pi-daddy 0.49.5 → 0.50.0
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/CHANGELOG.md +51 -1
- package/README.md +217 -27
- package/dist/governance/initiative-coordinator.d.ts +58 -0
- package/dist/governance/initiative-coordinator.d.ts.map +1 -0
- package/dist/governance/initiative-coordinator.js +348 -0
- package/dist/governance/initiative-coordinator.js.map +1 -0
- package/dist/governance/initiative-effects.d.ts +20 -0
- package/dist/governance/initiative-effects.d.ts.map +1 -0
- package/dist/governance/initiative-effects.js +108 -0
- package/dist/governance/initiative-effects.js.map +1 -0
- package/dist/governance/initiative-state.d.ts +13 -0
- package/dist/governance/initiative-state.d.ts.map +1 -0
- package/dist/governance/initiative-state.js +122 -0
- package/dist/governance/initiative-state.js.map +1 -0
- package/dist/governance/operation-artifact-io.d.ts +8 -0
- package/dist/governance/operation-artifact-io.d.ts.map +1 -0
- package/dist/governance/operation-artifact-io.js +95 -0
- package/dist/governance/operation-artifact-io.js.map +1 -0
- package/dist/governance/operation-artifact-scan.d.ts +13 -0
- package/dist/governance/operation-artifact-scan.d.ts.map +1 -0
- package/dist/governance/operation-artifact-scan.js +71 -0
- package/dist/governance/operation-artifact-scan.js.map +1 -0
- package/dist/governance/operation-artifacts.d.ts +53 -0
- package/dist/governance/operation-artifacts.d.ts.map +1 -0
- package/dist/governance/operation-artifacts.js +309 -0
- package/dist/governance/operation-artifacts.js.map +1 -0
- package/dist/governance/runtime-settlement.d.ts +2 -0
- package/dist/governance/runtime-settlement.d.ts.map +1 -1
- package/dist/governance/runtime-settlement.js +26 -0
- package/dist/governance/runtime-settlement.js.map +1 -1
- package/dist/governance/workspace-acceptance.d.ts +5 -0
- package/dist/governance/workspace-acceptance.d.ts.map +1 -1
- package/dist/governance/workspace-acceptance.js +16 -0
- package/dist/governance/workspace-acceptance.js.map +1 -1
- package/dist/index.d.ts +8 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -1
- package/dist/kernel/dashboard-observation.d.ts +76 -0
- package/dist/kernel/dashboard-observation.d.ts.map +1 -0
- package/dist/kernel/dashboard-observation.js +49 -0
- package/dist/kernel/dashboard-observation.js.map +1 -0
- package/dist/kernel/dispatch-operation.d.ts +2 -0
- package/dist/kernel/dispatch-operation.d.ts.map +1 -1
- package/dist/kernel/dispatch-operation.js.map +1 -1
- package/dist/kernel/initiative.d.ts +94 -0
- package/dist/kernel/initiative.d.ts.map +1 -0
- package/dist/kernel/initiative.js +38 -0
- package/dist/kernel/initiative.js.map +1 -0
- package/dist/kernel/operation-artifact.d.ts +49 -0
- package/dist/kernel/operation-artifact.d.ts.map +1 -0
- package/dist/kernel/operation-artifact.js +4 -0
- package/dist/kernel/operation-artifact.js.map +1 -0
- package/dist/kernel/principal-binding.d.ts +4 -0
- package/dist/kernel/principal-binding.d.ts.map +1 -0
- package/dist/kernel/principal-binding.js +94 -0
- package/dist/kernel/principal-binding.js.map +1 -0
- package/dist/kernel/project-paths.d.ts +6 -0
- package/dist/kernel/project-paths.d.ts.map +1 -1
- package/dist/kernel/project-paths.js +12 -0
- package/dist/kernel/project-paths.js.map +1 -1
- package/dist/kernel/selected-definitions.d.ts.map +1 -1
- package/dist/kernel/selected-definitions.js +5 -91
- package/dist/kernel/selected-definitions.js.map +1 -1
- package/dist/kernel/workspace-diagnostics.d.ts +24 -0
- package/dist/kernel/workspace-diagnostics.d.ts.map +1 -0
- package/dist/kernel/workspace-diagnostics.js +81 -0
- package/dist/kernel/workspace-diagnostics.js.map +1 -0
- package/dist/products/activity-storage.d.ts +2 -0
- package/dist/products/activity-storage.d.ts.map +1 -0
- package/dist/products/activity-storage.js +119 -0
- package/dist/products/activity-storage.js.map +1 -0
- package/dist/products/activity-timeline.d.ts +4 -0
- package/dist/products/activity-timeline.d.ts.map +1 -1
- package/dist/products/activity-timeline.js +12 -0
- package/dist/products/activity-timeline.js.map +1 -1
- package/dist/products/dashboard-cli.d.ts +2 -0
- package/dist/products/dashboard-cli.d.ts.map +1 -1
- package/dist/products/dashboard-cli.js +41 -9
- package/dist/products/dashboard-cli.js.map +1 -1
- package/dist/products/dashboard-display-controls.d.ts.map +1 -1
- package/dist/products/dashboard-display-controls.js +30 -0
- package/dist/products/dashboard-display-controls.js.map +1 -1
- package/dist/products/dashboard-file-cache.d.ts +10 -0
- package/dist/products/dashboard-file-cache.d.ts.map +1 -0
- package/dist/products/dashboard-file-cache.js +38 -0
- package/dist/products/dashboard-file-cache.js.map +1 -0
- package/dist/products/dashboard-panels.d.ts +6 -0
- package/dist/products/dashboard-panels.d.ts.map +1 -0
- package/dist/products/dashboard-panels.js +179 -0
- package/dist/products/dashboard-panels.js.map +1 -0
- package/dist/products/dashboard-screen.d.ts +8 -0
- package/dist/products/dashboard-screen.d.ts.map +1 -1
- package/dist/products/dashboard-screen.js +86 -15
- package/dist/products/dashboard-screen.js.map +1 -1
- package/dist/products/dashboard-session-client.d.ts +16 -2
- package/dist/products/dashboard-session-client.d.ts.map +1 -1
- package/dist/products/dashboard-session-client.js +64 -11
- package/dist/products/dashboard-session-client.js.map +1 -1
- package/dist/products/dashboard-settings.d.ts.map +1 -1
- package/dist/products/dashboard-settings.js +4 -6
- package/dist/products/dashboard-settings.js.map +1 -1
- package/dist/products/ecosystem-versions.d.ts +1 -1
- package/dist/products/ecosystem-versions.d.ts.map +1 -1
- package/extensions/activity-timeline.ts +3 -1
- package/extensions/artifact-bridge.ts +130 -0
- package/extensions/dashboard-live.ts +63 -0
- package/extensions/dashboard-observation.ts +39 -0
- package/extensions/dashboard-session-server.ts +45 -3
- package/extensions/dashboard-sources.ts +124 -0
- package/extensions/delegation-artifacts.ts +125 -0
- package/extensions/delegation-operations.ts +42 -13
- package/extensions/ecosystem-versions.ts +12 -5
- package/extensions/grants-command.ts +34 -6
- package/extensions/grants.ts +9 -20
- package/extensions/initiative-dashboard.ts +143 -0
- package/extensions/initiative-runtime.ts +406 -0
- package/extensions/runtime-snapshot.ts +118 -2
- package/extensions/session-environment.ts +13 -1
- package/extensions/session.ts +28 -10
- package/extensions/workspace-diagnostics.ts +90 -0
- package/package.json +1 -1
- package/src/governance/initiative-coordinator.ts +400 -0
- package/src/governance/initiative-effects.ts +146 -0
- package/src/governance/initiative-state.ts +144 -0
- package/src/governance/operation-artifact-io.ts +103 -0
- package/src/governance/operation-artifact-scan.ts +77 -0
- package/src/governance/operation-artifacts.ts +363 -0
- package/src/governance/runtime-settlement.ts +28 -0
- package/src/governance/workspace-acceptance.ts +18 -0
- package/src/index.ts +13 -0
- package/src/kernel/dashboard-observation.ts +109 -0
- package/src/kernel/dispatch-operation.ts +2 -0
- package/src/kernel/initiative.ts +126 -0
- package/src/kernel/operation-artifact.ts +46 -0
- package/src/kernel/principal-binding.ts +104 -0
- package/src/kernel/project-paths.ts +16 -0
- package/src/kernel/selected-definitions.ts +5 -100
- package/src/kernel/workspace-diagnostics.ts +110 -0
- package/src/products/activity-storage.ts +128 -0
- package/src/products/activity-timeline.ts +11 -0
- package/src/products/dashboard-cli.ts +44 -9
- package/src/products/dashboard-display-controls.ts +27 -0
- package/src/products/dashboard-file-cache.ts +38 -0
- package/src/products/dashboard-panels.ts +217 -0
- package/src/products/dashboard-screen.ts +107 -17
- package/src/products/dashboard-session-client.ts +78 -14
- package/src/products/dashboard-settings.ts +4 -6
- package/src/products/ecosystem-versions.ts +2 -1
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
/** Bounded private snapshot under the existing Daddy agent state; callers hold the existing OS lock. */
|
|
2
|
+
import { randomUUID } from "node:crypto";
|
|
3
|
+
import { constants, openSync, closeSync, fsyncSync, writeFileSync, renameSync, unlinkSync, realpathSync, existsSync, } from "node:fs";
|
|
4
|
+
import { join } from "node:path";
|
|
5
|
+
import { readBoundedTextSync } from "../kernel/bounded-read-sync.js";
|
|
6
|
+
import { initiativeStateDir } from "../kernel/project-paths.js";
|
|
7
|
+
import { validOperationId } from "../kernel/dispatch-operation.js";
|
|
8
|
+
import { validInitiativeId, validEffectReceipt, sameEffectTarget, validInitiativeTask, } from "../kernel/initiative.js";
|
|
9
|
+
import { artifactHash, privateArtifactDirectory } from "./operation-artifact-io.js";
|
|
10
|
+
const MAX_BYTES = 512 * 1024;
|
|
11
|
+
export const initiativeRevision = (record) => artifactHash(JSON.stringify(record));
|
|
12
|
+
export function initiativeLocation(directory, id, create = false) {
|
|
13
|
+
if (!validInitiativeId(id))
|
|
14
|
+
throw Error("invalid initiative identity");
|
|
15
|
+
const root = initiativeStateDir(realpathSync(directory));
|
|
16
|
+
privateArtifactDirectory(root, create);
|
|
17
|
+
return { root, path: join(root, artifactHash(id) + ".json") };
|
|
18
|
+
}
|
|
19
|
+
export function validateInitiative(v, id) {
|
|
20
|
+
const r = v;
|
|
21
|
+
if (!r ||
|
|
22
|
+
r.version !== 1 ||
|
|
23
|
+
r.initiativeId !== id ||
|
|
24
|
+
!Number.isSafeInteger(r.generation) ||
|
|
25
|
+
r.generation < 1 ||
|
|
26
|
+
!r.owner ||
|
|
27
|
+
typeof r.owner.sessionId !== "string" ||
|
|
28
|
+
!r.owner.sessionId ||
|
|
29
|
+
r.owner.sessionId.length > 512 ||
|
|
30
|
+
typeof r.owner.cwd !== "string" ||
|
|
31
|
+
!r.owner.cwd.startsWith("/") ||
|
|
32
|
+
r.owner.cwd.length > 4096 ||
|
|
33
|
+
!["owned", "released"].includes(r.state) ||
|
|
34
|
+
!Array.isArray(r.tasks) ||
|
|
35
|
+
r.tasks.length > 256)
|
|
36
|
+
throw Error("invalid initiative record");
|
|
37
|
+
const keys = new Set(), operations = new Set();
|
|
38
|
+
let attempts = 0;
|
|
39
|
+
for (const t of r.tasks) {
|
|
40
|
+
const key = JSON.stringify([t.taskId, t.taskRevision]);
|
|
41
|
+
if (!validInitiativeTask(t) ||
|
|
42
|
+
keys.has(key) ||
|
|
43
|
+
!Number.isSafeInteger(t.generation) ||
|
|
44
|
+
t.generation < 1 ||
|
|
45
|
+
t.generation > r.generation ||
|
|
46
|
+
!Array.isArray(t.attempts))
|
|
47
|
+
throw Error("invalid initiative task record");
|
|
48
|
+
keys.add(key);
|
|
49
|
+
for (const a of t.attempts) {
|
|
50
|
+
const key = JSON.stringify([a.owner?.sessionId, a.owner?.cwd, a.operationId]);
|
|
51
|
+
if (++attempts > 1024 ||
|
|
52
|
+
operations.has(key) ||
|
|
53
|
+
!validOperationId(a.operationId) ||
|
|
54
|
+
typeof a.executionId !== "string" ||
|
|
55
|
+
!a.executionId.startsWith("exec:") ||
|
|
56
|
+
a.executionId.length > 128 ||
|
|
57
|
+
typeof a.requestDigest !== "string" ||
|
|
58
|
+
!/^[a-f0-9]{64}$/.test(a.requestDigest) ||
|
|
59
|
+
!a.owner?.sessionId ||
|
|
60
|
+
a.owner.sessionId.length > 512 ||
|
|
61
|
+
typeof a.owner.cwd !== "string" ||
|
|
62
|
+
!a.owner.cwd.startsWith("/") ||
|
|
63
|
+
a.owner.cwd.length > 4096 ||
|
|
64
|
+
!["pending", "not-admitted"].includes(a.state) ||
|
|
65
|
+
(a.effectReceipt !== undefined && !validEffectReceipt(a.effectReceipt)) ||
|
|
66
|
+
(a.effectReceipt?.observation !== undefined &&
|
|
67
|
+
!sameEffectTarget(t.effectTarget, a.effectReceipt.observation.target)))
|
|
68
|
+
throw Error("invalid initiative attempt record");
|
|
69
|
+
operations.add(key);
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
return r;
|
|
73
|
+
}
|
|
74
|
+
export function readInitiativeState(directory, id) {
|
|
75
|
+
try {
|
|
76
|
+
const { path, root } = initiativeLocation(directory, id);
|
|
77
|
+
const record = validateInitiative(JSON.parse(readBoundedTextSync(path, { maxBytes: MAX_BYTES, confinedRoot: root }).text), id);
|
|
78
|
+
return { record, revision: initiativeRevision(record) };
|
|
79
|
+
}
|
|
80
|
+
catch (error) {
|
|
81
|
+
if (error.code === "ENOENT") {
|
|
82
|
+
const root = initiativeStateDir(realpathSync(directory));
|
|
83
|
+
if (existsSync(join(root, artifactHash(id) + ".json.initialized")))
|
|
84
|
+
throw Error("initiative state missing; restore trusted state");
|
|
85
|
+
return null;
|
|
86
|
+
}
|
|
87
|
+
throw error;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
export function saveInitiative(path, root, record) {
|
|
91
|
+
validateInitiative(record, record.initiativeId);
|
|
92
|
+
const text = JSON.stringify(record) + "\n";
|
|
93
|
+
if (Buffer.byteLength(text) > MAX_BYTES)
|
|
94
|
+
throw Error("initiative record exceeds bound");
|
|
95
|
+
privateArtifactDirectory(root);
|
|
96
|
+
const temporary = path + "." + randomUUID();
|
|
97
|
+
const fd = openSync(temporary, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
|
|
98
|
+
try {
|
|
99
|
+
writeFileSync(fd, text);
|
|
100
|
+
fsyncSync(fd);
|
|
101
|
+
}
|
|
102
|
+
finally {
|
|
103
|
+
closeSync(fd);
|
|
104
|
+
}
|
|
105
|
+
try {
|
|
106
|
+
renameSync(temporary, path);
|
|
107
|
+
const parent = openSync(root, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
|
|
108
|
+
try {
|
|
109
|
+
fsyncSync(parent);
|
|
110
|
+
}
|
|
111
|
+
finally {
|
|
112
|
+
closeSync(parent);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
finally {
|
|
116
|
+
try {
|
|
117
|
+
unlinkSync(temporary);
|
|
118
|
+
}
|
|
119
|
+
catch { }
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
//# sourceMappingURL=initiative-state.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"initiative-state.js","sourceRoot":"","sources":["../../src/governance/initiative-state.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { OperationArtifactContent } from "../kernel/operation-artifact.ts";
|
|
2
|
+
export declare const artifactHash: (text: string) => string;
|
|
3
|
+
export declare const artifactJson: (value: unknown) => string;
|
|
4
|
+
export declare function privateArtifactDirectory(path: string, create?: boolean): string;
|
|
5
|
+
export declare function readArtifactBytes(reference: OperationArtifactContent, root: string, maxBytes: number): string;
|
|
6
|
+
/** Publish without overwrite. A losing writer may reuse only byte-identical content. */
|
|
7
|
+
export declare function publishArtifact(path: string, name: string, text: string, reuse?: boolean): OperationArtifactContent;
|
|
8
|
+
//# sourceMappingURL=operation-artifact-io.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"operation-artifact-io.d.ts","sourceRoot":"","sources":["../../src/governance/operation-artifact-io.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,WAA4D,CAAC;AACtG,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,WAAiC,CAAC;AAC7E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,CAsB7E;AACD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,wBAAwB,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc7G;AACD,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,UAAO,GAAG,wBAAwB,CA2ChH"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
/** Small private, immutable files. Cooperative local integrity, not a hostile same-uid boundary. */
|
|
2
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
3
|
+
import { constants, openSync, closeSync, fstatSync, fsyncSync, mkdirSync, realpathSync, writeFileSync, linkSync, unlinkSync, lstatSync, } from "node:fs";
|
|
4
|
+
import { join, dirname } from "node:path";
|
|
5
|
+
import { readBoundedTextSync } from "../kernel/bounded-read-sync.js";
|
|
6
|
+
export const artifactHash = (text) => createHash("sha256").update(text, "utf8").digest("hex");
|
|
7
|
+
export const artifactJson = (value) => JSON.stringify(value) + "\n";
|
|
8
|
+
export function privateArtifactDirectory(path, create = false) {
|
|
9
|
+
if (create) {
|
|
10
|
+
const first = mkdirSync(path, { recursive: true, mode: 0o700 });
|
|
11
|
+
if (first) {
|
|
12
|
+
let parent = dirname(path);
|
|
13
|
+
while (true) {
|
|
14
|
+
const fd = openSync(parent, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
|
|
15
|
+
try {
|
|
16
|
+
fsyncSync(fd);
|
|
17
|
+
}
|
|
18
|
+
finally {
|
|
19
|
+
closeSync(fd);
|
|
20
|
+
}
|
|
21
|
+
if (parent === dirname(first))
|
|
22
|
+
break;
|
|
23
|
+
parent = dirname(parent);
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
if (realpathSync(path) !== path)
|
|
28
|
+
throw Error("operation artifact directory must be canonical without symlinks");
|
|
29
|
+
const info = lstatSync(path);
|
|
30
|
+
if (!info.isDirectory() || info.uid !== process.getuid?.() || info.mode & 0o077)
|
|
31
|
+
throw Error("operation artifact directory must be private and owned by this uid");
|
|
32
|
+
return path;
|
|
33
|
+
}
|
|
34
|
+
export function readArtifactBytes(reference, root, maxBytes) {
|
|
35
|
+
if (!reference ||
|
|
36
|
+
typeof reference.path !== "string" ||
|
|
37
|
+
!/^[a-f0-9]{64}$/.test(reference.sha256) ||
|
|
38
|
+
!Number.isSafeInteger(reference.bytes) ||
|
|
39
|
+
reference.bytes < 0 ||
|
|
40
|
+
reference.bytes > maxBytes)
|
|
41
|
+
throw Error("invalid or oversized operation artifact reference");
|
|
42
|
+
const text = readBoundedTextSync(reference.path, { maxBytes, confinedRoot: root }).text;
|
|
43
|
+
if (Buffer.byteLength(text) !== reference.bytes || artifactHash(text) !== reference.sha256)
|
|
44
|
+
throw Error("operation artifact content identity mismatch");
|
|
45
|
+
return text;
|
|
46
|
+
}
|
|
47
|
+
/** Publish without overwrite. A losing writer may reuse only byte-identical content. */
|
|
48
|
+
export function publishArtifact(path, name, text, reuse = true) {
|
|
49
|
+
privateArtifactDirectory(path);
|
|
50
|
+
const fd = openSync(path, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
|
|
51
|
+
const held = `/proc/self/fd/${fd}`;
|
|
52
|
+
const temporary = `${name}.${randomUUID()}.tmp`;
|
|
53
|
+
try {
|
|
54
|
+
const info = fstatSync(fd);
|
|
55
|
+
if (!info.isDirectory() || info.uid !== process.getuid?.() || info.mode & 0o077)
|
|
56
|
+
throw Error("invalid artifact owner");
|
|
57
|
+
const file = openSync(join(held, temporary), constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
|
|
58
|
+
try {
|
|
59
|
+
writeFileSync(file, text);
|
|
60
|
+
fsyncSync(file);
|
|
61
|
+
}
|
|
62
|
+
finally {
|
|
63
|
+
closeSync(file);
|
|
64
|
+
}
|
|
65
|
+
const reference = { path: join(path, name), sha256: artifactHash(text), bytes: Buffer.byteLength(text) };
|
|
66
|
+
try {
|
|
67
|
+
linkSync(join(held, temporary), join(held, name));
|
|
68
|
+
}
|
|
69
|
+
catch (error) {
|
|
70
|
+
if (error.code !== "EEXIST" || !reuse)
|
|
71
|
+
throw error;
|
|
72
|
+
readArtifactBytes(reference, path, reference.bytes);
|
|
73
|
+
}
|
|
74
|
+
fsyncSync(fd);
|
|
75
|
+
const current = lstatSync(path);
|
|
76
|
+
if (realpathSync(path) !== path || current.ino !== info.ino || current.dev !== info.dev)
|
|
77
|
+
throw Error("artifact directory changed before publication");
|
|
78
|
+
return reference;
|
|
79
|
+
}
|
|
80
|
+
finally {
|
|
81
|
+
try {
|
|
82
|
+
try {
|
|
83
|
+
unlinkSync(join(held, temporary));
|
|
84
|
+
}
|
|
85
|
+
catch (error) {
|
|
86
|
+
if (error.code !== "ENOENT")
|
|
87
|
+
throw error;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
finally {
|
|
91
|
+
closeSync(fd);
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
//# sourceMappingURL=operation-artifact-io.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"operation-artifact-io.js","sourceRoot":"","sources":["../../src/governance/operation-artifact-io.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { type OperationArtifactOwner, type OperationArtifactRef } from "../kernel/operation-artifact.ts";
|
|
2
|
+
export declare function operationArtifactInstance(agentDirectory: string): string;
|
|
3
|
+
export declare function openOperationArtifactScan(agentDirectory: string, owner: OperationArtifactOwner): {
|
|
4
|
+
close: () => void;
|
|
5
|
+
next(limit?: number): {
|
|
6
|
+
references: OperationArtifactRef[];
|
|
7
|
+
scanned: number;
|
|
8
|
+
uncertain: number;
|
|
9
|
+
issues: number;
|
|
10
|
+
complete: boolean;
|
|
11
|
+
};
|
|
12
|
+
};
|
|
13
|
+
//# sourceMappingURL=operation-artifact-scan.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"operation-artifact-scan.d.ts","sourceRoot":"","sources":["../../src/governance/operation-artifact-scan.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AAIzC,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAMxE;AACD,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB;;;;;;;;;EAyD9F"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
/** Bounded traversal of one trusted producer owner. No recursive discovery or dispatch. */
|
|
2
|
+
import { opendirSync, realpathSync, statSync } from "node:fs";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
import { operationArtifactsDir } from "../kernel/project-paths.js";
|
|
5
|
+
import { MAX_OPERATION_MANIFEST_BYTES, } from "../kernel/operation-artifact.js";
|
|
6
|
+
import { readBoundedTextSync } from "../kernel/bounded-read-sync.js";
|
|
7
|
+
import { artifactHash, privateArtifactDirectory } from "./operation-artifact-io.js";
|
|
8
|
+
import { openOperationArtifacts } from "./operation-artifacts.js";
|
|
9
|
+
export function operationArtifactInstance(agentDirectory) {
|
|
10
|
+
const canonical = realpathSync(agentDirectory), identity = statSync(canonical, { bigint: true });
|
|
11
|
+
return artifactHash(JSON.stringify([canonical, identity.dev.toString(), identity.ino.toString(), identity.birthtimeNs.toString()]));
|
|
12
|
+
}
|
|
13
|
+
export function openOperationArtifactScan(agentDirectory, owner) {
|
|
14
|
+
const store = openOperationArtifacts(agentDirectory, owner);
|
|
15
|
+
const root = join(operationArtifactsDir(realpathSync(agentDirectory)), artifactHash(JSON.stringify([owner.sessionId, owner.cwd])));
|
|
16
|
+
let directory, complete = false;
|
|
17
|
+
try {
|
|
18
|
+
privateArtifactDirectory(root);
|
|
19
|
+
directory = opendirSync(root, { bufferSize: 64 });
|
|
20
|
+
}
|
|
21
|
+
catch (error) {
|
|
22
|
+
if (error.code !== "ENOENT")
|
|
23
|
+
throw error;
|
|
24
|
+
complete = true;
|
|
25
|
+
}
|
|
26
|
+
const close = () => {
|
|
27
|
+
directory?.closeSync();
|
|
28
|
+
directory = undefined;
|
|
29
|
+
complete = true;
|
|
30
|
+
};
|
|
31
|
+
return {
|
|
32
|
+
close,
|
|
33
|
+
next(limit = 32) {
|
|
34
|
+
if (!Number.isSafeInteger(limit) || limit < 1 || limit > 64)
|
|
35
|
+
throw Error("invalid artifact scan limit");
|
|
36
|
+
const references = [];
|
|
37
|
+
let scanned = 0, uncertain = 0, issues = 0;
|
|
38
|
+
while (!complete && scanned < limit) {
|
|
39
|
+
const entry = directory.readSync();
|
|
40
|
+
if (!entry) {
|
|
41
|
+
close();
|
|
42
|
+
break;
|
|
43
|
+
}
|
|
44
|
+
scanned++;
|
|
45
|
+
try {
|
|
46
|
+
if (!entry.isDirectory() || !/^([a-f0-9]{64})$/.test(entry.name))
|
|
47
|
+
throw Error("invalid entry");
|
|
48
|
+
const path = join(root, entry.name);
|
|
49
|
+
privateArtifactDirectory(path);
|
|
50
|
+
const admission = JSON.parse(readBoundedTextSync(join(path, "admission.json"), {
|
|
51
|
+
maxBytes: MAX_OPERATION_MANIFEST_BYTES,
|
|
52
|
+
confinedRoot: path,
|
|
53
|
+
}).text);
|
|
54
|
+
const id = admission?.request?.operationId;
|
|
55
|
+
if (typeof id !== "string" || artifactHash(id) !== entry.name)
|
|
56
|
+
throw Error("invalid identity");
|
|
57
|
+
const retained = store.history(id, false);
|
|
58
|
+
if (retained?.artifact)
|
|
59
|
+
references.push(retained.artifact);
|
|
60
|
+
else
|
|
61
|
+
uncertain++;
|
|
62
|
+
}
|
|
63
|
+
catch {
|
|
64
|
+
issues++;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
return { references, scanned, uncertain, issues, complete };
|
|
68
|
+
},
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
//# sourceMappingURL=operation-artifact-scan.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"operation-artifact-scan.js","sourceRoot":"","sources":["../../src/governance/operation-artifact-scan.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import { type OperationRequest, type OperationReference } from "../kernel/dispatch-operation.ts";
|
|
2
|
+
import { type OperationArtifactOwner, type OperationArtifactRef, type OperationArtifactManifest, type OperationArtifactOutcome, type RetainedOperationFinal } from "../kernel/operation-artifact.ts";
|
|
3
|
+
export interface ReadOperationArtifactOptions {
|
|
4
|
+
/** Trusted selected agent directory, never inferred from the reference. */
|
|
5
|
+
agentDirectory?: string;
|
|
6
|
+
/** Maximum returned authored bytes. Metadata has its own 64 KiB bound. */
|
|
7
|
+
maxBytes?: number;
|
|
8
|
+
}
|
|
9
|
+
/** Exact immutable read; a successful read is not current applicability or execution authority. */
|
|
10
|
+
export declare function readOperationArtifact(reference: OperationArtifactRef, options?: ReadOperationArtifactOptions): {
|
|
11
|
+
partial?: {
|
|
12
|
+
text: string;
|
|
13
|
+
sha256: string;
|
|
14
|
+
} | undefined;
|
|
15
|
+
final?: RetainedOperationFinal | undefined;
|
|
16
|
+
manifest: OperationArtifactManifest;
|
|
17
|
+
};
|
|
18
|
+
export interface OperationArtifactHistory {
|
|
19
|
+
operation: OperationReference;
|
|
20
|
+
requestDigest: string;
|
|
21
|
+
reason?: string;
|
|
22
|
+
artifact?: OperationArtifactRef;
|
|
23
|
+
final?: RetainedOperationFinal;
|
|
24
|
+
partial?: {
|
|
25
|
+
text: string;
|
|
26
|
+
sha256: string;
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
export declare function openOperationArtifacts(agentDirectory: string, owner: OperationArtifactOwner): {
|
|
30
|
+
owner: Readonly<{
|
|
31
|
+
sessionId: string;
|
|
32
|
+
cwd: string;
|
|
33
|
+
}>;
|
|
34
|
+
history: (operationId: string, includeFinal?: boolean) => OperationArtifactHistory | null;
|
|
35
|
+
admit(request: OperationRequest): {
|
|
36
|
+
operation: OperationReference;
|
|
37
|
+
requestDigest: string;
|
|
38
|
+
reason?: string;
|
|
39
|
+
artifact?: OperationArtifactRef;
|
|
40
|
+
final?: RetainedOperationFinal;
|
|
41
|
+
partial?: {
|
|
42
|
+
text: string;
|
|
43
|
+
sha256: string;
|
|
44
|
+
};
|
|
45
|
+
created: boolean;
|
|
46
|
+
} | {
|
|
47
|
+
created: boolean;
|
|
48
|
+
};
|
|
49
|
+
started(request: OperationRequest, cwd: string, workspaceId: string | null): void;
|
|
50
|
+
finish(request: OperationRequest, outcome: OperationArtifactOutcome): OperationArtifactRef;
|
|
51
|
+
};
|
|
52
|
+
export type OperationArtifactStore = ReturnType<typeof openOperationArtifacts>;
|
|
53
|
+
//# sourceMappingURL=operation-artifacts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"operation-artifacts.d.ts","sourceRoot":"","sources":["../../src/governance/operation-artifacts.ts"],"names":[],"mappings":"AAKA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACnH,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAC;AAkKzC,MAAM,WAAW,4BAA4B;IAC3C,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,GAAE,4BAAiC;;cAkB1F,MAAM;gBAAU,MAAM;;;;EAQ5C;AACD,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AACD,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB;;;;;2BAI5D,MAAM,6BAAwB,wBAAwB,GAAG,IAAI;mBA8C1E,gBAAgB;mBAzDtB,kBAAkB;uBACd,MAAM;iBACZ,MAAM;mBACJ,oBAAoB;gBACvB,sBAAsB;kBACpB;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE;;;;;qBAiFvB,gBAAgB,OAAO,MAAM,eAAe,MAAM,GAAG,IAAI;oBAmB1D,gBAAgB,WAAW,wBAAwB,GAAG,oBAAoB;EA6C7F;AACD,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
|