@blxzer/pactile 0.5.0

package/dist/pactile/lifecycle/legacy-import.js

@@ -0,0 +1,228 @@
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { fingerprintBytes } from "../projection/planner.js";
+const CONTROL_METADATA = new Set([
+    ".template-hashes.json",
+    ".version",
+    ".p36-wave-c.json",
+]);
+const GENERATION_EXCLUDED = [
+    "runtime/",
+    "tasks/",
+    "workspace/",
+    "spec/",
+    "middleware/",
+];
+function relativePosix(root, target) {
+    const relative = path.relative(root, target).split(path.sep).join("/");
+    if (!relative ||
+        relative === ".." ||
+        relative.startsWith("../") ||
+        path.isAbsolute(relative))
+        throw new Error("legacy-import-path-escape");
+    return relative;
+}
+function assertSafeEntry(target) {
+    const stat = fs.lstatSync(target);
+    if (stat.isSymbolicLink() || (!stat.isDirectory() && !stat.isFile()))
+        throw new Error("legacy-import-source-unsafe");
+    if (stat.isFile() && stat.nlink !== 1)
+        throw new Error("legacy-import-source-unsafe");
+    return stat;
+}
+function skippedControlPath(relativePath) {
+    return (CONTROL_METADATA.has(relativePath) ||
+        relativePath === "runtime" ||
+        relativePath.startsWith("runtime/") ||
+        relativePath === "local/cursor2plus" ||
+        relativePath.startsWith("local/cursor2plus/") ||
+        relativePath.split("/").some((part) => part.startsWith(".backup-")));
+}
+/**
+ * Copy an explicitly selected `.cstl` tree into a new canonical root without
+ * mutating the source or following links. Runtime/control metadata is rebuilt
+ * by Pactile and retired Cursor++ payloads stay only in the read-only source.
+ */
+export function prepareLegacyCstlImport(projectRoot, destinationProjectRoot = projectRoot) {
+    const sourceRoot = path.join(projectRoot, ".cstl");
+    const targetRoot = path.join(destinationProjectRoot, ".pactile");
+    if (!fs.existsSync(sourceRoot) || !assertSafeEntry(sourceRoot).isDirectory())
+        throw new Error("legacy-cstl-source-required");
+    if (fs.existsSync(targetRoot))
+        throw new Error("canonical-root-already-present");
+    if (!fs.statSync(destinationProjectRoot).isDirectory())
+        throw new Error("legacy-import-destination-required");
+    const directories = [];
+    const files = [];
+    const inspect = (sourceDirectory) => {
+        for (const name of fs.readdirSync(sourceDirectory).sort()) {
+            const source = path.join(sourceDirectory, name);
+            const relativePath = relativePosix(sourceRoot, source);
+            const stat = assertSafeEntry(source);
+            if (skippedControlPath(relativePath))
+                continue;
+            if (stat.isDirectory()) {
+                directories.push(relativePath);
+                inspect(source);
+                continue;
+            }
+            files.push({ source, relativePath });
+        }
+    };
+    inspect(sourceRoot);
+    fs.mkdirSync(targetRoot);
+    try {
+        for (const relativePath of directories.sort())
+            fs.mkdirSync(path.join(targetRoot, ...relativePath.split("/")), {
+                recursive: true,
+            });
+        for (const file of files.sort((left, right) => left.relativePath < right.relativePath
+            ? -1
+            : left.relativePath > right.relativePath
+                ? 1
+                : 0)) {
+            const target = path.join(targetRoot, ...file.relativePath.split("/"));
+            fs.mkdirSync(path.dirname(target), { recursive: true });
+            fs.copyFileSync(file.source, target, fs.constants.COPYFILE_EXCL);
+        }
+        return files.map((file) => file.relativePath);
+    }
+    catch (error) {
+        fs.rmSync(targetRoot, { recursive: true, force: true });
+        throw error;
+    }
+}
+function generationEligible(relativePath) {
+    return (relativePath !== ".developer" &&
+        relativePath !== ".current-task" &&
+        !GENERATION_EXCLUDED.some((prefix) => relativePath === prefix.slice(0, -1) || relativePath.startsWith(prefix)));
+}
+/** Build the strict B2 legacy migration payload from the still-read-only source. */
+export function collectLegacyCstlLifecycleFiles(projectRoot, candidateProjectRoot = projectRoot, candidateFiles = []) {
+    const sourceRoot = path.join(projectRoot, ".cstl");
+    const targetRoot = path.join(candidateProjectRoot, ".pactile");
+    const result = [];
+    const visit = (sourceDirectory) => {
+        for (const name of fs.readdirSync(sourceDirectory).sort()) {
+            const source = path.join(sourceDirectory, name);
+            const relativePath = relativePosix(sourceRoot, source);
+            const stat = assertSafeEntry(source);
+            if (skippedControlPath(relativePath))
+                continue;
+            if (stat.isDirectory()) {
+                visit(source);
+                continue;
+            }
+            if (!generationEligible(relativePath))
+                continue;
+            const target = path.join(targetRoot, ...relativePath.split("/"));
+            const sourceBytes = fs.readFileSync(source);
+            const targetBytes = fs.existsSync(target)
+                ? fs.readFileSync(target)
+                : sourceBytes;
+            const sourceRef = `legacy://cstl/${relativePath
+                .split("/")
+                .map(encodeURIComponent)
+                .join("/")}`;
+            if (sourceRef.length > 512)
+                throw new Error("legacy-import-ref-too-long");
+            result.push({
+                sourceRef,
+                path: relativePath,
+                classification: "active",
+                sourceBytes,
+                bytes: targetBytes,
+                expectedSourceFingerprint: fingerprintBytes(sourceBytes),
+            });
+        }
+    };
+    visit(sourceRoot);
+    const legacyPaths = new Set(result.map((file) => file.path));
+    for (const file of candidateFiles) {
+        const targetPath = file.path.replace(/\\/g, "/");
+        if (legacyPaths.has(targetPath))
+            continue;
+        const bytes = Buffer.from(file.bytes);
+        const sourceRef = `generated://pactile/${targetPath
+            .split("/")
+            .map(encodeURIComponent)
+            .join("/")}`;
+        if (sourceRef.length > 512)
+            throw new Error("legacy-import-ref-too-long");
+        result.push({
+            sourceRef,
+            path: targetPath,
+            classification: "generated",
+            sourceBytes: bytes,
+            bytes,
+            expectedSourceFingerprint: fingerprintBytes(bytes),
+        });
+    }
+    if (result.length === 0)
+        throw new Error("legacy-import-source-empty");
+    return result.sort((left, right) => left.path < right.path ? -1 : left.path > right.path ? 1 : 0);
+}
+/**
+ * Publish imported user-owned namespaces after canonical commit. Writes are
+ * idempotent and conflict-closed so an interrupted import can safely resume.
+ */
+export function materializePreparedLegacyUserState(preparedProjectRoot, projectRoot) {
+    const sourceRoot = path.join(preparedProjectRoot, ".pactile");
+    const targetRoot = path.join(projectRoot, ".pactile");
+    const files = [];
+    const visit = (directory) => {
+        for (const name of fs.readdirSync(directory).sort()) {
+            const source = path.join(directory, name);
+            const relativePath = relativePosix(sourceRoot, source);
+            const stat = assertSafeEntry(source);
+            if (stat.isDirectory()) {
+                visit(source);
+                continue;
+            }
+            if (generationEligible(relativePath))
+                continue;
+            files.push({ path: relativePath, bytes: fs.readFileSync(source) });
+        }
+    };
+    visit(sourceRoot);
+    for (const file of files) {
+        const target = path.join(targetRoot, ...file.path.split("/"));
+        try {
+            if (fs.readFileSync(target).equals(file.bytes))
+                continue;
+            throw new Error("legacy-import-user-state-conflict");
+        }
+        catch (error) {
+            if (!(error instanceof Error && "code" in error && error.code === "ENOENT"))
+                throw error;
+        }
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        const temporary = `${target}.tmp-${randomUUID()}`;
+        try {
+            fs.writeFileSync(temporary, file.bytes, { flag: "wx", mode: 0o600 });
+            fs.renameSync(temporary, target);
+        }
+        finally {
+            try {
+                fs.unlinkSync(temporary);
+            }
+            catch {
+                /* Successful rename consumes the temporary file. */
+            }
+        }
+    }
+    return files.map((file) => file.path);
+}
+export function readLegacyCstlVersion(projectRoot) {
+    try {
+        const value = fs
+            .readFileSync(path.join(projectRoot, ".cstl", ".version"), "utf8")
+            .trim();
+        return /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(value) ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=legacy-import.js.map

package/dist/pactile/lifecycle/legacy-import.js.map

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

package/dist/pactile/lifecycle/orchestrator.d.ts

@@ -0,0 +1,109 @@
+import { type MigrationJournalV1, type MigrationPlanV1, type OwnershipLedgerV1 } from "@blxzer/pactile-core";
+import { runMigrationTransaction, type MigrationFileClassification } from "../migration/transaction.js";
+import { type ProjectionInputs } from "../projection/planner.js";
+import { ProjectionStore, type ProjectionStoreOptions } from "../projection/store.js";
+import { type GenerationFile, type InstallStateSnapshot } from "../runtime/stores.js";
+export interface LifecycleGenerationFile {
+    readonly path: string;
+    readonly bytes: Uint8Array;
+}
+export interface LifecycleLegacyFile extends LifecycleGenerationFile {
+    readonly sourceRef: string;
+    readonly classification: MigrationFileClassification;
+    readonly sourceBytes: Uint8Array;
+    readonly expectedSourceFingerprint: string;
+}
+export type LifecycleSource = {
+    readonly kind: "fresh";
+    readonly files: readonly LifecycleGenerationFile[];
+} | {
+    readonly kind: "canonical";
+    readonly generationId: string;
+    readonly runtimeVersion: string;
+    readonly schemaVersion: 1;
+    readonly files: readonly LifecycleGenerationFile[];
+} | {
+    readonly kind: "legacy";
+    /** Batch 3 only wires the owned cstl importer. Trellis stays explicit. */
+    readonly root: ".cstl";
+    readonly runtimeVersion: string | null;
+    readonly schemaVersion: number | null;
+    readonly files: readonly LifecycleLegacyFile[];
+};
+export interface LifecycleProjectionContext {
+    readonly generationId: string;
+    readonly canonicalFingerprint: string;
+    readonly ledger: OwnershipLedgerV1 | null;
+    readonly ledgerFingerprint: string | null;
+    readonly occurredAt: string;
+}
+export interface LifecycleAdapter {
+    readonly adapterId: string;
+    readonly adapterVersion: string;
+    readonly projectionPlanId: string;
+    /** Called only after the canonical generation has been committed. */
+    readonly buildProjection: (context: LifecycleProjectionContext) => ProjectionInputs | Promise<ProjectionInputs>;
+}
+export interface LifecycleRequest {
+    readonly projectRoot: string;
+    readonly id: string;
+    readonly generationId: string;
+    readonly runtimeVersion: string;
+    readonly expectedInstallStateFingerprint: string | null;
+    readonly occurredAt: string;
+    readonly source: LifecycleSource;
+    readonly adapters: readonly LifecycleAdapter[];
+    /** Idempotent canonical live-view materialization after generation commit. */
+    readonly materializeCanonical?: (context: LifecycleMaterializationContext) => void | Promise<void>;
+}
+export interface LifecycleValidationContext {
+    readonly generationId: string;
+    readonly files: readonly GenerationFile[];
+    readonly readFile: (relativePath: string) => Uint8Array;
+    /** Read several sealed files after one generation-inventory verification. */
+    readonly readFiles?: (relativePaths: readonly string[]) => ReadonlyMap<string, Uint8Array>;
+}
+export type LifecycleMaterializationContext = LifecycleValidationContext;
+export interface LifecycleOrchestratorOptions {
+    readonly validateGeneration?: (context: LifecycleValidationContext) => boolean | Promise<boolean>;
+    readonly projectionStore?: (projectRoot: string, adapterId: string) => ProjectionStore;
+    readonly migrationRunner?: typeof runMigrationTransaction;
+    /** In-memory fault seam. It receives no paths, bytes, or credentials. */
+    readonly fault?: (phase: "after-stage" | "before-canonical-commit" | "after-canonical-commit" | "before-adapter" | "after-adapter", adapterId?: string) => void;
+}
+export interface LifecycleAdapterResult {
+    readonly adapterId: string;
+    readonly status: "succeeded" | "failed" | "pending";
+    readonly attempts: number;
+    readonly reason: string | null;
+    readonly retryable: boolean;
+    readonly projectionFingerprint: string | null;
+}
+export type LifecycleResult = {
+    readonly status: "completed" | "degraded";
+    readonly resumed: boolean;
+    readonly reason: null;
+    readonly plan: MigrationPlanV1;
+    readonly planFingerprint: string;
+    readonly generationFingerprint: string;
+    readonly journal: MigrationJournalV1;
+    readonly installState: InstallStateSnapshot;
+    readonly adapters: readonly LifecycleAdapterResult[];
+} | {
+    readonly status: "review" | "interrupted";
+    readonly resumed: boolean;
+    readonly reason: "invalid-lifecycle-request" | "lifecycle-plan-conflict" | "lifecycle-journal-unavailable" | "generation-validation-failed" | "canonical-commit-not-completed";
+    readonly plan: MigrationPlanV1 | null;
+    readonly planFingerprint: string | null;
+    readonly generationFingerprint: string | null;
+    readonly journal: MigrationJournalV1 | null;
+    readonly installState: InstallStateSnapshot | null;
+    readonly adapters: readonly LifecycleAdapterResult[];
+};
+/**
+ * Durable Batch 3 lifecycle seam. Canonical generation activation is complete
+ * before any Adapter factory or ProjectionStore write is allowed to run.
+ */
+export declare function runLifecycleTransaction(request: LifecycleRequest, options?: LifecycleOrchestratorOptions): Promise<LifecycleResult>;
+export declare function createProjectionStore(projectRoot: string, options?: ProjectionStoreOptions): ProjectionStore;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/pactile/lifecycle/orchestrator.d.ts.map

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