@sentry/dotagents 0.2.0

package/dist/sources/cache.d.ts

@@ -0,0 +1,23 @@
+export interface CacheResult {
+    /** Path to the cached repo checkout */
+    repoDir: string;
+    /** Resolved commit SHA */
+    commit: string;
+}
+/**
+ * Get or populate the global cache for a git source.
+ *
+ * Cache layout:
+ *   ~/.local/dotagents/<owner>/<repo>/          -- unpinned (TTL-refreshed)
+ *   ~/.local/dotagents/<owner>/<repo>@<sha>/    -- pinned (immutable)
+ */
+export declare function ensureCached(opts: {
+    url: string;
+    /** Cache key, e.g. "anthropics/skills" or "git.corp.example.com/team/skills" */
+    cacheKey: string;
+    ref?: string;
+    /** If set, we pin to this exact commit and don't refresh */
+    pinnedCommit?: string;
+    ttlMs?: number;
+}): Promise<CacheResult>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/sources/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/sources/cache.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsCvB"}

package/dist/sources/cache.js

@@ -0,0 +1,61 @@
+import { join } from "node:path";
+import { mkdir, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { clone, fetchAndReset, fetchRef, headCommit, isGitRepo } from "./git.js";
+const DEFAULT_STATE_DIR = join(homedir(), ".local", "dotagents");
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+/**
+ * Get or populate the global cache for a git source.
+ *
+ * Cache layout:
+ *   ~/.local/dotagents/<owner>/<repo>/          -- unpinned (TTL-refreshed)
+ *   ~/.local/dotagents/<owner>/<repo>@<sha>/    -- pinned (immutable)
+ */
+export async function ensureCached(opts) {
+    const stateDir = process.env["DOTAGENTS_STATE_DIR"] || DEFAULT_STATE_DIR;
+    const ttl = opts.ttlMs ?? DEFAULT_TTL_MS;
+    // Pinned to an exact commit
+    if (opts.pinnedCommit) {
+        const repoDir = join(stateDir, `${opts.cacheKey}@${opts.pinnedCommit}`);
+        if (isGitRepo(repoDir)) {
+            return { repoDir, commit: opts.pinnedCommit };
+        }
+        await mkdir(repoDir, { recursive: true });
+        await clone(opts.url, repoDir, opts.ref);
+        await fetchRef(repoDir, opts.pinnedCommit);
+        const commit = await headCommit(repoDir);
+        return { repoDir, commit };
+    }
+    // Unpinned — use TTL-based refresh
+    const repoDir = join(stateDir, opts.cacheKey);
+    if (isGitRepo(repoDir)) {
+        const needsRefresh = await isStale(repoDir, ttl);
+        if (needsRefresh) {
+            if (opts.ref) {
+                await fetchRef(repoDir, opts.ref);
+            }
+            else {
+                await fetchAndReset(repoDir);
+            }
+        }
+        const commit = await headCommit(repoDir);
+        return { repoDir, commit };
+    }
+    // Not cached yet — clone
+    await mkdir(join(stateDir, opts.cacheKey, ".."), { recursive: true });
+    await clone(opts.url, repoDir, opts.ref);
+    const commit = await headCommit(repoDir);
+    return { repoDir, commit };
+}
+async function isStale(repoDir, ttlMs) {
+    try {
+        const gitDir = join(repoDir, ".git", "FETCH_HEAD");
+        const s = await stat(gitDir);
+        return Date.now() - s.mtimeMs > ttlMs;
+    }
+    catch {
+        // No FETCH_HEAD yet — consider stale
+        return true;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/sources/cache.js.map

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

package/dist/sources/git.d.ts

@@ -0,0 +1,25 @@
+export declare class GitError extends Error {
+    constructor(message: string);
+}
+/**
+ * Clone a repo with --depth=1 into the given directory.
+ * If ref is provided, clones that specific ref.
+ */
+export declare function clone(url: string, dest: string, ref?: string): Promise<void>;
+/**
+ * Fetch latest and reset to origin's HEAD. For updating unpinned repos.
+ */
+export declare function fetchAndReset(repoDir: string): Promise<void>;
+/**
+ * Fetch a specific ref and checkout.
+ */
+export declare function fetchRef(repoDir: string, ref: string): Promise<void>;
+/**
+ * Get the current HEAD commit SHA (full 40 chars).
+ */
+export declare function headCommit(repoDir: string): Promise<string>;
+/**
+ * Check if a directory is a git repository.
+ */
+export declare function isGitRepo(dir: string): boolean;
+//# sourceMappingURL=git.d.ts.map

package/dist/sources/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/sources/git.ts"],"names":[],"mappings":"AAGA,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAsB,KAAK,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C"}

package/dist/sources/git.js

@@ -0,0 +1,72 @@
+import { exec, ExecError } from "../utils/exec.js";
+import { existsSync } from "node:fs";
+export class GitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GitError";
+    }
+}
+/**
+ * Clone a repo with --depth=1 into the given directory.
+ * If ref is provided, clones that specific ref.
+ */
+export async function clone(url, dest, ref) {
+    const args = ["clone", "--depth=1"];
+    if (ref) {
+        args.push("--branch", ref);
+    }
+    args.push("--", url, dest);
+    try {
+        await exec("git", args);
+    }
+    catch (err) {
+        if (err instanceof ExecError) {
+            throw new GitError(`Failed to clone ${url}: ${err.stderr}`);
+        }
+        throw err;
+    }
+}
+/**
+ * Fetch latest and reset to origin's HEAD. For updating unpinned repos.
+ */
+export async function fetchAndReset(repoDir) {
+    try {
+        await exec("git", ["fetch", "--depth=1", "--", "origin"], { cwd: repoDir });
+        await exec("git", ["reset", "--hard", "FETCH_HEAD"], { cwd: repoDir });
+    }
+    catch (err) {
+        if (err instanceof ExecError) {
+            throw new GitError(`Failed to update ${repoDir}: ${err.stderr}`);
+        }
+        throw err;
+    }
+}
+/**
+ * Fetch a specific ref and checkout.
+ */
+export async function fetchRef(repoDir, ref) {
+    try {
+        await exec("git", ["fetch", "--depth=1", "--", "origin", ref], { cwd: repoDir });
+        await exec("git", ["checkout", "FETCH_HEAD"], { cwd: repoDir });
+    }
+    catch (err) {
+        if (err instanceof ExecError) {
+            throw new GitError(`Failed to fetch ref ${ref} in ${repoDir}: ${err.stderr}`);
+        }
+        throw err;
+    }
+}
+/**
+ * Get the current HEAD commit SHA (full 40 chars).
+ */
+export async function headCommit(repoDir) {
+    const { stdout } = await exec("git", ["rev-parse", "HEAD"], { cwd: repoDir });
+    return stdout.trim();
+}
+/**
+ * Check if a directory is a git repository.
+ */
+export function isGitRepo(dir) {
+    return existsSync(`${dir}/.git`);
+}
+//# sourceMappingURL=git.js.map

package/dist/sources/git.js.map

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

package/dist/sources/index.d.ts

@@ -0,0 +1,5 @@
+export { clone, fetchAndReset, fetchRef, headCommit, isGitRepo, GitError } from "./git.js";
+export { ensureCached } from "./cache.js";
+export type { CacheResult } from "./cache.js";
+export { resolveLocalSource, LocalSourceError } from "./local.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/sources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/sources/index.js

@@ -0,0 +1,4 @@
+export { clone, fetchAndReset, fetchRef, headCommit, isGitRepo, GitError } from "./git.js";
+export { ensureCached } from "./cache.js";
+export { resolveLocalSource, LocalSourceError } from "./local.js";
+//# sourceMappingURL=index.js.map

package/dist/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/sources/local.d.ts

@@ -0,0 +1,9 @@
+export declare class LocalSourceError extends Error {
+    constructor(message: string);
+}
+/**
+ * Resolve a path: source to an absolute directory.
+ * The path is relative to the project root.
+ */
+export declare function resolveLocalSource(projectRoot: string, relativePath: string): Promise<string>;
+//# sourceMappingURL=local.d.ts.map

package/dist/sources/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/sources/local.ts"],"names":[],"mappings":"AAGA,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/sources/local.js

@@ -0,0 +1,32 @@
+import { resolve } from "node:path";
+import { stat } from "node:fs/promises";
+export class LocalSourceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "LocalSourceError";
+    }
+}
+/**
+ * Resolve a path: source to an absolute directory.
+ * The path is relative to the project root.
+ */
+export async function resolveLocalSource(projectRoot, relativePath) {
+    const absRoot = resolve(projectRoot);
+    const absPath = resolve(projectRoot, relativePath);
+    // Prevent path traversal outside the project root
+    if (!absPath.startsWith(absRoot + "/") && absPath !== absRoot) {
+        throw new LocalSourceError(`Local source "${relativePath}" resolves outside project root`);
+    }
+    let s;
+    try {
+        s = await stat(absPath);
+    }
+    catch {
+        throw new LocalSourceError(`Local source not found: ${absPath}`);
+    }
+    if (!s.isDirectory()) {
+        throw new LocalSourceError(`Local source is not a directory: ${absPath}`);
+    }
+    return absPath;
+}
+//# sourceMappingURL=local.js.map

package/dist/sources/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/sources/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,YAAoB;IAEpB,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEnD,kDAAkD;IAClD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QAC9D,MAAM,IAAI,gBAAgB,CACxB,iBAAiB,YAAY,iCAAiC,CAC/D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,CAAC;IACN,IAAI,CAAC;QACH,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gBAAgB,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,gBAAgB,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/symlinks/index.d.ts

@@ -0,0 +1,2 @@
+export { ensureSkillsSymlink, verifySymlinks, SymlinkError } from "./manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/symlinks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/symlinks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/symlinks/index.js

@@ -0,0 +1,2 @@
+export { ensureSkillsSymlink, verifySymlinks, SymlinkError } from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/symlinks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/symlinks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/symlinks/manager.d.ts

@@ -0,0 +1,20 @@
+export declare class SymlinkError extends Error {
+    constructor(message: string);
+}
+/**
+ * Ensure <targetDir>/skills/ is a symlink pointing to <agentsDir>/skills/.
+ * Creates the parent directory if it doesn't exist.
+ */
+export declare function ensureSkillsSymlink(agentsDir: string, targetDir: string): Promise<{
+    created: boolean;
+    migrated: string[];
+}>;
+/**
+ * Verify all configured symlinks are correct.
+ * Returns a list of issues found.
+ */
+export declare function verifySymlinks(agentsDir: string, targets: string[]): Promise<{
+    target: string;
+    issue: string;
+}[]>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/symlinks/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/symlinks/manager.ts"],"names":[],"mappings":"AAGA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAyCnD;AAkCD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CA2B9C"}

package/dist/symlinks/manager.js

@@ -0,0 +1,103 @@
+import { symlink, readlink, unlink, mkdir, lstat, readdir } from "node:fs/promises";
+import { join, relative } from "node:path";
+export class SymlinkError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SymlinkError";
+    }
+}
+/**
+ * Ensure <targetDir>/skills/ is a symlink pointing to <agentsDir>/skills/.
+ * Creates the parent directory if it doesn't exist.
+ */
+export async function ensureSkillsSymlink(agentsDir, targetDir) {
+    const skillsSource = join(agentsDir, "skills");
+    const skillsLink = join(targetDir, "skills");
+    const relativeTarget = relative(targetDir, skillsSource);
+    // Ensure parent directory exists
+    await mkdir(targetDir, { recursive: true });
+    // Check if skills path already exists
+    let stat;
+    try {
+        stat = await lstat(skillsLink);
+    }
+    catch {
+        // Doesn't exist, create symlink
+        await symlink(relativeTarget, skillsLink);
+        return { created: true, migrated: [] };
+    }
+    // Already a symlink - check if it points to the right place
+    if (stat.isSymbolicLink()) {
+        const currentTarget = await readlink(skillsLink);
+        if (currentTarget === relativeTarget) {
+            return { created: false, migrated: [] };
+        }
+        // Wrong target, replace
+        await unlink(skillsLink);
+        await symlink(relativeTarget, skillsLink);
+        return { created: true, migrated: [] };
+    }
+    // Real directory - migrate contents then replace with symlink
+    if (stat.isDirectory()) {
+        const migrated = await migrateDirectory(skillsLink, skillsSource);
+        await rmdir(skillsLink);
+        await symlink(relativeTarget, skillsLink);
+        return { created: true, migrated };
+    }
+    throw new SymlinkError(`${skillsLink} exists but is not a directory or symlink`);
+}
+async function migrateDirectory(from, to) {
+    const entries = await readdir(from, { withFileTypes: true });
+    const migrated = [];
+    for (const entry of entries) {
+        const srcPath = join(from, entry.name);
+        const destPath = join(to, entry.name);
+        // Skip if destination already exists
+        try {
+            await lstat(destPath);
+            continue;
+        }
+        catch {
+            // Doesn't exist, proceed with migration
+        }
+        const { rename } = await import("node:fs/promises");
+        await rename(srcPath, destPath);
+        migrated.push(entry.name);
+    }
+    return migrated;
+}
+async function rmdir(dir) {
+    const { rm } = await import("node:fs/promises");
+    await rm(dir, { recursive: true });
+}
+/**
+ * Verify all configured symlinks are correct.
+ * Returns a list of issues found.
+ */
+export async function verifySymlinks(agentsDir, targets) {
+    const issues = [];
+    const skillsSource = join(agentsDir, "skills");
+    for (const target of targets) {
+        const skillsLink = join(target, "skills");
+        const relativeTarget = relative(target, skillsSource);
+        try {
+            const stat = await lstat(skillsLink);
+            if (!stat.isSymbolicLink()) {
+                issues.push({ target, issue: `${skillsLink} is not a symlink` });
+                continue;
+            }
+            const currentTarget = await readlink(skillsLink);
+            if (currentTarget !== relativeTarget) {
+                issues.push({
+                    target,
+                    issue: `${skillsLink} points to ${currentTarget}, expected ${relativeTarget}`,
+                });
+            }
+        }
+        catch {
+            issues.push({ target, issue: `${skillsLink} does not exist` });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=manager.js.map

package/dist/symlinks/manager.js.map

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

package/dist/symlinks/manager.test.d.ts

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

package/dist/symlinks/manager.test.d.ts.map

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

package/dist/symlinks/manager.test.js

@@ -0,0 +1,94 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm, mkdir, writeFile, lstat, readlink, readdir, } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { ensureSkillsSymlink, verifySymlinks } from "./manager.js";
+describe("symlinks", () => {
+    let dir;
+    let agentsDir;
+    beforeEach(async () => {
+        dir = await mkdtemp(join(tmpdir(), "dotagents-test-"));
+        agentsDir = join(dir, ".agents");
+        await mkdir(join(agentsDir, "skills"), { recursive: true });
+    });
+    afterEach(async () => {
+        await rm(dir, { recursive: true });
+    });
+    describe("ensureSkillsSymlink", () => {
+        it("creates symlink when target dir does not exist", async () => {
+            const targetDir = join(dir, ".claude");
+            const result = await ensureSkillsSymlink(agentsDir, targetDir);
+            expect(result.created).toBe(true);
+            expect(result.migrated).toEqual([]);
+            const stat = await lstat(join(targetDir, "skills"));
+            expect(stat.isSymbolicLink()).toBe(true);
+            const linkTarget = await readlink(join(targetDir, "skills"));
+            expect(linkTarget).toBe("../.agents/skills");
+        });
+        it("creates symlink when target dir exists but skills/ does not", async () => {
+            const targetDir = join(dir, ".claude");
+            await mkdir(targetDir, { recursive: true });
+            await writeFile(join(targetDir, "settings.json"), "{}");
+            const result = await ensureSkillsSymlink(agentsDir, targetDir);
+            expect(result.created).toBe(true);
+            // settings.json should still be there
+            const entries = await readdir(targetDir);
+            expect(entries).toContain("settings.json");
+            expect(entries).toContain("skills");
+        });
+        it("is idempotent when symlink already correct", async () => {
+            const targetDir = join(dir, ".claude");
+            await ensureSkillsSymlink(agentsDir, targetDir);
+            const result = await ensureSkillsSymlink(agentsDir, targetDir);
+            expect(result.created).toBe(false);
+        });
+        it("replaces wrong symlink", async () => {
+            const targetDir = join(dir, ".claude");
+            await mkdir(targetDir, { recursive: true });
+            // Create a wrong symlink
+            const { symlink } = await import("node:fs/promises");
+            await symlink("/wrong/target", join(targetDir, "skills"));
+            const result = await ensureSkillsSymlink(agentsDir, targetDir);
+            expect(result.created).toBe(true);
+            const linkTarget = await readlink(join(targetDir, "skills"));
+            expect(linkTarget).toBe("../.agents/skills");
+        });
+        it("migrates existing real directory", async () => {
+            const targetDir = join(dir, ".claude");
+            const realSkillsDir = join(targetDir, "skills");
+            await mkdir(join(realSkillsDir, "my-local-skill"), { recursive: true });
+            await writeFile(join(realSkillsDir, "my-local-skill", "SKILL.md"), "---\nname: test\n---\n");
+            const result = await ensureSkillsSymlink(agentsDir, targetDir);
+            expect(result.created).toBe(true);
+            expect(result.migrated).toContain("my-local-skill");
+            // Verify the skill was moved to .agents/skills/
+            const agentsEntries = await readdir(join(agentsDir, "skills"));
+            expect(agentsEntries).toContain("my-local-skill");
+            // Verify symlink is now in place
+            const stat = await lstat(join(targetDir, "skills"));
+            expect(stat.isSymbolicLink()).toBe(true);
+        });
+    });
+    describe("verifySymlinks", () => {
+        it("returns no issues when all symlinks correct", async () => {
+            const targetDir = join(dir, ".claude");
+            await ensureSkillsSymlink(agentsDir, targetDir);
+            const issues = await verifySymlinks(agentsDir, [targetDir]);
+            expect(issues).toEqual([]);
+        });
+        it("reports missing symlink", async () => {
+            const targetDir = join(dir, ".claude");
+            const issues = await verifySymlinks(agentsDir, [targetDir]);
+            expect(issues).toHaveLength(1);
+            expect(issues[0]?.issue).toContain("does not exist");
+        });
+        it("reports non-symlink directory", async () => {
+            const targetDir = join(dir, ".claude");
+            await mkdir(join(targetDir, "skills"), { recursive: true });
+            const issues = await verifySymlinks(agentsDir, [targetDir]);
+            expect(issues).toHaveLength(1);
+            expect(issues[0]?.issue).toContain("not a symlink");
+        });
+    });
+});
+//# sourceMappingURL=manager.test.js.map

package/dist/symlinks/manager.test.js.map

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

package/dist/utils/exec.d.ts

@@ -0,0 +1,16 @@
+export declare class ExecError extends Error {
+    readonly exitCode: number | null;
+    readonly stderr: string;
+    constructor(message: string, exitCode: number | null, stderr: string);
+}
+interface ExecResult {
+    stdout: string;
+    stderr: string;
+}
+export declare function exec(cmd: string, args: string[], opts?: {
+    cwd?: string;
+    env?: Record<string, string>;
+    timeoutMs?: number;
+}): Promise<ExecResult>;
+export {};
+//# sourceMappingURL=exec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAEA,qBAAa,SAAU,SAAQ,KAAK;aAGhB,QAAQ,EAAE,MAAM,GAAG,IAAI;aACvB,MAAM,EAAE,MAAM;gBAF9B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM;CAKjC;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD,wBAAgB,IAAI,CAClB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,OAAO,CAAC,UAAU,CAAC,CA0BrB"}

package/dist/utils/exec.js

@@ -0,0 +1,37 @@
+import { execFile } from "node:child_process";
+export class ExecError extends Error {
+    exitCode;
+    stderr;
+    constructor(message, exitCode, stderr) {
+        super(message);
+        this.exitCode = exitCode;
+        this.stderr = stderr;
+        this.name = "ExecError";
+    }
+}
+/**
+ * Run a command and return stdout/stderr.
+ * Non-interactive: sets GIT_TERMINAL_PROMPT=0 for git commands.
+ */
+const DEFAULT_TIMEOUT_MS = 60_000; // 60 seconds
+export function exec(cmd, args, opts) {
+    return new Promise((resolve, reject) => {
+        const env = {
+            ...process.env,
+            // Prevent git from prompting for credentials
+            GIT_TERMINAL_PROMPT: "0",
+            // Prevent git from asking for SSH key passphrases
+            GIT_SSH_COMMAND: "ssh -o BatchMode=yes",
+            ...opts?.env,
+        };
+        execFile(cmd, args, { cwd: opts?.cwd, env, maxBuffer: 50 * 1024 * 1024, timeout: opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS }, (err, stdout, stderr) => {
+            if (err) {
+                const code = "code" in err ? err.code : null;
+                reject(new ExecError(`${cmd} ${args.join(" ")} failed: ${stderr.trim() || err.message}`, code, stderr));
+                return;
+            }
+            resolve({ stdout, stderr });
+        });
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/utils/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGhB;IACA;IAHlB,YACE,OAAe,EACC,QAAuB,EACvB,MAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,aAAQ,GAAR,QAAQ,CAAe;QACvB,WAAM,GAAN,MAAM,CAAQ;QAG9B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAOD;;;GAGG;AACH,MAAM,kBAAkB,GAAG,MAAM,CAAC,CAAC,aAAa;AAEhD,MAAM,UAAU,IAAI,CAClB,GAAW,EACX,IAAc,EACd,IAAyE;IAEzE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG;YACV,GAAG,OAAO,CAAC,GAAG;YACd,6CAA6C;YAC7C,mBAAmB,EAAE,GAAG;YACxB,kDAAkD;YAClD,eAAe,EAAE,sBAAsB;YACvC,GAAG,IAAI,EAAE,GAAG;SACb,CAAC;QAEF,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,IAAI,kBAAkB,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAChJ,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,IAAI,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,IAAsB,CAAC,CAAC,CAAC,IAAI,CAAC;gBAChE,MAAM,CACJ,IAAI,SAAS,CACX,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,EAClE,IAAI,EACJ,MAAM,CACP,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YACD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/fs.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copy a directory recursively.
+ * Removes destination first if it exists.
+ */
+export declare function copyDir(src: string, dest: string): Promise<void>;
+//# sourceMappingURL=fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/utils/fs.js

@@ -0,0 +1,10 @@
+import { cp, rm } from "node:fs/promises";
+/**
+ * Copy a directory recursively.
+ * Removes destination first if it exists.
+ */
+export async function copyDir(src, dest) {
+    await rm(dest, { recursive: true, force: true });
+    await cp(src, dest, { recursive: true });
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,IAAY;IACrD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC"}