@polderlabs/bizar-omp 0.6.2 → 0.6.4

package/dist/src/services/recipes.js

@@ -0,0 +1,42 @@
+import { readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { createHash } from "node:crypto";
+import { ContractError } from "../core/errors.js";
+import { canonicalSpecHash, freezeCheckSpec } from "../core/acceptance.js";
+function digestFile(path) {
+    try {
+        return createHash("sha256").update(readFileSync(path)).digest("hex");
+    }
+    catch {
+        return undefined;
+    }
+}
+export function analyzeRecipe(cwd, objective) {
+    const root = resolve(cwd);
+    const packagePath = join(root, "package.json");
+    let packageJson = {};
+    try {
+        packageJson = JSON.parse(readFileSync(packagePath, "utf8"));
+    }
+    catch { /* non-JavaScript repositories remain advisory */ }
+    const scripts = packageJson.scripts ?? {};
+    const checks = [];
+    const known = ["test", "lint", "typecheck", "build"];
+    for (const name of known)
+        if (typeof scripts[name] === "string")
+            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" }));
+    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 }));
+    const assumptions = ["Suggested commands are not executed during analysis", "Candidate-workspace materialization and native task settlement still require qualification"];
+    const warnings = checks.length ? [] : ["No conventional package scripts were discovered; add an explicitly authorized CheckSpec or operator judgment"];
+    const unsigned = { schemaVersion: 1, recipeId: `recipe_${canonicalSpecHash({ root, objective: objective.objective }).slice(0, 16)}`, objective: objective.objective, suggestedScope: [], criteria, checks, assumptions, warnings, trusted: false };
+    return { ...unsigned, recipeHash: canonicalSpecHash(unsigned) };
+}
+export function admitRecipe(preview, authorized, expectedHash = preview.recipeHash) {
+    if (!authorized)
+        throw new ContractError("Recipe admission requires explicit authorization");
+    const { recipeHash, ...unsigned } = preview;
+    if (recipeHash !== canonicalSpecHash(unsigned) || recipeHash !== expectedHash)
+        throw new ContractError("Recipe changed since preview; refusing admission");
+    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}` };
+}
+//# sourceMappingURL=recipes.js.map

package/dist/src/services/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../../src/services/recipes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAc,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK3E,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,CAAC;QAAC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,SAA4B;IACrE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAAC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC1E,IAAI,WAAW,GAA0C,EAAE,CAAC;IAC5D,IAAI,CAAC;QAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAuB,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,iDAAiD,CAAC,CAAC;IACtJ,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;IAC9D,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,UAAU,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,cAAc,EAAE,mBAAmB,EAAE,qBAAqB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAA4B,CAAC,EAAE,iBAAiB,EAAE,kCAAkC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAC9mB,MAAM,QAAQ,GAAoB,SAAS,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,aAAa,KAAK,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClS,MAAM,WAAW,GAAG,CAAC,qDAAqD,EAAE,4FAA4F,CAAC,CAAC;IAC1K,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,8GAA8G,CAAC,CAAC;IACvJ,MAAM,QAAQ,GAAG,EAAE,aAAa,EAAE,CAAU,EAAE,QAAQ,EAAE,UAAU,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAc,EAAE,CAAC;IACrQ,OAAO,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAsB,EAAE,UAAmB,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU;IACxG,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,aAAa,CAAC,kDAAkD,CAAC,CAAC;IAC7F,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC5C,IAAI,UAAU,KAAK,iBAAiB,CAAC,QAAQ,CAAC,IAAI,UAAU,KAAK,YAAY;QAAE,MAAM,IAAI,aAAa,CAAC,kDAAkD,CAAC,CAAC;IAC3J,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,kBAAkB,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,0DAA0D,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;AACvd,CAAC"}

package/dist/src/services/recovery.d.ts

@@ -0,0 +1,19 @@
+import type { RepositoryIdentity } from "../storage/repository-identity.js";
+export declare function recoveryInspection(identity: RepositoryIdentity, statePath: string): {
+    statePath: string;
+    health: {
+        valid: boolean;
+        lines: number;
+        invalidLines: number;
+    };
+    issue: import("../storage/migrations.js").JournalReadIssue | undefined;
+    validatedEntries: number;
+    resourceRegistry: string;
+    resources: {
+        resourceId: string;
+        path: string;
+        state: import("../storage/resources.js").ResourceState;
+        consumers: string[];
+        retentionPins: string[];
+    }[];
+};

package/dist/src/services/recovery.js

@@ -0,0 +1,9 @@
+import { inspectState, readJournal } from "../storage/migrations.js";
+import { resourceRegistryPath, loadResourceRegistry } from "../storage/resources.js";
+export function recoveryInspection(identity, statePath) {
+    const health = inspectState(statePath);
+    const journal = readJournal(statePath);
+    const resources = loadResourceRegistry(identity);
+    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 })) };
+}
+//# sourceMappingURL=recovery.js.map

package/dist/src/services/recovery.js.map

@@ -0,0 +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"}

package/dist/src/services/review.d.ts

@@ -0,0 +1,15 @@
+import type { ReviewSpec } from "../core/types.js";
+export interface ReviewFinding {
+    id: string;
+    severity: "low" | "medium" | "high";
+    summary: string;
+    criterionId?: string;
+    evidenceIds: string[];
+}
+export interface ReviewDecision {
+    outcome: "passed" | "blocked" | "advisory";
+    findings: ReviewFinding[];
+    repairAllowed: boolean;
+    reason: string;
+}
+export declare function evaluateReview(spec: ReviewSpec, findings: ReviewFinding[], deterministicFailure: boolean, repairAttempts: number, maxRepairAttempts: number): ReviewDecision;

package/dist/src/services/review.js

@@ -0,0 +1,9 @@
+export function evaluateReview(spec, findings, deterministicFailure, repairAttempts, maxRepairAttempts) {
+    if (deterministicFailure)
+        return { outcome: "blocked", findings, repairAllowed: repairAttempts < maxRepairAttempts, reason: "Deterministic acceptance failures cannot be overridden by review" };
+    const blocking = findings.some(finding => spec.severityPolicy === "block-any" || (spec.severityPolicy === "block-high" && finding.severity === "high"));
+    if (blocking)
+        return { outcome: "blocked", findings, repairAllowed: repairAttempts < maxRepairAttempts, reason: "Review contains unresolved findings under the admitted severity policy" };
+    return { outcome: spec.severityPolicy === "advisory" ? "advisory" : "passed", findings, repairAllowed: false, reason: "Review criteria satisfied" };
+}
+//# sourceMappingURL=review.js.map

package/dist/src/services/review.js.map

@@ -0,0 +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"}

package/dist/src/storage/journal-recovery.d.ts

@@ -0,0 +1,10 @@
+export interface JournalRecoveryReceipt {
+    path: string;
+    backupPath: string;
+    backupDigest: string;
+    salvagedLines: number;
+    issue: "torn-tail";
+    authorized: true;
+}
+/** Salvage only a provably incomplete final record after an explicit operator authorization. */
+export declare function recoverTornJournalTail(path: string, authorized: boolean): JournalRecoveryReceipt;

package/dist/src/storage/journal-recovery.js

@@ -0,0 +1,33 @@
+import { closeSync, copyFileSync, existsSync, fsyncSync, openSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { createHash, randomUUID } from "node:crypto";
+import { ContractError } from "../core/errors.js";
+import { readJournal } from "./migrations.js";
+/** Salvage only a provably incomplete final record after an explicit operator authorization. */
+export function recoverTornJournalTail(path, authorized) {
+    if (!authorized)
+        throw new ContractError("Journal recovery requires explicit authorization");
+    if (!existsSync(path))
+        throw new ContractError("Journal does not exist", { path });
+    const result = readJournal(path);
+    if (!result.issue || result.issue.kind !== "torn-tail")
+        throw new ContractError("Only a torn journal tail may be salvaged", { issue: result.issue?.kind ?? "none" });
+    const original = readFileSync(path);
+    const backupPath = `${path}.recovery-${randomUUID()}.bak`;
+    copyFileSync(path, backupPath);
+    const backupDigest = createHash("sha256").update(original).digest("hex");
+    const completeLines = original.toString("utf8").split("\n").slice(0, result.issue.line - 1).filter(Boolean);
+    const temporaryPath = `${path}.recovery-${randomUUID()}.tmp`;
+    writeFileSync(temporaryPath, completeLines.length ? `${completeLines.join("\n")}\n` : "", { mode: 0o600 });
+    const fd = openSync(temporaryPath, "r");
+    try {
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+    renameSync(temporaryPath, path);
+    if (readJournal(path).issue)
+        throw new ContractError("Recovered journal did not validate after replacement", { path });
+    return { path, backupPath, backupDigest, salvagedLines: completeLines.length, issue: "torn-tail", authorized: true };
+}
+//# sourceMappingURL=journal-recovery.js.map

package/dist/src/storage/journal-recovery.js.map

@@ -0,0 +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"}

package/dist/src/storage/journal.d.ts

@@ -0,0 +1,12 @@
+import type { JournalEntry, JournalEvent, StateSnapshot } from "../core/types.js";
+export declare class Journal {
+    readonly path: string;
+    private readonly lockPath;
+    constructor(path: string);
+    entries(): JournalEntry[];
+    snapshot(): StateSnapshot;
+    append(event: JournalEvent, idempotencyKey: string, expectedRevision?: number): JournalEntry;
+    create(run: import("../core/types.js").WorkflowRun): JournalEntry;
+    clear(): void;
+}
+export declare function memoryJournal(): Journal;

package/dist/src/storage/journal.js

@@ -0,0 +1,82 @@
+import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, unlinkSync, writeSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { dirname, join } from "node:path";
+import { ContractError, OwnershipError } from "../core/errors.js";
+import { replay } from "../core/recovery.js";
+import { ensureStateFile, readJournal, STATE_SCHEMA, checksumFor, MAX_JOURNAL_RECORD_BYTES } from "./migrations.js";
+export class Journal {
+    path;
+    lockPath;
+    constructor(path) { this.path = path; this.lockPath = join(dirname(path), ".state.lock"); ensureStateFile(path); }
+    entries() {
+        if (!existsSync(this.path))
+            return [];
+        const result = readJournal(this.path);
+        if (result.issue)
+            throw new ContractError("Journal requires explicit recovery before use", result.issue);
+        return result.entries;
+    }
+    snapshot() { return replay(this.entries()); }
+    append(event, idempotencyKey, expectedRevision) {
+        if (!idempotencyKey.trim())
+            throw new ContractError("Idempotency key is required");
+        mkdirSync(dirname(this.path), { recursive: true, mode: 0o700 });
+        let fd;
+        const lockOwner = randomUUID();
+        try {
+            try {
+                fd = openSync(this.lockPath, "wx", 0o600);
+            }
+            catch {
+                throw new OwnershipError("Journal is already being advanced by another owner");
+            }
+            writeSync(fd, lockOwner, undefined, "utf8");
+            fsyncSync(fd);
+            ensureStateFile(this.path);
+            const existingEntries = this.entries();
+            const existing = existingEntries.find(entry => entry.idempotencyKey === idempotencyKey);
+            if (existing) {
+                if (JSON.stringify(existing.event) !== JSON.stringify(event))
+                    throw new ContractError("Idempotency key conflicts with an existing event", { idempotencyKey });
+                return existing;
+            }
+            const current = replay(existingEntries);
+            if (event.type === "run.created" && current.run && !["complete", "failed", "cancelled"].includes(current.run.phase))
+                throw new ContractError("A non-terminal workflow run already exists");
+            if (expectedRevision !== undefined && current.revision !== expectedRevision)
+                throw new ContractError("Revision conflict", { expectedRevision, actualRevision: current.revision });
+            const entryWithoutChecksum = { sequence: current.lastSequence + 1, at: new Date().toISOString(), idempotencyKey, event, schema: STATE_SCHEMA, previousHash: existingEntries.at(-1)?.checksum ?? "GENESIS" };
+            const entry = { ...entryWithoutChecksum, checksum: checksumFor(entryWithoutChecksum) };
+            const serialized = `${JSON.stringify(entry)}\n`;
+            if (Buffer.byteLength(serialized) > MAX_JOURNAL_RECORD_BYTES)
+                throw new ContractError("Journal event exceeds the configured size limit", { bytes: Buffer.byteLength(serialized), limit: MAX_JOURNAL_RECORD_BYTES });
+            let stateFd;
+            try {
+                stateFd = openSync(this.path, "a", 0o600);
+                const bytes = Buffer.from(serialized, "utf8");
+                let offset = 0;
+                while (offset < bytes.length)
+                    offset += writeSync(stateFd, bytes, offset, bytes.length - offset);
+                fsyncSync(stateFd);
+            }
+            finally {
+                if (stateFd !== undefined)
+                    closeSync(stateFd);
+            }
+            return entry;
+        }
+        finally {
+            if (fd !== undefined)
+                closeSync(fd);
+            try {
+                if (existsSync(this.lockPath) && readFileSync(this.lockPath, "utf8") === lockOwner)
+                    unlinkSync(this.lockPath);
+            }
+            catch { /* A replacement lock belongs to another owner. */ }
+        }
+    }
+    create(run) { return this.append({ type: "run.created", run }, `run-created:${run.runId}`); }
+    clear() { throw new ContractError("Journal deletion is not a supported recovery operation"); }
+}
+export function memoryJournal() { return new Journal(join(process.cwd(), ".bizar-omp", "memory-state.jsonl")); }
+//# sourceMappingURL=journal.js.map

package/dist/src/storage/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../../src/storage/journal.ts"],"names":[],"mappings":"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"}

package/dist/src/storage/migrations.d.ts

@@ -0,0 +1,22 @@
+import type { JournalEntry } from "../core/types.js";
+export declare const LEGACY_STATE_SCHEMA = "bizar.omp.state.v1";
+export declare const STATE_SCHEMA = "bizar.omp.state.v2";
+export declare const MAX_JOURNAL_RECORD_BYTES: number;
+export type JournalReadIssue = {
+    kind: "torn-tail" | "corrupt";
+    line: number;
+    message: string;
+};
+export type JournalReadResult = {
+    entries: JournalEntry[];
+    issue?: JournalReadIssue;
+};
+export declare function checksumFor(entry: Omit<JournalEntry, "checksum">): string;
+export declare function readJournal(path: string): JournalReadResult;
+export declare function ensureStateFile(path: string): void;
+export declare function validateJournalLine(line: string): boolean;
+export declare function inspectState(path: string): {
+    valid: boolean;
+    lines: number;
+    invalidLines: number;
+};

package/dist/src/storage/migrations.js

@@ -0,0 +1,107 @@
+import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { dirname } from "node:path";
+import { ContractError } from "../core/errors.js";
+export const LEGACY_STATE_SCHEMA = "bizar.omp.state.v1";
+export const STATE_SCHEMA = "bizar.omp.state.v2";
+export const MAX_JOURNAL_RECORD_BYTES = 1024 * 1024;
+function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(",")}]`;
+    if (value && typeof value === "object")
+        return `{${Object.entries(value).filter(([, item]) => item !== undefined).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => `${JSON.stringify(key)}:${canonical(item)}`).join(",")}}`;
+    return value === undefined ? "null" : JSON.stringify(value);
+}
+export function checksumFor(entry) {
+    return createHash("sha256").update(canonical(entry)).digest("hex");
+}
+function isEvent(value) {
+    return Boolean(value && typeof value === "object" && typeof value.type === "string");
+}
+function parseEntry(value, line) {
+    if (!value || typeof value !== "object")
+        throw new ContractError("Journal record is not an object", { line });
+    const input = value;
+    if (input.schema !== STATE_SCHEMA && input.schema !== LEGACY_STATE_SCHEMA)
+        throw new ContractError("Journal schema is unsupported", { line, schema: input.schema });
+    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))
+        throw new ContractError("Journal record is malformed", { line });
+    if (input.schema === STATE_SCHEMA) {
+        if (typeof input.previousHash !== "string" || !/^[a-f0-9]{64}$|^GENESIS$/.test(input.previousHash) || typeof input.checksum !== "string" || !/^[a-f0-9]{64}$/.test(input.checksum))
+            throw new ContractError("Journal v2 integrity fields are malformed", { line });
+        const { checksum: _checksum, ...withoutChecksum } = input;
+        if (checksumFor(withoutChecksum) !== input.checksum)
+            throw new ContractError("Journal checksum mismatch", { line });
+    }
+    return input;
+}
+export function readJournal(path) {
+    if (!existsSync(path))
+        return { entries: [] };
+    const bytes = readFileSync(path);
+    if (bytes.length === 0)
+        return { entries: [] };
+    const text = bytes.toString("utf8");
+    const lines = text.split("\n");
+    const hasTornTail = !text.endsWith("\n");
+    const entries = [];
+    for (let index = 0; index < lines.length; index += 1) {
+        const raw = lines[index];
+        if (!raw)
+            continue;
+        if (Buffer.byteLength(raw) > MAX_JOURNAL_RECORD_BYTES)
+            return { entries, issue: { kind: "corrupt", line: index + 1, message: "Journal record exceeds the configured size limit" } };
+        try {
+            entries.push(parseEntry(JSON.parse(raw), index + 1));
+        }
+        catch (error) {
+            return { entries, issue: { kind: hasTornTail && index === lines.length - 1 ? "torn-tail" : "corrupt", line: index + 1, message: error instanceof Error ? error.message : String(error) } };
+        }
+    }
+    let previous = 0;
+    let previousHash = "GENESIS";
+    for (const entry of entries) {
+        if (entry.sequence !== previous + 1)
+            return { entries: entries.slice(0, previous), issue: { kind: "corrupt", line: entry.sequence, message: `Journal sequence expected ${previous + 1} but found ${entry.sequence}` } };
+        if (entry.schema === STATE_SCHEMA && entry.previousHash !== previousHash)
+            return { entries: entries.slice(0, previous), issue: { kind: "corrupt", line: entry.sequence, message: "Journal previous-record hash does not match" } };
+        previous = entry.sequence;
+        previousHash = entry.checksum ?? previousHash;
+    }
+    return { entries };
+}
+export function ensureStateFile(path) {
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    if (existsSync(path))
+        return;
+    let fd;
+    try {
+        fd = openSync(path, "wx", 0o600);
+        fsyncSync(fd);
+    }
+    catch (error) {
+        if (!existsSync(path))
+            throw error;
+    }
+    finally {
+        if (fd !== undefined)
+            closeSync(fd);
+    }
+}
+export function validateJournalLine(line) {
+    try {
+        parseEntry(JSON.parse(line), 1);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function inspectState(path) {
+    if (!existsSync(path))
+        return { valid: true, lines: 0, invalidLines: 0 };
+    const lines = readFileSync(path, "utf8").split("\n").filter(Boolean);
+    const result = readJournal(path);
+    return { valid: !result.issue, lines: lines.length, invalidLines: result.issue ? 1 : 0 };
+}
+//# sourceMappingURL=migrations.js.map

package/dist/src/storage/migrations.js.map

@@ -0,0 +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,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,GAAG,IAAI,CAAC;AAKpD,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACnQ,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAqC;IAC/D,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AAC/G,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,IAAY;IAC9C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9G,MAAM,KAAK,GAAG,KAAqD,CAAC;IACpE,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,IAAI,KAAK,CAAC,MAAM,KAAK,mBAAmB;QAAE,MAAM,IAAI,aAAa,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACpK,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,aAAa,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5R,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QAClC,IAAI,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,aAAa,CAAC,2CAA2C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACnQ,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,GAAG,KAA0C,CAAC;QAC/F,IAAI,WAAW,CAAC,eAAe,CAAC,KAAK,KAAK,CAAC,QAAQ;YAAE,MAAM,IAAI,aAAa,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACtH,CAAC;IACD,OAAO,KAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,wBAAwB;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,EAAE,kDAAkD,EAAE,EAAE,CAAC;QACpL,IAAI,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;QAC7D,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QAC7L,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,YAAY,GAAG,SAAS,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,GAAG,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,6BAA6B,QAAQ,GAAG,CAAC,cAAc,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC;QACxN,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,IAAI,KAAK,CAAC,YAAY,KAAK,YAAY;YAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,6CAA6C,EAAE,EAAE,CAAC;QACnO,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC1B,YAAY,GAAG,KAAK,CAAC,QAAQ,IAAI,YAAY,CAAC;IAChD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,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;QAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC/E,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,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3F,CAAC"}

package/dist/src/storage/repository-identity.d.ts

@@ -0,0 +1,11 @@
+export interface RepositoryIdentity {
+    root: string;
+    commonDir: string;
+    gitDir: string;
+    head: string;
+    id: string;
+}
+export declare function repositoryIdentity(cwd?: string): RepositoryIdentity;
+export declare function statePath(identity: RepositoryIdentity): string;
+export declare function workingTreeDigest(cwd?: string): string;
+export declare function isDirty(cwd?: string): boolean;

package/dist/src/storage/repository-identity.js

@@ -0,0 +1,67 @@
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { lstatSync, readFileSync, readlinkSync, realpathSync } from "node:fs";
+import { join, resolve } from "node:path";
+const gitText = (cwd, args) => execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+const gitBytes = (cwd, args) => execFileSync("git", args, { cwd, stdio: ["ignore", "pipe", "ignore"] });
+export function repositoryIdentity(cwd = process.cwd()) {
+    const root = realpathSync(gitText(cwd, ["rev-parse", "--show-toplevel"]));
+    const commonDir = resolve(root, gitText(root, ["rev-parse", "--git-common-dir"]));
+    const gitDir = resolve(root, gitText(root, ["rev-parse", "--git-dir"]));
+    let head = "unborn";
+    try {
+        head = gitText(root, ["rev-parse", "--verify", "HEAD"]);
+    }
+    catch { /* An unborn repository has no commit yet. */ }
+    const id = createHash("sha256").update(`${gitDir}\0${root}`).digest("hex").slice(0, 24);
+    return { root, commonDir, gitDir, head, id };
+}
+export function statePath(identity) { return join(identity.gitDir, "bizar", "omp-v1", "state.jsonl"); }
+function updateFramed(hash, value) {
+    const bytes = typeof value === "string" ? Buffer.from(value) : value;
+    const length = Buffer.allocUnsafe(8);
+    length.writeBigUInt64BE(BigInt(bytes.length));
+    hash.update(length).update(bytes);
+}
+function untrackedPaths(root) {
+    const output = gitBytes(root, ["ls-files", "--others", "--exclude-standard", "-z"]);
+    const paths = [];
+    let start = 0;
+    for (let index = 0; index < output.length; index += 1) {
+        if (output[index] !== 0)
+            continue;
+        paths.push(output.subarray(start, index));
+        start = index + 1;
+    }
+    if (start !== output.length)
+        throw new Error("Git returned an unterminated untracked path");
+    return paths;
+}
+export function workingTreeDigest(cwd = process.cwd()) {
+    const identity = repositoryIdentity(cwd);
+    const hash = createHash("sha256");
+    updateFramed(hash, identity.head);
+    updateFramed(hash, gitBytes(identity.root, ["diff", "--binary", "--no-ext-diff"]));
+    updateFramed(hash, gitBytes(identity.root, ["diff", "--cached", "--binary", "--no-ext-diff"]));
+    for (const relativePath of untrackedPaths(identity.root)) {
+        const path = Buffer.concat([Buffer.from(`${identity.root}/`), relativePath]);
+        const stat = lstatSync(path);
+        updateFramed(hash, relativePath);
+        if (stat.isSymbolicLink()) {
+            updateFramed(hash, "symlink");
+            updateFramed(hash, readlinkSync(path, "buffer"));
+        }
+        else if (stat.isFile()) {
+            updateFramed(hash, "file");
+            updateFramed(hash, readFileSync(path));
+        }
+        else {
+            updateFramed(hash, `unsupported:${stat.mode}`);
+        }
+    }
+    return hash.digest("hex");
+}
+export function isDirty(cwd = process.cwd()) {
+    return gitBytes(repositoryIdentity(cwd).root, ["status", "--porcelain=v1", "--untracked-files=all", "-z"]).length > 0;
+}
+//# sourceMappingURL=repository-identity.js.map

package/dist/src/storage/repository-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-identity.js","sourceRoot":"","sources":["../../../src/storage/repository-identity.ts"],"names":[],"mappings":"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"}

package/dist/src/storage/resources.d.ts

@@ -0,0 +1,66 @@
+import type { RepositoryIdentity } from "./repository-identity.js";
+export type ResourceState = "creation-intent" | "ready" | "in-use" | "quiescing" | "preservation-pending" | "retained" | "reclaimable" | "cleanup-intent" | "removed" | "creation-incomplete" | "cleanup-failed" | "missing" | "unavailable" | "ownership-unknown";
+export interface WorkspaceRecord {
+    resourceId: string;
+    revision: number;
+    repositoryId: string;
+    commonDir: string;
+    path: string;
+    physicalKind: "git-worktree" | "verification-directory";
+    backend: "git" | "host" | "unknown";
+    runId?: string;
+    workItemId?: string;
+    dispatchId?: string;
+    candidateId?: string;
+    owner: string;
+    ownerEpoch: number;
+    nativeSessionId?: string;
+    nativeJobId?: string;
+    baseRef: string;
+    expectedHead?: string;
+    observedHead?: string;
+    createdAt: string;
+    lastObservedAt: string;
+    state: ResourceState;
+    consumers: string[];
+    retentionPins: string[];
+    retentionReason?: string;
+    disposable: boolean;
+    cleanupAttempts: number;
+    lastError?: string;
+}
+export interface RepositoryResourceRegistry {
+    schemaVersion: 1;
+    repositoryId: string;
+    commonDir: string;
+    revision: number;
+    resources: WorkspaceRecord[];
+    updatedAt: string;
+}
+export interface CleanupPreview {
+    resourceId: string;
+    allowed: boolean;
+    reasons: string[];
+    path: string;
+    state: ResourceState;
+    observed: {
+        exists: boolean;
+        dirty: boolean;
+        ignored: boolean;
+        registered: boolean;
+    };
+}
+export declare function resourceRegistryPath(identity: RepositoryIdentity): string;
+export declare function loadResourceRegistry(identity: RepositoryIdentity): RepositoryResourceRegistry;
+export declare function saveResourceRegistry(identity: RepositoryIdentity, registry: RepositoryResourceRegistry, expectedRevision?: number): RepositoryResourceRegistry;
+export declare function registerWorkspace(identity: RepositoryIdentity, input: Omit<WorkspaceRecord, "resourceId" | "revision" | "repositoryId" | "commonDir" | "createdAt" | "lastObservedAt" | "state" | "cleanupAttempts">): WorkspaceRecord;
+export declare function updateWorkspace(identity: RepositoryIdentity, resourceId: string, update: Partial<Pick<WorkspaceRecord, "state" | "ownerEpoch" | "observedHead" | "lastObservedAt" | "consumers" | "retentionPins" | "retentionReason" | "lastError" | "cleanupAttempts">>, expectedRevision?: number): WorkspaceRecord;
+export declare function previewWorkspaceCleanup(identity: RepositoryIdentity, resourceId: string): CleanupPreview;
+export declare function createDetachedWorkspace(identity: RepositoryIdentity, input: Omit<WorkspaceRecord, "resourceId" | "revision" | "repositoryId" | "commonDir" | "createdAt" | "lastObservedAt" | "state" | "cleanupAttempts" | "path"> & {
+    path?: string;
+}): WorkspaceRecord;
+export declare function cleanupWorkspace(identity: RepositoryIdentity, resourceId: string, authorize?: boolean): {
+    state: ResourceState;
+    reasons: string[];
+};
+export declare function resourceDigest(resource: WorkspaceRecord): string;