@blxzer/pactile 0.5.0

package/dist/pactile/adoption/workflow.js

@@ -0,0 +1,259 @@
+import { createHash } from "node:crypto";
+import { PACTILE_INTENTS_V1, resolveProviderV1, } from "@blxzer/pactile-core";
+import { reduceExternalBindingClaims, } from "../projection/planner.js";
+import { planBinding } from "./bindings.js";
+import { discoverSnapshot } from "./inventory.js";
+import { field, items, logicalId, member } from "./safety.js";
+const EMPTY_INVENTORY = { assets: [], diagnostics: [] };
+function failed(status, code, partial = {}) {
+    return {
+        status,
+        workflowId: null,
+        inventory: EMPTY_INVENTORY,
+        binding: null,
+        provider: null,
+        operations: [],
+        claims: [],
+        preserveExternalAsset: true,
+        remediation: [],
+        steps: [],
+        diagnostics: [code],
+        ...partial,
+    };
+}
+function resolutionInput(value, binding) {
+    return {
+        schemaVersion: field(value, "schemaVersion"),
+        intent: field(value, "intent"),
+        capabilityId: field(value, "capabilityId"),
+        minimumAssurance: field(value, "minimumAssurance"),
+        requestedPolicy: field(value, "requestedPolicy"),
+        authorizedProviderIds: field(value, "authorizedProviderIds"),
+        activeProviderIds: field(value, "activeProviderIds"),
+        standbyProviderIds: field(value, "standbyProviderIds"),
+        fallbackAllowed: field(value, "fallbackAllowed"),
+        manifests: field(value, "manifests"),
+        bindings: [binding],
+        runtimeFacts: field(value, "runtimeFacts"),
+        now: field(value, "now"),
+    };
+}
+function sanitizeClaims(value) {
+    return items(value).map((claim) => ({
+        resourceId: logicalId(field(claim, "resourceId")),
+        externalAssetId: logicalId(field(claim, "externalAssetId")),
+        claimants: items(field(claim, "claimants")).map(logicalId),
+    }));
+}
+function operation(action, resourceId, claimantId, externalAssetId) {
+    return {
+        id: `${resourceId}.${action}`,
+        resourceId,
+        claimantId,
+        action,
+        control: "borrowed",
+        targetPath: null,
+        format: "external-ref",
+        contentRef: null,
+        desiredFingerprint: null,
+        expectedCurrentFingerprint: null,
+        externalAssetId,
+    };
+}
+/**
+ * Pure discover -> adopt -> bind -> doctor -> optional detach workflow. It
+ * consumes sanitized public facts and emits declarative external-ref claims;
+ * it has no filesystem, installation, authentication, or deletion port.
+ */
+export function runAdoptionWorkflow(value) {
+    try {
+        const discovery = discoverSnapshot(field(value, "discovery"));
+        const assetId = logicalId(field(value, "assetId"));
+        const capabilityId = logicalId(field(value, "capabilityId"));
+        const claimantId = logicalId(field(value, "claimantId"));
+        const providerValue = field(value, "providerId");
+        const providerId = providerValue === null ? null : logicalId(providerValue);
+        const intents = [
+            ...new Set(items(field(value, "intents")).map((item) => member(item, PACTILE_INTENTS_V1))),
+        ].sort();
+        const detach = field(value, "detach");
+        if (typeof detach !== "boolean" || intents.length === 0)
+            return failed("invalid", "invalid-input");
+        const existingClaims = sanitizeClaims(field(value, "claims"));
+        const discoverEvidence = discovery.assets
+            .map(({ fingerprint }) => fingerprint)
+            .filter((item) => item !== null)
+            .map((item) => `evidence://inventory/${item.slice(7, 23)}`);
+        const steps = [
+            {
+                sequence: 1,
+                phase: "discover",
+                outcome: discovery.diagnostics.length ? "degraded" : "accepted",
+                evidenceRefs: discoverEvidence,
+            },
+        ];
+        if (discovery.diagnostics.length)
+            return failed("conflict", "inventory-conflict", {
+                inventory: discovery,
+                steps,
+            });
+        const matches = discovery.assets.filter(({ id }) => id === assetId);
+        if (matches.length !== 1)
+            return failed("conflict", "asset-not-found", {
+                inventory: discovery,
+                steps,
+            });
+        const proposal = planBinding({
+            asset: matches[0],
+            capabilityId,
+            providerId,
+            intents,
+        });
+        if (!proposal.binding) {
+            steps.push({
+                sequence: 2,
+                phase: "adopt",
+                outcome: "degraded",
+                evidenceRefs: [],
+            });
+            steps.push({
+                sequence: 3,
+                phase: "doctor",
+                outcome: "degraded",
+                evidenceRefs: [],
+            });
+            return failed("degraded", "adoption-unavailable", {
+                inventory: discovery,
+                remediation: proposal.installHint
+                    ? [proposal.installHint.label]
+                    : ["inspect-capability-readiness"],
+                steps,
+            });
+        }
+        const binding = proposal.binding;
+        steps.push({
+            sequence: 2,
+            phase: "adopt",
+            outcome: "accepted",
+            evidenceRefs: [],
+        });
+        if (binding.control === "pactile-owned") {
+            steps.push({
+                sequence: 3,
+                phase: "bind",
+                outcome: "degraded",
+                evidenceRefs: [],
+            });
+            steps.push({
+                sequence: 4,
+                phase: "doctor",
+                outcome: "degraded",
+                evidenceRefs: [],
+            });
+            return failed("degraded", "owned-projection-required", {
+                inventory: discovery,
+                binding,
+                claims: existingClaims,
+                preserveExternalAsset: false,
+                remediation: ["route-owned-asset-through-shared-projection"],
+                steps,
+            });
+        }
+        const provider = providerId === null
+            ? null
+            : resolveProviderV1(resolutionInput(field(value, "providerResolution"), binding));
+        if (providerId !== null && provider?.status !== "supported") {
+            steps.push({
+                sequence: 3,
+                phase: "bind",
+                outcome: "rejected",
+                evidenceRefs: [],
+            });
+            steps.push({
+                sequence: 4,
+                phase: "doctor",
+                outcome: "degraded",
+                evidenceRefs: provider?.explain.evidenceRefs ?? [],
+            });
+            return failed("degraded", "provider-unsupported", {
+                inventory: discovery,
+                binding,
+                provider,
+                claims: existingClaims,
+                remediation: ["refresh-or-authorize-provider"],
+                steps,
+            });
+        }
+        const resourceId = `adoption.${binding.asset.id}`;
+        const bind = operation("bind", resourceId, claimantId, binding.asset.id);
+        let claims;
+        try {
+            claims = reduceExternalBindingClaims(existingClaims, [bind]);
+        }
+        catch {
+            return failed("conflict", "foreign-conflict", {
+                inventory: discovery,
+                binding,
+                provider,
+                claims: existingClaims,
+                steps,
+            });
+        }
+        const providerEvidence = provider?.resolution?.evidenceRefs ?? [];
+        steps.push({
+            sequence: 3,
+            phase: "bind",
+            outcome: "accepted",
+            evidenceRefs: providerEvidence,
+        });
+        steps.push({
+            sequence: 4,
+            phase: "doctor",
+            outcome: provider?.resolution?.readiness === "degraded" ? "degraded" : "accepted",
+            evidenceRefs: providerEvidence,
+        });
+        const operations = [bind];
+        if (detach) {
+            const release = operation("detach", resourceId, claimantId, binding.asset.id);
+            claims = reduceExternalBindingClaims(claims, [release]);
+            operations.push(release);
+            steps.push({
+                sequence: 5,
+                phase: "detach",
+                outcome: "accepted",
+                evidenceRefs: [],
+            });
+        }
+        const workflowId = `workflow.${createHash("sha256")
+            .update(JSON.stringify({
+            asset: binding.asset.id,
+            binding: binding.id,
+            claimantId,
+            detach,
+            provider: provider?.fingerprint ?? null,
+        }))
+            .digest("hex")
+            .slice(0, 24)}`;
+        return {
+            status: provider?.resolution?.readiness === "degraded"
+                ? "degraded"
+                : "complete",
+            workflowId,
+            inventory: discovery,
+            binding,
+            provider,
+            operations,
+            claims,
+            preserveExternalAsset: binding.control === "borrowed",
+            remediation: provider?.resolution?.readiness === "degraded"
+                ? ["refresh-or-authorize-provider"]
+                : [],
+            steps,
+            diagnostics: [],
+        };
+    }
+    catch {
+        return failed("invalid", "invalid-input");
+    }
+}
+//# sourceMappingURL=workflow.js.map

package/dist/pactile/adoption/workflow.js.map

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

package/dist/pactile/compat/cli-options.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Command-line compatibility spellings retained only for the 0.5.x window.
+ * Keeping them here makes the legacy surface explicit and independently
+ * removable without leaking old names into the canonical command registry.
+ */
+export declare const LEGACY_IMPORT_OPTION = "--import-cstl";
+export declare const LEGACY_IMPORT_DESCRIPTION = "Explicitly import an existing .cstl tree as a read-only legacy source";
+export declare const LEGACY_UPDATE_BLOCK_MESSAGE = "Error: legacy workflow detected. Run `pactile init --import-cstl` from a checkout without .pactile; update will not write .cstl or .trellis.";
+//# sourceMappingURL=cli-options.d.ts.map

package/dist/pactile/compat/cli-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-options.d.ts","sourceRoot":"","sources":["../../../src/pactile/compat/cli-options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD,eAAO,MAAM,yBAAyB,0EACmC,CAAC;AAE1E,eAAO,MAAM,2BAA2B,iJACwG,CAAC"}

package/dist/pactile/compat/cli-options.js

@@ -0,0 +1,9 @@
+/**
+ * Command-line compatibility spellings retained only for the 0.5.x window.
+ * Keeping them here makes the legacy surface explicit and independently
+ * removable without leaking old names into the canonical command registry.
+ */
+export const LEGACY_IMPORT_OPTION = "--import-cstl";
+export const LEGACY_IMPORT_DESCRIPTION = "Explicitly import an existing .cstl tree as a read-only legacy source";
+export const LEGACY_UPDATE_BLOCK_MESSAGE = "Error: legacy workflow detected. Run `pactile init --import-cstl` from a checkout without .pactile; update will not write .cstl or .trellis.";
+//# sourceMappingURL=cli-options.js.map

package/dist/pactile/compat/cli-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-options.js","sourceRoot":"","sources":["../../../src/pactile/compat/cli-options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AAEpD,MAAM,CAAC,MAAM,yBAAyB,GACpC,uEAAuE,CAAC;AAE1E,MAAM,CAAC,MAAM,2BAA2B,GACtC,8IAA8I,CAAC"}

package/dist/pactile/compat/init-context.d.ts

@@ -0,0 +1,16 @@
+export interface LegacyInitContext {
+    readonly importedDeveloperFilePresent: boolean;
+    readonly coexistenceNotice: readonly string[];
+}
+/**
+ * Inspect legacy roots without granting write authority. The returned strings
+ * are compatibility guidance only; all generation remains under `.pactile`.
+ */
+export declare function inspectLegacyInitContext(options: {
+    readonly cwd: string;
+    readonly canonicalRootAbsent: boolean;
+    readonly importRequested: boolean;
+    readonly developerFileName: string;
+}): LegacyInitContext;
+export declare function legacyImportPreparedMessage(fileCount: number): string;
+//# sourceMappingURL=init-context.d.ts.map

package/dist/pactile/compat/init-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-context.d.ts","sourceRoot":"","sources":["../../../src/pactile/compat/init-context.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,4BAA4B,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AA+CD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC,GAAG,iBAAiB,CAwCpB;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/pactile/compat/init-context.js

@@ -0,0 +1,87 @@
+import fs from "node:fs";
+import path from "node:path";
+import { parseMigrationJournalV1 } from "@blxzer/pactile-core";
+function recoverableImportRoot(cwd) {
+    const canonicalRoot = path.join(cwd, ".pactile");
+    try {
+        const root = fs.lstatSync(canonicalRoot);
+        if (!root.isDirectory() || root.isSymbolicLink())
+            return false;
+        const journals = path.join(canonicalRoot, "runtime", "migrations");
+        const journalRoot = fs.lstatSync(journals);
+        if (!journalRoot.isDirectory() || journalRoot.isSymbolicLink())
+            return false;
+        return fs.readdirSync(journals).some((name) => {
+            if (!/^lifecycle\.import\.[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*\.json$/u.test(name))
+                return false;
+            try {
+                const target = path.join(journals, name);
+                const stat = fs.lstatSync(target);
+                if (!stat.isFile() || stat.isSymbolicLink() || stat.nlink !== 1)
+                    return false;
+                const parsed = parseMigrationJournalV1(JSON.parse(fs.readFileSync(target, "utf8")));
+                if (!parsed.success)
+                    return false;
+                const id = name.slice(0, -".json".length);
+                if (parsed.data.id !== id)
+                    return false;
+                // A completed/rolled-back/failed import is historical evidence, not a
+                // recovery lease. Re-importing over an existing canonical root must
+                // require a fresh explicit ownership decision rather than any stale
+                // filename left under runtime/migrations.
+                return [
+                    "planned",
+                    "backed-up",
+                    "staged",
+                    "validated",
+                    "committed",
+                    "reconciling",
+                    "degraded",
+                    "recovering",
+                ].includes(parsed.data.state);
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Inspect legacy roots without granting write authority. The returned strings
+ * are compatibility guidance only; all generation remains under `.pactile`.
+ */
+export function inspectLegacyInitContext(options) {
+    const legacyCstlRoot = path.join(options.cwd, ".cstl");
+    const hasLegacyCstl = fs.existsSync(legacyCstlRoot);
+    if (options.importRequested &&
+        ((!options.canonicalRootAbsent && !recoverableImportRoot(options.cwd)) ||
+            !hasLegacyCstl)) {
+        throw new Error("--import-cstl requires a readable .cstl source and either no .pactile root or a recoverable import journal");
+    }
+    if (options.canonicalRootAbsent &&
+        hasLegacyCstl &&
+        !options.importRequested) {
+        throw new Error("Existing .cstl detected. Re-run with --import-cstl to perform an explicit read-only legacy import.");
+    }
+    const importedDeveloperFilePresent = options.importRequested &&
+        fs.existsSync(path.join(legacyCstlRoot, options.developerFileName));
+    const foreignRootPresent = options.canonicalRootAbsent &&
+        fs.existsSync(path.join(options.cwd, ".trellis"));
+    return {
+        importedDeveloperFilePresent,
+        coexistenceNotice: foreignRootPresent
+            ? [
+                "\n  Detected upstream `.trellis/` — coexistence mode: Pactile will use `.pactile/`",
+                "  alongside `.trellis/`; the upstream tree will not be touched.\n",
+                "  Upstream state is never imported without a separate explicit ownership decision.\n",
+            ]
+            : [],
+    };
+}
+export function legacyImportPreparedMessage(fileCount) {
+    return `Prepared explicit read-only .cstl import (${fileCount} preserved file(s)); source bytes were not modified.`;
+}
+//# sourceMappingURL=init-context.js.map

package/dist/pactile/compat/init-context.js.map

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

package/dist/pactile/compat/legacy-migrations.d.ts

@@ -0,0 +1,8 @@
+import type { MigrationItem } from "../../types/migration.js";
+/**
+ * Historical manifests may still describe writes inside old runtime roots.
+ * Those roots are immutable import inputs in Pactile, so canonical update may
+ * retain host cleanup entries while dropping every legacy-root mutation.
+ */
+export declare function filterReadOnlyLegacyMigrationItems(items: readonly MigrationItem[]): MigrationItem[];
+//# sourceMappingURL=legacy-migrations.d.ts.map

package/dist/pactile/compat/legacy-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-migrations.d.ts","sourceRoot":"","sources":["../../../src/pactile/compat/legacy-migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAY9D;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,aAAa,EAAE,CAMjB"}

package/dist/pactile/compat/legacy-migrations.js

@@ -0,0 +1,17 @@
+const READ_ONLY_LEGACY_ROOTS = [".cstl", ".trellis"];
+function targetsReadOnlyLegacyRoot(value) {
+    if (value === undefined)
+        return false;
+    const normalized = value.replaceAll("\\", "/");
+    return READ_ONLY_LEGACY_ROOTS.some((root) => normalized === root || normalized.startsWith(`${root}/`));
+}
+/**
+ * Historical manifests may still describe writes inside old runtime roots.
+ * Those roots are immutable import inputs in Pactile, so canonical update may
+ * retain host cleanup entries while dropping every legacy-root mutation.
+ */
+export function filterReadOnlyLegacyMigrationItems(items) {
+    return items.filter((item) => !targetsReadOnlyLegacyRoot(item.from) &&
+        !targetsReadOnlyLegacyRoot(item.to));
+}
+//# sourceMappingURL=legacy-migrations.js.map

package/dist/pactile/compat/legacy-migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-migrations.js","sourceRoot":"","sources":["../../../src/pactile/compat/legacy-migrations.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,CAAU,CAAC;AAE9D,SAAS,yBAAyB,CAAC,KAAyB;IAC1D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,sBAAsB,CAAC,IAAI,CAChC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CACnE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAChD,KAA+B;IAE/B,OAAO,KAAK,CAAC,MAAM,CACjB,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC;QACrC,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,CACtC,CAAC;AACJ,CAAC"}

package/dist/pactile/compat/retired-alternate-client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Hash-safe cleanup of retired Cursor++ managed residue.
+ *
+ * Cursor++ product surfaces are no longer shipped. On `pactile update`, delete
+ * known managed paths only when on-disk content matches a pristine template
+ * hash captured from the last shipped SSOT bytes. User-modified files are
+ * preserved with a warning.
+ *
+ * Never target `.cstl/middleware/` (user overlay). Residue paths are an
+ * explicit allow-list; overlay isolation is a separate contract.
+ */
+/** Relative path under the workflow dir (`.cstl` or `.trellis`) or absolute-from-cwd. */
+export interface Cursor2plusResidueTarget {
+    /** Posix-style path relative to project cwd (uses `{workflow}` placeholder). */
+    pathTemplate: string;
+    allowedHashes: readonly string[];
+}
+/**
+ * Pristine hashes computed from packages/cli/src/templates before P23 deletion
+ * (LF-normalized SHA-256, same as computeHash).
+ */
+export declare const CURSOR2PLUS_RESIDUE_TARGETS: readonly Cursor2plusResidueTarget[];
+export interface Cursor2plusResidueCleanupResult {
+    deleted: string[];
+    preservedModified: string[];
+    missing: string[];
+}
+/**
+ * Delete pristine Cursor++ residue under cwd. Never deletes user-modified files.
+ */
+export declare function cleanupCursor2plusResidue(cwd: string, options?: {
+    dryRun?: boolean;
+    /** Test-only override. Production callers omit this. */
+    targets?: readonly Cursor2plusResidueTarget[];
+}): Cursor2plusResidueCleanupResult;
+/** Canonical call-site name for the 0.5.x legacy residue cleaner. */
+export declare const cleanupRetiredAlternateClientResidue: typeof cleanupCursor2plusResidue;
+/**
+ * True when any Cursor++ local bundle directory still exists (residue notice).
+ */
+export declare function hasCursor2plusBundleResidue(cwd: string): boolean;
+//# sourceMappingURL=retired-alternate-client.d.ts.map

package/dist/pactile/compat/retired-alternate-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retired-alternate-client.d.ts","sourceRoot":"","sources":["../../../src/pactile/compat/retired-alternate-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,yFAAyF;AACzF,MAAM,WAAW,wBAAwB;IACvC,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,wBAAwB,EA6D1E,CAAC;AAEF,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAwBD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC1C,GACL,+BAA+B,CAoCjC;AAED,qEAAqE;AACrE,eAAO,MAAM,oCAAoC,kCAA4B,CAAC;AAE9E;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQhE"}

package/dist/pactile/compat/retired-alternate-client.js

@@ -0,0 +1,153 @@
+/**
+ * Hash-safe cleanup of retired Cursor++ managed residue.
+ *
+ * Cursor++ product surfaces are no longer shipped. On `pactile update`, delete
+ * known managed paths only when on-disk content matches a pristine template
+ * hash captured from the last shipped SSOT bytes. User-modified files are
+ * preserved with a warning.
+ *
+ * Never target `.cstl/middleware/` (user overlay). Residue paths are an
+ * explicit allow-list; overlay isolation is a separate contract.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { DIR_NAMES } from "../../constants/paths.js";
+import { computeHash, removeHash } from "../../utils/template-hash.js";
+import { resolveWorkflowDirName } from "../../utils/workflow-dir.js";
+/**
+ * Pristine hashes computed from packages/cli/src/templates before P23 deletion
+ * (LF-normalized SHA-256, same as computeHash).
+ */
+export const CURSOR2PLUS_RESIDUE_TARGETS = [
+    {
+        pathTemplate: "{workflow}/local/cursor2plus/patch_wpelc8.py",
+        allowedHashes: [
+            "480d24cb0b5f98691938525db2e73326dfc9e2c70783fb3c357bc442f4d4c427",
+        ],
+    },
+    {
+        pathTemplate: "{workflow}/local/cursor2plus/smoke.py",
+        allowedHashes: [
+            "e7eecc069188e1dde85312ac5271932e797a3af37c3ae1bd397bbbbfe4f9785b",
+        ],
+    },
+    {
+        pathTemplate: "{workflow}/local/cursor2plus/README.md",
+        allowedHashes: [
+            "d170822a5f3d2bc01238ca4b9e72acb197b2678da7f5f9ffa0226e09fdb2a312",
+        ],
+    },
+    {
+        pathTemplate: "{workflow}/local/cursor2plus/config.local.json.example",
+        allowedHashes: [
+            "b01b653f74fed06070232eca22f2daeb8c14bf7c99db21446f6ee1105f0ce016",
+        ],
+    },
+    {
+        pathTemplate: "{workflow}/local/cursor2plus/trellis_task_models_config.py",
+        allowedHashes: [
+            "d27ebea2caeb52ec990a99c9e1c20c6a8265f65ceb95f28e01771b4efd6fa891",
+        ],
+    },
+    {
+        pathTemplate: "{workflow}/local/subagent-models.json.example",
+        allowedHashes: [
+            "57212acbb4d2434f13ca5a7b40ec7ca00136870748943a92e8036d8b1e8e7434",
+        ],
+    },
+    {
+        pathTemplate: "{workflow}/local/trellis-task-models.json.example",
+        allowedHashes: [
+            "10b74000b32020fbd5d3be73deeb61c066b51ea6fcfe7c1bba5883deb24fce65",
+        ],
+    },
+    {
+        pathTemplate: "{workflow}/local/trellis-task-models.json5.example",
+        allowedHashes: [
+            "30c7bf1809065eecd9afcafd67ad36d32b5d3a5a3c07f54b9a58a22b4f34f267",
+        ],
+    },
+    {
+        pathTemplate: ".cursor/commands/cstl-cursor2plus-setup.md",
+        allowedHashes: [
+            "7792337f85639e1bd0162d525056ee26cadb3400bf77e98d1a9bfe18d09d885c",
+        ],
+    },
+    {
+        pathTemplate: ".cursor/skills/cstl-cursor2plus-setup/SKILL.md",
+        allowedHashes: [
+            "bc3e11e550caceab6fa3feb994bcc5c4fb45ee612feb5223b0212b061d136d16",
+        ],
+    },
+];
+function resolvePathTemplate(pathTemplate, workflowDirName) {
+    return pathTemplate.replaceAll("{workflow}", workflowDirName);
+}
+function tryRemoveEmptyParents(filePath, stopAt) {
+    let dir = path.dirname(filePath);
+    const stop = path.resolve(stopAt);
+    while (dir.startsWith(stop) && dir !== stop) {
+        if (!fs.existsSync(dir)) {
+            dir = path.dirname(dir);
+            continue;
+        }
+        const entries = fs.readdirSync(dir);
+        if (entries.length > 0)
+            break;
+        fs.rmdirSync(dir);
+        dir = path.dirname(dir);
+    }
+}
+/**
+ * Delete pristine Cursor++ residue under cwd. Never deletes user-modified files.
+ */
+export function cleanupCursor2plusResidue(cwd, options = {}) {
+    const workflowDirName = resolveWorkflowDirName(cwd) ?? DIR_NAMES.WORKFLOW;
+    const result = {
+        deleted: [],
+        preservedModified: [],
+        missing: [],
+    };
+    const targets = options.targets ?? CURSOR2PLUS_RESIDUE_TARGETS;
+    for (const target of targets) {
+        const rel = resolvePathTemplate(target.pathTemplate, workflowDirName);
+        const fullPath = path.join(cwd, rel);
+        if (!fs.existsSync(fullPath)) {
+            result.missing.push(rel);
+            continue;
+        }
+        const content = fs.readFileSync(fullPath, "utf-8");
+        const hash = computeHash(content);
+        if (!target.allowedHashes.includes(hash)) {
+            result.preservedModified.push(rel);
+            continue;
+        }
+        if (!options.dryRun) {
+            fs.unlinkSync(fullPath);
+            // Legacy-only projects can have residue without a canonical Pactile
+            // hash manifest.  Deleting that residue must not create a new canonical
+            // root (or fail while trying to update one).
+            if (fs.existsSync(path.join(cwd, DIR_NAMES.WORKFLOW, ".template-hashes.json"))) {
+                removeHash(cwd, rel);
+            }
+            tryRemoveEmptyParents(fullPath, cwd);
+        }
+        result.deleted.push(rel);
+    }
+    return result;
+}
+/** Canonical call-site name for the 0.5.x legacy residue cleaner. */
+export const cleanupRetiredAlternateClientResidue = cleanupCursor2plusResidue;
+/**
+ * True when any Cursor++ local bundle directory still exists (residue notice).
+ */
+export function hasCursor2plusBundleResidue(cwd) {
+    const workflowDirName = resolveWorkflowDirName(cwd) ?? DIR_NAMES.WORKFLOW;
+    const candidates = [
+        path.join(cwd, workflowDirName, "local", "cursor2plus"),
+        path.join(cwd, ".cstl", "local", "cursor2plus"),
+        path.join(cwd, ".trellis", "local", "cursor2plus"),
+    ];
+    return candidates.some((p) => fs.existsSync(p));
+}
+//# sourceMappingURL=retired-alternate-client.js.map