@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/pactile/scheduler/project-lease-store.d.ts

@@ -0,0 +1,35 @@
+export interface ProjectWriteLeaseRecordV1 {
+    id: string;
+    pid?: number;
+    child_pid?: number;
+    durable?: boolean;
+    owner_kind?: "parent-child" | "task-kernel-v2-run";
+    parent?: string;
+    child?: string;
+    task_id?: string;
+    run_id?: string;
+    schedule_receipt_fingerprint?: string;
+    touches: string[];
+    authorized_conflicts?: {
+        taskIds: readonly [string, string];
+        approvedBy: string;
+        authorizationRef: string;
+        integrationOwner?: string;
+        integrationPlan: string;
+    }[];
+    [key: string]: unknown;
+}
+export interface LocatedProjectWriteLeaseV1 {
+    file: string;
+    lease: ProjectWriteLeaseRecordV1;
+}
+/** Serializes all P37 active-writer admission decisions for one project root. */
+export declare function withProjectSchedulerMutex<T>(rootValue: string, action: () => T): T;
+/** Reads both legacy Parent lease folders and the V2 project-level lease folder. Call under withProjectSchedulerMutex. */
+export declare function listProjectWriteLeases(rootValue: string): LocatedProjectWriteLeaseV1[];
+/** Canonicalizes concrete project-relative writes. Missing scope is a wildcard. */
+export declare function normalizeProjectWriteSet(values: readonly string[] | null | undefined): string[];
+export declare function projectWriteSetsConflict(left: readonly string[], right: readonly string[]): boolean;
+export declare function projectActiveLeasePath(rootValue: string, leaseId: string): string;
+export declare function projectLeaseHistoryPath(rootValue: string, leaseId: string): string;
+//# sourceMappingURL=project-lease-store.d.ts.map

package/dist/pactile/scheduler/project-lease-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-lease-store.d.ts","sourceRoot":"","sources":["../../../src/pactile/scheduler/project-lease-store.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,cAAc,GAAG,oBAAoB,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB,CAAC,EAAE;QACrB,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;KACzB,EAAE,CAAC;IACJ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,yBAAyB,CAAC;CAClC;AAgBD,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,GACd,CAAC,CAwDH;AAsBD,0HAA0H;AAC1H,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAChB,0BAA0B,EAAE,CAwC9B;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAC3C,MAAM,EAAE,CA0CV;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAaT;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,CAgBR;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,CAgBR"}

package/dist/pactile/scheduler/project-lease-store.js

@@ -0,0 +1,189 @@
+import fs from "node:fs";
+import path from "node:path";
+function alive(pid) {
+    if (!Number.isInteger(pid) || Number(pid) <= 0)
+        return false;
+    try {
+        process.kill(Number(pid), 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function waitBriefly() {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 10);
+}
+/** Serializes all P37 active-writer admission decisions for one project root. */
+export function withProjectSchedulerMutex(rootValue, action) {
+    const root = path.resolve(rootValue);
+    const mutex = path.join(root, ".pactile", ".runtime", "scheduler", "project-mutex");
+    fs.mkdirSync(path.dirname(mutex), { recursive: true });
+    let acquired = false;
+    for (let attempt = 0; attempt < 200; attempt += 1) {
+        try {
+            fs.mkdirSync(mutex);
+            acquired = true;
+            break;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            const ownerFile = path.join(mutex, "owner.json");
+            let owner = {};
+            let modifiedAt = Date.now();
+            try {
+                owner = JSON.parse(fs.readFileSync(ownerFile, "utf8"));
+                modifiedAt = fs.statSync(mutex).mtimeMs;
+            }
+            catch {
+                try {
+                    modifiedAt = fs.statSync(mutex).mtimeMs;
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (!alive(owner.pid) && Date.now() - modifiedAt > 5_000) {
+                fs.rmSync(ownerFile, { force: true });
+                try {
+                    fs.rmdirSync(mutex);
+                }
+                catch {
+                    /* Another process took the expired mutex. */
+                }
+            }
+            if (attempt === 199)
+                throw new Error("Project scheduler lock timed out");
+            waitBriefly();
+        }
+    }
+    if (!acquired)
+        throw new Error("Project scheduler lock timed out");
+    const ownerFile = path.join(mutex, "owner.json");
+    try {
+        fs.writeFileSync(ownerFile, JSON.stringify({ pid: process.pid }), {
+            mode: 0o600,
+        });
+        return action();
+    }
+    finally {
+        fs.rmSync(ownerFile, { force: true });
+        fs.rmdirSync(mutex);
+    }
+}
+function readLease(file) {
+    const value = JSON.parse(fs.readFileSync(file, "utf8"));
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`Invalid project write lease: ${file}`);
+    const lease = value;
+    if (typeof lease.id !== "string" ||
+        !lease.id ||
+        !Array.isArray(lease.touches) ||
+        lease.touches.some((touch) => typeof touch !== "string")) {
+        throw new Error(`Invalid project write lease: ${file}`);
+    }
+    // Normalize legacy leases in memory so older casing/path forms cannot bypass
+    // conflicts with newly admitted writers. An empty legacy scope is unknown,
+    // so normalizeProjectWriteSet conservatively treats it as a project-wide
+    // write. Do not rewrite the persisted compatibility record.
+    return { ...lease, touches: normalizeProjectWriteSet(lease.touches) };
+}
+/** Reads both legacy Parent lease folders and the V2 project-level lease folder. Call under withProjectSchedulerMutex. */
+export function listProjectWriteLeases(rootValue) {
+    const root = path.resolve(rootValue);
+    const folders = [];
+    const tasksRoot = path.join(root, ".pactile", "tasks");
+    if (fs.existsSync(tasksRoot)) {
+        for (const entry of fs.readdirSync(tasksRoot, { withFileTypes: true })) {
+            if (!entry.isDirectory() ||
+                ["archive", "locale", "templates"].includes(entry.name))
+                continue;
+            const folder = path.join(tasksRoot, entry.name, "parallel", "active");
+            if (fs.existsSync(folder))
+                folders.push(folder);
+        }
+    }
+    const projectActive = path.join(root, ".pactile", ".runtime", "scheduler", "active");
+    if (fs.existsSync(projectActive))
+        folders.push(projectActive);
+    const leases = [];
+    for (const folder of folders.sort()) {
+        for (const name of fs
+            .readdirSync(folder)
+            .filter((entry) => entry.endsWith(".json"))
+            .sort()) {
+            const file = path.join(folder, name);
+            const lease = readLease(file);
+            if (!lease.durable && !alive(lease.pid) && !alive(lease.child_pid)) {
+                fs.rmSync(file, { force: true });
+                continue;
+            }
+            leases.push({ file, lease });
+        }
+    }
+    return leases;
+}
+/** Canonicalizes concrete project-relative writes. Missing scope is a wildcard. */
+export function normalizeProjectWriteSet(values) {
+    if (!values?.length)
+        return ["*"];
+    if (values.length === 1 && values[0] === "*")
+        return ["*"];
+    return [
+        ...new Set(values.map((value) => {
+            if (typeof value !== "string")
+                throw new Error("write set must contain paths");
+            const original = value.trim();
+            const normalized = original
+                .replaceAll("\\", "/")
+                .replace(/^\.\//, "")
+                .replace(/\/$/, "")
+                .normalize("NFC");
+            const segments = normalized.split("/");
+            const hasWindowsAlternateDataStream = process.platform === "win32" &&
+                segments.some((segment) => segment.includes(":"));
+            if (!normalized ||
+                normalized === "." ||
+                normalized.startsWith("/") ||
+                /^[A-Za-z]:/.test(normalized) ||
+                hasWindowsAlternateDataStream ||
+                normalized.includes("*") ||
+                normalized.includes("?") ||
+                normalized.includes("[") ||
+                normalized.includes("]") ||
+                segments.some((segment) => !segment || segment === "." || segment === "..")) {
+                throw new Error(`write set must contain concrete project-relative paths: ${value}`);
+            }
+            return process.platform === "win32"
+                ? normalized.toLowerCase()
+                : normalized;
+        })),
+    ].sort();
+}
+export function projectWriteSetsConflict(left, right) {
+    const normalizedLeft = normalizeProjectWriteSet(left);
+    const normalizedRight = normalizeProjectWriteSet(right);
+    return normalizedLeft.some((a) => normalizedRight.some((b) => a === "*" ||
+        b === "*" ||
+        a === b ||
+        a.startsWith(`${b}/`) ||
+        b.startsWith(`${a}/`)));
+}
+export function projectActiveLeasePath(rootValue, leaseId) {
+    if (!leaseId ||
+        path.basename(leaseId) !== leaseId ||
+        leaseId.includes("/") ||
+        leaseId.includes("\\"))
+        throw new Error("Invalid project write lease ID");
+    return path.join(path.resolve(rootValue), ".pactile", ".runtime", "scheduler", "active", `${leaseId}.json`);
+}
+export function projectLeaseHistoryPath(rootValue, leaseId) {
+    if (!leaseId ||
+        path.basename(leaseId) !== leaseId ||
+        leaseId.includes("/") ||
+        leaseId.includes("\\"))
+        throw new Error("Invalid project write lease ID");
+    return path.join(path.resolve(rootValue), ".pactile", ".runtime", "scheduler", "lease-history", `${leaseId}.json`);
+}
+//# sourceMappingURL=project-lease-store.js.map

package/dist/pactile/scheduler/project-lease-store.js.map

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

package/dist/pactile/scheduler/scheduler.d.ts

@@ -0,0 +1,91 @@
+export type SchedulerTaskStateV1 = "waiting" | "running" | "completed" | "failed" | "blocked";
+export interface SchedulerCostVectorV1 {
+    latencyMs: number;
+    waitingMs: number;
+    executionMs: number;
+    integrationMs: number;
+    reworkMs: number;
+    reviewMs: number;
+}
+export interface SchedulerTaskV1 {
+    taskId: string;
+    dependsOn: readonly string[];
+    state: SchedulerTaskStateV1;
+    /** null means the task's write scope is unknown and conflicts with every writer. */
+    writeSet: readonly string[] | null;
+    estimatedCosts: SchedulerCostVectorV1;
+    observedCosts?: Partial<SchedulerCostVectorV1>;
+}
+export interface ConflictParallelAuthorizationV1 {
+    taskIds: readonly [string, string];
+    approvedBy: string;
+    authorizationRef: string;
+    /** Person or role accountable for integrating explicitly parallelized writers. */
+    integrationOwner: string;
+    integrationPlan: string;
+}
+export interface JevSchedulerAdviceV1 {
+    /** Earlier entries are preferred only when critical-path costs tie. */
+    taskOrder: readonly string[];
+    evidenceRef: string;
+}
+export interface TaskScheduleRequestV1 {
+    schemaVersion: 1;
+    tasks: readonly SchedulerTaskV1[];
+    conflictParallelizations?: readonly ConflictParallelAuthorizationV1[];
+    jevAdvice?: JevSchedulerAdviceV1;
+}
+export type SchedulerErrorCodeV1 = "invalid-request" | "duplicate-task" | "missing-dependency" | "dependency-cycle" | "invalid-cost" | "invalid-write-set" | "invalid-conflict-authorization";
+export declare class TaskScheduleError extends Error {
+    readonly code: SchedulerErrorCodeV1;
+    constructor(code: SchedulerErrorCodeV1, message: string);
+}
+export type SchedulerTaskActionV1 = "scheduled" | "completed" | "in-flight" | "failed" | "blocked" | "deferred";
+export interface SchedulerTaskDecisionV1 {
+    taskId: string;
+    action: SchedulerTaskActionV1;
+    reasonCodes: string[];
+    criticalPathMs: number;
+    estimatedCostMs: number;
+    estimatedCosts: SchedulerCostVectorV1;
+    /** All fields are returned so a receipt can be stored without losing absent measurements. */
+    observedCosts: Record<keyof SchedulerCostVectorV1, number | null>;
+    jevHintRank: number | null;
+    jevHintApplied: boolean;
+    wave: number | null;
+}
+export interface TaskScheduleWaveV1 {
+    sequence: number;
+    taskIds: string[];
+    candidateTaskIds: string[];
+    startedAfterMs: number;
+    estimatedDurationMs: number;
+    estimatedCompletionMs: number;
+    serialEquivalentMs: number;
+    estimatedSavingsMs: number;
+    candidateSerialEquivalentMs: number;
+    candidateParallelDurationMs: number;
+    candidateEstimatedSavingsMs: number;
+    decision: "single-ready-task" | "parallel-time-saved" | "parallelism-rejected-no-time-saved";
+    conflictAuthorizations: ConflictParallelAuthorizationV1[];
+}
+export interface TaskScheduleReceiptV1 {
+    schemaVersion: 1;
+    decisions: SchedulerTaskDecisionV1[];
+    waves: TaskScheduleWaveV1[];
+    serialEstimatedCompletionMs: number;
+    plannedEstimatedCompletionMs: number;
+    estimatedCompletionSavingsMs: number;
+    jevAdvice: null | {
+        evidenceRef: string;
+        hintedTaskIds: string[];
+        tieBreakAppliedTaskIds: string[];
+        ignoredTaskIds: string[];
+    };
+}
+/**
+ * Produces a deterministic schedule receipt from a Task DAG snapshot. It never
+ * starts, approves, integrates, or reviews a Run; callers own those side effects.
+ */
+export declare function planTaskScheduleV1(input: TaskScheduleRequestV1): TaskScheduleReceiptV1;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/pactile/scheduler/scheduler.d.ts.map

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