@devenius/junamis-skills 0.0.0-stage → 1.1.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 +150 -0
- package/LICENSE +21 -0
- package/README.md +231 -2
- package/SECURITY.md +81 -0
- package/bin/junamis-skills.js +7 -0
- package/dist/cli.d.ts +59 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +564 -0
- package/dist/cli.js.map +1 -0
- package/dist/color.d.ts +40 -0
- package/dist/color.d.ts.map +1 -0
- package/dist/color.js +55 -0
- package/dist/color.js.map +1 -0
- package/dist/design/atomic.d.ts +4 -0
- package/dist/design/atomic.d.ts.map +1 -0
- package/dist/design/atomic.js +14 -0
- package/dist/design/atomic.js.map +1 -0
- package/dist/design/bootstrap.d.ts +23 -0
- package/dist/design/bootstrap.d.ts.map +1 -0
- package/dist/design/bootstrap.js +411 -0
- package/dist/design/bootstrap.js.map +1 -0
- package/dist/design/cli.d.ts +86 -0
- package/dist/design/cli.d.ts.map +1 -0
- package/dist/design/cli.js +425 -0
- package/dist/design/cli.js.map +1 -0
- package/dist/design/delta.d.ts +45 -0
- package/dist/design/delta.d.ts.map +1 -0
- package/dist/design/delta.js +557 -0
- package/dist/design/delta.js.map +1 -0
- package/dist/design/drift.d.ts +26 -0
- package/dist/design/drift.d.ts.map +1 -0
- package/dist/design/drift.js +341 -0
- package/dist/design/drift.js.map +1 -0
- package/dist/design/errors.d.ts +25 -0
- package/dist/design/errors.d.ts.map +1 -0
- package/dist/design/errors.js +30 -0
- package/dist/design/errors.js.map +1 -0
- package/dist/design/events.d.ts +18 -0
- package/dist/design/events.d.ts.map +1 -0
- package/dist/design/events.js +44 -0
- package/dist/design/events.js.map +1 -0
- package/dist/design/fingerprint.d.ts +10 -0
- package/dist/design/fingerprint.d.ts.map +1 -0
- package/dist/design/fingerprint.js +66 -0
- package/dist/design/fingerprint.js.map +1 -0
- package/dist/design/index-gen.d.ts +16 -0
- package/dist/design/index-gen.d.ts.map +1 -0
- package/dist/design/index-gen.js +94 -0
- package/dist/design/index-gen.js.map +1 -0
- package/dist/design/schema.d.ts +54 -0
- package/dist/design/schema.d.ts.map +1 -0
- package/dist/design/schema.js +408 -0
- package/dist/design/schema.js.map +1 -0
- package/dist/design/yaml.d.ts +12 -0
- package/dist/design/yaml.d.ts.map +1 -0
- package/dist/design/yaml.js +264 -0
- package/dist/design/yaml.js.map +1 -0
- package/dist/external.d.ts +61 -0
- package/dist/external.d.ts.map +1 -0
- package/dist/external.js +426 -0
- package/dist/external.js.map +1 -0
- package/dist/guide.d.ts +17 -0
- package/dist/guide.d.ts.map +1 -0
- package/dist/guide.js +219 -0
- package/dist/guide.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -0
- package/dist/install-external.d.ts +3 -0
- package/dist/install-external.d.ts.map +1 -0
- package/dist/install-external.js +37 -0
- package/dist/install-external.js.map +1 -0
- package/dist/library-install.d.ts +39 -0
- package/dist/library-install.d.ts.map +1 -0
- package/dist/library-install.js +663 -0
- package/dist/library-install.js.map +1 -0
- package/dist/orchestrator/boot.d.ts +3 -0
- package/dist/orchestrator/boot.d.ts.map +1 -0
- package/dist/orchestrator/boot.js +515 -0
- package/dist/orchestrator/boot.js.map +1 -0
- package/dist/orchestrator/cli.d.ts +37 -0
- package/dist/orchestrator/cli.d.ts.map +1 -0
- package/dist/orchestrator/cli.js +563 -0
- package/dist/orchestrator/cli.js.map +1 -0
- package/dist/orchestrator/commands.d.ts +46 -0
- package/dist/orchestrator/commands.d.ts.map +1 -0
- package/dist/orchestrator/commands.js +752 -0
- package/dist/orchestrator/commands.js.map +1 -0
- package/dist/orchestrator/compaction.d.ts +21 -0
- package/dist/orchestrator/compaction.d.ts.map +1 -0
- package/dist/orchestrator/compaction.js +93 -0
- package/dist/orchestrator/compaction.js.map +1 -0
- package/dist/orchestrator/drift.d.ts +11 -0
- package/dist/orchestrator/drift.d.ts.map +1 -0
- package/dist/orchestrator/drift.js +181 -0
- package/dist/orchestrator/drift.js.map +1 -0
- package/dist/orchestrator/errors.d.ts +52 -0
- package/dist/orchestrator/errors.d.ts.map +1 -0
- package/dist/orchestrator/errors.js +96 -0
- package/dist/orchestrator/errors.js.map +1 -0
- package/dist/orchestrator/frontmatter.d.ts +6 -0
- package/dist/orchestrator/frontmatter.d.ts.map +1 -0
- package/dist/orchestrator/frontmatter.js +50 -0
- package/dist/orchestrator/frontmatter.js.map +1 -0
- package/dist/orchestrator/fsx.d.ts +45 -0
- package/dist/orchestrator/fsx.d.ts.map +1 -0
- package/dist/orchestrator/fsx.js +295 -0
- package/dist/orchestrator/fsx.js.map +1 -0
- package/dist/orchestrator/handoff.d.ts +8 -0
- package/dist/orchestrator/handoff.d.ts.map +1 -0
- package/dist/orchestrator/handoff.js +246 -0
- package/dist/orchestrator/handoff.js.map +1 -0
- package/dist/orchestrator/hash.d.ts +10 -0
- package/dist/orchestrator/hash.d.ts.map +1 -0
- package/dist/orchestrator/hash.js +65 -0
- package/dist/orchestrator/hash.js.map +1 -0
- package/dist/orchestrator/journal.d.ts +35 -0
- package/dist/orchestrator/journal.d.ts.map +1 -0
- package/dist/orchestrator/journal.js +163 -0
- package/dist/orchestrator/journal.js.map +1 -0
- package/dist/orchestrator/lease.d.ts +31 -0
- package/dist/orchestrator/lease.d.ts.map +1 -0
- package/dist/orchestrator/lease.js +175 -0
- package/dist/orchestrator/lease.js.map +1 -0
- package/dist/orchestrator/plan.d.ts +27 -0
- package/dist/orchestrator/plan.d.ts.map +1 -0
- package/dist/orchestrator/plan.js +240 -0
- package/dist/orchestrator/plan.js.map +1 -0
- package/dist/orchestrator/report.d.ts +49 -0
- package/dist/orchestrator/report.d.ts.map +1 -0
- package/dist/orchestrator/report.js +244 -0
- package/dist/orchestrator/report.js.map +1 -0
- package/dist/orchestrator/state.d.ts +43 -0
- package/dist/orchestrator/state.d.ts.map +1 -0
- package/dist/orchestrator/state.js +369 -0
- package/dist/orchestrator/state.js.map +1 -0
- package/dist/orchestrator/store.d.ts +42 -0
- package/dist/orchestrator/store.d.ts.map +1 -0
- package/dist/orchestrator/store.js +202 -0
- package/dist/orchestrator/store.js.map +1 -0
- package/dist/orchestrator/test-hooks.d.ts +5 -0
- package/dist/orchestrator/test-hooks.d.ts.map +1 -0
- package/dist/orchestrator/test-hooks.js +31 -0
- package/dist/orchestrator/test-hooks.js.map +1 -0
- package/dist/orchestrator/time.d.ts +11 -0
- package/dist/orchestrator/time.d.ts.map +1 -0
- package/dist/orchestrator/time.js +38 -0
- package/dist/orchestrator/time.js.map +1 -0
- package/dist/paths.d.ts +9 -0
- package/dist/paths.d.ts.map +1 -0
- package/dist/paths.js +42 -0
- package/dist/paths.js.map +1 -0
- package/dist/pinned-source.d.ts +13 -0
- package/dist/pinned-source.d.ts.map +1 -0
- package/dist/pinned-source.js +238 -0
- package/dist/pinned-source.js.map +1 -0
- package/dist/reconcile/cli.d.ts +17 -0
- package/dist/reconcile/cli.d.ts.map +1 -0
- package/dist/reconcile/cli.js +171 -0
- package/dist/reconcile/cli.js.map +1 -0
- package/dist/reconcile/detectors.d.ts +29 -0
- package/dist/reconcile/detectors.d.ts.map +1 -0
- package/dist/reconcile/detectors.js +294 -0
- package/dist/reconcile/detectors.js.map +1 -0
- package/dist/reconcile/manifest.d.ts +11 -0
- package/dist/reconcile/manifest.d.ts.map +1 -0
- package/dist/reconcile/manifest.js +118 -0
- package/dist/reconcile/manifest.js.map +1 -0
- package/dist/reconcile/queue.d.ts +3 -0
- package/dist/reconcile/queue.d.ts.map +1 -0
- package/dist/reconcile/queue.js +723 -0
- package/dist/reconcile/queue.js.map +1 -0
- package/dist/reconcile/score.d.ts +19 -0
- package/dist/reconcile/score.d.ts.map +1 -0
- package/dist/reconcile/score.js +58 -0
- package/dist/reconcile/score.js.map +1 -0
- package/dist/scripts/check-opencode-config.d.ts +12 -0
- package/dist/scripts/check-opencode-config.d.ts.map +1 -0
- package/dist/scripts/check-opencode-config.js +216 -0
- package/dist/scripts/check-opencode-config.js.map +1 -0
- package/dist/scripts/check-pack.d.ts +3 -0
- package/dist/scripts/check-pack.d.ts.map +1 -0
- package/dist/scripts/check-pack.js +74 -0
- package/dist/scripts/check-pack.js.map +1 -0
- package/dist/scripts/check-pins.d.ts +9 -0
- package/dist/scripts/check-pins.d.ts.map +1 -0
- package/dist/scripts/check-pins.js +65 -0
- package/dist/scripts/check-pins.js.map +1 -0
- package/dist/scripts/check-security.d.ts +3 -0
- package/dist/scripts/check-security.d.ts.map +1 -0
- package/dist/scripts/check-security.js +47 -0
- package/dist/scripts/check-security.js.map +1 -0
- package/dist/scripts/check-skills-lock.d.ts +7 -0
- package/dist/scripts/check-skills-lock.d.ts.map +1 -0
- package/dist/scripts/check-skills-lock.js +36 -0
- package/dist/scripts/check-skills-lock.js.map +1 -0
- package/dist/scripts/check-skills-sync.d.ts +7 -0
- package/dist/scripts/check-skills-sync.d.ts.map +1 -0
- package/dist/scripts/check-skills-sync.js +146 -0
- package/dist/scripts/check-skills-sync.js.map +1 -0
- package/dist/scripts/check-yaml.d.ts +3 -0
- package/dist/scripts/check-yaml.d.ts.map +1 -0
- package/dist/scripts/check-yaml.js +41 -0
- package/dist/scripts/check-yaml.js.map +1 -0
- package/dist/scripts/publish-npm.d.ts +3 -0
- package/dist/scripts/publish-npm.d.ts.map +1 -0
- package/dist/scripts/publish-npm.js +67 -0
- package/dist/scripts/publish-npm.js.map +1 -0
- package/dist/scripts/release-check.d.ts +3 -0
- package/dist/scripts/release-check.d.ts.map +1 -0
- package/dist/scripts/release-check.js +97 -0
- package/dist/scripts/release-check.js.map +1 -0
- package/dist/scripts/support.d.ts +41 -0
- package/dist/scripts/support.d.ts.map +1 -0
- package/dist/scripts/support.js +78 -0
- package/dist/scripts/support.js.map +1 -0
- package/dist/targets/claude.d.ts +4 -0
- package/dist/targets/claude.d.ts.map +1 -0
- package/dist/targets/claude.js +42 -0
- package/dist/targets/claude.js.map +1 -0
- package/dist/targets/cline.d.ts +4 -0
- package/dist/targets/cline.d.ts.map +1 -0
- package/dist/targets/cline.js +39 -0
- package/dist/targets/cline.js.map +1 -0
- package/dist/targets/cursor.d.ts +4 -0
- package/dist/targets/cursor.d.ts.map +1 -0
- package/dist/targets/cursor.js +40 -0
- package/dist/targets/cursor.js.map +1 -0
- package/dist/targets/index.d.ts +4 -0
- package/dist/targets/index.d.ts.map +1 -0
- package/dist/targets/index.js +11 -0
- package/dist/targets/index.js.map +1 -0
- package/dist/targets/opencode.d.ts +4 -0
- package/dist/targets/opencode.d.ts.map +1 -0
- package/dist/targets/opencode.js +48 -0
- package/dist/targets/opencode.js.map +1 -0
- package/dist/targets/windsurf.d.ts +4 -0
- package/dist/targets/windsurf.d.ts.map +1 -0
- package/dist/targets/windsurf.js +41 -0
- package/dist/targets/windsurf.js.map +1 -0
- package/dist/types/common.d.ts +193 -0
- package/dist/types/common.d.ts.map +1 -0
- package/dist/types/common.js +6 -0
- package/dist/types/common.js.map +1 -0
- package/dist/types/design.d.ts +185 -0
- package/dist/types/design.d.ts.map +1 -0
- package/dist/types/design.js +3 -0
- package/dist/types/design.js.map +1 -0
- package/dist/types/guards.d.ts +13 -0
- package/dist/types/guards.d.ts.map +1 -0
- package/dist/types/guards.js +64 -0
- package/dist/types/guards.js.map +1 -0
- package/dist/types/handoff.d.ts +29 -0
- package/dist/types/handoff.d.ts.map +1 -0
- package/dist/types/handoff.js +3 -0
- package/dist/types/handoff.js.map +1 -0
- package/dist/types/index.d.ts +7 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +11 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/orchestrator.d.ts +414 -0
- package/dist/types/orchestrator.d.ts.map +1 -0
- package/dist/types/orchestrator.js +4 -0
- package/dist/types/orchestrator.js.map +1 -0
- package/dist/types/reconcile.d.ts +160 -0
- package/dist/types/reconcile.d.ts.map +1 -0
- package/dist/types/reconcile.js +3 -0
- package/dist/types/reconcile.js.map +1 -0
- package/docs/RECONCILE.md +505 -0
- package/docs/design/_schema.md +506 -0
- package/junamis-skills.yml +328 -0
- package/library/EXTERNAL.md +35 -0
- package/library/HANDOFF.md +93 -0
- package/library/RESUME.md +429 -0
- package/library/SAFETY.md +83 -0
- package/library/agents/context-keeper.md +41 -0
- package/library/agents/frontend.md +43 -0
- package/library/agents/maintainer.md +44 -0
- package/library/agents/nestjs.md +40 -0
- package/library/agents/nextjs.md +40 -0
- package/library/agents/operator.md +42 -0
- package/library/agents/orchestrator.md +313 -0
- package/library/agents/researcher.md +40 -0
- package/library/agents/reviewer.md +40 -0
- package/library/skills/db-migrate/SKILL.md +50 -0
- package/library/skills/decision-record/SKILL.md +74 -0
- package/library/skills/dependency-upgrade/SKILL.md +57 -0
- package/library/skills/deploy-verify/SKILL.md +51 -0
- package/library/skills/document/SKILL.md +51 -0
- package/library/skills/env-doctor/SKILL.md +65 -0
- package/library/skills/frontend/SKILL.md +63 -0
- package/library/skills/handoff/SKILL.md +79 -0
- package/library/skills/incident-response/SKILL.md +69 -0
- package/library/skills/nestjs/SKILL.md +49 -0
- package/library/skills/nextjs/SKILL.md +48 -0
- package/library/skills/perf-budget/SKILL.md +62 -0
- package/library/skills/refactor-safely/SKILL.md +48 -0
- package/library/skills/release-prep/SKILL.md +75 -0
- package/library/skills/research/SKILL.md +66 -0
- package/library/skills/rollback/SKILL.md +49 -0
- package/library/skills/route/SKILL.md +107 -0
- package/library/skills/route-external/SKILL.md +67 -0
- package/library/skills/security-audit/SKILL.md +64 -0
- package/library/skills/skill-author/SKILL.md +49 -0
- package/opencode.json +5906 -0
- package/package.json +88 -4
- package/scripts/design-registry.mjs +7 -0
- package/scripts/orchestrator-state.mjs +7 -0
- package/scripts/reconcile.mjs +7 -0
- package/skills-lock.json +197 -0
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { Dirent, Stats } from "node:fs";
|
|
2
|
+
export declare const FILE_MODE = 384;
|
|
3
|
+
export declare const DIR_MODE = 448;
|
|
4
|
+
export declare function expandHome(path: string | undefined): string | undefined;
|
|
5
|
+
export declare function exists(path: string): Promise<boolean>;
|
|
6
|
+
export declare function statSafe(path: string): Promise<Stats | null>;
|
|
7
|
+
export declare function ensureDir(path: string): Promise<void>;
|
|
8
|
+
export declare function ensureTree(root: string, { taskIds }?: {
|
|
9
|
+
taskIds?: readonly string[];
|
|
10
|
+
}): Promise<void>;
|
|
11
|
+
export declare function ensureTaskTree(root: string, taskId: string): Promise<void>;
|
|
12
|
+
export interface WriteOptions {
|
|
13
|
+
readonly mode?: number;
|
|
14
|
+
}
|
|
15
|
+
export declare function atomicWriteFile(path: string, data: string | Buffer, { mode }?: WriteOptions): Promise<void>;
|
|
16
|
+
export declare function writeIfMissing(path: string, data: string | Buffer, options?: WriteOptions): Promise<boolean>;
|
|
17
|
+
export declare function appendLine(path: string, line: string): Promise<void>;
|
|
18
|
+
export declare function readText(path: string): Promise<string | null>;
|
|
19
|
+
export declare function readBuffer(path: string): Promise<Buffer | null>;
|
|
20
|
+
/** A JSON read that never throws: `exists`, `value`, `raw`, and `error`. */
|
|
21
|
+
export interface JsonFileRead {
|
|
22
|
+
readonly exists: boolean;
|
|
23
|
+
readonly value: unknown;
|
|
24
|
+
readonly raw: string | null;
|
|
25
|
+
readonly error: {
|
|
26
|
+
readonly message: string;
|
|
27
|
+
} | null;
|
|
28
|
+
}
|
|
29
|
+
export declare function readJsonFile(path: string): Promise<JsonFileRead>;
|
|
30
|
+
export declare function readJson(path: string): Promise<unknown>;
|
|
31
|
+
export declare function removeFile(path: string): Promise<boolean>;
|
|
32
|
+
export declare function listDir(path: string): Promise<Dirent[]>;
|
|
33
|
+
export declare function listFiles(path: string, suffix?: string | null): Promise<string[]>;
|
|
34
|
+
export declare function realpathDeep(path: string): Promise<string>;
|
|
35
|
+
export declare function isInside(parent: string, child: string): boolean;
|
|
36
|
+
export declare function assertPathInside(root: string, path: string, { label }?: {
|
|
37
|
+
label?: string;
|
|
38
|
+
}): Promise<string>;
|
|
39
|
+
export declare function assertStateRootSafe(root: string, { allowTmp }?: {
|
|
40
|
+
allowTmp?: boolean;
|
|
41
|
+
}): Promise<string>;
|
|
42
|
+
export declare function toPosixPath(path: string): string;
|
|
43
|
+
export declare function relativePosix(root: string, path: string): string;
|
|
44
|
+
export declare function directorySize(path: string): Promise<number>;
|
|
45
|
+
//# sourceMappingURL=fsx.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fsx.d.ts","sourceRoot":"","sources":["../../src/orchestrator/fsx.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,295 @@
|
|
|
1
|
+
// Filesystem primitives for the state engine.
|
|
2
|
+
//
|
|
3
|
+
// Every snapshot write is: temp file in the same directory, fsync the file,
|
|
4
|
+
// rename over the target, fsync the parent directory. Journal appends are one
|
|
5
|
+
// complete line through an append-only handle, fsynced before returning.
|
|
6
|
+
import { promises as fsp } from "node:fs";
|
|
7
|
+
import { homedir, tmpdir } from "node:os";
|
|
8
|
+
import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
9
|
+
import { randomBytes } from "node:crypto";
|
|
10
|
+
import { CorruptStateError, IoError } from "./errors.js";
|
|
11
|
+
export const FILE_MODE = 0o600;
|
|
12
|
+
export const DIR_MODE = 0o700;
|
|
13
|
+
const DIRECTORY_FSYNC_CODES = new Set(["EPERM", "EINVAL"]);
|
|
14
|
+
function errorCode(error) {
|
|
15
|
+
if (typeof error !== "object" || error === null)
|
|
16
|
+
return undefined;
|
|
17
|
+
const code = error.code;
|
|
18
|
+
return typeof code === "string" ? code : undefined;
|
|
19
|
+
}
|
|
20
|
+
function errorMessageOf(error) {
|
|
21
|
+
if (error instanceof Error)
|
|
22
|
+
return error.message;
|
|
23
|
+
return String(error);
|
|
24
|
+
}
|
|
25
|
+
function randomSuffix() {
|
|
26
|
+
return `${process.pid}-${randomBytes(6).toString("hex")}`;
|
|
27
|
+
}
|
|
28
|
+
export function expandHome(path) {
|
|
29
|
+
if (typeof path !== "string" || path.length === 0)
|
|
30
|
+
return path;
|
|
31
|
+
if (path === "~")
|
|
32
|
+
return homedir();
|
|
33
|
+
if (path.startsWith("~/") || path.startsWith("~\\"))
|
|
34
|
+
return join(homedir(), path.slice(2));
|
|
35
|
+
return path;
|
|
36
|
+
}
|
|
37
|
+
export async function exists(path) {
|
|
38
|
+
try {
|
|
39
|
+
await fsp.access(path);
|
|
40
|
+
return true;
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
return false;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
export async function statSafe(path) {
|
|
47
|
+
try {
|
|
48
|
+
return await fsp.stat(path);
|
|
49
|
+
}
|
|
50
|
+
catch {
|
|
51
|
+
return null;
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
export async function ensureDir(path) {
|
|
55
|
+
await fsp.mkdir(path, { recursive: true, mode: DIR_MODE });
|
|
56
|
+
try {
|
|
57
|
+
await fsp.chmod(path, DIR_MODE);
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
// A platform that ignores modes is not a failure.
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
export async function ensureTree(root, { taskIds = [] } = {}) {
|
|
64
|
+
await ensureDir(root);
|
|
65
|
+
for (const name of ["checkpoints", "tasks", "locks"]) {
|
|
66
|
+
await ensureDir(join(root, name));
|
|
67
|
+
}
|
|
68
|
+
for (const taskId of taskIds) {
|
|
69
|
+
await ensureDir(join(root, "tasks", taskId));
|
|
70
|
+
await ensureDir(join(root, "tasks", taskId, "handoffs"));
|
|
71
|
+
await ensureDir(join(root, "tasks", taskId, "artifacts"));
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
export async function ensureTaskTree(root, taskId) {
|
|
75
|
+
await ensureDir(join(root, "tasks", taskId));
|
|
76
|
+
await ensureDir(join(root, "tasks", taskId, "handoffs"));
|
|
77
|
+
await ensureDir(join(root, "tasks", taskId, "artifacts"));
|
|
78
|
+
}
|
|
79
|
+
async function fsyncDir(dir) {
|
|
80
|
+
let handle;
|
|
81
|
+
try {
|
|
82
|
+
handle = await fsp.open(dir, "r");
|
|
83
|
+
}
|
|
84
|
+
catch (error) {
|
|
85
|
+
const code = errorCode(error);
|
|
86
|
+
if (code !== undefined && DIRECTORY_FSYNC_CODES.has(code))
|
|
87
|
+
return;
|
|
88
|
+
throw error;
|
|
89
|
+
}
|
|
90
|
+
try {
|
|
91
|
+
await handle.sync();
|
|
92
|
+
}
|
|
93
|
+
catch (error) {
|
|
94
|
+
const code = errorCode(error);
|
|
95
|
+
if (code === undefined || !DIRECTORY_FSYNC_CODES.has(code))
|
|
96
|
+
throw error;
|
|
97
|
+
}
|
|
98
|
+
finally {
|
|
99
|
+
await handle.close();
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
export async function atomicWriteFile(path, data, { mode = FILE_MODE } = {}) {
|
|
103
|
+
const dir = dirname(path);
|
|
104
|
+
await fsp.mkdir(dir, { recursive: true, mode: DIR_MODE });
|
|
105
|
+
const temp = join(dir, `.${basename(path)}.tmp-${randomSuffix()}`);
|
|
106
|
+
const buffer = Buffer.isBuffer(data) ? data : Buffer.from(String(data), "utf8");
|
|
107
|
+
let handle = null;
|
|
108
|
+
try {
|
|
109
|
+
handle = await fsp.open(temp, "wx", mode);
|
|
110
|
+
await handle.writeFile(buffer);
|
|
111
|
+
await handle.sync();
|
|
112
|
+
await handle.close();
|
|
113
|
+
handle = null;
|
|
114
|
+
await fsp.rename(temp, path);
|
|
115
|
+
try {
|
|
116
|
+
await fsp.chmod(path, mode);
|
|
117
|
+
}
|
|
118
|
+
catch {
|
|
119
|
+
// A platform that ignores modes is not a failure.
|
|
120
|
+
}
|
|
121
|
+
await fsyncDir(dir);
|
|
122
|
+
}
|
|
123
|
+
catch (error) {
|
|
124
|
+
if (handle) {
|
|
125
|
+
try {
|
|
126
|
+
await handle.close();
|
|
127
|
+
}
|
|
128
|
+
catch {
|
|
129
|
+
// best effort
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
try {
|
|
133
|
+
await fsp.unlink(temp);
|
|
134
|
+
}
|
|
135
|
+
catch {
|
|
136
|
+
// best effort
|
|
137
|
+
}
|
|
138
|
+
throw error;
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
export async function writeIfMissing(path, data, options = {}) {
|
|
142
|
+
if (await exists(path))
|
|
143
|
+
return false;
|
|
144
|
+
await atomicWriteFile(path, data, options);
|
|
145
|
+
return true;
|
|
146
|
+
}
|
|
147
|
+
export async function appendLine(path, line) {
|
|
148
|
+
const text = String(line);
|
|
149
|
+
const complete = text.endsWith("\n") ? text : `${text}\n`;
|
|
150
|
+
let handle = null;
|
|
151
|
+
try {
|
|
152
|
+
handle = await fsp.open(path, "a", FILE_MODE);
|
|
153
|
+
await handle.writeFile(complete, "utf8");
|
|
154
|
+
await handle.sync();
|
|
155
|
+
}
|
|
156
|
+
finally {
|
|
157
|
+
if (handle)
|
|
158
|
+
await handle.close();
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
export async function readText(path) {
|
|
162
|
+
try {
|
|
163
|
+
return await fsp.readFile(path, "utf8");
|
|
164
|
+
}
|
|
165
|
+
catch (error) {
|
|
166
|
+
if (errorCode(error) === "ENOENT")
|
|
167
|
+
return null;
|
|
168
|
+
throw error;
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
export async function readBuffer(path) {
|
|
172
|
+
try {
|
|
173
|
+
return await fsp.readFile(path);
|
|
174
|
+
}
|
|
175
|
+
catch (error) {
|
|
176
|
+
if (errorCode(error) === "ENOENT")
|
|
177
|
+
return null;
|
|
178
|
+
throw error;
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
export async function readJsonFile(path) {
|
|
182
|
+
const raw = await readText(path);
|
|
183
|
+
if (raw === null)
|
|
184
|
+
return { exists: false, value: null, raw: null, error: null };
|
|
185
|
+
try {
|
|
186
|
+
return { exists: true, value: JSON.parse(raw), raw, error: null };
|
|
187
|
+
}
|
|
188
|
+
catch (error) {
|
|
189
|
+
return { exists: true, value: null, raw, error: { message: errorMessageOf(error) } };
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
export async function readJson(path) {
|
|
193
|
+
const result = await readJsonFile(path);
|
|
194
|
+
if (!result.exists)
|
|
195
|
+
return null;
|
|
196
|
+
if (result.error)
|
|
197
|
+
throw new CorruptStateError(`invalid JSON in ${path}`, { detail: result.error.message });
|
|
198
|
+
return result.value;
|
|
199
|
+
}
|
|
200
|
+
export async function removeFile(path) {
|
|
201
|
+
try {
|
|
202
|
+
await fsp.unlink(path);
|
|
203
|
+
return true;
|
|
204
|
+
}
|
|
205
|
+
catch (error) {
|
|
206
|
+
if (errorCode(error) === "ENOENT")
|
|
207
|
+
return false;
|
|
208
|
+
throw error;
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
export async function listDir(path) {
|
|
212
|
+
try {
|
|
213
|
+
return await fsp.readdir(path, { withFileTypes: true });
|
|
214
|
+
}
|
|
215
|
+
catch (error) {
|
|
216
|
+
if (errorCode(error) === "ENOENT")
|
|
217
|
+
return [];
|
|
218
|
+
throw error;
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
export async function listFiles(path, suffix = null) {
|
|
222
|
+
const entries = await listDir(path);
|
|
223
|
+
const out = [];
|
|
224
|
+
for (const entry of entries) {
|
|
225
|
+
if (!entry.isFile())
|
|
226
|
+
continue;
|
|
227
|
+
if (suffix && !entry.name.endsWith(suffix))
|
|
228
|
+
continue;
|
|
229
|
+
out.push(join(path, entry.name));
|
|
230
|
+
}
|
|
231
|
+
out.sort();
|
|
232
|
+
return out;
|
|
233
|
+
}
|
|
234
|
+
// Resolve a path to a real location without requiring the leaf to exist.
|
|
235
|
+
// The deepest existing ancestor is realpathed, then the missing tail is
|
|
236
|
+
// appended. This makes the temp-directory guard resistant to symlinks.
|
|
237
|
+
export async function realpathDeep(path) {
|
|
238
|
+
let current = resolve(path);
|
|
239
|
+
const tail = [];
|
|
240
|
+
for (;;) {
|
|
241
|
+
try {
|
|
242
|
+
const real = await fsp.realpath(current);
|
|
243
|
+
return tail.length === 0 ? real : join(real, ...tail.reverse());
|
|
244
|
+
}
|
|
245
|
+
catch (error) {
|
|
246
|
+
if (errorCode(error) !== "ENOENT")
|
|
247
|
+
throw error;
|
|
248
|
+
const parent = dirname(current);
|
|
249
|
+
if (parent === current)
|
|
250
|
+
return resolve(path);
|
|
251
|
+
tail.push(basename(current));
|
|
252
|
+
current = parent;
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
export function isInside(parent, child) {
|
|
257
|
+
const rel = relative(parent, child);
|
|
258
|
+
return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
|
|
259
|
+
}
|
|
260
|
+
export async function assertPathInside(root, path, { label = "path" } = {}) {
|
|
261
|
+
const realRoot = await realpathDeep(root);
|
|
262
|
+
const realPath = await realpathDeep(path);
|
|
263
|
+
if (!isInside(realRoot, realPath)) {
|
|
264
|
+
throw new IoError(`${label} escapes ${root}`, { detail: { path, root } });
|
|
265
|
+
}
|
|
266
|
+
return realPath;
|
|
267
|
+
}
|
|
268
|
+
export async function assertStateRootSafe(root, { allowTmp = false } = {}) {
|
|
269
|
+
const resolved = resolve(root);
|
|
270
|
+
const real = await realpathDeep(resolved);
|
|
271
|
+
const fsRoot = resolve("/");
|
|
272
|
+
const realTmp = await realpathDeep(tmpdir());
|
|
273
|
+
if (resolved === fsRoot || real === fsRoot) {
|
|
274
|
+
throw new IoError("state root cannot be the filesystem root", { detail: { root: resolved } });
|
|
275
|
+
}
|
|
276
|
+
if (isInside(realTmp, real)) {
|
|
277
|
+
if (!allowTmp) {
|
|
278
|
+
throw new IoError("state root cannot be inside the operating system temp directory", {
|
|
279
|
+
detail: { root: resolved, temp: realTmp },
|
|
280
|
+
});
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
return resolved;
|
|
284
|
+
}
|
|
285
|
+
export function toPosixPath(path) {
|
|
286
|
+
return path.split(sep).join("/");
|
|
287
|
+
}
|
|
288
|
+
export function relativePosix(root, path) {
|
|
289
|
+
return toPosixPath(relative(root, path));
|
|
290
|
+
}
|
|
291
|
+
export async function directorySize(path) {
|
|
292
|
+
const stat = await statSafe(path);
|
|
293
|
+
return stat ? stat.size : 0;
|
|
294
|
+
}
|
|
295
|
+
//# sourceMappingURL=fsx.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fsx.js","sourceRoot":"","sources":["../../src/orchestrator/fsx.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,yEAAyE;AAEzE,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAG1C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC;AAC/B,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC;AAE9B,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE3D,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAwB;IACjD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3F,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,GAAoC,EAAE;IACnG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QACrD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QACzD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,MAAc;IAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACzD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAW;IACjC,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,KAAK,CAAC;IAC1E,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAAqB,EACrB,EAAE,IAAI,GAAG,SAAS,EAAE,GAAiB,EAAE;IAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,YAAY,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAChF,IAAI,MAAM,GAAsB,IAAI,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,IAAI,CAAC;QACd,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;QACD,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAAqB,EACrB,OAAO,GAAiB,EAAE;IAE1B,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY;IACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;IAC1D,IAAI,MAAM,GAAsB,IAAI,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAC9C,MAAM,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,IAAI,MAAM;YAAE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAChF,IAAI,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IACvF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,MAAM,CAAC,KAAK;QAAE,MAAM,IAAI,iBAAiB,CAAC,mBAAmB,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3G,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAChD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAC7C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,MAAM,GAAkB,IAAI;IACxE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAC9B,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS;QACrD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,OAAO,GAAG,CAAC;AACb,CAAC;AAED,yEAAyE;AACzE,wEAAwE;AACxE,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,MAAM,KAAK,OAAO;gBAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7B,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,KAAa;IACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,IAAY,EACZ,EAAE,KAAK,GAAG,MAAM,EAAE,GAAuB,EAAE;IAE3C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,OAAO,CAAC,GAAG,KAAK,YAAY,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,EAAE,QAAQ,GAAG,KAAK,EAAE,GAA2B,EAAE;IAEjD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3C,MAAM,IAAI,OAAO,CAAC,0CAA0C,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,OAAO,CAAC,iEAAiE,EAAE;gBACnF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;aAC1C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY;IACtD,OAAO,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { ArtifactCheck, Handoff } from "../types/handoff.js";
|
|
2
|
+
export declare function parseHandoff(text: string): Handoff;
|
|
3
|
+
export declare function checkHandoffArtifacts(handoff: Handoff, { projectRoot }: {
|
|
4
|
+
readonly projectRoot: string;
|
|
5
|
+
}): Promise<ArtifactCheck>;
|
|
6
|
+
export declare function normalizeHandoffPath(projectRelative: string): string;
|
|
7
|
+
export declare function handoffPath(base: string, relative: string): string;
|
|
8
|
+
//# sourceMappingURL=handoff.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/orchestrator/handoff.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAY,aAAa,EAAW,OAAO,EAAiB,MAAM,qBAAqB,CAAC;AA0FpG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmGlD;AASD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,EAAE,WAAW,EAAE,EAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,aAAa,CAAC,CAkBxB;AAED,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElE"}
|
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
// Strict HANDOFF block parser and artifact check.
|
|
2
|
+
//
|
|
3
|
+
// The documented block is a constrained subset: scalars, two lists of objects,
|
|
4
|
+
// and one list of questions. Anchors, aliases, flow collections, and multiple
|
|
5
|
+
// documents are rejected so a malformed handoff fails closed.
|
|
6
|
+
import { isAbsolute, join, resolve, sep } from "node:path";
|
|
7
|
+
import { exists, isInside, realpathDeep } from "./fsx.js";
|
|
8
|
+
import { HandoffError } from "./errors.js";
|
|
9
|
+
import { isRecord } from "../types/guards.js";
|
|
10
|
+
const TOP_KEYS = new Set(["agent", "job", "status", "artifacts", "findings", "decisions_owed", "next"]);
|
|
11
|
+
const HANDOFF_STATUSES = new Set(["complete", "blocked", "needs-decision", "failed"]);
|
|
12
|
+
const ARTIFACT_KINDS = new Set(["created", "updated", "read-only"]);
|
|
13
|
+
const SEVERITIES = new Set(["critical", "high", "medium", "low"]);
|
|
14
|
+
function fail(message) {
|
|
15
|
+
throw new HandoffError(message);
|
|
16
|
+
}
|
|
17
|
+
function extractBlock(text) {
|
|
18
|
+
if (typeof text !== "string")
|
|
19
|
+
fail("handoff is not text");
|
|
20
|
+
const cleaned = text.replace(/^\uFEFF/, "");
|
|
21
|
+
const fenced = /```ya?ml[ \t]*\r?\n([\s\S]*?)\r?\n```/i.exec(cleaned);
|
|
22
|
+
if (fenced)
|
|
23
|
+
return fenced[1] ?? "";
|
|
24
|
+
const lines = cleaned.split(/\r?\n/);
|
|
25
|
+
const nonEmpty = lines.findIndex((line) => line.trim().length > 0);
|
|
26
|
+
if (nonEmpty === -1)
|
|
27
|
+
fail("handoff is empty");
|
|
28
|
+
if ((lines[nonEmpty] ?? "").trim() === "---") {
|
|
29
|
+
const end = lines.findLastIndex((line) => line.trim() === "---");
|
|
30
|
+
if (end <= nonEmpty)
|
|
31
|
+
fail("handoff document has no closing ---");
|
|
32
|
+
return lines.slice(nonEmpty + 1, end).join("\n");
|
|
33
|
+
}
|
|
34
|
+
return cleaned;
|
|
35
|
+
}
|
|
36
|
+
function parseScalar(raw, field) {
|
|
37
|
+
let value = raw.trim();
|
|
38
|
+
if (value.length === 0)
|
|
39
|
+
return "";
|
|
40
|
+
if (value === "[]")
|
|
41
|
+
return [];
|
|
42
|
+
if (value === "{}")
|
|
43
|
+
return {};
|
|
44
|
+
if ((value.startsWith('"') && value.endsWith('"')) ||
|
|
45
|
+
(value.startsWith("'") && value.endsWith("'"))) {
|
|
46
|
+
return value.slice(1, -1);
|
|
47
|
+
}
|
|
48
|
+
if (value.startsWith("[") || value.startsWith("{") || value.startsWith("&") || value.startsWith("*") || value.startsWith("!")) {
|
|
49
|
+
fail(`${field} uses an unsupported YAML construct`);
|
|
50
|
+
}
|
|
51
|
+
if (value === "true")
|
|
52
|
+
return true;
|
|
53
|
+
if (value === "false")
|
|
54
|
+
return false;
|
|
55
|
+
if (value === "null" || value === "~")
|
|
56
|
+
return null;
|
|
57
|
+
return value;
|
|
58
|
+
}
|
|
59
|
+
function parseKeyValue(trimmed, allowed, field) {
|
|
60
|
+
const match = /^([A-Za-z0-9_-]+):(.*)$/.exec(trimmed);
|
|
61
|
+
if (!match)
|
|
62
|
+
fail(`${field} is not a key: value line`);
|
|
63
|
+
const key = match[1] ?? "";
|
|
64
|
+
if (allowed && !allowed.has(key))
|
|
65
|
+
fail(`${field} has an unknown key ${key}`);
|
|
66
|
+
let rest = (match[2] ?? "").trim();
|
|
67
|
+
if (rest.startsWith("#"))
|
|
68
|
+
rest = "";
|
|
69
|
+
const hasValue = rest.length > 0;
|
|
70
|
+
return { key, value: hasValue ? parseScalar(rest, `${field}.${key}`) : undefined, hasValue };
|
|
71
|
+
}
|
|
72
|
+
/** The validated artifacts, still carrying any extra item keys. */
|
|
73
|
+
function artifactsOf(value) {
|
|
74
|
+
for (const artifact of value) {
|
|
75
|
+
if (!isRecord(artifact))
|
|
76
|
+
fail("artifact item must be a mapping");
|
|
77
|
+
if (typeof artifact["path"] !== "string" || artifact["path"].length === 0)
|
|
78
|
+
fail("artifact.path must be a string");
|
|
79
|
+
if (!ARTIFACT_KINDS.has(String(artifact["kind"]))) {
|
|
80
|
+
fail(`artifact.kind ${JSON.stringify(artifact["kind"])} is not valid`);
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
return value;
|
|
84
|
+
}
|
|
85
|
+
function findingsOf(value) {
|
|
86
|
+
for (const finding of value) {
|
|
87
|
+
if (!isRecord(finding))
|
|
88
|
+
fail("finding item must be a mapping");
|
|
89
|
+
if (typeof finding["id"] !== "string" || finding["id"].length === 0)
|
|
90
|
+
fail("finding.id must be a string");
|
|
91
|
+
if (!SEVERITIES.has(String(finding["severity"]))) {
|
|
92
|
+
fail(`finding.severity ${JSON.stringify(finding["severity"])} is not valid`);
|
|
93
|
+
}
|
|
94
|
+
if (typeof finding["summary"] !== "string")
|
|
95
|
+
fail("finding.summary must be a string");
|
|
96
|
+
if (typeof finding["evidence"] !== "string")
|
|
97
|
+
fail("finding.evidence must be a string");
|
|
98
|
+
}
|
|
99
|
+
return value;
|
|
100
|
+
}
|
|
101
|
+
export function parseHandoff(text) {
|
|
102
|
+
const block = extractBlock(text);
|
|
103
|
+
const lines = block.split(/\r?\n/);
|
|
104
|
+
const top = {};
|
|
105
|
+
let currentKey = null;
|
|
106
|
+
let currentItem = null;
|
|
107
|
+
for (const rawLine of lines) {
|
|
108
|
+
if (rawLine.includes("\t"))
|
|
109
|
+
fail("handoff contains a tab");
|
|
110
|
+
const line = rawLine.replace(/\s+$/, "");
|
|
111
|
+
const trimmed = line.trim();
|
|
112
|
+
if (!trimmed || trimmed.startsWith("#"))
|
|
113
|
+
continue;
|
|
114
|
+
if (trimmed === "---")
|
|
115
|
+
fail("handoff contains multiple YAML documents");
|
|
116
|
+
const indent = line.length - line.trimStart().length;
|
|
117
|
+
if (indent % 2 !== 0)
|
|
118
|
+
fail("handoff indentation must be a multiple of two spaces");
|
|
119
|
+
if (indent === 0) {
|
|
120
|
+
const { key, value, hasValue } = parseKeyValue(trimmed, TOP_KEYS, "handoff");
|
|
121
|
+
if (Object.prototype.hasOwnProperty.call(top, key))
|
|
122
|
+
fail(`handoff repeats ${key}`);
|
|
123
|
+
if (!hasValue) {
|
|
124
|
+
top[key] = null;
|
|
125
|
+
currentKey = key;
|
|
126
|
+
currentItem = null;
|
|
127
|
+
}
|
|
128
|
+
else {
|
|
129
|
+
top[key] = value;
|
|
130
|
+
currentKey = null;
|
|
131
|
+
currentItem = null;
|
|
132
|
+
}
|
|
133
|
+
continue;
|
|
134
|
+
}
|
|
135
|
+
if (!currentKey)
|
|
136
|
+
fail(`handoff has an indented line outside a list: ${trimmed}`);
|
|
137
|
+
if (top[currentKey] === null)
|
|
138
|
+
top[currentKey] = [];
|
|
139
|
+
const list = top[currentKey];
|
|
140
|
+
if (!Array.isArray(list))
|
|
141
|
+
fail(`handoff field ${currentKey} is not a list`);
|
|
142
|
+
if (trimmed.startsWith("- ")) {
|
|
143
|
+
const rest = trimmed.slice(2).trim();
|
|
144
|
+
if (currentKey === "artifacts" || currentKey === "findings") {
|
|
145
|
+
const item = {};
|
|
146
|
+
if (rest.length > 0) {
|
|
147
|
+
const parsed = parseKeyValue(rest, null, currentKey);
|
|
148
|
+
if (!parsed.hasValue)
|
|
149
|
+
fail(`${currentKey} item needs a value`);
|
|
150
|
+
item[parsed.key] = parsed.value;
|
|
151
|
+
}
|
|
152
|
+
list.push(item);
|
|
153
|
+
currentItem = item;
|
|
154
|
+
}
|
|
155
|
+
else if (currentKey === "decisions_owed") {
|
|
156
|
+
if (rest.length === 0)
|
|
157
|
+
fail("decisions_owed item is empty");
|
|
158
|
+
list.push(parseScalar(rest, "decisions_owed"));
|
|
159
|
+
currentItem = null;
|
|
160
|
+
}
|
|
161
|
+
else {
|
|
162
|
+
fail(`handoff field ${currentKey} is not a list`);
|
|
163
|
+
}
|
|
164
|
+
continue;
|
|
165
|
+
}
|
|
166
|
+
if (!currentItem)
|
|
167
|
+
fail(`handoff has a property without a list item: ${trimmed}`);
|
|
168
|
+
const parsed = parseKeyValue(trimmed, null, currentKey);
|
|
169
|
+
if (!parsed.hasValue)
|
|
170
|
+
fail(`${currentKey} item property needs a value`);
|
|
171
|
+
currentItem[parsed.key] = parsed.value;
|
|
172
|
+
}
|
|
173
|
+
for (const key of ["agent", "job", "status", "artifacts", "next"]) {
|
|
174
|
+
if (!(key in top))
|
|
175
|
+
fail(`handoff is missing ${key}`);
|
|
176
|
+
}
|
|
177
|
+
const agent = top["agent"];
|
|
178
|
+
if (typeof agent !== "string" || agent.length === 0)
|
|
179
|
+
fail("handoff.agent must be a string");
|
|
180
|
+
const job = top["job"];
|
|
181
|
+
if (typeof job !== "string" || job.length === 0)
|
|
182
|
+
fail("handoff.job must be a string");
|
|
183
|
+
const status = top["status"];
|
|
184
|
+
if (typeof status !== "string" || !HANDOFF_STATUSES.has(status)) {
|
|
185
|
+
fail(`handoff.status ${JSON.stringify(status)} is not valid`);
|
|
186
|
+
}
|
|
187
|
+
const next = top["next"];
|
|
188
|
+
if (typeof next !== "string" || next.length === 0)
|
|
189
|
+
fail("handoff.next must be a string");
|
|
190
|
+
const rawArtifacts = top["artifacts"];
|
|
191
|
+
if (!Array.isArray(rawArtifacts))
|
|
192
|
+
fail("handoff.artifacts must be a list");
|
|
193
|
+
const artifacts = artifactsOf(rawArtifacts);
|
|
194
|
+
const rawFindings = top["findings"] ?? [];
|
|
195
|
+
if (!Array.isArray(rawFindings))
|
|
196
|
+
fail("handoff.findings must be a list");
|
|
197
|
+
const findings = findingsOf(rawFindings);
|
|
198
|
+
const decisions = top["decisions_owed"] ?? [];
|
|
199
|
+
if (!Array.isArray(decisions) || decisions.some((q) => typeof q !== "string" || q.length === 0)) {
|
|
200
|
+
fail("handoff.decisions_owed must be a list of questions");
|
|
201
|
+
}
|
|
202
|
+
return {
|
|
203
|
+
agent,
|
|
204
|
+
job,
|
|
205
|
+
status: status,
|
|
206
|
+
artifacts,
|
|
207
|
+
findings,
|
|
208
|
+
decisions_owed: decisions,
|
|
209
|
+
next,
|
|
210
|
+
};
|
|
211
|
+
}
|
|
212
|
+
function unsafeArtifactPath(path) {
|
|
213
|
+
if (typeof path !== "string" || path.length === 0)
|
|
214
|
+
return true;
|
|
215
|
+
if (isAbsolute(path))
|
|
216
|
+
return true;
|
|
217
|
+
const segments = path.split(/[\\/]+/);
|
|
218
|
+
return segments.some((segment) => segment === "..");
|
|
219
|
+
}
|
|
220
|
+
export async function checkHandoffArtifacts(handoff, { projectRoot }) {
|
|
221
|
+
const missing = [];
|
|
222
|
+
const outside = [];
|
|
223
|
+
const realRoot = await realpathDeep(projectRoot);
|
|
224
|
+
for (const artifact of handoff.artifacts ?? []) {
|
|
225
|
+
if (unsafeArtifactPath(artifact.path)) {
|
|
226
|
+
outside.push(artifact.path);
|
|
227
|
+
continue;
|
|
228
|
+
}
|
|
229
|
+
const full = resolve(projectRoot, artifact.path);
|
|
230
|
+
const real = await realpathDeep(full);
|
|
231
|
+
if (!isInside(realRoot, real)) {
|
|
232
|
+
outside.push(artifact.path);
|
|
233
|
+
continue;
|
|
234
|
+
}
|
|
235
|
+
if (!(await exists(full)))
|
|
236
|
+
missing.push(artifact.path);
|
|
237
|
+
}
|
|
238
|
+
return { ok: missing.length === 0 && outside.length === 0, missing, outside };
|
|
239
|
+
}
|
|
240
|
+
export function normalizeHandoffPath(projectRelative) {
|
|
241
|
+
return projectRelative.split(sep).join("/");
|
|
242
|
+
}
|
|
243
|
+
export function handoffPath(base, relative) {
|
|
244
|
+
return join(base, relative);
|
|
245
|
+
}
|
|
246
|
+
//# sourceMappingURL=handoff.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../src/orchestrator/handoff.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export declare function canonicalJson(value: unknown): string;
|
|
2
|
+
export declare function sha256Hex(data: string | Buffer): string;
|
|
3
|
+
export declare function sha256(data: string | Buffer): string;
|
|
4
|
+
export declare function eventHash(event: Record<string, unknown>): string;
|
|
5
|
+
export declare function checkpointChecksum(checkpoint: Record<string, unknown>): string;
|
|
6
|
+
export declare function planChecksum(tasks: unknown): string;
|
|
7
|
+
/** The identity fields a task's inputs hash covers, in a fixed order. */
|
|
8
|
+
export declare function inputsHash(task: unknown): string;
|
|
9
|
+
export declare function fileHash(buffer: Buffer | string): string;
|
|
10
|
+
//# sourceMappingURL=hash.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/orchestrator/hash.ts"],"names":[],"mappings":"AAgCA,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAGhE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAG9E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAQhD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAExD"}
|