@mycelish/cli 0.1.0

package/dist/core/snapshot.js

@@ -0,0 +1,179 @@
+/**
+ * Snapshot — create, restore, list, and delete config snapshots
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { mkdirp, MYCELIUM_HOME } from "./fs-helpers.js";
+function getMyceliumDir() {
+    return MYCELIUM_HOME;
+}
+function getSnapshotsDir() {
+    return path.join(getMyceliumDir(), "snapshots");
+}
+/** Files to capture relative to getMyceliumDir() */
+const SNAPSHOT_FILES = [
+    "global/mcps.yaml",
+    "global/hooks.yaml",
+    "migration-manifest.json",
+    "marketplaces.yaml",
+];
+const VALID_NAME = /^[a-zA-Z0-9-]+$/;
+// ============================================================================
+// Helpers
+// ============================================================================
+async function copyIfExists(src, dest) {
+    try {
+        await mkdirp(path.dirname(dest));
+        await fs.copyFile(src, dest);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function copyDirRecursive(src, dest) {
+    const files = [];
+    try {
+        const entries = await fs.readdir(src, { withFileTypes: true });
+        await mkdirp(dest);
+        for (const entry of entries) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...(await copyDirRecursive(srcPath, destPath)));
+            }
+            else {
+                await fs.copyFile(srcPath, destPath);
+                files.push(entry.name);
+            }
+        }
+    }
+    catch {
+        // directory doesn't exist, skip
+    }
+    return files;
+}
+async function rmrf(dir) {
+    await fs.rm(dir, { recursive: true, force: true });
+}
+// ============================================================================
+// Public API
+// ============================================================================
+export async function createSnapshot(name, description) {
+    if (!VALID_NAME.test(name)) {
+        throw new Error(`Invalid snapshot name "${name}": only alphanumeric characters and hyphens are allowed`);
+    }
+    const snapshotDir = path.join(getSnapshotsDir(), name);
+    // Check for duplicates
+    try {
+        await fs.access(snapshotDir);
+        throw new Error(`Snapshot "${name}" already exists`);
+    }
+    catch (err) {
+        if (err.message.includes("already exists"))
+            throw err;
+        // ENOENT is expected
+    }
+    await mkdirp(snapshotDir);
+    const fileList = [];
+    // Copy individual files
+    for (const relPath of SNAPSHOT_FILES) {
+        const src = path.join(getMyceliumDir(), relPath);
+        const dest = path.join(snapshotDir, relPath);
+        if (await copyIfExists(src, dest)) {
+            fileList.push(relPath);
+        }
+    }
+    // Copy memory directory
+    const memoryFiles = await copyDirRecursive(path.join(getMyceliumDir(), "memory"), path.join(snapshotDir, "memory"));
+    for (const f of memoryFiles) {
+        fileList.push(`memory/${f}`);
+    }
+    // Read symlinks in global/skills/
+    const skillSymlinks = {};
+    const skillsDir = path.join(getMyceliumDir(), "global", "skills");
+    try {
+        const entries = await fs.readdir(skillsDir);
+        for (const entry of entries) {
+            const fullPath = path.join(skillsDir, entry);
+            try {
+                const target = await fs.readlink(fullPath);
+                skillSymlinks[entry] = target;
+            }
+            catch {
+                // Not a symlink, skip
+            }
+        }
+    }
+    catch {
+        // skills dir doesn't exist
+    }
+    const metadata = {
+        name,
+        createdAt: new Date().toISOString(),
+        description,
+        skillSymlinks,
+        fileList,
+    };
+    await fs.writeFile(path.join(snapshotDir, "metadata.json"), JSON.stringify(metadata, null, 2));
+    return metadata;
+}
+export async function restoreSnapshot(name) {
+    const snapshotDir = path.join(getSnapshotsDir(), name);
+    let raw;
+    try {
+        raw = await fs.readFile(path.join(snapshotDir, "metadata.json"), "utf-8");
+    }
+    catch {
+        throw new Error(`Snapshot "${name}" not found`);
+    }
+    const metadata = JSON.parse(raw);
+    // Remove current config files
+    for (const relPath of SNAPSHOT_FILES) {
+        await fs.rm(path.join(getMyceliumDir(), relPath), { force: true });
+    }
+    await rmrf(path.join(getMyceliumDir(), "memory"));
+    await rmrf(path.join(getMyceliumDir(), "global", "skills"));
+    // Restore files
+    for (const relPath of metadata.fileList) {
+        const src = path.join(snapshotDir, relPath);
+        const dest = path.join(getMyceliumDir(), relPath);
+        await copyIfExists(src, dest);
+    }
+    // Recreate symlinks
+    const skillsDir = path.join(getMyceliumDir(), "global", "skills");
+    await mkdirp(skillsDir);
+    for (const [linkName, target] of Object.entries(metadata.skillSymlinks)) {
+        await fs.symlink(target, path.join(skillsDir, linkName));
+    }
+}
+export async function listSnapshots() {
+    const results = [];
+    try {
+        const entries = await fs.readdir(getSnapshotsDir());
+        for (const entry of entries) {
+            try {
+                const raw = await fs.readFile(path.join(getSnapshotsDir(), entry, "metadata.json"), "utf-8");
+                results.push(JSON.parse(raw));
+            }
+            catch {
+                // skip invalid entries
+            }
+        }
+    }
+    catch {
+        // snapshots dir doesn't exist yet
+    }
+    return results.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+}
+export async function deleteSnapshot(name) {
+    const snapshotDir = path.join(getSnapshotsDir(), name);
+    try {
+        await fs.access(snapshotDir);
+    }
+    catch {
+        throw new Error(`Snapshot "${name}" not found`);
+    }
+    await rmrf(snapshotDir);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/core/snapshot.js.map

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

package/dist/core/snapshot.test.d.ts

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

package/dist/core/snapshot.test.d.ts.map

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

package/dist/core/snapshot.test.js

@@ -0,0 +1,132 @@
+/**
+ * Tests for the Snapshot module
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+// We mock os.homedir to point to a temp directory so snapshot.ts operates in isolation
+let tmpDir;
+vi.mock("node:os", async () => {
+    const actual = await vi.importActual("node:os");
+    return {
+        ...actual,
+        homedir: () => tmpDir,
+    };
+});
+// Mock fs-helpers to avoid MYCELIUM_HOME evaluation at import time (os.homedir() is undefined then)
+vi.mock("./fs-helpers.js", async () => {
+    const fsp = await import("node:fs/promises");
+    const osMod = await import("node:os");
+    const pathMod = await import("node:path");
+    return {
+        mkdirp: (dir) => fsp.mkdir(dir, { recursive: true }),
+        get MYCELIUM_HOME() { return pathMod.join(osMod.homedir(), ".mycelium"); },
+        DEFAULT_PORT: 3378,
+        MEMORY_LINE_LIMIT: 200,
+        readFileIfExists: vi.fn(),
+    };
+});
+// Must import after mock setup
+const { createSnapshot, restoreSnapshot, listSnapshots, deleteSnapshot } = await import("./snapshot.js");
+async function setupMyceliumDir() {
+    const myceliumDir = path.join(tmpDir, ".mycelium");
+    await fs.mkdir(path.join(myceliumDir, "global", "skills"), { recursive: true });
+    await fs.mkdir(path.join(myceliumDir, "memory"), { recursive: true });
+    await fs.writeFile(path.join(myceliumDir, "global", "mcps.yaml"), "mcps:\n  test: {}\n");
+    await fs.writeFile(path.join(myceliumDir, "global", "hooks.yaml"), "hooks: []\n");
+    await fs.writeFile(path.join(myceliumDir, "memory", "shared.md"), "# Shared memory\n");
+    await fs.writeFile(path.join(myceliumDir, "migration-manifest.json"), '{"version":"1","entries":[]}');
+    await fs.writeFile(path.join(myceliumDir, "marketplaces.yaml"), "sources: {}\n");
+    // Create a symlink in skills
+    const targetDir = path.join(tmpDir, "skill-target");
+    await fs.mkdir(targetDir, { recursive: true });
+    await fs.symlink(targetDir, path.join(myceliumDir, "global", "skills", "my-skill"));
+    return myceliumDir;
+}
+beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "snapshot-test-"));
+});
+afterEach(async () => {
+    await fs.rm(tmpDir, { recursive: true, force: true });
+});
+describe("createSnapshot", () => {
+    it("captures files and symlink targets in metadata", async () => {
+        await setupMyceliumDir();
+        const meta = await createSnapshot("test-snap", "A test snapshot");
+        expect(meta.name).toBe("test-snap");
+        expect(meta.description).toBe("A test snapshot");
+        expect(meta.fileList).toContain("global/mcps.yaml");
+        expect(meta.fileList).toContain("memory/shared.md");
+        expect(meta.skillSymlinks["my-skill"]).toBeDefined();
+        // Verify metadata.json was written
+        const raw = await fs.readFile(path.join(tmpDir, ".mycelium", "snapshots", "test-snap", "metadata.json"), "utf-8");
+        const saved = JSON.parse(raw);
+        expect(saved.name).toBe("test-snap");
+    });
+    it("throws on duplicate name", async () => {
+        await setupMyceliumDir();
+        await createSnapshot("dup");
+        await expect(createSnapshot("dup")).rejects.toThrow("already exists");
+    });
+    it("throws on invalid name with spaces", async () => {
+        await setupMyceliumDir();
+        await expect(createSnapshot("bad name")).rejects.toThrow("Invalid snapshot name");
+    });
+    it("throws on invalid name with slashes", async () => {
+        await setupMyceliumDir();
+        await expect(createSnapshot("bad/name")).rejects.toThrow("Invalid snapshot name");
+    });
+});
+describe("restoreSnapshot", () => {
+    it("recreates files and symlinks", async () => {
+        const myceliumDir = await setupMyceliumDir();
+        await createSnapshot("restore-test");
+        // Delete the originals
+        await fs.rm(path.join(myceliumDir, "global", "mcps.yaml"));
+        await fs.rm(path.join(myceliumDir, "global", "skills", "my-skill"));
+        await fs.rm(path.join(myceliumDir, "memory"), { recursive: true });
+        await restoreSnapshot("restore-test");
+        // Verify restored
+        const mcps = await fs.readFile(path.join(myceliumDir, "global", "mcps.yaml"), "utf-8");
+        expect(mcps).toContain("mcps:");
+        const symlinkTarget = await fs.readlink(path.join(myceliumDir, "global", "skills", "my-skill"));
+        expect(symlinkTarget).toContain("skill-target");
+    });
+    it("throws on non-existent snapshot", async () => {
+        await setupMyceliumDir();
+        await expect(restoreSnapshot("nope")).rejects.toThrow("not found");
+    });
+});
+describe("listSnapshots", () => {
+    it("returns snapshots sorted by date descending", async () => {
+        await setupMyceliumDir();
+        await createSnapshot("first");
+        // Small delay to ensure different timestamps
+        await new Promise((r) => setTimeout(r, 10));
+        await createSnapshot("second");
+        const list = await listSnapshots();
+        expect(list).toHaveLength(2);
+        expect(list[0].name).toBe("second");
+        expect(list[1].name).toBe("first");
+    });
+    it("returns empty array when no snapshots exist", async () => {
+        await setupMyceliumDir();
+        const list = await listSnapshots();
+        expect(list).toEqual([]);
+    });
+});
+describe("deleteSnapshot", () => {
+    it("removes snapshot directory", async () => {
+        await setupMyceliumDir();
+        await createSnapshot("to-delete");
+        await deleteSnapshot("to-delete");
+        const list = await listSnapshots();
+        expect(list).toHaveLength(0);
+    });
+    it("throws on non-existent snapshot", async () => {
+        await setupMyceliumDir();
+        await expect(deleteSnapshot("nope")).rejects.toThrow("not found");
+    });
+});
+//# sourceMappingURL=snapshot.test.js.map

package/dist/core/snapshot.test.js.map

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

package/dist/core/symlink-manager.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Symlink Manager for Mycelium
+ *
+ * Handles creating, updating, and removing symlinks from the global
+ * skills directory to tool-specific directories.
+ */
+export interface CreateSymlinkResult {
+    success: boolean;
+    action: "created" | "updated" | "replaced" | "unchanged" | "error";
+    backupPath?: string;
+    error?: string;
+}
+export interface RemoveSymlinkResult {
+    success: boolean;
+    existed: boolean;
+    error?: string;
+}
+export interface SymlinkValidation {
+    valid: boolean;
+    exists?: boolean;
+    isSymlink?: boolean;
+    currentTarget?: string;
+    expectedTarget?: string;
+}
+export interface SkillSymlinkStatus {
+    skillName: string;
+    skillPath: string;
+    symlinkPath: string;
+    exists: boolean;
+    valid: boolean;
+    currentTarget?: string;
+}
+export interface Skill {
+    name: string;
+    path: string;
+    manifest: {
+        name: string;
+        enabled?: boolean;
+    };
+}
+export interface SyncOptions {
+    removeOrphans?: boolean;
+}
+export interface SyncResult {
+    success: boolean;
+    created: string[];
+    updated: string[];
+    removed: string[];
+    unchanged: string[];
+    errors: Array<{
+        skill: string;
+        error: string;
+    }>;
+}
+/**
+ * Create a symlink from a skill source path to a tool directory location.
+ * Handles existing symlinks, files, and directories appropriately.
+ */
+export declare function createSkillSymlink(sourcePath: string, symlinkPath: string): Promise<CreateSymlinkResult>;
+/**
+ * Remove a symlink. Only removes actual symlinks, not regular files/directories.
+ */
+export declare function removeSkillSymlink(symlinkPath: string): Promise<RemoveSymlinkResult>;
+/**
+ * Check if a symlink exists and points to the expected target.
+ */
+export declare function isSymlinkValid(symlinkPath: string, expectedTarget: string): Promise<SymlinkValidation>;
+/**
+ * Get the status of symlinks for a list of skills in a tool directory.
+ */
+export declare function getSymlinkStatus(skills: Skill[], toolSkillsDir: string): Promise<SkillSymlinkStatus[]>;
+/**
+ * Sync all skills to a specific tool directory.
+ * Creates symlinks for enabled skills, removes symlinks for disabled skills,
+ * and optionally removes orphaned symlinks.
+ */
+export declare function syncSkillsToTool(skills: Skill[], toolSkillsDir: string, options?: SyncOptions): Promise<SyncResult>;
+//# sourceMappingURL=symlink-manager.d.ts.map

package/dist/core/symlink-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symlink-manager.d.ts","sourceRoot":"","sources":["../../src/core/symlink-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC,CA4C9B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC,CA6B9B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAgC5B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,KAAK,EAAE,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkB/B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,KAAK,EAAE,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAsFrB"}

package/dist/core/symlink-manager.js

@@ -0,0 +1,227 @@
+/**
+ * Symlink Manager for Mycelium
+ *
+ * Handles creating, updating, and removing symlinks from the global
+ * skills directory to tool-specific directories.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+// ============================================================================
+// Core Functions
+// ============================================================================
+/**
+ * Create a symlink from a skill source path to a tool directory location.
+ * Handles existing symlinks, files, and directories appropriately.
+ */
+export async function createSkillSymlink(sourcePath, symlinkPath) {
+    try {
+        // Ensure parent directory exists
+        const parentDir = path.dirname(symlinkPath);
+        await fs.mkdir(parentDir, { recursive: true });
+        // Check if something exists at the symlink path
+        let stats;
+        try {
+            stats = await fs.lstat(symlinkPath);
+        }
+        catch {
+            // Path doesn't exist, create new symlink
+            await fs.symlink(sourcePath, symlinkPath);
+            return { success: true, action: "created" };
+        }
+        // Something exists at the path
+        if (stats.isSymbolicLink()) {
+            // Check if it points to the correct target
+            const currentTarget = await fs.readlink(symlinkPath);
+            if (currentTarget === sourcePath) {
+                return { success: true, action: "unchanged" };
+            }
+            // Update symlink to new target
+            await fs.unlink(symlinkPath);
+            await fs.symlink(sourcePath, symlinkPath);
+            return { success: true, action: "updated" };
+        }
+        // Not a symlink - backup and replace
+        const backupPath = `${symlinkPath}.backup.${Date.now()}`;
+        await fs.rename(symlinkPath, backupPath);
+        await fs.symlink(sourcePath, symlinkPath);
+        return { success: true, action: "replaced", backupPath };
+    }
+    catch (error) {
+        return {
+            success: false,
+            action: "error",
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Remove a symlink. Only removes actual symlinks, not regular files/directories.
+ */
+export async function removeSkillSymlink(symlinkPath) {
+    try {
+        // Check if path exists
+        let stats;
+        try {
+            stats = await fs.lstat(symlinkPath);
+        }
+        catch {
+            // Path doesn't exist
+            return { success: true, existed: false };
+        }
+        // Only remove if it's a symlink
+        if (!stats.isSymbolicLink()) {
+            return {
+                success: false,
+                existed: true,
+                error: `Path exists but is not a symlink: ${symlinkPath}`,
+            };
+        }
+        await fs.unlink(symlinkPath);
+        return { success: true, existed: true };
+    }
+    catch (error) {
+        return {
+            success: false,
+            existed: true,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Check if a symlink exists and points to the expected target.
+ */
+export async function isSymlinkValid(symlinkPath, expectedTarget) {
+    try {
+        // Check if path exists
+        let stats;
+        try {
+            stats = await fs.lstat(symlinkPath);
+        }
+        catch {
+            return { valid: false, exists: false };
+        }
+        // Check if it's a symlink
+        if (!stats.isSymbolicLink()) {
+            return { valid: false, exists: true, isSymlink: false };
+        }
+        // Check if it points to the correct target
+        const currentTarget = await fs.readlink(symlinkPath);
+        if (currentTarget === expectedTarget) {
+            return { valid: true, currentTarget };
+        }
+        return {
+            valid: false,
+            exists: true,
+            isSymlink: true,
+            currentTarget,
+            expectedTarget,
+        };
+    }
+    catch (error) {
+        return { valid: false };
+    }
+}
+/**
+ * Get the status of symlinks for a list of skills in a tool directory.
+ */
+export async function getSymlinkStatus(skills, toolSkillsDir) {
+    const statuses = [];
+    for (const skill of skills) {
+        const symlinkPath = path.join(toolSkillsDir, skill.name);
+        const validation = await isSymlinkValid(symlinkPath, skill.path);
+        statuses.push({
+            skillName: skill.name,
+            skillPath: skill.path,
+            symlinkPath,
+            exists: validation.exists !== false,
+            valid: validation.valid,
+            currentTarget: validation.currentTarget,
+        });
+    }
+    return statuses;
+}
+/**
+ * Sync all skills to a specific tool directory.
+ * Creates symlinks for enabled skills, removes symlinks for disabled skills,
+ * and optionally removes orphaned symlinks.
+ */
+export async function syncSkillsToTool(skills, toolSkillsDir, options = {}) {
+    const result = {
+        success: true,
+        created: [],
+        updated: [],
+        removed: [],
+        unchanged: [],
+        errors: [],
+    };
+    // Ensure tool skills directory exists
+    await fs.mkdir(toolSkillsDir, { recursive: true });
+    // Build set of skill names for orphan detection
+    const skillNames = new Set(skills.map((s) => s.name));
+    // Process each skill
+    for (const skill of skills) {
+        const symlinkPath = path.join(toolSkillsDir, skill.name);
+        const isEnabled = skill.manifest.enabled !== false;
+        if (isEnabled) {
+            // Create or update symlink
+            const createResult = await createSkillSymlink(skill.path, symlinkPath);
+            if (createResult.success) {
+                switch (createResult.action) {
+                    case "created":
+                        result.created.push(skill.name);
+                        break;
+                    case "updated":
+                    case "replaced":
+                        result.updated.push(skill.name);
+                        break;
+                    case "unchanged":
+                        result.unchanged.push(skill.name);
+                        break;
+                }
+            }
+            else {
+                result.success = false;
+                result.errors.push({ skill: skill.name, error: createResult.error || "Unknown error" });
+            }
+        }
+        else {
+            // Remove symlink for disabled skill
+            const removeResult = await removeSkillSymlink(symlinkPath);
+            if (removeResult.existed) {
+                result.removed.push(skill.name);
+            }
+            if (!removeResult.success && removeResult.existed) {
+                result.errors.push({ skill: skill.name, error: removeResult.error || "Unknown error" });
+            }
+        }
+    }
+    // Handle orphaned symlinks
+    if (options.removeOrphans) {
+        try {
+            const entries = await fs.readdir(toolSkillsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                // Skip if this is a known skill
+                if (skillNames.has(entry.name)) {
+                    continue;
+                }
+                const entryPath = path.join(toolSkillsDir, entry.name);
+                // Only remove symlinks
+                try {
+                    const stats = await fs.lstat(entryPath);
+                    if (stats.isSymbolicLink()) {
+                        await fs.unlink(entryPath);
+                        result.removed.push(entry.name);
+                    }
+                }
+                catch {
+                    // Ignore errors for individual entries
+                }
+            }
+        }
+        catch {
+            // Ignore errors reading directory
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=symlink-manager.js.map

package/dist/core/symlink-manager.js.map

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