@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/pactile/migration/legacy-task-held-source-reader.js

@@ -0,0 +1,261 @@
+/** Read the original files for one still-held P36 import without activating it. */
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { scanLegacyTaskMigration } from "../../core/task/legacy-task-migration.js";
+import { readLegacyTaskImportRecord, readLegacyTaskMigrationView, } from "../../core/task/legacy-task-migration-reader.js";
+const TASKS_ROOT = ".pactile/tasks";
+const SOURCE_PATH_PREFIX = `${TASKS_ROOT}/`;
+const FINGERPRINT = /^sha256:[a-f0-9]{64}$/;
+const MAX_FILES = 512;
+const MAX_FILE_BYTES = 2 * 1024 * 1024;
+const MAX_TOTAL_BYTES = 16 * 1024 * 1024;
+const MAX_SOURCE_FILE_FACTS = 32_768;
+const MAX_DIRECTORY_DEPTH = 32;
+function validRelativePath(value) {
+    if (!value ||
+        value.length > 4096 ||
+        value.includes("\\") ||
+        path.posix.isAbsolute(value) ||
+        path.win32.isAbsolute(value) ||
+        /^[A-Za-z]:/.test(value)) {
+        return false;
+    }
+    return value
+        .split("/")
+        .every((part) => part !== "" && part !== "." && part !== ".." && part.length <= 255);
+}
+function heldTaskRelativePath(value) {
+    const relative = value.startsWith(`${SOURCE_PATH_PREFIX}`)
+        ? value.slice(SOURCE_PATH_PREFIX.length)
+        : value;
+    const parts = relative.split("/");
+    const archived = parts[0]?.toLowerCase() === "archive";
+    if (!validRelativePath(relative) ||
+        relative.length > 2048 ||
+        parts.length > 32 ||
+        parts.some((part, index) => part.toLowerCase() === "archive" && !(archived && index === 0))) {
+        throw new Error("legacy-task-held-history-path-invalid");
+    }
+    return relative;
+}
+function assertRealTaskDirectory(root, relative) {
+    let cursor = path.resolve(root);
+    try {
+        const rootStat = fs.lstatSync(cursor);
+        if (!rootStat.isDirectory() || rootStat.isSymbolicLink()) {
+            throw new Error("legacy-task-held-history-directory-invalid");
+        }
+        for (const part of [".pactile", "tasks", ...relative.split("/")]) {
+            cursor = path.join(cursor, part);
+            const stat = fs.lstatSync(cursor);
+            if (stat.isSymbolicLink()) {
+                throw new Error("legacy-task-held-history-link-invalid");
+            }
+            if (!stat.isDirectory()) {
+                throw new Error("legacy-task-held-history-directory-invalid");
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            error.message.startsWith("legacy-task-held-history-")) {
+            throw error;
+        }
+        if (error.code === "ENOENT") {
+            throw new Error("legacy-task-held-history-path-missing");
+        }
+        throw error;
+    }
+    return cursor;
+}
+function utf8OrBase64(bytes) {
+    const text = bytes.toString("utf8");
+    return Buffer.from(text, "utf8").equals(bytes)
+        ? { encoding: "utf8", content: text }
+        : { encoding: "base64", content: bytes.toString("base64") };
+}
+function fingerprint(bytes) {
+    return `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
+}
+function readHeldTaskFiles(taskDir, relativeTaskPath, sourceFacts) {
+    if (sourceFacts.length > MAX_FILES) {
+        throw new Error("legacy-task-held-history-size-limit-exceeded");
+    }
+    const files = [];
+    let totalBytes = 0;
+    const sourcePrefix = `${TASKS_ROOT}/${relativeTaskPath}/`;
+    for (const fact of sourceFacts) {
+        if (!fact.path.startsWith(sourcePrefix) || !validRelativePath(fact.path)) {
+            throw new Error("legacy-task-held-history-record-invalid");
+        }
+        const relativeFilePath = fact.path.slice(sourcePrefix.length);
+        const parts = relativeFilePath.split("/");
+        if (!validRelativePath(relativeFilePath) ||
+            parts.length - 1 > MAX_DIRECTORY_DEPTH) {
+            throw new Error("legacy-task-held-history-path-invalid");
+        }
+        let cursor = taskDir;
+        for (const part of parts.slice(0, -1)) {
+            cursor = path.join(cursor, part);
+            const directoryStat = fs.lstatSync(cursor);
+            if (directoryStat.isSymbolicLink()) {
+                throw new Error("legacy-task-held-history-link-invalid");
+            }
+            if (!directoryStat.isDirectory()) {
+                throw new Error("legacy-task-held-history-directory-invalid");
+            }
+        }
+        const file = path.join(cursor, parts.at(-1) ?? "");
+        const stat = fs.lstatSync(file);
+        if (stat.isSymbolicLink()) {
+            throw new Error("legacy-task-held-history-link-invalid");
+        }
+        if (!stat.isFile() || stat.nlink !== 1) {
+            throw new Error("legacy-task-held-history-file-invalid");
+        }
+        if (stat.size > MAX_FILE_BYTES) {
+            throw new Error("legacy-task-held-history-size-limit-exceeded");
+        }
+        totalBytes += stat.size;
+        if (totalBytes > MAX_TOTAL_BYTES) {
+            throw new Error("legacy-task-held-history-size-limit-exceeded");
+        }
+        const bytes = fs.readFileSync(file);
+        const afterRead = fs.lstatSync(file);
+        if (!afterRead.isFile() ||
+            afterRead.isSymbolicLink() ||
+            afterRead.nlink !== 1 ||
+            afterRead.dev !== stat.dev ||
+            afterRead.ino !== stat.ino ||
+            bytes.byteLength !== stat.size) {
+            throw new Error("legacy-task-held-history-file-changed-during-read");
+        }
+        const sha256 = fingerprint(bytes);
+        if (sha256 !== fact.fingerprint) {
+            throw new Error("legacy-task-held-history-source-stale");
+        }
+        files.push({
+            path: fact.path,
+            byteLength: bytes.byteLength,
+            sha256,
+            ...utf8OrBase64(bytes),
+        });
+    }
+    return files.sort((left, right) => left.path.localeCompare(right.path));
+}
+function migrationSourceFacts(record) {
+    if (!Array.isArray(record.sourceFiles) ||
+        record.sourceFiles.length > MAX_SOURCE_FILE_FACTS) {
+        throw new Error("legacy-task-held-history-record-invalid");
+    }
+    const seen = new Set();
+    const facts = record.sourceFiles.map((item) => {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+            throw new Error("legacy-task-held-history-record-invalid");
+        }
+        const value = item;
+        if (typeof value.path !== "string" ||
+            !validRelativePath(value.path) ||
+            !value.path.startsWith(SOURCE_PATH_PREFIX) ||
+            typeof value.fingerprint !== "string" ||
+            !FINGERPRINT.test(value.fingerprint) ||
+            seen.has(value.path)) {
+            throw new Error("legacy-task-held-history-record-invalid");
+        }
+        seen.add(value.path);
+        return { path: value.path, fingerprint: value.fingerprint };
+    });
+    return facts.sort((left, right) => left.path.localeCompare(right.path));
+}
+function sameFacts(left, right) {
+    return (left.length === right.length &&
+        left.every((item, index) => item.path === right[index]?.path &&
+            item.fingerprint === right[index]?.fingerprint));
+}
+/** Read one current Task only when its committed P36 record is still held and its source is unchanged. */
+export function readLegacyTaskHeldSource(projectRoot, taskPath) {
+    const root = path.resolve(projectRoot);
+    const relative = heldTaskRelativePath(taskPath);
+    const taskDir = assertRealTaskDirectory(root, relative);
+    const canonicalTaskPath = `${TASKS_ROOT}/${relative}`;
+    const view = readLegacyTaskMigrationView(root);
+    if (!view) {
+        throw new Error("legacy-task-held-history-migration-authority-missing");
+    }
+    const recordPath = `${canonicalTaskPath}/legacy-import.json`;
+    const baseRecord = view.baseFiles.get(recordPath);
+    const activeRecord = view.files.get(recordPath);
+    if (!baseRecord || !activeRecord?.bytes.equals(baseRecord.bytes)) {
+        throw new Error("legacy-task-held-history-record-not-base-import");
+    }
+    const record = readLegacyTaskImportRecord(root, taskDir, view);
+    if (!record) {
+        throw new Error("legacy-task-held-history-record-missing");
+    }
+    if (record.taskPath !== canonicalTaskPath ||
+        (record.status !== "needs-definition" &&
+            record.status !== "needs-coordination" &&
+            record.status !== "archived-historical-only")) {
+        throw new Error("legacy-task-held-history-task-not-held");
+    }
+    if (record.sourceFingerprint !== view.authority.sourceFingerprint) {
+        throw new Error("legacy-task-held-history-authority-stale");
+    }
+    const prefix = `${canonicalTaskPath}/`;
+    const expectedFacts = migrationSourceFacts(record).filter((fact) => fact.path.startsWith(prefix));
+    if (!expectedFacts.some((fact) => fact.path === `${prefix}task.json`) ||
+        expectedFacts.length > MAX_FILES ||
+        !expectedFacts.length) {
+        throw new Error("legacy-task-held-history-source-stale");
+    }
+    const plan = scanLegacyTaskMigration({ projectRoot: root });
+    const scannedTask = plan.tasks.find((task) => task.directory === canonicalTaskPath);
+    const scannedFacts = scannedTask?.files
+        .map((file) => ({ path: file.path, fingerprint: file.sha256 }))
+        .sort((left, right) => left.path.localeCompare(right.path));
+    if (plan.findings.some((finding) => finding.code === "source-symlink-skipped")) {
+        throw new Error("legacy-task-held-history-link-invalid");
+    }
+    if (!scannedTask ||
+        scannedTask?.archivedByPath !==
+            (record.status === "archived-historical-only") ||
+        scannedTask.preflight !== "clear-to-review" ||
+        !scannedTask.sourceFingerprint ||
+        !scannedFacts ||
+        !sameFacts(expectedFacts, scannedFacts)) {
+        throw new Error("legacy-task-held-history-source-stale");
+    }
+    if (plan.preflight.status !== "clear-to-review" ||
+        plan.sourceFingerprint !== view.authority.sourceFingerprint) {
+        throw new Error("legacy-task-held-history-authority-stale");
+    }
+    const files = readHeldTaskFiles(taskDir, relative, scannedFacts);
+    const actualFacts = files.map(({ path: filePath, sha256 }) => ({
+        path: filePath,
+        fingerprint: sha256,
+    }));
+    if (!sameFacts(scannedFacts, actualFacts)) {
+        throw new Error("legacy-task-held-history-source-stale");
+    }
+    return {
+        taskPath: canonicalTaskPath,
+        status: "held-source-read-only",
+        migrationStatus: record.status,
+        legacyTaskId: record.legacyTaskId,
+        archived: record.status === "archived-historical-only",
+        missingDefinitionFields: record.missingDefinitionFields,
+        coordinationReasons: record.coordinationReasons,
+        runnable: false,
+        lifecyclePolicy: "source-only-no-v2-run-review-or-close",
+        sourceFingerprint: view.authority.sourceFingerprint,
+        ...(record.legacySourceMetadata
+            ? { legacySourceMetadata: record.legacySourceMetadata }
+            : {}),
+        ...(record.legacyHistoryDiagnostics
+            ? { legacyHistoryDiagnostics: record.legacyHistoryDiagnostics }
+            : {}),
+        files,
+    };
+}
+//# sourceMappingURL=legacy-task-held-source-reader.js.map

package/dist/pactile/migration/legacy-task-held-source-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-task-held-source-reader.js","sourceRoot":"","sources":["../../../src/pactile/migration/legacy-task-held-source-reader.ts"],"names":[],"mappings":"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"}

package/dist/pactile/migration/legacy-task-reconciliation.d.ts

@@ -0,0 +1,46 @@
+/** Explicit, append-only completion of a held P36 legacy import. */
+import { type LegacyTaskV2ReconciliationInput } from "../../core/task/legacy-task-v2-import.js";
+import { type LegacyTaskMigrationPlan } from "../../core/task/legacy-task-migration.js";
+type ReconciliationPhase = "generation-staged" | "authority-written" | "authority-committed";
+export interface LegacyTaskReconciliationRequest {
+    readonly projectRoot: string;
+    readonly plan: LegacyTaskMigrationPlan;
+    readonly input: LegacyTaskV2ReconciliationInput;
+}
+export interface LegacyTaskReconciliationOptions {
+    readonly approved?: boolean;
+    readonly dryRun?: boolean;
+    readonly cancelled?: boolean;
+    readonly occurredAt?: string;
+    readonly onPhase?: (phase: ReconciliationPhase) => void | Promise<void>;
+}
+export type LegacyTaskReconciliationResult = {
+    readonly status: "dry-run" | "cancelled";
+    readonly taskPath: string;
+    readonly requestFingerprint: string;
+    readonly wrote: false;
+    readonly visible: false;
+} | {
+    readonly status: "completed";
+    readonly taskPath: string;
+    readonly generationId: string;
+    readonly requestFingerprint: string;
+    readonly resumed: boolean;
+    readonly wrote: boolean;
+    readonly visible: true;
+} | {
+    readonly status: "blocked" | "interrupted";
+    readonly taskPath: string;
+    readonly reason: string;
+    readonly requestFingerprint: string | null;
+    readonly wrote: boolean;
+    readonly visible: false | true;
+};
+/**
+ * Activate exactly one previously held legacy Task through an immutable
+ * secondary generation and pointer. The original P36 authority and overlays
+ * remain byte-for-byte unchanged.
+ */
+export declare function runLegacyTaskReconciliation(request: LegacyTaskReconciliationRequest, options?: LegacyTaskReconciliationOptions): Promise<LegacyTaskReconciliationResult>;
+export {};
+//# sourceMappingURL=legacy-task-reconciliation.d.ts.map

package/dist/pactile/migration/legacy-task-reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-task-reconciliation.d.ts","sourceRoot":"","sources":["../../../src/pactile/migration/legacy-task-reconciliation.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAKpE,OAAO,EAAmC,KAAK,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AACjI,OAAO,EAA2B,KAAK,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAsCjH,KAAK,mBAAmB,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;AAE7F,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,+BAA+B,CAAC;CACjD;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,MAAM,MAAM,8BAA8B,GACtC;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;CACxB,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;CAChC,CAAC;AAmbN;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,+BAA+B,EACxC,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,8BAA8B,CAAC,CAkQzC"}