@cotal-ai/workspace 0.171.1 → 0.171.3
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.
- package/dist/agent-grants.d.ts.map +1 -1
- package/dist/agent-grants.js +4 -2
- package/dist/agent-grants.js.map +1 -1
- package/dist/connect.d.ts +9 -4
- package/dist/connect.d.ts.map +1 -1
- package/dist/connect.js +56 -47
- package/dist/connect.js.map +1 -1
- package/dist/connector-retention.d.ts +1 -1
- package/dist/connector-retention.d.ts.map +1 -1
- package/dist/connector-retention.js +54 -19
- package/dist/connector-retention.js.map +1 -1
- package/dist/extension-mutation.d.ts +1 -0
- package/dist/extension-mutation.d.ts.map +1 -1
- package/dist/extension-mutation.js +1 -0
- package/dist/extension-mutation.js.map +1 -1
- package/dist/maintenance-foundation.d.ts +568 -0
- package/dist/maintenance-foundation.d.ts.map +1 -0
- package/dist/maintenance-foundation.js +531 -0
- package/dist/maintenance-foundation.js.map +1 -0
- package/dist/maintenance-journal.d.ts +59 -0
- package/dist/maintenance-journal.d.ts.map +1 -0
- package/dist/maintenance-journal.js +1072 -0
- package/dist/maintenance-journal.js.map +1 -0
- package/dist/maintenance.d.ts +3 -556
- package/dist/maintenance.d.ts.map +1 -1
- package/dist/maintenance.js +7 -1588
- package/dist/maintenance.js.map +1 -1
- package/dist/mesh-registry.d.ts +2 -0
- package/dist/mesh-registry.d.ts.map +1 -1
- package/dist/mesh-registry.js.map +1 -1
- package/dist/mesh-target.d.ts +2 -2
- package/dist/mesh-target.d.ts.map +1 -1
- package/dist/mesh-target.js +30 -2
- package/dist/mesh-target.js.map +1 -1
- package/dist/protected-records.d.ts +3 -0
- package/dist/protected-records.d.ts.map +1 -1
- package/dist/protected-records.js +41 -5
- package/dist/protected-records.js.map +1 -1
- package/dist/render.js +2 -0
- package/dist/render.js.map +1 -1
- package/dist/service-adapter.d.ts +3 -0
- package/dist/service-adapter.d.ts.map +1 -1
- package/dist/service-adapter.js.map +1 -1
- package/dist/update-check.d.ts.map +1 -1
- package/dist/update-check.js +4 -2
- package/dist/update-check.js.map +1 -1
- package/dist/update-recovery.d.ts.map +1 -1
- package/dist/update-recovery.js +13 -11
- package/dist/update-recovery.js.map +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1,531 @@
|
|
|
1
|
+
/** The maintenance foundation: the journal and lock contract types, the structured
|
|
2
|
+
* MaintenanceError, store identity, the process owner and the store-wide maintenance lock that
|
|
3
|
+
* every maintenance operation in `maintenance.ts` builds on. `maintenance.ts` re-exports every public
|
|
4
|
+
* name here, so importers keep their path. */
|
|
5
|
+
import { closeSync, chmodSync, constants, existsSync, fsyncSync, lstatSync, mkdirSync, openSync, readdirSync, readFileSync, realpathSync, renameSync, rmdirSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
|
|
6
|
+
import { hostname } from "node:os";
|
|
7
|
+
import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
8
|
+
import { randomUUID } from "node:crypto";
|
|
9
|
+
import { hardenPrivate } from "@cotal-ai/core";
|
|
10
|
+
import { recordOperationWarning } from "./output.js";
|
|
11
|
+
/** Version 1 lives in `<project>/.cotal/maintenance/v1`; the lock is shared across versions. */
|
|
12
|
+
export const MAINTENANCE_JOURNAL_VERSION = 1;
|
|
13
|
+
export const MAINTENANCE_RESUME_DOCUMENT_VERSION = 1;
|
|
14
|
+
export const MAX_MAINTENANCE_RESUME_BYTES = 1024 * 1024;
|
|
15
|
+
const MAINTENANCE_ERROR = "cotal:workspace:maintenance-error";
|
|
16
|
+
/** Stable code and structured recourse are the consumer contract; `message` is diagnostic text. */
|
|
17
|
+
export class MaintenanceError extends Error {
|
|
18
|
+
brand = MAINTENANCE_ERROR;
|
|
19
|
+
code;
|
|
20
|
+
details;
|
|
21
|
+
constructor(code, message, details) {
|
|
22
|
+
super(message);
|
|
23
|
+
this.name = "MaintenanceError";
|
|
24
|
+
this.code = code;
|
|
25
|
+
this.details = details;
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
export function isMaintenanceError(error) {
|
|
29
|
+
return typeof error === "object" && error !== null &&
|
|
30
|
+
error.brand === MAINTENANCE_ERROR;
|
|
31
|
+
}
|
|
32
|
+
const noRecourse = [];
|
|
33
|
+
export const STORE_ID_FILE = ".cotal-store-id";
|
|
34
|
+
export const ATTEMPT_ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
|
|
35
|
+
export const DURABLE_COMMIT_TOKEN = /^[a-f0-9]{64}$/;
|
|
36
|
+
export function maintenanceError(code, message, details = {}) {
|
|
37
|
+
throw new MaintenanceError(code, message, { ...details, recourse: details.recourse ?? noRecourse });
|
|
38
|
+
}
|
|
39
|
+
export function errno(error) {
|
|
40
|
+
return error.code;
|
|
41
|
+
}
|
|
42
|
+
function canonicalRoot(root) {
|
|
43
|
+
if (!root || !isAbsolute(root))
|
|
44
|
+
maintenanceError("invalid-path", "maintenance root must be an absolute existing directory", {
|
|
45
|
+
root,
|
|
46
|
+
paths: [root],
|
|
47
|
+
});
|
|
48
|
+
let canonical;
|
|
49
|
+
try {
|
|
50
|
+
canonical = realpathSync.native(root);
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
maintenanceError("invalid-path", "maintenance root does not exist", { root, paths: [root] });
|
|
54
|
+
}
|
|
55
|
+
if (!statSync(canonical).isDirectory())
|
|
56
|
+
maintenanceError("invalid-path", "maintenance root is not a directory", { root, paths: [root] });
|
|
57
|
+
return canonical;
|
|
58
|
+
}
|
|
59
|
+
export function maintenancePaths(root) {
|
|
60
|
+
const canonical = canonicalRoot(root);
|
|
61
|
+
const cotalDir = join(canonical, ".cotal");
|
|
62
|
+
const maintenanceDir = join(cotalDir, "maintenance");
|
|
63
|
+
const versionDir = join(maintenanceDir, `v${MAINTENANCE_JOURNAL_VERSION}`);
|
|
64
|
+
return {
|
|
65
|
+
root: canonical,
|
|
66
|
+
cotalDir,
|
|
67
|
+
maintenanceDir,
|
|
68
|
+
versionDir,
|
|
69
|
+
journal: join(versionDir, "journal.json"),
|
|
70
|
+
resume: join(versionDir, "resume.json"),
|
|
71
|
+
prepareIntent: join(versionDir, "prepare-intent.json"),
|
|
72
|
+
commitIntent: join(versionDir, "commit-intent.json"),
|
|
73
|
+
lock: join(maintenanceDir, "lock.json"),
|
|
74
|
+
reaper: join(maintenanceDir, "lock-reaper.json"),
|
|
75
|
+
handoff: join(versionDir, "handoff"),
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
export function fsyncDirectory(path) {
|
|
79
|
+
let fd;
|
|
80
|
+
try {
|
|
81
|
+
fd = openSync(path, constants.O_RDONLY);
|
|
82
|
+
fsyncSync(fd);
|
|
83
|
+
}
|
|
84
|
+
catch (error) {
|
|
85
|
+
// Windows does not support opening/fsyncing a directory. POSIX errors are correctness failures.
|
|
86
|
+
if (process.platform !== "win32")
|
|
87
|
+
throw error;
|
|
88
|
+
}
|
|
89
|
+
finally {
|
|
90
|
+
if (fd !== undefined)
|
|
91
|
+
closeSync(fd);
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
function ensureDirectory(path, harden) {
|
|
95
|
+
if (!existsSync(path)) {
|
|
96
|
+
// A concurrent first operation on this root can create it between the check and the mkdir; the
|
|
97
|
+
// checks below verify what is there, and the lock then names that operation.
|
|
98
|
+
try {
|
|
99
|
+
mkdirSync(path, { mode: 0o700 });
|
|
100
|
+
fsyncDirectory(dirname(path));
|
|
101
|
+
}
|
|
102
|
+
catch (error) {
|
|
103
|
+
if (error.code !== "EEXIST")
|
|
104
|
+
throw error;
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
const stat = lstatSync(path);
|
|
108
|
+
if (!stat.isDirectory() || stat.isSymbolicLink())
|
|
109
|
+
maintenanceError("invalid-path", "maintenance path is not a real directory", { paths: [path] });
|
|
110
|
+
if (harden) {
|
|
111
|
+
if (process.platform !== "win32")
|
|
112
|
+
chmodSync(path, 0o700);
|
|
113
|
+
hardenPrivate(path, "dir");
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
export function ensureLayout(paths) {
|
|
117
|
+
ensureDirectory(paths.cotalDir, false);
|
|
118
|
+
ensureDirectory(paths.maintenanceDir, true);
|
|
119
|
+
ensureDirectory(paths.versionDir, true);
|
|
120
|
+
}
|
|
121
|
+
export function canonicalAbsentPath(path) {
|
|
122
|
+
if (!path || !isAbsolute(path))
|
|
123
|
+
maintenanceError("invalid-path", "store path must be absolute", { paths: [path] });
|
|
124
|
+
const parent = dirname(resolve(path));
|
|
125
|
+
let realParent;
|
|
126
|
+
try {
|
|
127
|
+
realParent = realpathSync.native(parent);
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
maintenanceError("invalid-path", "store parent does not exist", { paths: [parent] });
|
|
131
|
+
}
|
|
132
|
+
const canonical = join(realParent, basename(path));
|
|
133
|
+
if (pathExistsStrict(canonical))
|
|
134
|
+
maintenanceError("path-exists", "store path must be absent", {
|
|
135
|
+
paths: [canonical],
|
|
136
|
+
recourse: [{ action: "inspect", description: "Inspect the unexpected path before retrying.", paths: [canonical] }],
|
|
137
|
+
});
|
|
138
|
+
return canonical;
|
|
139
|
+
}
|
|
140
|
+
export function canonicalCandidatePath(path) {
|
|
141
|
+
if (!path || !isAbsolute(path))
|
|
142
|
+
maintenanceError("invalid-path", "store path must be absolute", { paths: [path] });
|
|
143
|
+
if (pathExistsStrict(resolve(path))) {
|
|
144
|
+
try {
|
|
145
|
+
return realpathSync.native(resolve(path));
|
|
146
|
+
}
|
|
147
|
+
catch {
|
|
148
|
+
maintenanceError("invalid-path", "store path cannot be resolved safely", { paths: [path] });
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
return canonicalAbsentPath(path);
|
|
152
|
+
}
|
|
153
|
+
export function pathContains(parent, child) {
|
|
154
|
+
const fromParent = relative(parent, child);
|
|
155
|
+
return fromParent === "" ||
|
|
156
|
+
(fromParent !== ".." && !fromParent.startsWith(`..${sep}`) && !isAbsolute(fromParent));
|
|
157
|
+
}
|
|
158
|
+
export function assertPathsDoNotOverlap(a, b, message) {
|
|
159
|
+
if (pathContains(a, b) || pathContains(b, a))
|
|
160
|
+
maintenanceError("invalid-path", message, {
|
|
161
|
+
paths: [a, b],
|
|
162
|
+
recourse: [{ action: "inspect", description: "Choose disjoint source and target directory trees.", paths: [a, b] }],
|
|
163
|
+
});
|
|
164
|
+
}
|
|
165
|
+
export function pathExistsStrict(path) {
|
|
166
|
+
try {
|
|
167
|
+
lstatSync(path);
|
|
168
|
+
return true;
|
|
169
|
+
}
|
|
170
|
+
catch (error) {
|
|
171
|
+
if (errno(error) === "ENOENT")
|
|
172
|
+
return false;
|
|
173
|
+
maintenanceError("invalid-path", "filesystem path cannot be inspected safely", { paths: [path] });
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
function storeGeneration(path, create) {
|
|
177
|
+
const marker = join(path, STORE_ID_FILE);
|
|
178
|
+
if (!pathExistsStrict(marker)) {
|
|
179
|
+
if (!create)
|
|
180
|
+
maintenanceError("identity-mismatch", "store generation marker is missing", {
|
|
181
|
+
paths: [path, marker],
|
|
182
|
+
recourse: [{ action: "inspect", description: "Treat this path as a replacement until its provenance is proven.", paths: [path] }],
|
|
183
|
+
});
|
|
184
|
+
writePrivateExclusive(marker, `${randomUUID()}\n`);
|
|
185
|
+
}
|
|
186
|
+
let stat;
|
|
187
|
+
try {
|
|
188
|
+
stat = lstatSync(marker);
|
|
189
|
+
}
|
|
190
|
+
catch {
|
|
191
|
+
maintenanceError("identity-mismatch", "store generation marker cannot be inspected", { paths: [path, marker] });
|
|
192
|
+
}
|
|
193
|
+
if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 128)
|
|
194
|
+
maintenanceError("identity-mismatch", "store generation marker is invalid", { paths: [path, marker] });
|
|
195
|
+
const generation = readFileSync(marker, "utf8").trim();
|
|
196
|
+
if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(generation))
|
|
197
|
+
maintenanceError("identity-mismatch", "store generation marker is corrupt", { paths: [path, marker] });
|
|
198
|
+
return generation;
|
|
199
|
+
}
|
|
200
|
+
function storeIdentity(path, createGeneration) {
|
|
201
|
+
if (!path || !isAbsolute(path))
|
|
202
|
+
maintenanceError("invalid-path", "store path must be absolute", { paths: [path] });
|
|
203
|
+
let canonical;
|
|
204
|
+
try {
|
|
205
|
+
canonical = realpathSync.native(path);
|
|
206
|
+
}
|
|
207
|
+
catch (error) {
|
|
208
|
+
if (errno(error) === "ENOENT")
|
|
209
|
+
maintenanceError("path-missing", "store path is missing", { paths: [path] });
|
|
210
|
+
maintenanceError("invalid-path", "store path cannot be resolved safely", { paths: [path] });
|
|
211
|
+
}
|
|
212
|
+
const stat = lstatSync(canonical, { bigint: true });
|
|
213
|
+
if (!stat.isDirectory() || stat.isSymbolicLink())
|
|
214
|
+
maintenanceError("invalid-path", "store path must be a real directory", { paths: [canonical] });
|
|
215
|
+
return {
|
|
216
|
+
path: canonical, dev: stat.dev.toString(), ino: stat.ino.toString(),
|
|
217
|
+
generation: storeGeneration(canonical, createGeneration),
|
|
218
|
+
};
|
|
219
|
+
}
|
|
220
|
+
/** Read an already-bound store identity. Missing generation is a replacement ambiguity, not absence. */
|
|
221
|
+
export function readStoreIdentity(path) {
|
|
222
|
+
return storeIdentity(path, false);
|
|
223
|
+
}
|
|
224
|
+
/** Bind a stopped source or attempt-owned target to a non-reusable generation marker. */
|
|
225
|
+
export function ensureStoreIdentity(path) {
|
|
226
|
+
return storeIdentity(path, true);
|
|
227
|
+
}
|
|
228
|
+
export function sameStoreIdentity(a, b) {
|
|
229
|
+
return a.path === b.path && a.dev === b.dev && a.ino === b.ino && a.generation === b.generation;
|
|
230
|
+
}
|
|
231
|
+
export function identityAt(path) {
|
|
232
|
+
try {
|
|
233
|
+
return readStoreIdentity(path);
|
|
234
|
+
}
|
|
235
|
+
catch (error) {
|
|
236
|
+
if (isMaintenanceError(error) && error.code === "path-missing")
|
|
237
|
+
return undefined;
|
|
238
|
+
throw error;
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
export function assertStoreIdentity(expected) {
|
|
242
|
+
const actual = identityAt(expected.path);
|
|
243
|
+
if (!actual)
|
|
244
|
+
maintenanceError("path-missing", "recorded store path is missing", {
|
|
245
|
+
paths: [expected.path], expected,
|
|
246
|
+
recourse: [{ action: "inspect", description: "Do not recreate the path; inspect maintenance state first.", paths: [expected.path] }],
|
|
247
|
+
});
|
|
248
|
+
if (!sameStoreIdentity(expected, actual))
|
|
249
|
+
maintenanceError("identity-mismatch", "recorded store path has been replaced", {
|
|
250
|
+
paths: [expected.path], expected, actual,
|
|
251
|
+
recourse: [{ action: "inspect", description: "Preserve both stores and determine which inode is authoritative.", paths: [expected.path] }],
|
|
252
|
+
});
|
|
253
|
+
return actual;
|
|
254
|
+
}
|
|
255
|
+
export function writePrivateExclusive(path, data) {
|
|
256
|
+
let fd;
|
|
257
|
+
let created = false;
|
|
258
|
+
try {
|
|
259
|
+
fd = openSync(path, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY, 0o600);
|
|
260
|
+
created = true;
|
|
261
|
+
writeFileSync(fd, data);
|
|
262
|
+
fsyncSync(fd);
|
|
263
|
+
closeSync(fd);
|
|
264
|
+
fd = undefined;
|
|
265
|
+
hardenPrivate(path, "file");
|
|
266
|
+
fsyncDirectory(dirname(path));
|
|
267
|
+
}
|
|
268
|
+
catch (error) {
|
|
269
|
+
if (fd !== undefined)
|
|
270
|
+
closeSync(fd);
|
|
271
|
+
if (created) {
|
|
272
|
+
try {
|
|
273
|
+
unlinkSync(path);
|
|
274
|
+
}
|
|
275
|
+
catch { /* remove only the path this exclusive create owned */ }
|
|
276
|
+
}
|
|
277
|
+
throw error;
|
|
278
|
+
}
|
|
279
|
+
}
|
|
280
|
+
export function atomicWrite(path, value) {
|
|
281
|
+
const tmp = `${path}.${process.pid}.${randomUUID()}.tmp`;
|
|
282
|
+
try {
|
|
283
|
+
writePrivateExclusive(tmp, `${JSON.stringify(value, null, 2)}\n`);
|
|
284
|
+
renameSync(tmp, path);
|
|
285
|
+
fsyncDirectory(dirname(path));
|
|
286
|
+
}
|
|
287
|
+
catch (error) {
|
|
288
|
+
try {
|
|
289
|
+
unlinkSync(tmp);
|
|
290
|
+
}
|
|
291
|
+
catch { /* best effort for an exclusively-created temp */ }
|
|
292
|
+
throw error;
|
|
293
|
+
}
|
|
294
|
+
}
|
|
295
|
+
export function defaultOwner() {
|
|
296
|
+
return { pid: process.pid, host: hostname(), startedAt: new Date().toISOString(), id: randomUUID() };
|
|
297
|
+
}
|
|
298
|
+
export function localProcessOwnerStatus(owner) {
|
|
299
|
+
if (owner.host !== hostname())
|
|
300
|
+
return "unknown";
|
|
301
|
+
try {
|
|
302
|
+
process.kill(owner.pid, 0);
|
|
303
|
+
return "alive";
|
|
304
|
+
}
|
|
305
|
+
catch (error) {
|
|
306
|
+
if (errno(error) === "ESRCH")
|
|
307
|
+
return "dead";
|
|
308
|
+
if (errno(error) === "EPERM")
|
|
309
|
+
return "alive";
|
|
310
|
+
return "unknown";
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
export function parseOwner(value, label) {
|
|
314
|
+
const o = value;
|
|
315
|
+
if (!o || typeof o !== "object" || !Number.isInteger(o.pid) || o.pid <= 0 ||
|
|
316
|
+
typeof o.host !== "string" || !o.host || typeof o.startedAt !== "string" || !Number.isFinite(Date.parse(o.startedAt)) ||
|
|
317
|
+
typeof o.id !== "string" || !o.id)
|
|
318
|
+
maintenanceError("journal-corrupt", `invalid ${label} owner record`);
|
|
319
|
+
return o;
|
|
320
|
+
}
|
|
321
|
+
function readLockFile(path) {
|
|
322
|
+
let parsed;
|
|
323
|
+
try {
|
|
324
|
+
const stat = lstatSync(path);
|
|
325
|
+
if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 64 * 1024)
|
|
326
|
+
maintenanceError("journal-corrupt", "maintenance lock is not a bounded regular file", { paths: [path] });
|
|
327
|
+
parsed = JSON.parse(readFileSync(path, "utf8"));
|
|
328
|
+
}
|
|
329
|
+
catch (error) {
|
|
330
|
+
if (isMaintenanceError(error))
|
|
331
|
+
throw error;
|
|
332
|
+
if (errno(error) === "ENOENT")
|
|
333
|
+
throw error;
|
|
334
|
+
maintenanceError("journal-corrupt", "maintenance lock cannot be parsed", { paths: [path] });
|
|
335
|
+
}
|
|
336
|
+
const lock = parsed;
|
|
337
|
+
if (!lock || typeof lock !== "object" || typeof lock.token !== "string" || !lock.token)
|
|
338
|
+
maintenanceError("journal-corrupt", "maintenance lock has no token", { paths: [path] });
|
|
339
|
+
const operation = typeof lock.operation === "string" && /^[a-z][a-z -]{0,63}$/.test(lock.operation) ? lock.operation : undefined;
|
|
340
|
+
return { token: lock.token, owner: parseOwner(lock.owner, "lock"), ...(operation ? { operation } : {}) };
|
|
341
|
+
}
|
|
342
|
+
/** The process that holds this root's maintenance lock, and the operation it recorded, for a refused
|
|
343
|
+
* contender to name. Undefined when no lock is held or it cannot be read. */
|
|
344
|
+
export function readMaintenanceLockHolder(root) {
|
|
345
|
+
try {
|
|
346
|
+
const { owner, operation } = readLockFile(maintenancePaths(root).lock);
|
|
347
|
+
return { owner, ...(operation ? { operation } : {}) };
|
|
348
|
+
}
|
|
349
|
+
catch {
|
|
350
|
+
return undefined;
|
|
351
|
+
}
|
|
352
|
+
}
|
|
353
|
+
function removeReaper(path, token) {
|
|
354
|
+
try {
|
|
355
|
+
const current = readLockFile(path);
|
|
356
|
+
if (current.token === token) {
|
|
357
|
+
unlinkSync(path);
|
|
358
|
+
fsyncDirectory(dirname(path));
|
|
359
|
+
}
|
|
360
|
+
}
|
|
361
|
+
catch (error) {
|
|
362
|
+
if (errno(error) !== "ENOENT")
|
|
363
|
+
throw error;
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
/** Whether a live process holds `root`'s maintenance lock, read without taking it: the holder's
|
|
367
|
+
* status as {@link acquireMaintenanceLock} would judge it, or `undefined` when no lock is held. */
|
|
368
|
+
export function maintenanceLockHolder(root) {
|
|
369
|
+
try {
|
|
370
|
+
return localProcessOwnerStatus(readLockFile(maintenancePaths(root).lock).owner);
|
|
371
|
+
}
|
|
372
|
+
catch (error) {
|
|
373
|
+
if (errno(error) === "ENOENT")
|
|
374
|
+
return undefined;
|
|
375
|
+
throw error;
|
|
376
|
+
}
|
|
377
|
+
}
|
|
378
|
+
export function acquireMaintenanceLock(root, options = {}) {
|
|
379
|
+
const paths = maintenancePaths(root);
|
|
380
|
+
ensureLayout(paths);
|
|
381
|
+
const owner = options.owner ?? defaultOwner();
|
|
382
|
+
parseOwner(owner, "requested lock");
|
|
383
|
+
const token = randomUUID();
|
|
384
|
+
const body = `${JSON.stringify({ token, owner, ...(options.operation ? { operation: options.operation } : {}) }, null, 2)}\n`;
|
|
385
|
+
try {
|
|
386
|
+
writePrivateExclusive(paths.lock, body);
|
|
387
|
+
return { root: paths.root, path: paths.lock, token, owner };
|
|
388
|
+
}
|
|
389
|
+
catch (error) {
|
|
390
|
+
if (errno(error) !== "EEXIST")
|
|
391
|
+
throw error;
|
|
392
|
+
}
|
|
393
|
+
// One exclusive reaper serializes stale-owner removal. Without it, two reclaimers could race
|
|
394
|
+
// between checking the old inode and unlinking it, and one could unlink the other's new lock.
|
|
395
|
+
const reaperToken = randomUUID();
|
|
396
|
+
try {
|
|
397
|
+
writePrivateExclusive(paths.reaper, `${JSON.stringify({ token: reaperToken, owner }, null, 2)}\n`);
|
|
398
|
+
}
|
|
399
|
+
catch (error) {
|
|
400
|
+
if (errno(error) === "EEXIST") {
|
|
401
|
+
const stale = readLockFile(paths.reaper);
|
|
402
|
+
const status = (options.ownerStatus ?? localProcessOwnerStatus)(stale.owner);
|
|
403
|
+
if (status === "alive")
|
|
404
|
+
maintenanceError("lock-held", "maintenance lock recovery is already in progress", {
|
|
405
|
+
root: paths.root,
|
|
406
|
+
recourse: [{ action: "retry", description: "Retry after the current maintenance operation exits." }],
|
|
407
|
+
});
|
|
408
|
+
if (status === "unknown")
|
|
409
|
+
maintenanceError("lock-owner-ambiguous", "maintenance lock reaper death cannot be proven", {
|
|
410
|
+
root: paths.root,
|
|
411
|
+
paths: [paths.reaper],
|
|
412
|
+
recourse: [{ action: "inspect", description: "Prove the recorded reaper owner dead before retrying.", paths: [paths.reaper] }],
|
|
413
|
+
});
|
|
414
|
+
// There is no portable token-conditional unlink. Automatic recovery would let two contenders
|
|
415
|
+
// both approve the stale token, then one unlink the other's fresh reaper. Fail closed and make
|
|
416
|
+
// the deliberate single-operator recovery step explicit instead of weakening exclusion.
|
|
417
|
+
maintenanceError("lock-owner-ambiguous", "maintenance lock reaper is stale and requires manual recovery", {
|
|
418
|
+
root: paths.root,
|
|
419
|
+
paths: [paths.lock, paths.reaper],
|
|
420
|
+
recourse: [{
|
|
421
|
+
action: "repair",
|
|
422
|
+
description: "With all Cotal maintenance commands stopped, remove only the recorded stale reaper, then retry; the stale main lock will be recovered normally.",
|
|
423
|
+
paths: [paths.reaper],
|
|
424
|
+
}],
|
|
425
|
+
});
|
|
426
|
+
}
|
|
427
|
+
throw error;
|
|
428
|
+
}
|
|
429
|
+
let takenOver;
|
|
430
|
+
try {
|
|
431
|
+
let existing;
|
|
432
|
+
try {
|
|
433
|
+
existing = readLockFile(paths.lock);
|
|
434
|
+
}
|
|
435
|
+
catch (error) {
|
|
436
|
+
if (errno(error) !== "ENOENT")
|
|
437
|
+
throw error;
|
|
438
|
+
}
|
|
439
|
+
if (existing) {
|
|
440
|
+
const status = (options.ownerStatus ?? localProcessOwnerStatus)(existing.owner);
|
|
441
|
+
if (status === "alive")
|
|
442
|
+
maintenanceError("lock-held", "maintenance lock is held by a live owner", {
|
|
443
|
+
root: paths.root,
|
|
444
|
+
recourse: [{ action: "retry", description: "Wait for the current maintenance operation to finish." }],
|
|
445
|
+
});
|
|
446
|
+
if (status === "unknown")
|
|
447
|
+
maintenanceError("lock-owner-ambiguous", "maintenance lock owner death cannot be proven", {
|
|
448
|
+
root: paths.root,
|
|
449
|
+
recourse: [{ action: "inspect", description: "Confirm the recorded host and process are dead before retrying.", paths: [paths.lock] }],
|
|
450
|
+
});
|
|
451
|
+
const again = readLockFile(paths.lock);
|
|
452
|
+
if (again.token !== existing.token)
|
|
453
|
+
maintenanceError("lock-held", "maintenance lock changed during stale-owner recovery", {
|
|
454
|
+
root: paths.root,
|
|
455
|
+
recourse: [{ action: "retry", description: "Retry after the current maintenance operation exits." }],
|
|
456
|
+
});
|
|
457
|
+
unlinkSync(paths.lock);
|
|
458
|
+
fsyncDirectory(paths.maintenanceDir);
|
|
459
|
+
takenOver = existing.owner;
|
|
460
|
+
}
|
|
461
|
+
}
|
|
462
|
+
finally {
|
|
463
|
+
removeReaper(paths.reaper, reaperToken);
|
|
464
|
+
}
|
|
465
|
+
// Another waiter may win after stale removal. Exclusive create remains the arbiter.
|
|
466
|
+
try {
|
|
467
|
+
writePrivateExclusive(paths.lock, body);
|
|
468
|
+
}
|
|
469
|
+
catch (error) {
|
|
470
|
+
if (errno(error) === "EEXIST")
|
|
471
|
+
maintenanceError("lock-held", "another maintenance operation acquired the recovered lock", {
|
|
472
|
+
root: paths.root,
|
|
473
|
+
recourse: [{ action: "retry", description: "Retry after the current maintenance operation exits." }],
|
|
474
|
+
});
|
|
475
|
+
throw error;
|
|
476
|
+
}
|
|
477
|
+
// A lock is taken over only from an owner proven dead, and the run that takes it says so.
|
|
478
|
+
if (takenOver)
|
|
479
|
+
recordOperationWarning({
|
|
480
|
+
code: "MAINTENANCE_LOCK_TAKEN_OVER",
|
|
481
|
+
target: { root: paths.root, path: paths.lock, owner: { pid: takenOver.pid, host: takenOver.host, startedAt: takenOver.startedAt } },
|
|
482
|
+
message: `took over the maintenance lock in ${paths.root} that process ${takenOver.pid} (started ${takenOver.startedAt}) left; that process is no longer running, so the command it ran there ended without releasing it`,
|
|
483
|
+
});
|
|
484
|
+
return { root: paths.root, path: paths.lock, token, owner };
|
|
485
|
+
}
|
|
486
|
+
export function assertLock(lock) {
|
|
487
|
+
const paths = maintenancePaths(lock.root);
|
|
488
|
+
if (paths.lock !== lock.path)
|
|
489
|
+
maintenanceError("lock-lost", "maintenance lock belongs to a different root", { root: paths.root });
|
|
490
|
+
let current;
|
|
491
|
+
try {
|
|
492
|
+
current = readLockFile(lock.path);
|
|
493
|
+
}
|
|
494
|
+
catch (error) {
|
|
495
|
+
if (errno(error) === "ENOENT")
|
|
496
|
+
maintenanceError("lock-lost", "maintenance lock disappeared", { root: paths.root });
|
|
497
|
+
throw error;
|
|
498
|
+
}
|
|
499
|
+
if (current.token !== lock.token)
|
|
500
|
+
maintenanceError("lock-lost", "maintenance lock ownership changed", { root: paths.root });
|
|
501
|
+
}
|
|
502
|
+
/** Verify a retained lock token at the expected root, without releasing it. */
|
|
503
|
+
export function assertMaintenanceLock(lock, root = lock.root) {
|
|
504
|
+
if (maintenancePaths(root).root !== lock.root)
|
|
505
|
+
maintenanceError("lock-lost", "maintenance lock belongs to a different root", { root: maintenancePaths(root).root });
|
|
506
|
+
assertLock(lock);
|
|
507
|
+
}
|
|
508
|
+
export function releaseMaintenanceLock(lock) {
|
|
509
|
+
assertLock(lock);
|
|
510
|
+
unlinkSync(lock.path);
|
|
511
|
+
fsyncDirectory(dirname(lock.path));
|
|
512
|
+
const onlyLockLayout = lock.createdDirectories !== undefined && readdirSync(join(lock.root, ".cotal")).every((entry) => entry === "maintenance");
|
|
513
|
+
for (const dir of onlyLockLayout ? lock.createdDirectories ?? [] : []) {
|
|
514
|
+
try {
|
|
515
|
+
rmdirSync(dir);
|
|
516
|
+
}
|
|
517
|
+
catch {
|
|
518
|
+
break;
|
|
519
|
+
}
|
|
520
|
+
}
|
|
521
|
+
}
|
|
522
|
+
export function withMaintenanceLock(root, operation, options = {}) {
|
|
523
|
+
const lock = acquireMaintenanceLock(root, options);
|
|
524
|
+
try {
|
|
525
|
+
return operation(lock);
|
|
526
|
+
}
|
|
527
|
+
finally {
|
|
528
|
+
releaseMaintenanceLock(lock);
|
|
529
|
+
}
|
|
530
|
+
}
|
|
531
|
+
//# sourceMappingURL=maintenance-foundation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"maintenance-foundation.js","sourceRoot":"","sources":["../src/maintenance-foundation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { type AttemptBrokerInstance, type AttemptOwnedPath, type CompletedJournalBase, type ControllerCutBinding, type ControllerListenerInstance, type ControllerResumeBinding, type JsonValue, type ListenerProof, type MaintenanceCutCompletionEvidence, type MaintenanceCutContext, type MaintenanceJournal, type MaintenanceLock, type MaintenanceReadyRecord, type MaintenanceRecourse, type MaintenanceResumeDescriptor, type MaintenanceResumeDocument, type ManagerCommitEvidence, type ManagerFinalizeEvidence, type OrdinaryResumeActivationEvidence, type OrdinaryResumeContext, type ProcessOwner, type RestoreActivationEvidence, type RestoreClaim, type RestoreContext } from "./maintenance-foundation.js";
|
|
2
|
+
export declare function exactObjectKeys(value: object, expected: readonly string[]): boolean;
|
|
3
|
+
export declare function canonicalListenerEndpoint(value: string): string | undefined;
|
|
4
|
+
export declare function validManagerCommitEvidence(value: unknown, attemptId: string): value is ManagerCommitEvidence;
|
|
5
|
+
export declare function validManagerFinalizeEvidence(value: unknown, attemptId: string, durableCommitToken: string): value is ManagerFinalizeEvidence;
|
|
6
|
+
export declare function sameManagerCommitEvidence(a: ManagerCommitEvidence, b: ManagerCommitEvidence): boolean;
|
|
7
|
+
export declare function sameManagerFinalizeEvidence(a: ManagerFinalizeEvidence, b: ManagerFinalizeEvidence): boolean;
|
|
8
|
+
export declare function validRestoreActivationEvidence(value: unknown, attemptId: string): value is RestoreActivationEvidence;
|
|
9
|
+
export declare function validOrdinaryResumeActivationEvidence(value: unknown, attemptId: string): value is OrdinaryResumeActivationEvidence;
|
|
10
|
+
export declare function validOwnedPaths(value: unknown): value is readonly AttemptOwnedPath[];
|
|
11
|
+
export declare function validRestoreClaim(value: unknown): value is RestoreClaim;
|
|
12
|
+
/** The cut's controller binding, or undefined for a legacy cut. The journal reader has validated it. */
|
|
13
|
+
export declare function cutController(cut: MaintenanceCutContext): ControllerCutBinding | undefined;
|
|
14
|
+
/** A rollback rebound the broker revision away from the one the cut's broker record runs at, so that
|
|
15
|
+
* record can never start again (`startProcessService` refuses a revision mismatch). */
|
|
16
|
+
export declare function cutBrokerRetired(cut: ControllerCutBinding): boolean;
|
|
17
|
+
export declare function validAttemptBroker(value: unknown, cut: ControllerCutBinding): value is AttemptBrokerInstance;
|
|
18
|
+
/** The resume's controller binding, or undefined for a legacy resume. The journal reader has validated it. */
|
|
19
|
+
export declare function ordinaryResumeController(context: OrdinaryResumeContext): ControllerResumeBinding | undefined;
|
|
20
|
+
type ControllerProofScope = {
|
|
21
|
+
readonly resume: ControllerResumeBinding;
|
|
22
|
+
} | {
|
|
23
|
+
readonly restore: RestoreContext;
|
|
24
|
+
readonly broker?: AttemptBrokerInstance;
|
|
25
|
+
};
|
|
26
|
+
/** A restore's proof scope: its context and the attempt broker its launch binding names. */
|
|
27
|
+
export declare function restoreProofScope(record: {
|
|
28
|
+
readonly restore: RestoreContext;
|
|
29
|
+
readonly launch: {
|
|
30
|
+
readonly [key: string]: JsonValue;
|
|
31
|
+
};
|
|
32
|
+
}): ControllerProofScope;
|
|
33
|
+
export declare function validCutCompletionEvidence(value: unknown, cut: MaintenanceCutContext): value is MaintenanceCutCompletionEvidence;
|
|
34
|
+
export declare function normalizedListenerProof(value: ListenerProof): ListenerProof;
|
|
35
|
+
export declare function sameProcessOwner(a: ProcessOwner, b: ProcessOwner): boolean;
|
|
36
|
+
/** The proof variant must match the cut's custody, and a controller proof must fit the journal's
|
|
37
|
+
* recorded broker. The workspace cannot read service instance records, so the caller passes the
|
|
38
|
+
* live check that the named instance is running at that launch request with that process. A
|
|
39
|
+
* controller proof without that check refuses. */
|
|
40
|
+
export declare function requireCustodyProof(proof: ListenerProof, cut: MaintenanceCutContext, scope: ControllerProofScope | undefined, running: ((instance: ControllerListenerInstance) => boolean) | undefined, root: string, attemptId: string): void;
|
|
41
|
+
export declare function sameListenerProof(a: ListenerProof, b: ListenerProof): boolean;
|
|
42
|
+
export declare function reusesListenerIdentity(a: ListenerProof, b: ListenerProof): boolean;
|
|
43
|
+
export declare function assertListenerOwnerAlive(proof: ListenerProof): void;
|
|
44
|
+
export declare function validJsonObject(value: unknown): value is {
|
|
45
|
+
readonly [key: string]: JsonValue;
|
|
46
|
+
};
|
|
47
|
+
export declare function sameJsonValue(a: JsonValue, b: JsonValue): boolean;
|
|
48
|
+
export declare function sameResumeDescriptor(a: MaintenanceResumeDescriptor, b: MaintenanceResumeDescriptor): boolean;
|
|
49
|
+
/** Atomically persist the bounded private resume inventory and launch provenance before publishing ready. */
|
|
50
|
+
export declare function writeMaintenanceResumeDocument<Inventory extends JsonValue, Launch extends JsonValue>(lock: MaintenanceLock, document: MaintenanceResumeDocument<Inventory, Launch>): MaintenanceResumeDescriptor;
|
|
51
|
+
/** Read exactly the fixed resume file after size, mode, SHA-256, version, and JSON-shape verification. */
|
|
52
|
+
export declare function readMaintenanceResumeDocument<Inventory extends JsonValue = JsonValue, Launch extends JsonValue = JsonValue>(root: string, descriptor: MaintenanceResumeDescriptor): MaintenanceResumeDocument<Inventory, Launch>;
|
|
53
|
+
export declare function validRecourse(value: unknown): value is readonly MaintenanceRecourse[];
|
|
54
|
+
export declare function readMaintenanceJournal(root: string): MaintenanceJournal | undefined;
|
|
55
|
+
export declare function currentJournal(lock: MaintenanceLock): MaintenanceJournal;
|
|
56
|
+
export declare function writeJournal<T extends Omit<MaintenanceJournal, "version" | "revision" | "updatedAt">>(lock: MaintenanceLock, previous: MaintenanceJournal | undefined, next: T): MaintenanceJournal;
|
|
57
|
+
export declare function readyFrom(record: CompletedJournalBase): Omit<MaintenanceReadyRecord, "version" | "revision" | "updatedAt">;
|
|
58
|
+
export {};
|
|
59
|
+
//# sourceMappingURL=maintenance-journal.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"maintenance-journal.d.ts","sourceRoot":"","sources":["../src/maintenance-journal.ts"],"names":[],"mappings":"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"}
|