@blxzer/pactile 0.5.0

package/dist/utils/uninstall-scrubbers.js

@@ -0,0 +1,196 @@
+/**
+ * Compatibility scrubbers for structured config files during detach.
+ *
+ * Each scrubber takes the file content (and any context it needs) and returns
+ * `{ content, fullyEmpty }`:
+ * - `content` is the post-scrub text to write back if the file should remain.
+ * - `fullyEmpty` is true when, after stripping every Pactile-managed value,
+ *   nothing meaningful is left. The caller deletes the file in that case.
+ *
+ * Manifest path matching (for hooks.json scrubbers) uses substring containment
+ * on the resolved `command` string. The leading `python3 ` / `python ` prefix
+ * does not matter — we just look for the manifest-relative file path.
+ */
+/**
+ * Test whether a hook command string references any of the given manifest paths.
+ *
+ * Pactile-emitted hook commands have the shape
+ *   `<python-cmd> [interpreter-flags] <manifest-path> [hook-args…]`
+ * e.g. `python .cursor/hooks/event-bridge.py --event sessionStart`.
+ * The invoked script is the first non-flag token after the interpreter, not
+ * necessarily the last token. Matching only the last token left leftover
+ * `event-bridge.py` references after uninstall.
+ *
+ * This is still stricter than substring matching: a user hook whose body
+ * merely mentions a deleted path inside an `echo` argument
+ * (`echo "see .claude/hooks/session-start.py for inspiration" && python3 my-hook.py`)
+ * does NOT match, because the invoked script is `my-hook.py`. Absolute-path
+ * variants like `/Users/me/proj/.claude/hooks/session-start.py` match via
+ * `endsWith("/" + p)`.
+ */
+function isPythonCommandToken(token) {
+    const base = token
+        .replace(/^["']|["']$/g, "")
+        .replace(/\\/g, "/")
+        .split("/")
+        .pop()
+        ?.toLowerCase();
+    return (base === "python" ||
+        base === "python3" ||
+        base === "python.exe" ||
+        base === "python3.exe" ||
+        base === "py" ||
+        base === "py.exe");
+}
+function extractInvokedScriptToken(command) {
+    const tokens = command.trim().split(/\s+/);
+    if (tokens.length === 0)
+        return "";
+    for (let i = 0; i < tokens.length; i++) {
+        if (!isPythonCommandToken(tokens[i]))
+            continue;
+        let j = i + 1;
+        while (j < tokens.length) {
+            const opt = tokens[j].replace(/^["']|["']$/g, "");
+            if (opt.startsWith("-") && !opt.includes("/") && !opt.endsWith(".py")) {
+                j += 1;
+                continue;
+            }
+            break;
+        }
+        if (j < tokens.length) {
+            return tokens[j].replace(/^["']|["']$/g, "");
+        }
+    }
+    return tokens[tokens.length - 1].replace(/^["']|["']$/g, "");
+}
+function commandMatchesDeletedPath(command, deletedPaths) {
+    const trimmed = command.trim();
+    if (trimmed.length === 0)
+        return false;
+    const scriptToken = extractInvokedScriptToken(trimmed);
+    if (scriptToken.length === 0)
+        return false;
+    for (const p of deletedPaths) {
+        if (scriptToken === p || scriptToken.endsWith("/" + p)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Read the `command` (or fallback `bash` / `powershell`) string out of an
+ * arbitrary hook entry. Copilot's flat schema uses `bash` + `powershell`
+ * instead of `command` for some events.
+ */
+function getEntryCommand(entry) {
+    if (entry === null || typeof entry !== "object") {
+        return null;
+    }
+    const obj = entry;
+    if (typeof obj.command === "string")
+        return obj.command;
+    if (typeof obj.bash === "string")
+        return obj.bash;
+    if (typeof obj.powershell === "string")
+        return obj.powershell;
+    return null;
+}
+/**
+ * Scrub a hooks-shaped settings JSON file.
+ *
+ * `mode = "nested"` → `hooks.{Event}.[ {matcher?, hooks: [ {command,...} ]} ]`
+ * `mode = "flat"`   → `hooks.{Event}.[ {command,...} ]`
+ *
+ * Strips every entry whose command references a path in `deletedPaths`,
+ * then bottom-up cleans empty containers (matcher block, event array, hooks
+ * object). Any user-defined keys outside `hooks` (e.g. `env`, `model`,
+ * `permissions`, `version`) are preserved verbatim.
+ */
+export function scrubHooksJson(content, deletedPaths, mode) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        // Malformed JSON — leave it untouched, caller will skip.
+        return { content, fullyEmpty: false };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { content, fullyEmpty: false };
+    }
+    const root = parsed;
+    const hooks = root.hooks;
+    if (hooks === undefined) {
+        // No hooks block — nothing to scrub. Treat as fully empty only if the
+        // entire file has no other keys.
+        const fullyEmpty = Object.keys(root).length === 0;
+        return { content: JSON.stringify(root, null, 2) + "\n", fullyEmpty };
+    }
+    if (hooks === null || typeof hooks !== "object" || Array.isArray(hooks)) {
+        // hooks is some unexpected shape — leave it alone.
+        return { content, fullyEmpty: false };
+    }
+    const hooksObj = hooks;
+    for (const eventName of Object.keys(hooksObj)) {
+        const eventArr = hooksObj[eventName];
+        if (!Array.isArray(eventArr))
+            continue;
+        const filteredEvent = [];
+        for (const entry of eventArr) {
+            if (mode === "flat") {
+                const cmd = getEntryCommand(entry);
+                if (cmd !== null && commandMatchesDeletedPath(cmd, deletedPaths)) {
+                    continue; // drop Pactile entry
+                }
+                filteredEvent.push(entry);
+            }
+            else {
+                // nested: entry is { matcher?, hooks: [...] }
+                if (entry === null || typeof entry !== "object") {
+                    filteredEvent.push(entry);
+                    continue;
+                }
+                const matcherBlock = entry;
+                const inner = matcherBlock.hooks;
+                if (!Array.isArray(inner)) {
+                    filteredEvent.push(entry);
+                    continue;
+                }
+                const filteredInner = inner.filter((sub) => {
+                    const cmd = getEntryCommand(sub);
+                    return !(cmd !== null && commandMatchesDeletedPath(cmd, deletedPaths));
+                });
+                if (filteredInner.length === 0) {
+                    // Whole matcher block is now empty → drop the block.
+                    continue;
+                }
+                // Reconstruct the block with the filtered inner list.
+                const rebuilt = { ...matcherBlock };
+                rebuilt.hooks = filteredInner;
+                filteredEvent.push(rebuilt);
+            }
+        }
+        if (filteredEvent.length === 0) {
+            // Drop the whole event array.
+            // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+            delete hooksObj[eventName];
+        }
+        else {
+            hooksObj[eventName] = filteredEvent;
+        }
+    }
+    // If hooks is empty → drop the key.
+    if (Object.keys(hooksObj).length === 0) {
+        delete root.hooks;
+    }
+    else {
+        root.hooks = hooksObj;
+    }
+    const fullyEmpty = Object.keys(root).length === 0;
+    return {
+        content: JSON.stringify(root, null, 2) + "\n",
+        fullyEmpty,
+    };
+}
+//# sourceMappingURL=uninstall-scrubbers.js.map

package/dist/utils/uninstall-scrubbers.js.map

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

package/dist/utils/update-rollout-report.d.ts

@@ -0,0 +1,171 @@
+import type { ClassifiedMigrations, MigrationResult } from "../types/migration.js";
+import type { LifecycleResult } from "../pactile/lifecycle/orchestrator.js";
+export declare const UPDATE_ROLLOUT_REPORT_SCHEMA_VERSION: 1;
+export type UpdateRolloutMode = "dry-run" | "apply";
+export type UpdateRolloutOutcome = "no_changes" | "would_apply" | "applied" | "applied_degraded" | "cancelled" | "blocked_downgrade" | "blocked_migration_required" | "blocked_not_initialized" | "error";
+export interface UpdateFileActions {
+    added: string[];
+    autoUpdated: string[];
+    overwritten: string[];
+    skipped: string[];
+    createdNew: string[];
+    unchanged: string[];
+    userDeleted: string[];
+    safeDeleted: string[];
+}
+export interface UpdateMigrationPlanSummary {
+    pendingCount: number;
+    auto: number;
+    confirm: number;
+    conflict: number;
+    safeDeleteCandidates: number;
+}
+export interface UpdateMigrationApplySummary {
+    renamed: number;
+    deleted: number;
+    skipped: number;
+    conflicts: number;
+}
+export interface UpdateReadinessProbeSnapshot {
+    id: string;
+    ok: boolean;
+    failures: string[];
+    warnings: string[];
+    smokeCommands: string[];
+}
+export interface UpdateReadinessSnapshot {
+    skipped: boolean;
+    smartSearch: {
+        command: string;
+        ok: boolean;
+        details: string[];
+    };
+    capabilities: UpdateReadinessProbeSnapshot[];
+}
+export interface UpdateSmokeCheckResult {
+    command: string;
+    ok: boolean;
+    detail?: string;
+}
+export interface UpdateReleaseBlocker {
+    code: string;
+    message: string;
+    recovery?: string[];
+}
+export interface UpdateRolloutReport {
+    schemaVersion: typeof UPDATE_ROLLOUT_REPORT_SCHEMA_VERSION;
+    generatedAt: string;
+    mode: UpdateRolloutMode;
+    outcome: UpdateRolloutOutcome;
+    projectPath: string;
+    pactile: {
+        cliVersion: string;
+        packageName: string;
+        projectVersionBefore: string;
+        projectVersionAfter: string | null;
+        latestNpmVersion: string | null;
+        cliBehindNpm: boolean;
+    };
+    options: {
+        dryRun: boolean;
+        force: boolean;
+        skipAll: boolean;
+        createNew: boolean;
+        migrate: boolean;
+        allowDowngrade: boolean;
+        skipReadiness: boolean;
+        writeArtifacts?: boolean;
+    };
+    p36?: {
+        officialRefresh: number;
+        officialPreserved: number;
+        officialRetire: number;
+        artifactDualRead: number;
+        artifactWritable: number;
+        degraded: string[];
+        writeArtifacts: boolean;
+        waveCConfirmed?: boolean;
+        leftoverCloseout?: number;
+        alreadyNewShape?: number;
+    };
+    plan: {
+        upgradeDirection: "upgrade" | "downgrade" | "same" | "unknown";
+        breakingMigrationGateRequired: boolean;
+        files: UpdateFileActions;
+        conflictsPending: string[];
+        migrations: UpdateMigrationPlanSummary;
+        backupPath: string | null;
+    };
+    apply?: {
+        backupPath: string | null;
+        migrations: UpdateMigrationApplySummary | null;
+        safeDeleted: number;
+        configSectionsAppended: number;
+    };
+    readiness: UpdateReadinessSnapshot;
+    lifecycle: UpdateLifecycleSummary | null;
+    postUpdateSmoke: UpdateSmokeCheckResult[];
+    releaseBlockers: UpdateReleaseBlocker[];
+}
+export interface BuildFilePlanInput {
+    newFiles: {
+        relativePath: string;
+    }[];
+    unchangedFiles: {
+        relativePath: string;
+    }[];
+    autoUpdateFiles: {
+        relativePath: string;
+    }[];
+    changedFiles: {
+        relativePath: string;
+    }[];
+    userDeletedFiles: {
+        relativePath: string;
+    }[];
+    safeDeletePaths?: string[];
+}
+export declare function buildFilePlanFromChanges(input: BuildFilePlanInput): UpdateFileActions;
+export declare function summarizeMigrationPlan(classified: ClassifiedMigrations | null, safeDeleteCandidateCount: number): UpdateMigrationPlanSummary;
+export declare function migrationResultToSummary(result: MigrationResult | null): UpdateMigrationApplySummary | null;
+export declare function lifecycleResultToSummary(result: LifecycleResult | null): UpdateLifecycleSummary | null;
+export declare function createBaseRolloutReport(input: {
+    mode: UpdateRolloutMode;
+    outcome: UpdateRolloutOutcome;
+    projectPath: string;
+    projectVersionBefore: string;
+    projectVersionAfter?: string | null;
+    latestNpmVersion: string | null;
+    cliBehindNpm: boolean;
+    options: UpdateRolloutReport["options"];
+    readiness: UpdateReadinessSnapshot;
+    upgradeDirection: UpdateRolloutReport["plan"]["upgradeDirection"];
+    files: UpdateFileActions;
+    conflictsPending: string[];
+    migrations: UpdateMigrationPlanSummary;
+    backupPath?: string | null;
+    breakingMigrationGateRequired?: boolean;
+    apply?: UpdateRolloutReport["apply"];
+    postUpdateSmoke?: UpdateSmokeCheckResult[];
+    lifecycle?: UpdateLifecycleSummary | null;
+    releaseBlockers?: UpdateReleaseBlocker[];
+    p36?: UpdateRolloutReport["p36"];
+}): UpdateRolloutReport;
+export declare function emitRolloutReport(report: UpdateRolloutReport, json: boolean | undefined): void;
+export interface UpdateLifecycleSummary {
+    status: LifecycleResult["status"];
+    resumed: boolean;
+    reason: string | null;
+    planId: string | null;
+    generationId: string | null;
+    generationFingerprint: string | null;
+    adapters: {
+        adapterId: string;
+        status: "succeeded" | "failed" | "pending";
+        attempts: number;
+        reason: string | null;
+        retryable: boolean;
+        projectionFingerprint: string | null;
+    }[];
+}
+//# sourceMappingURL=update-rollout-report.d.ts.map

package/dist/utils/update-rollout-report.d.ts.map

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

package/dist/utils/update-rollout-report.js

@@ -0,0 +1,126 @@
+import { VERSION, PACKAGE_NAME } from "../constants/version.js";
+export const UPDATE_ROLLOUT_REPORT_SCHEMA_VERSION = 1;
+export function buildFilePlanFromChanges(input) {
+    return {
+        added: input.newFiles.map((f) => f.relativePath),
+        autoUpdated: input.autoUpdateFiles.map((f) => f.relativePath),
+        overwritten: [],
+        skipped: [],
+        createdNew: [],
+        unchanged: input.unchangedFiles.map((f) => f.relativePath),
+        userDeleted: input.userDeletedFiles.map((f) => f.relativePath),
+        safeDeleted: input.safeDeletePaths ?? [],
+    };
+}
+export function summarizeMigrationPlan(classified, safeDeleteCandidateCount) {
+    if (!classified) {
+        return {
+            pendingCount: 0,
+            auto: 0,
+            confirm: 0,
+            conflict: 0,
+            safeDeleteCandidates: safeDeleteCandidateCount,
+        };
+    }
+    return {
+        pendingCount: classified.auto.length +
+            classified.confirm.length +
+            classified.conflict.length,
+        auto: classified.auto.length,
+        confirm: classified.confirm.length,
+        conflict: classified.conflict.length,
+        safeDeleteCandidates: safeDeleteCandidateCount,
+    };
+}
+export function migrationResultToSummary(result) {
+    if (!result)
+        return null;
+    return {
+        renamed: result.renamed,
+        deleted: result.deleted,
+        skipped: result.skipped,
+        conflicts: result.conflicts,
+    };
+}
+export function lifecycleResultToSummary(result) {
+    if (!result)
+        return null;
+    return {
+        status: result.status,
+        resumed: result.resumed,
+        reason: result.reason,
+        planId: result.plan?.id ?? null,
+        generationId: result.plan?.target.generationId ?? null,
+        generationFingerprint: result.generationFingerprint,
+        adapters: result.adapters.map((adapter) => ({ ...adapter })),
+    };
+}
+export function createBaseRolloutReport(input) {
+    return {
+        schemaVersion: UPDATE_ROLLOUT_REPORT_SCHEMA_VERSION,
+        generatedAt: new Date().toISOString(),
+        mode: input.mode,
+        outcome: input.outcome,
+        projectPath: input.projectPath,
+        pactile: {
+            cliVersion: VERSION,
+            packageName: PACKAGE_NAME,
+            projectVersionBefore: input.projectVersionBefore,
+            projectVersionAfter: input.projectVersionAfter ?? null,
+            latestNpmVersion: input.latestNpmVersion,
+            cliBehindNpm: input.cliBehindNpm,
+        },
+        options: input.options,
+        plan: {
+            upgradeDirection: input.upgradeDirection,
+            breakingMigrationGateRequired: input.breakingMigrationGateRequired ?? false,
+            files: input.files,
+            conflictsPending: input.conflictsPending,
+            migrations: input.migrations,
+            backupPath: input.backupPath ?? null,
+        },
+        apply: input.apply,
+        readiness: input.readiness,
+        lifecycle: input.lifecycle ?? null,
+        postUpdateSmoke: input.postUpdateSmoke ?? [],
+        releaseBlockers: input.releaseBlockers ?? [],
+        p36: input.p36,
+    };
+}
+export function emitRolloutReport(report, json) {
+    if (json) {
+        process.stdout.write(`${JSON.stringify(report)}\n`);
+        return;
+    }
+    const relBackup = report.plan.backupPath ?? report.apply?.backupPath;
+    console.log("");
+    console.log("--- Rollout evidence (machine-readable) ---");
+    console.log(`  outcome: ${report.outcome}`);
+    console.log(`  mode: ${report.mode}`);
+    console.log(`  versions: ${report.pactile.projectVersionBefore} → ${report.pactile.projectVersionAfter ?? "(unchanged)"} (cli ${report.pactile.cliVersion})`);
+    if (relBackup) {
+        console.log(`  backup: ${relBackup}`);
+    }
+    if (report.lifecycle) {
+        console.log(`  lifecycle: ${report.lifecycle.status} (${report.lifecycle.generationId ?? "no-generation"})`);
+    }
+    const f = report.plan.files;
+    const pending = f.added.length +
+        f.autoUpdated.length +
+        report.plan.conflictsPending.length +
+        f.safeDeleted.length;
+    if (pending > 0 || report.mode === "dry-run") {
+        console.log(`  files: +${f.added.length} auto↑${f.autoUpdated.length} conflicts=${report.plan.conflictsPending.length} skip=${f.skipped.length} overwrite=${f.overwritten.length}`);
+    }
+    if (report.postUpdateSmoke.length > 0) {
+        const failed = report.postUpdateSmoke.filter((s) => !s.ok);
+        console.log(`  post-update smoke: ${report.postUpdateSmoke.length - failed.length}/${report.postUpdateSmoke.length} passed`);
+    }
+    if (report.releaseBlockers.length > 0) {
+        for (const b of report.releaseBlockers) {
+            console.log(`  release blocker: ${b.code} — ${b.message}`);
+        }
+    }
+    console.log("  Tip: re-run with --json for full structured evidence.");
+}
+//# sourceMappingURL=update-rollout-report.js.map

package/dist/utils/update-rollout-report.js.map

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

package/dist/utils/validate-rules.d.ts

@@ -0,0 +1,21 @@
+import { type ExpectedRule } from "../templates/cursor/fixtures/expected-rules.js";
+export interface RuleValidationIssue {
+    filename: string;
+    kind: "missing" | "section" | "size";
+    detail: string;
+}
+export interface RuleValidationResult {
+    ok: boolean;
+    issues: RuleValidationIssue[];
+}
+/** Validate template rules from getAllRules() against the expected manifest. */
+export declare function validateTemplateRules(manifest?: ExpectedRule[]): RuleValidationResult;
+/** Validate installed .cursor/rules/*.mdc on disk against the manifest. */
+export declare function validateRulesDir(rulesDir: string, manifest?: ExpectedRule[]): RuleValidationResult;
+export declare function formatRuleValidationErrors(result: RuleValidationResult): string;
+/**
+ * Hard gate: validate template rules and, when Cursor is configured,
+ * installed rules under cwd/.cursor/rules.
+ */
+export declare function assertCursorRulesValid(cwd: string): void;
+//# sourceMappingURL=validate-rules.d.ts.map

package/dist/utils/validate-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-rules.d.ts","sourceRoot":"","sources":["../../src/utils/validate-rules.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,gDAAgD,CAAC;AAGxD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAsDD,gFAAgF;AAChF,wBAAgB,qBAAqB,CACnC,QAAQ,GAAE,YAAY,EAAkB,GACvC,oBAAoB,CAMtB;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,YAAY,EAAkB,GACvC,oBAAoB,CAYtB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,oBAAoB,GAC3B,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAmBxD"}

package/dist/utils/validate-rules.js

@@ -0,0 +1,88 @@
+import fs from "node:fs";
+import path from "node:path";
+import { AI_TOOLS } from "../types/ai-tools.js";
+import { getAllRules } from "../templates/cursor/index.js";
+import { expectedRules, } from "../templates/cursor/fixtures/expected-rules.js";
+import { normalizeText, normalizedByteLength } from "./normalize-text.js";
+function validateRuleContent(filename, content, spec) {
+    const issues = [];
+    const normalized = normalizeText(content);
+    for (const section of spec.requiredSections) {
+        if (!normalized.includes(section)) {
+            issues.push({
+                filename,
+                kind: "section",
+                detail: `missing required section "${section}"`,
+            });
+        }
+    }
+    const bytes = normalizedByteLength(content);
+    if (bytes < spec.minBytes) {
+        issues.push({
+            filename,
+            kind: "size",
+            detail: `content too short (${bytes} bytes, minimum ${spec.minBytes})`,
+        });
+    }
+    return issues;
+}
+function validateRuleMap(rules, manifest = expectedRules) {
+    const issues = [];
+    for (const spec of manifest) {
+        const content = rules.get(spec.filename);
+        if (content === undefined) {
+            issues.push({
+                filename: spec.filename,
+                kind: "missing",
+                detail: "rule file not found",
+            });
+            continue;
+        }
+        issues.push(...validateRuleContent(spec.filename, content, spec));
+    }
+    return { ok: issues.length === 0, issues };
+}
+/** Validate template rules from getAllRules() against the expected manifest. */
+export function validateTemplateRules(manifest = expectedRules) {
+    const rules = new Map();
+    for (const rule of getAllRules()) {
+        rules.set(rule.name, rule.content);
+    }
+    return validateRuleMap(rules, manifest);
+}
+/** Validate installed .cursor/rules/*.mdc on disk against the manifest. */
+export function validateRulesDir(rulesDir, manifest = expectedRules) {
+    const rules = new Map();
+    for (const spec of manifest) {
+        const filePath = path.join(rulesDir, spec.filename);
+        if (!fs.existsSync(filePath)) {
+            continue;
+        }
+        rules.set(spec.filename, fs.readFileSync(filePath, "utf-8"));
+    }
+    return validateRuleMap(rules, manifest);
+}
+export function formatRuleValidationErrors(result) {
+    return result.issues
+        .map((issue) => `- ${issue.filename}: ${issue.detail}`)
+        .join("\n");
+}
+/**
+ * Hard gate: validate template rules and, when Cursor is configured,
+ * installed rules under cwd/.cursor/rules.
+ */
+export function assertCursorRulesValid(cwd) {
+    const templateResult = validateTemplateRules();
+    if (!templateResult.ok) {
+        throw new Error(`Cursor rules template validation failed:\n${formatRuleValidationErrors(templateResult)}`);
+    }
+    const rulesDir = path.join(cwd, AI_TOOLS.cursor.configDir, "rules");
+    if (!fs.existsSync(rulesDir)) {
+        return;
+    }
+    const installedResult = validateRulesDir(rulesDir);
+    if (!installedResult.ok) {
+        throw new Error(`Cursor rules installation validation failed (${rulesDir}):\n${formatRuleValidationErrors(installedResult)}`);
+    }
+}
+//# sourceMappingURL=validate-rules.js.map

package/dist/utils/validate-rules.js.map

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

package/dist/utils/workflow-dir.d.ts

@@ -0,0 +1,15 @@
+/** Pre-0.3.1 cursor-trellis runtime directory (upstream Trellis still uses this name). */
+export declare const LEGACY_WORKFLOW_DIR = ".trellis";
+export declare const LEGACY_CSTL_WORKFLOW_DIR = ".cstl";
+export declare const CANONICAL_WORKFLOW_DIR = ".pactile";
+/**
+ * Resolve the active workflow directory name for this project. New writes use
+ * `.pactile/`; legacy roots remain read-only discovery inputs during 0.5.x.
+ */
+export declare function resolveWorkflowDirName(cwd: string): string | null;
+/** Absolute path to the active workflow root, or null when not initialized. */
+export declare function workflowDirPath(cwd: string): string | null;
+export declare function isWorkflowInitialized(cwd: string): boolean;
+/** Join a path segment under the active workflow dir (POSIX-style relative segments). */
+export declare function workflowPath(cwd: string, ...segments: string[]): string | null;
+//# sourceMappingURL=workflow-dir.d.ts.map

package/dist/utils/workflow-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-dir.d.ts","sourceRoot":"","sources":["../../src/utils/workflow-dir.ts"],"names":[],"mappings":"AAIA,0FAA0F;AAC1F,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAC9C,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAChD,eAAO,MAAM,sBAAsB,aAAa,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIjE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1D;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,GAAG,QAAQ,EAAE,MAAM,EAAE,GACpB,MAAM,GAAG,IAAI,CAMf"}