gitifact 0.4.0 → 0.4.2

package/dist/main.js

@@ -1100,18 +1100,18 @@ function editDistance(a, b) {
   }
   return d[a.length][b.length];
 }
-function suggestSimilar(word, candidates) {
-  if (!candidates || candidates.length === 0) return "";
-  candidates = Array.from(new Set(candidates));
+function suggestSimilar(word, candidates2) {
+  if (!candidates2 || candidates2.length === 0) return "";
+  candidates2 = Array.from(new Set(candidates2));
   const searchingOptions = word.startsWith("--");
   if (searchingOptions) {
     word = word.slice(2);
-    candidates = candidates.map((candidate) => candidate.slice(2));
+    candidates2 = candidates2.map((candidate) => candidate.slice(2));
   }
   let similar = [];
   let bestDistance = maxDistance;
   const minSimilarity = 0.4;
-  candidates.forEach((candidate) => {
+  candidates2.forEach((candidate) => {
     if (candidate.length <= 1) return;
     const distance = editDistance(word, candidate);
     const length = Math.max(word.length, candidate.length);
@@ -24601,18 +24601,21 @@ var messages_default2 = {
   "help.spec": "Markdown \uBA85\uC138 \uC791\uC131\xB7\uC870\uD68C\xB7Git \uAE30\uB85D",
   "help.deprecated": "Deprecated: 0.6.0\uC5D0\uC11C \uC81C\uAC70 \uC608\uC815. spec commit\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.",
   "help.specCommit": "\uBCC0\uACBD \uC774\uC720 \uAE30\uB85D\uACFC \uAD00\uB828 \uD30C\uC77C \uCEE4\uBC0B\uC744 \uD55C \uBC88\uC5D0 \uC2E4\uD589",
-  "help.specCommitFile": "reasons\xB7paths\xB7message\xB7authorization\uC744 \uB2F4\uC740 JSON \uD30C\uC77C",
+  "help.specCommitFile": "reasons\xB7paths\xB7message\xB7authorization\uC744 \uB2F4\uC740 JSON \uD30C\uC77C (-\uB294 \uD45C\uC900 \uC785\uB825)",
   "help.specCommitDryRun": "\uD30C\uC77C\uC744 \uC4F0\uAC70\uB098 \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uACE0 \uACB0\uACFC\uB9CC \uD655\uC778",
   "help.specCommitPlanFile": "\uCEE4\uBC0B \uC785\uB825 \uB610\uB294 \uACC4\uD68D JSON \uD30C\uC77C",
   "help.specPrepareFile": "expected\uC640 \uCD5C\uC885 reasons\uB97C \uB2F4\uC740 JSON \uD30C\uC77C",
   "help.specVerifyFile": "prepare\uC758 verification \uAC1D\uCCB4\uB97C \uB2F4\uC740 JSON \uD30C\uC77C",
   "help.specVerifyStaged": "index \uC6D0\uBB38\uB3C4 \uBE44\uAD50",
-  "help.specSaveFile": "expected\uC640 operations\uB97C \uB2F4\uC740 UTF-8 JSON \uD30C\uC77C",
+  "help.specSaveFile": "expected\uC640 operations\uB97C \uB2F4\uC740 UTF-8 JSON \uD30C\uC77C (-\uB294 \uD45C\uC900 \uC785\uB825)",
   "help.specReadRef": "\uC77D\uC744 \uCEE4\uBC0B",
   "help.specDiffFrom": "\uC774\uC804 \uCEE4\uBC0B",
   "help.specDiffTo": "\uC774\uD6C4 \uCEE4\uBC0B",
   "help.specChanges": "HEAD \uB300\uBE44 \uCD5C\uC885 \uBA85\uC138 \uCC28\uC774\uC640 \uBBF8\uCEE4\uBC0B \uC774\uC720 \uC870\uD68C",
-  "help.specWorking": "\uD604\uC7AC \uBA85\uC138\xB7\uC81C\uD488\xB7\uC9C0\uCE68 \uC804\uCCB4\uC640 stamp \uC870\uD68C",
+  "help.specWorking": "\uD604\uC7AC \uBA85\uC138\xB7\uC81C\uD488\xB7\uC9C0\uCE68 \uC804\uCCB4\uC640 stamp, \uC785\uB825 \uD30C\uC77C \uACBD\uB85C \uC870\uD68C",
+  "help.specWorkingStamp": "stamp\uC640 \uC785\uB825 \uD30C\uC77C \uACBD\uB85C\uB9CC \uCD9C\uB825",
+  "help.specWorkingFeature": "\uD55C \uAE30\uB2A5 \uD3F4\uB354\uC758 \uBA85\uC138\uB9CC \uCD9C\uB825 (\uC81C\uD488\xB7\uC9C0\uCE68 \uC81C\uC678)",
+  "help.specWorkingIds": "\uBCF8\uBB38 \uC5C6\uC774 ID\xB7\uC81C\uBAA9\xB7\uACBD\uB85C\uB9CC \uCD9C\uB825",
   "help.specSave": "\uC694\uAD6C\uC0AC\uD56D\xB7\uC124\uACC4\xB7\uBB38\uC11C \uC800\uC7A5",
   "help.specRead": "\uCEE4\uBC0B \uC2DC\uC810\uC758 \uBA85\uC138 \uC870\uD68C",
   "help.specDiff": "\uB450 \uCEE4\uBC0B \uC0AC\uC774\uC758 \uBA85\uC138 \uBCC0\uACBD \uC870\uD68C",
@@ -24638,6 +24641,7 @@ var messages_default2 = {
   "preview.inputFile": "\uC785\uB825\uC740 1 MiB \uC774\uD558\uC758 JSON \uD30C\uC77C\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
   "preview.inputSize": "\uC785\uB825 \uD06C\uAE30\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.",
   "preview.inputJson": "\uC785\uB825 \uD30C\uC77C\uC740 UTF-8 JSON\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.",
+  "preview.unknownFeature": "\uAE30\uB2A5 \uD3F4\uB354 {feature}\uC758 \uBA85\uC138\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "preview.failed": "\uAC80\uD1A0 \uBA85\uC138 \uC791\uC5C5\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.",
   "initRepo.configIgnored": "\uC124\uC815\uC774 ignore \uADDC\uCE59\uC73C\uB85C \uC81C\uC678\uB429\uB2C8\uB2E4: {rule}",
   "initRepo.baselineMismatch": "\uAE30\uC900\uC120\uACFC \uD604\uC7AC \uC800\uC7A5\uC18C\uAC00 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
@@ -25186,23 +25190,23 @@ var fileInfo = (path3) => lstat(path3).catch((error62) => {
 });
 async function configDirectory(root) {
   const path3 = join2(root, ".gitifact");
-  const info4 = await fileInfo(path3);
-  if (info4 && (!info4.isDirectory() || info4.isSymbolicLink())) throw new InitError("PATH_CONFLICT", t2("config.storeNotDirectory"));
-  return info4;
+  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 = join2(root, ".gitifact", "config.json");
-  const info4 = await fileInfo(path3);
-  if (!info4) {
+  const info5 = await fileInfo(path3);
+  if (!info5) {
     if (await fileInfo(join2(root, ".tryce", "config.json"))) throw new InitError("MIGRATION_REQUIRED", t2("config.migrateFirst"));
     return void 0;
   }
-  if (!info4.isFile() || info4.isSymbolicLink() || info4.size > 65536) throw new InitError("PATH_CONFLICT", t2("config.fileShape"));
+  if (!info5.isFile() || info5.isSymbolicLink() || info5.size > 65536) throw new InitError("PATH_CONFLICT", t2("config.fileShape"));
   const bytes = await readFile2(path3);
   const after = await fileInfo(path3);
   await configDirectory(root);
-  if (!after || after.ino !== info4.ino || after.dev !== info4.dev || after.mtimeMs !== info4.mtimeMs || bytes.length > 65536) {
+  if (!after || after.ino !== info5.ino || after.dev !== info5.dev || after.mtimeMs !== info5.mtimeMs || bytes.length > 65536) {
     throw new InitError("INPUT_CHANGED", t2("config.changedWhileReading"));
   }
   try {
@@ -25901,14 +25905,14 @@ async function managedPath(root, path3, create = false) {
   const parts = path3.split("/");
   for (let i = 0; i < parts.length; i++) {
     full = join6(full, parts[i]);
-    let info4 = await fileInfo(full);
-    if (!info4 && create && i < parts.length - 1) {
+    let info5 = await fileInfo(full);
+    if (!info5 && create && i < parts.length - 1) {
       await mkdir3(full).catch((error62) => {
         if (error62.code !== "EEXIST") throw error62;
       });
-      info4 = await fileInfo(full);
+      info5 = await fileInfo(full);
     }
-    if (info4 && (info4.isSymbolicLink() || (i < parts.length - 1 ? !info4.isDirectory() : !info4.isFile()))) {
+    if (info5 && (info5.isSymbolicLink() || (i < parts.length - 1 ? !info5.isDirectory() : !info5.isFile()))) {
       throw new InitError("PATH_CONFLICT", t2("managedFile.notRegularPath", { path: path3 }));
     }
   }
@@ -26259,7 +26263,7 @@ async function runUpdate(options, version2) {
 }
 
 // src/commands/spec-preview.ts
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 import { readFile as readFile12, stat as stat2 } from "node:fs/promises";
 
 // src/adapters/filesystem/spec-preview-prepare.ts
@@ -26344,24 +26348,89 @@ async function verifyPreparedPreview(cwd, input2, staged) {
   return { verified: true, scope: staged ? "staged" : "working", base: c.base, stamp: current.stamp };
 }
 
+// src/adapters/filesystem/agent-inputs.ts
+import { createHash as createHash5, randomBytes as randomBytes2 } from "node:crypto";
+import { lstat as lstat5, mkdir as mkdir4, readdir as readdir4, realpath as realpath3, unlink as unlink4, writeFile as writeFile2 } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { basename, dirname as dirname3, join as join9 } from "node:path";
+var maxAge = 7 * 24 * 60 * 60 * 1e3;
+var info2 = (path3) => lstat5(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 = createHash5("sha256").update(comparable(await realpath3(root))).digest("hex").slice(0, 16);
+  return { system: join9((controls.tmpdir ?? tmpdir)(), "gitifact", key), project: join9(root, ".gitifact", "tmp") };
+}
+async function writable(directory) {
+  try {
+    await mkdir4(directory, { recursive: true });
+    const stat3 = await info2(directory);
+    if (!stat3?.isDirectory() || stat3.isSymbolicLink()) return false;
+    const probe = join9(directory, ".probe-" + randomBytes2(8).toString("hex"));
+    await writeFile2(probe, "", { flag: "wx" });
+    await unlink4(probe);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function prepareAgentInputs(root, controls = {}) {
+  const { system, project } = await candidates(root, controls);
+  let directory;
+  if (await writable(system)) directory = system;
+  else if (await writable(project)) {
+    directory = project;
+    await writeFile2(join9(project, ".gitignore"), "*\n", { flag: "wx" }).catch((e) => {
+      if (e.code !== "EEXIST") throw e;
+    });
+  }
+  if (!directory) return void 0;
+  const now = (controls.now ?? Date.now)();
+  for (const name of await readdir4(directory).catch(() => [])) {
+    if (name === ".gitignore") continue;
+    const stat3 = await info2(join9(directory, name)).catch(() => void 0);
+    if (stat3?.isFile() && now - stat3.mtimeMs > maxAge) await unlink4(join9(directory, name)).catch(() => void 0);
+  }
+  return { save: join9(directory, "save.json"), commit: join9(directory, "commit.json") };
+}
+async function discardAgentInput(root, file2, controls = {}) {
+  try {
+    const stat3 = await info2(file2);
+    if (!stat3?.isFile() || stat3.isSymbolicLink()) return false;
+    const parent = comparable(await realpath3(dirname3(file2)));
+    const { system, project } = await candidates(root, controls);
+    let managed = false;
+    for (const directory of [system, project]) {
+      if (await info2(directory) && comparable(await realpath3(directory)) === parent) managed = true;
+    }
+    if (!managed || basename(file2) === ".gitignore") return false;
+    await unlink4(file2);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // src/commands/spec-preview-commit.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
-import { readFile as readFile10, mkdir as mkdir4, open as open4, rename as rename3, unlink as unlink4, rmdir as rmdir2, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join10 } from "node:path";
+import { readFile as readFile10, mkdir as mkdir5, open as open4, rename as rename3, unlink as unlink5, rmdir as rmdir2, writeFile as writeFile3 } from "node:fs/promises";
+import { join as join11 } from "node:path";
 
 // src/commands/spec-commit-files.ts
-import { createHash as createHash5 } from "node:crypto";
-import { lstat as lstat5, readFile as readFile9 } from "node:fs/promises";
-import { join as join9 } from "node:path";
+import { createHash as createHash6 } from "node:crypto";
+import { lstat as lstat6, readFile as readFile9 } from "node:fs/promises";
+import { join as join10 } from "node:path";
 var fail6 = (message) => {
   throw new SpecPreviewError(message);
 };
-var hash2 = (value) => createHash5("sha256").update(value).digest("hex");
+var hash2 = (value) => createHash6("sha256").update(value).digest("hex");
 var optional2 = (path3) => readFile9(path3).catch((e) => {
   if (e.code === "ENOENT") return null;
   throw e;
 });
-var info2 = (path3) => lstat5(path3).catch((e) => {
+var info3 = (path3) => lstat6(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -26373,11 +26442,11 @@ async function fingerprint(root, path3) {
   validPath2(path3);
   const parts = path3.split("/");
   for (let i = 1; i <= parts.length; i++) {
-    const target = join9(root, ...parts.slice(0, i));
-    const stat3 = await info2(target);
+    const target = join10(root, ...parts.slice(0, i));
+    const stat3 = await info3(target);
     if (!stat3) return null;
     if (stat3.isSymbolicLink() || (i < parts.length ? !stat3.isDirectory() : !stat3.isFile())) fail6(t2("commitFiles.linkOrDirectory"));
-    if (i < parts.length && await info2(join9(target, ".git"))) fail6(t2("commitFiles.nestedRepository"));
+    if (i < parts.length && await info3(join10(target, ".git"))) fail6(t2("commitFiles.nestedRepository"));
     if (i === parts.length) {
       if (stat3.nlink !== 1 || stat3.size > 16 * 1024 * 1024) fail6(t2("commitFiles.hardLinkOrSize"));
       return hash2(Buffer.concat([Buffer.from(String(stat3.mode & 73) + "\0"), await readFile9(target)]));
@@ -26443,8 +26512,8 @@ async function previewCommit(cwd, action, input2) {
   });
   const indexPath = (await git(["rev-parse", "--path-format=absolute", "--git-path", "index"])).toString("utf8").trim();
   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 = join10(gitDir, "gitifact-spec-commit.lock");
-  if (await info2(busy)) fail6(t2("commit.busy", { path: busy }));
+  const busy = join11(gitDir, "gitifact-spec-commit.lock");
+  if (await info3(busy)) fail6(t2("commit.busy", { path: busy }));
   if ((await staged()).length) fail6(t2("commit.existingStagingPlan"));
   const request = object3(input2);
   let plan;
@@ -26501,33 +26570,33 @@ async function previewCommit(cwd, action, input2) {
   if (!("plan" in refreshed) || refreshed.plan.digest !== plan.digest) fail6(t2("commit.planStale"));
   const before = await reader.baseline();
   const original = await optional2(indexPath);
-  await mkdir4(busy);
-  const draftLock = join10(gitDir, "gitifact-spec-preview.lock");
+  await mkdir5(busy);
+  const draftLock = join11(gitDir, "gitifact-spec-preview.lock");
   let draftOwned = false;
   let indexLock;
   let uncertain = false;
   let commitStarted = false;
-  const temporary = join10(gitDir, "gitifact-commit-index-" + randomUUID6());
+  const temporary = join11(gitDir, "gitifact-commit-index-" + randomUUID6());
   const checkFiles = async () => {
     for (const f of [...plan.files, ...plan.context]) if (f.hash !== await fingerprint(root, f.path)) fail6(t2("commit.fileChangedPreparing", { path: f.path }));
     if ((await readLockedPreviewState(root)).stamp !== object3(plan.verification).stamp) fail6(t2("commit.specsChangedPreparing"));
-    for (const name of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"]) if (await info2(join10(gitDir, name))) fail6(t2("commit.integrationStarted"));
+    for (const name of ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"]) if (await info3(join11(gitDir, name))) fail6(t2("commit.integrationStarted"));
   };
   try {
     await verifyPreparedPreview(cwd, plan.verification, false);
-    await mkdir4(draftLock);
+    await mkdir5(draftLock);
     draftOwned = true;
     indexLock = await open4(indexPath + ".lock", "wx", 384);
     if (plan.index !== hash2(await optional2(indexPath) ?? Buffer.alloc(0)) || (await staged()).length) fail6(t2("commit.indexChangedLocked"));
-    await writeFile2(join10(busy, "recovery.json"), JSON.stringify({ before, originalIndex: original?.toString("base64") ?? null, temporary, plan }));
-    if (original) await writeFile2(temporary, original, { flag: "wx" });
+    await writeFile3(join11(busy, "recovery.json"), JSON.stringify({ before, originalIndex: original?.toString("base64") ?? null, temporary, plan }));
+    if (original) await writeFile3(temporary, original, { flag: "wx" });
     else await git(["read-tree", "--empty"], temporary);
     await git(["add", "--", ...selected], temporary);
     const actual = await staged(temporary);
     if (!actual.length || actual.some((p) => !selected.includes(p))) fail6(t2("commit.unexpectedFiles"));
     for (const file2 of plan.files.filter((f) => record2(f.path) && f.hash !== null)) {
       const stagedBytes = await git(["show", ":" + file2.path], temporary);
-      if (!stagedBytes.equals(await readFile10(join10(root, file2.path)))) fail6(t2("commit.filterChanged"));
+      if (!stagedBytes.equals(await readFile10(join11(root, file2.path)))) fail6(t2("commit.filterChanged"));
     }
     await checkFiles();
     if (JSON.stringify(before) !== JSON.stringify(await reader.baseline())) fail6(t2("commit.headChanged"));
@@ -26562,11 +26631,11 @@ async function previewCommit(cwd, action, input2) {
     await indexLock?.close().catch(() => {
     });
     if (!uncertain) {
-      if (indexLock) await unlink4(indexPath + ".lock").catch(() => {
+      if (indexLock) await unlink5(indexPath + ".lock").catch(() => {
       });
-      await unlink4(temporary).catch(() => {
+      await unlink5(temporary).catch(() => {
       });
-      await unlink4(join10(busy, "recovery.json")).catch(() => {
+      await unlink5(join11(busy, "recovery.json")).catch(() => {
       });
       await rmdir2(busy);
       if (draftOwned) await rmdir2(draftLock);
@@ -26575,9 +26644,9 @@ async function previewCommit(cwd, action, input2) {
 }
 
 // src/commands/spec-commit.ts
-import { createHash as createHash7, randomUUID as randomUUID7 } from "node:crypto";
-import { mkdir as mkdir5, open as open5, readFile as readFile11, rename as rename4, rmdir as rmdir3, unlink as unlink5, writeFile as writeFile3 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { createHash as createHash8, randomUUID as randomUUID7 } from "node:crypto";
+import { mkdir as mkdir6, open as open5, readFile as readFile11, rename as rename4, rmdir as rmdir3, unlink as unlink6, writeFile as writeFile4 } from "node:fs/promises";
+import { join as join12 } from "node:path";
 var fields = ["reasons", "paths", "message", "authorization", "requirements", "policyFiles", "expected"];
 var integration = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply"];
 var same2 = (a, b) => JSON.stringify(a) === JSON.stringify(b);
@@ -26616,9 +26685,9 @@ async function specCommit(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 = join11(gitDir, "gitifact-spec-commit.lock");
+  const busy = join12(gitDir, "gitifact-spec-commit.lock");
   await failOnLegacyLock(gitDir);
-  if (await info2(busy)) fail6(t2("commit.busy", { path: busy }));
+  if (await info3(busy)) fail6(t2("commit.busy", { path: busy }));
   if ((await staged()).length) fail6(t2("commit.existingStaging"));
   const indexHash = hash2(await optional2(indexPath) ?? Buffer.alloc(0));
   const current = c.working;
@@ -26627,7 +26696,7 @@ async function specCommit(cwd, input2, dryRun) {
   const prepared = prepareSpecPreview(c.bundle, current.bundle, c.files, current.files, reasons, () => generatePreviewId("H"));
   const blobId = (text2) => {
     const bytes = Buffer.from(text2);
-    return createHash7(objectFormat).update(`blob ${bytes.length}\0`).update(bytes).digest("hex");
+    return createHash8(objectFormat).update(`blob ${bytes.length}\0`).update(bytes).digest("hex");
   };
   const present = [...current.files.keys()];
   if (present.some((p) => p.includes("\n"))) fail6(t2("commit.newlinePath"));
@@ -26670,14 +26739,14 @@ async function specCommit(cwd, input2, dryRun) {
     ...prepared.changes.filter((c2) => c2.kind === "design").map((c2) => "Gitifact-Design: " + c2.id),
     ...prepared.changes.filter((c2) => c2.kind === "product" || c2.kind === "guide").map((c2) => "Gitifact-Doc: " + c2.id)
   ];
-  const temporary = join11(gitDir, "gitifact-commit-index-" + randomUUID7());
+  const temporary = join12(gitDir, "gitifact-commit-index-" + randomUUID7());
   let owned = false;
   let uncertain = false;
   let indexLock;
   let committed;
   try {
     try {
-      await mkdir5(busy);
+      await mkdir6(busy);
       owned = true;
     } catch (e) {
       if (e.code === "EEXIST") fail6(t2("commit.busy", { path: busy }));
@@ -26691,8 +26760,8 @@ async function specCommit(cwd, input2, dryRun) {
         if (hash2(original ?? Buffer.alloc(0)) !== indexHash || (await staged()).length) fail6(t2("commit.indexChanged"));
         const locked = await hashes([.../* @__PURE__ */ new Set([...selected, ...contextPaths])]);
         for (const [path3, value] of started) if (locked.get(path3) !== value) fail6(t2("commit.fileChangedRunning", { path: path3 }));
-        await writeFile3(join11(busy, "recovery.json"), JSON.stringify({ before: c.base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected, message, requirements }));
-        if (original) await writeFile3(temporary, original, { flag: "wx" });
+        await writeFile4(join12(busy, "recovery.json"), JSON.stringify({ before: c.base, originalIndex: original?.toString("base64") ?? null, temporary, paths: selected, message, requirements }));
+        if (original) await writeFile4(temporary, original, { flag: "wx" });
         else await git(["read-tree", "--empty"], temporary);
         await git(["add", "--", ...stageable], temporary);
         const actual = await staged(temporary);
@@ -26707,7 +26776,7 @@ async function specCommit(cwd, input2, dryRun) {
             const size = Number(header[2]);
             if (end < 0 || header[1] !== "blob" || !Number.isSafeInteger(size) || output2[end + 1 + size] !== 10) fail6(t2("commit.stagedUnreadable", { path: path3 }));
             const staged2 = output2.subarray(end + 1, end + 1 + size);
-            const file2 = await readFile11(join11(root, path3));
+            const file2 = await readFile11(join12(root, path3));
             if (!staged2.equals(file2) && !staged2.equals(Buffer.from(file2.toString("latin1").replace(/\r\n/g, "\n"), "latin1"))) fail6(t2("commit.filterChanged"));
             offset = end + size + 2;
           }
@@ -26715,7 +26784,7 @@ async function specCommit(cwd, input2, dryRun) {
         const again = await hashes([...locked.keys()]);
         for (const [path3, value] of locked) if (again.get(path3) !== value) fail6(t2("commit.fileChangedPreparing", { path: path3 }));
         if ((await readLockedPreviewState(root)).stamp !== published.stamp) fail6(t2("commit.specsChangedPreparing"));
-        for (const name of integration) if (await info2(join11(gitDir, name))) fail6(t2("commit.integrationStarted"));
+        for (const name of integration) if (await info3(join12(gitDir, name))) fail6(t2("commit.integrationStarted"));
         if (!same2(c.base, await c.reader.baseline())) fail6(t2("commit.headChanged"));
         const tree = (await git(["write-tree"], temporary)).toString("utf8").trim();
         commitStarted = true;
@@ -26752,12 +26821,12 @@ async function specCommit(cwd, input2, dryRun) {
     await indexLock?.close().catch(() => {
     });
     if (!uncertain) {
-      if (indexLock) await unlink5(indexPath + ".lock").catch(() => {
+      if (indexLock) await unlink6(indexPath + ".lock").catch(() => {
       });
-      await unlink5(temporary).catch(() => {
+      await unlink6(temporary).catch(() => {
       });
       if (owned) {
-        await unlink5(join11(busy, "recovery.json")).catch(() => {
+        await unlink6(join12(busy, "recovery.json")).catch(() => {
         });
         await rmdir3(busy);
       }
@@ -26768,13 +26837,13 @@ async function specCommit(cwd, input2, dryRun) {
 
 // src/commands/spec-preview.ts
 var operations = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"];
-var runSpecPreview = (action, options) => withCommandScope(() => execute(action, options));
-async function execute(action, options) {
+var runSpecPreview = (action, options, controls = {}) => withCommandScope(() => execute(action, options, controls));
+async function execute(action, options, controls) {
   const envelope = { contract: "spec", version: 1 };
   try {
     const guard = specPreviewReader(process.cwd());
     const { root, gitDir, objectFormat } = await guard.location();
-    for (const marker2 of operations) if (await fileInfo(join12(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
+    for (const marker2 of operations) if (await fileInfo(join13(gitDir, marker2))) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker2 }));
     if (await guard.hasUnmerged()) throw new InitError("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
     const raw = await readConfigFile(root);
     if (raw === void 0) throw new SpecPreviewError(t2("preview.notInitialized"));
@@ -26783,12 +26852,11 @@ async function execute(action, options) {
     await initRepository(root).validateBaseline(config2, root, "HEAD", objectFormat);
     if (["working", "save", "changes", "prepare", "verify", "commit-plan", "commit-apply", "commit"].includes(action)) {
       let result;
-      if (action === "working") result = await readWorkingPreview(process.cwd());
-      else if (action === "changes") result = await readFinalPreviewChanges(process.cwd());
+      const inputs = () => prepareAgentInputs(root, controls).catch(() => void 0);
+      if (action === "working") result = narrowWorking(await readWorkingPreview(process.cwd()), options, await inputs());
+      else if (action === "changes") result = { ...await readFinalPreviewChanges(process.cwd()), inputs: await inputs() };
       else {
-        const source = await stat2(options.file);
-        if (!source.isFile() || source.size > 1024 * 1024) throw new SpecPreviewError(t2("preview.inputFile"));
-        const bytes = await readFile12(options.file);
+        const bytes = options.file === "-" ? await readStdin(controls.stdin ?? process.stdin) : await readInputFile(options.file);
         if (bytes.length > 1024 * 1024) throw new SpecPreviewError(t2("preview.inputSize"));
         let input2;
         try {
@@ -26797,6 +26865,8 @@ async function execute(action, options) {
           throw new SpecPreviewError(t2("preview.inputJson"));
         }
         result = action === "commit" ? await specCommit(process.cwd(), input2, !!options.dryRun) : action === "commit-plan" || action === "commit-apply" ? await previewCommit(process.cwd(), action === "commit-plan" ? "plan" : "apply", input2) : action === "prepare" ? await prepareWorkingPreview(process.cwd(), input2) : action === "verify" ? await verifyPreparedPreview(process.cwd(), input2, !!options.staged) : await saveWorkingPreview(process.cwd(), input2);
+        const consumed = action === "save" || action === "commit" && result.outcome === "committed";
+        if (consumed && options.file !== "-") result = { ...result, inputRemoved: await discardAgentInput(root, options.file, controls) };
       }
       process.stdout.write(JSON.stringify({ ...envelope, ok: true, ...result }) + "\n");
       return;
@@ -26817,13 +26887,46 @@ async function execute(action, options) {
     process.exitCode = 1;
   }
 }
+async function readInputFile(path3) {
+  const source = await stat2(path3);
+  if (!source.isFile() || source.size > 1024 * 1024) throw new SpecPreviewError(t2("preview.inputFile"));
+  return readFile12(path3);
+}
+async function readStdin(stream) {
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of stream) {
+    size += chunk.length;
+    if (size > 1024 * 1024) throw new SpecPreviewError(t2("preview.inputSize"));
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks);
+}
+function narrowWorking(working, options, inputs) {
+  if (options.stamp) return { stamp: working.stamp, inputs };
+  let { specs, documents, warnings } = working;
+  if (options.feature !== void 0) {
+    specs = specs.filter((s) => s.path === ".gitifact/spec/" + options.feature + "/requirements.md");
+    if (!specs.length) throw new SpecPreviewError(t2("preview.unknownFeature", { feature: options.feature }));
+    documents = [];
+    warnings = warnings.filter((w) => w.specId === specs[0].id);
+  }
+  if (!options.ids) return { stamp: working.stamp, inputs, specs, documents, warnings };
+  return {
+    stamp: working.stamp,
+    inputs,
+    warnings,
+    specs: specs.map((s) => ({ id: s.id, path: s.path, title: s.title, design: s.design?.title ?? null, requirements: s.requirements.map((r) => ({ id: r.id, title: r.title })) })),
+    documents: documents.map((set2) => ({ kind: set2.kind, documents: set2.documents.map((d) => ({ id: d.id, path: d.path, title: d.title })) }))
+  };
+}
 
 // src/commands/migrate.ts
-import { lstat as lstat7, readdir as readdir4, readFile as readFile13, rename as rename5, writeFile as writeFile4, unlink as unlink6 } from "node:fs/promises";
-import { join as join13 } from "node:path";
-import { randomBytes as randomBytes2 } from "node:crypto";
+import { lstat as lstat8, readdir as readdir5, readFile as readFile13, rename as rename5, writeFile as writeFile5, unlink as unlink7 } from "node:fs/promises";
+import { join as join14 } from "node:path";
+import { randomBytes as randomBytes3 } from "node:crypto";
 var operations2 = ["MERGE_HEAD", "CHERRY_PICK_HEAD", "REVERT_HEAD", "rebase-merge", "rebase-apply", "sequencer", "BISECT_START", "index.lock"];
-var info3 = (path3) => lstat7(path3).catch((e) => {
+var info4 = (path3) => lstat8(path3).catch((e) => {
   if (e.code === "ENOENT") return void 0;
   throw e;
 });
@@ -26834,40 +26937,40 @@ var fail7 = (code, message) => {
 async function migrateStore(cwd, dryRun = false) {
   const reader = specPreviewReader(cwd);
   const { root, gitDir } = await reader.location();
-  for (const marker3 of operations2) if (await info3(join13(gitDir, marker3))) fail7("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker3 }));
+  for (const marker3 of operations2) if (await info4(join14(gitDir, marker3))) fail7("GIT_OPERATION_IN_PROGRESS", t2("git.operationInProgress", { marker: marker3 }));
   if (await reader.hasUnmerged()) fail7("GIT_OPERATION_IN_PROGRESS", t2("git.resolveConflicts"));
-  for (const name of [...LEGACY_LOCKS, "gitifact-spec-preview.lock", "gitifact-spec-commit.lock"]) if (await info3(join13(gitDir, name))) fail7("LOCKED", t2("migrate.locked", { path: join13(gitDir, name) }));
-  const from = join13(root, ".tryce");
-  const to = join13(root, ".gitifact");
-  const fromInfo = await info3(from);
-  if (await info3(to)) fail7("ALREADY_MIGRATED", t2("migrate.alreadyMigrated"));
+  for (const name of [...LEGACY_LOCKS, "gitifact-spec-preview.lock", "gitifact-spec-commit.lock"]) if (await info4(join14(gitDir, name))) fail7("LOCKED", t2("migrate.locked", { path: join14(gitDir, name) }));
+  const from = join14(root, ".tryce");
+  const to = join14(root, ".gitifact");
+  const fromInfo = await info4(from);
+  if (await info4(to)) fail7("ALREADY_MIGRATED", t2("migrate.alreadyMigrated"));
   if (!fromInfo) return fail7("NOTHING_TO_MIGRATE", t2("migrate.nothingToMigrate"));
   if (!fromInfo.isDirectory() || fromInfo.isSymbolicLink()) fail7("PATH_CONFLICT", t2("migrate.notDirectory"));
-  const configInfo = await info3(join13(from, "config.json"));
+  const configInfo = await info4(join14(from, "config.json"));
   if (!configInfo?.isFile() || configInfo.isSymbolicLink()) fail7("NOT_INITIALIZED", t2("migrate.noConfig"));
-  const config2 = parseManagedConfig(decode4(await readFile13(join13(from, "config.json"))));
+  const config2 = parseManagedConfig(decode4(await readFile13(join14(from, "config.json"))));
   if (!("schemaVersion" in config2)) fail7("UNSUPPORTED_FORMAT", t2("migrate.legacyJson"));
-  const top = (await readdir4(from)).sort();
+  const top = (await readdir5(from)).sort();
   if (top.some((name) => name !== "config.json" && name !== "spec")) fail7("UNSUPPORTED_FORMAT", t2("migrate.extraEntries"));
   const files = /* @__PURE__ */ new Map();
   const rewrites = [];
   const legacyRecords = [];
   const marker2 = /^<!-- tryce-(spec|req|design|ref): /;
   if (top.includes("spec")) {
-    for (const feature2 of (await readdir4(join13(from, "spec"))).sort()) {
-      const dir = join13(from, "spec", feature2);
-      const stat3 = await info3(dir);
+    for (const feature2 of (await readdir5(join14(from, "spec"))).sort()) {
+      const dir = join14(from, "spec", feature2);
+      const stat3 = await info4(dir);
       if (!stat3?.isDirectory() || stat3.isSymbolicLink()) fail7("UNSUPPORTED_FORMAT", t2("migrate.notSpecFolder", { feature: feature2 }));
-      for (const name of (await readdir4(dir)).sort()) {
+      for (const name of (await readdir5(dir)).sort()) {
         if (!["requirements.md", "design.md", "history.jsonl", "tryce.json"].includes(name)) fail7("UNSUPPORTED_FORMAT", t2("migrate.unsupportedFile", { feature: feature2, name }));
-        const fileStat = await info3(join13(dir, name));
+        const fileStat = await info4(join14(dir, name));
         if (!fileStat?.isFile() || fileStat.isSymbolicLink() || fileStat.nlink !== 1 || fileStat.size > 1024 * 1024) fail7("UNSUPPORTED_FORMAT", t2("migrate.fileTooLarge", { name }));
         const newPath = `.gitifact/spec/${feature2}/${name}`;
         if (name === "tryce.json") {
           legacyRecords.push(newPath);
           continue;
         }
-        const text2 = decode4(await readFile13(join13(dir, name)));
+        const text2 = decode4(await readFile13(join14(dir, name)));
         if (name === "history.jsonl") {
           files.set(newPath, text2);
           continue;
@@ -26912,13 +27015,13 @@ async function migrateStore(cwd, dryRun = false) {
   if (dryRun) return result("planned");
   await rename5(from, to);
   for (const r of rewrites) {
-    const full = join13(root, r.path);
-    const temp = join13(root, ".gitifact", "spec", ".gitifact-migrate-" + randomBytes2(8).toString("hex"));
-    await writeFile4(temp, r.content, { flag: "wx" });
+    const full = join14(root, r.path);
+    const temp = join14(root, ".gitifact", "spec", ".gitifact-migrate-" + randomBytes3(8).toString("hex"));
+    await writeFile5(temp, r.content, { flag: "wx" });
     try {
       await rename5(temp, full);
     } finally {
-      await unlink6(temp).catch(() => {
+      await unlink7(temp).catch(() => {
       });
     }
   }
@@ -26936,16 +27039,16 @@ async function runMigrate(options) {
 }
 
 // src/main.ts
-var program2 = new Command().name("gitifact").description(t2("help.program")).version("0.4.0").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
+var program2 = new Command().name("gitifact").description(t2("help.program")).version("0.4.2").allowExcessArguments(false).addHelpText("after", "\n" + t2("help.notYet")).action(() => program2.outputHelp());
 program2.command("status").description(t2("help.status")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action(async (options) => {
   await runStatus(options.format);
 });
-program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).option("--no-update-check", t2("help.browserNoUpdateCheck")).action((options) => runBrowser(options, "0.4.0"));
-program2.command("init").description(t2("help.init")).allowExcessArguments(false).option("--dry-run", t2("help.initDryRun")).addOption(new Option("--agent <agent>", t2("help.initAgent")).choices([...agentPresetNames])).addOption(new Option("--remove-agents", t2("help.initRemoveAgents")).conflicts("skipAgents")).option("--skip-agents", t2("help.initSkipAgents")).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runInit(options, "0.4.0"));
+program2.command("browser").description(t2("help.browser")).allowExcessArguments(false).option("--port <port>", t2("help.browserPort"), parsePort, 0).option("--dev", t2("help.browserDev")).option("--no-update-check", t2("help.browserNoUpdateCheck")).action((options) => runBrowser(options, "0.4.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.4.2"));
 program2.command("docs").description(t2("help.docs")).argument("[topic]", t2("help.docsTopic")).allowExcessArguments(false).action(async (topic) => {
   await runDocs(topic);
 });
-program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runUpdate(options, "0.4.0"));
+program2.command("update").description(t2("help.update")).allowExcessArguments(false).addOption(new Option("--format <format>", t2("help.format")).choices(["json", "text"]).default("json")).action((options) => runUpdate(options, "0.4.2"));
 program2.command("migrate").description(t2("help.migrate")).allowExcessArguments(false).option("--dry-run", t2("help.migrateDryRun")).action(runMigrate);
 var spec = program2.command("spec").description(t2("help.spec"));
 var replaced = t2("help.deprecated");
@@ -26954,7 +27057,7 @@ for (const action of ["commit-plan", "commit-apply"]) spec.command(action).descr
 spec.command("changes").description(t2("help.specChanges")).allowExcessArguments(false).action((o) => runSpecPreview("changes", o));
 spec.command("prepare").description(replaced).allowExcessArguments(false).requiredOption("--file <path>", t2("help.specPrepareFile")).action((o) => runSpecPreview("prepare", o));
 spec.command("verify").description(replaced).allowExcessArguments(false).requiredOption("--file <path>", t2("help.specVerifyFile")).option("--staged", t2("help.specVerifyStaged")).action((o) => runSpecPreview("verify", o));
-spec.command("working").description(t2("help.specWorking")).allowExcessArguments(false).action((o) => runSpecPreview("working", o));
+spec.command("working").description(t2("help.specWorking")).allowExcessArguments(false).addOption(new Option("--stamp", t2("help.specWorkingStamp")).conflicts(["feature", "ids"])).option("--feature <name>", t2("help.specWorkingFeature")).option("--ids", t2("help.specWorkingIds")).action((o) => runSpecPreview("working", o));
 spec.command("save").description(t2("help.specSave")).allowExcessArguments(false).requiredOption("--file <path>", t2("help.specSaveFile")).action((o) => runSpecPreview("save", o));
 spec.command("read").description(t2("help.specRead")).allowExcessArguments(false).option("--ref <commit>", t2("help.specReadRef"), "HEAD").action((o) => runSpecPreview("read", o));
 spec.command("diff").description(t2("help.specDiff")).allowExcessArguments(false).requiredOption("--from <commit>", t2("help.specDiffFrom")).requiredOption("--to <commit>", t2("help.specDiffTo")).action((o) => runSpecPreview("diff", o));

package/package.json

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