@blxzer/pactile 0.5.0

package/dist/utils/file-writer.js

@@ -0,0 +1,203 @@
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { toPosix } from "./posix.js";
+// Global write mode (set from CLI options)
+let globalWriteMode = "ask";
+export function setWriteMode(mode) {
+    globalWriteMode = mode;
+}
+export function getWriteMode() {
+    return globalWriteMode;
+}
+// ---------------------------------------------------------------------------
+// Write recording
+//
+// `pactile init` uses recording to capture exactly which files were actually
+// written this run (vs skipped because they already existed). The captured
+// set is what `.template-hashes.json` should contain — NOT a blind directory
+// walk of `.codex/` / `.claude/` / etc, which would include user-owned files
+// that pre-dated init. See `pruneOrphanManifestKeys` for the self-heal side
+// of the same contract.
+// ---------------------------------------------------------------------------
+/** When recording is active, every actual `writeFile` disk write appends here. */
+let writeRecorder = null;
+/** Project root used to convert absolute write paths to POSIX-relative keys. */
+let writeRecorderRoot = null;
+/**
+ * Begin recording every write into the returned Set. Calls accumulate into the
+ * same set until `stopRecordingWrites` runs. POSIX relative paths (relative to
+ * `cwd`) are stored, matching `.template-hashes.json` keys.
+ *
+ * Nested recording sessions are NOT supported — the caller must ensure
+ * `stopRecordingWrites` runs before the next `startRecordingWrites`. Failure
+ * is silent (the second `start` replaces the first set), so callers should
+ * always pair start/stop in try/finally.
+ */
+export function startRecordingWrites(cwd) {
+    const sink = new Set();
+    writeRecorder = sink;
+    writeRecorderRoot = cwd;
+    return sink;
+}
+/** End recording. Subsequent writes are not captured until `start` is called again. */
+export function stopRecordingWrites() {
+    writeRecorder = null;
+    writeRecorderRoot = null;
+}
+/** Record a successful write. Called internally by `writeFile`. */
+function recordWrite(absPath) {
+    if (!writeRecorder || !writeRecorderRoot)
+        return;
+    const rel = path.relative(writeRecorderRoot, absPath);
+    // Defensive: skip writes outside cwd (no meaningful manifest key).
+    if (rel.startsWith("..") || path.isAbsolute(rel))
+        return;
+    writeRecorder.add(toPosix(rel));
+}
+/**
+ * Get relative path from cwd for display
+ */
+function getRelativePath(filePath) {
+    const cwd = process.cwd();
+    const relativePath = path.relative(cwd, filePath);
+    return relativePath || path.basename(filePath);
+}
+/**
+ * Append content to file
+ */
+function appendToFile(filePath, content, options) {
+    const existingContent = fs.readFileSync(filePath, "utf-8");
+    const newContent = existingContent.endsWith("\n")
+        ? existingContent + content
+        : existingContent + "\n" + content;
+    fs.writeFileSync(filePath, newContent);
+    if (options?.executable) {
+        fs.chmodSync(filePath, "755");
+    }
+}
+/**
+ * Write file with conflict handling
+ * - If file doesn't exist: write directly
+ * - If file exists and content is identical: skip silently
+ * - If file exists and mode is 'force': overwrite
+ * - If file exists and mode is 'skip': skip
+ * - If file exists and mode is 'append': append to end
+ * - If file exists and mode is 'ask': prompt user
+ */
+export async function writeFile(filePath, content, options) {
+    const exists = fs.existsSync(filePath);
+    const displayPath = getRelativePath(filePath);
+    if (!exists) {
+        // File doesn't exist, write directly
+        fs.writeFileSync(filePath, content);
+        if (options?.executable) {
+            fs.chmodSync(filePath, "755");
+        }
+        recordWrite(filePath);
+        return true;
+    }
+    // File exists, check if content is identical
+    const existingContent = fs.readFileSync(filePath, "utf-8");
+    if (existingContent === content) {
+        // Content identical, but no disk write happened. Do not record it for
+        // init-time manifests: pre-existing user files can legitimately be
+        // byte-identical to a Pactile template and still not be Pactile-owned.
+        return false;
+    }
+    // File exists with different content, handle based on mode.
+    // Non-TTY (CI, pipes, scripted runs): never prompt — fall back to skip
+    // rather than crash with ERR_USE_AFTER_CLOSE if a CLI flag forgot to call
+    // setWriteMode. Layer-level safety net for the init.ts mapping.
+    const mode = globalWriteMode === "ask" && !process.stdin.isTTY
+        ? "skip"
+        : globalWriteMode;
+    if (mode === "force") {
+        fs.writeFileSync(filePath, content);
+        if (options?.executable) {
+            fs.chmodSync(filePath, "755");
+        }
+        console.log(chalk.yellow(`  ↻ Overwritten: ${displayPath}`));
+        recordWrite(filePath);
+        return true;
+    }
+    if (mode === "skip") {
+        console.log(chalk.gray(`  ○ Skipped: ${displayPath} (already exists)`));
+        // Skipped: Pactile did not write this file — caller should not track it
+        // in the manifest. This is the AGENTS.md skip-existing case.
+        return false;
+    }
+    if (mode === "append") {
+        appendToFile(filePath, content, options);
+        console.log(chalk.blue(`  + Appended: ${displayPath}`));
+        // Append: Pactile added managed content to a user-owned file. Tracking
+        // is risky here (uninstall would unlink the whole file), so we do NOT
+        // record appended files. Users on `--append` get a fresh manifest miss
+        // on next update; that's the safer default.
+        return true;
+    }
+    // mode === 'ask': Interactive prompt
+    const { action } = await inquirer.prompt([
+        {
+            type: "list",
+            name: "action",
+            message: `File "${displayPath}" already exists. What would you like to do?`,
+            choices: [
+                { name: "Skip (keep existing)", value: "skip" },
+                { name: "Overwrite", value: "overwrite" },
+                { name: "Append to end", value: "append" },
+                { name: "Skip all remaining conflicts", value: "skip-all" },
+                { name: "Overwrite all remaining conflicts", value: "overwrite-all" },
+                { name: "Append all remaining conflicts", value: "append-all" },
+            ],
+        },
+    ]);
+    if (action === "skip") {
+        console.log(chalk.gray(`  ○ Skipped: ${displayPath}`));
+        return false;
+    }
+    if (action === "overwrite") {
+        fs.writeFileSync(filePath, content);
+        if (options?.executable) {
+            fs.chmodSync(filePath, "755");
+        }
+        console.log(chalk.yellow(`  ↻ Overwritten: ${displayPath}`));
+        recordWrite(filePath);
+        return true;
+    }
+    if (action === "append") {
+        appendToFile(filePath, content, options);
+        console.log(chalk.blue(`  + Appended: ${displayPath}`));
+        return true;
+    }
+    if (action === "skip-all") {
+        globalWriteMode = "skip";
+        console.log(chalk.gray(`  ○ Skipped: ${displayPath}`));
+        return false;
+    }
+    if (action === "overwrite-all") {
+        globalWriteMode = "force";
+        fs.writeFileSync(filePath, content);
+        if (options?.executable) {
+            fs.chmodSync(filePath, "755");
+        }
+        console.log(chalk.yellow(`  ↻ Overwritten: ${displayPath}`));
+        recordWrite(filePath);
+        return true;
+    }
+    if (action === "append-all") {
+        globalWriteMode = "append";
+        appendToFile(filePath, content, options);
+        console.log(chalk.blue(`  + Appended: ${displayPath}`));
+        return true;
+    }
+    return false;
+}
+/**
+ * Ensure directory exists
+ */
+export function ensureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+//# sourceMappingURL=file-writer.js.map

package/dist/utils/file-writer.js.map

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

package/dist/utils/manifest-prune.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Self-heal poisoned `.template-hashes.json` manifests.
+ *
+ * Versions before this fix walked `.codex/`, `.claude/`, etc. with a blind
+ * recursive scan when computing the manifest, so they hashed user-owned
+ * runtime data (`.codex/sessions/*`, `.claude/projects/*.jsonl`, pre-existing
+ * `AGENTS.md`, user-added `.codex/skills/<custom>/`, …). On uninstall, every
+ * manifest entry is unlinked, which silently deletes user data.
+ *
+ * `pruneOrphanManifestKeys` removes any manifest entry that no current
+ * platform configurator owns. The two entry points that consume it are
+ * `pactile update` (before migration classification) and lifecycle cleanup
+ * (before plan building). Together they ensure existing poisoned manifests
+ * self-correct on the next routine command.
+ *
+ * Rules:
+ *   - Canonical `.pactile/*` entries are kept only for framework-managed
+ *     content; user task/workspace/spec and middleware state is excluded.
+ *   - Root-level `AGENTS.md` is kept only when it still looks Pactile-managed
+ *     (contains the managed block markers) or is missing on disk. This
+ *     self-heals old poisoned manifests for user-owned AGENTS.md files that
+ *     predated init and were skipped.
+ *   - Paths referenced by `from`/`to` of any migration manifest entry
+ *     (rename, rename-dir, delete, safe-file-delete) are preserved. Pruning
+ *     them would prevent legitimate pending migrations from finding their
+ *     source/target.
+ *   - Everything else: if the path is not in the union of
+ *     `collectPlatformTemplates()` for currently-configured platforms, it is
+ *     pruned. This matches files Pactile actually wrote during init/update.
+ */
+import type { AITool } from "../types/ai-tools.js";
+import type { TemplateHashes } from "../types/migration.js";
+export interface PruneResult {
+    /** Manifest keys removed (POSIX-style relative paths). */
+    pruned: string[];
+    /** The post-prune manifest (saved to disk only when `pruned.length > 0`). */
+    hashes: TemplateHashes;
+}
+export interface PruneOptions {
+    /**
+     * Save the pruned manifest to `.template-hashes.json`. Defaults to true.
+     * Callers can pass `false` to compute the prune without mutating disk
+     * (dry-run, change-analysis passes).
+     */
+    persist?: boolean;
+}
+/**
+ * Walk the manifest and split it into kept vs pruned entries.
+ *
+ * @param cwd  Project root — used to save the rewritten manifest.
+ * @param configuredPlatforms Output of `getConfiguredPlatforms(cwd)` — caller
+ *   resolves this so we don't have to re-walk the filesystem.
+ * @param hashes Already-loaded manifest contents. Passing it in (vs reading
+ *   from disk) lets the caller chain `loadHashes` → prune → use the result.
+ * @param options.persist When true (default), saves the pruned manifest to
+ *   disk. Pass `false` for dry-run flows.
+ */
+export declare function pruneOrphanManifestKeys(cwd: string, configuredPlatforms: readonly AITool[], hashes: TemplateHashes, options?: PruneOptions): PruneResult;
+//# sourceMappingURL=manifest-prune.d.ts.map

package/dist/utils/manifest-prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-prune.d.ts","sourceRoot":"","sources":["../../src/utils/manifest-prune.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAiBH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,MAAM,EAAE,cAAc,CAAC;CACxB;AAgED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,mBAAmB,EAAE,SAAS,MAAM,EAAE,EACtC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,YAAiB,GACzB,WAAW,CAwEb"}

package/dist/utils/manifest-prune.js

@@ -0,0 +1,176 @@
+/**
+ * Self-heal poisoned `.template-hashes.json` manifests.
+ *
+ * Versions before this fix walked `.codex/`, `.claude/`, etc. with a blind
+ * recursive scan when computing the manifest, so they hashed user-owned
+ * runtime data (`.codex/sessions/*`, `.claude/projects/*.jsonl`, pre-existing
+ * `AGENTS.md`, user-added `.codex/skills/<custom>/`, …). On uninstall, every
+ * manifest entry is unlinked, which silently deletes user data.
+ *
+ * `pruneOrphanManifestKeys` removes any manifest entry that no current
+ * platform configurator owns. The two entry points that consume it are
+ * `pactile update` (before migration classification) and lifecycle cleanup
+ * (before plan building). Together they ensure existing poisoned manifests
+ * self-correct on the next routine command.
+ *
+ * Rules:
+ *   - Canonical `.pactile/*` entries are kept only for framework-managed
+ *     content; user task/workspace/spec and middleware state is excluded.
+ *   - Root-level `AGENTS.md` is kept only when it still looks Pactile-managed
+ *     (contains the managed block markers) or is missing on disk. This
+ *     self-heals old poisoned manifests for user-owned AGENTS.md files that
+ *     predated init and were skipped.
+ *   - Paths referenced by `from`/`to` of any migration manifest entry
+ *     (rename, rename-dir, delete, safe-file-delete) are preserved. Pruning
+ *     them would prevent legitimate pending migrations from finding their
+ *     source/target.
+ *   - Everything else: if the path is not in the union of
+ *     `collectPlatformTemplates()` for currently-configured platforms, it is
+ *     pruned. This matches files Pactile actually wrote during init/update.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { collectPlatformTemplates } from "../configurators/index.js";
+import { getWorkflowRootTemplateFiles } from "../configurators/workflow.js";
+import { FILE_NAMES, isUserMiddlewareOverlayPath } from "../constants/paths.js";
+import { getAllMigrations } from "../migrations/index.js";
+import { saveHashes } from "./template-hash.js";
+import { toPosix } from "./posix.js";
+import { LEGACY_CSTL_BLOCK_END, LEGACY_CSTL_BLOCK_START, PACTILE_BLOCK_END, PACTILE_BLOCK_START, } from "./agents-md.js";
+/**
+ * Compute the union of what Pactile writes across:
+ *   - every configured platform's collectTemplates() output
+ *   - root-level AGENTS.md when it still carries an owned managed block
+ *   - every migration manifest's from/to path (preserve so legitimate
+ *     pending migrations can find their source/target)
+ */
+function buildKnownKeys(configuredPlatforms) {
+    const known = new Set();
+    for (const id of configuredPlatforms) {
+        const templates = collectPlatformTemplates(id);
+        if (!templates)
+            continue;
+        for (const key of templates.keys()) {
+            known.add(toPosix(key));
+        }
+    }
+    // Root-level files written by the workflow configurator (CONTEXT.md,
+    // docs/adr/README.md) — they live outside platform config dirs but are
+    // Pactile-owned, so lifecycle reconciliation must recognize them.
+    for (const key of getWorkflowRootTemplateFiles().keys()) {
+        known.add(toPosix(key));
+    }
+    // Preserve any path referenced by a migration: legitimate pending
+    // rename/delete operations need to resolve their `from` (and the target's
+    // hash record for `to`) even if the current registry doesn't list it.
+    for (const migration of getAllMigrations()) {
+        if (migration.from)
+            known.add(toPosix(migration.from));
+        if (migration.to)
+            known.add(toPosix(migration.to));
+    }
+    return known;
+}
+/**
+ * Root-level AGENTS.md needs special handling because it has no platform
+ * registry owner. New fixed inits record it only when written, but old
+ * manifests may contain a user-owned AGENTS.md that init skipped. The
+ * managed block markers are the least destructive ownership signal: no
+ * markers means preserve the user's file by pruning the stale manifest key.
+ */
+function shouldKeepAgentsMd(cwd, canonicalInstall) {
+    const fullPath = path.join(cwd, FILE_NAMES.AGENTS);
+    if (!fs.existsSync(fullPath)) {
+        return true;
+    }
+    try {
+        const content = fs.readFileSync(fullPath, "utf-8");
+        if (canonicalInstall) {
+            return (content.includes(PACTILE_BLOCK_START) &&
+                content.includes(PACTILE_BLOCK_END));
+        }
+        return (content.includes(LEGACY_CSTL_BLOCK_START) &&
+            content.includes(LEGACY_CSTL_BLOCK_END));
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Walk the manifest and split it into kept vs pruned entries.
+ *
+ * @param cwd  Project root — used to save the rewritten manifest.
+ * @param configuredPlatforms Output of `getConfiguredPlatforms(cwd)` — caller
+ *   resolves this so we don't have to re-walk the filesystem.
+ * @param hashes Already-loaded manifest contents. Passing it in (vs reading
+ *   from disk) lets the caller chain `loadHashes` → prune → use the result.
+ * @param options.persist When true (default), saves the pruned manifest to
+ *   disk. Pass `false` for dry-run flows.
+ */
+export function pruneOrphanManifestKeys(cwd, configuredPlatforms, hashes, options = {}) {
+    const persist = options.persist ?? true;
+    const known = buildKnownKeys(configuredPlatforms);
+    const pruned = [];
+    const kept = {};
+    const canonicalInstall = fs.existsSync(path.join(cwd, ".pactile"));
+    const projectionOwned = [
+        "AGENTS.md",
+        ".agents/",
+        ".cursor/",
+        ".codex/",
+    ];
+    for (const [rawKey, value] of Object.entries(hashes)) {
+        const key = toPosix(rawKey);
+        if (canonicalInstall &&
+            projectionOwned.some((prefix) => key === prefix || key.startsWith(prefix))) {
+            pruned.push(key);
+            continue;
+        }
+        // A user middleware overlay must never stay in the template hash.
+        if (isUserMiddlewareOverlayPath(key)) {
+            pruned.push(key);
+            continue;
+        }
+        if (canonicalInstall && (key.startsWith(".cstl/") || key === ".cstl")) {
+            pruned.push(key);
+            continue;
+        }
+        if (key.startsWith(".pactile/") || key === ".pactile") {
+            if (key === ".pactile/spec" ||
+                key.startsWith(".pactile/spec/") ||
+                key === ".pactile/tasks" ||
+                key.startsWith(".pactile/tasks/") ||
+                key === ".pactile/workspace" ||
+                key.startsWith(".pactile/workspace/")) {
+                pruned.push(key);
+            }
+            else {
+                kept[key] = value;
+            }
+            continue;
+        }
+        if (!canonicalInstall && (key.startsWith(".cstl/") || key === ".cstl")) {
+            kept[key] = value;
+            continue;
+        }
+        if (key === FILE_NAMES.AGENTS) {
+            if (shouldKeepAgentsMd(cwd, canonicalInstall)) {
+                kept[key] = value;
+            }
+            else {
+                pruned.push(key);
+            }
+            continue;
+        }
+        if (known.has(key)) {
+            kept[key] = value;
+            continue;
+        }
+        pruned.push(key);
+    }
+    if (persist && pruned.length > 0) {
+        saveHashes(cwd, kept);
+    }
+    return { pruned, hashes: kept };
+}
+//# sourceMappingURL=manifest-prune.js.map

package/dist/utils/manifest-prune.js.map

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

package/dist/utils/mirror-check.d.ts

@@ -0,0 +1,22 @@
+export interface MirrorDiffEntry {
+    relativePath: string;
+    kind: "missing-dogfood" | "missing-template" | "content";
+}
+export interface MirrorCheckOptions {
+    /** Project root containing .cursor/ and AGENTS.md (dogfood instance) */
+    dogfoodRoot: string;
+    /** Path to packages/cli/src/templates/cursor */
+    templateCursorDir: string;
+    /** Path to packages/cli/src/templates/markdown/agents.md */
+    templateAgentsPath: string;
+}
+export interface MirrorCheckResult {
+    ok: boolean;
+    diffs: MirrorDiffEntry[];
+}
+/** Extract the canonical managed block for AGENTS.md mirror comparison. */
+export declare function extractPactileManagedBlock(content: string): string;
+/** Compare dogfood .cursor/{rules,agents} + AGENTS.md against CLI templates. */
+export declare function runMirrorCheck(options: MirrorCheckOptions): MirrorCheckResult;
+export declare function formatMirrorDiffs(diffs: MirrorDiffEntry[]): string;
+//# sourceMappingURL=mirror-check.d.ts.map

package/dist/utils/mirror-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirror-check.d.ts","sourceRoot":"","sources":["../../src/utils/mirror-check.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAOD,2EAA2E;AAC3E,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASlE;AAoDD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA+B7E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAalE"}

package/dist/utils/mirror-check.js

@@ -0,0 +1,90 @@
+import fs from "node:fs";
+import path from "node:path";
+import { FILE_NAMES } from "../constants/paths.js";
+import { normalizeText } from "./normalize-text.js";
+const MIRROR_SUBDIRS = ["rules", "agents"];
+const PACTILE_BLOCK_START = "<!-- PACTILE:START -->";
+const PACTILE_BLOCK_END = "<!-- PACTILE:END -->";
+/** Extract the canonical managed block for AGENTS.md mirror comparison. */
+export function extractPactileManagedBlock(content) {
+    const startIdx = content.indexOf(PACTILE_BLOCK_START);
+    const endIdx = content.indexOf(PACTILE_BLOCK_END);
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        return normalizeText(content.slice(startIdx, endIdx + PACTILE_BLOCK_END.length));
+    }
+    return normalizeText(content);
+}
+function listRelativeFiles(root, subdir) {
+    const dir = path.join(root, subdir);
+    if (!fs.existsSync(dir)) {
+        return [];
+    }
+    return fs
+        .readdirSync(dir)
+        .filter((name) => !name.startsWith("."))
+        .sort()
+        .map((name) => path.posix.join(subdir, name));
+}
+function compareFilePair(relativePath, dogfoodPath, templatePath) {
+    const dogfoodExists = fs.existsSync(dogfoodPath);
+    const templateExists = fs.existsSync(templatePath);
+    if (!dogfoodExists && templateExists) {
+        return { relativePath, kind: "missing-dogfood" };
+    }
+    if (dogfoodExists && !templateExists) {
+        return { relativePath, kind: "missing-template" };
+    }
+    if (!dogfoodExists && !templateExists) {
+        return null;
+    }
+    let dogfood;
+    let template;
+    if (relativePath === FILE_NAMES.AGENTS) {
+        dogfood = extractPactileManagedBlock(fs.readFileSync(dogfoodPath, "utf-8"));
+        template = extractPactileManagedBlock(fs.readFileSync(templatePath, "utf-8"));
+    }
+    else {
+        dogfood = normalizeText(fs.readFileSync(dogfoodPath, "utf-8"));
+        template = normalizeText(fs.readFileSync(templatePath, "utf-8"));
+    }
+    if (dogfood !== template) {
+        return { relativePath, kind: "content" };
+    }
+    return null;
+}
+/** Compare dogfood .cursor/{rules,agents} + AGENTS.md against CLI templates. */
+export function runMirrorCheck(options) {
+    const dogfoodCursor = path.join(options.dogfoodRoot, ".cursor");
+    const diffs = [];
+    for (const subdir of MIRROR_SUBDIRS) {
+        const dogfoodFiles = listRelativeFiles(dogfoodCursor, subdir);
+        const templateFiles = listRelativeFiles(options.templateCursorDir, subdir);
+        const allFiles = [...new Set([...dogfoodFiles, ...templateFiles])].sort();
+        for (const relativePath of allFiles) {
+            const diff = compareFilePair(relativePath, path.join(dogfoodCursor, relativePath), path.join(options.templateCursorDir, relativePath));
+            if (diff) {
+                diffs.push(diff);
+            }
+        }
+    }
+    const agentsDiff = compareFilePair(FILE_NAMES.AGENTS, path.join(options.dogfoodRoot, FILE_NAMES.AGENTS), options.templateAgentsPath);
+    if (agentsDiff) {
+        diffs.push(agentsDiff);
+    }
+    return { ok: diffs.length === 0, diffs };
+}
+export function formatMirrorDiffs(diffs) {
+    return diffs
+        .map((entry) => {
+        switch (entry.kind) {
+            case "missing-dogfood":
+                return `- ${entry.relativePath}: present in template, missing in dogfood`;
+            case "missing-template":
+                return `- ${entry.relativePath}: present in dogfood, missing in template`;
+            case "content":
+                return `- ${entry.relativePath}: content differs (normalized)`;
+        }
+    })
+        .join("\n");
+}
+//# sourceMappingURL=mirror-check.js.map

package/dist/utils/mirror-check.js.map

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

package/dist/utils/normalize-text.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Normalize text for mirror diff and rules validation comparisons.
+ * Trims trailing whitespace per line and normalizes line endings to LF.
+ */
+export declare function normalizeText(content: string): string;
+export declare function normalizedByteLength(content: string): number;
+//# sourceMappingURL=normalize-text.d.ts.map

package/dist/utils/normalize-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-text.d.ts","sourceRoot":"","sources":["../../src/utils/normalize-text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/utils/normalize-text.js

@@ -0,0 +1,16 @@
+/**
+ * Normalize text for mirror diff and rules validation comparisons.
+ * Trims trailing whitespace per line and normalizes line endings to LF.
+ */
+export function normalizeText(content) {
+    return content
+        .replace(/\r\n/g, "\n")
+        .replace(/\r/g, "\n")
+        .split("\n")
+        .map((line) => line.replace(/[ \t]+$/u, ""))
+        .join("\n");
+}
+export function normalizedByteLength(content) {
+    return Buffer.byteLength(normalizeText(content), "utf-8");
+}
+//# sourceMappingURL=normalize-text.js.map

package/dist/utils/normalize-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-text.js","sourceRoot":"","sources":["../../src/utils/normalize-text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,OAAO;SACX,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;SAC3C,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC"}