link-agents 0.9.0

package/dist/utils/apply.js

@@ -0,0 +1,215 @@
+import chalk from "chalk";
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+import { writeFileSafe, createBackup, restoreBackup, verifyFileHash, readFileSafe, hashContent, fileExists, } from "./fs.js";
+import { transformContentForClient } from "./frontmatter.js";
+import { updateManifest, pruneStaleFiles } from "./manifest.js";
+const BACKUP_DIR = path.join(os.homedir(), ".link-agents", "backups");
+const MAX_BACKUPS = 10;
+function getWriteModeLabel(useSymlink, action) {
+    return useSymlink ? "link" : action;
+}
+export async function applyPlan(plan, options) {
+    const result = {
+        applied: 0,
+        skipped: 0,
+        failed: 0,
+        backups: [],
+        errors: [],
+        rolledBack: false,
+    };
+    if (plan.length === 0) {
+        if (options.verbose) {
+            console.log(chalk.green("No changes required."));
+        }
+        return result;
+    }
+    const appliedChanges = [];
+    for (const entry of plan) {
+        const displayPath = entry.targetRelativePath ?? entry.asset.relativePath;
+        if (entry.action === "skip") {
+            if (options.verbose) {
+                console.log(chalk.gray(`skip   ${entry.targetClient} :: ${displayPath}`));
+            }
+            result.skipped++;
+            continue;
+        }
+        // Transform content for target client (e.g., OpenCode frontmatter format)
+        const transformedContent = transformContentForClient(entry.asset.content, entry.targetClient, entry.asset.type);
+        const symlinkEligible = Boolean(options.link) &&
+            (await canWriteAsSymlink(entry, transformedContent));
+        const actionLabel = getWriteModeLabel(symlinkEligible, entry.action);
+        if (symlinkEligible) {
+            const alreadyLinked = await isSymlinkToTarget(entry.targetPath, entry.asset.path);
+            if (alreadyLinked) {
+                if (options.verbose) {
+                    console.log(chalk.gray(`unchanged ${entry.targetClient} :: ${displayPath}`));
+                }
+                result.skipped++;
+                continue;
+            }
+        }
+        else {
+            // Check if file already has identical content (skip unchanged)
+            const existingContent = await readFileSafe(entry.targetPath);
+            if (existingContent !== null) {
+                const existingHash = hashContent(existingContent);
+                const newHash = hashContent(transformedContent);
+                if (existingHash === newHash) {
+                    if (options.verbose) {
+                        console.log(chalk.gray(`unchanged ${entry.targetClient} :: ${displayPath}`));
+                    }
+                    result.skipped++;
+                    continue;
+                }
+            }
+        }
+        if (options.dryRun) {
+            console.log(chalk.yellow(`${actionLabel.padEnd(7)} ${entry.targetClient} :: ${displayPath}`));
+            result.applied++;
+            continue;
+        }
+        let backupPath = null;
+        try {
+            // Create backup before overwrite
+            backupPath = await createBackup(entry.targetPath);
+            if (backupPath) {
+                result.backups.push(backupPath);
+                if (options.verbose) {
+                    console.log(chalk.dim(`  backup: ${backupPath}`));
+                }
+            }
+            if (symlinkEligible) {
+                await writeSymlinkSafe(entry.asset.path, entry.targetPath);
+            }
+            else {
+                await writeFileSafe(entry.targetPath, transformedContent);
+            }
+            console.log(chalk.green(`${actionLabel.padEnd(7)} ${entry.targetClient} :: ${displayPath}`));
+            // Post-sync verification
+            const verified = symlinkEligible
+                ? await isSymlinkToTarget(entry.targetPath, entry.asset.path)
+                : await verifyFileHash(entry.targetPath, transformedContent);
+            if (!verified) {
+                const error = `Verification failed for ${entry.targetPath}`;
+                result.errors.push(error);
+                console.log(chalk.red(`  ✗ ${error}`));
+                result.failed++;
+                await rollbackChanges(appliedChanges, result, options.verbose);
+                return result;
+            }
+            appliedChanges.push({ targetPath: entry.targetPath, backupPath });
+            result.applied++;
+        }
+        catch (err) {
+            const error = `Failed to write ${entry.targetPath}: ${err}`;
+            result.errors.push(error);
+            console.log(chalk.red(`  ✗ ${error}`));
+            result.failed++;
+            await rollbackChanges(appliedChanges, result, options.verbose);
+            return result;
+        }
+    }
+    return result;
+}
+async function canWriteAsSymlink(entry, transformedContent) {
+    const sourceContent = await readFileSafe(entry.asset.path);
+    return sourceContent === transformedContent;
+}
+async function isSymlinkToTarget(linkPath, targetPath) {
+    try {
+        const stats = await fs.lstat(linkPath);
+        if (!stats.isSymbolicLink()) {
+            return false;
+        }
+        const linkTarget = await fs.readlink(linkPath);
+        const resolvedTarget = path.resolve(path.dirname(linkPath), linkTarget);
+        return resolvedTarget === path.resolve(targetPath);
+    }
+    catch {
+        return false;
+    }
+}
+async function writeSymlinkSafe(sourcePath, targetPath) {
+    await fs.mkdir(path.dirname(targetPath), { recursive: true });
+    await fs.rm(targetPath, { force: true, recursive: true });
+    const linkTarget = path.relative(path.dirname(targetPath), sourcePath);
+    await fs.symlink(linkTarget, targetPath);
+}
+async function rollbackChanges(changes, result, verbose) {
+    if (changes.length === 0)
+        return;
+    console.log();
+    console.log(chalk.yellow(`Rolling back ${changes.length} change(s)...`));
+    for (const change of changes.reverse()) {
+        if (change.backupPath) {
+            const restored = await restoreBackup(change.backupPath, change.targetPath);
+            if (restored) {
+                if (verbose) {
+                    console.log(chalk.dim(`  restored: ${change.targetPath}`));
+                }
+            }
+            else {
+                result.errors.push(`Failed to restore ${change.targetPath}`);
+            }
+        }
+    }
+    result.rolledBack = true;
+    console.log(chalk.yellow("Rollback complete."));
+}
+/**
+ * Cleanup old backups beyond MAX_BACKUPS limit.
+ */
+export async function cleanupOldBackups() {
+    try {
+        if (!(await fileExists(BACKUP_DIR))) {
+            return 0;
+        }
+        const entries = await fs.readdir(BACKUP_DIR);
+        const backupDirs = entries
+            .filter((e) => e.match(/^\d{4}-\d{2}-\d{2}T/))
+            .sort()
+            .reverse();
+        if (backupDirs.length <= MAX_BACKUPS) {
+            return 0;
+        }
+        const toDelete = backupDirs.slice(MAX_BACKUPS);
+        let deleted = 0;
+        for (const dir of toDelete) {
+            try {
+                await fs.rm(path.join(BACKUP_DIR, dir), { recursive: true });
+                deleted++;
+            }
+            catch {
+                // Ignore deletion errors
+            }
+        }
+        return deleted;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Update manifest with generated files and prune stale files.
+ */
+export async function postApplyCleanup(appliedPaths, verbose) {
+    // Prune stale files from previous syncs
+    const pruned = await pruneStaleFiles(appliedPaths);
+    if (pruned.length > 0 && verbose) {
+        console.log(chalk.dim(`Cleaned up ${pruned.length} stale file(s)`));
+        for (const f of pruned) {
+            console.log(chalk.dim(`  removed: ${f}`));
+        }
+    }
+    // Update manifest with current files
+    await updateManifest(appliedPaths);
+    // Cleanup old backups
+    const deletedBackups = await cleanupOldBackups();
+    if (deletedBackups > 0 && verbose) {
+        console.log(chalk.dim(`Cleaned up ${deletedBackups} old backup(s)`));
+    }
+    return { pruned, manifestUpdated: true };
+}
+//# sourceMappingURL=apply.js.map

package/dist/utils/apply.js.map

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

package/dist/utils/bootstrap.d.ts

@@ -0,0 +1,18 @@
+import type { AgentClientName, AssetContent } from "../types/index.js";
+interface BootstrapResolutionInput {
+    canonicalPath: string;
+    candidates: AssetContent[];
+    bootstrapSource?: AgentClientName;
+}
+type BootstrapResolution = {
+    status: "missing";
+} | {
+    status: "selected";
+    asset: AssetContent;
+} | {
+    status: "ambiguous";
+    candidates: AssetContent[];
+};
+export declare function getBootstrapResolution(input: BootstrapResolutionInput): BootstrapResolution;
+export {};
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/utils/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/utils/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEvE,UAAU,wBAAwB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,KAAK,mBAAmB,GACpB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAC3C;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAExD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CAsCrB"}

package/dist/utils/bootstrap.js

@@ -0,0 +1,31 @@
+export function getBootstrapResolution(input) {
+    const { candidates, bootstrapSource, canonicalPath } = input;
+    if (candidates.length === 0) {
+        return { status: "missing" };
+    }
+    if (bootstrapSource) {
+        const matches = candidates.filter((asset) => asset.client === bootstrapSource);
+        if (matches.length === 0) {
+            throw new Error(`bootstrap-source ${bootstrapSource} is not available for ${canonicalPath}`);
+        }
+        if (matches.length === 1) {
+            return { status: "selected", asset: matches[0] };
+        }
+        return { status: "ambiguous", candidates: matches };
+    }
+    if (candidates.length === 1) {
+        return { status: "selected", asset: candidates[0] };
+    }
+    // All candidates have the same content — pick the newest, no need to ask
+    const allIdentical = candidates.every((c) => c.hash === candidates[0].hash);
+    if (allIdentical) {
+        const newest = [...candidates].sort((a, b) => {
+            const ta = a.modifiedAt?.getTime() ?? 0;
+            const tb = b.modifiedAt?.getTime() ?? 0;
+            return tb - ta;
+        });
+        return { status: "selected", asset: newest[0] };
+    }
+    return { status: "ambiguous", candidates };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/utils/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/utils/bootstrap.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,sBAAsB,CACpC,KAA+B;IAE/B,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAE7D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAC/B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,eAAe,CAC5C,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,oBAAoB,eAAe,yBAAyB,aAAa,EAAE,CAC5E,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,CAAC;IAED,yEAAyE;IACzE,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5E,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC3C,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACxC,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACxC,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAC7C,CAAC"}

package/dist/utils/bootstrap.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bootstrap.spec.d.ts.map

package/dist/utils/bootstrap.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.spec.d.ts","sourceRoot":"","sources":["../../src/utils/bootstrap.spec.ts"],"names":[],"mappings":""}

package/dist/utils/bootstrap.spec.js

@@ -0,0 +1,92 @@
+import { describe, expect, it } from "vitest";
+import { hashContent } from "./fs.js";
+import { getBootstrapResolution } from "./bootstrap.js";
+import { buildLegacyDefinitions } from "./canonical.js";
+function makeAsset(client, type, relativePath, content = `${client}:${relativePath}`) {
+    return {
+        client,
+        type,
+        path: `/${client}/${relativePath}`,
+        relativePath,
+        canonicalPath: relativePath,
+        name: relativePath,
+        content,
+        hash: hashContent(content),
+    };
+}
+describe("getBootstrapResolution", () => {
+    it("returns missing when there are no candidates", () => {
+        expect(getBootstrapResolution({
+            canonicalPath: "AGENTS.md",
+            candidates: [],
+        })).toEqual({ status: "missing" });
+    });
+    it("auto-selects the only candidate", () => {
+        const candidate = makeAsset("claude", "agents", "AGENTS.md");
+        expect(getBootstrapResolution({
+            canonicalPath: "AGENTS.md",
+            candidates: [candidate],
+        })).toEqual({ status: "selected", asset: candidate });
+    });
+    it("uses the explicit bootstrap source when present", () => {
+        const claude = makeAsset("claude", "agents", "AGENTS.md");
+        const cursor = makeAsset("cursor", "agents", "AGENTS.md");
+        expect(getBootstrapResolution({
+            canonicalPath: "AGENTS.md",
+            candidates: [claude, cursor],
+            bootstrapSource: "cursor",
+        })).toEqual({ status: "selected", asset: cursor });
+    });
+    it("errors when the explicit bootstrap source is not available", () => {
+        const claude = makeAsset("claude", "agents", "AGENTS.md");
+        const cursor = makeAsset("cursor", "agents", "AGENTS.md");
+        expect(() => getBootstrapResolution({
+            canonicalPath: "AGENTS.md",
+            candidates: [claude, cursor],
+            bootstrapSource: "codex",
+        })).toThrow(/bootstrap-source codex is not available/i);
+    });
+    it("auto-selects newest when all candidates have identical content", () => {
+        const shared = "identical content";
+        const claude = makeAsset("claude", "agents", "AGENTS.md", shared);
+        claude.modifiedAt = new Date("2026-01-01");
+        const cursor = makeAsset("cursor", "agents", "AGENTS.md", shared);
+        cursor.modifiedAt = new Date("2026-03-01");
+        expect(getBootstrapResolution({
+            canonicalPath: "AGENTS.md",
+            candidates: [claude, cursor],
+        })).toEqual({ status: "selected", asset: cursor });
+    });
+    it("surfaces ambiguity when candidates have different content", () => {
+        const claude = makeAsset("claude", "agents", "AGENTS.md");
+        const cursor = makeAsset("cursor", "agents", "AGENTS.md");
+        expect(getBootstrapResolution({
+            canonicalPath: "AGENTS.md",
+            candidates: [claude, cursor],
+        })).toEqual({
+            status: "ambiguous",
+            candidates: [claude, cursor],
+        });
+    });
+    it("surfaces ambiguity when bootstrap-source still matches multiple files", () => {
+        const projectCursor = makeAsset("project", "mcp", "mcp.json", "cursor");
+        projectCursor.path = "/project/.cursor/mcp.json";
+        const projectRoot = makeAsset("project", "mcp", "mcp.json", "root");
+        projectRoot.path = "/project/.mcp.json";
+        expect(getBootstrapResolution({
+            canonicalPath: "mcp.json",
+            candidates: [projectCursor, projectRoot],
+            bootstrapSource: "project",
+        })).toEqual({
+            status: "ambiguous",
+            candidates: [projectCursor, projectRoot],
+        });
+    });
+});
+describe("buildLegacyDefinitions", () => {
+    it("excludes the project client from legacy bootstrap sources", () => {
+        const defs = buildLegacyDefinitions("/repo");
+        expect(defs.every((def) => ["codex", "claude", "cursor", "opencode"].includes(def.name))).toBe(true);
+    });
+});
+//# sourceMappingURL=bootstrap.spec.js.map

package/dist/utils/bootstrap.spec.js.map

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

package/dist/utils/canonical.d.ts

@@ -0,0 +1,17 @@
+import type { AssetContent, ClientDefinition, ManagedAssetType } from "../types/index.js";
+import type { SyncCommandOptions, SyncPlanEntry } from "../types/index.js";
+export declare function buildCanonicalDefinition(projectRoot: string): ClientDefinition;
+export declare function buildLegacyDefinitions(projectRoot: string): ClientDefinition[];
+export declare function discoverCanonicalAssets(projectRoot: string, types?: ManagedAssetType[]): Promise<AssetContent[]>;
+export declare function discoverLegacyAssets(projectRoot: string, types?: ManagedAssetType[]): Promise<AssetContent[]>;
+export declare function discoverIgnoredCursorRules(projectRoot: string): Promise<AssetContent[]>;
+export declare function groupAssetsByCanonicalKey(assets: AssetContent[]): Map<string, AssetContent[]>;
+export declare function synthesizeCanonicalAsset(projectRoot: string, asset: AssetContent): AssetContent;
+export declare function buildBootstrapEntry(projectRoot: string, asset: AssetContent): SyncPlanEntry;
+export declare function buildFanoutPlan(canonicalAssets: AssetContent[], defs: ClientDefinition[], options: SyncCommandOptions): SyncPlanEntry[];
+export declare function getBootstrapChoices(candidates: AssetContent[]): {
+    value: string;
+    label: string;
+    hint: string;
+}[];
+//# sourceMappingURL=canonical.d.ts.map

package/dist/utils/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../src/utils/canonical.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EAEZ,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAa3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAI3E,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,GAClB,gBAAgB,CAYlB;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAClB,gBAAgB,EAAE,CAEpB;AAED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,gBAAgB,EAAE,GACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,gBAAgB,EAAE,GACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzB;AAED,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,EAAE,GACrB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAU7B;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,GAClB,YAAY,CASd;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,GAClB,aAAa,CAUf;AAED,wBAAgB,eAAe,CAC7B,eAAe,EAAE,YAAY,EAAE,EAC/B,IAAI,EAAE,gBAAgB,EAAE,EACxB,OAAO,EAAE,kBAAkB,GAC1B,aAAa,EAAE,CA0CjB;AA6BD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,YAAY,EAAE,GACzB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAMlD"}

package/dist/utils/canonical.js

@@ -0,0 +1,136 @@
+import path from "node:path";
+import { buildClientDefinitions, clientSupportsAssetType, } from "../clients/definitions.js";
+import { discoverAssets } from "./discovery.js";
+import { hashContent } from "./fs.js";
+import { buildTargetAbsolutePath, remapRelativePathForTarget, resolveTargetRelativePath, } from "./paths.js";
+import { shouldSkipTargetAsset } from "./syncFilters.js";
+const CODEX_COMMAND_METADATA = "policy:\n  allow_implicit_invocation: false\n";
+export function buildCanonicalDefinition(projectRoot) {
+    return {
+        name: "project",
+        displayName: "Canonical",
+        root: path.join(projectRoot, ".agents"),
+        assets: [
+            { type: "agents", patterns: ["AGENTS.md"] },
+            { type: "commands", patterns: ["commands/**/*.md"] },
+            { type: "skills", patterns: ["skills/**/SKILL.md"] },
+            { type: "mcp", patterns: [], files: ["mcp.json"] },
+        ],
+    };
+}
+export function buildLegacyDefinitions(projectRoot) {
+    return buildClientDefinitions(projectRoot);
+}
+export async function discoverCanonicalAssets(projectRoot, types) {
+    return discoverAssets([buildCanonicalDefinition(projectRoot)], {
+        types: types,
+    });
+}
+export async function discoverLegacyAssets(projectRoot, types) {
+    const defs = buildLegacyDefinitions(projectRoot);
+    return discoverAssets(defs, { types: types });
+}
+export async function discoverIgnoredCursorRules(projectRoot) {
+    const cursorDef = buildLegacyDefinitions(projectRoot).find((def) => def.name === "cursor");
+    if (!cursorDef) {
+        return [];
+    }
+    return discoverAssets([
+        {
+            ...cursorDef,
+            assets: [
+                { type: "rules", patterns: ["rules/**/*.md", "rules/**/*.mdc"] },
+            ],
+        },
+    ]);
+}
+export function groupAssetsByCanonicalKey(assets) {
+    const grouped = new Map();
+    for (const asset of assets) {
+        const canonicalPath = asset.canonicalPath ?? asset.relativePath;
+        const key = `${asset.type}::${canonicalPath}`;
+        const bucket = grouped.get(key) ?? [];
+        bucket.push(asset);
+        grouped.set(key, bucket);
+    }
+    return grouped;
+}
+export function synthesizeCanonicalAsset(projectRoot, asset) {
+    const canonicalPath = asset.canonicalPath ?? asset.relativePath;
+    return {
+        ...asset,
+        client: "project",
+        path: path.join(projectRoot, ".agents", canonicalPath),
+        relativePath: canonicalPath,
+        canonicalPath,
+    };
+}
+export function buildBootstrapEntry(projectRoot, asset) {
+    const canonicalAsset = synthesizeCanonicalAsset(projectRoot, asset);
+    return {
+        asset,
+        targetClient: "project",
+        targetPath: canonicalAsset.path,
+        targetRelativePath: canonicalAsset.relativePath,
+        action: "create",
+        reason: "bootstrap",
+    };
+}
+export function buildFanoutPlan(canonicalAssets, defs, options) {
+    const plan = [];
+    for (const asset of canonicalAssets) {
+        for (const def of defs) {
+            if (shouldSkipTargetAsset(options, def.name, asset)) {
+                continue;
+            }
+            if (!clientSupportsAssetType(def, asset.type)) {
+                continue;
+            }
+            const baseRelative = resolveTargetRelativePath(def.name, asset);
+            const targetRelative = remapRelativePathForTarget(asset, def.name, baseRelative, defs);
+            const targetPath = buildTargetAbsolutePath(def.root, targetRelative);
+            if (targetPath !== asset.path) {
+                plan.push({
+                    asset,
+                    targetClient: def.name,
+                    targetPath,
+                    targetRelativePath: targetRelative,
+                    action: "create",
+                    reason: "fanout",
+                });
+            }
+            if (def.name === "codex" && asset.type === "commands") {
+                plan.push(buildCodexCommandMetadataEntry(asset, def.root, targetRelative));
+            }
+        }
+    }
+    return plan;
+}
+function buildCodexCommandMetadataEntry(asset, root, commandTargetRelative) {
+    const metadataRelative = normalizeCodexMetadataPath(commandTargetRelative);
+    const syntheticAsset = {
+        ...asset,
+        content: CODEX_COMMAND_METADATA,
+        hash: hashContent(CODEX_COMMAND_METADATA),
+        name: `${asset.name}-openai-yaml`,
+    };
+    return {
+        asset: syntheticAsset,
+        targetClient: "codex",
+        targetPath: buildTargetAbsolutePath(root, metadataRelative),
+        targetRelativePath: metadataRelative,
+        action: "create",
+        reason: "fanout",
+    };
+}
+function normalizeCodexMetadataPath(commandTargetRelative) {
+    return commandTargetRelative.replace(/\/SKILL\.md$/i, "/agents/openai.yaml");
+}
+export function getBootstrapChoices(candidates) {
+    return candidates.map((asset, i) => ({
+        value: asset.path,
+        label: `${asset.client}: ${asset.relativePath}`,
+        hint: `${asset.path}${i === 0 ? " (newest)" : ""}`,
+    }));
+}
+//# sourceMappingURL=canonical.js.map

package/dist/utils/canonical.js.map

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

package/dist/utils/canonicalState.d.ts

@@ -0,0 +1,19 @@
+import type { AgentClientName, ManagedAssetType } from "../types/index.js";
+export interface GeneratedStateEntry {
+    path: string;
+    sourcePath: string;
+    canonicalPath: string;
+    targetClient: AgentClientName;
+    type: ManagedAssetType;
+    mode: "copy" | "symlink";
+    expectedContent?: string;
+}
+interface CanonicalState {
+    version: 1;
+    updatedAt: string;
+    generated: GeneratedStateEntry[];
+}
+export declare function readCanonicalState(): Promise<CanonicalState>;
+export declare function writeCanonicalState(entries: GeneratedStateEntry[]): Promise<void>;
+export {};
+//# sourceMappingURL=canonicalState.d.ts.map

package/dist/utils/canonicalState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalState.d.ts","sourceRoot":"","sources":["../../src/utils/canonicalState.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI3E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,eAAe,CAAC;IAC9B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CAMlE;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,EAAE,GAC7B,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/utils/canonicalState.js

@@ -0,0 +1,21 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+const STATE_PATH = path.join(os.homedir(), ".link-agents", "canonical-state.json");
+export async function readCanonicalState() {
+    try {
+        return JSON.parse(await fs.readFile(STATE_PATH, "utf8"));
+    }
+    catch {
+        return { version: 1, updatedAt: new Date(0).toISOString(), generated: [] };
+    }
+}
+export async function writeCanonicalState(entries) {
+    await fs.mkdir(path.dirname(STATE_PATH), { recursive: true });
+    await fs.writeFile(STATE_PATH, JSON.stringify({
+        version: 1,
+        updatedAt: new Date().toISOString(),
+        generated: entries,
+    }, null, 2), "utf8");
+}
+//# sourceMappingURL=canonicalState.js.map

package/dist/utils/canonicalState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalState.js","sourceRoot":"","sources":["../../src/utils/canonicalState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,sBAAsB,CAAC,CAAC;AAkBnF,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAmB,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA8B;IAE9B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,SAAS,CAChB,UAAU,EACV,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,OAAO;KACM,EAC1B,IAAI,EACJ,CAAC,CACF,EACD,MAAM,CACP,CAAC;AACJ,CAAC"}

package/dist/utils/cursorHistory.d.ts

@@ -0,0 +1,7 @@
+interface ExportOptions {
+    destination?: string;
+    verbose?: boolean;
+}
+export declare function exportCursorHistory(options?: ExportOptions): Promise<void>;
+export {};
+//# sourceMappingURL=cursorHistory.d.ts.map

package/dist/utils/cursorHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorHistory.d.ts","sourceRoot":"","sources":["../../src/utils/cursorHistory.ts"],"names":[],"mappings":"AAOA,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CpF"}