link-agents 0.9.0

package/dist/utils/plan.d.ts

@@ -0,0 +1,7 @@
+import type { AssetContent, ClientDefinition, SyncOptions, SyncPlanEntry } from "../types/index.js";
+export interface PlanResult {
+    plan: SyncPlanEntry[];
+    desiredAssets: Map<string, AssetContent>;
+}
+export declare function buildSyncPlan(assets: AssetContent[], defs: ClientDefinition[], options: SyncOptions): PlanResult;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/utils/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EAEZ,gBAAgB,EAChB,WAAW,EACX,aAAa,EACd,MAAM,mBAAmB,CAAC;AAiC3B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC1C;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EAAE,EACtB,IAAI,EAAE,gBAAgB,EAAE,EACxB,OAAO,EAAE,WAAW,GACnB,UAAU,CA6HZ"}

package/dist/utils/plan.js

@@ -0,0 +1,118 @@
+import { CLIENT_ORDER, clientSupportsAssetType, } from "../clients/definitions.js";
+import { buildTargetAbsolutePath, resolveTargetRelativePath, normalizeRelativePath, remapRelativePathForTarget, } from "./paths.js";
+import { validatePathSafe } from "./validation.js";
+import { mergeRulesIntoAgents, shouldMergeRulesIntoAgents, getRulesForMerge, } from "./merge.js";
+import { hashContent } from "./fs.js";
+import { shouldSkipTargetAsset } from "./syncFilters.js";
+/**
+ * Check if target client requires content transformation for this asset type.
+ * When transformation is needed, we can't reliably compare source/target hashes
+ * as they'll differ even if content is semantically up-to-date.
+ */
+function requiresTransformation(targetClient, assetType) {
+    // OpenCode requires frontmatter transformation for agents
+    return targetClient === "opencode" && assetType === "agents";
+}
+export function buildSyncPlan(assets, defs, options) {
+    const priority = options.priority ?? CLIENT_ORDER;
+    const typeFilter = new Set(options.types ?? []);
+    const clientFilter = new Set(options.clients ?? []);
+    const canonical = new Map();
+    const filteredAssets = options.mode === "source"
+        ? assets.filter((asset) => asset.client === options.source)
+        : assets;
+    const sorted = filteredAssets.slice().sort((a, b) => {
+        const priA = priority.indexOf(a.client);
+        const priB = priority.indexOf(b.client);
+        return priA - priB;
+    });
+    for (const asset of sorted) {
+        if (typeFilter.size && !typeFilter.has(asset.type)) {
+            continue;
+        }
+        const canonicalRel = getCanonicalRelative(asset);
+        const key = makeAssetKey(asset.type, canonicalRel);
+        if (!canonical.has(key)) {
+            canonical.set(key, asset);
+        }
+    }
+    const existingMap = new Map();
+    for (const asset of assets) {
+        const clientMap = existingMap.get(asset.client) ?? new Map();
+        clientMap.set(makeAssetKey(asset.type, getCanonicalRelative(asset)), asset);
+        existingMap.set(asset.client, clientMap);
+    }
+    // Collect rules for merging into agents for clients that don't support rules
+    const sourceClient = options.mode === "source" ? options.source : undefined;
+    const rulesToMerge = getRulesForMerge(filteredAssets, sourceClient);
+    const plan = [];
+    for (const def of defs) {
+        if (clientFilter.size && !clientFilter.has(def.name)) {
+            continue;
+        }
+        const supports = new Set(def.assets.map((a) => a.type));
+        const needsRulesMerge = shouldMergeRulesIntoAgents(def) && rulesToMerge.length > 0;
+        for (const [key, desired] of canonical.entries()) {
+            // Skip rules for clients that don't support them - they'll be merged into agents
+            if (desired.type === "rules" && !clientSupportsAssetType(def, "rules")) {
+                continue;
+            }
+            if (shouldSkipTargetAsset(options, def.name, desired)) {
+                continue;
+            }
+            if (!supports.has(desired.type)) {
+                continue;
+            }
+            if (def.name === desired.client && options.mode !== "source") {
+                // Already the canonical source, skip
+                continue;
+            }
+            // For agents on clients without rules support, merge rules into content
+            let assetToWrite = desired;
+            if (desired.type === "agents" && needsRulesMerge) {
+                const mergedContent = mergeRulesIntoAgents(desired.content, rulesToMerge);
+                assetToWrite = {
+                    ...desired,
+                    content: mergedContent,
+                    hash: hashContent(mergedContent),
+                };
+            }
+            const baseRelative = resolveTargetRelativePath(def.name, assetToWrite);
+            const targetRelative = remapRelativePathForTarget(assetToWrite, def.name, baseRelative, defs);
+            const targetPath = buildTargetAbsolutePath(def.root, targetRelative);
+            validatePathSafe(def.root, targetPath);
+            const existing = existingMap.get(def.name)?.get(key);
+            // Don't skip if target requires transformation - let apply phase compare transformed content
+            const needsTransform = requiresTransformation(def.name, assetToWrite.type);
+            // Also don't skip if rules were merged - hash will differ
+            if (existing &&
+                existing.hash === assetToWrite.hash &&
+                !needsTransform &&
+                !needsRulesMerge) {
+                plan.push({
+                    asset: assetToWrite,
+                    targetClient: def.name,
+                    targetPath,
+                    action: "skip",
+                    reason: "up-to-date",
+                });
+                continue;
+            }
+            plan.push({
+                asset: assetToWrite,
+                targetClient: def.name,
+                targetPath,
+                targetRelativePath: targetRelative,
+                action: existing ? "update" : "create",
+            });
+        }
+    }
+    return { plan, desiredAssets: canonical };
+}
+function makeAssetKey(type, relativePath) {
+    return `${type}::${normalizeRelativePath(relativePath)}`;
+}
+function getCanonicalRelative(asset) {
+    return normalizeRelativePath(asset.canonicalPath ?? asset.relativePath);
+}
+//# sourceMappingURL=plan.js.map

package/dist/utils/plan.js.map

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

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

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

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

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

package/dist/utils/plan.spec.js

@@ -0,0 +1,420 @@
+import { describe, it, expect } from "vitest";
+import { buildSyncPlan } from "./plan.js";
+describe("buildSyncPlan", () => {
+    it("should create a merge plan with priority order", () => {
+        const assets = [
+            {
+                client: "project",
+                type: "agents",
+                path: "/project/AGENTS.md",
+                relativePath: "AGENTS.md",
+                canonicalPath: "AGENTS.md",
+                name: "AGENTS",
+                content: "project content",
+                hash: "hash1",
+            },
+            {
+                client: "claude",
+                type: "agents",
+                path: "/claude/AGENTS.md",
+                relativePath: "AGENTS.md",
+                canonicalPath: "AGENTS.md",
+                name: "AGENTS",
+                content: "claude content",
+                hash: "hash2",
+            },
+        ];
+        const defs = [
+            {
+                name: "project",
+                displayName: "Project",
+                root: "/project",
+                assets: [{ type: "agents", patterns: ["AGENTS.md"] }],
+            },
+            {
+                name: "claude",
+                displayName: "Claude",
+                root: "/claude",
+                assets: [{ type: "agents", patterns: ["AGENTS.md"] }],
+            },
+        ];
+        const options = {
+            mode: "merge",
+            priority: ["project", "claude"],
+        };
+        const { plan, desiredAssets } = buildSyncPlan(assets, defs, options);
+        expect(desiredAssets.size).toBe(1);
+        const asset = desiredAssets.get("agents::AGENTS.md");
+        expect(asset?.content).toBe("project content");
+        expect(asset?.hash).toBe("hash1");
+    });
+    it("should skip entries that are already up-to-date", () => {
+        const sourceAsset = {
+            client: "claude",
+            type: "agents",
+            path: "/claude/AGENTS.md",
+            relativePath: "AGENTS.md",
+            canonicalPath: "AGENTS.md",
+            name: "AGENTS",
+            content: "same content",
+            hash: "sameHash",
+        };
+        const targetAsset = {
+            client: "project",
+            type: "agents",
+            path: "/project/AGENTS.md",
+            relativePath: "AGENTS.md",
+            canonicalPath: "AGENTS.md",
+            name: "AGENTS",
+            content: "same content",
+            hash: "sameHash",
+        };
+        const defs = [
+            {
+                name: "claude",
+                displayName: "Claude",
+                root: "/claude",
+                assets: [{ type: "agents", patterns: ["AGENTS.md"] }],
+            },
+            {
+                name: "project",
+                displayName: "Project",
+                root: "/project",
+                assets: [{ type: "agents", patterns: ["AGENTS.md"] }],
+            },
+        ];
+        const options = {
+            mode: "merge",
+            clients: ["project"],
+            priority: ["claude", "project"],
+        };
+        const { plan } = buildSyncPlan([sourceAsset, targetAsset], defs, options);
+        expect(plan).toHaveLength(1);
+        expect(plan[0].action).toBe("skip");
+        expect(plan[0].reason).toBe("up-to-date");
+    });
+    it("should create update entries for changed content", () => {
+        const sourceAsset = {
+            client: "claude",
+            type: "agents",
+            path: "/claude/AGENTS.md",
+            relativePath: "AGENTS.md",
+            canonicalPath: "AGENTS.md",
+            name: "AGENTS",
+            content: "new content",
+            hash: "newHash",
+        };
+        const existingAsset = {
+            client: "project",
+            type: "agents",
+            path: "/project/AGENTS.md",
+            relativePath: "AGENTS.md",
+            canonicalPath: "AGENTS.md",
+            name: "AGENTS",
+            content: "old content",
+            hash: "oldHash",
+        };
+        const defs = [
+            {
+                name: "project",
+                displayName: "Project",
+                root: "/project",
+                assets: [{ type: "agents", patterns: ["AGENTS.md"] }],
+            },
+            {
+                name: "claude",
+                displayName: "Claude",
+                root: "/claude",
+                assets: [{ type: "agents", patterns: ["AGENTS.md"] }],
+            },
+        ];
+        const options = {
+            mode: "merge",
+            priority: ["claude", "project"],
+        };
+        const { plan } = buildSyncPlan([sourceAsset, existingAsset], defs, options);
+        const updateForProject = plan.find((e) => e.targetClient === "project");
+        expect(updateForProject?.action).toBe("update");
+        expect(updateForProject?.asset.hash).toBe("newHash");
+    });
+    it("should filter by asset types when specified", () => {
+        const assets = [
+            {
+                client: "project",
+                type: "agents",
+                path: "/project/AGENTS.md",
+                relativePath: "AGENTS.md",
+                canonicalPath: "AGENTS.md",
+                name: "AGENTS",
+                content: "agents content",
+                hash: "hash1",
+            },
+            {
+                client: "project",
+                type: "commands",
+                path: "/project/commands/test.md",
+                relativePath: "commands/test.md",
+                canonicalPath: "commands/test.md",
+                name: "test",
+                content: "command content",
+                hash: "hash2",
+            },
+        ];
+        const defs = [
+            {
+                name: "claude",
+                displayName: "Claude",
+                root: "/claude",
+                assets: [
+                    { type: "agents", patterns: ["AGENTS.md"] },
+                    { type: "commands", patterns: ["commands/**/*.md"] },
+                ],
+            },
+        ];
+        const options = {
+            mode: "merge",
+            types: ["agents"],
+        };
+        const { desiredAssets } = buildSyncPlan(assets, defs, options);
+        expect(desiredAssets.size).toBe(1);
+        expect(desiredAssets.has("agents::AGENTS.md")).toBe(true);
+        expect(desiredAssets.has("commands::commands/test.md")).toBe(false);
+    });
+    it("should use source mode when specified", () => {
+        const assets = [
+            {
+                client: "claude",
+                type: "agents",
+                path: "/claude/AGENTS.md",
+                relativePath: "AGENTS.md",
+                canonicalPath: "AGENTS.md",
+                name: "AGENTS",
+                content: "claude content",
+                hash: "hash1",
+            },
+            {
+                client: "project",
+                type: "agents",
+                path: "/project/AGENTS.md",
+                relativePath: "AGENTS.md",
+                canonicalPath: "AGENTS.md",
+                name: "AGENTS",
+                content: "project content",
+                hash: "hash2",
+            },
+        ];
+        const defs = [
+            {
+                name: "claude",
+                displayName: "Claude",
+                root: "/claude",
+                assets: [{ type: "agents", patterns: ["AGENTS.md"] }],
+            },
+        ];
+        const options = {
+            mode: "source",
+            source: "claude",
+        };
+        const { desiredAssets } = buildSyncPlan(assets, defs, options);
+        expect(desiredAssets.size).toBe(1);
+        const asset = desiredAssets.get("agents::AGENTS.md");
+        expect(asset?.client).toBe("claude");
+        expect(asset?.content).toBe("claude content");
+    });
+    it("should skip syncing AGENTS.md to Claude when separateClaudeMd is enabled", () => {
+        const assets = [
+            {
+                client: "project",
+                type: "agents",
+                path: "/project/AGENTS.md",
+                relativePath: "AGENTS.md",
+                canonicalPath: "AGENTS.md",
+                name: "AGENTS",
+                content: "project content",
+                hash: "hash1",
+            },
+        ];
+        const defs = [
+            {
+                name: "project",
+                displayName: "Project",
+                root: "/project",
+                assets: [{ type: "agents", patterns: ["AGENTS.md"] }],
+            },
+            {
+                name: "claude",
+                displayName: "Claude",
+                root: "/claude",
+                assets: [{ type: "agents", patterns: ["CLAUDE.md"] }],
+            },
+            {
+                name: "cursor",
+                displayName: "Cursor",
+                root: "/cursor",
+                assets: [{ type: "agents", patterns: ["AGENTS.md"] }],
+            },
+        ];
+        const options = {
+            mode: "merge",
+            separateClaudeMd: true,
+        };
+        const { plan } = buildSyncPlan(assets, defs, options);
+        expect(plan.some((entry) => entry.targetClient === "claude")).toBe(false);
+        expect(plan.some((entry) => entry.targetClient === "cursor")).toBe(true);
+    });
+    describe("rules merging into agents", () => {
+        it("should merge rules into agents for clients without rules support", () => {
+            const assets = [
+                {
+                    client: "cursor",
+                    type: "agents",
+                    path: "/cursor/AGENTS.md",
+                    relativePath: "AGENTS.md",
+                    canonicalPath: "AGENTS.md",
+                    name: "AGENTS",
+                    content: "# Agent Instructions",
+                    hash: "agentHash",
+                },
+                {
+                    client: "cursor",
+                    type: "rules",
+                    path: "/cursor/rules/typescript.md",
+                    relativePath: "rules/typescript.md",
+                    canonicalPath: "rules/typescript.md",
+                    name: "typescript",
+                    content: "Always use TypeScript.",
+                    hash: "ruleHash",
+                },
+            ];
+            const defs = [
+                {
+                    name: "cursor",
+                    displayName: "Cursor",
+                    root: "/cursor",
+                    assets: [
+                        { type: "agents", patterns: ["AGENTS.md"] },
+                        { type: "rules", patterns: ["rules/**/*.md"] },
+                    ],
+                },
+                {
+                    name: "claude",
+                    displayName: "Claude Code",
+                    root: "/claude",
+                    assets: [
+                        { type: "agents", patterns: ["CLAUDE.md"] },
+                        { type: "rules", patterns: [] }, // No rules support
+                    ],
+                },
+            ];
+            const options = {
+                mode: "merge",
+                priority: ["cursor", "claude"],
+            };
+            const { plan } = buildSyncPlan(assets, defs, options);
+            // Find the plan entry for claude agents
+            const claudeAgentPlan = plan.find((e) => e.targetClient === "claude" && e.asset.type === "agents");
+            expect(claudeAgentPlan).toBeDefined();
+            expect(claudeAgentPlan?.asset.content).toContain("# Agent Instructions");
+            expect(claudeAgentPlan?.asset.content).toContain("# Rules");
+            expect(claudeAgentPlan?.asset.content).toContain("Always use TypeScript.");
+        });
+        it("should not merge rules for clients that support rules", () => {
+            const assets = [
+                {
+                    client: "cursor",
+                    type: "agents",
+                    path: "/cursor/AGENTS.md",
+                    relativePath: "AGENTS.md",
+                    canonicalPath: "AGENTS.md",
+                    name: "AGENTS",
+                    content: "# Agent Instructions",
+                    hash: "agentHash",
+                },
+                {
+                    client: "cursor",
+                    type: "rules",
+                    path: "/cursor/rules/typescript.md",
+                    relativePath: "rules/typescript.md",
+                    canonicalPath: "rules/typescript.md",
+                    name: "typescript",
+                    content: "Always use TypeScript.",
+                    hash: "ruleHash",
+                },
+            ];
+            const defs = [
+                {
+                    name: "cursor",
+                    displayName: "Cursor",
+                    root: "/cursor",
+                    assets: [
+                        { type: "agents", patterns: ["AGENTS.md"] },
+                        { type: "rules", patterns: ["rules/**/*.md"] },
+                    ],
+                },
+                {
+                    name: "opencode",
+                    displayName: "OpenCode",
+                    root: "/opencode",
+                    assets: [
+                        { type: "agents", patterns: ["AGENTS.md"] },
+                        { type: "rules", patterns: ["rules/**/*.md"] }, // Has rules support
+                    ],
+                },
+            ];
+            const options = {
+                mode: "merge",
+                priority: ["cursor", "opencode"],
+            };
+            const { plan } = buildSyncPlan(assets, defs, options);
+            // Find the plan entry for opencode agents
+            const opencodeAgentPlan = plan.find((e) => e.targetClient === "opencode" && e.asset.type === "agents");
+            expect(opencodeAgentPlan).toBeDefined();
+            // Should NOT contain merged rules
+            expect(opencodeAgentPlan?.asset.content).toBe("# Agent Instructions");
+            expect(opencodeAgentPlan?.asset.content).not.toContain("# Rules");
+        });
+        it("should skip rules entries for clients without rules support", () => {
+            const assets = [
+                {
+                    client: "cursor",
+                    type: "rules",
+                    path: "/cursor/rules/test.md",
+                    relativePath: "rules/test.md",
+                    canonicalPath: "rules/test.md",
+                    name: "test",
+                    content: "Test rule",
+                    hash: "ruleHash",
+                },
+            ];
+            const defs = [
+                {
+                    name: "cursor",
+                    displayName: "Cursor",
+                    root: "/cursor",
+                    assets: [
+                        { type: "agents", patterns: ["AGENTS.md"] },
+                        { type: "rules", patterns: ["rules/**/*.md"] },
+                    ],
+                },
+                {
+                    name: "claude",
+                    displayName: "Claude Code",
+                    root: "/claude",
+                    assets: [
+                        { type: "agents", patterns: ["CLAUDE.md"] },
+                        { type: "rules", patterns: [] }, // No rules support
+                    ],
+                },
+            ];
+            const options = {
+                mode: "merge",
+                priority: ["cursor", "claude"],
+            };
+            const { plan } = buildSyncPlan(assets, defs, options);
+            // Should not have any rules entries for claude
+            const claudeRulesPlan = plan.filter((e) => e.targetClient === "claude" && e.asset.type === "rules");
+            expect(claudeRulesPlan).toHaveLength(0);
+        });
+    });
+});
+//# sourceMappingURL=plan.spec.js.map

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

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

package/dist/utils/reporting.d.ts

@@ -0,0 +1,21 @@
+import type { ManagedAssetType, SyncPlanEntry } from "../types/index.js";
+interface SyncPreflightInput {
+    canonicalCount: number;
+    bootstrapCount: number;
+    ignoredCount: number;
+    targets: string[];
+    writeMode: "symlink" | "copy";
+    dryRun: boolean;
+    types?: ManagedAssetType[];
+}
+export declare function buildSyncPreflightLines(input: SyncPreflightInput): string[];
+export declare function buildSyncPlanSummaryLines(plan: SyncPlanEntry[]): string[];
+export declare function buildDetailedPlanLines(plan: SyncPlanEntry[]): string[];
+export declare function formatIssueSection(title: string, items: string[]): string[];
+export declare function formatSnapshotList(snapshots: Array<{
+    id: string;
+    createdAt: string;
+    entries: unknown[];
+}>): string[];
+export {};
+//# sourceMappingURL=reporting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reporting.d.ts","sourceRoot":"","sources":["../../src/utils/reporting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAUzE,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAe3E;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAuBzE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAKtE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAU3E;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,GACtE,MAAM,EAAE,CAKV"}