@polderlabs/bizar-omp 0.4.10 → 0.5.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.
Files changed (126) hide show
  1. package/README.md +3 -3
  2. package/dist/cli/install.js +5 -5
  3. package/dist/cli/install.js.map +1 -1
  4. package/dist/core/acceptance.d.ts +33 -0
  5. package/dist/core/acceptance.d.ts.map +1 -0
  6. package/dist/core/acceptance.js +87 -0
  7. package/dist/core/acceptance.js.map +1 -0
  8. package/dist/core/evidence.d.ts +6 -1
  9. package/dist/core/evidence.d.ts.map +1 -1
  10. package/dist/core/evidence.js +6 -2
  11. package/dist/core/evidence.js.map +1 -1
  12. package/dist/core/recovery.js +3 -3
  13. package/dist/core/recovery.js.map +1 -1
  14. package/dist/core/transitions.d.ts.map +1 -1
  15. package/dist/core/transitions.js +3 -3
  16. package/dist/core/transitions.js.map +1 -1
  17. package/dist/core/types.d.ts +51 -0
  18. package/dist/core/types.d.ts.map +1 -1
  19. package/dist/extension.d.ts.map +1 -1
  20. package/dist/extension.js +47 -5
  21. package/dist/extension.js.map +1 -1
  22. package/dist/index.d.ts +13 -0
  23. package/dist/index.d.ts.map +1 -1
  24. package/dist/index.js +13 -0
  25. package/dist/index.js.map +1 -1
  26. package/dist/omp/autonomous-settings.d.ts +11 -0
  27. package/dist/omp/autonomous-settings.d.ts.map +1 -1
  28. package/dist/omp/autonomous-settings.js +14 -0
  29. package/dist/omp/autonomous-settings.js.map +1 -1
  30. package/dist/omp/capabilities.d.ts +24 -0
  31. package/dist/omp/capabilities.d.ts.map +1 -0
  32. package/dist/omp/capabilities.js +6 -0
  33. package/dist/omp/capabilities.js.map +1 -0
  34. package/dist/omp/compatibility.d.ts +7 -0
  35. package/dist/omp/compatibility.d.ts.map +1 -1
  36. package/dist/omp/compatibility.js +27 -1
  37. package/dist/omp/compatibility.js.map +1 -1
  38. package/dist/omp/completion.d.ts.map +1 -1
  39. package/dist/omp/completion.js +4 -8
  40. package/dist/omp/completion.js.map +1 -1
  41. package/dist/omp/daemon-service.d.ts +2 -0
  42. package/dist/omp/daemon-service.d.ts.map +1 -1
  43. package/dist/omp/daemon-service.js +62 -13
  44. package/dist/omp/daemon-service.js.map +1 -1
  45. package/dist/omp/model-role-assignment.d.ts +5 -0
  46. package/dist/omp/model-role-assignment.d.ts.map +1 -1
  47. package/dist/omp/model-role-assignment.js +11 -1
  48. package/dist/omp/model-role-assignment.js.map +1 -1
  49. package/dist/omp/rpc.d.ts +6 -0
  50. package/dist/omp/rpc.d.ts.map +1 -1
  51. package/dist/omp/session-controls.d.ts +18 -0
  52. package/dist/omp/session-controls.d.ts.map +1 -0
  53. package/dist/omp/session-controls.js +14 -0
  54. package/dist/omp/session-controls.js.map +1 -0
  55. package/dist/services/budget.d.ts +20 -0
  56. package/dist/services/budget.d.ts.map +1 -0
  57. package/dist/services/budget.js +10 -0
  58. package/dist/services/budget.js.map +1 -0
  59. package/dist/services/candidate-local.d.ts +14 -0
  60. package/dist/services/candidate-local.d.ts.map +1 -0
  61. package/dist/services/candidate-local.js +15 -0
  62. package/dist/services/candidate-local.js.map +1 -0
  63. package/dist/services/candidates.d.ts +21 -0
  64. package/dist/services/candidates.d.ts.map +1 -0
  65. package/dist/services/candidates.js +100 -0
  66. package/dist/services/candidates.js.map +1 -0
  67. package/dist/services/evidence-bundle.d.ts +18 -0
  68. package/dist/services/evidence-bundle.d.ts.map +1 -0
  69. package/dist/services/evidence-bundle.js +21 -0
  70. package/dist/services/evidence-bundle.js.map +1 -0
  71. package/dist/services/inspector.d.ts +12 -0
  72. package/dist/services/inspector.d.ts.map +1 -0
  73. package/dist/services/inspector.js +6 -0
  74. package/dist/services/inspector.js.map +1 -0
  75. package/dist/services/lessons.d.ts +14 -0
  76. package/dist/services/lessons.d.ts.map +1 -0
  77. package/dist/services/lessons.js +11 -0
  78. package/dist/services/lessons.js.map +1 -0
  79. package/dist/services/projection.d.ts +22 -0
  80. package/dist/services/projection.d.ts.map +1 -0
  81. package/dist/services/projection.js +10 -0
  82. package/dist/services/projection.js.map +1 -0
  83. package/dist/services/readiness.d.ts +5 -0
  84. package/dist/services/readiness.d.ts.map +1 -0
  85. package/dist/services/readiness.js +35 -0
  86. package/dist/services/readiness.js.map +1 -0
  87. package/dist/services/recipes.d.ts +16 -0
  88. package/dist/services/recipes.d.ts.map +1 -0
  89. package/dist/services/recipes.js +42 -0
  90. package/dist/services/recipes.js.map +1 -0
  91. package/dist/services/recovery.d.ts +20 -0
  92. package/dist/services/recovery.d.ts.map +1 -0
  93. package/dist/services/recovery.js +9 -0
  94. package/dist/services/recovery.js.map +1 -0
  95. package/dist/services/review.d.ts +16 -0
  96. package/dist/services/review.d.ts.map +1 -0
  97. package/dist/services/review.js +9 -0
  98. package/dist/services/review.js.map +1 -0
  99. package/dist/storage/journal-recovery.d.ts +11 -0
  100. package/dist/storage/journal-recovery.d.ts.map +1 -0
  101. package/dist/storage/journal-recovery.js +33 -0
  102. package/dist/storage/journal-recovery.js.map +1 -0
  103. package/dist/storage/journal.d.ts.map +1 -1
  104. package/dist/storage/journal.js +14 -4
  105. package/dist/storage/journal.js.map +1 -1
  106. package/dist/storage/migrations.d.ts +15 -1
  107. package/dist/storage/migrations.d.ts.map +1 -1
  108. package/dist/storage/migrations.js +74 -5
  109. package/dist/storage/migrations.js.map +1 -1
  110. package/dist/storage/resources.d.ts +67 -0
  111. package/dist/storage/resources.d.ts.map +1 -0
  112. package/dist/storage/resources.js +148 -0
  113. package/dist/storage/resources.js.map +1 -0
  114. package/dist/tools/integrate.d.ts +1 -0
  115. package/dist/tools/integrate.d.ts.map +1 -1
  116. package/dist/tools/integrate.js +24 -40
  117. package/dist/tools/integrate.js.map +1 -1
  118. package/dist/tools/verify.d.ts +1 -1
  119. package/dist/tools/verify.d.ts.map +1 -1
  120. package/dist/tools/verify.js +30 -6
  121. package/dist/tools/verify.js.map +1 -1
  122. package/docs/compatibility/baseline.json +1 -1
  123. package/docs/compatibility/supported-surfaces.json +6 -0
  124. package/docs/releases/0.5.0.md +18 -0
  125. package/docs/releases/support-matrix.md +3 -0
  126. package/package.json +1 -1
@@ -0,0 +1,10 @@
1
+ import { inspectEvidence } from "./inspector.js";
2
+ export function projectWorkflow(state, requirements, maxChars = 16_000) {
3
+ const acceptance = inspectEvidence(state, requirements).decision;
4
+ const projection = { schemaVersion: 1, generatedAt: new Date().toISOString(), runId: state.run?.runId, phase: state.run?.phase, objective: state.run?.objective.objective, work: state.run?.workItems.map(item => ({ id: item.id, title: item.title.slice(0, 160), lifecycle: item.lifecycle, dependencies: item.dependencies })) ?? [], acceptance, unresolvedEffects: [...state.integrations.filter(item => item.outcome === "unknown-outcome").map(item => item.id), ...state.observations.filter(item => item.status === "unknown-outcome").map(item => item.dispatchId)], nextAction: acceptance.eligible ? "inspect accepted result" : acceptance.blockers[0]?.message ?? "admit a required check", truncated: false };
5
+ const serialized = JSON.stringify(projection);
6
+ if (serialized.length <= maxChars)
7
+ return projection;
8
+ return { ...projection, work: projection.work.slice(0, 8), acceptance: { ...projection.acceptance, selectedEvidenceIds: projection.acceptance.selectedEvidenceIds.slice(0, 8), supersededEvidence: projection.acceptance.supersededEvidence.slice(-8), blockers: projection.acceptance.blockers.slice(0, 8) }, truncated: true };
9
+ }
10
+ //# sourceMappingURL=projection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projection.js","sourceRoot":"","sources":["../../src/services/projection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,UAAU,eAAe,CAAC,KAAoB,EAAE,YAAoC,EAAE,QAAQ,GAAG,MAAM;IAC3G,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC;IACjE,MAAM,UAAU,GAAuB,EAAE,aAAa,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,iBAAiB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,iBAAiB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,wBAAwB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACjtB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,UAAU,CAAC;IACrD,OAAO,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,GAAG,UAAU,CAAC,UAAU,EAAE,mBAAmB,EAAE,UAAU,CAAC,UAAU,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,kBAAkB,EAAE,UAAU,CAAC,UAAU,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACnU,CAAC"}
@@ -0,0 +1,5 @@
1
+ import type { WorkItem } from "../core/types.js";
2
+ export declare function validateDependencies(items: WorkItem[]): void;
3
+ export declare function dependencyReady(item: WorkItem, items: WorkItem[]): boolean;
4
+ export declare function readyWorkItems(items: WorkItem[], capacity?: number): WorkItem[];
5
+ //# sourceMappingURL=readiness.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../src/services/readiness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAM5D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAE1E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,SAA2B,GAAG,QAAQ,EAAE,CAMjG"}
@@ -0,0 +1,35 @@
1
+ import { ContractError } from "../core/errors.js";
2
+ export function validateDependencies(items) {
3
+ const ids = new Set(items.map(item => item.id));
4
+ for (const item of items) {
5
+ if (item.dependencies.includes(item.id))
6
+ throw new ContractError("Work item cannot depend on itself", { workItemId: item.id });
7
+ for (const dependency of item.dependencies)
8
+ if (!ids.has(dependency))
9
+ throw new ContractError("Work item dependency is unknown", { workItemId: item.id, dependency });
10
+ }
11
+ const visiting = new Set();
12
+ const visited = new Set();
13
+ const visit = (id) => { if (visiting.has(id))
14
+ throw new ContractError("Work item dependency cycle detected", { workItemId: id }); if (visited.has(id))
15
+ return; visiting.add(id); const item = items.find(candidate => candidate.id === id); for (const dependency of item?.dependencies ?? [])
16
+ visit(dependency); visiting.delete(id); visited.add(id); };
17
+ for (const item of items)
18
+ visit(item.id);
19
+ }
20
+ export function dependencyReady(item, items) {
21
+ return item.dependencies.every(id => { const dependency = items.find(candidate => candidate.id === id); return dependency !== undefined && dependency.lifecycle === "accepted"; });
22
+ }
23
+ export function readyWorkItems(items, capacity = Number.POSITIVE_INFINITY) {
24
+ validateDependencies(items);
25
+ const ready = items.filter(item => item.lifecycle === "pending" && dependencyReady(item, items));
26
+ const selected = [];
27
+ for (const item of ready)
28
+ if (selected.every(other => item.scope.every(path => other.scope.every(otherPath => path !== otherPath && !path.startsWith(`${otherPath}/`) && !otherPath.startsWith(`${path}/`))))) {
29
+ selected.push(item);
30
+ if (selected.length >= capacity)
31
+ break;
32
+ }
33
+ return selected;
34
+ }
35
+ //# sourceMappingURL=readiness.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../src/services/readiness.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { CheckSpec, CriterionSpec, ObjectiveContract } from "../core/types.js";
2
+ export interface RecipePreview {
3
+ schemaVersion: 1;
4
+ recipeId: string;
5
+ objective: string;
6
+ suggestedScope: string[];
7
+ criteria: CriterionSpec[];
8
+ checks: CheckSpec[];
9
+ assumptions: string[];
10
+ warnings: string[];
11
+ trusted: false;
12
+ recipeHash: string;
13
+ }
14
+ export declare function analyzeRecipe(cwd: string, objective: ObjectiveContract): RecipePreview;
15
+ export declare function admitRecipe(preview: RecipePreview, authorized: boolean, expectedHash?: string): ObjectiveContract;
16
+ //# sourceMappingURL=recipes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../src/services/recipes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEpF,MAAM,WAAW,aAAa;IAAG,aAAa,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;CAAE;AAMlP,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,aAAa,CAatF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,SAAqB,GAAG,iBAAiB,CAK7H"}
@@ -0,0 +1,42 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { join, resolve } from "node:path";
3
+ import { createHash } from "node:crypto";
4
+ import { ContractError } from "../core/errors.js";
5
+ import { canonicalSpecHash, freezeCheckSpec } from "../core/acceptance.js";
6
+ function digestFile(path) {
7
+ try {
8
+ return createHash("sha256").update(readFileSync(path)).digest("hex");
9
+ }
10
+ catch {
11
+ return undefined;
12
+ }
13
+ }
14
+ export function analyzeRecipe(cwd, objective) {
15
+ const root = resolve(cwd);
16
+ const packagePath = join(root, "package.json");
17
+ let packageJson = {};
18
+ try {
19
+ packageJson = JSON.parse(readFileSync(packagePath, "utf8"));
20
+ }
21
+ catch { /* non-JavaScript repositories remain advisory */ }
22
+ const scripts = packageJson.scripts ?? {};
23
+ const checks = [];
24
+ const known = ["test", "lint", "typecheck", "build"];
25
+ for (const name of known)
26
+ if (typeof scripts[name] === "string")
27
+ checks.push(freezeCheckSpec({ id: `recipe:${name}`, revision: 1, runner: "argv", executable: "npm", argumentTemplate: ["run", name], cwdRule: "candidate-workspace", inputDigests: Object.fromEntries(["package.json", "package-lock.json", "npm-shrinkwrap.json"].map(file => [file, digestFile(join(root, file))]).filter(([, digest]) => digest !== undefined)), environmentPolicy: "Bizar safe environment allowlist", limits: { timeoutMs: 10 * 60 * 1000, outputBytes: 100_000 }, expected: "zero-exit", outputPolicy: "sanitized-tail" }));
28
+ const criteria = objective.acceptanceCriteria.map((description, index) => ({ id: `criterion:${index + 1}`, revision: 1, description, kind: "deterministic", requiredEvidenceClasses: checks.length ? checks.map(check => check.id) : ["operator-judgment"], applicable: true }));
29
+ const assumptions = ["Suggested commands are not executed during analysis", "Candidate-workspace materialization and native task settlement still require qualification"];
30
+ const warnings = checks.length ? [] : ["No conventional package scripts were discovered; add an explicitly authorized CheckSpec or operator judgment"];
31
+ const unsigned = { schemaVersion: 1, recipeId: `recipe_${canonicalSpecHash({ root, objective: objective.objective }).slice(0, 16)}`, objective: objective.objective, suggestedScope: [], criteria, checks, assumptions, warnings, trusted: false };
32
+ return { ...unsigned, recipeHash: canonicalSpecHash(unsigned) };
33
+ }
34
+ export function admitRecipe(preview, authorized, expectedHash = preview.recipeHash) {
35
+ if (!authorized)
36
+ throw new ContractError("Recipe admission requires explicit authorization");
37
+ const { recipeHash, ...unsigned } = preview;
38
+ if (recipeHash !== canonicalSpecHash(unsigned) || recipeHash !== expectedHash)
39
+ throw new ContractError("Recipe changed since preview; refusing admission");
40
+ return { objective: preview.objective, nonGoals: [], constraints: [], acceptanceCriteria: preview.criteria.map(criterion => criterion.description), verificationPlan: preview.checks.map(check => check.id), stopConditions: ["A required check fails, becomes stale, or is unsupported"], userRestrictions: [], revision: 1, criteria: preview.criteria, checkSpecs: preview.checks, policyRevision: preview.recipeHash, authorizationRef: `recipe-admission:${preview.recipeId}` };
41
+ }
42
+ //# sourceMappingURL=recipes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../src/services/recipes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import type { RepositoryIdentity } from "../storage/repository-identity.js";
2
+ export declare function recoveryInspection(identity: RepositoryIdentity, statePath: string): {
3
+ statePath: string;
4
+ health: {
5
+ valid: boolean;
6
+ lines: number;
7
+ invalidLines: number;
8
+ };
9
+ issue: import("../storage/migrations.js").JournalReadIssue | undefined;
10
+ validatedEntries: number;
11
+ resourceRegistry: string;
12
+ resources: {
13
+ resourceId: string;
14
+ path: string;
15
+ state: import("../storage/resources.js").ResourceState;
16
+ consumers: string[];
17
+ retentionPins: string[];
18
+ }[];
19
+ };
20
+ //# sourceMappingURL=recovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/services/recovery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;EAGjF"}
@@ -0,0 +1,9 @@
1
+ import { inspectState, readJournal } from "../storage/migrations.js";
2
+ import { resourceRegistryPath, loadResourceRegistry } from "../storage/resources.js";
3
+ export function recoveryInspection(identity, statePath) {
4
+ const health = inspectState(statePath);
5
+ const journal = readJournal(statePath);
6
+ const resources = loadResourceRegistry(identity);
7
+ return { statePath, health, issue: journal.issue, validatedEntries: journal.entries.length, resourceRegistry: resourceRegistryPath(identity), resources: resources.resources.map(resource => ({ resourceId: resource.resourceId, path: resource.path, state: resource.state, consumers: resource.consumers, retentionPins: resource.retentionPins })) };
8
+ }
9
+ //# sourceMappingURL=recovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/services/recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACrF,MAAM,UAAU,kBAAkB,CAAC,QAA4B,EAAE,SAAiB;IAChF,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAAC,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IAAC,MAAM,SAAS,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACjI,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC;AAC1V,CAAC"}
@@ -0,0 +1,16 @@
1
+ import type { ReviewSpec } from "../core/types.js";
2
+ export interface ReviewFinding {
3
+ id: string;
4
+ severity: "low" | "medium" | "high";
5
+ summary: string;
6
+ criterionId?: string;
7
+ evidenceIds: string[];
8
+ }
9
+ export interface ReviewDecision {
10
+ outcome: "passed" | "blocked" | "advisory";
11
+ findings: ReviewFinding[];
12
+ repairAllowed: boolean;
13
+ reason: string;
14
+ }
15
+ export declare function evaluateReview(spec: ReviewSpec, findings: ReviewFinding[], deterministicFailure: boolean, repairAttempts: number, maxRepairAttempts: number): ReviewDecision;
16
+ //# sourceMappingURL=review.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/services/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,MAAM,WAAW,aAAa;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;CAAE;AACjJ,MAAM,WAAW,cAAc;IAAG,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE;AAClJ,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,cAAc,CAK5K"}
@@ -0,0 +1,9 @@
1
+ export function evaluateReview(spec, findings, deterministicFailure, repairAttempts, maxRepairAttempts) {
2
+ if (deterministicFailure)
3
+ return { outcome: "blocked", findings, repairAllowed: repairAttempts < maxRepairAttempts, reason: "Deterministic acceptance failures cannot be overridden by review" };
4
+ const blocking = findings.some(finding => spec.severityPolicy === "block-any" || (spec.severityPolicy === "block-high" && finding.severity === "high"));
5
+ if (blocking)
6
+ return { outcome: "blocked", findings, repairAllowed: repairAttempts < maxRepairAttempts, reason: "Review contains unresolved findings under the admitted severity policy" };
7
+ return { outcome: spec.severityPolicy === "advisory" ? "advisory" : "passed", findings, repairAllowed: false, reason: "Review criteria satisfied" };
8
+ }
9
+ //# sourceMappingURL=review.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/services/review.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,QAAyB,EAAE,oBAA6B,EAAE,cAAsB,EAAE,iBAAyB;IAC1J,IAAI,oBAAoB;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,GAAG,iBAAiB,EAAE,MAAM,EAAE,kEAAkE,EAAE,CAAC;IACjM,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,cAAc,KAAK,YAAY,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC;IACxJ,IAAI,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,GAAG,iBAAiB,EAAE,MAAM,EAAE,wEAAwE,EAAE,CAAC;IAC3L,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;AACtJ,CAAC"}
@@ -0,0 +1,11 @@
1
+ export interface JournalRecoveryReceipt {
2
+ path: string;
3
+ backupPath: string;
4
+ backupDigest: string;
5
+ salvagedLines: number;
6
+ issue: "torn-tail";
7
+ authorized: true;
8
+ }
9
+ /** Salvage only a provably incomplete final record after an explicit operator authorization. */
10
+ export declare function recoverTornJournalTail(path: string, authorized: boolean): JournalRecoveryReceipt;
11
+ //# sourceMappingURL=journal-recovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"journal-recovery.d.ts","sourceRoot":"","sources":["../../src/storage/journal-recovery.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,sBAAsB,CAiBhG"}
@@ -0,0 +1,33 @@
1
+ import { closeSync, copyFileSync, existsSync, fsyncSync, openSync, readFileSync, renameSync, writeFileSync } from "node:fs";
2
+ import { createHash, randomUUID } from "node:crypto";
3
+ import { ContractError } from "../core/errors.js";
4
+ import { readJournal } from "./migrations.js";
5
+ /** Salvage only a provably incomplete final record after an explicit operator authorization. */
6
+ export function recoverTornJournalTail(path, authorized) {
7
+ if (!authorized)
8
+ throw new ContractError("Journal recovery requires explicit authorization");
9
+ if (!existsSync(path))
10
+ throw new ContractError("Journal does not exist", { path });
11
+ const result = readJournal(path);
12
+ if (!result.issue || result.issue.kind !== "torn-tail")
13
+ throw new ContractError("Only a torn journal tail may be salvaged", { issue: result.issue?.kind ?? "none" });
14
+ const original = readFileSync(path);
15
+ const backupPath = `${path}.recovery-${randomUUID()}.bak`;
16
+ copyFileSync(path, backupPath);
17
+ const backupDigest = createHash("sha256").update(original).digest("hex");
18
+ const completeLines = original.toString("utf8").split("\n").slice(0, result.issue.line - 1).filter(Boolean);
19
+ const temporaryPath = `${path}.recovery-${randomUUID()}.tmp`;
20
+ writeFileSync(temporaryPath, completeLines.length ? `${completeLines.join("\n")}\n` : "", { mode: 0o600 });
21
+ const fd = openSync(temporaryPath, "r");
22
+ try {
23
+ fsyncSync(fd);
24
+ }
25
+ finally {
26
+ closeSync(fd);
27
+ }
28
+ renameSync(temporaryPath, path);
29
+ if (readJournal(path).issue)
30
+ throw new ContractError("Recovered journal did not validate after replacement", { path });
31
+ return { path, backupPath, backupDigest, salvagedLines: completeLines.length, issue: "torn-tail", authorized: true };
32
+ }
33
+ //# sourceMappingURL=journal-recovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"journal-recovery.js","sourceRoot":"","sources":["../../src/storage/journal-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5H,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAW9C,gGAAgG;AAChG,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,UAAmB;IACtE,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,aAAa,CAAC,kDAAkD,CAAC,CAAC;IAC7F,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,aAAa,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACnF,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW;QAAE,MAAM,IAAI,aAAa,CAAC,0CAA0C,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;IACrK,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,GAAG,IAAI,aAAa,UAAU,EAAE,MAAM,CAAC;IAC1D,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/B,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5G,MAAM,aAAa,GAAG,GAAG,IAAI,aAAa,UAAU,EAAE,MAAM,CAAC;IAC7D,aAAa,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3G,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;YAAS,CAAC;QAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;IACjD,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAChC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK;QAAE,MAAM,IAAI,aAAa,CAAC,sDAAsD,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACvH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACvH,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/storage/journal.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElF,qBAAa,OAAO;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,YAAY,IAAI,EAAE,MAAM,EAAkG;IAE1H,OAAO,IAAI,YAAY,EAAE,CAGxB;IACD,QAAQ,IAAI,aAAa,CAAmC;IAE5D,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAiC3F;IAED,MAAM,CAAC,GAAG,EAAE,OAAO,kBAAkB,EAAE,WAAW,GAAG,YAAY,CAAkF;IACnJ,KAAK,IAAI,IAAI,CAAuF;CACrG;AAED,wBAAgB,aAAa,IAAI,OAAO,CAAiF"}
1
+ {"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/storage/journal.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElF,qBAAa,OAAO;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,YAAY,IAAI,EAAE,MAAM,EAAkG;IAE1H,OAAO,IAAI,YAAY,EAAE,CAKxB;IACD,QAAQ,IAAI,aAAa,CAAmC;IAE5D,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAsC3F;IAED,MAAM,CAAC,GAAG,EAAE,OAAO,kBAAkB,EAAE,WAAW,GAAG,YAAY,CAAkF;IACnJ,KAAK,IAAI,IAAI,CAAuF;CACrG;AAED,wBAAgB,aAAa,IAAI,OAAO,CAAiF"}
@@ -3,7 +3,7 @@ import { randomUUID } from "node:crypto";
3
3
  import { dirname, join } from "node:path";
4
4
  import { ContractError, OwnershipError } from "../core/errors.js";
5
5
  import { replay } from "../core/recovery.js";
6
- import { ensureStateFile, STATE_SCHEMA } from "./migrations.js";
6
+ import { ensureStateFile, readJournal, STATE_SCHEMA, checksumFor, MAX_JOURNAL_RECORD_BYTES } from "./migrations.js";
7
7
  export class Journal {
8
8
  path;
9
9
  lockPath;
@@ -11,7 +11,10 @@ export class Journal {
11
11
  entries() {
12
12
  if (!existsSync(this.path))
13
13
  return [];
14
- return readFileSync(this.path, "utf8").split("\n").filter(Boolean).map(line => JSON.parse(line));
14
+ const result = readJournal(this.path);
15
+ if (result.issue)
16
+ throw new ContractError("Journal requires explicit recovery before use", result.issue);
17
+ return result.entries;
15
18
  }
16
19
  snapshot() { return replay(this.entries()); }
17
20
  append(event, idempotencyKey, expectedRevision) {
@@ -42,11 +45,18 @@ export class Journal {
42
45
  throw new ContractError("A non-terminal workflow run already exists");
43
46
  if (expectedRevision !== undefined && current.revision !== expectedRevision)
44
47
  throw new ContractError("Revision conflict", { expectedRevision, actualRevision: current.revision });
45
- const entry = { sequence: current.lastSequence + 1, at: new Date().toISOString(), idempotencyKey, event };
48
+ const entryWithoutChecksum = { sequence: current.lastSequence + 1, at: new Date().toISOString(), idempotencyKey, event, schema: STATE_SCHEMA, previousHash: existingEntries.at(-1)?.checksum ?? "GENESIS" };
49
+ const entry = { ...entryWithoutChecksum, checksum: checksumFor(entryWithoutChecksum) };
50
+ const serialized = `${JSON.stringify(entry)}\n`;
51
+ if (Buffer.byteLength(serialized) > MAX_JOURNAL_RECORD_BYTES)
52
+ throw new ContractError("Journal event exceeds the configured size limit", { bytes: Buffer.byteLength(serialized), limit: MAX_JOURNAL_RECORD_BYTES });
46
53
  let stateFd;
47
54
  try {
48
55
  stateFd = openSync(this.path, "a", 0o600);
49
- writeSync(stateFd, `${JSON.stringify({ schema: STATE_SCHEMA, ...entry })}\n`, undefined, "utf8");
56
+ const bytes = Buffer.from(serialized, "utf8");
57
+ let offset = 0;
58
+ while (offset < bytes.length)
59
+ offset += writeSync(stateFd, bytes, offset, bytes.length - offset);
50
60
  fsyncSync(stateFd);
51
61
  }
52
62
  finally {
@@ -1 +1 @@
1
- {"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/storage/journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAiB,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGhE,MAAM,OAAO,OAAO;IACT,IAAI,CAAS;IACL,QAAQ,CAAS;IAClC,YAAY,IAAY,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE1H,OAAO;QACL,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACtC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC,CAAC;IACnH,CAAC;IACD,QAAQ,KAAoB,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAE5D,MAAM,CAAC,KAAmB,EAAE,cAAsB,EAAE,gBAAyB;QAC3E,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,aAAa,CAAC,6BAA6B,CAAC,CAAC;QACnF,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,IAAI,EAAsB,CAAC;QAC3B,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC;gBAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,MAAM,IAAI,cAAc,CAAC,oDAAoD,CAAC,CAAC;YAAC,CAAC;YAC5I,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YAC5C,SAAS,CAAC,EAAE,CAAC,CAAC;YACd,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,KAAK,cAAc,CAAC,CAAC;YACxF,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;oBAAE,MAAM,IAAI,aAAa,CAAC,kDAAkD,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;gBAC9J,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,aAAa,CAAC,4CAA4C,CAAC,CAAC;YAC3L,IAAI,gBAAgB,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,gBAAgB;gBAAE,MAAM,IAAI,aAAa,CAAC,mBAAmB,EAAE,EAAE,gBAAgB,EAAE,cAAc,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClL,MAAM,KAAK,GAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;YACxH,IAAI,OAA2B,CAAC;YAChC,IAAI,CAAC;gBACH,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC1C,SAAS,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;gBACjG,SAAS,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;oBAAS,CAAC;gBAAC,IAAI,OAAO,KAAK,SAAS;oBAAE,SAAS,CAAC,OAAO,CAAC,CAAC;YAAC,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,IAAI,EAAE,KAAK,SAAS;gBAAE,SAAS,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,CAAC;gBACH,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,SAAS;oBAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChH,CAAC;YAAC,MAAM,CAAC,CAAC,kDAAkD,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,MAAM,CAAC,GAA2C,IAAkB,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,eAAe,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACnJ,KAAK,KAAW,MAAM,IAAI,aAAa,CAAC,wDAAwD,CAAC,CAAC,CAAC,CAAC;CACrG;AAED,MAAM,UAAU,aAAa,KAAc,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/storage/journal.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,18 @@
1
- export declare const STATE_SCHEMA = "bizar.omp.state.v1";
1
+ import type { JournalEntry } from "../core/types.js";
2
+ export declare const LEGACY_STATE_SCHEMA = "bizar.omp.state.v1";
3
+ export declare const STATE_SCHEMA = "bizar.omp.state.v2";
4
+ export declare const MAX_JOURNAL_RECORD_BYTES: number;
5
+ export type JournalReadIssue = {
6
+ kind: "torn-tail" | "corrupt";
7
+ line: number;
8
+ message: string;
9
+ };
10
+ export type JournalReadResult = {
11
+ entries: JournalEntry[];
12
+ issue?: JournalReadIssue;
13
+ };
14
+ export declare function checksumFor(entry: Omit<JournalEntry, "checksum">): string;
15
+ export declare function readJournal(path: string): JournalReadResult;
2
16
  export declare function ensureStateFile(path: string): void;
3
17
  export declare function validateJournalLine(line: string): boolean;
4
18
  export declare function inspectState(path: string): {
@@ -1 +1 @@
1
- {"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/storage/migrations.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,uBAAuB,CAAC;AAEjD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAYlD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAKlG"}
1
+ {"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/storage/migrations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,YAAY,uBAAuB,CAAC;AACjD,eAAO,MAAM,wBAAwB,QAAc,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAChG,MAAM,MAAM,iBAAiB,GAAG;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAQtF,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,MAAM,CAEzE;AAmBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA0B3D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAYlD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAKlG"}
@@ -1,6 +1,75 @@
1
1
  import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync } from "node:fs";
2
+ import { createHash } from "node:crypto";
2
3
  import { dirname } from "node:path";
3
- export const STATE_SCHEMA = "bizar.omp.state.v1";
4
+ import { ContractError } from "../core/errors.js";
5
+ export const LEGACY_STATE_SCHEMA = "bizar.omp.state.v1";
6
+ export const STATE_SCHEMA = "bizar.omp.state.v2";
7
+ export const MAX_JOURNAL_RECORD_BYTES = 1024 * 1024;
8
+ function canonical(value) {
9
+ if (Array.isArray(value))
10
+ return `[${value.map(canonical).join(",")}]`;
11
+ if (value && typeof value === "object")
12
+ return `{${Object.entries(value).filter(([, item]) => item !== undefined).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => `${JSON.stringify(key)}:${canonical(item)}`).join(",")}}`;
13
+ return value === undefined ? "null" : JSON.stringify(value);
14
+ }
15
+ export function checksumFor(entry) {
16
+ return createHash("sha256").update(canonical(entry)).digest("hex");
17
+ }
18
+ function isEvent(value) {
19
+ return Boolean(value && typeof value === "object" && typeof value.type === "string");
20
+ }
21
+ function parseEntry(value, line) {
22
+ if (!value || typeof value !== "object")
23
+ throw new ContractError("Journal record is not an object", { line });
24
+ const input = value;
25
+ if (input.schema !== STATE_SCHEMA && input.schema !== LEGACY_STATE_SCHEMA)
26
+ throw new ContractError("Journal schema is unsupported", { line, schema: input.schema });
27
+ if (!Number.isSafeInteger(input.sequence) || (input.sequence ?? 0) <= 0 || typeof input.at !== "string" || !input.at || typeof input.idempotencyKey !== "string" || !input.idempotencyKey.trim() || !isEvent(input.event))
28
+ throw new ContractError("Journal record is malformed", { line });
29
+ if (input.schema === STATE_SCHEMA) {
30
+ if (typeof input.previousHash !== "string" || !/^[a-f0-9]{64}$|^GENESIS$/.test(input.previousHash) || typeof input.checksum !== "string" || !/^[a-f0-9]{64}$/.test(input.checksum))
31
+ throw new ContractError("Journal v2 integrity fields are malformed", { line });
32
+ const { checksum: _checksum, ...withoutChecksum } = input;
33
+ if (checksumFor(withoutChecksum) !== input.checksum)
34
+ throw new ContractError("Journal checksum mismatch", { line });
35
+ }
36
+ return input;
37
+ }
38
+ export function readJournal(path) {
39
+ if (!existsSync(path))
40
+ return { entries: [] };
41
+ const bytes = readFileSync(path);
42
+ if (bytes.length === 0)
43
+ return { entries: [] };
44
+ const text = bytes.toString("utf8");
45
+ const lines = text.split("\n");
46
+ const hasTornTail = !text.endsWith("\n");
47
+ const entries = [];
48
+ for (let index = 0; index < lines.length; index += 1) {
49
+ const raw = lines[index];
50
+ if (!raw)
51
+ continue;
52
+ if (Buffer.byteLength(raw) > MAX_JOURNAL_RECORD_BYTES)
53
+ return { entries, issue: { kind: "corrupt", line: index + 1, message: "Journal record exceeds the configured size limit" } };
54
+ try {
55
+ entries.push(parseEntry(JSON.parse(raw), index + 1));
56
+ }
57
+ catch (error) {
58
+ return { entries, issue: { kind: hasTornTail && index === lines.length - 1 ? "torn-tail" : "corrupt", line: index + 1, message: error instanceof Error ? error.message : String(error) } };
59
+ }
60
+ }
61
+ let previous = 0;
62
+ let previousHash = "GENESIS";
63
+ for (const entry of entries) {
64
+ if (entry.sequence !== previous + 1)
65
+ return { entries: entries.slice(0, previous), issue: { kind: "corrupt", line: entry.sequence, message: `Journal sequence expected ${previous + 1} but found ${entry.sequence}` } };
66
+ if (entry.schema === STATE_SCHEMA && entry.previousHash !== previousHash)
67
+ return { entries: entries.slice(0, previous), issue: { kind: "corrupt", line: entry.sequence, message: "Journal previous-record hash does not match" } };
68
+ previous = entry.sequence;
69
+ previousHash = entry.checksum ?? previousHash;
70
+ }
71
+ return { entries };
72
+ }
4
73
  export function ensureStateFile(path) {
5
74
  mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
6
75
  if (existsSync(path))
@@ -21,8 +90,8 @@ export function ensureStateFile(path) {
21
90
  }
22
91
  export function validateJournalLine(line) {
23
92
  try {
24
- const entry = JSON.parse(line);
25
- return entry.schema === STATE_SCHEMA && Number.isInteger(entry.sequence) && entry.sequence > 0 && typeof entry.idempotencyKey === "string" && entry.idempotencyKey.trim().length > 0 && entry.event !== undefined;
93
+ parseEntry(JSON.parse(line), 1);
94
+ return true;
26
95
  }
27
96
  catch {
28
97
  return false;
@@ -32,7 +101,7 @@ export function inspectState(path) {
32
101
  if (!existsSync(path))
33
102
  return { valid: true, lines: 0, invalidLines: 0 };
34
103
  const lines = readFileSync(path, "utf8").split("\n").filter(Boolean);
35
- const invalidLines = lines.filter(line => !validateJournalLine(line)).length;
36
- return { valid: invalidLines === 0, lines: lines.length, invalidLines };
104
+ const result = readJournal(path);
105
+ return { valid: !result.issue, lines: lines.length, invalidLines: result.issue ? 1 : 0 };
37
106
  }
38
107
  //# sourceMappingURL=migrations.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/storage/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9F,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAEjD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO;IAC7B,IAAI,EAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACjC,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,KAAK,CAAC;IACrC,CAAC;YAAS,CAAC;QACT,IAAI,EAAE,KAAK,SAAS;YAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqF,CAAC;QACnH,OAAO,KAAK,CAAC,MAAM,KAAK,YAAY,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAS,GAAG,CAAC,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;IACrN,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACzE,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7E,OAAO,EAAE,KAAK,EAAE,YAAY,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;AAC1E,CAAC"}
1
+ {"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/storage/migrations.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,67 @@
1
+ import type { RepositoryIdentity } from "./repository-identity.js";
2
+ export type ResourceState = "creation-intent" | "ready" | "in-use" | "quiescing" | "preservation-pending" | "retained" | "reclaimable" | "cleanup-intent" | "removed" | "creation-incomplete" | "cleanup-failed" | "missing" | "unavailable" | "ownership-unknown";
3
+ export interface WorkspaceRecord {
4
+ resourceId: string;
5
+ revision: number;
6
+ repositoryId: string;
7
+ commonDir: string;
8
+ path: string;
9
+ physicalKind: "git-worktree" | "verification-directory";
10
+ backend: "git" | "host" | "unknown";
11
+ runId?: string;
12
+ workItemId?: string;
13
+ dispatchId?: string;
14
+ candidateId?: string;
15
+ owner: string;
16
+ ownerEpoch: number;
17
+ nativeSessionId?: string;
18
+ nativeJobId?: string;
19
+ baseRef: string;
20
+ expectedHead?: string;
21
+ observedHead?: string;
22
+ createdAt: string;
23
+ lastObservedAt: string;
24
+ state: ResourceState;
25
+ consumers: string[];
26
+ retentionPins: string[];
27
+ retentionReason?: string;
28
+ disposable: boolean;
29
+ cleanupAttempts: number;
30
+ lastError?: string;
31
+ }
32
+ export interface RepositoryResourceRegistry {
33
+ schemaVersion: 1;
34
+ repositoryId: string;
35
+ commonDir: string;
36
+ revision: number;
37
+ resources: WorkspaceRecord[];
38
+ updatedAt: string;
39
+ }
40
+ export interface CleanupPreview {
41
+ resourceId: string;
42
+ allowed: boolean;
43
+ reasons: string[];
44
+ path: string;
45
+ state: ResourceState;
46
+ observed: {
47
+ exists: boolean;
48
+ dirty: boolean;
49
+ ignored: boolean;
50
+ registered: boolean;
51
+ };
52
+ }
53
+ export declare function resourceRegistryPath(identity: RepositoryIdentity): string;
54
+ export declare function loadResourceRegistry(identity: RepositoryIdentity): RepositoryResourceRegistry;
55
+ export declare function saveResourceRegistry(identity: RepositoryIdentity, registry: RepositoryResourceRegistry, expectedRevision?: number): RepositoryResourceRegistry;
56
+ export declare function registerWorkspace(identity: RepositoryIdentity, input: Omit<WorkspaceRecord, "resourceId" | "revision" | "repositoryId" | "commonDir" | "createdAt" | "lastObservedAt" | "state" | "cleanupAttempts">): WorkspaceRecord;
57
+ export declare function updateWorkspace(identity: RepositoryIdentity, resourceId: string, update: Partial<Pick<WorkspaceRecord, "state" | "ownerEpoch" | "observedHead" | "lastObservedAt" | "consumers" | "retentionPins" | "retentionReason" | "lastError" | "cleanupAttempts">>, expectedRevision?: number): WorkspaceRecord;
58
+ export declare function previewWorkspaceCleanup(identity: RepositoryIdentity, resourceId: string): CleanupPreview;
59
+ export declare function createDetachedWorkspace(identity: RepositoryIdentity, input: Omit<WorkspaceRecord, "resourceId" | "revision" | "repositoryId" | "commonDir" | "createdAt" | "lastObservedAt" | "state" | "cleanupAttempts" | "path"> & {
60
+ path?: string;
61
+ }): WorkspaceRecord;
62
+ export declare function cleanupWorkspace(identity: RepositoryIdentity, resourceId: string, authorize?: boolean): {
63
+ state: ResourceState;
64
+ reasons: string[];
65
+ };
66
+ export declare function resourceDigest(resource: WorkspaceRecord): string;
67
+ //# sourceMappingURL=resources.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/storage/resources.ts"],"names":[],"mappings":"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"}