@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,65 @@
|
|
|
1
|
+
// SHA 256 helpers, canonical JSON, and every checksum the engine records.
|
|
2
|
+
//
|
|
3
|
+
// Canonical JSON sorts object keys and emits no whitespace, so the same logical
|
|
4
|
+
// value hashes to the same digest regardless of how a caller serialized it.
|
|
5
|
+
import { createHash } from "node:crypto";
|
|
6
|
+
import { isRecord } from "../types/guards.js";
|
|
7
|
+
const TASK_IDENTITY_FIELDS = [
|
|
8
|
+
"capability",
|
|
9
|
+
"depends_on",
|
|
10
|
+
"resolved_skill",
|
|
11
|
+
"resolution_source",
|
|
12
|
+
"owner",
|
|
13
|
+
"adapter",
|
|
14
|
+
"idempotent",
|
|
15
|
+
];
|
|
16
|
+
function canonicalize(value) {
|
|
17
|
+
if (Array.isArray(value))
|
|
18
|
+
return value.map(canonicalize);
|
|
19
|
+
if (value !== null && typeof value === "object") {
|
|
20
|
+
const out = {};
|
|
21
|
+
for (const key of Object.keys(value).sort()) {
|
|
22
|
+
const entry = value[key];
|
|
23
|
+
if (entry === undefined)
|
|
24
|
+
continue;
|
|
25
|
+
out[key] = canonicalize(entry);
|
|
26
|
+
}
|
|
27
|
+
return out;
|
|
28
|
+
}
|
|
29
|
+
return value;
|
|
30
|
+
}
|
|
31
|
+
export function canonicalJson(value) {
|
|
32
|
+
return JSON.stringify(canonicalize(value));
|
|
33
|
+
}
|
|
34
|
+
export function sha256Hex(data) {
|
|
35
|
+
return createHash("sha256").update(data).digest("hex");
|
|
36
|
+
}
|
|
37
|
+
export function sha256(data) {
|
|
38
|
+
return `sha256:${sha256Hex(data)}`;
|
|
39
|
+
}
|
|
40
|
+
export function eventHash(event) {
|
|
41
|
+
const { hash: _hash, ...body } = event;
|
|
42
|
+
return sha256(canonicalJson(body));
|
|
43
|
+
}
|
|
44
|
+
export function checkpointChecksum(checkpoint) {
|
|
45
|
+
const { checksum: _checksum, ...body } = checkpoint;
|
|
46
|
+
return sha256(canonicalJson(body));
|
|
47
|
+
}
|
|
48
|
+
export function planChecksum(tasks) {
|
|
49
|
+
return sha256(canonicalJson(tasks));
|
|
50
|
+
}
|
|
51
|
+
/** The identity fields a task's inputs hash covers, in a fixed order. */
|
|
52
|
+
export function inputsHash(task) {
|
|
53
|
+
const source = isRecord(task) ? task : {};
|
|
54
|
+
const body = {};
|
|
55
|
+
for (const key of TASK_IDENTITY_FIELDS) {
|
|
56
|
+
body[key] = key === "adapter" ? (source[key] ?? null) : source[key];
|
|
57
|
+
}
|
|
58
|
+
if (body["depends_on"] === undefined)
|
|
59
|
+
body["depends_on"] = [];
|
|
60
|
+
return sha256(canonicalJson(body));
|
|
61
|
+
}
|
|
62
|
+
export function fileHash(buffer) {
|
|
63
|
+
return sha256(buffer);
|
|
64
|
+
}
|
|
65
|
+
//# sourceMappingURL=hash.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/orchestrator/hash.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { ChainCheck, Checkpoint, JournalEvent, JournalEventInput, JournalHead, JournalInfo, JournalSink, PlanSnapshot, RunState, TaskState } from "../types/orchestrator.js";
|
|
2
|
+
export declare function readJournal(path: string): Promise<JournalInfo>;
|
|
3
|
+
export declare function truncatePartialTail(path: string, info?: JournalInfo | null): Promise<number>;
|
|
4
|
+
export interface VerifyChainOptions {
|
|
5
|
+
readonly prevHash?: string | null;
|
|
6
|
+
readonly startSeq?: number;
|
|
7
|
+
}
|
|
8
|
+
export declare function verifyChain(events: readonly unknown[], { prevHash, startSeq }?: VerifyChainOptions): ChainCheck;
|
|
9
|
+
export interface JournalWriterOptions {
|
|
10
|
+
readonly path: string;
|
|
11
|
+
readonly events?: readonly JournalEvent[];
|
|
12
|
+
readonly prevHash?: string | null;
|
|
13
|
+
readonly lastSeq?: number;
|
|
14
|
+
}
|
|
15
|
+
export declare class JournalWriter implements JournalSink {
|
|
16
|
+
readonly path: string;
|
|
17
|
+
events: JournalEvent[];
|
|
18
|
+
prevHash: string | null;
|
|
19
|
+
lastSeq: number;
|
|
20
|
+
constructor({ path, events, prevHash, lastSeq }: JournalWriterOptions);
|
|
21
|
+
get head(): JournalHead;
|
|
22
|
+
append(fields: JournalEventInput): Promise<JournalEvent>;
|
|
23
|
+
retainAfter(seq: number): JournalEvent[];
|
|
24
|
+
lastEvents(count: number): JournalEvent[];
|
|
25
|
+
}
|
|
26
|
+
export interface ReplayOptions {
|
|
27
|
+
readonly base?: Checkpoint | null;
|
|
28
|
+
}
|
|
29
|
+
export interface ReplayResult {
|
|
30
|
+
readonly run: RunState | null;
|
|
31
|
+
readonly plan: PlanSnapshot | null;
|
|
32
|
+
readonly tasks: readonly TaskState[];
|
|
33
|
+
}
|
|
34
|
+
export declare function replay(events: readonly JournalEvent[], { base }?: ReplayOptions): ReplayResult;
|
|
35
|
+
//# sourceMappingURL=journal.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/orchestrator/journal.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,WAAW,EAEX,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,SAAS,EACV,MAAM,0BAA0B,CAAC;AAgBlC,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA4CpE;AAID,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAW,GAAG,IAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAKxG;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,EAAE,QAAe,EAAE,QAAY,EAAE,GAAE,kBAAuB,GACzD,UAAU,CA0BZ;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAc,YAAW,WAAW;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAEhB,YAAY,EAAE,IAAI,EAAE,MAAW,EAAE,QAAe,EAAE,OAAW,EAAE,EAAE,oBAAoB,EAKpF;IAED,IAAI,IAAI,IAAI,WAAW,CAEtB;IAEK,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoC7D;IAED,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAGvC;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAExC;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC;AAGD,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,EAAE,IAAW,EAAE,GAAE,aAAkB,GAAG,YAAY,CAQzG"}
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
// Append-only journal: append, read, hash chain verification, partial tail
|
|
2
|
+
// truncation, and replay.
|
|
3
|
+
import { appendLine, atomicWriteFile, readBuffer } from "./fsx.js";
|
|
4
|
+
import { eventHash } from "./hash.js";
|
|
5
|
+
import { applyEvent, finalizeRun } from "./state.js";
|
|
6
|
+
import { nowIso } from "./time.js";
|
|
7
|
+
import { isRecord } from "../types/guards.js";
|
|
8
|
+
function clone(value) {
|
|
9
|
+
return value === undefined ? value : JSON.parse(JSON.stringify(value));
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* The journal is hash-chained and `verifyChain` proves every line before it is
|
|
13
|
+
* replayed. Parsing stops at "valid JSON" on purpose: a line of the wrong shape
|
|
14
|
+
* is reported by the chain check with its sequence number, not dropped here.
|
|
15
|
+
*/
|
|
16
|
+
function parseJournalLine(line) {
|
|
17
|
+
return JSON.parse(line);
|
|
18
|
+
}
|
|
19
|
+
export async function readJournal(path) {
|
|
20
|
+
const buffer = await readBuffer(path);
|
|
21
|
+
if (buffer === null) {
|
|
22
|
+
return {
|
|
23
|
+
events: [],
|
|
24
|
+
errors: [],
|
|
25
|
+
truncated: false,
|
|
26
|
+
partial: "",
|
|
27
|
+
removedBytes: 0,
|
|
28
|
+
completeText: "",
|
|
29
|
+
exists: false,
|
|
30
|
+
size: 0,
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
const text = buffer.toString("utf8");
|
|
34
|
+
let completeText = text;
|
|
35
|
+
let partial = "";
|
|
36
|
+
let truncated = false;
|
|
37
|
+
if (text.length > 0 && !text.endsWith("\n")) {
|
|
38
|
+
const index = text.lastIndexOf("\n");
|
|
39
|
+
partial = index === -1 ? text : text.slice(index + 1);
|
|
40
|
+
completeText = index === -1 ? "" : text.slice(0, index + 1);
|
|
41
|
+
truncated = true;
|
|
42
|
+
}
|
|
43
|
+
const events = [];
|
|
44
|
+
const errors = [];
|
|
45
|
+
for (const line of completeText.split("\n")) {
|
|
46
|
+
if (!line.trim())
|
|
47
|
+
continue;
|
|
48
|
+
try {
|
|
49
|
+
events.push(parseJournalLine(line));
|
|
50
|
+
}
|
|
51
|
+
catch (error) {
|
|
52
|
+
errors.push({ line, error });
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
return {
|
|
56
|
+
events,
|
|
57
|
+
errors,
|
|
58
|
+
truncated,
|
|
59
|
+
partial,
|
|
60
|
+
removedBytes: truncated ? Buffer.byteLength(partial, "utf8") : 0,
|
|
61
|
+
completeText,
|
|
62
|
+
exists: true,
|
|
63
|
+
size: buffer.length,
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
// Rewrite the journal with only complete lines. Used when boot finds a partial
|
|
67
|
+
// trailing line; the replacement uses the same atomic write protocol.
|
|
68
|
+
export async function truncatePartialTail(path, info = null) {
|
|
69
|
+
const current = info ?? (await readJournal(path));
|
|
70
|
+
if (!current.truncated)
|
|
71
|
+
return 0;
|
|
72
|
+
await atomicWriteFile(path, current.completeText);
|
|
73
|
+
return current.removedBytes;
|
|
74
|
+
}
|
|
75
|
+
export function verifyChain(events, { prevHash = null, startSeq = 1 } = {}) {
|
|
76
|
+
let expectedPrev = prevHash;
|
|
77
|
+
let expectedSeq = startSeq;
|
|
78
|
+
for (let index = 0; index < events.length; index++) {
|
|
79
|
+
const event = events[index];
|
|
80
|
+
if (!isRecord(event)) {
|
|
81
|
+
return { ok: false, index, reason: "event is not an object" };
|
|
82
|
+
}
|
|
83
|
+
const seq = event["seq"];
|
|
84
|
+
if (seq !== expectedSeq) {
|
|
85
|
+
return { ok: false, index, reason: `sequence gap: expected ${expectedSeq}, got ${String(seq)}` };
|
|
86
|
+
}
|
|
87
|
+
const hash = event["hash"];
|
|
88
|
+
if (typeof hash !== "string") {
|
|
89
|
+
return { ok: false, index, reason: `event ${String(seq)} has no hash` };
|
|
90
|
+
}
|
|
91
|
+
if (eventHash(event) !== hash) {
|
|
92
|
+
return { ok: false, index, reason: `hash mismatch at seq ${String(seq)}` };
|
|
93
|
+
}
|
|
94
|
+
if ((event["prev_hash"] ?? null) !== expectedPrev) {
|
|
95
|
+
return { ok: false, index, reason: `prev_hash mismatch at seq ${String(seq)}` };
|
|
96
|
+
}
|
|
97
|
+
expectedPrev = hash;
|
|
98
|
+
expectedSeq += 1;
|
|
99
|
+
}
|
|
100
|
+
return { ok: true, head: { seq: expectedSeq - 1, event_hash: expectedPrev } };
|
|
101
|
+
}
|
|
102
|
+
export class JournalWriter {
|
|
103
|
+
path;
|
|
104
|
+
events;
|
|
105
|
+
prevHash;
|
|
106
|
+
lastSeq;
|
|
107
|
+
constructor({ path, events = [], prevHash = null, lastSeq = 0 }) {
|
|
108
|
+
this.path = path;
|
|
109
|
+
this.events = [...events];
|
|
110
|
+
this.prevHash = prevHash;
|
|
111
|
+
this.lastSeq = lastSeq;
|
|
112
|
+
}
|
|
113
|
+
get head() {
|
|
114
|
+
return { seq: this.lastSeq, event_hash: this.prevHash };
|
|
115
|
+
}
|
|
116
|
+
async append(fields) {
|
|
117
|
+
const seq = this.lastSeq + 1;
|
|
118
|
+
const { type, ts, run_id, session_id, prev_hash: _ignoredPrev, hash: _ignoredHash, seq: _ignoredSeq, ...rest } = fields;
|
|
119
|
+
const body = {
|
|
120
|
+
seq,
|
|
121
|
+
ts: ts ?? nowIso(),
|
|
122
|
+
type,
|
|
123
|
+
run_id: run_id ?? null,
|
|
124
|
+
session_id: session_id ?? null,
|
|
125
|
+
...rest,
|
|
126
|
+
prev_hash: this.prevHash,
|
|
127
|
+
};
|
|
128
|
+
const full = {
|
|
129
|
+
seq,
|
|
130
|
+
ts: body["ts"],
|
|
131
|
+
type,
|
|
132
|
+
run_id: run_id ?? null,
|
|
133
|
+
session_id: session_id ?? null,
|
|
134
|
+
prev_hash: this.prevHash,
|
|
135
|
+
...rest,
|
|
136
|
+
hash: eventHash(body),
|
|
137
|
+
};
|
|
138
|
+
await appendLine(this.path, JSON.stringify(full));
|
|
139
|
+
this.events.push(full);
|
|
140
|
+
this.lastSeq = seq;
|
|
141
|
+
this.prevHash = full.hash;
|
|
142
|
+
return full;
|
|
143
|
+
}
|
|
144
|
+
retainAfter(seq) {
|
|
145
|
+
this.events = this.events.filter((event) => event.seq > seq);
|
|
146
|
+
return this.events;
|
|
147
|
+
}
|
|
148
|
+
lastEvents(count) {
|
|
149
|
+
return this.events.slice(-count);
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
// Replay a retained journal onto an optional checkpoint base.
|
|
153
|
+
export function replay(events, { base = null } = {}) {
|
|
154
|
+
const ctx = {
|
|
155
|
+
run: base?.state ? clone(base.state) : null,
|
|
156
|
+
plan: base?.plan ? clone(base.plan) : null,
|
|
157
|
+
tasks: base?.tasks ? new Map(base.tasks.map((task) => [task.task_id, clone(task)])) : new Map(),
|
|
158
|
+
};
|
|
159
|
+
for (const event of events)
|
|
160
|
+
applyEvent(ctx, event);
|
|
161
|
+
return finalizeRun(ctx.run, ctx.plan, ctx.tasks);
|
|
162
|
+
}
|
|
163
|
+
//# sourceMappingURL=journal.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/orchestrator/journal.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import type { Lease, LeaseAcquisition, LeaseRecord, LeaseSummary, LeaseView } from "../types/orchestrator.js";
|
|
2
|
+
export declare function leasePath(root: string, sessionId: string): string;
|
|
3
|
+
export declare function readLeases(root: string): Promise<LeaseRecord[]>;
|
|
4
|
+
export declare function pidAlive(pid: number): boolean;
|
|
5
|
+
export declare function heartbeatMs(lease: Lease | null | undefined): number;
|
|
6
|
+
export declare function leaseIsLive(lease: Lease | null | undefined, atMs?: number): boolean;
|
|
7
|
+
export declare function leaseView(lease: Lease | null, atMs?: number): Partial<LeaseView>;
|
|
8
|
+
export interface AcquireLeaseInput {
|
|
9
|
+
readonly root: string;
|
|
10
|
+
readonly sessionId: string;
|
|
11
|
+
readonly pid?: number;
|
|
12
|
+
readonly host?: string;
|
|
13
|
+
readonly ttlSeconds?: number;
|
|
14
|
+
readonly atMs?: number;
|
|
15
|
+
}
|
|
16
|
+
export declare function acquireLease({ root, sessionId, pid, host, ttlSeconds, atMs, }: AcquireLeaseInput): Promise<LeaseAcquisition>;
|
|
17
|
+
export declare function readOwnLease(root: string, sessionId: string): Promise<Lease | null>;
|
|
18
|
+
export declare function assertLease(root: string, sessionId: string): Promise<Lease>;
|
|
19
|
+
export interface HeartbeatLeaseInput {
|
|
20
|
+
readonly root: string;
|
|
21
|
+
readonly sessionId: string;
|
|
22
|
+
readonly ttlSeconds?: number | null;
|
|
23
|
+
readonly atMs?: number;
|
|
24
|
+
}
|
|
25
|
+
export declare function heartbeatLease({ root, sessionId, ttlSeconds, atMs, }: HeartbeatLeaseInput): Promise<Lease>;
|
|
26
|
+
export declare function releaseLease({ root, sessionId, }: {
|
|
27
|
+
readonly root: string;
|
|
28
|
+
readonly sessionId: string;
|
|
29
|
+
}): Promise<Lease>;
|
|
30
|
+
export declare function summarizeLeases(leases: readonly LeaseRecord[], atMs?: number): LeaseSummary[];
|
|
31
|
+
//# sourceMappingURL=lease.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lease.d.ts","sourceRoot":"","sources":["../../src/orchestrator/lease.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE9G,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAYD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAiBrE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ7C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAInE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,GAAE,MAAgB,GAAG,OAAO,CAK5F;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,GAAE,MAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CASzF;AAwBD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,YAAY,CAAC,EACjC,IAAI,EACJ,SAAS,EACT,GAAiB,EACjB,IAAiB,EACjB,UAAe,EACf,IAAc,GACf,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkD/C;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAOzF;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAIjF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,cAAc,CAAC,EACnC,IAAI,EACJ,SAAS,EACT,UAAiB,EACjB,IAAc,GACf,EAAE,mBAAmB,GAAG,OAAO,CAAC,KAAK,CAAC,CAStC;AAED,wBAAsB,YAAY,CAAC,EACjC,IAAI,EACJ,SAAS,GACV,EAAE;IACD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,KAAK,CAAC,CAIjB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,GAAE,MAAgB,GAAG,YAAY,EAAE,CAKtG"}
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
// Advisory single-writer lease.
|
|
2
|
+
//
|
|
3
|
+
// A lease is one JSON file under locks/. A live lease owned by another session
|
|
4
|
+
// halts boot. A stale lease is taken over. A dead lease with the same session
|
|
5
|
+
// id and host is reclaimed after a crash.
|
|
6
|
+
import { hostname } from "node:os";
|
|
7
|
+
import { join } from "node:path";
|
|
8
|
+
import { atomicWriteFile, ensureDir, listDir, readJsonFile, removeFile } from "./fsx.js";
|
|
9
|
+
import { LeaseHeldError, LeaseLostError } from "./errors.js";
|
|
10
|
+
import { nowIso, nowMs, parseIso } from "./time.js";
|
|
11
|
+
import { isRecord } from "../types/guards.js";
|
|
12
|
+
export function leasePath(root, sessionId) {
|
|
13
|
+
return join(root, "locks", `session-${sessionId}.json`);
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* A lease file is written only by this engine. A file that parses as a JSON
|
|
17
|
+
* object is kept as-is: every reader is total over missing fields, so a foreign
|
|
18
|
+
* or truncated lease reads as stale and is taken over.
|
|
19
|
+
*/
|
|
20
|
+
function asLease(value) {
|
|
21
|
+
if (!isRecord(value))
|
|
22
|
+
return null;
|
|
23
|
+
return value;
|
|
24
|
+
}
|
|
25
|
+
export async function readLeases(root) {
|
|
26
|
+
const dir = join(root, "locks");
|
|
27
|
+
const entries = await listDir(dir);
|
|
28
|
+
const leases = [];
|
|
29
|
+
for (const entry of entries) {
|
|
30
|
+
if (!entry.isFile() || !entry.name.startsWith("session-") || !entry.name.endsWith(".json"))
|
|
31
|
+
continue;
|
|
32
|
+
const path = join(dir, entry.name);
|
|
33
|
+
const parsed = await readJsonFile(path);
|
|
34
|
+
const lease = parsed.exists && !parsed.error ? asLease(parsed.value) : null;
|
|
35
|
+
if (lease) {
|
|
36
|
+
leases.push({ path, lease });
|
|
37
|
+
}
|
|
38
|
+
else {
|
|
39
|
+
leases.push({ path, lease: null, invalid: true });
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
leases.sort((a, b) => String(a.lease?.session_id ?? a.path).localeCompare(String(b.lease?.session_id ?? b.path)));
|
|
43
|
+
return leases;
|
|
44
|
+
}
|
|
45
|
+
export function pidAlive(pid) {
|
|
46
|
+
if (!Number.isInteger(pid) || pid <= 0)
|
|
47
|
+
return false;
|
|
48
|
+
try {
|
|
49
|
+
process.kill(pid, 0);
|
|
50
|
+
return true;
|
|
51
|
+
}
|
|
52
|
+
catch (error) {
|
|
53
|
+
return typeof error === "object" && error !== null && error.code === "EPERM";
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
export function heartbeatMs(lease) {
|
|
57
|
+
const value = parseIso(lease?.heartbeat_at);
|
|
58
|
+
if (value !== null)
|
|
59
|
+
return value;
|
|
60
|
+
return parseIso(lease?.started_at) ?? 0;
|
|
61
|
+
}
|
|
62
|
+
export function leaseIsLive(lease, atMs = nowMs()) {
|
|
63
|
+
if (!lease)
|
|
64
|
+
return false;
|
|
65
|
+
const ttl = Number(lease.ttl_seconds);
|
|
66
|
+
if (!Number.isFinite(ttl) || ttl <= 0)
|
|
67
|
+
return false;
|
|
68
|
+
return atMs - heartbeatMs(lease) < ttl * 1000;
|
|
69
|
+
}
|
|
70
|
+
export function leaseView(lease, atMs = nowMs()) {
|
|
71
|
+
if (!lease)
|
|
72
|
+
return { live: false, stale: true, age_seconds: null };
|
|
73
|
+
const ageMs = Math.max(0, atMs - heartbeatMs(lease));
|
|
74
|
+
return {
|
|
75
|
+
...lease,
|
|
76
|
+
live: leaseIsLive(lease, atMs),
|
|
77
|
+
stale: !leaseIsLive(lease, atMs),
|
|
78
|
+
age_seconds: Math.floor(ageMs / 1000),
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
function newLease({ sessionId, pid, host, ttlSeconds, }) {
|
|
82
|
+
const at = nowIso();
|
|
83
|
+
return {
|
|
84
|
+
session_id: sessionId,
|
|
85
|
+
pid,
|
|
86
|
+
host,
|
|
87
|
+
started_at: at,
|
|
88
|
+
heartbeat_at: at,
|
|
89
|
+
ttl_seconds: ttlSeconds,
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
export async function acquireLease({ root, sessionId, pid = process.pid, host = hostname(), ttlSeconds = 60, atMs = nowMs(), }) {
|
|
93
|
+
await ensureDir(join(root, "locks"));
|
|
94
|
+
const leases = await readLeases(root);
|
|
95
|
+
const live = leases.filter((entry) => entry.lease !== null && leaseIsLive(entry.lease, atMs));
|
|
96
|
+
for (const entry of live) {
|
|
97
|
+
const lease = entry.lease;
|
|
98
|
+
const sameSession = lease.session_id === sessionId;
|
|
99
|
+
const sameHost = lease.host === host;
|
|
100
|
+
if (sameSession && sameHost && !pidAlive(lease.pid)) {
|
|
101
|
+
const reclaimed = newLease({ sessionId, pid, host, ttlSeconds });
|
|
102
|
+
await atomicWriteFile(leasePath(root, sessionId), `${JSON.stringify(reclaimed, null, 2)}\n`);
|
|
103
|
+
return { action: "reacquired", lease: reclaimed, previous: lease };
|
|
104
|
+
}
|
|
105
|
+
throw new LeaseHeldError(lease.session_id, { detail: { lease, path: entry.path } });
|
|
106
|
+
}
|
|
107
|
+
const stale = leases.filter((entry) => entry.lease !== null && !leaseIsLive(entry.lease, atMs));
|
|
108
|
+
const lease = newLease({ sessionId, pid, host, ttlSeconds });
|
|
109
|
+
if (stale.length > 0) {
|
|
110
|
+
stale.sort((a, b) => heartbeatMs(b.lease) - heartbeatMs(a.lease));
|
|
111
|
+
const previous = stale[0]?.lease ?? null;
|
|
112
|
+
for (const entry of leases) {
|
|
113
|
+
try {
|
|
114
|
+
await removeFile(entry.path);
|
|
115
|
+
}
|
|
116
|
+
catch {
|
|
117
|
+
// A lease file we cannot remove is reported through the next read.
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
await atomicWriteFile(leasePath(root, sessionId), `${JSON.stringify(lease, null, 2)}\n`);
|
|
121
|
+
return { action: "taken_over", lease, previous };
|
|
122
|
+
}
|
|
123
|
+
// Invalid, unreadable lease files are treated as stale and cleared.
|
|
124
|
+
if (leases.length > 0) {
|
|
125
|
+
for (const entry of leases) {
|
|
126
|
+
try {
|
|
127
|
+
await removeFile(entry.path);
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
// best effort
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
await atomicWriteFile(leasePath(root, sessionId), `${JSON.stringify(lease, null, 2)}\n`);
|
|
135
|
+
return { action: "acquired", lease, previous: null };
|
|
136
|
+
}
|
|
137
|
+
export async function readOwnLease(root, sessionId) {
|
|
138
|
+
const parsed = await readJsonFile(leasePath(root, sessionId));
|
|
139
|
+
if (!parsed.exists || parsed.error)
|
|
140
|
+
return null;
|
|
141
|
+
const lease = asLease(parsed.value);
|
|
142
|
+
if (!lease)
|
|
143
|
+
return null;
|
|
144
|
+
if (lease.session_id !== sessionId)
|
|
145
|
+
return null;
|
|
146
|
+
return lease;
|
|
147
|
+
}
|
|
148
|
+
export async function assertLease(root, sessionId) {
|
|
149
|
+
const lease = await readOwnLease(root, sessionId);
|
|
150
|
+
if (!lease)
|
|
151
|
+
throw new LeaseLostError(sessionId);
|
|
152
|
+
return lease;
|
|
153
|
+
}
|
|
154
|
+
export async function heartbeatLease({ root, sessionId, ttlSeconds = null, atMs = nowMs(), }) {
|
|
155
|
+
const lease = await assertLease(root, sessionId);
|
|
156
|
+
const next = {
|
|
157
|
+
...lease,
|
|
158
|
+
heartbeat_at: new Date(atMs).toISOString().slice(0, 19) + "Z",
|
|
159
|
+
ttl_seconds: ttlSeconds ?? lease.ttl_seconds,
|
|
160
|
+
};
|
|
161
|
+
await atomicWriteFile(leasePath(root, sessionId), `${JSON.stringify(next, null, 2)}\n`);
|
|
162
|
+
return next;
|
|
163
|
+
}
|
|
164
|
+
export async function releaseLease({ root, sessionId, }) {
|
|
165
|
+
const lease = await assertLease(root, sessionId);
|
|
166
|
+
await removeFile(leasePath(root, sessionId));
|
|
167
|
+
return lease;
|
|
168
|
+
}
|
|
169
|
+
export function summarizeLeases(leases, atMs = nowMs()) {
|
|
170
|
+
return leases.map((entry) => ({
|
|
171
|
+
path: entry.path,
|
|
172
|
+
...(entry.lease ? leaseView(entry.lease, atMs) : { invalid: true }),
|
|
173
|
+
}));
|
|
174
|
+
}
|
|
175
|
+
//# sourceMappingURL=lease.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lease.js","sourceRoot":"","sources":["../../src/orchestrator/lease.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { EnvFingerprint, PlanSnapshot } from "../types/orchestrator.js";
|
|
2
|
+
/** Anything that has a task id and dependencies can be ordered. */
|
|
3
|
+
export interface Orderable {
|
|
4
|
+
readonly task_id: string;
|
|
5
|
+
readonly depends_on?: readonly string[];
|
|
6
|
+
}
|
|
7
|
+
export declare function isValidTaskId(value: unknown): value is string;
|
|
8
|
+
export declare function skillNameFromResolved(resolvedSkill: unknown): string | null;
|
|
9
|
+
export declare function orderTasks<T extends Orderable>(tasks: readonly T[]): T[];
|
|
10
|
+
export interface PlanInputOptions {
|
|
11
|
+
readonly libraryRoot: string | null;
|
|
12
|
+
readonly runId: string;
|
|
13
|
+
readonly createdAt: string;
|
|
14
|
+
readonly envFingerprint?: EnvFingerprint | null;
|
|
15
|
+
}
|
|
16
|
+
export declare function validatePlanInput(input: unknown, { libraryRoot, runId, createdAt, envFingerprint, }: PlanInputOptions): Promise<PlanSnapshot>;
|
|
17
|
+
export interface ReplaceInput {
|
|
18
|
+
readonly currentPlan: PlanSnapshot | null;
|
|
19
|
+
readonly currentTasks?: readonly {
|
|
20
|
+
readonly task_id: string;
|
|
21
|
+
readonly status: string;
|
|
22
|
+
}[];
|
|
23
|
+
readonly newPlan: PlanSnapshot;
|
|
24
|
+
readonly replace: boolean;
|
|
25
|
+
}
|
|
26
|
+
export declare function assertReplaceAllowed({ currentPlan, currentTasks, newPlan, replace }: ReplaceInput): void;
|
|
27
|
+
//# sourceMappingURL=plan.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/orchestrator/plan.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAY,MAAM,0BAA0B,CAAC;AAQvF,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAcD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQ7D;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ3E;AAkBD,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CA2BxE;AAiED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACjD;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,EACtD,WAAW,EACX,KAAK,EACL,SAAS,EACT,cAAc,GACf,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6E1C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzF,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAID,wBAAgB,oBAAoB,CAAC,EAAE,WAAW,EAAE,YAAiB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,IAAI,CA0B7G"}
|