link-agents 0.9.0

package/dist/utils/similarity.spec.js

@@ -0,0 +1,62 @@
+import { describe, it, expect } from "vitest";
+import { calculateSimilarity, getSimilarityLabel, formatRelativeTime, } from "./similarity.js";
+describe("calculateSimilarity", () => {
+    it("returns 1 for identical strings", () => {
+        expect(calculateSimilarity("hello world", "hello world")).toBe(1);
+    });
+    it("returns 0 for completely different strings", () => {
+        const result = calculateSimilarity("the quick brown fox", "xyz abc 123 456");
+        expect(result).toBe(0);
+    });
+    it("returns high similarity for similar content", () => {
+        const a = "This is a test document with some content";
+        const b = "This is a test document with different content";
+        const result = calculateSimilarity(a, b);
+        expect(result).toBeGreaterThan(0.5);
+    });
+    it("handles empty strings", () => {
+        expect(calculateSimilarity("", "")).toBe(1);
+        expect(calculateSimilarity("hello", "")).toBe(0);
+        expect(calculateSimilarity("", "hello")).toBe(0);
+    });
+    it("ignores short words", () => {
+        // "a" and "is" are too short (<=2 chars), should be ignored
+        const result = calculateSimilarity("a is the", "a is the");
+        expect(result).toBe(1); // only "the" counts
+    });
+});
+describe("getSimilarityLabel", () => {
+    it("returns correct labels for score ranges", () => {
+        expect(getSimilarityLabel(0.95)).toBe("nearly identical");
+        expect(getSimilarityLabel(0.75)).toBe("very similar");
+        expect(getSimilarityLabel(0.55)).toBe("similar");
+        expect(getSimilarityLabel(0.35)).toBe("somewhat different");
+        expect(getSimilarityLabel(0.1)).toBe("very different");
+    });
+});
+describe("formatRelativeTime", () => {
+    it("formats recent times", () => {
+        const now = new Date();
+        expect(formatRelativeTime(now)).toBe("just now");
+    });
+    it("formats minutes ago", () => {
+        const date = new Date(Date.now() - 5 * 60 * 1000);
+        expect(formatRelativeTime(date)).toBe("5m ago");
+    });
+    it("formats hours ago", () => {
+        const date = new Date(Date.now() - 3 * 60 * 60 * 1000);
+        expect(formatRelativeTime(date)).toBe("3h ago");
+    });
+    it("formats days ago", () => {
+        const date = new Date(Date.now() - 2 * 24 * 60 * 60 * 1000);
+        expect(formatRelativeTime(date)).toBe("2d ago");
+    });
+    it("formats weeks ago", () => {
+        const date = new Date(Date.now() - 14 * 24 * 60 * 60 * 1000);
+        expect(formatRelativeTime(date)).toBe("2w ago");
+    });
+    it("handles undefined", () => {
+        expect(formatRelativeTime(undefined)).toBe("unknown");
+    });
+});
+//# sourceMappingURL=similarity.spec.js.map

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

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

package/dist/utils/snapshots.d.ts

@@ -0,0 +1,21 @@
+interface SnapshotFileEntry {
+    path: string;
+    state: "missing" | "file" | "symlink";
+    dataFile?: string;
+    linkTarget?: string;
+}
+export interface SnapshotManifest {
+    id: string;
+    createdAt: string;
+    entries: SnapshotFileEntry[];
+}
+interface SnapshotStoreOptions {
+    storeDir?: string;
+}
+export declare function createSnapshot(targetPaths: string[], options?: SnapshotStoreOptions): Promise<SnapshotManifest>;
+export declare function listSnapshots(options?: SnapshotStoreOptions): Promise<SnapshotManifest[]>;
+export declare function readSnapshot(snapshotId: string, options?: SnapshotStoreOptions): Promise<SnapshotManifest>;
+export declare function restoreSnapshot(snapshotId: string, options?: SnapshotStoreOptions): Promise<SnapshotManifest>;
+export declare function snapshotDirForId(snapshotId: string, storeDir?: string): string;
+export {};
+//# sourceMappingURL=snapshots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/utils/snapshots.ts"],"names":[],"mappings":"AAOA,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CA+C3B;AAED,wBAAsB,aAAa,CACjC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAe7B;AAED,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAK3B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAwB3B;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,SAAoB,GAC3B,MAAM,CAER"}

package/dist/utils/snapshots.js

@@ -0,0 +1,81 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+const DEFAULT_STORE_DIR = path.join(os.homedir(), ".link-agents", "snapshots");
+export async function createSnapshot(targetPaths, options = {}) {
+    const storeDir = options.storeDir ?? DEFAULT_STORE_DIR;
+    const id = `${Date.now()}-${crypto.randomUUID().slice(0, 8)}`;
+    const dir = snapshotDirForId(id, storeDir);
+    const filesDir = path.join(dir, "files");
+    await fs.mkdir(filesDir, { recursive: true });
+    const entries = [];
+    for (const [index, targetPath] of targetPaths.entries()) {
+        try {
+            const stats = await fs.lstat(targetPath);
+            if (stats.isSymbolicLink()) {
+                entries.push({
+                    path: targetPath,
+                    state: "symlink",
+                    linkTarget: await fs.readlink(targetPath),
+                });
+                continue;
+            }
+            const dataFile = `file-${index}.txt`;
+            await fs.writeFile(path.join(filesDir, dataFile), await fs.readFile(targetPath, "utf8"), "utf8");
+            entries.push({ path: targetPath, state: "file", dataFile });
+        }
+        catch {
+            entries.push({ path: targetPath, state: "missing" });
+        }
+    }
+    const manifest = {
+        id,
+        createdAt: new Date().toISOString(),
+        entries,
+    };
+    await fs.writeFile(path.join(dir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
+    return manifest;
+}
+export async function listSnapshots(options = {}) {
+    const storeDir = options.storeDir ?? DEFAULT_STORE_DIR;
+    try {
+        const entries = await fs.readdir(storeDir, { withFileTypes: true });
+        const manifests = await Promise.all(entries
+            .filter((entry) => entry.isDirectory())
+            .map(async (entry) => readSnapshot(entry.name, { storeDir })));
+        return manifests.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    catch {
+        return [];
+    }
+}
+export async function readSnapshot(snapshotId, options = {}) {
+    const storeDir = options.storeDir ?? DEFAULT_STORE_DIR;
+    const dir = snapshotDirForId(snapshotId, storeDir);
+    const content = await fs.readFile(path.join(dir, "manifest.json"), "utf8");
+    return JSON.parse(content);
+}
+export async function restoreSnapshot(snapshotId, options = {}) {
+    const storeDir = options.storeDir ?? DEFAULT_STORE_DIR;
+    const dir = snapshotDirForId(snapshotId, storeDir);
+    const manifest = await readSnapshot(snapshotId, { storeDir });
+    for (const entry of manifest.entries) {
+        await fs.rm(entry.path, { recursive: true, force: true });
+        if (entry.state === "missing") {
+            continue;
+        }
+        await fs.mkdir(path.dirname(entry.path), { recursive: true });
+        if (entry.state === "symlink") {
+            await fs.symlink(entry.linkTarget, entry.path);
+            continue;
+        }
+        const filePath = path.join(dir, "files", entry.dataFile);
+        await fs.writeFile(entry.path, await fs.readFile(filePath, "utf8"), "utf8");
+    }
+    return manifest;
+}
+export function snapshotDirForId(snapshotId, storeDir = DEFAULT_STORE_DIR) {
+    return path.join(storeDir, snapshotId);
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/utils/snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.js","sourceRoot":"","sources":["../../src/utils/snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;AAmB/E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAqB,EACrB,UAAgC,EAAE;IAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACvD,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC9D,MAAM,GAAG,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAEzC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,KAAK,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACzC,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,UAAU;oBAChB,KAAK,EAAE,SAAS;oBAChB,UAAU,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;iBAC1C,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,QAAQ,KAAK,MAAM,CAAC;YACrC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAC7B,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,EACrC,MAAM,CACP,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAqB;QACjC,EAAE;QACF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO;KACR,CAAC;IAEF,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAC/B,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EACjC,MAAM,CACP,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAgC,EAAE;IAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IAEvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO;aACJ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;aACtC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAChE,CAAC;QAEF,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,UAAgC,EAAE;IAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACvD,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,UAAgC,EAAE;IAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACvD,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE9D,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1D,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9D,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,UAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAChD,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,QAAS,CAAC,CAAC;QAC1D,MAAM,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,QAAQ,GAAG,iBAAiB;IAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC"}

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

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

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

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

package/dist/utils/snapshots.spec.js

@@ -0,0 +1,56 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { createSnapshot, listSnapshots, restoreSnapshot, snapshotDirForId, } from "./snapshots.js";
+describe("snapshots", () => {
+    const root = path.join(os.tmpdir(), "link-agents-snapshots-test");
+    const targetsDir = path.join(root, "targets");
+    const storeDir = path.join(root, "store");
+    beforeEach(async () => {
+        await fs.rm(root, { recursive: true, force: true });
+        await fs.mkdir(targetsDir, { recursive: true });
+        await fs.mkdir(storeDir, { recursive: true });
+    });
+    afterEach(async () => {
+        await fs.rm(root, { recursive: true, force: true });
+    });
+    it("captures file, symlink, and missing states and restores them", async () => {
+        const filePath = path.join(targetsDir, "file.md");
+        const sourcePath = path.join(targetsDir, "source.md");
+        const linkPath = path.join(targetsDir, "link.md");
+        const missingPath = path.join(targetsDir, "missing.md");
+        await fs.writeFile(filePath, "before", "utf8");
+        await fs.writeFile(sourcePath, "source", "utf8");
+        await fs.symlink("source.md", linkPath);
+        const snapshot = await createSnapshot([filePath, linkPath, missingPath], {
+            storeDir,
+        });
+        await fs.writeFile(filePath, "after", "utf8");
+        await fs.rm(linkPath, { force: true });
+        await fs.writeFile(linkPath, "flattened", "utf8");
+        await fs.writeFile(missingPath, "new file", "utf8");
+        await restoreSnapshot(snapshot.id, { storeDir });
+        expect(await fs.readFile(filePath, "utf8")).toBe("before");
+        expect((await fs.lstat(linkPath)).isSymbolicLink()).toBe(true);
+        expect(await fs.readlink(linkPath)).toBe("source.md");
+        await expect(fs.access(missingPath)).rejects.toThrow();
+    });
+    it("lists snapshots by newest first", async () => {
+        const filePath = path.join(targetsDir, "file.md");
+        await fs.writeFile(filePath, "content", "utf8");
+        const first = await createSnapshot([filePath], { storeDir });
+        const second = await createSnapshot([filePath], { storeDir });
+        const listed = await listSnapshots({ storeDir });
+        expect(listed[0].id).toBe(second.id);
+        expect(listed[1].id).toBe(first.id);
+    });
+    it("stores snapshot manifests under the snapshot directory", async () => {
+        const filePath = path.join(targetsDir, "file.md");
+        await fs.writeFile(filePath, "content", "utf8");
+        const snapshot = await createSnapshot([filePath], { storeDir });
+        const manifestPath = path.join(snapshotDirForId(snapshot.id, storeDir), "manifest.json");
+        expect(await fs.readFile(manifestPath, "utf8")).toContain(filePath);
+    });
+});
+//# sourceMappingURL=snapshots.spec.js.map

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

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

package/dist/utils/syncFilters.d.ts

@@ -0,0 +1,3 @@
+import type { AgentClientName, AssetContent, SyncOptions } from "../types/index.js";
+export declare function shouldSkipTargetAsset(options: Pick<SyncOptions, "separateClaudeMd">, targetClient: AgentClientName, asset: Pick<AssetContent, "type" | "canonicalPath" | "relativePath">): boolean;
+//# sourceMappingURL=syncFilters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syncFilters.d.ts","sourceRoot":"","sources":["../../src/utils/syncFilters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,EAC9C,YAAY,EAAE,eAAe,EAC7B,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,GAAG,cAAc,CAAC,GACnE,OAAO,CAST"}

package/dist/utils/syncFilters.js

@@ -0,0 +1,8 @@
+export function shouldSkipTargetAsset(options, targetClient, asset) {
+    const canonicalPath = asset.canonicalPath ?? asset.relativePath;
+    return (Boolean(options.separateClaudeMd) &&
+        targetClient === "claude" &&
+        asset.type === "agents" &&
+        canonicalPath === "AGENTS.md");
+}
+//# sourceMappingURL=syncFilters.js.map

package/dist/utils/syncFilters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncFilters.js","sourceRoot":"","sources":["../../src/utils/syncFilters.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,qBAAqB,CACnC,OAA8C,EAC9C,YAA6B,EAC7B,KAAoE;IAEpE,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,YAAY,CAAC;IAEhE,OAAO,CACL,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACjC,YAAY,KAAK,QAAQ;QACzB,KAAK,CAAC,IAAI,KAAK,QAAQ;QACvB,aAAa,KAAK,WAAW,CAC9B,CAAC;AACJ,CAAC"}

package/dist/utils/syncRuntime.d.ts

@@ -0,0 +1,3 @@
+import type { ApplyResult } from "./apply.js";
+export declare function printApplyResultLike(result: ApplyResult, verbose: boolean): void;
+//# sourceMappingURL=syncRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syncRuntime.d.ts","sourceRoot":"","sources":["../../src/utils/syncRuntime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,GACf,IAAI,CAgCN"}

package/dist/utils/syncRuntime.js

@@ -0,0 +1,31 @@
+import chalk from "chalk";
+export function printApplyResultLike(result, verbose) {
+    const parts = [];
+    if (result.applied > 0) {
+        parts.push(chalk.green(`${result.applied} applied`));
+    }
+    if (result.skipped > 0) {
+        parts.push(chalk.gray(`${result.skipped} skipped`));
+    }
+    if (result.failed > 0) {
+        parts.push(chalk.red(`${result.failed} failed`));
+    }
+    if (result.rolledBack) {
+        parts.push(chalk.yellow("rolled back"));
+    }
+    if (parts.length > 0) {
+        console.log();
+        console.log(`Done: ${parts.join(", ")}`);
+    }
+    if (result.backups.length > 0 && verbose) {
+        console.log(chalk.dim(`Created ${result.backups.length} backup(s)`));
+    }
+    if (result.errors.length > 0) {
+        console.log();
+        console.log(chalk.red("Errors:"));
+        for (const error of result.errors) {
+            console.log(chalk.red(`  - ${error}`));
+        }
+    }
+}
+//# sourceMappingURL=syncRuntime.js.map

package/dist/utils/syncRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncRuntime.js","sourceRoot":"","sources":["../../src/utils/syncRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,UAAU,oBAAoB,CAClC,MAAmB,EACnB,OAAgB;IAEhB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,3 @@
+export declare function validatePathSafe(root: string, targetPath: string): void;
+export declare function isValidPathSafe(root: string, targetPath: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAWvE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAOzE"}

package/dist/utils/validation.js

@@ -0,0 +1,19 @@
+import path from "node:path";
+export function validatePathSafe(root, targetPath) {
+    const normalizedRoot = path.normalize(root);
+    const normalizedTarget = path.normalize(targetPath);
+    const relative = path.relative(normalizedRoot, normalizedTarget);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw new Error(`Path traversal detected: ${targetPath} escapes root ${root}`);
+    }
+}
+export function isValidPathSafe(root, targetPath) {
+    try {
+        validatePathSafe(root, targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,UAAkB;IAC/D,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAEjE,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,4BAA4B,UAAU,iBAAiB,IAAI,EAAE,CAC9D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,UAAkB;IAC9D,IAAI,CAAC;QACH,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

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

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

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

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

package/dist/utils/validation.spec.js

@@ -0,0 +1,36 @@
+import { describe, it, expect } from "vitest";
+import { validatePathSafe, isValidPathSafe } from "./validation.js";
+describe("path validation", () => {
+    describe("validatePathSafe", () => {
+        it("should allow valid paths within root", () => {
+            expect(() => validatePathSafe("/root", "/root/subdir/file.txt")).not.toThrow();
+        });
+        it("should allow paths at root level", () => {
+            expect(() => validatePathSafe("/root", "/root/file.txt")).not.toThrow();
+        });
+        it("should throw on path traversal with ..", () => {
+            expect(() => validatePathSafe("/root", "/root/../etc/passwd")).toThrow("Path traversal detected");
+        });
+        it("should throw on path traversal with multiple ..", () => {
+            expect(() => validatePathSafe("/root", "/root/subdir/../../etc/passwd")).toThrow("Path traversal detected");
+        });
+        it("should throw on absolute path escaping root", () => {
+            expect(() => validatePathSafe("/root", "/etc/passwd")).toThrow("Path traversal detected");
+        });
+        it("should normalize paths before checking", () => {
+            expect(() => validatePathSafe("/root", "/root/sub/../sub/file.txt")).not.toThrow();
+        });
+    });
+    describe("isValidPathSafe", () => {
+        it("should return true for valid paths", () => {
+            expect(isValidPathSafe("/root", "/root/subdir/file.txt")).toBe(true);
+        });
+        it("should return false for path traversal", () => {
+            expect(isValidPathSafe("/root", "/root/../etc/passwd")).toBe(false);
+        });
+        it("should return false for absolute paths escaping root", () => {
+            expect(isValidPathSafe("/root", "/etc/passwd")).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=validation.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.spec.js","sourceRoot":"","sources":["../../src/utils/validation.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,CAAC,GAAG,EAAE,CACV,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,CAAC,CACnD,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,OAAO,CACpE,yBAAyB,CAC1B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,CAAC,GAAG,EAAE,CACV,gBAAgB,CAAC,OAAO,EAAE,+BAA+B,CAAC,CAC3D,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAC5D,yBAAyB,CAC1B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,GAAG,EAAE,CACV,gBAAgB,CAAC,OAAO,EAAE,2BAA2B,CAAC,CACvD,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "link-agents",
+  "version": "0.9.0",
+  "description": "Synchronize agent guidance (AGENTS, commands, rules, skills, MCP configs) across AI coding assistants.",
+  "type": "module",
+  "bin": {
+    "link-agents": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "agents",
+    "sync",
+    "codex",
+    "claude",
+    "cursor",
+    "opencode",
+    "mcp"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "chalk": "5.3.0",
+    "commander": "12.1.0",
+    "fast-glob": "3.3.2",
+    "fs-extra": "11.2.0",
+    "inquirer-checkbox-plus-plus": "^1.1.1",
+    "ora": "8.0.1",
+    "picocolors": "1.0.0",
+    "semver": "7.6.3",
+    "zod": "3.23.8"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "11.0.4",
+    "@types/node": "22.10.1",
+    "@types/semver": "7.5.8",
+    "eslint": "9.13.0",
+    "eslint-config-prettier": "9.1.0",
+    "eslint-plugin-import": "2.31.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "3.2.5",
+    "tsx": "4.19.0",
+    "typescript": "5.6.3",
+    "vitest": "2.1.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "AGENTS.md",
+    "cursor-rules-notes.md"
+  ]
+}