@xrkseek/harness 0.4.0-rc.4 → 0.4.1

package/dist/index.d.ts

@@ -23,11 +23,12 @@ export { createHttpServer } from "@xrkseek/server-http";
 export { createMinimalComposition } from "@xrkseek/preset-minimal";
 export { createHarnessComposition } from "@xrkseek/preset-harness";
 export { createServerAgentFactory, createServerComposition, } from "@xrkseek/preset-server";
-export { createWorkerCodeRuntime, createRunCodeTool, } from "@xrkseek/code-runtime";
+export { createWorkerCodeRuntime, createRunCodeTool, createRegistryCodeToolBridge, runCodeWithTools, } from "@xrkseek/code-runtime";
+export { createContextFragmentPipeline, createAdditionalContextFragment, createRecapFragment, createStaticAdditionalContextProvider, appendContextFragments, fragmentsToPrepareContexts, truncateMiddle, formatAdditionalContextBody, DEFAULT_FRAGMENT_BUDGET_CHARS, } from "@xrkseek/context-fragments";
 export { createDefaultWebAccess, createWebTools, createHttpFetchProvider, WEB_SEARCH_MAX_RESULTS, } from "@xrkseek/exec-web";
 export { createDefaultLspAccess, createLspTools, createStdioLspService, LSP_PROMPT_TEXT, } from "@xrkseek/exec-lsp";
 export { createDefaultPtyAccess, createPtyTools, createTerminalSessionService, PTY_PROMPT_TEXT, } from "@xrkseek/exec-pty";
-export { createWorkspaceInjector, resolveWorkspaceInject, appendWorkspaceInjectsIfChanged, createWorkspaceToolOutputPersist, resolveProductHome, resolveSpillRoot, applyRecipe, parseRecipeYaml, tryApplySlashRecipe, tryApplySlashSkill, createSlashResolver, loadOfficeRecipes, createSkillTools, listSkillsFromWorkspace, } from "@xrkseek/workspace";
+export { createWorkspaceInjector, resolveWorkspaceInject, appendWorkspaceInjectsIfChanged, createWorkspaceToolOutputPersist, resolveProductHome, resolveSpillRoot, applyRecipe, parseRecipeYaml, tryApplySlashRecipe, tryApplySlashSkill, createSlashResolver, loadOfficeRecipes, createSkillTools, createProposeSkillTool, listSkillsFromWorkspace, } from "@xrkseek/workspace";
 export { createPolicyEngine, createPolicyEngineFromFile, createPolicyEngineFromRuleset, createPolicyToolCallGuard, createPolicyToolGuard, createPolicyToolPre, denyToolNames, askToolNames, assertPolicyAllow, loadPolicyRulesetFile, parsePolicyRuleset, policyRulesetJsonSchema, } from "@xrkseek/policy";
 export { createMcpClient, registerMcpTools, publicToolName, parsePublicToolName, type McpClient, type McpStdioOptions, type McpHttpOptions, type McpHttpReconnectionOptions, } from "@xrkseek/mcp";
 export { createMemoryAttachmentStore, AttachmentError, isAttachmentError, type AttachmentStore, } from "@xrkseek/attachment";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -22,11 +22,12 @@ export { createHttpServer } from "@xrkseek/server-http";
 export { createMinimalComposition } from "@xrkseek/preset-minimal";
 export { createHarnessComposition } from "@xrkseek/preset-harness";
 export { createServerAgentFactory, createServerComposition, } from "@xrkseek/preset-server";
-export { createWorkerCodeRuntime, createRunCodeTool, } from "@xrkseek/code-runtime";
+export { createWorkerCodeRuntime, createRunCodeTool, createRegistryCodeToolBridge, runCodeWithTools, } from "@xrkseek/code-runtime";
+export { createContextFragmentPipeline, createAdditionalContextFragment, createRecapFragment, createStaticAdditionalContextProvider, appendContextFragments, fragmentsToPrepareContexts, truncateMiddle, formatAdditionalContextBody, DEFAULT_FRAGMENT_BUDGET_CHARS, } from "@xrkseek/context-fragments";
 export { createDefaultWebAccess, createWebTools, createHttpFetchProvider, WEB_SEARCH_MAX_RESULTS, } from "@xrkseek/exec-web";
 export { createDefaultLspAccess, createLspTools, createStdioLspService, LSP_PROMPT_TEXT, } from "@xrkseek/exec-lsp";
 export { createDefaultPtyAccess, createPtyTools, createTerminalSessionService, PTY_PROMPT_TEXT, } from "@xrkseek/exec-pty";
-export { createWorkspaceInjector, resolveWorkspaceInject, appendWorkspaceInjectsIfChanged, createWorkspaceToolOutputPersist, resolveProductHome, resolveSpillRoot, applyRecipe, parseRecipeYaml, tryApplySlashRecipe, tryApplySlashSkill, createSlashResolver, loadOfficeRecipes, createSkillTools, listSkillsFromWorkspace, } from "@xrkseek/workspace";
+export { createWorkspaceInjector, resolveWorkspaceInject, appendWorkspaceInjectsIfChanged, createWorkspaceToolOutputPersist, resolveProductHome, resolveSpillRoot, applyRecipe, parseRecipeYaml, tryApplySlashRecipe, tryApplySlashSkill, createSlashResolver, loadOfficeRecipes, createSkillTools, createProposeSkillTool, listSkillsFromWorkspace, } from "@xrkseek/workspace";
 export { createPolicyEngine, createPolicyEngineFromFile, createPolicyEngineFromRuleset, createPolicyToolCallGuard, createPolicyToolGuard, createPolicyToolPre, denyToolNames, askToolNames, assertPolicyAllow, loadPolicyRulesetFile, parsePolicyRuleset, policyRulesetJsonSchema, } from "@xrkseek/policy";
 export { createMcpClient, registerMcpTools, publicToolName, parsePublicToolName, } from "@xrkseek/mcp";
 export { createMemoryAttachmentStore, AttachmentError, isAttachmentError, } from "@xrkseek/attachment";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,GAGxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,OAAO,EACP,eAAe,EACf,aAAa,GAId,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,gCAAgC,EAChC,kBAAkB,GAQnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,6BAA6B,EAC7B,OAAO,EACP,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GAOpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,YAAY,EACZ,qBAAqB,GAMtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,EAC/B,mBAAmB,EACnB,qCAAqC,EACrC,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,EACd,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,4BAA4B,EAC5B,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,+BAA+B,EAC/B,gCAAgC,EAChC,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,6BAA6B,EAC7B,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GAKpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,2BAA2B,EAC3B,eAAe,EACf,iBAAiB,GAElB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,eAAe,EACf,uBAAuB,GAQxB,MAAM,mBAAmB,CAAC"}

package/node_modules/@xrkseek/checkpoint/README.md

@@ -0,0 +1,88 @@
+# @xrkseek/checkpoint
+
+回合级**工作区文件快照**（turn rewind 的可恢复侧）。
+
+A turn-scoped **workspace file snapshot** store: the recoverable half of turn
+rewind.
+
+## 为什么是影子 git
+
+快照提交落在**独立**的 `--git-dir`（`<workspace>/.xrk/checkpoints/git`），
+`--work-tree` 指向工作区。因此：
+
+- 工作区本身不是 git 仓库也能快照；
+- 永不读/写用户自己的 `.git`，不会改写操作者历史；
+- 每条命令都带 `core.autocrlf=false`，Windows 上 restore 不会重写行尾。
+
+`snapshot()` 用 `commit --allow-empty`，所以「这一回合没改文件」也仍是一个
+**可恢复点**（它标记的是状态，而不是差异）。
+
+## API
+
+```ts
+import { WorkspaceCheckpointStore, createProcessGitRunner } from "@xrkseek/checkpoint";
+
+const store = new WorkspaceCheckpointStore({
+  workspaceDir: "/path/to/ws",
+  runGit: createProcessGitRunner(), // 注入：测试可传假 runner
+});
+
+// 回合开始前
+const record = await store.snapshot({ sessionId: "s1", seq: 12, label: "pre-edit" });
+
+// 改文件 · 跑工具 · …
+
+// 预演：会说清哪些文件不在快照里（不会被误删）
+const plan = await store.planRestore(record.id);
+// → { id, fileCount, extra: ["scratch/new.txt"] }
+
+// 回退：默认保留 extra；prune 才删除它们（ignored 文件永不触碰）
+const result = await store.restore(record.id, { prune: false });
+// → { id, fileCount, extra, restored, removed }
+```
+
+## 语义
+
+| 方法                     | 行为                                                     |
+| ------------------------ | -------------------------------------------------------- |
+| `snapshot(input)`        | `add -A` → `commit --allow-empty` → 索引追加记录         |
+| `list()`                 | 时间序（旧 → 新）记录                                    |
+| `planRestore(id)`        | 预演：快照文件数 + 快照不知道的 untracked 文件           |
+| `restore(id, { prune })` | `checkout --force <id> -- .`；`prune` 时追加 `clean -fd` |
+| `prune(keep)`            | 只裁剪索引，保留最新 `keep` 条（影子提交仍在）           |
+
+- `restore` 会**恢复**快照里存在、之后被删除的文件；
+- 快照之后**新建**的文件默认保留（列在 `extra` 里）；
+- `prune: true` 才删除它们，且 `clean` 不加 `-x`，**ignored 路径（如
+  `node_modules`）永不删除**。
+
+## 错误
+
+`WorkspaceCheckpointError.code`：`bad-argument` · `git-unavailable` ·
+`init-failed` · `snapshot-failed` · `restore-failed` · `unknown-checkpoint`。
+
+`git` 不在 PATH 时 runner 解析为 `{ code: -1 }`，store 抛 `git-unavailable`
+而不是崩溃。
+
+## Face / Host 暴露
+
+库本身无 RPC。产品面在 `@xrkseek/server-face`：
+
+| 入口 | 作用 |
+| ---- | ---- |
+| `session.checkpoint.list` · `planRestore` · `restore` · `snapshot` | Face unary |
+| `/rollback` | 斜杠列表 / 回退 / `plan` 预演 |
+| 消息 **Restore** | `/rollback seq:N`（与 **Branch** / `session.fork` 并列，语义不同） |
+| Host `snapshotSessionWorkspace` | 每轮 `continueTurn` 前自动打点（`XRK_CHECKPOINTS=0` 关闭） |
+
+**fork-cut ≠ restore**：`session.fork` 只切会话血缘；本包只回退工作区文件。详见 [docs/turn-rewind.md](../../docs/turn-rewind.md)。
+
+## 测试
+
+```bash
+npx vitest run packages/checkpoint
+npx vitest run packages/server/face/tests/checkpoint.test.ts
+```
+
+`tests/store.test.ts` 用假 runner 断言 git argv 序列；`tests/shadow-git.integration.test.ts`
+用真实 git 验证 restore 后内容回退、用户 `.git` 未被改写。

package/node_modules/@xrkseek/checkpoint/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { WorkspaceCheckpointError, type GitResult, type GitRunner, type RestoreOptions, type RestorePlan, type RestoreResult, type SnapshotInput, type WorkspaceCheckpointErrorCode, type WorkspaceCheckpointRecord, } from "./types.js";
+export { CHECKPOINT_AUTHOR_EMAIL, CHECKPOINT_AUTHOR_NAME, WorkspaceCheckpointStore, checkpointExcludePath, checkpointIndexPath, shadowGitDir, workspaceCheckpointDir, workspaceCheckpointId, type WorkspaceCheckpointStoreOptions, } from "./store.js";
+export { createProcessGitRunner } from "./process-git.js";
+export { readJsonFile, writeJsonFileAtomic } from "./json-file.js";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@xrkseek/checkpoint/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,GAC/B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,+BAA+B,GACrC,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/node_modules/@xrkseek/checkpoint/dist/index.js

@@ -0,0 +1,5 @@
+export { WorkspaceCheckpointError, } from "./types.js";
+export { CHECKPOINT_AUTHOR_EMAIL, CHECKPOINT_AUTHOR_NAME, WorkspaceCheckpointStore, checkpointExcludePath, checkpointIndexPath, shadowGitDir, workspaceCheckpointDir, workspaceCheckpointId, } from "./store.js";
+export { createProcessGitRunner } from "./process-git.js";
+export { readJsonFile, writeJsonFileAtomic } from "./json-file.js";
+//# sourceMappingURL=index.js.map

package/node_modules/@xrkseek/checkpoint/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GASzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/node_modules/@xrkseek/checkpoint/dist/json-file.d.ts

@@ -0,0 +1,5 @@
+/** Read JSON, or `undefined` when the file is missing / unparsable. */
+export declare function readJsonFile<T>(file: string): T | undefined;
+/** Best-effort atomic JSON write (tmp + rename) so a crash cannot truncate. */
+export declare function writeJsonFileAtomic(file: string, payload: unknown): void;
+//# sourceMappingURL=json-file.d.ts.map

package/node_modules/@xrkseek/checkpoint/dist/json-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.d.ts","sourceRoot":"","sources":["../src/json-file.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAM3D;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAaxE"}

package/node_modules/@xrkseek/checkpoint/dist/json-file.js

@@ -0,0 +1,29 @@
+import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+/** Read JSON, or `undefined` when the file is missing / unparsable. */
+export function readJsonFile(file) {
+    try {
+        return JSON.parse(readFileSync(file, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Best-effort atomic JSON write (tmp + rename) so a crash cannot truncate. */
+export function writeJsonFileAtomic(file, payload) {
+    const tmp = `${file}.tmp-${process.pid}`;
+    try {
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(tmp, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+        renameSync(tmp, file);
+    }
+    catch {
+        try {
+            rmSync(tmp, { force: true });
+        }
+        catch {
+            /* best effort */
+        }
+    }
+}
+//# sourceMappingURL=json-file.js.map

package/node_modules/@xrkseek/checkpoint/dist/json-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.js","sourceRoot":"","sources":["../src/json-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAI,IAAY;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAAgB;IAChE,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;AACH,CAAC"}

package/node_modules/@xrkseek/checkpoint/dist/process-git.d.ts

@@ -0,0 +1,8 @@
+import type { GitRunner } from "./types.js";
+/**
+ * Default git runner: spawn git, capture stdout/stderr, never inherit stdio.
+ * A missing binary resolves `{ code: -1 }` (rather than rejecting) so the
+ * store can raise its own typed `git-unavailable` error.
+ */
+export declare function createProcessGitRunner(gitPath?: string): GitRunner;
+//# sourceMappingURL=process-git.d.ts.map

package/node_modules/@xrkseek/checkpoint/dist/process-git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-git.d.ts","sourceRoot":"","sources":["../src/process-git.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,SAAQ,GAAG,SAAS,CA6BjE"}

package/node_modules/@xrkseek/checkpoint/dist/process-git.js

@@ -0,0 +1,40 @@
+import { spawn } from "node:child_process";
+const STDIO_CAP = 4_000_000;
+/**
+ * Default git runner: spawn git, capture stdout/stderr, never inherit stdio.
+ * A missing binary resolves `{ code: -1 }` (rather than rejecting) so the
+ * store can raise its own typed `git-unavailable` error.
+ */
+export function createProcessGitRunner(gitPath = "git") {
+    return (args, opts) => new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(gitPath, [...args], {
+                cwd: opts?.cwd,
+                stdio: ["ignore", "pipe", "pipe"],
+                windowsHide: true,
+            });
+        }
+        catch (err) {
+            resolve({ code: -1, stdout: "", stderr: String(err) });
+            return;
+        }
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            if (stdout.length < STDIO_CAP)
+                stdout += chunk.toString("utf8");
+        });
+        child.stderr?.on("data", (chunk) => {
+            if (stderr.length < STDIO_CAP)
+                stderr += chunk.toString("utf8");
+        });
+        child.on("error", (err) => {
+            resolve({ code: -1, stdout, stderr: stderr || String(err) });
+        });
+        child.on("close", (code) => {
+            resolve({ code: code ?? -1, stdout, stderr });
+        });
+    });
+}
+//# sourceMappingURL=process-git.js.map

package/node_modules/@xrkseek/checkpoint/dist/process-git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-git.js","sourceRoot":"","sources":["../src/process-git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,MAAM,SAAS,GAAG,SAAS,CAAC;AAE5B;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAO,GAAG,KAAK;IACpD,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CACpB,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;QACjC,IAAI,KAA+B,CAAC;QACpC,IAAI,CAAC;YACH,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;gBAChC,GAAG,EAAE,IAAI,EAAE,GAAG;gBACd,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;gBACjC,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QACD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/node_modules/@xrkseek/checkpoint/dist/store.d.ts

@@ -0,0 +1,101 @@
+import { type GitRunner, type RestoreOptions, type RestorePlan, type RestoreResult, type SnapshotInput, type WorkspaceCheckpointRecord } from "./types.js";
+/**
+ * Synthetic commit identity for shadow commits. The store must not depend on
+ * (or write to) the operator's git config.
+ */
+export declare const CHECKPOINT_AUTHOR_NAME = "XRK Checkpoint";
+export declare const CHECKPOINT_AUTHOR_EMAIL = "checkpoint@xrk.invalid";
+/** Stable, filesystem-safe id for one workspace path. */
+export declare function workspaceCheckpointId(workspaceDir: string): string;
+/** `<workspace>/.xrk/checkpoints` — shadow repo + index live here. */
+export declare function workspaceCheckpointDir(workspaceDir: string): string;
+/** Shadow git dir inside the checkpoint dir. */
+export declare function shadowGitDir(shadowDir: string): string;
+/** Snapshot index (chronological records) inside the checkpoint dir. */
+export declare function checkpointIndexPath(shadowDir: string): string;
+/** Git-level ignore file pinning the shadow dir out of every snapshot. */
+export declare function checkpointExcludePath(shadowDir: string): string;
+export interface WorkspaceCheckpointStoreOptions {
+    readonly workspaceDir: string;
+    readonly runGit: GitRunner;
+    /** Defaults to {@link workspaceCheckpointDir}. */
+    readonly shadowDir?: string;
+    /** Defaults to `index.json` inside the shadow dir. */
+    readonly indexFile?: string;
+    readonly now?: () => number;
+}
+/**
+ * Turn-scoped workspace snapshots in a shadow git repo.
+ *
+ * Every command pins `--git-dir=<shadow>` **and** `--work-tree=<workspace>`, so
+ * the operator's own repository (and its history) is never touched. `snapshot`
+ * commits the current worktree (`--allow-empty`, so a no-change turn still
+ * records a recoverable point); `restore` checks that commit back out, leaving
+ * files the snapshot never saw in place unless `prune` is requested.
+ *
+ * The shadow dir usually lives *inside* the workspace, so it is pinned into
+ * `core.excludesFile`. Without that, `add -A` would stage the repo's own
+ * objects and `clean -fd` would delete them.
+ */
+export declare class WorkspaceCheckpointStore {
+    readonly workspaceDir: string;
+    readonly shadowDir: string;
+    /** {@link workspaceCheckpointId} for this workspace. */
+    readonly id: string;
+    /** Git-level ignore file (see {@link checkpointExcludePath}). */
+    readonly excludesFile: string;
+    private readonly gitDir;
+    private readonly indexFile;
+    private readonly runGit;
+    private readonly now;
+    /** Work-tree-relative shadow path, when the shadow lives in the workspace. */
+    private readonly shadowRelPath;
+    private records;
+    private repoReady;
+    constructor(options: WorkspaceCheckpointStoreOptions);
+    /**
+     * Git-level argv shared by every command.
+     *
+     * - `core.excludesFile` keeps the shadow dir out of staging and `clean`.
+     * - `core.autocrlf=false` stops a Windows checkout rewriting line endings.
+     * - A synthetic commit identity + `commit.gpgsign=false` make shadow commits
+     *   independent of the operator's git config, so snapshotting works on a
+     *   machine with no `user.name` / `user.email` and never tries to sign.
+     */
+    private get baseArgs();
+    private exec;
+    private execOk;
+    /**
+     * (Re)write the git-level ignore file. Idempotent and cheap: patterns are
+     * only rewritten when the content differs. Safety-critical — `clean -fd`
+     * must never see the shadow repo as untracked.
+     */
+    private ensureExcludesFile;
+    /** Create the shadow repo on first use; idempotent afterwards. */
+    private ensureRepo;
+    /** Like {@link ensureRepo} but never creates: a missing repo is a lost point. */
+    private requireRepo;
+    /** Snapshot the workspace and record it against a session seq. */
+    snapshot(input: SnapshotInput): Promise<WorkspaceCheckpointRecord>;
+    /** Chronological (oldest first) records, newest last. */
+    list(): readonly WorkspaceCheckpointRecord[];
+    get(id: string): WorkspaceCheckpointRecord;
+    /** Untracked, non-ignored files present now but absent from the snapshot. */
+    private extraFiles;
+    /** What a restore would restore and which files it would leave behind. */
+    planRestore(id: string): Promise<RestorePlan>;
+    /**
+     * Restore the snapshot into the worktree. Files the snapshot does not know
+     * about survive unless `prune` is set.
+     */
+    restore(id: string, options?: RestoreOptions): Promise<RestoreResult>;
+    /**
+     * Drop the oldest records, keeping the newest `keep`. Index-only: the
+     * shadow commits stay until git prunes them, so a dropped record is still
+     * restorable by sha when the operator kept a copy.
+     */
+    prune(keep: number): string[];
+    private loadIndex;
+    private saveIndex;
+}
+//# sourceMappingURL=store.d.ts.map

package/node_modules/@xrkseek/checkpoint/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AAKpB;;;GAGG;AACH,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AACvD,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAEhE,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAuCD;;;;;;;;;;;;GAYG;AACH,qBAAa,wBAAwB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,+BAA+B;IAmBpD;;;;;;;;OAQG;IACH,OAAO,KAAK,QAAQ,GAmBnB;YAEa,IAAI;YAIJ,MAAM;IAyBpB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAe1B,kEAAkE;YACpD,UAAU;IASxB,iFAAiF;YACnE,WAAW;IAYzB,kEAAkE;IAC5D,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAoDxE,yDAAyD;IACzD,IAAI,IAAI,SAAS,yBAAyB,EAAE;IAI5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,yBAAyB;IAY1C,6EAA6E;YAC/D,UAAU;IAKxB,0EAA0E;IACpE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAgBnD;;;OAGG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAsB/E;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAc7B,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,SAAS;CAMlB"}