gitifact 0.8.1 → 0.8.2

package/dist/main.js

@@ -10413,15 +10413,15 @@ function bucketFor(state2, inst) {
 var handoff;
 var open = [];
 var memo = {
-  alloc(_inst, payload, empty) {
+  alloc(_inst, payload, empty2) {
     const bucket = handoff;
     if (!bucket)
-      return empty;
+      return empty2;
     handoff = void 0;
-    const entry2 = { value: empty, issues: null };
+    const entry2 = { value: empty2, issues: null };
     bucket.set(payload.value, entry2);
     open.push(entry2);
-    return empty;
+    return empty2;
   },
   guard(inst) {
     var _a3;
@@ -13092,8 +13092,8 @@ var error20 = () => {
       case "invalid_union":
         return "\u05E7\u05DC\u05D8 \u05DC\u05D0 \u05EA\u05E7\u05D9\u05DF";
       case "invalid_element": {
-        const place2 = withDefinite(issue2.origin ?? "array");
-        return `\u05E2\u05E8\u05DA \u05DC\u05D0 \u05EA\u05E7\u05D9\u05DF \u05D1${place2}`;
+        const place3 = withDefinite(issue2.origin ?? "array");
+        return `\u05E2\u05E8\u05DA \u05DC\u05D0 \u05EA\u05E7\u05D9\u05DF \u05D1${place3}`;
       }
       default:
         return `\u05E7\u05DC\u05D8 \u05DC\u05D0 \u05EA\u05E7\u05D9\u05DF`;
@@ -25064,20 +25064,73 @@ var instruction = external_exports.strictObject({
 var agents = external_exports.strictObject({ path: external_exports.string(), body: external_exports.string(), updatedAt: external_exports.string().nullable() });
 var problem = external_exports.strictObject({ code: external_exports.string(), path: external_exports.string(), message: external_exports.string() });
 var oid2 = external_exports.string().regex(/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/);
-var browserSpecsV7 = external_exports.strictObject({
-  contract: external_exports.literal("browser-specs"),
-  version: external_exports.literal(7),
+var indexFeature = external_exports.strictObject({
+  id: external_exports.string(),
+  path: external_exports.string(),
+  title: external_exports.string(),
+  state,
+  requirements: external_exports.array(external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string(), description: external_exports.string() })),
+  designs: external_exports.array(external_exports.strictObject({ id: external_exports.string(), path: external_exports.string(), title: external_exports.string() }))
+});
+var indexInstruction = external_exports.strictObject({ id: external_exports.string(), name: external_exports.string(), path: external_exports.string(), title: external_exports.string() });
+var browserCheckoutV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-checkout"),
+  version: external_exports.literal(1),
   sessionId: external_exports.string(),
   head: oid2.nullable(),
   observedAt: external_exports.string(),
   working: external_exports.boolean(),
   stamp: external_exports.string(),
-  features: external_exports.array(feature),
-  instructions: external_exports.array(instruction),
-  agents: agents.nullable(),
   problems: external_exports.array(problem),
+  index: external_exports.strictObject({ features: external_exports.array(indexFeature), instructions: external_exports.array(indexInstruction), people: external_exports.array(external_exports.strictObject({ name: external_exports.string(), email: external_exports.string() })) })
+});
+var featureRow = external_exports.strictObject({
+  id: external_exports.string(),
+  path: external_exports.string(),
+  title: external_exports.string(),
+  description: external_exports.string(),
+  state,
+  designs: external_exports.number().int().nonnegative(),
   contributors: external_exports.array(contributor),
-  contributorsLimited: external_exports.boolean()
+  updatedAt: external_exports.string().nullable(),
+  requirementCount: external_exports.number().int().nonnegative(),
+  // `acceptance`: the numbered items under the acceptance heading, null without one. `designed`: a design names it.
+  requirements: external_exports.array(external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), description: external_exports.string(), state, acceptance: external_exports.number().int().positive().nullable(), designed: external_exports.boolean() })),
+  hidden: external_exports.number().int().nonnegative()
+});
+var browserFeaturesV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-features"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  total: external_exports.number().int().nonnegative(),
+  all: external_exports.number().int().nonnegative(),
+  requirements: external_exports.number().int().nonnegative(),
+  mostRequirements: external_exports.number().int().nonnegative(),
+  next: external_exports.string().nullable(),
+  features: external_exports.array(featureRow)
+});
+var browserFeatureV1 = external_exports.strictObject({ contract: external_exports.literal("browser-feature"), version: external_exports.literal(1), sessionId: external_exports.string(), feature });
+var browserInstructionsV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-instructions"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  instructions: external_exports.array(instruction),
+  agents: agents.nullable()
+});
+var browserContributorsV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-contributors"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  total: external_exports.number().int().nonnegative(),
+  next: external_exports.string().nullable(),
+  people: external_exports.array(external_exports.strictObject({ email: external_exports.string(), name: external_exports.string(), commits: external_exports.number().int().nonnegative(), latest: external_exports.string(), features: external_exports.number().int().nonnegative() }))
+});
+var browserContributorV1 = external_exports.strictObject({
+  contract: external_exports.literal("browser-contributor"),
+  version: external_exports.literal(1),
+  sessionId: external_exports.string(),
+  person: contributor,
+  features: external_exports.array(external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), commits: external_exports.number().int().nonnegative(), requirements: external_exports.number().int().nonnegative() }))
 });
 var kind = external_exports.enum(["feature", "requirement", "design", "wiki", "instruction"]);
 var reference = external_exports.strictObject({ id: external_exports.string(), title: external_exports.string(), specId: external_exports.string(), path: external_exports.string() }).nullable();
@@ -25122,11 +25175,13 @@ var browserHistoryV6 = external_exports.strictObject({
   next: oid2.nullable(),
   events: external_exports.array(event)
 });
-var browserHistorySummaryV4 = external_exports.strictObject({
+var browserHistorySummaryV5 = external_exports.strictObject({
   contract: external_exports.literal("browser-history-summary"),
-  version: external_exports.literal(4),
+  version: external_exports.literal(5),
   sessionId: external_exports.string(),
   head: oid2,
+  // The three who committed most, and how many others there are and how many commits they made between them.
+  people: external_exports.strictObject({ total: external_exports.number().int().nonnegative(), top: external_exports.array(contributor), rest: external_exports.strictObject({ count: external_exports.number().int().nonnegative(), commits: external_exports.number().int().nonnegative() }) }),
   total: external_exports.number().int().nonnegative(),
   byType: external_exports.strictObject({ created: external_exports.number().int().nonnegative(), modified: external_exports.number().int().nonnegative(), moved: external_exports.number().int().nonnegative(), deleted: external_exports.number().int().nonnegative() }),
   // One entry per commit within three weeks of the newest change, so the reader can count by its own calendar day.
@@ -25134,22 +25189,23 @@ var browserHistorySummaryV4 = external_exports.strictObject({
   // The newest commits: a few of their changes each and how many there are in all.
   recent: external_exports.array(external_exports.strictObject({ commit: oid2, count: external_exports.number().int().positive(), events: external_exports.array(event) }))
 });
-var browserSearchV2 = external_exports.strictObject({
+var searchKind = external_exports.enum(["feature", "requirement", "design", "instruction", "record", "commit"]);
+var searchHit = external_exports.strictObject({
+  id: external_exports.string(),
+  kind: searchKind,
+  title: external_exports.string(),
+  where: external_exports.string(),
+  line: external_exports.string(),
+  // What the hit opens: a feature (with the requirement or design tab), an instruction, a record, or a commit.
+  featureId: external_exports.string().optional(),
+  commit: oid2.optional()
+});
+var browserSearchV3 = external_exports.strictObject({
   contract: external_exports.literal("browser-search"),
-  version: external_exports.literal(2),
+  version: external_exports.literal(3),
   sessionId: external_exports.string(),
   query: external_exports.string(),
-  hits: external_exports.array(external_exports.strictObject({
-    id: external_exports.string(),
-    kind: external_exports.enum(["feature", "requirement", "design", "instruction", "history"]),
-    title: external_exports.string(),
-    where: external_exports.string(),
-    line: external_exports.string(),
-    // What the hit opens: a feature (with the requirement or design tab), an instruction, or one change in the activity.
-    featureId: external_exports.string().optional(),
-    documentId: external_exports.string().optional(),
-    key: external_exports.string().optional()
-  }))
+  groups: external_exports.array(external_exports.strictObject({ group: external_exports.union([searchKind, external_exports.literal("recent")]), total: external_exports.number().int().nonnegative(), next: external_exports.string().nullable(), hits: external_exports.array(searchHit) }))
 });
 var headQuery = oid2;
 var count = (max) => external_exports.string().regex(/^(0|[1-9]\d{0,6})$/).transform(Number).pipe(external_exports.number().int().min(0).max(max));
@@ -25164,7 +25220,26 @@ var browserHistoryQueryV4 = external_exports.strictObject({
   q: external_exports.string().max(200).optional()
 });
 var browserHistorySummaryQueryV1 = external_exports.strictObject({ head: headQuery });
-var browserSearchQueryV1 = external_exports.strictObject({ q: external_exports.string().min(1).max(200), head: headQuery.optional() });
+var featureId = external_exports.string().regex(/^S-[a-z2-7]{10}$/);
+var browserFeaturesQueryV1 = external_exports.strictObject({
+  q: external_exports.string().max(200).optional(),
+  design: external_exports.enum(["yes", "no"]).optional(),
+  author: external_exports.string().min(1).max(320).optional(),
+  sort: external_exports.enum(["title", "requirements", "updated"]).optional(),
+  dir: external_exports.enum(["asc", "desc"]).optional(),
+  after: featureId.optional(),
+  limit: count(50).pipe(external_exports.number().min(1)).optional()
+});
+var browserFeatureQueryV1 = external_exports.strictObject({ id: featureId });
+var browserContributorsQueryV1 = external_exports.strictObject({ q: external_exports.string().max(200).optional(), after: external_exports.string().min(1).max(320).optional(), limit: count(50).pipe(external_exports.number().min(1)).optional() });
+var browserContributorQueryV1 = external_exports.strictObject({ email: external_exports.string().min(1).max(320) });
+var browserSearchQueryV2 = external_exports.strictObject({
+  q: external_exports.string().max(200),
+  head: headQuery.optional(),
+  group: searchKind.optional(),
+  after: external_exports.string().min(1).max(200).optional(),
+  limit: count(50).pipe(external_exports.number().min(1)).optional()
+});
 var browserInstructionFileQueryV1 = external_exports.strictObject({ id: external_exports.string().regex(/^I-[a-z2-7]{10}$/), path: external_exports.string().min(1).max(1e3) });
 var changelogQueryV1 = external_exports.strictObject({ lang: external_exports.string().regex(/^[a-z]{2}(?:-[A-Z]{2})?$/).optional() });
 var fileStatus = external_exports.enum(["added", "modified", "deleted", "renamed"]);
@@ -25176,12 +25251,13 @@ var commitFile = external_exports.strictObject({
   additions: external_exports.number().int().nonnegative().nullable(),
   deletions: external_exports.number().int().nonnegative().nullable()
 });
-var browserCommitFilesV1 = external_exports.strictObject({
+var browserCommitFilesV2 = external_exports.strictObject({
   contract: external_exports.literal("browser-commit-files"),
-  version: external_exports.literal(1),
+  version: external_exports.literal(2),
   sessionId: external_exports.string(),
   commit: oid2,
   total: external_exports.number().int().nonnegative(),
+  next: external_exports.string().nullable(),
   files: external_exports.array(commitFile)
 });
 var browserCommitFileV1 = external_exports.strictObject({
@@ -25196,7 +25272,7 @@ var browserCommitFileV1 = external_exports.strictObject({
   binary: external_exports.boolean(),
   tooLarge: external_exports.boolean()
 });
-var browserCommitFilesQueryV1 = external_exports.strictObject({ commit: oid2 });
+var browserCommitFilesQueryV2 = external_exports.strictObject({ commit: oid2, after: external_exports.string().min(1).max(4096).optional(), limit: count(100).pipe(external_exports.number().min(1)).optional() });
 var browserCommitFileQueryV1 = external_exports.strictObject({ commit: oid2, path: external_exports.string().min(1).max(4096) });
 var browserCommitV4 = external_exports.strictObject({
   contract: external_exports.literal("browser-commit"),
@@ -25212,7 +25288,8 @@ var browserCommitV4 = external_exports.strictObject({
   next: external_exports.string().nullable(),
   changes: external_exports.array(event)
 });
-var browserCommitQueryV2 = external_exports.strictObject({ commit: oid2, after: external_exports.string().min(1).max(200).optional(), limit: count(500).pipe(external_exports.number().min(1)).optional() });
+var recordId = external_exports.string().regex(/^(?:DR|H)-[A-Za-z0-9_-]{1,64}$/);
+var browserCommitQueryV3 = external_exports.strictObject({ commit: oid2, after: external_exports.string().min(1).max(200).optional(), limit: count(100).pipe(external_exports.number().min(1)).optional(), record: recordId.optional() });
 var browserCommitChangeV1 = external_exports.strictObject({
   contract: external_exports.literal("browser-commit-change"),
   version: external_exports.literal(1),
@@ -25223,14 +25300,15 @@ var browserCommitChangeV1 = external_exports.strictObject({
   after: snapshot
 });
 var browserCommitChangeQueryV1 = external_exports.strictObject({ commit: oid2, id: external_exports.string().min(1).max(100) });
-var recordId = external_exports.string().regex(/^(?:DR|H)-[A-Za-z0-9_-]{1,64}$/);
-var browserRecordV1 = external_exports.strictObject({
+var browserRecordV2 = external_exports.strictObject({
   contract: external_exports.literal("browser-record"),
-  version: external_exports.literal(1),
+  version: external_exports.literal(2),
   sessionId: external_exports.string(),
   head: oid2,
   id: recordId,
-  commit: oid2
+  commit: oid2,
+  record: record2,
+  others: external_exports.number().int().nonnegative()
 });
 var browserRecordQueryV1 = external_exports.strictObject({ head: oid2, id: recordId });
 var browserInstructionFileV1 = external_exports.strictObject({
@@ -25505,6 +25583,8 @@ var messages_default3 = {
   "server.sessionChanged": "\uC11C\uBC84 \uC138\uC158\uC774 \uBCC0\uACBD\uB410\uC2B5\uB2C8\uB2E4. \uB2E4\uC2DC \uC5F0\uACB0\uD558\uC138\uC694.",
   "server.badRange": "\uC870\uD68C \uBC94\uC704\uB97C \uD655\uC778\uD558\uC138\uC694.",
   "server.commitNotFound": "\uC774 \uC800\uC7A5\uC18C\uC5D0 \uADF8 \uCEE4\uBC0B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "server.featureNotFound": "\uCCB4\uD06C\uC544\uC6C3\uC5D0 \uADF8 \uAE30\uB2A5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "server.contributorNotFound": "HEAD\uC5D0 \uADF8 \uC774\uBA54\uC77C\uB85C \uCEE4\uBC0B\uD55C \uC0AC\uB78C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.cursorNotFound": "\uC774\uC5B4 \uC77D\uC744 \uC704\uCE58\uB97C \uBAA9\uB85D\uC5D0\uC11C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uCC98\uC74C\uBD80\uD130 \uB2E4\uC2DC \uBD88\uB7EC\uC624\uC138\uC694.",
   "server.workingChangeNotFound": "\uCEE4\uBC0B \uC804 \uBCC0\uACBD\uC5D0 \uADF8 \uBB38\uC11C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "server.recordNotFound": "\uC774 \uC774\uB825\uC5D0 \uADF8 \uACB0\uC815\uAE30\uB85D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
@@ -25571,7 +25651,6 @@ var messages_default3 = {
   "agentBlock.duplicateStart": "GITIFACT \uC2DC\uC791 \uB9C8\uCEE4\uAC00 \uC5EC\uB7EC \uAC1C\uC785\uB2C8\uB2E4. \uC911\uBCF5 \uBE14\uB85D\uC744 \uC815\uB9AC\uD55C \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
   "specReader.headUnreadable": "HEAD\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "specReader.schemaRequired": "\uC0C8 \uC2A4\uD0A4\uB9C8 \uD504\uB85C\uC81D\uD2B8\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
-  "specReader.authorUnreadable": "Git \uC791\uC131\uC790\uB97C \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "specReader.historyUnreadable": "Git \uC774\uB825 \uD615\uC2DD\uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.",
   "specReader.projectChanged": "\uC870\uD68C \uC911 \uD504\uB85C\uC81D\uD2B8\uAC00 \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4. \uC0C8\uB85C\uACE0\uCE68\uD558\uC138\uC694.",
   "browser.invalidPort": "\uD3EC\uD2B8\uB294 0\uBD80\uD130 65535 \uC0AC\uC774\uC758 \uC815\uC218\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
@@ -25809,6 +25888,8 @@ var messages_default4 = {
   "server.sessionChanged": "The server session changed. Reconnect to continue.",
   "server.badRange": "Check the requested range.",
   "server.commitNotFound": "This repository has no such commit.",
+  "server.featureNotFound": "The checkout has no such feature.",
+  "server.contributorNotFound": "Nobody with this email committed to HEAD.",
   "server.cursorNotFound": "The place to read on from is no longer in the list. Load it again from the start.",
   "server.workingChangeNotFound": "No uncommitted change of that document.",
   "server.recordNotFound": "This history has no such decision record.",
@@ -25875,7 +25956,6 @@ var messages_default4 = {
   "agentBlock.duplicateStart": "Multiple GITIFACT start markers found. Remove duplicate blocks before retrying.",
   "specReader.headUnreadable": "Could not read HEAD.",
   "specReader.schemaRequired": "A project using the supported schema is required.",
-  "specReader.authorUnreadable": "Could not read Git authors.",
   "specReader.historyUnreadable": "Could not read Git history.",
   "specReader.projectChanged": "The project changed while reading. Refresh to continue.",
   "browser.invalidPort": "Port must be an integer between 0 and 65535.",
@@ -26414,7 +26494,7 @@ function storeReader(cwd) {
 import { DatabaseSync } from "node:sqlite";
 import { lstat, mkdir, rm, writeFile } from "node:fs/promises";
 import { join as join2 } from "node:path";
-var CACHE_FORMAT = 9;
+var CACHE_FORMAT = 11;
 var CACHE_DIR = ".gitifact/cache";
 var SCHEMA = `
   -- Working-tree files already read: the modification time and size decide whether a file is read again.
@@ -26444,7 +26524,17 @@ var SCHEMA = `
   CREATE TABLE lineage (head TEXT NOT NULL, pos INTEGER NOT NULL, oid TEXT NOT NULL, PRIMARY KEY (head, pos));
   CREATE INDEX lineage_by_commit ON lineage (head, oid);
   CREATE TABLE heads (head TEXT PRIMARY KEY, seen INTEGER NOT NULL);
-  -- Everything the search box finds: documents of the working tree (scope 'checkout') and past changes ('history').
+  -- Every commit the log has met, code commits too: who made it and when, and whether it is a format migration.
+  -- 'reach' is 1 for the commits of the HEAD the log follows now; contributors are counted over those.
+  CREATE TABLE log (oid TEXT PRIMARY KEY, name TEXT NOT NULL, email TEXT NOT NULL, time INTEGER NOT NULL, date TEXT NOT NULL,
+    subject TEXT NOT NULL, migration INTEGER NOT NULL, reach INTEGER NOT NULL);
+  CREATE INDEX log_by_reach ON log (reach, email);
+  -- The store folders a commit touched: a feature folder, an instruction folder, or AGENTS.md.
+  CREATE TABLE touches (oid TEXT NOT NULL, folder TEXT NOT NULL, PRIMARY KEY (oid, folder));
+  CREATE INDEX touches_by_folder ON touches (folder);
+  -- What the log follows: the HEAD ('head') and the fingerprint of the .mailmap its names were read with ('mailmap').
+  CREATE TABLE state (key TEXT PRIMARY KEY, value TEXT NOT NULL);
+  -- What the search box finds among the working tree's documents (scope 'checkout'); records are searched in their table.
   -- The searched columns hold lower-cased text; trigram lets LIKE '%...%' use the index from three characters on.
   CREATE VIRTUAL TABLE search USING fts5(
     scope UNINDEXED, kind UNINDEXED, ref UNINDEXED, oid UNINDEXED, payload UNINDEXED,
@@ -26728,6 +26818,40 @@ function createDocumentCache(root, database) {
         }));
       });
     },
+    /**
+     * The working documents of one kind whose title, place or text holds the query, a page at a time: a title that
+     * starts with it first, then a title, a place, and the text; by title within each. `after` is the ID of the last
+     * hit of the page before; one that no longer matches answers undefined. Each hit names its feature's ID.
+     */
+    async searchKind(kind2, raw, after, limit) {
+      const query = raw.trim().toLowerCase();
+      await sync();
+      return database.with((db) => {
+        const literal2 = /[\\%_]/.test(query);
+        const match = (column) => literal2 ? `instr(${column}, :q) > 0` : `${column} LIKE :like`;
+        const ordered = `WITH hits AS (
+            SELECT json_extract(payload, '$.id') AS id, payload, title, ref,
+              CASE WHEN substr(title, 1, length(:q)) = :q THEN 0 WHEN instr(title, :q) > 0 THEN 1 WHEN instr(place, :q) > 0 THEN 2 ELSE 3 END AS rank
+            FROM search WHERE scope = 'checkout' AND kind = :kind AND (${match("title")} OR ${match("place")} OR ${match("body")})),
+          ordered AS (SELECT *, row_number() OVER (ORDER BY rank, title, ref) AS n FROM hits)`;
+        const params = { q: query, kind: kind2, ...literal2 ? {} : { like: containing(query) } };
+        const total = Number(db.prepare(`${ordered} SELECT count(*) AS n FROM ordered`).get(params).n);
+        let start = 0;
+        if (after !== void 0) {
+          const at = db.prepare(`${ordered} SELECT n FROM ordered WHERE id = :after`).get({ ...params, after });
+          if (!at) return void 0;
+          start = Number(at.n);
+        }
+        const rows = db.prepare(`${ordered} SELECT payload FROM ordered WHERE n > :start ORDER BY n LIMIT :limit`).all({ ...params, start, limit: limit + 1 });
+        const features = new Map(db.prepare("SELECT feature, id FROM documents WHERE kind = 'feature'").all().map((r) => [r.feature, r.id]));
+        const hits = rows.slice(0, limit).map((r) => {
+          const p = JSON.parse(r.payload);
+          const featureId2 = p.feature ? features.get(p.feature) : void 0;
+          return { id: p.id, kind: kind2, title: p.title, where: p.where, line: snippet(p.body, query), ...featureId2 ? { featureId: featureId2 } : {} };
+        });
+        return { total, next: rows.length > limit ? hits[hits.length - 1].id : null, hits };
+      });
+    },
     /** Documents that refer to `id` from their frontmatter: designs naming a requirement or a source. */
     async referencing(id) {
       await sync();
@@ -27096,20 +27220,19 @@ var listed = (e) => {
   return { ...event2, before: reference2(e.before), after: reference2(e.after) };
 };
 var sideOf3 = (snapshot5, rev) => !snapshot5 ? null : rev ? { rev, path: snapshot5.path } : snapshot5;
-var titleOf = (e) => (e.after ?? e.before)?.title ?? e.id;
 var DAY = 864e5;
 var KEPT_HEADS = 4;
 var RECENT_COMMITS = 3;
 var RECENT_CHANGES = 12;
-function createHistory(database, git) {
+function createHistory(database, git, originals) {
   const changes2 = createCommitChanges(git);
+  const texts = originals ?? changes2;
   const building = /* @__PURE__ */ new Map();
   const built = /* @__PURE__ */ new Set();
   function insert(db, commits, readers) {
     const commit = db.prepare("INSERT OR IGNORE INTO commits (oid, reader) VALUES (?, ?)");
     const change2 = db.prepare("INSERT OR IGNORE INTO changes (key, oid, ord, id, kind, types, email, date, before_spec, after_spec, needle, row, detail) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)");
     const record4 = db.prepare("INSERT OR IGNORE INTO records (oid, id, title, sections) VALUES (?, ?, ?, ?)");
-    const search = db.prepare("INSERT INTO search (scope, kind, ref, oid, payload, title, place, body) VALUES (?,?,?,?,?,?,?,?)");
     transaction(db, () => {
       for (const c of commits) {
         if (!Number(commit.run(c.commit, readers.get(c.commit) ?? "current").changes)) continue;
@@ -27132,23 +27255,19 @@ function createHistory(database, git) {
             JSON.stringify(row),
             JSON.stringify(detail)
           );
-          const line2 = e.records.length ? e.records.map((r) => [r.title, ...r.sections.map((s) => s.body)].join(" ")).join(" \xB7 ") : e.message;
-          const where2 = e.commit.slice(0, 7) + " \xB7 " + e.author;
-          search.run(
-            "history",
-            "history",
-            e.key,
-            e.commit,
-            JSON.stringify({ title: titleOf(e), where: where2, line: line2 }),
-            titleOf(e).toLowerCase(),
-            where2.toLowerCase(),
-            [line2, e.message, e.id].join(" ").toLowerCase()
-          );
         });
       }
     });
   }
   async function build(head) {
+    const known = await database.with((db) => {
+      const seen = !!db.prepare("SELECT 1 FROM heads WHERE head = ?").get(head);
+      if (seen) db.prepare("UPDATE heads SET seen = ? WHERE head = ?").run(Date.now(), head);
+      return seen;
+    });
+    if (!known) await read(head);
+  }
+  async function read(head) {
     const lineage = await changes2.lineage(head);
     const readers = await changes2.readers(head, lineage);
     const known = await database.with((db) => new Map(db.prepare("SELECT oid, reader FROM commits").all().map((r) => [r.oid, r.reader])));
@@ -27158,13 +27277,14 @@ function createHistory(database, git) {
         db.prepare("DELETE FROM commits WHERE oid = ?").run(oid3);
         db.prepare("DELETE FROM changes WHERE oid = ?").run(oid3);
         db.prepare("DELETE FROM records WHERE oid = ?").run(oid3);
-        db.prepare("DELETE FROM search WHERE scope = 'history' AND oid = ?").run(oid3);
       }
+      db.prepare("DELETE FROM lineage WHERE head != ?").run(head);
+      db.prepare("DELETE FROM heads WHERE head != ?").run(head);
     }));
     const missing2 = lineage.filter((oid3) => !known.has(oid3) || stale.includes(oid3));
     for (let i = 0; i < missing2.length; i += 100) {
-      const read = await changes2.of(missing2.slice(i, i + 100), readers);
-      await database.with((db) => insert(db, read, readers));
+      const read2 = await changes2.of(missing2.slice(i, i + 100), readers);
+      await database.with((db) => insert(db, read2, readers));
     }
     await database.with((db) => transaction(db, () => {
       db.prepare("DELETE FROM lineage WHERE head = ?").run(head);
@@ -27191,15 +27311,21 @@ function createHistory(database, git) {
   async function readCommit(commit) {
     const known = await database.with((db) => !!db.prepare("SELECT 1 FROM commits WHERE oid = ?").get(commit));
     if (known) return;
-    const read = await changes2.of([commit]).catch(() => void 0);
-    if (read) await database.with((db) => insert(db, read, /* @__PURE__ */ new Map()));
+    const read2 = await changes2.of([commit]).catch(() => void 0);
+    if (read2) await database.with((db) => insert(db, read2, /* @__PURE__ */ new Map()));
+  }
+  function sameRecord(db, commit, id) {
+    if (!id.startsWith("H-")) return [id];
+    const own2 = db.prepare("SELECT title, sections FROM records WHERE oid = ? AND id = ?").get(commit, id);
+    if (!own2) return [id];
+    return db.prepare("SELECT id FROM records WHERE oid = ? AND id LIKE 'H-%' AND title = ? AND sections = ?").all(commit, own2.title, own2.sections).map((r) => r.id);
   }
   function hydrate(db, rows) {
     const events = rows.map((row) => JSON.parse(row));
-    const read = db.prepare("SELECT id, title, sections FROM records WHERE oid = ?");
+    const read2 = db.prepare("SELECT id, title, sections FROM records WHERE oid = ?");
     const byCommit = /* @__PURE__ */ new Map();
     for (const e of events) if (e.records.length && !byCommit.has(e.commit)) {
-      byCommit.set(e.commit, new Map(read.all(e.commit).map((r) => [r.id, { id: r.id, title: r.title, sections: JSON.parse(r.sections) }])));
+      byCommit.set(e.commit, new Map(read2.all(e.commit).map((r) => [r.id, { id: r.id, title: r.title, sections: JSON.parse(r.sections) }])));
     }
     return events.map((e) => ({ ...e, records: e.records.flatMap((id) => {
       const r = byCommit.get(e.commit)?.get(id);
@@ -27216,8 +27342,8 @@ function createHistory(database, git) {
         if (value && "rev" in value) places.push({ rev: value.rev, path: value.path, specId: events[i][key]?.specId ?? "" });
       }
     });
-    const read = places.length ? await changes2.sides(places) : [];
-    const text4 = new Map(places.map((p, i) => [p.rev + ":" + p.path, read[i] ?? null]));
+    const read2 = places.length ? await texts.sides(places) : [];
+    const text4 = new Map(places.map((p, i) => [p.rev + ":" + p.path, read2[i] ?? null]));
     const resolve = (value) => !value ? null : "rev" in value ? text4.get(value.rev + ":" + value.path) ?? null : value;
     return events.map((event2, i) => ({ event: event2, before: resolve(sides[i].before), after: resolve(sides[i].after) }));
   }
@@ -27249,7 +27375,7 @@ function createHistory(database, git) {
   return {
     ensure,
     /** The document and reason files of one commit, read from Git and not kept. */
-    filesAt: (rev) => changes2.tree(rev),
+    filesAt: (rev) => texts.tree(rev),
     /**
      * The changes that match, newest first, a page of whole commits: `limit` commits after the commit `after`, each
      * with all of its matching changes, and how many changes and commits match in all. `next` is the last commit of the
@@ -27278,11 +27404,15 @@ function createHistory(database, git) {
         };
       });
     },
-    /** The changes of one commit without their text, a page at a time after the change `after` (a key): the commit page's list. */
-    async commitChanges(commit, after, limit) {
+    /**
+     * The changes of one commit without their text, a page at a time after the change `after` (a key): the commit page's
+     * list. With `record`, only the changes that record explains: the record page's documents.
+     */
+    async commitChanges(commit, after, limit, record4) {
       await readCommit(commit);
       return database.with((db) => {
-        const all = db.prepare("SELECT key, row FROM changes WHERE oid = ? ORDER BY ord").all(commit);
+        const ids = record4 === void 0 ? void 0 : JSON.stringify(sameRecord(db, commit, record4));
+        const all = ids === void 0 ? db.prepare("SELECT key, row FROM changes WHERE oid = ? ORDER BY ord").all(commit) : db.prepare("SELECT key, row FROM changes c WHERE oid = ? AND EXISTS (SELECT 1 FROM json_each(c.row, '$.records') j WHERE j.value IN (SELECT value FROM json_each(?))) ORDER BY ord").all(commit, ids);
         const start = after === void 0 ? 0 : all.findIndex((r) => r.key === after) + 1;
         if (after !== void 0 && !start) return void 0;
         const shown = all.slice(start, start + limit);
@@ -27372,86 +27502,226 @@ function createHistory(database, git) {
         const commits = db.prepare(`SELECT l.oid AS oid, max(c.date) AS date, count(*) AS n ${from} GROUP BY l.pos, l.oid ORDER BY l.pos`).all(head);
         const newest = Math.max(0, ...commits.map((c) => Date.parse(c.date)).filter(Number.isFinite));
         const pulse = commits.filter((c) => Date.parse(c.date) >= newest - 22 * DAY).map((c) => ({ date: c.date, count: Number(c.n) }));
-        const recent = commits.slice(0, RECENT_COMMITS).map((c) => ({
+        const recent2 = commits.slice(0, RECENT_COMMITS).map((c) => ({
           commit: c.oid,
           count: Number(c.n),
           events: hydrate(db, db.prepare("SELECT row FROM changes WHERE oid = ? ORDER BY ord LIMIT ?").all(c.oid, RECENT_CHANGES).map((r) => r.row))
         }));
-        return { total, byType: { created: count2("created"), modified: count2("modified"), moved: count2("moved"), deleted: count2("deleted") }, pulse, recent };
+        return { total, byType: { created: count2("created"), modified: count2("modified"), moved: count2("moved"), deleted: count2("deleted") }, pulse, recent: recent2 };
       });
     },
-    /** The commit of `head`'s history that added a record, found through the records its changes carry. */
-    async commitOfRecord(head, id) {
+    /**
+     * The record of `head`'s history with the commit that added it, and how many other records that commit holds (a
+     * 0.7 reason written once over several documents counts once). Undefined when the history has no such record.
+     */
+    async recordOf(head, id) {
       await ensure(head);
-      return database.with((db) => db.prepare("SELECT l.oid AS oid FROM lineage l JOIN records r ON r.oid = l.oid WHERE l.head = ? AND r.id = ? ORDER BY l.pos LIMIT 1").get(head, id)?.oid);
+      return database.with((db) => {
+        const found = db.prepare("SELECT r.oid AS oid, r.title AS title, r.sections AS sections FROM lineage l JOIN records r ON r.oid = l.oid WHERE l.head = ? AND r.id = ? ORDER BY l.pos LIMIT 1").get(head, id);
+        if (!found) return void 0;
+        const all = db.prepare("SELECT id, title, sections FROM records WHERE oid = ?").all(found.oid);
+        const groups = new Set(all.map((r) => r.id.startsWith("H-") ? "H\0" + r.title + "\0" + r.sections : r.id));
+        return { commit: found.oid, record: { id, title: found.title, sections: JSON.parse(found.sections) }, others: groups.size - 1 };
+      });
     },
     /**
-     * Documents whose title, place or text holds the query — a title match before a place match before a text match —
-     * then past changes of `head`'s history, newest first. The caller syncs the working documents first.
+     * The records of `head`'s history whose title, ID or sections hold the query, one hit per record file, a page at a
+     * time: a title that starts with it first, then a title, the ID, and the sections; newest first within each. `after`
+     * is the ID of the last hit of the page before; one that no longer matches answers undefined.
      */
-    async search(head, raw) {
+    async searchRecords(head, raw, after, limit) {
       const query = raw.trim().toLowerCase();
-      if (!query) return [];
-      if (head) await ensure(head);
+      await ensure(head);
       return database.with((db) => {
-        const literal2 = /[\\%_]/.test(query);
-        const match = (column) => literal2 ? `instr(${column}, ?) > 0` : `${column} LIKE ?`;
-        const needle = literal2 ? query : containing(query);
-        const features = new Map(db.prepare("SELECT feature, id FROM documents WHERE kind = 'feature'").all().map((r) => [r.feature, r.id]));
-        const found = db.prepare(`SELECT kind, payload, title, place FROM search WHERE scope = 'checkout' AND (${match("title")} OR ${match("place")} OR ${match("body")}) LIMIT 400`).all(needle, needle, needle);
-        const documents = found.map((r) => {
-          const at = r.title.indexOf(query);
-          const rank = at === 0 ? 0 : at > 0 ? 1 : r.place.includes(query) ? 2 : 3;
-          const p = JSON.parse(r.payload);
-          const featureId = p.feature ? features.get(p.feature) : void 0;
-          const hit = {
-            id: p.id,
-            kind: r.kind,
-            title: p.title,
-            where: p.where,
-            line: snippet(p.body, query),
-            ...featureId ? { featureId } : {}
-          };
-          return { rank, hit };
-        }).sort((a, b) => a.rank - b.rank || a.hit.title.localeCompare(b.hit.title)).slice(0, 24).map((r) => r.hit);
-        const past = !head ? [] : db.prepare(`SELECT s.ref AS ref, s.payload AS payload FROM search s JOIN lineage l ON l.head = ? AND l.oid = s.oid
-          WHERE s.scope = 'history' AND (${match("s.title")} OR ${match("s.body")}) ORDER BY l.pos LIMIT 8`).all(head, needle, needle).map((r) => {
-          const p = JSON.parse(r.payload);
-          return { id: r.ref, kind: "history", title: p.title, where: p.where, line: snippet(p.line, query), key: r.ref };
+        const ordered = `WITH own AS (
+            SELECT r.id AS id, r.title AS title, r.oid AS oid, min(l.pos) AS pos, r.sections AS sections,
+              lower((SELECT group_concat(json_extract(s.value, '$.body'), ' ') FROM json_each(r.sections) s)) AS body
+            FROM lineage l JOIN records r ON r.oid = l.oid WHERE l.head = :head GROUP BY r.id),
+          hits AS (SELECT *, CASE WHEN substr(lower(title), 1, length(:q)) = :q THEN 0 WHEN instr(lower(title), :q) > 0 THEN 1
+              WHEN instr(lower(id), :q) > 0 THEN 2 ELSE 3 END AS rank
+            FROM own WHERE instr(lower(title), :q) > 0 OR instr(lower(id), :q) > 0 OR instr(body, :q) > 0),
+          ordered AS (SELECT *, row_number() OVER (ORDER BY rank, pos, id) AS n FROM hits)`;
+        const params = { head, q: query };
+        const total = Number(db.prepare(`${ordered} SELECT count(*) AS n FROM ordered`).get(params).n);
+        let start = 0;
+        if (after !== void 0) {
+          const at = db.prepare(`${ordered} SELECT n FROM ordered WHERE id = :after`).get({ ...params, after });
+          if (!at) return void 0;
+          start = Number(at.n);
+        }
+        const rows = db.prepare(`${ordered} SELECT id, title, oid, sections FROM ordered WHERE n > :start ORDER BY n LIMIT :limit`).all({ ...params, start, limit: limit + 1 });
+        const hits = rows.slice(0, limit).map((r) => {
+          const text4 = JSON.parse(r.sections).map((s) => s.body).join(" ");
+          return { id: r.id, kind: "record", title: r.title, where: r.id + " \xB7 " + r.oid.slice(0, 7), line: snippet(text4, query), commit: r.oid };
         });
-        return [...documents, ...past];
+        return { total, next: rows.length > limit ? hits[hits.length - 1].id : null, hits };
+      });
+    }
+  };
+}
+
+// src/adapters/cache/commit-log.ts
+import { lstat as lstat3 } from "node:fs/promises";
+import { join as join4 } from "node:path";
+var FORMAT2 = `%x1e%H%x00%aN%x00%aE%x00%at%x00%aI%x00%s%x00%(trailers:key=${MIGRATION_TRAILER},valueonly,separator=%x2C)`;
+var CHUNK = 1e5;
+var folderOf2 = (path3) => path3 === "AGENTS.md" ? path3 : new RegExp(`^(${SPEC_ROOT.replace(/\./g, "\\.")}/[^/]+|${INSTRUCTIONS_ROOT.replace(/\./g, "\\.")}/[^/]+)/`).exec(path3)?.[1];
+function createCommitLog(database, git, root) {
+  let following;
+  let followingHead;
+  const read = async (args) => git.decode(await git.run(args));
+  async function commits(range) {
+    const out = [];
+    for (let skip = 0; ; skip += CHUNK) {
+      const text4 = await read(["log", `--format=${FORMAT2}`, `--max-count=${CHUNK}`, `--skip=${skip}`, ...range, "--"]);
+      const chunk = text4.split("").filter(Boolean).map((entry2) => {
+        const [oid3, name2, email3, time3, date5, subject, migration] = entry2.split("\0");
+        return { oid: oid3, name: name2 ?? "", email: email3 ?? "", time: Number(time3), date: date5 ?? "", subject: subject ?? "", migration: !!migration?.trim() };
+      });
+      out.push(...chunk);
+      if (chunk.length < CHUNK) return out;
+    }
+  }
+  async function touches(range) {
+    const text4 = await read(["log", "--format=%x1e%H", "-z", "--name-only", "--no-renames", ...range, "--", SPEC_ROOT, INSTRUCTIONS_ROOT, "AGENTS.md"]);
+    const out = [];
+    for (const entry2 of text4.split("").filter(Boolean)) {
+      const [oid3, ...paths2] = entry2.split("\0");
+      const folders = new Set(paths2.map((p) => folderOf2(p.replace(/^\n/, ""))).filter((f) => !!f));
+      for (const folder of folders) out.push([oid3.trim(), folder]);
+    }
+    return out;
+  }
+  async function mailmap() {
+    const info5 = await lstat3(join4(root, ".mailmap")).catch(() => void 0);
+    return info5 ? info5.mtimeMs + ":" + info5.size : "-";
+  }
+  const stateOf = (db, key) => db.prepare("SELECT value FROM state WHERE key = ?").get(key)?.value;
+  async function follow(head, attempts = 3) {
+    const names = await mailmap();
+    const [before, named] = await database.with((db) => [stateOf(db, "head"), stateOf(db, "mailmap")]);
+    if (before === head && named === names) return;
+    let change2;
+    if (before && named === names) {
+      try {
+        const range = [head, "^" + before];
+        const [added2, removed2, touched2] = await Promise.all([commits(range), read(["rev-list", before, "^" + head, "--"]), touches(range)]);
+        change2 = { added: added2, removed: removed2.split("\n").filter(Boolean), touched: touched2, whole: false };
+      } catch {
+        change2 = void 0;
+      }
+    }
+    if (!change2) {
+      const [added2, touched2] = await Promise.all([commits([head]), touches([head])]);
+      change2 = { added: added2, removed: [], touched: touched2, whole: true };
+    }
+    const { added, removed, touched, whole } = change2;
+    const written = await database.with((db) => transaction(db, () => {
+      if (stateOf(db, "head") !== before || stateOf(db, "mailmap") !== named) return false;
+      if (whole) {
+        db.exec("DELETE FROM log");
+        db.exec("DELETE FROM touches");
+      }
+      const put = db.prepare(`INSERT INTO log (oid, name, email, time, date, subject, migration, reach) VALUES (?, ?, ?, ?, ?, ?, ?, 1)
+        ON CONFLICT (oid) DO UPDATE SET name = excluded.name, email = excluded.email, reach = 1`);
+      for (const c of added) put.run(c.oid, c.name, c.email, c.time, c.date, c.subject, c.migration ? 1 : 0);
+      const leave = db.prepare("UPDATE log SET reach = 0 WHERE oid = ?");
+      for (const oid3 of removed) leave.run(oid3);
+      const touch = db.prepare("INSERT OR IGNORE INTO touches (oid, folder) VALUES (?, ?)");
+      for (const [oid3, folder] of touched) touch.run(oid3, folder);
+      const set2 = db.prepare("INSERT INTO state (key, value) VALUES (?, ?) ON CONFLICT (key) DO UPDATE SET value = excluded.value");
+      set2.run("head", head);
+      set2.run("mailmap", names);
+      return true;
+    }));
+    if (!written && attempts > 1) return follow(head, attempts - 1);
+  }
+  async function ensure(head) {
+    while (following && followingHead !== head) await following.catch(() => void 0);
+    if (!following) {
+      followingHead = head;
+      following = follow(head).finally(() => {
+        following = void 0;
+        followingHead = void 0;
+      });
+    }
+    return following;
+  }
+  return {
+    ensure,
+    /** Everyone who committed to `head`, most commits first, format migrations left out. `latest` is their newest commit. */
+    async contributors(head) {
+      await ensure(head);
+      return database.with((db) => db.prepare(`SELECT email, name, count(*) AS commits, max(time) AS time, date AS latest FROM log
+        WHERE reach = 1 AND migration = 0 GROUP BY email ORDER BY commits DESC, name, email`).all().map(({ name: name2, email: email3, commits: commits2, latest }) => ({ name: name2, email: email3, commits: Number(commits2), latest })));
+    },
+    /**
+     * The commits of `head` a hash names: the whole hash, or its start from seven characters on, as `git log --oneline`
+     * prints it. Anything shorter or not a hash names none. Newest first, a page after the commit `after`.
+     */
+    async commitsNamed(head, raw, after, limit) {
+      const prefix = raw.trim().toLowerCase();
+      if (!/^[0-9a-f]{7,64}$/.test(prefix)) return { total: 0, next: null, hits: [] };
+      await ensure(head);
+      return database.with((db) => {
+        const rows = db.prepare("SELECT oid, name, date, subject FROM log WHERE reach = 1 AND substr(oid, 1, length(?)) = ? ORDER BY time DESC, oid").all(prefix, prefix);
+        const start = after === void 0 ? 0 : rows.findIndex((r) => r.oid === after) + 1;
+        if (after !== void 0 && !start) return void 0;
+        const shown = rows.slice(start, start + limit);
+        return {
+          total: rows.length,
+          next: start + shown.length < rows.length ? shown[shown.length - 1].oid : null,
+          hits: shown.map((r) => ({ id: r.oid, kind: "commit", title: r.subject, where: r.oid.slice(0, 7) + " \xB7 " + r.name, line: r.date.slice(0, 10), commit: r.oid }))
+        };
+      });
+    },
+    /** Each store folder's authors, most commits first, and when it was last touched, format migrations left out. */
+    async folders(head) {
+      await ensure(head);
+      return database.with((db) => {
+        const rows = db.prepare(`SELECT t.folder AS folder, l.email AS email, l.name AS name, count(*) AS commits, max(l.time) AS time, l.date AS latest
+          FROM touches t JOIN log l ON l.oid = t.oid WHERE l.reach = 1 AND l.migration = 0
+          GROUP BY t.folder, l.email ORDER BY t.folder, commits DESC, name, email`).all();
+        const out = /* @__PURE__ */ new Map();
+        for (const r of rows) {
+          let entry2 = out.get(r.folder);
+          if (!entry2) out.set(r.folder, entry2 = { people: [], latest: r.latest, time: r.time });
+          entry2.people.push({ name: r.name, email: r.email, commits: Number(r.commits), latest: r.latest });
+          if (r.time > entry2.time) {
+            entry2.time = r.time;
+            entry2.latest = r.latest;
+          }
+        }
+        return new Map([...out].map(([folder, { people, latest }]) => [folder, { people, latest }]));
       });
     }
   };
 }
 
 // src/adapters/cache/index.ts
-function openCache(root, git) {
+function openCache(root, git, originals) {
   const database = createCacheDatabase(root);
   const documents = createDocumentCache(root, database);
-  const history = createHistory(database, git);
+  const history = createHistory(database, git, originals);
+  const log = createCommitLog(database, git, root);
   return {
     documents,
     history,
-    location: database.location,
-    /** Documents first, so a search right after an edit finds the edited text. */
-    async search(head, query) {
-      await documents.sync();
-      return history.search(head, query);
-    }
+    log,
+    location: database.location
   };
 }
 
 // src/adapters/git/pending-records.ts
-import { lstat as lstat3, readdir as readdir3, readFile as readFile3 } from "node:fs/promises";
-import { join as join4 } from "node:path";
+import { lstat as lstat4, readdir as readdir3, readFile as readFile3 } from "node:fs/promises";
+import { join as join5 } from "node:path";
 var decoder = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
-var info = (path3) => lstat3(path3).catch((error62) => {
+var info = (path3) => lstat4(path3).catch((error62) => {
   if (error62.code === "ENOENT") return void 0;
   throw error62;
 });
 async function recordFolders(root) {
-  return (await readdir3(join4(root, ...RECORDS_ROOT.split("/"))).catch((error62) => {
+  return (await readdir3(join5(root, ...RECORDS_ROOT.split("/"))).catch((error62) => {
     if (error62.code === "ENOENT") return [];
     throw error62;
   })).filter(isRecordFolder);
@@ -27459,7 +27729,7 @@ async function recordFolders(root) {
 async function findRecord(root, id) {
   for (const folder of await recordFolders(root)) {
     const path3 = `${RECORDS_ROOT}/${folder}/${id}.md`;
-    if ((await info(join4(root, ...path3.split("/"))))?.isFile()) return path3;
+    if ((await info(join5(root, ...path3.split("/"))))?.isFile()) return path3;
   }
   return void 0;
 }
@@ -27475,7 +27745,7 @@ async function readPendingRecords(root, run) {
       altered.push(path3);
       continue;
     }
-    const file2 = join4(root, ...path3.split("/"));
+    const file2 = join5(root, ...path3.split("/"));
     const stat3 = await info(file2);
     if (!stat3?.isFile() || stat3.isSymbolicLink()) {
       problems.push(docProblem("PATH_UNSUPPORTED", path3));
@@ -27497,30 +27767,30 @@ async function readPendingRecords(root, run) {
     if (!id) continue;
     for (const folder of folders) {
       const other = `${RECORDS_ROOT}/${folder}/${id}.md`;
-      if (other !== path3 && !files.has(other) && (await info(join4(root, ...other.split("/"))))?.isFile()) problems.push(docProblem("DUPLICATE_RECORD_ID", path3, { id, other }));
+      if (other !== path3 && !files.has(other) && (await info(join5(root, ...other.split("/"))))?.isFile()) problems.push(docProblem("DUPLICATE_RECORD_ID", path3, { id, other }));
     }
   }
   return { files, altered: altered.sort(), problems };
 }
 
 // src/adapters/filesystem/config-file.ts
-import { lstat as lstat4, readFile as readFile4, realpath, mkdir as mkdir2, open as open2, link, rename, unlink } from "node:fs/promises";
-import { join as join5 } from "node:path";
+import { lstat as lstat5, readFile as readFile4, realpath, mkdir as mkdir2, open as open2, link, rename, unlink } from "node:fs/promises";
+import { join as join6 } from "node:path";
 import { randomUUID as randomUUID2 } from "node:crypto";
 var missing = (error62) => error62.code === "ENOENT";
-var fileInfo = (path3) => lstat4(path3).catch((error62) => {
+var fileInfo = (path3) => lstat5(path3).catch((error62) => {
   if (missing(error62)) return void 0;
   throw error62;
 });
 async function configDirectory(root) {
-  const path3 = join5(root, ".gitifact");
+  const path3 = join6(root, ".gitifact");
   const info5 = await fileInfo(path3);
   if (info5 && (!info5.isDirectory() || info5.isSymbolicLink())) throw new InitError("PATH_CONFLICT", t2("config.storeNotDirectory"));
   return info5;
 }
 async function readConfigFile(root) {
   await configDirectory(root);
-  const path3 = join5(root, ".gitifact", "config.json");
+  const path3 = join6(root, ".gitifact", "config.json");
   const info5 = await fileInfo(path3);
   if (!info5) return void 0;
   if (!info5.isFile() || info5.isSymbolicLink() || info5.size > 65536) throw new InitError("PATH_CONFLICT", t2("config.fileShape"));
@@ -27537,7 +27807,7 @@ async function readConfigFile(root) {
   }
 }
 async function publishConfig(root, text4, recheck, beforePublish, replace = false) {
-  const directory = join5(root, ".gitifact");
+  const directory = join6(root, ".gitifact");
   await configDirectory(root);
   await mkdir2(directory).catch((error62) => {
     if (error62.code !== "EEXIST") throw error62;
@@ -27550,7 +27820,7 @@ async function publishConfig(root, text4, recheck, beforePublish, replace = fals
       throw new InitError("INPUT_CHANGED", t2("config.directoryChanged"));
     }
   };
-  const temporary = join5(directory, ".init-" + randomUUID2() + ".tmp");
+  const temporary = join6(directory, ".init-" + randomUUID2() + ".tmp");
   const handle = await open2(temporary, "wx", 384);
   const tempOwner = await handle.stat();
   try {
@@ -27567,8 +27837,8 @@ async function publishConfig(root, text4, recheck, beforePublish, replace = fals
     const bytes = await readFile4(temporary, "utf8");
     if (bytes !== text4) throw new InitError("INPUT_CHANGED", t2("config.temporaryChanged"));
     parseManagedConfig(bytes);
-    if (replace) await rename(temporary, join5(directory, "config.json"));
-    else await link(temporary, join5(directory, "config.json"));
+    if (replace) await rename(temporary, join6(directory, "config.json"));
+    else await link(temporary, join6(directory, "config.json"));
   } finally {
     await unchanged();
     const current2 = await fileInfo(temporary);
@@ -27577,11 +27847,11 @@ async function publishConfig(root, text4, recheck, beforePublish, replace = fals
 }
 
 // src/adapters/filesystem/instruction-folder.ts
-import { lstat as lstat5, open as open3, readdir as readdir4, readFile as readFile5 } from "node:fs/promises";
-import { join as join6 } from "node:path";
+import { lstat as lstat6, open as open3, readdir as readdir4, readFile as readFile5 } from "node:fs/promises";
+import { join as join7 } from "node:path";
 var INSTRUCTION_FILE_LIMIT = 500;
 var INSTRUCTION_TEXT_LIMIT = 512 * 1024;
-var folderOf2 = (root, instructionPath) => join6(root, ...instructionPath.split("/").slice(0, -1));
+var folderOf3 = (root, instructionPath) => join7(root, ...instructionPath.split("/").slice(0, -1));
 async function listInstructionFiles(root, instructionPath) {
   const files = [];
   let limited = false;
@@ -27594,21 +27864,21 @@ async function listInstructionFiles(root, instructionPath) {
         return;
       }
       const path3 = prefix + entry2.name;
-      if (entry2.isDirectory()) await visit2(join6(folder, entry2.name), path3 + "/", depth + 1);
-      else if (entry2.isFile() && path3 !== INSTRUCTION_FILE) files.push({ path: path3, size: (await lstat5(join6(folder, entry2.name))).size });
+      if (entry2.isDirectory()) await visit2(join7(folder, entry2.name), path3 + "/", depth + 1);
+      else if (entry2.isFile() && path3 !== INSTRUCTION_FILE) files.push({ path: path3, size: (await lstat6(join7(folder, entry2.name))).size });
     }
   }
-  await visit2(folderOf2(root, instructionPath), "", 0);
+  await visit2(folderOf3(root, instructionPath), "", 0);
   return { files, limited };
 }
 var FRONTMATTER_WINDOW = 8 * 1024;
 async function describeFiles(root, instructionPath, files) {
-  const folder = folderOf2(root, instructionPath);
+  const folder = folderOf3(root, instructionPath);
   return Promise.all(files.map(async (file2) => {
     if (!isInstructionReference(file2.path)) return file2;
     let handle;
     try {
-      handle = await open3(join6(folder, ...file2.path.split("/")), "r");
+      handle = await open3(join7(folder, ...file2.path.split("/")), "r");
       const buffer = Buffer.alloc(Math.min(FRONTMATTER_WINDOW, file2.size));
       const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
       return { ...file2, ...parseInstructionFile(file2.path, buffer.subarray(0, bytesRead).toString("utf8")) };
@@ -27626,13 +27896,13 @@ async function readInstructionFiles(root, instructionPath) {
 async function readInstructionFile(root, instructionPath, path3) {
   const parts = path3.split("/");
   if (parts.some((p) => !p || p === "." || p === ".." || /[\\:\0]/.test(p))) return void 0;
-  let full = folderOf2(root, instructionPath);
+  let full = folderOf3(root, instructionPath);
   for (const [index, part] of parts.entries()) {
-    full = join6(full, part);
-    const info5 = await lstat5(full).catch(() => void 0);
+    full = join7(full, part);
+    const info5 = await lstat6(full).catch(() => void 0);
     if (!info5 || info5.isSymbolicLink() || (index < parts.length - 1 ? !info5.isDirectory() : !info5.isFile())) return void 0;
   }
-  const size = (await lstat5(full)).size;
+  const size = (await lstat6(full)).size;
   if (size > INSTRUCTION_TEXT_LIMIT) return { text: null, size, binary: false, tooLarge: true };
   const bytes = await readFile5(full);
   try {
@@ -27644,12 +27914,12 @@ async function readInstructionFile(root, instructionPath, path3) {
 }
 
 // src/adapters/filesystem/agents-file.ts
-import { lstat as lstat6, readFile as readFile6 } from "node:fs/promises";
-import { join as join7 } from "node:path";
+import { lstat as lstat7, readFile as readFile6 } from "node:fs/promises";
+import { join as join8 } from "node:path";
 var LIMIT = 1024 * 1024;
 async function readAgentsFile(root) {
-  const file2 = join7(root, "AGENTS.md");
-  const info5 = await lstat6(file2).catch(() => void 0);
+  const file2 = join8(root, "AGENTS.md");
+  const info5 = await lstat7(file2).catch(() => void 0);
   if (!info5?.isFile() || info5.size > LIMIT) return null;
   try {
     return new TextDecoder("utf-8", { fatal: true, ignoreBOM: false }).decode(await readFile6(file2));
@@ -27726,8 +27996,8 @@ async function documentsAtHead(project, head, paths2) {
 
 // src/server/checkout/stamp.ts
 import { createHash as createHash2 } from "node:crypto";
-import { lstat as lstat7 } from "node:fs/promises";
-import { join as join8 } from "node:path";
+import { lstat as lstat8 } from "node:fs/promises";
+import { join as join9 } from "node:path";
 function createStampReader(root, inherited = process.env) {
   const runner = createGitRunner();
   const env = { ...inherited, GIT_OPTIONAL_LOCKS: "0", GIT_NO_REPLACE_OBJECTS: "1", GIT_TERMINAL_PROMPT: "0", GIT_LITERAL_PATHSPECS: "0", LC_ALL: "C" };
@@ -27739,7 +28009,7 @@ function createStampReader(root, inherited = process.env) {
     ]);
     const paths2 = status.split("\0").filter(Boolean).map((entry2) => entry2.slice(3)).filter((path3) => !path3.startsWith(".gitifact/cache/"));
     const seen = await Promise.all(paths2.map(async (path3) => {
-      const info5 = await lstat7(join8(root, ...path3.split("/"))).catch(() => void 0);
+      const info5 = await lstat8(join9(root, ...path3.split("/"))).catch(() => void 0);
       return path3 + "	" + (info5 ? info5.mtimeMs + ":" + info5.size : "-");
     }));
     return createHash2("sha256").update(head.trim() + "\n" + seen.sort().join("\n")).digest("hex").slice(0, 20);
@@ -27747,19 +28017,14 @@ function createStampReader(root, inherited = process.env) {
 }
 
 // src/server/checkout/checkout-reader.ts
-var tally = (people, name2, email3, latest) => {
-  const person = people.get(email3);
-  if (person) person.commits++;
-  else people.set(email3, { name: name2, email: email3, latest, commits: 1 });
-};
 async function settled(reads) {
   const results = await Promise.allSettled(reads);
   const failure2 = results.find((r) => r.status === "rejected");
   if (failure2) throw failure2.reason;
   return results.map((r) => r.value);
 }
-var folderOf3 = (path3) => path3.split("/").slice(0, 3).join("/");
-function checkoutDocuments(states) {
+var folderOf4 = (path3) => path3.split("/").slice(0, 3).join("/");
+function checkoutDocuments(states, authors) {
   const documents = states.documents;
   const standing2 = (id) => {
     const previousPath = states.previousPath(id);
@@ -27772,30 +28037,45 @@ function checkoutDocuments(states) {
     return { id: s.id, ...target ? { title: target.title, path: target.path } : {}, ...s.note ? { note: s.note } : {} };
   };
   const arranged = arrangeDocuments(documents);
-  const features = arranged.features.map(({ index, requirements, designs }) => ({
-    id: index.id,
-    path: index.path,
-    title: index.title,
-    description: index.description,
-    body: index.body,
-    ...standing2(index.id),
-    requirements: requirements.map((r) => ({ id: r.id, path: r.path, title: r.title, description: r.description, order: r.order, body: r.body, ...standing2(r.id) })),
-    designs: designs.map((d) => ({
-      id: d.id,
-      path: d.path,
-      title: d.title,
-      description: d.description,
-      order: d.order,
-      body: d.body,
-      requirements: d.requirements,
-      sources: d.sources.map(source2),
-      ...standing2(d.id)
-    }))
+  const features = arranged.features.map(({ index, requirements, designs }) => {
+    const entry2 = authors.get(folderOf4(index.path));
+    return {
+      id: index.id,
+      path: index.path,
+      title: index.title,
+      description: index.description,
+      body: index.body,
+      ...standing2(index.id),
+      requirements: requirements.map((r) => ({ id: r.id, path: r.path, title: r.title, description: r.description, order: r.order, body: r.body, ...standing2(r.id) })),
+      designs: designs.map((d) => ({
+        id: d.id,
+        path: d.path,
+        title: d.title,
+        description: d.description,
+        order: d.order,
+        body: d.body,
+        requirements: d.requirements,
+        sources: d.sources.map(source2),
+        ...standing2(d.id)
+      })),
+      // Who committed to the feature folder, most first, and when it was last touched; nobody until first committed.
+      contributors: entry2?.people ?? [],
+      updatedAt: entry2?.latest ?? null
+    };
+  });
+  const instructions2 = arranged.instructions.map((k) => ({
+    id: k.id,
+    name: k.name,
+    path: k.path,
+    title: k.title,
+    description: k.description,
+    body: k.body,
+    ...standing2(k.id),
+    updatedAt: authors.get(folderOf4(k.path))?.latest ?? null
   }));
-  const instructions2 = arranged.instructions.map((k) => ({ id: k.id, name: k.name, path: k.path, title: k.title, description: k.description, body: k.body, ...standing2(k.id) }));
   return { features, instructions: instructions2, orphans: arranged.orphans };
 }
-function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
+function createCheckoutReader(root, cache, inherited = process.env) {
   const reader = storeReader(root);
   const runner = createGitRunner();
   const env = { ...inherited, GIT_OPTIONAL_LOCKS: "0", GIT_NO_REPLACE_OBJECTS: "1", GIT_TERMINAL_PROMPT: "0", LC_ALL: "C" };
@@ -27808,87 +28088,36 @@ function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
   };
   const pending = /* @__PURE__ */ new Map();
   const readStamp = createStampReader(root, inherited);
-  const notMigration = ["-E", "--invert-grep", `--grep=^${MIGRATION_TRAILER}: `];
-  async function storeAuthors(head) {
-    const text4 = await git(["log", ...notMigration, "--format=%x1e%aN%x00%aE%x00%aI", "-z", "--name-only", "--no-renames", "--max-count=20000", head, "--", ".gitifact/spec", INSTRUCTIONS_ROOT, "AGENTS.md"]);
-    const folders = /* @__PURE__ */ new Map();
-    const instructions2 = /* @__PURE__ */ new Map();
-    for (const chunk of text4.split("")) {
-      if (!chunk) continue;
-      const [name2, email3, date5, ...paths2] = chunk.split("\0");
-      if (!name2 || !email3 || !date5) throw new StoreError(t2("specReader.authorUnreadable"));
-      const seen = /* @__PURE__ */ new Set();
-      for (const raw of paths2) {
-        const path3 = raw.replace(/^\n/, "");
-        if (!path3) continue;
-        const folder = /^(\.gitifact\/spec\/[^/]+)\//.exec(path3)?.[1];
-        if (folder && !seen.has(folder)) {
-          seen.add(folder);
-          let entry2 = folders.get(folder);
-          if (!entry2) folders.set(folder, entry2 = { people: /* @__PURE__ */ new Map(), count: 0, latest: date5 });
-          if (entry2.count < 2e3) {
-            entry2.count++;
-            tally(entry2.people, name2, email3, date5);
-          }
-        }
-        const instruction2 = path3 === "AGENTS.md" ? path3 : /^(\.gitifact\/instructions\/[^/]+)\//.exec(path3)?.[1];
-        if (instruction2 && !instructions2.has(instruction2)) instructions2.set(instruction2, date5);
-      }
-    }
-    return { folders, instructions: instructions2 };
-  }
   async function read() {
     const raw = await readConfigFile(root);
     if (!raw) throw new StoreError(t2("specReader.schemaRequired"));
     parseManagedConfig(raw);
     const head = await readHead();
     const stamp = await readStamp();
-    const [current2, dirty, authors, everyone] = await settled([
+    const [current2, dirty, authors, people] = await settled([
       cache.documents.list(),
       head ? git(["status", "--porcelain=v1", "--", ".gitifact/spec", INSTRUCTIONS_ROOT]) : Promise.resolve(""),
-      head ? storeAuthors(head) : Promise.resolve(void 0),
-      // Git mailmap may change without a new HEAD; refresh names with every observation that carries them.
-      head ? git(["log", ...notMigration, "--format=%aN%x00%aE%x00%aI", "--max-count=10001", head]) : Promise.resolve("")
+      // Who touched each folder and who committed at all, counted over the commit log in the cache.
+      head ? cache.log.folders(head) : Promise.resolve(/* @__PURE__ */ new Map()),
+      head ? cache.log.contributors(head) : Promise.resolve([])
     ]);
-    const people = /* @__PURE__ */ new Map();
-    const lines = everyone.trim().split("\n").filter(Boolean);
-    for (const line2 of lines.slice(0, 1e4)) {
-      const [name2, email3, latest] = line2.split("\0");
-      if (!name2 || !email3 || !latest) throw new StoreError(t2("specReader.authorUnreadable"));
-      tally(people, name2, email3, latest);
-    }
     const states = await documentStates({ head: async () => head, reader }, current2.documents);
-    const arranged = checkoutDocuments(states);
-    const features = arranged.features.map((feature2) => {
-      const entry2 = authors?.folders.get(folderOf3(feature2.path));
-      return { ...feature2, contributors: entry2 ? [...entry2.people.values()].sort((a, b) => b.commits - a.commits) : [], updatedAt: entry2?.latest ?? null };
-    });
-    const instructions2 = await Promise.all(arranged.instructions.map(async (instruction2) => {
-      const { files, limited } = instruction2.state === "deleted" ? { files: [], limited: false } : await readInstructionFiles(root, instruction2.path);
-      return { ...instruction2, files, filesLimited: limited, updatedAt: authors?.instructions.get(instruction2.path.split("/").slice(0, 3).join("/")) ?? null };
-    }));
-    const agentsText = await readAgentsFile(root);
-    const agents2 = agentsText === null ? null : { path: "AGENTS.md", body: agentsText, updatedAt: authors?.instructions.get("AGENTS.md") ?? null };
-    const problems = [...current2.problems, ...arranged.orphans.map((feature2) => docProblem("FEATURE_INDEX_REQUIRED", `.gitifact/spec/${feature2}/index.md`, { feature: feature2 }))];
+    const { features, instructions: instructions2, orphans } = checkoutDocuments(states, authors);
+    const problems = [...current2.problems, ...orphans.map((feature2) => docProblem("FEATURE_INDEX_REQUIRED", `.gitifact/spec/${feature2}/index.md`, { feature: feature2 }))];
     if (await readHead() !== head) throw new StoreError(t2("specReader.projectChanged"));
-    const checkout = browserSpecsV7.parse({
-      contract: "browser-specs",
-      version: 7,
-      sessionId,
+    return {
       head,
-      observedAt: (/* @__PURE__ */ new Date()).toISOString(),
       stamp,
+      observedAt: (/* @__PURE__ */ new Date()).toISOString(),
       working: head ? !!dirty.trim() : features.length > 0 || instructions2.length > 0,
       features,
       instructions: instructions2,
-      agents: agents2,
       problems,
-      contributors: [...people.values()].sort((a, b) => b.commits - a.commits),
-      contributorsLimited: lines.length > 1e4
-    });
-    return { checkout, head };
+      people,
+      folders: authors
+    };
   }
-  return () => {
+  const base = () => {
     const language = getLanguage();
     let value = pending.get(language);
     if (!value) {
@@ -27897,10 +28126,37 @@ function createCheckoutReader(root, sessionId, cache, inherited = process.env) {
     }
     return value;
   };
+  return {
+    base,
+    /** Every instruction by name with the other files of its folder, and AGENTS.md: few enough to read whole. */
+    async instructions() {
+      const checkout = await base();
+      const instructions2 = await Promise.all([...checkout.instructions].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0).map(async (instruction2) => {
+        const { files, limited } = instruction2.state === "deleted" ? { files: [], limited: false } : await readInstructionFiles(root, instruction2.path);
+        return { ...instruction2, files, filesLimited: limited };
+      }));
+      const agentsText = await readAgentsFile(root);
+      return { instructions: instructions2, agents: agentsText === null ? null : { path: "AGENTS.md", body: agentsText, updatedAt: checkout.folders.get("AGENTS.md")?.latest ?? null } };
+    }
+  };
+}
+
+// src/queries/paging.ts
+var PAGE_SIZE = 20;
+function pageOf(rows, keyOf, request) {
+  let start = 0;
+  if (request.after !== void 0) {
+    const at = rows.findIndex((row) => keyOf(row) === request.after);
+    if (at < 0) return void 0;
+    start = at + 1;
+  }
+  const size = request.all ? rows.length : request.limit ?? PAGE_SIZE;
+  const shown = rows.slice(start, start + size);
+  const more = start + shown.length < rows.length && shown.length > 0;
+  return { rows: shown, total: rows.length, next: more ? keyOf(shown[shown.length - 1]) : null };
 }
 
 // src/server/commit/commit-files.ts
-var LIST_LIMIT = 500;
 var TEXT_LIMIT = 512 * 1024;
 var KEPT = 200;
 var statusOf = (code) => code.startsWith("R") ? "renamed" : code === "A" ? "added" : code === "D" ? "deleted" : "modified";
@@ -27956,10 +28212,15 @@ function createCommitFiles(git) {
     return git.run(["cat-file", "blob", `${rev}:${path3}`]);
   }
   return {
-    /** The first `LIST_LIMIT` source files and how many there are; undefined for a commit the repository lacks. */
-    async files(commit) {
+    /**
+     * A page of the source files after the file `after` (a path) and how many there are in all: undefined for a commit
+     * the repository lacks, null for a cursor the commit does not have.
+     */
+    async files(commit, request) {
       const all = await list(commit);
-      return all && { ...all, files: all.files.slice(0, LIST_LIMIT) };
+      if (!all) return void 0;
+      const page = pageOf(all.files, (f) => f.path, request);
+      return page ? { ...all, files: page.rows, next: page.next } : null;
     },
     /** One listed file on both sides; undefined when the commit did not change that path. */
     async file(commit, path3) {
@@ -28041,31 +28302,200 @@ async function workingChange2(source2, id) {
   };
 }
 
+// src/queries/search.ts
+var SEARCH_GROUPS = ["feature", "requirement", "design", "instruction", "record", "commit"];
+var FIRST = 5;
+var RECENT = 6;
+var place2 = (path3) => path3.replace(/^\.gitifact\//, "");
+var folderOf5 = (path3) => path3.split("/").slice(0, 3).join("/");
+async function searchRecords(source2, request) {
+  const head = request.head ?? await source2.head();
+  const query = request.q.trim().toLowerCase();
+  if (!query) return [await recent(source2, head)];
+  const size = request.group ? request.limit ?? 20 : FIRST;
+  const one = async (group) => {
+    const found = group === "record" ? head ? await source2.cache.history.searchRecords(head, query, request.after, size) : empty() : group === "commit" ? head ? await source2.cache.log.commitsNamed(head, query, request.after, size) : empty() : await source2.cache.documents.searchKind(group, query, request.after, size);
+    return found && { group, ...found };
+  };
+  const groups = await Promise.all((request.group ? [request.group] : SEARCH_GROUPS).map(one));
+  if (groups.some((g) => !g)) return void 0;
+  return groups.filter((g) => request.group || g.total > 0);
+}
+var empty = () => ({ total: 0, next: null, hits: [] });
+async function recent(source2, head) {
+  const [{ documents }, folders] = await Promise.all([source2.cache.documents.list(), head ? source2.cache.log.folders(head) : /* @__PURE__ */ new Map()]);
+  const hits = documents.filter((d) => d.kind === "feature" || d.kind === "instruction").map((d) => ({ doc: d, latest: folders.get(folderOf5(d.path))?.latest })).filter((d) => !!d.latest).sort((a, b) => Date.parse(b.latest) - Date.parse(a.latest) || a.doc.id.localeCompare(b.doc.id)).slice(0, RECENT).map(({ doc }) => ({
+    id: doc.id,
+    kind: doc.kind,
+    title: doc.title,
+    where: place2(doc.path),
+    line: doc.description,
+    ...doc.kind === "feature" ? { featureId: doc.id } : {}
+  }));
+  return { group: "recent", total: hits.length, next: null, hits };
+}
+
+// src/queries/checkout.ts
+var SHOWN_REQUIREMENTS = 12;
+function checkoutIndex(base) {
+  return {
+    features: base.features.map((f) => ({
+      id: f.id,
+      path: f.path,
+      title: f.title,
+      state: f.state,
+      requirements: f.requirements.map((r) => ({ id: r.id, path: r.path, title: r.title, description: r.description })),
+      designs: f.designs.map((d) => ({ id: d.id, path: d.path, title: d.title }))
+    })),
+    instructions: base.instructions.map((k) => ({ id: k.id, name: k.name, path: k.path, title: k.title })),
+    people: base.people.map((p) => ({ name: p.name, email: p.email }))
+  };
+}
+var acceptanceHeading = /^###\s+(?:수용 조건|acceptance criteria)\s*$/i;
+function acceptanceCount(body2) {
+  const lines = body2.replace(/\r\n/g, "\n").split("\n");
+  const start = lines.findIndex((line2) => acceptanceHeading.test(line2.trim()));
+  if (start < 0) return null;
+  let count2 = 0;
+  for (const line2 of lines.slice(start + 1)) {
+    if (/^#{1,6}\s/.test(line2)) break;
+    if (/^\d+\.\s/.test(line2)) count2++;
+  }
+  return count2 || null;
+}
+function listFeatures(base, filter, request) {
+  const query = filter.q?.trim().toLowerCase();
+  const named = (f) => !query || (f.title + " " + f.id).toLowerCase().includes(query);
+  const key = filter.sort ?? "updated";
+  const opens = { title: "asc", requirements: "desc", updated: "desc" };
+  const way = (filter.dir ?? opens[key]) === "asc" ? 1 : -1;
+  const groups = base.features.filter((f) => !filter.design || filter.design === "yes" === f.designs.length > 0).filter((f) => !filter.author || f.contributors.some((p) => p.email === filter.author)).map((f) => ({ feature: f, requirements: named(f) ? f.requirements : f.requirements.filter((r) => (r.title + " " + r.id).toLowerCase().includes(query)) })).filter((g) => named(g.feature) || g.requirements.length).sort((a, b) => way * (key === "requirements" ? a.feature.requirements.length - b.feature.requirements.length : key === "title" ? a.feature.title.localeCompare(b.feature.title) : (a.feature.updatedAt ?? "").localeCompare(b.feature.updatedAt ?? "")) || a.feature.title.localeCompare(b.feature.title));
+  const page = pageOf(groups, (g) => g.feature.id, request);
+  if (!page) return void 0;
+  const features = page.rows.map(({ feature: f, requirements }) => {
+    const designed = new Set(f.designs.flatMap((d) => d.requirements));
+    return {
+      id: f.id,
+      path: f.path,
+      title: f.title,
+      description: f.description,
+      state: f.state,
+      designs: f.designs.length,
+      contributors: f.contributors,
+      updatedAt: f.updatedAt,
+      requirementCount: f.requirements.length,
+      requirements: requirements.slice(0, SHOWN_REQUIREMENTS).map((r) => ({
+        id: r.id,
+        title: r.title,
+        description: r.description,
+        state: r.state,
+        acceptance: acceptanceCount(r.body),
+        designed: designed.has(r.id)
+      })),
+      hidden: Math.max(0, requirements.length - SHOWN_REQUIREMENTS)
+    };
+  });
+  return {
+    total: page.total,
+    all: base.features.length,
+    requirements: groups.reduce((sum, g) => sum + g.requirements.length, 0),
+    mostRequirements: Math.max(0, ...base.features.map((f) => f.requirements.length)),
+    next: page.next,
+    features
+  };
+}
+var featureOf = (base, id) => base.features.find((f) => f.id === id);
+function listContributors(base, q, request) {
+  const query = q?.trim().toLowerCase();
+  const people = base.people.filter((p) => !query || (p.name + " " + p.email).toLowerCase().includes(query));
+  const page = pageOf(people, (p) => p.email, request);
+  if (!page) return void 0;
+  const touched = (email3) => base.features.filter((f) => f.contributors.some((c) => c.email === email3)).length;
+  return { total: page.total, next: page.next, people: page.rows.map((p) => ({ ...p, features: touched(p.email) })) };
+}
+function contributorOf(base, email3) {
+  const person = base.people.find((p) => p.email === email3);
+  if (!person) return void 0;
+  const features = base.features.flatMap((f) => {
+    const share = f.contributors.find((c) => c.email === email3);
+    return share ? [{ id: f.id, title: f.title, commits: share.commits, requirements: f.requirements.length }] : [];
+  });
+  return { person, features };
+}
+function topContributors(people) {
+  const rest = people.slice(3);
+  return { total: people.length, top: people.slice(0, 3), rest: { count: rest.length, commits: rest.reduce((sum, p) => sum + p.commits, 0) } };
+}
+
 // src/server/routes/record-routes.ts
 var PAGE = 20;
 function recordRoutes(root, sessionId, env) {
   const git = storeReader(root);
   const cache = openCache(root, { run: (args, input2) => git.run(args, input2), decode: git.decode, legacyBundles: (oids) => git.readBundles(oids) });
-  const readCheckout = createCheckoutReader(root, sessionId, cache, env);
+  const checkout = createCheckoutReader(root, cache, env);
   const readStamp = createStampReader(root, env);
   const commitFiles = createCommitFiles(git);
+  const source2 = { head: async () => (await git.baseline()).head, reader: git, cache };
   const working2 = { head: async () => (await git.baseline()).head, cache, pendingRecords: () => readPendingRecords(root, (args) => git.run(args)) };
   const unreadable2 = () => t2("server.specsUnreadable");
-  const cursorGone = () => new HttpError(404, "NOT_FOUND", t2("server.cursorNotFound"));
+  const cursorGone2 = () => new HttpError(404, "NOT_FOUND", t2("server.cursorNotFound"));
   return [
-    route({ method: "GET", path: "/api/v1/specs", session: true, unreadable: unreadable2, handle: async () => ok((await readCheckout()).checkout) }),
+    // The checkout a part at a time, each shaped by the query layer (`queries/checkout.ts`): the frame every screen reads
+    // first, the feature list and one feature, the instructions, and the contributors.
+    route({ method: "GET", path: "/api/v1/checkout", session: true, unreadable: unreadable2, handle: async () => {
+      const base = await checkout.base();
+      return ok(browserCheckoutV1.parse({
+        contract: "browser-checkout",
+        version: 1,
+        sessionId,
+        head: base.head,
+        observedAt: base.observedAt,
+        stamp: base.stamp,
+        working: base.working,
+        problems: base.problems,
+        index: checkoutIndex(base)
+      }));
+    } }),
+    route({ method: "GET", path: "/api/v1/features", session: true, query: browserFeaturesQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const page = listFeatures(await checkout.base(), query, { after: query.after, limit: query.limit ?? PAGE });
+      if (!page) throw cursorGone2();
+      return ok(browserFeaturesV1.parse({ contract: "browser-features", version: 1, sessionId, ...page }));
+    } }),
+    route({ method: "GET", path: "/api/v1/feature", session: true, query: browserFeatureQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const feature2 = featureOf(await checkout.base(), query.id);
+      if (!feature2) throw new HttpError(404, "NOT_FOUND", t2("server.featureNotFound"));
+      return ok(browserFeatureV1.parse({ contract: "browser-feature", version: 1, sessionId, feature: feature2 }));
+    } }),
+    route({ method: "GET", path: "/api/v1/instructions", session: true, unreadable: unreadable2, handle: async () => ok(browserInstructionsV1.parse({ contract: "browser-instructions", version: 1, sessionId, ...await checkout.instructions() })) }),
+    route({ method: "GET", path: "/api/v1/contributors", session: true, query: browserContributorsQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const page = listContributors(await checkout.base(), query.q, { after: query.after, limit: query.limit ?? PAGE });
+      if (!page) throw cursorGone2();
+      return ok(browserContributorsV1.parse({ contract: "browser-contributors", version: 1, sessionId, ...page }));
+    } }),
+    route({ method: "GET", path: "/api/v1/contributor", session: true, query: browserContributorQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
+      const found = contributorOf(await checkout.base(), query.email);
+      if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.contributorNotFound"));
+      return ok(browserContributorV1.parse({ contract: "browser-contributor", version: 1, sessionId, ...found }));
+    } }),
     // Whether the screen is behind, asked when the reader comes back to the tab; cheap enough to ask every time.
     route({ method: "GET", path: "/api/v1/stamp", session: true, unreadable: unreadable2, handle: async () => ok(browserStampV1.parse({ contract: "browser-stamp", version: 1, sessionId, stamp: await readStamp() })) }),
     route({ method: "GET", path: "/api/v1/history", session: true, query: browserHistoryQueryV4, unreadable: unreadable2, handle: async ({ query }) => {
       const page = await cache.history.commits(query.head, { kind: query.kind, document: query.document, feature: query.feature, author: query.author, q: query.q }, query.after, query.limit ?? PAGE);
-      if (!page) throw cursorGone();
+      if (!page) throw cursorGone2();
       return ok(browserHistoryV6.parse({ contract: "browser-history", version: 6, sessionId, head: query.head, ...page }));
     } }),
-    route({ method: "GET", path: "/api/v1/history/summary", session: true, query: browserHistorySummaryQueryV1, unreadable: unreadable2, handle: async ({ query }) => ok(browserHistorySummaryV4.parse({ contract: "browser-history-summary", version: 4, sessionId, head: query.head, ...await cache.history.summary(query.head) })) }),
+    route({ method: "GET", path: "/api/v1/history/summary", session: true, query: browserHistorySummaryQueryV1, unreadable: unreadable2, handle: async ({ query }) => ok(browserHistorySummaryV5.parse({
+      contract: "browser-history-summary",
+      version: 5,
+      sessionId,
+      head: query.head,
+      ...await cache.history.summary(query.head),
+      people: topContributors(await cache.log.contributors(query.head))
+    })) }),
     // One commit as its page reads it: who made it and a page of the documents it changed, even when it changed none.
-    route({ method: "GET", path: "/api/v1/commit", session: true, query: browserCommitQueryV2, unreadable: unreadable2, handle: async ({ query }) => {
-      const page = await cache.history.commitChanges(query.commit, query.after, query.limit ?? PAGE);
-      if (!page) throw cursorGone();
+    route({ method: "GET", path: "/api/v1/commit", session: true, query: browserCommitQueryV3, unreadable: unreadable2, handle: async ({ query }) => {
+      const page = await cache.history.commitChanges(query.commit, query.after, query.limit ?? PAGE, query.record);
+      if (!page) throw cursorGone2();
       const first = page.events[0];
       const line2 = first ? [] : git.decode(await git.run(["log", "-1", "--format=%aN%x00%aE%x00%cN%x00%aI%x00%s", query.commit, "--"]).catch(() => Buffer.from(""))).split("\0");
       if (!first && line2.length < 5) throw new HttpError(404, "NOT_FOUND", t2("server.commitNotFound"));
@@ -28093,9 +28523,9 @@ function recordRoutes(root, sessionId, env) {
     } }),
     // A record's page names the record; which commit added it is read from the history of the HEAD the reader is on.
     route({ method: "GET", path: "/api/v1/record", session: true, query: browserRecordQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
-      const commit = await cache.history.commitOfRecord(query.head, query.id);
-      if (!commit) throw new HttpError(404, "NOT_FOUND", t2("server.recordNotFound"));
-      return ok(browserRecordV1.parse({ contract: "browser-record", version: 1, sessionId, head: query.head, id: query.id, commit }));
+      const found = await cache.history.recordOf(query.head, query.id);
+      if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.recordNotFound"));
+      return ok(browserRecordV2.parse({ contract: "browser-record", version: 2, sessionId, head: query.head, id: query.id, ...found }));
     } }),
     // What is not committed yet, worked out again on every request: the uncommitted entry of the records list.
     route({ method: "GET", path: "/api/v1/working", session: true, unreadable: unreadable2, handle: async () => ok(browserWorkingV1.parse({ contract: "browser-working", version: 1, sessionId, ...await workingOverview(working2) })) }),
@@ -28105,10 +28535,11 @@ function recordRoutes(root, sessionId, env) {
       return ok(browserWorkingChangeV1.parse({ contract: "browser-working-change", version: 1, sessionId, ...change2 }));
     } }),
     // The source a commit changed beside its documents, read from Git when the commit or record page asks for it.
-    route({ method: "GET", path: "/api/v1/commit/files", session: true, query: browserCommitFilesQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
-      const found = await commitFiles.files(query.commit);
-      if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.commitNotFound"));
-      return ok(browserCommitFilesV1.parse({ contract: "browser-commit-files", version: 1, sessionId, commit: found.commit, total: found.total, files: found.files }));
+    route({ method: "GET", path: "/api/v1/commit/files", session: true, query: browserCommitFilesQueryV2, unreadable: unreadable2, handle: async ({ query }) => {
+      const found = await commitFiles.files(query.commit, { after: query.after, limit: query.limit ?? PAGE });
+      if (found === void 0) throw new HttpError(404, "NOT_FOUND", t2("server.commitNotFound"));
+      if (found === null) throw cursorGone2();
+      return ok(browserCommitFilesV2.parse({ contract: "browser-commit-files", version: 2, sessionId, commit: found.commit, total: found.total, next: found.next, files: found.files }));
     } }),
     route({ method: "GET", path: "/api/v1/commit/file", session: true, query: browserCommitFileQueryV1, unreadable: unreadable2, handle: async ({ query }) => {
       const found = await commitFiles.file(query.commit, query.path);
@@ -28122,21 +28553,26 @@ function recordRoutes(root, sessionId, env) {
       if (!found) throw new HttpError(404, "NOT_FOUND", t2("server.instructionFileNotFound"));
       return ok(browserInstructionFileV1.parse({ contract: "browser-instruction-file", version: 1, sessionId, id: query.id, path: query.path, ...found }));
     } }),
-    route({ method: "GET", path: "/api/v1/search", session: true, query: browserSearchQueryV1, unreadable: unreadable2, handle: async ({ query }) => ok(browserSearchV2.parse({ contract: "browser-search", version: 2, sessionId, query: query.q, hits: await cache.search(query.head ?? null, query.q) })) })
+    // The search box's groups as the query layer works them out (`queries/search.ts`); the browser only draws them.
+    route({ method: "GET", path: "/api/v1/search", session: true, query: browserSearchQueryV2, unreadable: unreadable2, handle: async ({ query }) => {
+      const groups = await searchRecords(source2, query);
+      if (!groups) throw cursorGone2();
+      return ok(browserSearchV3.parse({ contract: "browser-search", version: 3, sessionId, query: query.q, groups }));
+    } })
   ];
 }
 
 // src/server/routes/asset-routes.ts
-import { lstat as lstat8, readFile as readFile7 } from "node:fs/promises";
-import { join as join9 } from "node:path";
+import { lstat as lstat9, readFile as readFile7 } from "node:fs/promises";
+import { join as join10 } from "node:path";
 function assetRoutes(root) {
   return [
     route({ method: "GET", path: "/api/v1/assets/*", session: false, handle: async ({ path: path3, response }) => {
       const relative = path3.slice("/api/v1/assets/".length);
       const assetPath = ASSETS_DIR + "/" + relative;
       if (!isAssetPath(assetPath)) throw new HttpError(404, "NOT_FOUND", t2("server.assetNotFound"));
-      const file2 = join9(root, ...assetPath.split("/"));
-      const stat3 = await lstat8(file2).catch(() => void 0);
+      const file2 = join10(root, ...assetPath.split("/"));
+      const stat3 = await lstat9(file2).catch(() => void 0);
       if (!stat3?.isFile() || stat3.isSymbolicLink() || stat3.size > 20 * 1024 * 1024) throw new HttpError(404, "NOT_FOUND", t2("server.assetNotFound"));
       const bytes = await readFile7(file2);
       const extension = assetExtension(relative);
@@ -28286,13 +28722,13 @@ async function runBrowser(options, version2) {
 
 // src/commands/spec-init.ts
 import { readdir as readdir5 } from "node:fs/promises";
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 
 // src/adapters/git/init-repository.ts
 import { createHash as createHash3 } from "node:crypto";
-import { lstat as lstat9, readFile as readFile9 } from "node:fs/promises";
-import { join as join10 } from "node:path";
-var markerPresent = (path3) => lstat9(path3).then(() => true, (error62) => {
+import { lstat as lstat10, readFile as readFile9 } from "node:fs/promises";
+import { join as join11 } from "node:path";
+var markerPresent = (path3) => lstat10(path3).then(() => true, (error62) => {
   if (error62.code === "ENOENT") return false;
   throw error62;
 });
@@ -28315,7 +28751,7 @@ function initRepository(cwd, inherited = process.env) {
       const gitDir = locations.length === 2 ? locations[0] : decodeGitLine(await git(["rev-parse", "--absolute-git-dir"], root));
       const indexPath = locations.length === 2 ? locations[1] : decodeGitLine(await git(["rev-parse", "--path-format=absolute", "--git-path", "index"], root));
       for (const marker2 of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"]) {
-        if (await markerPresent(join10(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+        if (await markerPresent(join11(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
       }
       if (state2.changes.some((change2) => change2.kind === "unmerged")) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
       const index = await readFile9(indexPath).catch((error62) => {
@@ -28353,14 +28789,14 @@ function initRepository(cwd, inherited = process.env) {
 
 // src/adapters/filesystem/document-file.ts
 import { randomBytes } from "node:crypto";
-import { lstat as lstat10, mkdir as mkdir3, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { lstat as lstat11, mkdir as mkdir3, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join12 } from "node:path";
 var generateId = (prefix) => prefix + "-" + [...randomBytes(10)].map((n) => "abcdefghijklmnopqrstuvwxyz234567"[n & 31]).join("");
 async function createDocumentFile(root, path3, text4) {
   const parts = path3.split("/");
   for (let i = 1; i < parts.length; i++) {
-    const folder = join11(root, ...parts.slice(0, i));
-    const info5 = await lstat10(folder).catch((error62) => {
+    const folder = join12(root, ...parts.slice(0, i));
+    const info5 = await lstat11(folder).catch((error62) => {
       if (error62.code === "ENOENT") return void 0;
       throw error62;
     });
@@ -28370,7 +28806,7 @@ async function createDocumentFile(root, path3, text4) {
     }
     if (!info5.isDirectory() || info5.isSymbolicLink()) throw Object.assign(new Error(folder), { code: "ENOTDIR" });
   }
-  await writeFile2(join11(root, ...parts), text4, { flag: "wx" });
+  await writeFile2(join12(root, ...parts), text4, { flag: "wx" });
 }
 var LINE_ENDINGS_PATH = ".gitifact/.gitattributes";
 var LINE_ENDINGS = "# Written by gitifact init: documents keep LF on every OS, so what Git holds and the files read the same.\n* text=auto eol=lf\n";
@@ -28386,14 +28822,14 @@ async function writeLineEndings(root) {
 
 // src/adapters/filesystem/managed-file.ts
 import { open as open4, readFile as readFile10, mkdir as mkdir4, realpath as realpath2, rename as rename2, link as link2, unlink as unlink2 } from "node:fs/promises";
-import { join as join12, dirname } from "node:path";
+import { join as join13, dirname } from "node:path";
 import { randomUUID as randomUUID4 } from "node:crypto";
 var DEFAULT_LIMIT = 1024 * 1024;
 async function managedPath(root, path3, create = false) {
   let full = root;
   const parts = path3.split("/");
   for (let i = 0; i < parts.length; i++) {
-    full = join12(full, parts[i]);
+    full = join13(full, parts[i]);
     let info5 = await fileInfo(full);
     if (!info5 && create && i < parts.length - 1) {
       await mkdir4(full).catch((error62) => {
@@ -28441,7 +28877,7 @@ async function managedWrite(root, path3, previous, next, recheck) {
     if (previous !== null) await unlink2(full);
     return;
   }
-  const temp = join12(directory, ".gitifact-managed-" + randomUUID4() + ".tmp");
+  const temp = join13(directory, ".gitifact-managed-" + randomUUID4() + ".tmp");
   const handle = await open4(temp, "wx", 384);
   const tempOwner = await handle.stat();
   try {
@@ -28768,7 +29204,7 @@ async function initializeSpecProject(cwd, dryRun = false, env = process.env, bef
   if (old !== void 0) return existing(old);
   if (first.trackedConfig) throw new InitError("CONFIG_DELETED", t2("init.configDeleted"));
   const checkRecords = async () => {
-    const entries = await readdir5(join13(root, ".gitifact")).catch((e) => {
+    const entries = await readdir5(join14(root, ".gitifact")).catch((e) => {
       if (e.code === "ENOENT") return [];
       throw e;
     });
@@ -28837,16 +29273,16 @@ ${lineEndings}${newer}` : JSON.stringify(dto) + "\n");
 
 // src/commands/documents.ts
 import { readFile as readFile13 } from "node:fs/promises";
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 
 // src/commands/project.ts
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 var operations = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"];
 async function openProject(cwd, options = {}) {
   const reader = storeReader(cwd);
   const location = await reader.location();
   if (options.writing) {
-    for (const marker2 of operations) if (await fileInfo(join14(location.gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+    for (const marker2 of operations) if (await fileInfo(join15(location.gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
     if (await reader.hasUnmerged()) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
   }
   const raw = await readConfigFile(location.root);
@@ -28877,6 +29313,125 @@ function documentsOf(files) {
   return docs;
 }
 
+// src/queries/filters.ts
+function byAuthor(author) {
+  if (author === void 0) return () => true;
+  const wanted = author.trim().toLowerCase();
+  return (change2) => change2.author.toLowerCase() === wanted || change2.email.toLowerCase() === wanted;
+}
+async function since(project, value, head) {
+  if (value === void 0) return () => true;
+  if (/^\d{4}-\d\d-\d\d/.test(value)) {
+    const from = Date.parse(value);
+    if (!Number.isFinite(from)) throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
+    return (change2) => Date.parse(change2.date) >= from;
+  }
+  let commit;
+  try {
+    commit = await project.reader.resolve(value);
+  } catch {
+    throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
+  }
+  if (!head) return () => false;
+  const after = new Set(project.reader.decode(await project.reader.run(["rev-list", `${commit}..${head}`, "--"])).split("\n").filter(Boolean));
+  return (change2) => after.has(change2.commit);
+}
+async function sinceRange(project, value, head) {
+  if (value === void 0) return {};
+  if (/^\d{4}-\d\d-\d\d/.test(value)) {
+    const from = Date.parse(value);
+    if (!Number.isFinite(from)) throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
+    return { from };
+  }
+  let commit;
+  try {
+    commit = await project.reader.resolve(value);
+  } catch {
+    throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
+  }
+  if (!head) return { commits: [] };
+  return { commits: project.reader.decode(await project.reader.run(["rev-list", `${commit}..${head}`, "--"])).split("\n").filter(Boolean) };
+}
+var contains = (query) => {
+  const wanted = query?.trim().toLowerCase();
+  return (...texts) => !wanted || texts.some((value) => value?.toLowerCase().includes(wanted));
+};
+
+// src/queries/specs.ts
+var titledSources = (d, byId) => d.sources.map((s) => "id" in s ? { id: s.id, title: byId.get(s.id)?.title ?? null, ...s.note ? { note: s.note } : {} } : s);
+async function listSpecs(source2, filter, request) {
+  const listed3 = await source2.cache.documents.list();
+  const problems = listed3.problems;
+  const states = await documentStates(source2, listed3.documents);
+  const documents = states.documents;
+  const byId = new Map(documents.map((d) => [d.id, d]));
+  const arranged = arrangeDocuments(documents);
+  let features = arranged.features;
+  if (filter.feature !== void 0) {
+    features = features.filter((f) => f.index.feature === filter.feature);
+    if (!features.length) throw new CommandError("UNKNOWN_FEATURE", t2("docs.unknownFeature", { feature: filter.feature }));
+  }
+  const titled = (id) => ({ id, title: byId.get(id)?.title ?? null });
+  const designsOf = /* @__PURE__ */ new Map();
+  for (const f of arranged.features) for (const d of f.designs) for (const r of d.requirements) designsOf.set(r, [...designsOf.get(r) ?? [], titled(d.id)]);
+  const historyNeeded = filter.sort === "updated" || filter.changedSince !== void 0 || filter.author !== void 0 || !!filter.withUpdated;
+  const latest = /* @__PURE__ */ new Map();
+  const newest = /* @__PURE__ */ new Map();
+  let touched;
+  if (historyNeeded) {
+    const head = await source2.head();
+    const changes2 = head ? await source2.cache.history.changesOf(head) : [];
+    changes2.forEach((c, rank) => {
+      if (!latest.has(c.id)) {
+        latest.set(c.id, { commit: c.commit, date: c.date, author: c.author, email: c.email });
+        newest.set(c.id, rank);
+      }
+    });
+    if (filter.changedSince !== void 0 || filter.author !== void 0) {
+      const after = await since(source2, filter.changedSince, head);
+      const by = byAuthor(filter.author);
+      touched = new Set(changes2.filter((c) => after(c) && by(c)).map((c) => c.id));
+    }
+  }
+  const matched = filter.q !== void 0 ? await source2.cache.documents.matching(filter.q) : void 0;
+  const rows = features.flatMap((f) => [f.index, ...f.requirements, ...f.designs].filter(
+    (doc) => (filter.type === void 0 || doc.kind === filter.type) && (!filter.withoutDesign || !f.designs.length) && (!filter.uncovered || doc.kind === "requirement" && !designsOf.has(doc.id)) && (!filter.draft || doc.draft) && (!touched || touched.has(doc.id)) && (!matched || matched.has(doc.id))
+  ).map((doc) => ({
+    id: doc.id,
+    kind: doc.kind,
+    feature: doc.feature,
+    path: doc.path,
+    title: doc.title,
+    description: doc.description,
+    ...doc.kind === "requirement" || doc.kind === "design" ? { order: doc.order } : {},
+    ...doc.draft ? { draft: true } : {},
+    state: states.state(doc.id),
+    ...states.previousPath(doc.id) ? { previousPath: states.previousPath(doc.id) } : {},
+    ...doc.kind === "design" ? { requirements: doc.requirements.map(titled), sources: titledSources(doc, byId) } : {},
+    ...doc.kind === "requirement" ? { designs: designsOf.get(doc.id) ?? [] } : {},
+    ...historyNeeded ? { updated: latest.get(doc.id) ?? null } : {},
+    ...matched ? { line: matched.get(doc.id) } : {}
+  })));
+  if (filter.sort === "title") rows.sort((a, b) => a.title.localeCompare(b.title));
+  if (filter.sort === "updated") rows.sort((a, b) => (newest.get(a.id) ?? Infinity) - (newest.get(b.id) ?? Infinity));
+  const grouped = filter.sort === "order";
+  const groups = features.map((f) => ({ id: f.index.id, rows: rows.filter((r) => r.feature === f.index.feature) })).filter((g) => g.rows.length);
+  const page = grouped ? pageOf(groups, (g) => g.id, request) : pageOf(rows, (r) => r.id, request);
+  if (!page) return void 0;
+  const shown = grouped ? page.rows.flatMap((g) => g.rows) : page.rows;
+  return {
+    rows: shown,
+    features,
+    byId,
+    states,
+    grouped,
+    problems,
+    page: { rows: page.rows, total: page.total, next: page.next },
+    unit: grouped ? "feature" : "document",
+    orphans: filter.feature === void 0 ? arranged.orphans : []
+  };
+}
+
 // src/commands/documents.ts
 var draftMark = (doc) => doc.draft ? " (" + t2("docs.draft") + ")" : "";
 var stateLabel = {
@@ -28887,12 +29442,11 @@ var stateLabel = {
 var stateMark = (state2) => state2 === "committed" ? "" : " (" + stateLabel[state2]() + ")";
 var line = (doc) => `${doc.id} ${doc.title}${draftMark(doc)} \u2014 ${doc.description}`;
 var fileLine = (f) => f.title ? `${f.path} ${f.title} \u2014 ${f.description}` : f.path;
-var titledSources = (d, byId) => d.sources.map((s) => "id" in s ? { id: s.id, title: byId.get(s.id)?.title ?? null, ...s.note ? { note: s.note } : {} } : s);
 async function working(project) {
   const { documents } = await project.cache.documents.list();
   return {
     byId: new Map(documents.map((d) => [d.id, d])),
-    read: (path3) => readFile13(join15(project.root, ...path3.split("/")), "utf8"),
+    read: (path3) => readFile13(join16(project.root, ...path3.split("/")), "utf8"),
     referencing: async (id) => [...new Set((await project.cache.documents.referencing(id)).map((r) => r.from))]
   };
 }
@@ -29001,48 +29555,6 @@ function checkFields(fields2, columns3) {
   if (unknown2.length || !fields2.length) throw new CommandError("INVALID_VALUE", t2("list.unknownFields", { fields: unknown2.join(", "), columns: columns3.join(", ") }));
   return [...new Set(fields2)];
 }
-function byAuthor(author) {
-  if (author === void 0) return () => true;
-  const wanted = author.trim().toLowerCase();
-  return (change2) => change2.author.toLowerCase() === wanted || change2.email.toLowerCase() === wanted;
-}
-async function since(project, value, head) {
-  if (value === void 0) return () => true;
-  if (/^\d{4}-\d\d-\d\d/.test(value)) {
-    const from = Date.parse(value);
-    if (!Number.isFinite(from)) throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
-    return (change2) => Date.parse(change2.date) >= from;
-  }
-  let commit;
-  try {
-    commit = await project.reader.resolve(value);
-  } catch {
-    throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
-  }
-  if (!head) return () => false;
-  const after = new Set(project.reader.decode(await project.reader.run(["rev-list", `${commit}..${head}`, "--"])).split("\n").filter(Boolean));
-  return (change2) => after.has(change2.commit);
-}
-async function sinceRange(project, value, head) {
-  if (value === void 0) return {};
-  if (/^\d{4}-\d\d-\d\d/.test(value)) {
-    const from = Date.parse(value);
-    if (!Number.isFinite(from)) throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
-    return { from };
-  }
-  let commit;
-  try {
-    commit = await project.reader.resolve(value);
-  } catch {
-    throw new CommandError("INVALID_VALUE", t2("list.since", { value }));
-  }
-  if (!head) return { commits: [] };
-  return { commits: project.reader.decode(await project.reader.run(["rev-list", `${commit}..${head}`, "--"])).split("\n").filter(Boolean) };
-}
-var contains = (query) => {
-  const wanted = query?.trim().toLowerCase();
-  return (...texts) => !wanted || texts.some((value) => value?.toLowerCase().includes(wanted));
-};
 function cell(value) {
   if (value === void 0 || value === null || value === false) return "";
   if (Array.isArray(value)) return value.map((v) => typeof v === "object" && v !== null ? "id" in v ? v.id : "title" in v ? v.title : JSON.stringify(v) : String(v)).join(",");
@@ -29061,18 +29573,14 @@ function selected(rows, fields2) {
     text: rows.length ? text2(rows.map((row) => fields2.map((f) => cell(row[f])).join("	"))) : ""
   };
 }
-var PAGE_SIZE = 20;
 function paginate(rows, keyOf, options) {
-  let start = 0;
-  if (options.after !== void 0) {
-    const at = rows.findIndex((row) => keyOf(row) === options.after);
-    if (at < 0) throw new CommandError("INVALID_VALUE", t2("list.after", { cursor: options.after }));
-    start = at + 1;
-  }
-  const size = options.all ? rows.length : options.limit ?? PAGE_SIZE;
-  const shown = rows.slice(start, start + size);
-  const more = start + shown.length < rows.length && shown.length > 0;
-  return { rows: shown, total: rows.length, next: more ? keyOf(shown[shown.length - 1]) : null };
+  return pageOr(pageOf(rows, keyOf, options), options);
+}
+function pageOr(page, options) {
+  return page ?? cursorGone(options);
+}
+function cursorGone(options) {
+  throw new CommandError("INVALID_VALUE", t2("list.after", { cursor: options.after ?? "" }));
 }
 var pageLine = (page, before = 0, unit = t2("list.items")) => page.next === null ? [] : [t2("list.more", { shown: before + page.rows.length, total: page.total, unit, cursor: page.next })];
 function aside(format2, lines) {
@@ -29088,67 +29596,10 @@ var kindLabel = { feature: () => t2("docs.feature"), requirement: () => t2("docs
 var runSpecsList = (options) => runCommand("specs", options.format, async () => {
   const fields2 = checkFields(options.fields, columns);
   const project = await openProject(process.cwd());
-  const listed3 = await project.cache.documents.list();
-  const problems = listed3.problems;
-  const states = await documentStates(project, listed3.documents);
-  const documents = states.documents;
-  const byId = new Map(documents.map((d) => [d.id, d]));
-  const arranged = arrangeDocuments(documents);
-  let features = arranged.features;
-  if (options.feature !== void 0) {
-    features = features.filter((f) => f.index.feature === options.feature);
-    if (!features.length) throw new CommandError("UNKNOWN_FEATURE", t2("docs.unknownFeature", { feature: options.feature }));
-  }
-  const titled = (id) => ({ id, title: byId.get(id)?.title ?? null });
-  const designsOf = /* @__PURE__ */ new Map();
-  for (const f of arranged.features) for (const d of f.designs) for (const r of d.requirements) designsOf.set(r, [...designsOf.get(r) ?? [], titled(d.id)]);
-  const historyNeeded = options.sort === "updated" || options.changedSince !== void 0 || options.author !== void 0 || !!fields2?.includes("updated");
-  const latest = /* @__PURE__ */ new Map();
-  const newest = /* @__PURE__ */ new Map();
-  let touched;
-  if (historyNeeded) {
-    const head = await project.head();
-    const changes2 = head ? await project.cache.history.changesOf(head) : [];
-    changes2.forEach((c, rank) => {
-      if (!latest.has(c.id)) {
-        latest.set(c.id, { commit: c.commit, date: c.date, author: c.author, email: c.email });
-        newest.set(c.id, rank);
-      }
-    });
-    if (options.changedSince !== void 0 || options.author !== void 0) {
-      const after = await since(project, options.changedSince, head);
-      const by = byAuthor(options.author);
-      touched = new Set(changes2.filter((c) => after(c) && by(c)).map((c) => c.id));
-    }
-  }
-  const matched = options.q !== void 0 ? await project.cache.documents.matching(options.q) : void 0;
-  const rows = features.flatMap((f) => [f.index, ...f.requirements, ...f.designs].filter(
-    (doc) => (options.type === void 0 || doc.kind === options.type) && (!options.withoutDesign || !f.designs.length) && (!options.uncovered || doc.kind === "requirement" && !designsOf.has(doc.id)) && (!options.draft || doc.draft) && (!touched || touched.has(doc.id)) && (!matched || matched.has(doc.id))
-  ).map((doc) => ({
-    id: doc.id,
-    kind: doc.kind,
-    feature: doc.feature,
-    path: doc.path,
-    title: doc.title,
-    description: doc.description,
-    ...doc.kind === "requirement" || doc.kind === "design" ? { order: doc.order } : {},
-    ...doc.draft ? { draft: true } : {},
-    state: states.state(doc.id),
-    ...states.previousPath(doc.id) ? { previousPath: states.previousPath(doc.id) } : {},
-    ...doc.kind === "design" ? { requirements: doc.requirements.map(titled), sources: titledSources(doc, byId) } : {},
-    ...doc.kind === "requirement" ? { designs: designsOf.get(doc.id) ?? [] } : {},
-    ...historyNeeded ? { updated: latest.get(doc.id) ?? null } : {},
-    ...matched ? { line: matched.get(doc.id) } : {}
-  })));
-  if (options.sort === "title") rows.sort((a, b) => a.title.localeCompare(b.title));
-  if (options.sort === "updated") rows.sort((a, b) => (newest.get(a.id) ?? Infinity) - (newest.get(b.id) ?? Infinity));
-  const grouped = options.sort === "order";
-  const groups = features.map((f) => ({ id: f.index.id, rows: rows.filter((r) => r.feature === f.index.feature) })).filter((g) => g.rows.length);
-  const page = grouped ? paginate(groups, (g) => g.id, options) : paginate(rows, (r) => r.id, options);
-  const shown = grouped ? page.rows.flatMap((g) => g.rows) : page.rows;
+  const listed3 = await listSpecs(project, { ...options, withUpdated: !!fields2?.includes("updated") }, options) ?? cursorGone(options);
+  const { rows: shown, features, byId, states, grouped, problems, orphans, page } = listed3;
   const more = pageLine(page, 0, grouped ? t2("list.features") : t2("list.items"));
-  const paging = { total: page.total, next: page.next, unit: grouped ? "feature" : "document" };
-  const orphans = options.feature === void 0 ? arranged.orphans : [];
+  const paging = { total: page.total, next: page.next, unit: listed3.unit };
   if (fields2) {
     const picked = selected(shown, fields2);
     return { json: { documents: picked.json, orphans, problems, page: paging }, text: picked.text + aside(options.format, more) };
@@ -29192,27 +29643,23 @@ var runSpecsShow = (ids, options) => runCommand("specs", options.format, async (
 });
 var runSpecsNew = (kind2, path3, options) => runCommand("specs", options.format, async () => createDocument(await openProject(process.cwd()), kind2, path3, options));
 
-// src/commands/instructions.ts
-import { lstat as lstat11 } from "node:fs/promises";
-import { join as join16 } from "node:path";
-var instructionSorts = ["name", "updated"];
-var columns2 = ["id", "name", "path", "title", "description", "draft", "state", "previousPath", "files", "updated", "line"];
+// src/queries/instructions.ts
+import { lstat as lstat12 } from "node:fs/promises";
+import { join as join17 } from "node:path";
 var AGENTS = "AGENTS.md";
-var runInstructionsList = (options) => runCommand("instructions", options.format, async () => {
-  const fields2 = checkFields(options.fields, columns2);
-  const project = await openProject(process.cwd());
-  const listed3 = await project.cache.documents.list();
+async function listInstructions(source2, options, request) {
+  const listed3 = await source2.cache.documents.list();
   const problems = listed3.problems;
-  const states = await documentStates(project, listed3.documents);
+  const states = await documentStates(source2, listed3.documents);
   const documents = states.documents;
-  const agents2 = { path: AGENTS, exists: !!(await lstat11(join16(project.root, AGENTS)).catch(() => void 0))?.isFile() };
-  const historyNeeded = options.sort === "updated" || options.author !== void 0 || !!fields2?.includes("updated");
+  const agents2 = { path: AGENTS, exists: !!(await lstat12(join17(source2.root, AGENTS)).catch(() => void 0))?.isFile() };
+  const historyNeeded = options.sort === "updated" || options.author !== void 0 || !!options.withUpdated;
   const latest = /* @__PURE__ */ new Map();
   const newest = /* @__PURE__ */ new Map();
   let touched;
   if (historyNeeded) {
-    const head = await project.head();
-    const changes2 = head ? await project.cache.history.changesOf(head) : [];
+    const head = await source2.head();
+    const changes2 = head ? await source2.cache.history.changesOf(head) : [];
     changes2.forEach((c, rank) => {
       if (!latest.has(c.id)) {
         latest.set(c.id, { commit: c.commit, date: c.date, author: c.author, email: c.email });
@@ -29224,11 +29671,11 @@ var runInstructionsList = (options) => runCommand("instructions", options.format
       touched = new Set(changes2.filter(by).map((c) => c.id));
     }
   }
-  const matched = options.q !== void 0 ? await project.cache.documents.matching(options.q) : void 0;
+  const matched = options.q !== void 0 ? await source2.cache.documents.matching(options.q) : void 0;
   const instructions2 = documents.filter((d) => d.kind === "instruction").filter((d) => (!touched || touched.has(d.id)) && (!matched || matched.has(d.id))).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
   const rows = await Promise.all(instructions2.map(async (d) => {
     const state2 = states.state(d.id);
-    const { files, limited } = state2 === "deleted" ? { files: [], limited: false } : await readInstructionFiles(project.root, d.path);
+    const { files, limited } = state2 === "deleted" ? { files: [], limited: false } : await readInstructionFiles(source2.root, d.path);
     return {
       id: d.id,
       name: d.name,
@@ -29245,7 +29692,19 @@ var runInstructionsList = (options) => runCommand("instructions", options.format
     };
   }));
   if (options.sort === "updated") rows.sort((a, b) => (newest.get(a.id) ?? Infinity) - (newest.get(b.id) ?? Infinity));
-  const page = paginate(rows, (r) => r.id, options);
+  const page = pageOf(rows, (r) => r.id, request);
+  if (!page) return void 0;
+  return { agents: agents2, problems, page };
+}
+
+// src/commands/instructions.ts
+var instructionSorts = ["name", "updated"];
+var columns2 = ["id", "name", "path", "title", "description", "draft", "state", "previousPath", "files", "updated", "line"];
+var runInstructionsList = (options) => runCommand("instructions", options.format, async () => {
+  const fields2 = checkFields(options.fields, columns2);
+  const project = await openProject(process.cwd());
+  const listed3 = await listInstructions(project, { ...options, withUpdated: !!fields2?.includes("updated") }, options) ?? cursorGone(options);
+  const { agents: agents2, problems, page } = listed3;
   const shown = page.rows;
   const paging = { total: page.total, next: page.next, unit: "instruction" };
   const unreadable2 = problems.filter((p) => p.path.startsWith(INSTRUCTIONS_ROOT + "/"));
@@ -29291,9 +29750,9 @@ var runInstructionsShow = (targets, options) => runCommand("instructions", optio
 var runInstructionsNew = (name2, options) => runCommand("instructions", options.format, async () => createDocument(await openProject(process.cwd()), "instruction", name2, options));
 
 // src/adapters/filesystem/document-warnings.ts
-import { lstat as lstat12, readdir as readdir6 } from "node:fs/promises";
-import { join as join17 } from "node:path";
-var info2 = async (path3) => lstat12(path3).catch((e) => {
+import { lstat as lstat13, readdir as readdir6 } from "node:fs/promises";
+import { join as join18 } from "node:path";
+var info2 = async (path3) => lstat13(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -29301,11 +29760,11 @@ var posix = (path3) => path3.split("\\").join("/");
 async function listAssets(root) {
   const out = [];
   async function visit2(relative, depth) {
-    const stat3 = await info2(join17(root, relative));
+    const stat3 = await info2(join18(root, relative));
     if (!stat3 || stat3.isSymbolicLink()) return;
     if (stat3.isDirectory()) {
       if (depth > 8 || out.length > 4e3) return;
-      for (const name2 of (await readdir6(join17(root, relative))).sort()) await visit2(relative + "/" + name2, depth + 1);
+      for (const name2 of (await readdir6(join18(root, relative))).sort()) await visit2(relative + "/" + name2, depth + 1);
     } else if (stat3.isFile()) out.push({ path: posix(relative), bytes: stat3.size });
   }
   await visit2(ASSETS_DIR, 0);
@@ -29314,7 +29773,7 @@ async function listAssets(root) {
 async function readDocumentWarnings(root, documents) {
   const outside = [...new Set(documentBodyLinks(documents).map((l) => l.target).filter((t3) => !t3.startsWith(".gitifact/") || t3.startsWith(INSTRUCTIONS_ROOT + "/")))];
   const existing = /* @__PURE__ */ new Set();
-  for (const target of outside) if ((await info2(join17(root, ...target.split("/"))))?.isFile()) existing.add(target);
+  for (const target of outside) if ((await info2(join18(root, ...target.split("/"))))?.isFile()) existing.add(target);
   return documentWarnings(documents, await listAssets(root), existing);
 }
 
@@ -29339,29 +29798,29 @@ var runCheck = (options) => runCommand("check", options.format, async () => {
 // src/commands/changes.ts
 import { randomUUID as randomUUID5 } from "node:crypto";
 import { mkdir as mkdir6, open as open5, readFile as readFile16, rename as rename3, rmdir, unlink as unlink4, writeFile as writeFile4 } from "node:fs/promises";
-import { join as join20 } from "node:path";
+import { join as join21 } from "node:path";
 
 // src/adapters/filesystem/agent-inputs.ts
 import { createHash as createHash4, randomBytes as randomBytes2 } from "node:crypto";
-import { lstat as lstat13, mkdir as mkdir5, readdir as readdir7, realpath as realpath3, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
+import { lstat as lstat14, mkdir as 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 join18 } from "node:path";
+import { basename, dirname as dirname2, join as join19 } from "node:path";
 var maxAge = 7 * 24 * 60 * 60 * 1e3;
-var info3 = (path3) => lstat13(path3).catch((e) => {
+var info3 = (path3) => lstat14(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
 var comparable = (path3) => process.platform === "win32" ? path3.toLowerCase() : path3;
 async function candidates(root, controls) {
   const key = createHash4("sha256").update(comparable(await realpath3(root))).digest("hex").slice(0, 16);
-  return { system: join18((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join18(root, ".gitifact", "tmp") };
+  return { system: join19((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join19(root, ".gitifact", "tmp") };
 }
 async function writable(directory) {
   try {
     await mkdir5(directory, { recursive: true });
     const stat3 = await info3(directory);
     if (!stat3?.isDirectory() || stat3.isSymbolicLink()) return false;
-    const probe = join18(directory, ".probe-" + randomBytes2(8).toString("hex"));
+    const probe = join19(directory, ".probe-" + randomBytes2(8).toString("hex"));
     await writeFile3(probe, "", { flag: "wx" });
     await unlink3(probe);
     return true;
@@ -29375,7 +29834,7 @@ async function prepareAgentInputs(root, controls = {}) {
   if (await writable(system)) directory = system;
   else if (await writable(project)) {
     directory = project;
-    await writeFile3(join18(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
+    await writeFile3(join19(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
       if (e.code !== "EEXIST") throw e;
     });
   }
@@ -29383,10 +29842,10 @@ async function prepareAgentInputs(root, controls = {}) {
   const now = (controls.now ?? Date.now)();
   for (const name2 of await readdir7(directory).catch(() => [])) {
     if (name2 === ".gitignore") continue;
-    const stat3 = await info3(join18(directory, name2)).catch(() => void 0);
-    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink3(join18(directory, name2)).catch(() => void 0);
+    const stat3 = await info3(join19(directory, name2)).catch(() => void 0);
+    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink3(join19(directory, name2)).catch(() => void 0);
   }
-  return { commit: join18(directory, "commit.json") };
+  return { commit: join19(directory, "commit.json") };
 }
 async function discardAgentInput(root, file2, controls = {}) {
   try {
@@ -29408,8 +29867,8 @@ async function discardAgentInput(root, file2, controls = {}) {
 
 // src/commands/commit-files.ts
 import { createHash as createHash5 } from "node:crypto";
-import { lstat as lstat14, readFile as readFile14 } from "node:fs/promises";
-import { join as join19 } from "node:path";
+import { lstat as lstat15, readFile as readFile14 } from "node:fs/promises";
+import { join as join20 } from "node:path";
 var fail3 = (message) => {
   throw new CommandError("INVALID_COMMIT", message);
 };
@@ -29418,7 +29877,7 @@ var optional2 = (path3) => readFile14(path3).catch((e) => {
   if (e.code === "ENOENT") return null;
   throw e;
 });
-var info4 = (path3) => lstat14(path3).catch((e) => {
+var info4 = (path3) => lstat15(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -29444,11 +29903,11 @@ async function fingerprint(root, path3) {
   validPath2(path3);
   const parts = path3.split("/");
   for (let i = 1; i <= parts.length; i++) {
-    const target = join19(root, ...parts.slice(0, i));
+    const target = join20(root, ...parts.slice(0, i));
     const stat3 = await info4(target);
     if (!stat3) return null;
     if (stat3.isSymbolicLink() || (i < parts.length ? !stat3.isDirectory() : !stat3.isFile())) fail3(t2("commitFiles.linkOrDirectory"));
-    if (i < parts.length && await info4(join19(target, ".git"))) fail3(t2("commitFiles.nestedRepository"));
+    if (i < parts.length && await info4(join20(target, ".git"))) fail3(t2("commitFiles.nestedRepository"));
     if (i === parts.length) {
       if (stat3.nlink !== 1 || stat3.size > 16 * 1024 * 1024) fail3(t2("commitFiles.hardLinkOrSize"));
       return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile14(target)]));
@@ -29598,7 +30057,7 @@ async function commitChanges(cwd, input2, dryRun) {
     ...stdin ? { input: stdin } : {}
   });
   const staged = async (index) => (await git(["diff", "--cached", "--ita-visible-in-index", "--name-only", "--no-renames", "-z"], index)).toString("utf8").split("\0").filter(Boolean).sort();
-  const busy = join20(gitDir, "gitifact-changes-commit.lock");
+  const busy = join21(gitDir, "gitifact-changes-commit.lock");
   if (await info4(busy)) fail3(t2("commit.busy", { path: busy }));
   if ((await staged()).length) fail3(t2("commit.existingStaging"));
   const indexHash = hash2(await optional2(indexPath) ?? Buffer.alloc(0));
@@ -29637,7 +30096,7 @@ async function commitChanges(cwd, input2, dryRun) {
     if (!same2(base, await project.reader.baseline())) fail3(t2("commit.headChanged"));
     return { outcome: "dry-run", committed: false, ...summary, commit: void 0 };
   }
-  const temporary = join20(gitDir, "gitifact-commit-index-" + randomUUID5());
+  const temporary = join21(gitDir, "gitifact-commit-index-" + randomUUID5());
   let owned = false;
   let uncertain = false;
   let commitStarted = false;
@@ -29656,7 +30115,7 @@ async function commitChanges(cwd, input2, dryRun) {
     if (hash2(original ?? Buffer.alloc(0)) !== indexHash || (await staged()).length) fail3(t2("commit.indexChanged"));
     const before = await hashes([...started.keys()]);
     for (const [path3, value] of started) if (before.get(path3) !== value) fail3(t2("commit.fileChangedRunning", { path: path3 }));
-    await writeFile4(join20(busy, "recovery.json"), JSON.stringify({ before: base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected2, message }));
+    await writeFile4(join21(busy, "recovery.json"), JSON.stringify({ before: base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected2, message }));
     const locked = await hashes([.../* @__PURE__ */ new Set([...selected2, ...contextPaths])]);
     if (original) await writeFile4(temporary, original, { flag: "wx" });
     else await git(["read-tree", "--empty"], temporary);
@@ -29673,14 +30132,14 @@ 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(join20(root, path3));
+        const file2 = await readFile16(join21(root, path3));
         if (!blob.equals(file2) && !blob.equals(Buffer.from(file2.toString("latin1").replace(/\r\n/g, "\n"), "latin1"))) fail3(t2("commit.filterChanged"));
         offset = end + size + 2;
       }
     }
     const again = await hashes([...locked.keys()]);
     for (const [path3, value] of locked) if (again.get(path3) !== value) fail3(t2("commit.fileChangedPreparing", { path: path3 }));
-    for (const name2 of integration) if (await info4(join20(gitDir, name2))) fail3(t2("commit.integrationStarted"));
+    for (const name2 of integration) if (await info4(join21(gitDir, name2))) fail3(t2("commit.integrationStarted"));
     if (!same2(base, await project.reader.baseline())) fail3(t2("commit.headChanged"));
     const tree = (await git(["write-tree"], temporary)).toString("utf8").trim();
     commitStarted = true;
@@ -29720,7 +30179,7 @@ async function commitChanges(cwd, input2, dryRun) {
       await unlink4(temporary).catch(() => {
       });
       if (owned) {
-        await unlink4(join20(busy, "recovery.json")).catch(() => {
+        await unlink4(join21(busy, "recovery.json")).catch(() => {
         });
         await rmdir(busy);
       }
@@ -29731,7 +30190,7 @@ async function commitChanges(cwd, input2, dryRun) {
 
 // src/commands/records.ts
 import { readFile as readFile17 } from "node:fs/promises";
-import { join as join21 } from "node:path";
+import { join as join22 } from "node:path";
 var runRecordsNew = (options) => runCommand("records", options.format, async () => {
   if (/[\r\n]/.test(options.title)) throw new CommandError("INVALID_VALUE", t2("docs.singleLine", { field: "title" }));
   const docs = [...new Set(options.docs.flatMap((d) => d.split(",")).map((d) => d.trim()).filter(Boolean))];
@@ -29767,7 +30226,7 @@ var runRecordsShow = (ids, options) => runCommand("records", options.format, asy
   const shown = await Promise.all([...new Set(ids)].map(async (id) => {
     const path3 = await findRecord(project.root, id);
     if (!path3) return { id, missing: true };
-    const source2 = await readFile17(join21(project.root, ...path3.split("/")), "utf8");
+    const source2 = await readFile17(join22(project.root, ...path3.split("/")), "utf8");
     const log = project.reader.decode(await project.reader.run(["log", "-1", "--diff-filter=A", "--format=%H%x00%aN%x00%aI", "--", path3])).trim();
     const [commit, author, date5] = log.split("\0");
     return { id, path: path3, text: source2, commit: commit ? { commit, author, date: date5 } : null };
@@ -29877,7 +30336,7 @@ async function readThrough(project, head, filter, id) {
 // src/commands/feedback.ts
 import { readFile as readFile18 } from "node:fs/promises";
 import { release as release3 } from "node:os";
-import { dirname as dirname3, join as join22 } from "node:path";
+import { dirname as dirname3, join as join23 } from "node:path";
 
 // src/adapters/github/issue.ts
 import { spawn as spawn2 } from "node:child_process";
@@ -29944,7 +30403,7 @@ function parseFeedback(input2) {
 }
 async function schemaVersion(from) {
   for (let folder = from; ; folder = dirname3(folder)) {
-    const config2 = await readFile18(join22(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
+    const config2 = await readFile18(join23(folder, ".gitifact", "config.json"), "utf8").catch(() => void 0);
     if (config2 !== void 0) {
       try {
         const value = JSON.parse(config2).schemaVersion;
@@ -30170,11 +30629,11 @@ for (let i = 0; i < languageArgs.length; i++) {
   if (value === "ko" || value === "en") selectedLanguage = value;
 }
 configureLanguage(selectedLanguage ?? environmentLanguage(), selectedLanguage);
-var program2 = new Command().name("gitifact").addOption(new Option("--lang <language>", t2("help.lang")).choices(["ko", "en"])).description(t2("help.program")).version("0.8.1").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
+var program2 = new Command().name("gitifact").addOption(new Option("--lang <language>", t2("help.lang")).choices(["ko", "en"])).description(t2("help.program")).version("0.8.2").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
 var format = () => new Option("--format <format>", t2("help.format")).choices(formats).default("text");
-program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).action((options) => runBrowser(options, "0.8.1"));
-program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.8.1"));
-program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).action((options) => options.check ? runUpdateCheck(options.format, "0.8.1") : runUpdate(options, "0.8.1"));
+program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).action((options) => runBrowser(options, "0.8.2"));
+program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.8.2"));
+program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).option("--commit", t2("help.updateCommit")).addOption(new Option("--check", t2("help.updateCheck")).conflicts("commit")).action((options) => options.check ? runUpdateCheck(options.format, "0.8.2") : runUpdate(options, "0.8.2"));
 var listed2 = (command, sorts) => {
   command.allowExcessArguments(false).option("--q <words>", t2("help.listQ")).option("--author <name>", t2("help.listAuthor"));
   if (sorts) command.addOption(new Option("--sort <key>", t2("help.listSort")).choices([...sorts]).default(sorts[0]));
@@ -30196,7 +30655,7 @@ program2.command("check").description(t2("help.check")).allowExcessArguments(fal
 var changes = program2.command("changes").description(t2("help.changes"));
 changes.command("list").description(t2("help.changesList")).allowExcessArguments(false).addOption(format()).action((o) => runChangesList(o));
 changes.command("commit").description(t2("help.changesCommit")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.changesCommitFile")).option("--dry-run", t2("help.changesCommitDryRun")).addOption(format()).action((o) => runChangesCommit(o));
-program2.command("feedback").description(t2("help.feedback")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.feedbackFile")).option("--dry-run", t2("help.feedbackDryRun")).addOption(format()).action((o) => runFeedback(o, "0.8.1"));
+program2.command("feedback").description(t2("help.feedback")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.feedbackFile")).option("--dry-run", t2("help.feedbackDryRun")).addOption(format()).action((o) => runFeedback(o, "0.8.2"));
 var guide = program2.command("guide").description(t2("help.guide"));
 guide.command("list").description(t2("help.guideList")).allowExcessArguments(false).addOption(format()).action((o) => runGuideList(o));
 guide.command("show").description(t2("help.guideShow")).argument("<topic>", t2("help.guideTopic")).allowExcessArguments(false).addOption(format()).action((topic, o) => runGuideShow(topic, o));