@rewind-ai/cli 0.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (244) hide show
  1. package/.env.example +8 -0
  2. package/LICENSE +21 -0
  3. package/README.md +39 -0
  4. package/dist/src/action/capture.d.ts +15 -0
  5. package/dist/src/action/capture.js +215 -0
  6. package/dist/src/action/capture.js.map +1 -0
  7. package/dist/src/action/mediate.d.ts +28 -0
  8. package/dist/src/action/mediate.js +109 -0
  9. package/dist/src/action/mediate.js.map +1 -0
  10. package/dist/src/action/mutate.d.ts +11 -0
  11. package/dist/src/action/mutate.js +189 -0
  12. package/dist/src/action/mutate.js.map +1 -0
  13. package/dist/src/action/objects.d.ts +5 -0
  14. package/dist/src/action/objects.js +50 -0
  15. package/dist/src/action/objects.js.map +1 -0
  16. package/dist/src/action/store.d.ts +24 -0
  17. package/dist/src/action/store.js +149 -0
  18. package/dist/src/action/store.js.map +1 -0
  19. package/dist/src/action/types.d.ts +84 -0
  20. package/dist/src/action/types.js +3 -0
  21. package/dist/src/action/types.js.map +1 -0
  22. package/dist/src/action/undo.d.ts +11 -0
  23. package/dist/src/action/undo.js +42 -0
  24. package/dist/src/action/undo.js.map +1 -0
  25. package/dist/src/adapters/filesystem.d.ts +35 -0
  26. package/dist/src/adapters/filesystem.js +499 -0
  27. package/dist/src/adapters/filesystem.js.map +1 -0
  28. package/dist/src/adapters/index.d.ts +7 -0
  29. package/dist/src/adapters/index.js +19 -0
  30. package/dist/src/adapters/index.js.map +1 -0
  31. package/dist/src/adapters/types.d.ts +54 -0
  32. package/dist/src/adapters/types.js +7 -0
  33. package/dist/src/adapters/types.js.map +1 -0
  34. package/dist/src/api/server.d.ts +25 -0
  35. package/dist/src/api/server.js +786 -0
  36. package/dist/src/api/server.js.map +1 -0
  37. package/dist/src/approval/store.d.ts +35 -0
  38. package/dist/src/approval/store.js +113 -0
  39. package/dist/src/approval/store.js.map +1 -0
  40. package/dist/src/checkpoint.d.ts +9 -0
  41. package/dist/src/checkpoint.js +140 -0
  42. package/dist/src/checkpoint.js.map +1 -0
  43. package/dist/src/cli/v5.d.ts +15 -0
  44. package/dist/src/cli/v5.js +110 -0
  45. package/dist/src/cli/v5.js.map +1 -0
  46. package/dist/src/cli.d.ts +2 -0
  47. package/dist/src/cli.js +823 -0
  48. package/dist/src/cli.js.map +1 -0
  49. package/dist/src/clients/types.d.ts +90 -0
  50. package/dist/src/clients/types.js +239 -0
  51. package/dist/src/clients/types.js.map +1 -0
  52. package/dist/src/commercial/auth/provider.d.ts +61 -0
  53. package/dist/src/commercial/auth/provider.js +227 -0
  54. package/dist/src/commercial/auth/provider.js.map +1 -0
  55. package/dist/src/commercial/entitlement/provider.d.ts +27 -0
  56. package/dist/src/commercial/entitlement/provider.js +192 -0
  57. package/dist/src/commercial/entitlement/provider.js.map +1 -0
  58. package/dist/src/commercial/entitlement/signing.d.ts +61 -0
  59. package/dist/src/commercial/entitlement/signing.js +124 -0
  60. package/dist/src/commercial/entitlement/signing.js.map +1 -0
  61. package/dist/src/commercial/env.d.ts +10 -0
  62. package/dist/src/commercial/env.js +40 -0
  63. package/dist/src/commercial/env.js.map +1 -0
  64. package/dist/src/commercial/product.d.ts +26 -0
  65. package/dist/src/commercial/product.js +39 -0
  66. package/dist/src/commercial/product.js.map +1 -0
  67. package/dist/src/commercial/store.d.ts +46 -0
  68. package/dist/src/commercial/store.js +104 -0
  69. package/dist/src/commercial/store.js.map +1 -0
  70. package/dist/src/commercial/stripe/checkout.d.ts +104 -0
  71. package/dist/src/commercial/stripe/checkout.js +469 -0
  72. package/dist/src/commercial/stripe/checkout.js.map +1 -0
  73. package/dist/src/core/compatibility.d.ts +15 -0
  74. package/dist/src/core/compatibility.js +226 -0
  75. package/dist/src/core/compatibility.js.map +1 -0
  76. package/dist/src/core/engine.d.ts +33 -0
  77. package/dist/src/core/engine.js +432 -0
  78. package/dist/src/core/engine.js.map +1 -0
  79. package/dist/src/core/lifecycle.d.ts +17 -0
  80. package/dist/src/core/lifecycle.js +56 -0
  81. package/dist/src/core/lifecycle.js.map +1 -0
  82. package/dist/src/core/types.d.ts +140 -0
  83. package/dist/src/core/types.js +37 -0
  84. package/dist/src/core/types.js.map +1 -0
  85. package/dist/src/destroy.d.ts +21 -0
  86. package/dist/src/destroy.js +219 -0
  87. package/dist/src/destroy.js.map +1 -0
  88. package/dist/src/diff.d.ts +13 -0
  89. package/dist/src/diff.js +251 -0
  90. package/dist/src/diff.js.map +1 -0
  91. package/dist/src/enforcement/detect.d.ts +13 -0
  92. package/dist/src/enforcement/detect.js +75 -0
  93. package/dist/src/enforcement/detect.js.map +1 -0
  94. package/dist/src/enforcement/hook-policy.d.ts +38 -0
  95. package/dist/src/enforcement/hook-policy.js +111 -0
  96. package/dist/src/enforcement/hook-policy.js.map +1 -0
  97. package/dist/src/enforcement/index.d.ts +8 -0
  98. package/dist/src/enforcement/index.js +8 -0
  99. package/dist/src/enforcement/index.js.map +1 -0
  100. package/dist/src/enforcement/perf.d.ts +6 -0
  101. package/dist/src/enforcement/perf.js +18 -0
  102. package/dist/src/enforcement/perf.js.map +1 -0
  103. package/dist/src/enforcement/policy.d.ts +12 -0
  104. package/dist/src/enforcement/policy.js +84 -0
  105. package/dist/src/enforcement/policy.js.map +1 -0
  106. package/dist/src/enforcement/readonly.d.ts +17 -0
  107. package/dist/src/enforcement/readonly.js +124 -0
  108. package/dist/src/enforcement/readonly.js.map +1 -0
  109. package/dist/src/enforcement/sandbox-clone.d.ts +6 -0
  110. package/dist/src/enforcement/sandbox-clone.js +11 -0
  111. package/dist/src/enforcement/sandbox-clone.js.map +1 -0
  112. package/dist/src/enforcement/setup.d.ts +33 -0
  113. package/dist/src/enforcement/setup.js +168 -0
  114. package/dist/src/enforcement/setup.js.map +1 -0
  115. package/dist/src/enforcement/trust.d.ts +10 -0
  116. package/dist/src/enforcement/trust.js +71 -0
  117. package/dist/src/enforcement/trust.js.map +1 -0
  118. package/dist/src/enforcement/types.d.ts +40 -0
  119. package/dist/src/enforcement/types.js +3 -0
  120. package/dist/src/enforcement/types.js.map +1 -0
  121. package/dist/src/entitlement/provider.d.ts +48 -0
  122. package/dist/src/entitlement/provider.js +95 -0
  123. package/dist/src/entitlement/provider.js.map +1 -0
  124. package/dist/src/hash.d.ts +9 -0
  125. package/dist/src/hash.js +23 -0
  126. package/dist/src/hash.js.map +1 -0
  127. package/dist/src/ledger/query.d.ts +19 -0
  128. package/dist/src/ledger/query.js +158 -0
  129. package/dist/src/ledger/query.js.map +1 -0
  130. package/dist/src/manifest.d.ts +32 -0
  131. package/dist/src/manifest.js +242 -0
  132. package/dist/src/manifest.js.map +1 -0
  133. package/dist/src/mcp/server.d.ts +7 -0
  134. package/dist/src/mcp/server.js +364 -0
  135. package/dist/src/mcp/server.js.map +1 -0
  136. package/dist/src/paths.d.ts +94 -0
  137. package/dist/src/paths.js +354 -0
  138. package/dist/src/paths.js.map +1 -0
  139. package/dist/src/permission/engine.d.ts +15 -0
  140. package/dist/src/permission/engine.js +147 -0
  141. package/dist/src/permission/engine.js.map +1 -0
  142. package/dist/src/permission/types.d.ts +42 -0
  143. package/dist/src/permission/types.js +3 -0
  144. package/dist/src/permission/types.js.map +1 -0
  145. package/dist/src/product/setup.d.ts +35 -0
  146. package/dist/src/product/setup.js +300 -0
  147. package/dist/src/product/setup.js.map +1 -0
  148. package/dist/src/protect/audit.d.ts +5 -0
  149. package/dist/src/protect/audit.js +26 -0
  150. package/dist/src/protect/audit.js.map +1 -0
  151. package/dist/src/protect/capture.d.ts +7 -0
  152. package/dist/src/protect/capture.js +250 -0
  153. package/dist/src/protect/capture.js.map +1 -0
  154. package/dist/src/protect/fingerprint.d.ts +4 -0
  155. package/dist/src/protect/fingerprint.js +49 -0
  156. package/dist/src/protect/fingerprint.js.map +1 -0
  157. package/dist/src/protect/hook-cli.d.ts +2 -0
  158. package/dist/src/protect/hook-cli.js +107 -0
  159. package/dist/src/protect/hook-cli.js.map +1 -0
  160. package/dist/src/protect/index.d.ts +12 -0
  161. package/dist/src/protect/index.js +12 -0
  162. package/dist/src/protect/index.js.map +1 -0
  163. package/dist/src/protect/install.d.ts +34 -0
  164. package/dist/src/protect/install.js +293 -0
  165. package/dist/src/protect/install.js.map +1 -0
  166. package/dist/src/protect/intercept.d.ts +11 -0
  167. package/dist/src/protect/intercept.js +390 -0
  168. package/dist/src/protect/intercept.js.map +1 -0
  169. package/dist/src/protect/protect.d.ts +17 -0
  170. package/dist/src/protect/protect.js +194 -0
  171. package/dist/src/protect/protect.js.map +1 -0
  172. package/dist/src/protect/root-paths.d.ts +13 -0
  173. package/dist/src/protect/root-paths.js +140 -0
  174. package/dist/src/protect/root-paths.js.map +1 -0
  175. package/dist/src/protect/shell-policy.d.ts +17 -0
  176. package/dist/src/protect/shell-policy.js +269 -0
  177. package/dist/src/protect/shell-policy.js.map +1 -0
  178. package/dist/src/protect/status.d.ts +11 -0
  179. package/dist/src/protect/status.js +165 -0
  180. package/dist/src/protect/status.js.map +1 -0
  181. package/dist/src/protect/store.d.ts +20 -0
  182. package/dist/src/protect/store.js +170 -0
  183. package/dist/src/protect/store.js.map +1 -0
  184. package/dist/src/protect/types.d.ts +116 -0
  185. package/dist/src/protect/types.js +3 -0
  186. package/dist/src/protect/types.js.map +1 -0
  187. package/dist/src/protect/undo-session.d.ts +14 -0
  188. package/dist/src/protect/undo-session.js +182 -0
  189. package/dist/src/protect/undo-session.js.map +1 -0
  190. package/dist/src/restore.d.ts +39 -0
  191. package/dist/src/restore.js +141 -0
  192. package/dist/src/restore.js.map +1 -0
  193. package/dist/src/sandbox.d.ts +23 -0
  194. package/dist/src/sandbox.js +198 -0
  195. package/dist/src/sandbox.js.map +1 -0
  196. package/dist/src/session/ambient.d.ts +10 -0
  197. package/dist/src/session/ambient.js +53 -0
  198. package/dist/src/session/ambient.js.map +1 -0
  199. package/dist/src/session/attribution.d.ts +27 -0
  200. package/dist/src/session/attribution.js +201 -0
  201. package/dist/src/session/attribution.js.map +1 -0
  202. package/dist/src/session/index.d.ts +25 -0
  203. package/dist/src/session/index.js +472 -0
  204. package/dist/src/session/index.js.map +1 -0
  205. package/dist/src/session/process.d.ts +34 -0
  206. package/dist/src/session/process.js +234 -0
  207. package/dist/src/session/process.js.map +1 -0
  208. package/dist/src/session/store.d.ts +14 -0
  209. package/dist/src/session/store.js +125 -0
  210. package/dist/src/session/store.js.map +1 -0
  211. package/dist/src/session/types.d.ts +111 -0
  212. package/dist/src/session/types.js +3 -0
  213. package/dist/src/session/types.js.map +1 -0
  214. package/dist/src/session/watcher.d.ts +32 -0
  215. package/dist/src/session/watcher.js +186 -0
  216. package/dist/src/session/watcher.js.map +1 -0
  217. package/dist/src/timing.d.ts +7 -0
  218. package/dist/src/timing.js +19 -0
  219. package/dist/src/timing.js.map +1 -0
  220. package/dist/src/types.d.ts +101 -0
  221. package/dist/src/types.js +3 -0
  222. package/dist/src/types.js.map +1 -0
  223. package/dist/src/verify.d.ts +8 -0
  224. package/dist/src/verify.js +126 -0
  225. package/dist/src/verify.js.map +1 -0
  226. package/docs/ADAPTERS.md +37 -0
  227. package/docs/APPROVALS.md +32 -0
  228. package/docs/ARCHITECTURE.md +57 -0
  229. package/docs/ATTRIBUTION.md +179 -0
  230. package/docs/COMMERCIAL.md +51 -0
  231. package/docs/CURSOR-ENFORCEMENT.md +73 -0
  232. package/docs/ENFORCEMENT.md +134 -0
  233. package/docs/FUTURE.md +91 -0
  234. package/docs/HUMAN-SETUP.md +98 -0
  235. package/docs/IDENTITY-AUTHORITY.md +35 -0
  236. package/docs/MCP.md +107 -0
  237. package/docs/PACKAGING.md +77 -0
  238. package/docs/PERMISSIONS.md +53 -0
  239. package/docs/PRODUCT-V5.md +63 -0
  240. package/docs/PRODUCT-V6.md +69 -0
  241. package/docs/PROTECTED-SESSIONS.md +155 -0
  242. package/docs/THREAT-MODEL.md +84 -0
  243. package/docs/TRANSACTIONS.md +57 -0
  244. package/package.json +85 -0
@@ -0,0 +1,499 @@
1
+ /**
2
+ * FilesystemAdapter — wraps proven V2 FS mediation (capture / mutate / undo).
3
+ * Does not duplicate mutation paths; reuses action/* primitives.
4
+ */
5
+ import { assertApprovedSandbox, getSandboxPath, PathSafetyError, SANDBOX_DIR_NAME, } from "../paths.js";
6
+ import { captureEntry, resolveSandboxRelative, snapshotIdentityHash, } from "../action/capture.js";
7
+ import { createDirectoryMediated, createFileMediated, deleteDirectoryMediated, deleteFileMediated, moveFileMediated, restoreSnapshot, writeFileMediated, } from "../action/mutate.js";
8
+ import { operationToTool } from "../core/compatibility.js";
9
+ function emptyAbsent() {
10
+ return {
11
+ exists: false,
12
+ kind: "absent",
13
+ hash: null,
14
+ size: 0,
15
+ mode: null,
16
+ linkTarget: null,
17
+ objectId: null,
18
+ };
19
+ }
20
+ function fsState(primary, secondary = null) {
21
+ return { kind: "filesystem", primary, secondary };
22
+ }
23
+ function sandboxOf(intent) {
24
+ return intent.sandbox ?? SANDBOX_DIR_NAME;
25
+ }
26
+ function projectRootOf(intent) {
27
+ const meta = intent.metadata ?? {};
28
+ const root = meta.projectRoot;
29
+ if (typeof root === "string" && root.length > 0)
30
+ return root;
31
+ throw new PathSafetyError("FilesystemAdapter requires metadata.projectRoot");
32
+ }
33
+ function resolveOp(intent) {
34
+ const op = intent.operation;
35
+ const allowed = [
36
+ "write",
37
+ "create",
38
+ "delete",
39
+ "move",
40
+ "create_directory",
41
+ "delete_directory",
42
+ ];
43
+ if (!allowed.includes(op)) {
44
+ throw new PathSafetyError(`Unknown filesystem operation: ${intent.operation}`);
45
+ }
46
+ return op;
47
+ }
48
+ export class FilesystemAdapter {
49
+ id = "filesystem";
50
+ identifyTarget(intent) {
51
+ const op = resolveOp(intent);
52
+ const root = projectRootOf(intent);
53
+ const sn = sandboxOf(intent);
54
+ if (op === "move") {
55
+ const input = intent.input;
56
+ const from = resolveSandboxRelative(input.from, root, sn);
57
+ const to = resolveSandboxRelative(input.to, root, sn);
58
+ if (!from || !to)
59
+ throw new PathSafetyError("Invalid move paths");
60
+ return {
61
+ type: "file",
62
+ resource: from,
63
+ displayName: `${from} → ${to}`,
64
+ secondary: to,
65
+ };
66
+ }
67
+ const input = intent.input;
68
+ const rel = resolveSandboxRelative(input.path, root, sn);
69
+ if (op === "write" || op === "create" || op === "delete") {
70
+ if (!rel)
71
+ throw new PathSafetyError("Cannot operate on sandbox root as a file");
72
+ }
73
+ if ((op === "create_directory" || op === "delete_directory") && !rel) {
74
+ throw new PathSafetyError("Invalid directory path");
75
+ }
76
+ if (op === "delete_directory" && !rel) {
77
+ throw new PathSafetyError("Cannot delete sandbox root");
78
+ }
79
+ return {
80
+ type: op === "create_directory" || op === "delete_directory"
81
+ ? "directory"
82
+ : "file",
83
+ resource: rel,
84
+ displayName: rel,
85
+ secondary: null,
86
+ };
87
+ }
88
+ async validateOperation(intent) {
89
+ try {
90
+ const root = projectRootOf(intent);
91
+ const sn = sandboxOf(intent);
92
+ await assertApprovedSandbox(getSandboxPath(root, sn), root, sn);
93
+ const target = this.identifyTarget(intent);
94
+ const op = resolveOp(intent);
95
+ if (op === "create") {
96
+ const before = await captureEntry(target.resource, root, {
97
+ storeContent: false,
98
+ sandboxName: sn,
99
+ });
100
+ if (before.exists) {
101
+ return {
102
+ ok: false,
103
+ operation: op,
104
+ target,
105
+ error: `File already exists: ${target.resource}`,
106
+ };
107
+ }
108
+ }
109
+ if (op === "write") {
110
+ const before = await captureEntry(target.resource, root, {
111
+ storeContent: false,
112
+ sandboxName: sn,
113
+ });
114
+ if (before.exists && before.kind !== "file") {
115
+ return {
116
+ ok: false,
117
+ operation: op,
118
+ target,
119
+ error: `Target is not a file: ${target.resource}`,
120
+ };
121
+ }
122
+ }
123
+ if (op === "delete") {
124
+ const before = await captureEntry(target.resource, root, {
125
+ storeContent: false,
126
+ sandboxName: sn,
127
+ });
128
+ if (!before.exists) {
129
+ return {
130
+ ok: false,
131
+ operation: op,
132
+ target,
133
+ error: `File does not exist: ${target.resource}`,
134
+ };
135
+ }
136
+ if (before.kind !== "file" && before.kind !== "symlink") {
137
+ return {
138
+ ok: false,
139
+ operation: op,
140
+ target,
141
+ error: `Not a file: ${target.resource}`,
142
+ };
143
+ }
144
+ }
145
+ if (op === "move") {
146
+ const to = target.secondary;
147
+ const before = await captureEntry(target.resource, root, {
148
+ storeContent: false,
149
+ sandboxName: sn,
150
+ });
151
+ if (!before.exists) {
152
+ return {
153
+ ok: false,
154
+ operation: op,
155
+ target,
156
+ error: `Source missing: ${target.resource}`,
157
+ };
158
+ }
159
+ const dest = await captureEntry(to, root, {
160
+ storeContent: false,
161
+ sandboxName: sn,
162
+ });
163
+ if (dest.exists) {
164
+ return {
165
+ ok: false,
166
+ operation: op,
167
+ target,
168
+ error: `Destination already exists: ${to}`,
169
+ };
170
+ }
171
+ }
172
+ if (op === "delete_directory") {
173
+ const before = await captureEntry(target.resource, root, {
174
+ storeContent: false,
175
+ sandboxName: sn,
176
+ });
177
+ if (!before.exists || before.kind !== "directory") {
178
+ return {
179
+ ok: false,
180
+ operation: op,
181
+ target,
182
+ error: `Not a directory: ${target.resource}`,
183
+ };
184
+ }
185
+ }
186
+ return { ok: true, operation: op, target };
187
+ }
188
+ catch (err) {
189
+ return {
190
+ ok: false,
191
+ operation: intent.operation,
192
+ target: intent.target,
193
+ error: err instanceof Error ? err.message : String(err),
194
+ };
195
+ }
196
+ }
197
+ async inspectCurrent(intent) {
198
+ const root = projectRootOf(intent);
199
+ const sn = sandboxOf(intent);
200
+ const target = this.identifyTarget(intent);
201
+ const op = resolveOp(intent);
202
+ const primary = await captureEntry(target.resource, root, {
203
+ storeContent: true,
204
+ captureSubtree: op === "delete_directory",
205
+ sandboxName: sn,
206
+ });
207
+ let secondary = null;
208
+ if (op === "move" && target.secondary) {
209
+ secondary = await captureEntry(target.secondary, root, {
210
+ storeContent: true,
211
+ sandboxName: sn,
212
+ });
213
+ }
214
+ return fsState(primary, secondary);
215
+ }
216
+ async captureBefore(intent) {
217
+ const root = projectRootOf(intent);
218
+ const sn = sandboxOf(intent);
219
+ const target = this.identifyTarget(intent);
220
+ const op = resolveOp(intent);
221
+ let createOnly = false;
222
+ if (op === "write" || op === "create") {
223
+ const input = intent.input;
224
+ createOnly = Boolean(input.createOnly) || op === "create";
225
+ }
226
+ const storeContent = op === "write" ||
227
+ op === "create" ||
228
+ op === "delete" ||
229
+ op === "move" ||
230
+ op === "delete_directory";
231
+ const primary = await captureEntry(target.resource, root, {
232
+ storeContent,
233
+ captureSubtree: op === "delete_directory",
234
+ sandboxName: sn,
235
+ });
236
+ let secondary = null;
237
+ if (op === "move" && target.secondary) {
238
+ secondary = await captureEntry(target.secondary, root, {
239
+ storeContent: true,
240
+ sandboxName: sn,
241
+ });
242
+ }
243
+ let resolvedOp = op;
244
+ if (op === "write" && !createOnly && !primary.exists) {
245
+ resolvedOp = "create";
246
+ }
247
+ if (op === "write" && createOnly) {
248
+ resolvedOp = "create";
249
+ }
250
+ const legacyTool = operationToTool(resolvedOp, createOnly || resolvedOp === "create");
251
+ return {
252
+ before: fsState(primary, secondary),
253
+ reversibility: "REVERSIBLE",
254
+ strategy: "restore_snapshot",
255
+ legacyTool,
256
+ };
257
+ }
258
+ async execute(intent, txn) {
259
+ const root = projectRootOf(intent);
260
+ const sn = sandboxOf(intent);
261
+ const op = (txn.legacyTool
262
+ ? toolToFsOp(txn.legacyTool)
263
+ : resolveOp(intent));
264
+ const rel = txn.target.resource;
265
+ if (op === "create" || (op === "write" && txn.legacyTool === "rewind_create_file")) {
266
+ const input = intent.input;
267
+ await createFileMediated(rel, input.content, root, 0o644, sn);
268
+ }
269
+ else if (op === "write") {
270
+ const input = intent.input;
271
+ await writeFileMediated(rel, input.content, root, 0o644, sn);
272
+ }
273
+ else if (op === "delete") {
274
+ await deleteFileMediated(rel, root, sn);
275
+ }
276
+ else if (op === "move") {
277
+ const to = txn.target.secondary;
278
+ await moveFileMediated(rel, to, root, sn);
279
+ }
280
+ else if (op === "create_directory") {
281
+ await createDirectoryMediated(rel, root, 0o755, sn);
282
+ }
283
+ else if (op === "delete_directory") {
284
+ await deleteDirectoryMediated(rel, root, sn);
285
+ }
286
+ else {
287
+ throw new Error(`Unsupported filesystem execute: ${op}`);
288
+ }
289
+ const after = await this.captureAfter(intent, txn);
290
+ return { after };
291
+ }
292
+ async captureAfter(intent, txn) {
293
+ const root = projectRootOf(intent);
294
+ const sn = sandboxOf(intent);
295
+ const op = resolveOp(intent);
296
+ const storeContent = op === "write" ||
297
+ op === "create" ||
298
+ op === "move" ||
299
+ (txn.legacyTool === "rewind_write_file" ||
300
+ txn.legacyTool === "rewind_create_file" ||
301
+ txn.legacyTool === "rewind_move_file");
302
+ const primary = await captureEntry(txn.target.resource, root, {
303
+ storeContent: storeContent &&
304
+ txn.legacyTool !== "rewind_delete_file" &&
305
+ txn.legacyTool !== "rewind_delete_directory" &&
306
+ txn.legacyTool !== "rewind_move_file",
307
+ sandboxName: sn,
308
+ });
309
+ let secondary = null;
310
+ if ((op === "move" || txn.legacyTool === "rewind_move_file") &&
311
+ txn.target.secondary) {
312
+ secondary = await captureEntry(txn.target.secondary, root, {
313
+ storeContent: true,
314
+ sandboxName: sn,
315
+ });
316
+ // for move, source should be absent
317
+ const fromAfter = await captureEntry(txn.target.resource, root, {
318
+ storeContent: false,
319
+ sandboxName: sn,
320
+ });
321
+ return fsState(fromAfter, secondary);
322
+ }
323
+ return fsState(primary, secondary);
324
+ }
325
+ async compareExpectedCurrent(txn) {
326
+ if (txn.after?.kind !== "filesystem") {
327
+ return {
328
+ matches: false,
329
+ expected: null,
330
+ actual: null,
331
+ detail: "Missing filesystem after-state",
332
+ };
333
+ }
334
+ const root = typeof txn.metadata.projectRoot === "string"
335
+ ? txn.metadata.projectRoot
336
+ : null;
337
+ if (!root) {
338
+ return {
339
+ matches: false,
340
+ expected: null,
341
+ actual: null,
342
+ detail: "Missing projectRoot in transaction metadata",
343
+ };
344
+ }
345
+ const sn = txn.sandbox ?? SANDBOX_DIR_NAME;
346
+ if (txn.legacyTool === "rewind_move_file" || txn.operation === "move") {
347
+ const fromNow = await captureEntry(txn.target.resource, root, {
348
+ storeContent: false,
349
+ sandboxName: sn,
350
+ });
351
+ const toRel = txn.target.secondary;
352
+ if (!toRel) {
353
+ return {
354
+ matches: false,
355
+ expected: null,
356
+ actual: null,
357
+ detail: "Move action missing destination",
358
+ };
359
+ }
360
+ const toNow = await captureEntry(toRel, root, {
361
+ storeContent: true,
362
+ sandboxName: sn,
363
+ });
364
+ const expectedFrom = snapshotIdentityHash(txn.after.primary);
365
+ const expectedTo = snapshotIdentityHash(txn.after.secondary ?? emptyAbsent());
366
+ const actualFrom = snapshotIdentityHash(fromNow);
367
+ const actualTo = snapshotIdentityHash(toNow);
368
+ const matches = expectedFrom === actualFrom && expectedTo === actualTo;
369
+ return {
370
+ matches,
371
+ expected: `${expectedFrom}|${expectedTo}`,
372
+ actual: `${actualFrom}|${actualTo}`,
373
+ detail: matches
374
+ ? "Move endpoints match recorded after-state"
375
+ : "Move endpoints diverged from recorded after-state",
376
+ };
377
+ }
378
+ const now = await captureEntry(txn.target.resource, root, {
379
+ storeContent: true,
380
+ captureSubtree: txn.after.primary.kind === "directory" ||
381
+ (txn.before?.kind === "filesystem" &&
382
+ txn.before.primary.kind === "directory"),
383
+ sandboxName: sn,
384
+ });
385
+ const expected = snapshotIdentityHash(txn.after.primary);
386
+ const actual = snapshotIdentityHash(now);
387
+ return {
388
+ matches: expected === actual,
389
+ expected,
390
+ actual,
391
+ detail: expected === actual
392
+ ? "Current state matches recorded after-state"
393
+ : "CURRENT != RECORDED AFTER",
394
+ };
395
+ }
396
+ async reverse(txn) {
397
+ if (txn.before?.kind !== "filesystem") {
398
+ return { ok: false, restoredFingerprint: null, error: "No before state" };
399
+ }
400
+ const root = typeof txn.metadata.projectRoot === "string"
401
+ ? txn.metadata.projectRoot
402
+ : null;
403
+ if (!root) {
404
+ return {
405
+ ok: false,
406
+ restoredFingerprint: null,
407
+ error: "Missing projectRoot",
408
+ };
409
+ }
410
+ const sn = txn.sandbox ?? SANDBOX_DIR_NAME;
411
+ const before = txn.before.primary;
412
+ const beforeSecondary = txn.before.secondary;
413
+ try {
414
+ if (txn.legacyTool === "rewind_move_file" || txn.operation === "move") {
415
+ const to = txn.target.secondary;
416
+ await restoreSnapshot(txn.target.resource, before, root, sn);
417
+ await restoreSnapshot(to, beforeSecondary ?? emptyAbsent(), root, sn);
418
+ }
419
+ else {
420
+ await restoreSnapshot(txn.target.resource, before, root, sn);
421
+ }
422
+ const restored = await captureEntry(txn.target.resource, root, {
423
+ storeContent: true,
424
+ captureSubtree: before.kind === "directory",
425
+ sandboxName: sn,
426
+ });
427
+ let restoredHash = snapshotIdentityHash(restored);
428
+ let ok = restoredHash === snapshotIdentityHash(before);
429
+ if (txn.legacyTool === "rewind_move_file" && txn.target.secondary) {
430
+ const dest = await captureEntry(txn.target.secondary, root, {
431
+ storeContent: false,
432
+ sandboxName: sn,
433
+ });
434
+ const expectedDest = snapshotIdentityHash(beforeSecondary ?? emptyAbsent());
435
+ const actualDest = snapshotIdentityHash(dest);
436
+ restoredHash = `${snapshotIdentityHash(restored)}|${actualDest}`;
437
+ ok =
438
+ snapshotIdentityHash(restored) === snapshotIdentityHash(before) &&
439
+ actualDest === expectedDest;
440
+ }
441
+ else if (!before.exists) {
442
+ ok = !restored.exists;
443
+ restoredHash = restored.exists
444
+ ? snapshotIdentityHash(restored)
445
+ : "ABSENT";
446
+ }
447
+ else if (before.kind === "directory" && before.subtree) {
448
+ const withTree = await captureEntry(txn.target.resource, root, {
449
+ storeContent: true,
450
+ captureSubtree: true,
451
+ sandboxName: sn,
452
+ });
453
+ restoredHash = snapshotIdentityHash(withTree);
454
+ ok = restoredHash === snapshotIdentityHash(before);
455
+ }
456
+ const result = {
457
+ ok,
458
+ restoredFingerprint: restoredHash,
459
+ };
460
+ if (!ok)
461
+ result.error = "Undo verification failed";
462
+ return result;
463
+ }
464
+ catch (err) {
465
+ return {
466
+ ok: false,
467
+ restoredFingerprint: null,
468
+ error: err instanceof Error ? err.message : String(err),
469
+ };
470
+ }
471
+ }
472
+ describe(txn) {
473
+ const label = `${txn.operation} ${txn.target.displayName ?? txn.target.resource}`;
474
+ return {
475
+ summary: `filesystem:${label}`,
476
+ humanLabel: label,
477
+ };
478
+ }
479
+ }
480
+ function toolToFsOp(tool) {
481
+ switch (tool) {
482
+ case "rewind_write_file":
483
+ return "write";
484
+ case "rewind_create_file":
485
+ return "create";
486
+ case "rewind_delete_file":
487
+ return "delete";
488
+ case "rewind_move_file":
489
+ return "move";
490
+ case "rewind_create_directory":
491
+ return "create_directory";
492
+ case "rewind_delete_directory":
493
+ return "delete_directory";
494
+ default:
495
+ return "write";
496
+ }
497
+ }
498
+ export const filesystemAdapter = new FilesystemAdapter();
499
+ //# sourceMappingURL=filesystem.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../../src/adapters/filesystem.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /** Adapter registry — filesystem is the only shipped adapter in V5. */
2
+ import type { RewindAdapter } from "./types.js";
3
+ export declare function getAdapter(id: string): RewindAdapter;
4
+ export declare function listAdapters(): string[];
5
+ export declare function registerAdapter(adapter: RewindAdapter): void;
6
+ export type { RewindAdapter } from "./types.js";
7
+ export { filesystemAdapter } from "./filesystem.js";
@@ -0,0 +1,19 @@
1
+ /** Adapter registry — filesystem is the only shipped adapter in V5. */
2
+ import { filesystemAdapter } from "./filesystem.js";
3
+ const registry = new Map();
4
+ registry.set(filesystemAdapter.id, filesystemAdapter);
5
+ export function getAdapter(id) {
6
+ const adapter = registry.get(id);
7
+ if (!adapter) {
8
+ throw new Error(`No adapter registered for "${id}". V5 ships filesystem only.`);
9
+ }
10
+ return adapter;
11
+ }
12
+ export function listAdapters() {
13
+ return [...registry.keys()];
14
+ }
15
+ export function registerAdapter(adapter) {
16
+ registry.set(adapter.id, adapter);
17
+ }
18
+ export { filesystemAdapter } from "./filesystem.js";
19
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAClD,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAEtD,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,8BAA8B,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAGD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,54 @@
1
+ /**
2
+ * RewindAdapter — mediation surface for a target domain.
3
+ * Filesystem is the first production adapter. Do not assume every adapter
4
+ * behaves like a file.
5
+ */
6
+ import type { AdapterStatePayload, ReversibilityClass, Transaction, TransactionIntent, TransactionTarget } from "../core/types.js";
7
+ export interface AdapterValidation {
8
+ ok: boolean;
9
+ operation: string;
10
+ target: TransactionTarget;
11
+ error?: string | undefined;
12
+ }
13
+ export interface AdapterPrepareResult {
14
+ before: AdapterStatePayload;
15
+ reversibility: ReversibilityClass;
16
+ strategy: string | null;
17
+ /** Legacy tool name for FS ledger compatibility. */
18
+ legacyTool?: string;
19
+ }
20
+ export interface AdapterExecuteResult {
21
+ after: AdapterStatePayload;
22
+ }
23
+ export interface AdapterCompareResult {
24
+ matches: boolean;
25
+ expected: string | null;
26
+ actual: string | null;
27
+ detail: string;
28
+ }
29
+ export interface AdapterReverseResult {
30
+ ok: boolean;
31
+ restoredFingerprint: string | null;
32
+ error?: string | undefined;
33
+ }
34
+ export interface AdapterDescribe {
35
+ summary: string;
36
+ humanLabel: string;
37
+ }
38
+ /**
39
+ * Contract every adapter must implement.
40
+ * Capture / execute / compare / reverse are adapter-defined.
41
+ */
42
+ export interface RewindAdapter {
43
+ readonly id: string;
44
+ identifyTarget(intent: TransactionIntent): TransactionTarget;
45
+ validateOperation(intent: TransactionIntent): Promise<AdapterValidation>;
46
+ /** Inspect current state without mutating (for approval revalidation). */
47
+ inspectCurrent(intent: TransactionIntent): Promise<AdapterStatePayload>;
48
+ captureBefore(intent: TransactionIntent): Promise<AdapterPrepareResult>;
49
+ execute(intent: TransactionIntent, txn: Transaction): Promise<AdapterExecuteResult>;
50
+ captureAfter(intent: TransactionIntent, txn: Transaction): Promise<AdapterStatePayload>;
51
+ compareExpectedCurrent(txn: Transaction): Promise<AdapterCompareResult>;
52
+ reverse(txn: Transaction): Promise<AdapterReverseResult>;
53
+ describe(txn: Transaction): AdapterDescribe;
54
+ }
@@ -0,0 +1,7 @@
1
+ /**
2
+ * RewindAdapter — mediation surface for a target domain.
3
+ * Filesystem is the first production adapter. Do not assume every adapter
4
+ * behaves like a file.
5
+ */
6
+ export {};
7
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Local-only REWIND control API for a future desktop app.
3
+ *
4
+ * Security:
5
+ * - Binds to 127.0.0.1 only (never 0.0.0.0)
6
+ * - Requires a session token issued at startup (file + response)
7
+ * - No cloud, no public exposure
8
+ *
9
+ * Threat model: see docs/THREAT-MODEL.md
10
+ */
11
+ export interface LocalApiOptions {
12
+ projectRoot?: string;
13
+ /** Loopback port. Default 7429. */
14
+ port?: number;
15
+ /** If true, keep process alive (CLI mode). */
16
+ listen?: boolean;
17
+ }
18
+ export interface LocalApiHandle {
19
+ port: number;
20
+ host: string;
21
+ token: string;
22
+ url: string;
23
+ close: () => Promise<void>;
24
+ }
25
+ export declare function startLocalApiServer(options?: LocalApiOptions): Promise<LocalApiHandle>;