skillmux 0.1.2 → 0.1.3

package/dist/chunk-DBEVDI27.js

@@ -0,0 +1,1826 @@
+// src/config/default-agent-rules.ts
+var supportedPlatforms = ["win32", "linux", "darwin"];
+var builtInAgentIds = [
+  "codex",
+  "claude",
+  "gemini",
+  "agents",
+  "openclaw"
+];
+var defaultAgentRules = [
+  {
+    id: "codex",
+    stableName: "OpenAI Codex",
+    supportedPlatforms: [...supportedPlatforms],
+    homeRelativeRootPath: ".codex",
+    skillsDirectoryPath: "skills",
+    enabledByDefault: true,
+    discovery: "builtin"
+  },
+  {
+    id: "claude",
+    stableName: "Claude Code",
+    supportedPlatforms: [...supportedPlatforms],
+    homeRelativeRootPath: ".claude",
+    skillsDirectoryPath: "skills",
+    enabledByDefault: true,
+    discovery: "builtin"
+  },
+  {
+    id: "gemini",
+    stableName: "Gemini CLI",
+    supportedPlatforms: [...supportedPlatforms],
+    homeRelativeRootPath: ".gemini",
+    skillsDirectoryPath: "skills",
+    enabledByDefault: true,
+    discovery: "builtin"
+  },
+  {
+    id: "agents",
+    stableName: "Agents",
+    supportedPlatforms: [...supportedPlatforms],
+    homeRelativeRootPath: ".agents",
+    skillsDirectoryPath: "skills",
+    enabledByDefault: true,
+    discovery: "builtin"
+  },
+  {
+    id: "openclaw",
+    stableName: "OpenClaw",
+    supportedPlatforms: [...supportedPlatforms],
+    homeRelativeRootPath: ".openclaw",
+    skillsDirectoryPath: "skills",
+    enabledByDefault: true,
+    discovery: "builtin"
+  }
+];
+var defaultAgentRuleMap = Object.fromEntries(
+  defaultAgentRules.map((rule) => [rule.id, rule])
+);
+
+// src/commands/adopt.ts
+import { homedir } from "os";
+import { join as join7, resolve as resolve8 } from "path";
+
+// src/core/errors.ts
+var SkillMuxError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = new.target.name;
+  }
+};
+var InvalidIdentifierError = class extends SkillMuxError {
+  constructor(kind, value) {
+    super(`Invalid ${kind}: ${value}`);
+    this.kind = kind;
+    this.value = value;
+  }
+  kind;
+  value;
+};
+var ManifestValidationError = class extends SkillMuxError {
+  constructor(message) {
+    super(message);
+  }
+};
+var UserConfigValidationError = class extends SkillMuxError {
+  constructor(message) {
+    super(message);
+  }
+};
+var AdoptionError = class extends SkillMuxError {
+  constructor(message) {
+    super(message);
+  }
+};
+
+// src/core/ids.ts
+var ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function normalizeId(value) {
+  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return normalized.length > 0 ? normalized : "skill";
+}
+function isValidId(value) {
+  return ID_PATTERN.test(value);
+}
+
+// src/config/resolve-skillmux-home.ts
+import { join, resolve } from "path";
+function buildConfigPath(skillmuxHome) {
+  return join(resolve(skillmuxHome), "config.json");
+}
+function resolveSkillmuxHome(homeDir) {
+  const resolvedHomeDir = resolve(homeDir);
+  const skillmuxHome = join(resolvedHomeDir, ".skillmux");
+  return {
+    skillmuxHome,
+    configPath: buildConfigPath(skillmuxHome)
+  };
+}
+
+// src/discovery/discover-agents.ts
+import * as fs2 from "fs/promises";
+import { join as join2, resolve as resolve2 } from "path";
+
+// src/config/load-user-config.ts
+import * as fs from "fs/promises";
+import { z } from "zod";
+var supportedPlatformSchema = z.enum(supportedPlatforms);
+var agentOverrideSchema = z.object({
+  stableName: z.string().min(1).optional(),
+  supportedPlatforms: z.array(supportedPlatformSchema).min(1).optional(),
+  homeRelativeRootPath: z.string().min(1).optional(),
+  skillsDirectoryPath: z.string().min(1).optional(),
+  enabledByDefault: z.boolean().optional()
+}).strict();
+var userConfigSchema = z.object({
+  version: z.literal(1),
+  agents: z.record(z.string().min(1), agentOverrideSchema)
+}).strict();
+function createEmptyUserConfig() {
+  return {
+    version: 1,
+    agents: {}
+  };
+}
+function stripUtf8Bom(contents) {
+  return contents.charCodeAt(0) === 65279 ? contents.slice(1) : contents;
+}
+function formatValidationIssues(error) {
+  return error.issues.map((issue) => {
+    const path = issue.path.length > 0 ? issue.path.join(".") : "<root>";
+    return `${path}: ${issue.message}`;
+  }).join("; ");
+}
+async function loadUserConfig(skillmuxHome) {
+  const configPath = buildConfigPath(skillmuxHome);
+  try {
+    const contents = await fs.readFile(configPath, "utf8");
+    const parsed = JSON.parse(stripUtf8Bom(contents));
+    const validated = userConfigSchema.safeParse(parsed);
+    if (!validated.success) {
+      throw new UserConfigValidationError(
+        `Invalid config at ${configPath}: ${formatValidationIssues(validated.error)}`
+      );
+    }
+    return validated.data;
+  } catch (error) {
+    if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+      return createEmptyUserConfig();
+    }
+    if (error instanceof SyntaxError) {
+      throw new UserConfigValidationError(
+        `Invalid config at ${configPath}: malformed JSON`
+      );
+    }
+    throw error;
+  }
+}
+
+// src/discovery/discover-agents.ts
+function mergeRule(rule, override) {
+  if (override === void 0) {
+    return rule;
+  }
+  return {
+    ...rule,
+    ...override
+  };
+}
+function buildCustomRule(id, override) {
+  if (override.homeRelativeRootPath === void 0 || override.skillsDirectoryPath === void 0) {
+    throw new Error(
+      `Custom agent override "${id}" must define homeRelativeRootPath and skillsDirectoryPath`
+    );
+  }
+  return {
+    id,
+    stableName: override.stableName ?? id,
+    supportedPlatforms: override.supportedPlatforms ?? [...supportedPlatforms],
+    homeRelativeRootPath: override.homeRelativeRootPath,
+    skillsDirectoryPath: override.skillsDirectoryPath,
+    enabledByDefault: override.enabledByDefault ?? true,
+    discovery: "custom"
+  };
+}
+async function pathExists(path) {
+  try {
+    await fs2.access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function resolveAgentRulePaths(homeDir, rule) {
+  const absoluteRootPath = resolve2(homeDir, rule.homeRelativeRootPath);
+  return {
+    absoluteRootPath,
+    absoluteSkillsDirectoryPath: join2(
+      absoluteRootPath,
+      rule.skillsDirectoryPath
+    )
+  };
+}
+async function discoverAgents(options) {
+  const platform = options.platform ?? process.platform;
+  const homeDir = resolve2(options.homeDir);
+  const skillmuxHome = options.skillmuxHome ?? resolveSkillmuxHome(homeDir).skillmuxHome;
+  const userConfig = await loadUserConfig(skillmuxHome);
+  const discoveredAgents = [];
+  for (const agentId of builtInAgentIds) {
+    const mergedRule = mergeRule(
+      defaultAgentRuleMap[agentId],
+      userConfig.agents[agentId]
+    );
+    const resolvedPaths = resolveAgentRulePaths(homeDir, mergedRule);
+    discoveredAgents.push({
+      ...mergedRule,
+      ...resolvedPaths,
+      exists: await pathExists(resolvedPaths.absoluteSkillsDirectoryPath),
+      supportedOnPlatform: mergedRule.supportedPlatforms.some(
+        (supportedPlatform) => supportedPlatform === platform
+      )
+    });
+  }
+  for (const [agentId, override] of Object.entries(userConfig.agents)) {
+    if (Object.hasOwn(defaultAgentRuleMap, agentId)) {
+      continue;
+    }
+    const customRule = buildCustomRule(agentId, override);
+    const resolvedPaths = resolveAgentRulePaths(homeDir, customRule);
+    discoveredAgents.push({
+      ...customRule,
+      ...resolvedPaths,
+      exists: await pathExists(resolvedPaths.absoluteSkillsDirectoryPath),
+      supportedOnPlatform: customRule.supportedPlatforms.some(
+        (supportedPlatform) => supportedPlatform === platform
+      )
+    });
+  }
+  return discoveredAgents;
+}
+
+// src/discovery/scan-agent-skills.ts
+import * as fs5 from "fs/promises";
+import { join as join3 } from "path";
+
+// src/discovery/infer-skill-entry.ts
+import * as fs4 from "fs/promises";
+import { basename, resolve as resolve4 } from "path";
+
+// src/fs/path-utils.ts
+import * as fs3 from "fs/promises";
+import { dirname, parse, relative, resolve as resolve3, sep } from "path";
+function normalizeAbsolutePath(path) {
+  const normalized = resolve3(path);
+  return process.platform === "win32" ? normalized.replaceAll("/", "\\").toLowerCase() : normalized;
+}
+function pathsAreEqual(left, right) {
+  return normalizeAbsolutePath(left) === normalizeAbsolutePath(right);
+}
+function isPathInside(parentPath, childPath) {
+  const parent = normalizeAbsolutePath(parentPath);
+  const child = normalizeAbsolutePath(childPath);
+  if (parse(parent).root !== parse(child).root) {
+    return false;
+  }
+  const relativePath = relative(parent, child);
+  if (relativePath === "") {
+    return true;
+  }
+  if (relativePath === "..") {
+    return false;
+  }
+  if (relativePath.startsWith(`..${sep}`)) {
+    return false;
+  }
+  return true;
+}
+async function assertNoSymlinkAncestors(path, options) {
+  let current = options?.includeLeaf === true ? resolve3(path) : dirname(resolve3(path));
+  while (true) {
+    try {
+      const entry = await fs3.lstat(current);
+      if (entry.isSymbolicLink()) {
+        throw new Error(`Refusing to use path with symlink ancestor at ${current}`);
+      }
+    } catch (error) {
+      if (error.code !== "ENOENT") {
+        throw error;
+      }
+    }
+    const parent = dirname(current);
+    if (parent === current) {
+      return;
+    }
+    current = parent;
+  }
+}
+
+// src/discovery/infer-skill-entry.ts
+function buildIssue(code, severity, message, path) {
+  return { code, severity, message, path };
+}
+async function inferSkillEntry(options) {
+  const absolutePath = resolve4(options.path);
+  const skillName = basename(absolutePath);
+  const stats = await fs4.lstat(absolutePath);
+  if (stats.isSymbolicLink()) {
+    try {
+      const targetPath = await fs4.realpath(absolutePath);
+      if (isPathInside(options.skillmuxHome, targetPath)) {
+        return {
+          entry: {
+            agentId: options.agentId,
+            agentName: options.agentName,
+            skillName,
+            kind: "managed-link",
+            path: absolutePath,
+            targetPath
+          }
+        };
+      }
+      return {
+        entry: {
+          agentId: options.agentId,
+          agentName: options.agentName,
+          skillName,
+          kind: "unmanaged-link",
+          path: absolutePath,
+          targetPath
+        }
+      };
+    } catch (error) {
+      if (error.code !== "ENOENT") {
+        throw error;
+      }
+      return {
+        entry: {
+          agentId: options.agentId,
+          agentName: options.agentName,
+          skillName,
+          kind: "broken-link",
+          path: absolutePath
+        },
+        issue: buildIssue(
+          "broken-link",
+          "error",
+          "Skill entry points to a missing target",
+          absolutePath
+        )
+      };
+    }
+  }
+  if (stats.isDirectory()) {
+    return {
+      entry: {
+        agentId: options.agentId,
+        agentName: options.agentName,
+        skillName,
+        kind: "unmanaged-directory",
+        path: absolutePath
+      }
+    };
+  }
+  return {
+    entry: {
+      agentId: options.agentId,
+      agentName: options.agentName,
+      skillName,
+      kind: "unknown",
+      path: absolutePath
+    },
+    issue: buildIssue(
+      "unknown-entry",
+      "warning",
+      "Skill entry is neither a managed link nor a directory",
+      absolutePath
+    )
+  };
+}
+
+// src/discovery/scan-agent-skills.ts
+async function scanAgentSkills(agent, skillmuxHome) {
+  if (!agent.exists || !agent.supportedOnPlatform) {
+    return {
+      entries: [],
+      issues: []
+    };
+  }
+  const directoryEntries = await fs5.readdir(agent.absoluteSkillsDirectoryPath, {
+    withFileTypes: true
+  });
+  const sortedDirectoryEntries = [...directoryEntries].sort(
+    (left, right) => left.name.localeCompare(right.name)
+  );
+  const entries = [];
+  const issues = [];
+  for (const directoryEntry of sortedDirectoryEntries) {
+    const result = await inferSkillEntry({
+      agentId: agent.id,
+      agentName: agent.stableName,
+      path: join3(agent.absoluteSkillsDirectoryPath, directoryEntry.name),
+      skillmuxHome
+    });
+    entries.push(result.entry);
+    if (result.issue !== void 0) {
+      issues.push(result.issue);
+    }
+  }
+  return {
+    entries,
+    issues
+  };
+}
+
+// src/fs/safe-copy.ts
+import * as fs6 from "fs/promises";
+import { dirname as dirname2, join as join4, resolve as resolve5 } from "path";
+async function assertDirectory(path) {
+  const entry = await fs6.lstat(path);
+  if (!entry.isDirectory()) {
+    throw new Error(`Expected a directory at ${path}`);
+  }
+}
+async function assertRegularFile(path, label) {
+  const entry = await fs6.lstat(path);
+  if (!entry.isFile()) {
+    throw new Error(`Expected ${label} to be a regular file at ${path}`);
+  }
+}
+async function assertTargetDoesNotExist(path) {
+  try {
+    await fs6.lstat(path);
+    throw new Error(`Refusing to overwrite existing path at ${path}`);
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      throw error;
+    }
+  }
+}
+async function copyDirectoryContents(sourcePath, targetPath) {
+  await fs6.mkdir(targetPath, { recursive: true });
+  const entries = await fs6.readdir(sourcePath, { withFileTypes: true });
+  for (const entry of entries) {
+    const sourceEntryPath = join4(sourcePath, entry.name);
+    const targetEntryPath = join4(targetPath, entry.name);
+    const entryStats = await fs6.lstat(sourceEntryPath);
+    if (entryStats.isSymbolicLink()) {
+      throw new Error(`Refusing to copy source symlink at ${sourceEntryPath}`);
+    }
+    if (entryStats.isDirectory()) {
+      await copyDirectoryContents(sourceEntryPath, targetEntryPath);
+      continue;
+    }
+    if (entryStats.isFile()) {
+      await fs6.mkdir(dirname2(targetEntryPath), { recursive: true });
+      await fs6.copyFile(sourceEntryPath, targetEntryPath);
+      continue;
+    }
+    throw new Error(`Unsupported filesystem entry at ${sourceEntryPath}`);
+  }
+}
+async function assertSkillSourceLayout(sourcePath) {
+  const resolvedSourcePath = resolve5(sourcePath);
+  const skillFilePath = join4(resolvedSourcePath, "SKILL.md");
+  await assertNoSymlinkAncestors(resolvedSourcePath, { includeLeaf: true });
+  await assertDirectory(resolvedSourcePath);
+  try {
+    await assertRegularFile(skillFilePath, "SKILL.md");
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      throw new Error(`Refusing to import ${resolvedSourcePath} without a root SKILL.md`);
+    }
+    throw error;
+  }
+}
+async function hasRootSkillFile(sourcePath) {
+  const resolvedSourcePath = resolve5(sourcePath);
+  const skillFilePath = join4(resolvedSourcePath, "SKILL.md");
+  try {
+    await assertDirectory(resolvedSourcePath);
+    await assertRegularFile(skillFilePath, "SKILL.md");
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+async function copySkillContentsToManagedStore(sourcePath, targetPath) {
+  const resolvedSourcePath = resolve5(sourcePath);
+  const resolvedTargetPath = resolve5(targetPath);
+  if (pathsAreEqual(resolvedSourcePath, resolvedTargetPath)) {
+    throw new Error("Source and target paths must differ");
+  }
+  if (isPathInside(resolvedSourcePath, resolvedTargetPath)) {
+    throw new Error("Refusing to copy into a child of the source directory");
+  }
+  await assertSkillSourceLayout(resolvedSourcePath);
+  await assertNoSymlinkAncestors(resolvedTargetPath);
+  await assertTargetDoesNotExist(resolvedTargetPath);
+  await copyDirectoryContents(resolvedSourcePath, resolvedTargetPath);
+}
+
+// src/core/batch-operation-error.ts
+function getCauseMessage(cause) {
+  if (cause instanceof Error) {
+    return cause.message;
+  }
+  return String(cause);
+}
+function buildBatchOperationMessage(options) {
+  const completedSuffix = options.completedItems.length > 0 ? ` after ${options.completedAction}: ${options.completedItems.join(", ")}` : "";
+  return `Failed to ${options.failedAction}${completedSuffix}: ${getCauseMessage(options.cause)}`;
+}
+var BatchOperationError = class extends Error {
+  operation;
+  failedItem;
+  completedItems;
+  cause;
+  constructor(options) {
+    super(buildBatchOperationMessage(options), { cause: options.cause });
+    this.name = "BatchOperationError";
+    this.operation = options.operation;
+    this.failedItem = options.failedItem;
+    this.completedItems = [...options.completedItems];
+    this.cause = options.cause;
+  }
+};
+
+// src/fs/link-ops.ts
+import * as fs7 from "fs/promises";
+import { dirname as dirname3, resolve as resolve6 } from "path";
+var directoryLinkType = process.platform === "win32" ? "junction" : "dir";
+async function createManagedLink(linkPath, targetPath) {
+  const resolvedLinkPath = resolve6(linkPath);
+  const resolvedTargetPath = resolve6(targetPath);
+  await assertNoSymlinkAncestors(resolvedLinkPath);
+  await assertNoSymlinkAncestors(resolvedTargetPath, { includeLeaf: true });
+  await fs7.mkdir(dirname3(resolvedLinkPath), { recursive: true });
+  try {
+    const existingEntry = await fs7.lstat(resolvedLinkPath);
+    if (!existingEntry.isSymbolicLink()) {
+      throw new Error(`Refusing to replace non-link entry at ${resolvedLinkPath}`);
+    }
+    const currentTargetPath = await fs7.realpath(resolvedLinkPath);
+    if (pathsAreEqual(currentTargetPath, resolvedTargetPath)) {
+      return;
+    }
+    throw new Error(`Refusing to replace link at ${resolvedLinkPath}`);
+  } catch (error) {
+    if (error.code === "ENOENT" && await fs7.lstat(resolvedLinkPath).then((entry) => entry.isSymbolicLink()).catch(() => false)) {
+      await fs7.rm(resolvedLinkPath, { recursive: true, force: false });
+    } else if (error.code !== "ENOENT") {
+      throw error;
+    }
+  }
+  await fs7.symlink(resolvedTargetPath, resolvedLinkPath, directoryLinkType);
+}
+async function replaceEntryWithManagedLink(linkPath, targetPath, expectedCurrentPath) {
+  const resolvedLinkPath = resolve6(linkPath);
+  const resolvedTargetPath = resolve6(targetPath);
+  const resolvedExpectedCurrentPath = resolve6(expectedCurrentPath);
+  await assertNoSymlinkAncestors(resolvedLinkPath);
+  await assertNoSymlinkAncestors(resolvedTargetPath, { includeLeaf: true });
+  await fs7.mkdir(dirname3(resolvedLinkPath), { recursive: true });
+  const existingEntry = await fs7.lstat(resolvedLinkPath);
+  if (existingEntry.isSymbolicLink()) {
+    const currentTargetPath = await fs7.realpath(resolvedLinkPath);
+    if (pathsAreEqual(currentTargetPath, resolvedTargetPath)) {
+      return false;
+    }
+    if (!pathsAreEqual(currentTargetPath, resolvedExpectedCurrentPath)) {
+      throw new Error(`Refusing to replace unexpected link at ${resolvedLinkPath}`);
+    }
+    await fs7.rm(resolvedLinkPath, { recursive: true, force: false });
+    await fs7.symlink(resolvedTargetPath, resolvedLinkPath, directoryLinkType);
+    return true;
+  }
+  if (!existingEntry.isDirectory()) {
+    throw new Error(`Refusing to replace non-directory entry at ${resolvedLinkPath}`);
+  }
+  const currentPath = await fs7.realpath(resolvedLinkPath);
+  if (!pathsAreEqual(currentPath, resolvedExpectedCurrentPath)) {
+    throw new Error(`Refusing to replace unexpected directory at ${resolvedLinkPath}`);
+  }
+  await fs7.rm(resolvedLinkPath, { recursive: true, force: false });
+  await fs7.symlink(resolvedTargetPath, resolvedLinkPath, directoryLinkType);
+  return true;
+}
+async function isLinkPointingToTarget(linkPath, targetPath) {
+  try {
+    const entry = await fs7.lstat(linkPath);
+    if (!entry.isSymbolicLink()) {
+      return false;
+    }
+    const resolvedTargetPath = await fs7.realpath(linkPath);
+    return pathsAreEqual(resolvedTargetPath, targetPath);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+
+// src/manifest/read-manifest.ts
+import * as fs9 from "fs/promises";
+import { join as join6, resolve as resolve7 } from "path";
+
+// src/manifest/build-empty-manifest.ts
+function buildEmptyManifest(skillmuxHome) {
+  return {
+    version: 1,
+    skillmuxHome,
+    skills: {},
+    agents: {},
+    activations: [],
+    lastScan: {
+      at: null,
+      issues: []
+    }
+  };
+}
+
+// src/manifest/manifest-schema.ts
+import { z as z2 } from "zod";
+var idSchema = z2.string().min(1).refine(isValidId, "Expected a canonical lowercase slug identifier");
+var scanIssueSchema = z2.object({
+  code: z2.string().min(1),
+  severity: z2.enum(["info", "warning", "error"]),
+  message: z2.string().min(1),
+  path: z2.string().min(1).optional()
+}).strict();
+var managedSkillSchema = z2.object({
+  id: idSchema,
+  name: z2.string().min(1),
+  path: z2.string().min(1),
+  source: z2.object({
+    kind: z2.enum(["local", "imported"]),
+    path: z2.string().min(1)
+  }).strict(),
+  importedAt: z2.string().min(1)
+}).strict();
+var agentRecordSchema = z2.object({
+  id: idSchema,
+  name: z2.string().min(1),
+  path: z2.string().min(1),
+  discovery: z2.enum(["builtin", "custom"]),
+  available: z2.boolean(),
+  lastSeenAt: z2.string().min(1).nullable()
+}).strict();
+var activationRecordSchema = z2.object({
+  skillId: idSchema,
+  agentId: idSchema,
+  linkPath: z2.string().min(1),
+  state: z2.enum(["enabled", "disabled"]),
+  updatedAt: z2.string().min(1)
+}).strict();
+var manifestSchema = z2.object({
+  version: z2.literal(1),
+  skillmuxHome: z2.string().min(1),
+  skills: z2.record(z2.string(), managedSkillSchema),
+  agents: z2.record(z2.string(), agentRecordSchema),
+  activations: z2.array(activationRecordSchema),
+  lastScan: z2.object({
+    at: z2.string().min(1).nullable(),
+    issues: z2.array(scanIssueSchema)
+  }).strict()
+}).strict().superRefine((manifest, ctx) => {
+  for (const [skillId, skill] of Object.entries(manifest.skills)) {
+    if (!isValidId(skillId)) {
+      ctx.addIssue({
+        code: z2.ZodIssueCode.custom,
+        path: ["skills", skillId],
+        message: `Invalid skill id key: ${skillId}`
+      });
+    }
+    if (skill.id !== skillId) {
+      ctx.addIssue({
+        code: z2.ZodIssueCode.custom,
+        path: ["skills", skillId, "id"],
+        message: `Skill id must match its record key: ${skillId}`
+      });
+    }
+  }
+  for (const [agentId, agent] of Object.entries(manifest.agents)) {
+    if (!isValidId(agentId)) {
+      ctx.addIssue({
+        code: z2.ZodIssueCode.custom,
+        path: ["agents", agentId],
+        message: `Invalid agent id key: ${agentId}`
+      });
+    }
+    if (agent.id !== agentId) {
+      ctx.addIssue({
+        code: z2.ZodIssueCode.custom,
+        path: ["agents", agentId, "id"],
+        message: `Agent id must match its record key: ${agentId}`
+      });
+    }
+  }
+  const activationPairs = /* @__PURE__ */ new Set();
+  manifest.activations.forEach((activation, index) => {
+    if (!(activation.skillId in manifest.skills)) {
+      ctx.addIssue({
+        code: z2.ZodIssueCode.custom,
+        path: ["activations", index, "skillId"],
+        message: `Unknown skill reference: ${activation.skillId}`
+      });
+    }
+    if (!(activation.agentId in manifest.agents)) {
+      ctx.addIssue({
+        code: z2.ZodIssueCode.custom,
+        path: ["activations", index, "agentId"],
+        message: `Unknown agent reference: ${activation.agentId}`
+      });
+    }
+    const pairKey = `${activation.skillId}:${activation.agentId}`;
+    if (activationPairs.has(pairKey)) {
+      ctx.addIssue({
+        code: z2.ZodIssueCode.custom,
+        path: ["activations", index],
+        message: `Duplicate activation for ${pairKey}`
+      });
+      return;
+    }
+    activationPairs.add(pairKey);
+  });
+});
+
+// src/manifest/write-manifest.ts
+import { randomUUID } from "crypto";
+import * as fs8 from "fs/promises";
+import { join as join5 } from "path";
+function getManifestPath(home) {
+  return join5(home, "manifest.json");
+}
+function createManifestTempPath(manifestPath) {
+  return `${manifestPath}.${process.pid}.${randomUUID()}.tmp`;
+}
+async function writeManifest(home, manifest) {
+  await fs8.mkdir(home, { recursive: true });
+  const manifestPath = getManifestPath(home);
+  const tempPath = createManifestTempPath(manifestPath);
+  const contents = `${JSON.stringify(manifest, null, 2)}
+`;
+  await fs8.writeFile(tempPath, contents, "utf8");
+  try {
+    await fs8.rename(tempPath, manifestPath);
+  } catch (error) {
+    await fs8.unlink(tempPath).catch(() => void 0);
+    throw error;
+  }
+}
+
+// src/manifest/read-manifest.ts
+function getManifestPath2(home) {
+  return join6(home, "manifest.json");
+}
+function normalizeHomePath(home) {
+  const resolvedHome = resolve7(home);
+  return process.platform === "win32" ? resolvedHome.toLowerCase() : resolvedHome;
+}
+function formatValidationIssues2(error) {
+  return error.issues.map((issue) => {
+    const path = issue.path.length > 0 ? issue.path.join(".") : "<root>";
+    return `${path}: ${issue.message}`;
+  }).join("; ");
+}
+async function readManifest(home) {
+  const manifestPath = getManifestPath2(home);
+  try {
+    const contents = await fs9.readFile(manifestPath, "utf8");
+    const parsedJson = JSON.parse(contents);
+    const parsedManifest = manifestSchema.safeParse(parsedJson);
+    if (!parsedManifest.success) {
+      throw new ManifestValidationError(
+        `Invalid manifest at ${manifestPath}: ${formatValidationIssues2(parsedManifest.error)}`
+      );
+    }
+    if (normalizeHomePath(parsedManifest.data.skillmuxHome) !== normalizeHomePath(home)) {
+      throw new ManifestValidationError(
+        `Invalid manifest at ${manifestPath}: skillmuxHome must match ${home}`
+      );
+    }
+    return parsedManifest.data;
+  } catch (error) {
+    if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+      const emptyManifest = buildEmptyManifest(home);
+      await writeManifest(home, emptyManifest);
+      return emptyManifest;
+    }
+    if (error instanceof SyntaxError) {
+      throw new ManifestValidationError(
+        `Invalid manifest at ${manifestPath}: malformed JSON`
+      );
+    }
+    throw error;
+  }
+}
+
+// src/output/print-json.ts
+function printJson(value) {
+  return `${JSON.stringify(value, null, 2)}
+`;
+}
+
+// src/commands/adopt.ts
+function buildManagedSkillPath(skillmuxHome, skillId) {
+  return resolve8(skillmuxHome, "skills", skillId);
+}
+function buildAgentRecord(agent, timestamp) {
+  return {
+    id: agent.id,
+    name: agent.stableName,
+    path: agent.absoluteSkillsDirectoryPath,
+    discovery: agent.discovery,
+    available: agent.exists && agent.supportedOnPlatform,
+    lastSeenAt: agent.exists ? timestamp : null
+  };
+}
+function buildActivationRecord(skillId, agentId, linkPath, timestamp) {
+  return {
+    skillId,
+    agentId,
+    linkPath,
+    state: "enabled",
+    updatedAt: timestamp
+  };
+}
+function upsertActivation(manifest, activation) {
+  const index = manifest.activations.findIndex(
+    (entry) => entry.skillId === activation.skillId && entry.agentId === activation.agentId
+  );
+  if (index === -1) {
+    manifest.activations.push(activation);
+    return;
+  }
+  manifest.activations[index] = activation;
+}
+async function resolveTargetAgent(homeDir, skillmuxHome, agentName) {
+  const agentId = normalizeId(agentName);
+  const agents = await discoverAgents({ homeDir, skillmuxHome });
+  const agent = agents.find((entry) => entry.id === agentId);
+  if (agent === void 0) {
+    throw new AdoptionError(`Unknown agent: ${agentName}`);
+  }
+  if (!agent.supportedOnPlatform) {
+    throw new AdoptionError(
+      `Agent ${agent.id} is not supported on ${process.platform}`
+    );
+  }
+  return agent;
+}
+function filterEntries(scannedAgent, skillFilter) {
+  if (skillFilter === void 0) {
+    return scannedAgent.entries;
+  }
+  const skillId = normalizeId(skillFilter);
+  return scannedAgent.entries.filter(
+    (entry) => normalizeId(entry.skillName) === skillId
+  );
+}
+async function resolveAdoptionSource(entry) {
+  if (entry.kind === "unmanaged-link") {
+    return entry.targetPath;
+  }
+  if (entry.kind === "unmanaged-directory") {
+    return entry.path;
+  }
+  return void 0;
+}
+function buildManagedSkill(skillId, skillName, managedPath, sourcePath, timestamp) {
+  return {
+    id: skillId,
+    name: skillName,
+    path: managedPath,
+    source: {
+      kind: "imported",
+      path: sourcePath
+    },
+    importedAt: timestamp
+  };
+}
+async function reconcileManagedLink(manifest, skillId, entry, agentId, timestamp) {
+  if (entry.targetPath === void 0) {
+    throw new AdoptionError(`Managed link target is missing for ${entry.path}`);
+  }
+  await assertSkillSourceLayout(entry.targetPath);
+  const skill = manifest.skills[skillId];
+  if (skill === void 0 || !pathsAreEqual(skill.path, entry.targetPath)) {
+    throw new AdoptionError(
+      `Managed link for ${agentId}/${skillId} has no matching manifest skill record`
+    );
+  }
+  upsertActivation(
+    manifest,
+    buildActivationRecord(skillId, agentId, entry.path, timestamp)
+  );
+}
+function buildOutput(result, json) {
+  if (json) {
+    return printJson({
+      agent: result.agent,
+      adopted: result.adopted,
+      skipped: result.skipped
+    });
+  }
+  if (result.adopted.length === 0) {
+    return `No skills adopted for ${result.agent.id}.
+`;
+  }
+  const adoptedSkills = result.adopted.map((entry) => entry.skillId).sort((left, right) => left.localeCompare(right)).join(", ");
+  return `Adopted ${adoptedSkills} for ${result.agent.id}
+`;
+}
+async function runAdoptSingle(options) {
+  const homeDir = options.homeDir ?? homedir();
+  const { skillmuxHome: defaultSkillmuxHome } = resolveSkillmuxHome(homeDir);
+  const skillmuxHome = options.skillmuxHome ?? defaultSkillmuxHome;
+  const timestamp = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
+  const manifest = await readManifest(skillmuxHome);
+  const agent = await resolveTargetAgent(homeDir, skillmuxHome, options.agent);
+  const agentRecord = buildAgentRecord(agent, timestamp);
+  const scannedAgent = await scanAgentSkills(agent, skillmuxHome);
+  const entries = filterEntries(scannedAgent, options.skill);
+  const adopted = [];
+  const skipped = [];
+  manifest.agents[agent.id] = agentRecord;
+  for (const entry of entries) {
+    const skillId = normalizeId(entry.skillName);
+    if (entry.kind === "managed-link") {
+      await reconcileManagedLink(
+        manifest,
+        skillId,
+        entry,
+        agent.id,
+        timestamp
+      );
+      skipped.push({
+        skillId,
+        agentId: agent.id,
+        path: entry.path,
+        reason: "already-managed"
+      });
+      await writeManifest(skillmuxHome, manifest);
+      continue;
+    }
+    const sourcePath = await resolveAdoptionSource(entry);
+    if (sourcePath === void 0) {
+      skipped.push({
+        skillId,
+        agentId: agent.id,
+        path: entry.path,
+        reason: "not-adoptable"
+      });
+      continue;
+    }
+    if (!await hasRootSkillFile(sourcePath)) {
+      skipped.push({
+        skillId,
+        agentId: agent.id,
+        path: entry.path,
+        reason: "missing-skill-file"
+      });
+      continue;
+    }
+    const managedPath = buildManagedSkillPath(skillmuxHome, skillId);
+    if (manifest.skills[skillId] === void 0) {
+      await copySkillContentsToManagedStore(sourcePath, managedPath);
+      manifest.skills[skillId] = buildManagedSkill(
+        skillId,
+        entry.skillName,
+        managedPath,
+        sourcePath,
+        timestamp
+      );
+    } else if (await isLinkPointingToTarget(entry.path, manifest.skills[skillId].path)) {
+      skipped.push({
+        skillId,
+        agentId: agent.id,
+        path: entry.path,
+        reason: "already-managed"
+      });
+      continue;
+    } else {
+      await assertSkillSourceLayout(manifest.skills[skillId].path);
+    }
+    await replaceEntryWithManagedLink(
+      entry.path,
+      manifest.skills[skillId].path,
+      sourcePath
+    );
+    const activation = buildActivationRecord(
+      skillId,
+      agent.id,
+      join7(agent.absoluteSkillsDirectoryPath, entry.skillName),
+      timestamp
+    );
+    upsertActivation(manifest, activation);
+    adopted.push({
+      skillId,
+      agentId: agent.id,
+      sourcePath,
+      managedPath: manifest.skills[skillId].path,
+      linkPath: activation.linkPath
+    });
+    await writeManifest(skillmuxHome, manifest);
+  }
+  await writeManifest(skillmuxHome, manifest);
+  const resultWithoutOutput = {
+    agent: agentRecord,
+    adopted,
+    skipped,
+    manifest
+  };
+  return {
+    ...resultWithoutOutput,
+    output: buildOutput(resultWithoutOutput, options.json === true)
+  };
+}
+async function runAdopt(options) {
+  if (options.skills !== void 0) {
+    const results = [];
+    const completedSkills = [];
+    for (const skill of options.skills) {
+      try {
+        results.push(await runAdoptSingle({ ...options, skill, skills: void 0 }));
+        completedSkills.push(skill);
+      } catch (error) {
+        throw new BatchOperationError({
+          operation: "adopt",
+          failedItem: skill,
+          failedAction: `adopt ${skill} for ${options.agent}`,
+          completedAction: "adopting",
+          completedItems: completedSkills,
+          cause: error
+        });
+      }
+    }
+    if (results.length === 0) {
+      throw new AdoptionError("Adopt requires at least one target skill");
+    }
+    const lastResult = results[results.length - 1];
+    const resultWithoutOutput = {
+      agent: lastResult.agent,
+      adopted: results.flatMap((result) => result.adopted),
+      skipped: results.flatMap((result) => result.skipped),
+      manifest: lastResult.manifest,
+      results
+    };
+    return {
+      ...resultWithoutOutput,
+      output: options.json === true ? printJson({
+        agent: resultWithoutOutput.agent,
+        adopted: resultWithoutOutput.adopted,
+        skipped: resultWithoutOutput.skipped,
+        results: resultWithoutOutput.results
+      }) : results.map((result) => result.output).join("")
+    };
+  }
+  return runAdoptSingle(options);
+}
+
+// src/commands/disable.ts
+import * as fs11 from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { join as join8, resolve as resolve9 } from "path";
+
+// src/fs/safe-remove-link.ts
+import * as fs10 from "fs/promises";
+async function safeRemoveLink(path) {
+  try {
+    const entry = await fs10.lstat(path);
+    if (!entry.isSymbolicLink()) {
+      return false;
+    }
+    await fs10.rm(path, { recursive: true, force: false });
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+
+// src/commands/disable.ts
+function buildAgentRecord2(agent, timestamp) {
+  return {
+    id: agent.id,
+    name: agent.stableName,
+    path: agent.absoluteSkillsDirectoryPath,
+    discovery: agent.discovery,
+    available: agent.exists && agent.supportedOnPlatform,
+    lastSeenAt: agent.exists ? timestamp : null
+  };
+}
+function buildActivationRecord2(skillId, agentId, linkPath, timestamp) {
+  return {
+    skillId,
+    agentId,
+    linkPath,
+    state: "disabled",
+    updatedAt: timestamp
+  };
+}
+function upsertActivation2(manifest, activation) {
+  const index = manifest.activations.findIndex(
+    (entry) => entry.skillId === activation.skillId && entry.agentId === activation.agentId
+  );
+  if (index === -1) {
+    manifest.activations.push(activation);
+    return;
+  }
+  manifest.activations[index] = activation;
+}
+function buildManagedSkillPath2(skillmuxHome, skillId) {
+  return resolve9(skillmuxHome, "skills", skillId);
+}
+async function tryAdoptManagedSkill(manifest, skillmuxHome, skillId, skillName, linkPath, timestamp) {
+  try {
+    const entry = await fs11.lstat(linkPath);
+    if (!entry.isSymbolicLink()) {
+      return void 0;
+    }
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return void 0;
+    }
+    throw error;
+  }
+  const sourcePath = await fs11.realpath(linkPath);
+  await assertSkillSourceLayout(sourcePath);
+  const managedSkillPath = buildManagedSkillPath2(skillmuxHome, skillId);
+  await copySkillContentsToManagedStore(sourcePath, managedSkillPath);
+  const skill = {
+    id: skillId,
+    name: skillName,
+    path: managedSkillPath,
+    source: {
+      kind: "imported",
+      path: sourcePath
+    },
+    importedAt: timestamp
+  };
+  manifest.skills[skillId] = skill;
+  return { skill, sourcePath };
+}
+async function resolveTargetAgent2(homeDir, skillmuxHome, agentName) {
+  const agentId = normalizeId(agentName);
+  const agents = await discoverAgents({ homeDir, skillmuxHome });
+  const agent = agents.find((entry) => entry.id === agentId);
+  if (agent === void 0) {
+    throw new Error(`Unknown agent: ${agentName}`);
+  }
+  if (!agent.supportedOnPlatform) {
+    throw new Error(`Agent ${agent.id} is not supported on ${process.platform}`);
+  }
+  return agent;
+}
+async function pathExists2(path) {
+  try {
+    await fs11.lstat(path);
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+async function runDisableSingle(options) {
+  if (options.agent === void 0) {
+    throw new Error("Disable requires one target agent");
+  }
+  const homeDir = options.homeDir ?? homedir2();
+  const { skillmuxHome: defaultSkillmuxHome } = resolveSkillmuxHome(homeDir);
+  const skillmuxHome = options.skillmuxHome ?? defaultSkillmuxHome;
+  const timestamp = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
+  const manifest = await readManifest(skillmuxHome);
+  const skillId = normalizeId(options.skill);
+  const agent = await resolveTargetAgent2(homeDir, skillmuxHome, options.agent);
+  const linkPath = join8(agent.absoluteSkillsDirectoryPath, skillId);
+  const adoption = manifest.skills[skillId] ? void 0 : await tryAdoptManagedSkill(
+    manifest,
+    skillmuxHome,
+    skillId,
+    options.skill,
+    linkPath,
+    timestamp
+  );
+  const skill = manifest.skills[skillId] ?? adoption?.skill;
+  if (skill === void 0) {
+    throw new Error(`Managed skill not found: ${skillId}`);
+  }
+  const currentActivation = manifest.activations.find(
+    (entry) => entry.skillId === skill.id && entry.agentId === agent.id
+  );
+  const activationLinkPath = currentActivation?.linkPath ?? linkPath;
+  const agentRecord = buildAgentRecord2(agent, timestamp);
+  manifest.agents[agent.id] = agentRecord;
+  const adoptedLinkRemoved = adoption !== void 0 ? await safeRemoveLink(linkPath) : false;
+  const linkMatchesSkill = adoption === void 0 ? await isLinkPointingToTarget(activationLinkPath, skill.path) : false;
+  if (adoption === void 0 && !linkMatchesSkill && await pathExists2(activationLinkPath)) {
+    throw new Error(`Refusing to disable non-managed entry at ${linkPath}`);
+  }
+  const removedLink = adoptedLinkRemoved ? true : linkMatchesSkill ? await safeRemoveLink(activationLinkPath) : false;
+  if (removedLink === false && currentActivation?.state !== "enabled") {
+    return {
+      changed: false,
+      skill,
+      agent: agentRecord,
+      activation: currentActivation ?? null,
+      manifest,
+      output: `${skill.id} is already disabled for ${agent.id}
+`
+    };
+  }
+  const activation = buildActivationRecord2(skill.id, agent.id, linkPath, timestamp);
+  upsertActivation2(manifest, activation);
+  await writeManifest(skillmuxHome, manifest);
+  return {
+    changed: true,
+    skill,
+    agent: agentRecord,
+    activation,
+    manifest,
+    output: `Disabled ${skill.id} for ${agent.id}
+`
+  };
+}
+async function runDisable(options) {
+  if (options.agents !== void 0) {
+    const results = [];
+    for (const agent of options.agents) {
+      try {
+        results.push(await runDisableSingle({ ...options, agent, agents: void 0 }));
+      } catch (error) {
+        throw new BatchOperationError({
+          operation: "disable",
+          failedItem: agent,
+          failedAction: `disable ${options.skill} for ${agent}`,
+          completedAction: "disabling",
+          completedItems: results.map((result) => result.agent.id),
+          cause: error
+        });
+      }
+    }
+    if (results.length === 0) {
+      throw new Error("Disable requires at least one target agent");
+    }
+    const lastResult = results[results.length - 1];
+    return {
+      changed: results.some((result) => result.changed),
+      skill: lastResult.skill,
+      results,
+      changedAgents: results.filter((result) => result.changed).map((result) => result.agent.id),
+      manifest: lastResult.manifest,
+      output: results.map((result) => result.output).join("")
+    };
+  }
+  return runDisableSingle(options);
+}
+
+// src/commands/enable.ts
+import * as fs12 from "fs/promises";
+import { homedir as homedir3 } from "os";
+import { join as join9 } from "path";
+function buildAgentRecord3(agent, timestamp) {
+  return {
+    id: agent.id,
+    name: agent.stableName,
+    path: agent.absoluteSkillsDirectoryPath,
+    discovery: agent.discovery,
+    available: agent.supportedOnPlatform,
+    lastSeenAt: timestamp
+  };
+}
+function buildActivationRecord3(skillId, agentId, linkPath, timestamp, state) {
+  return {
+    skillId,
+    agentId,
+    linkPath,
+    state,
+    updatedAt: timestamp
+  };
+}
+function upsertActivation3(manifest, activation) {
+  const index = manifest.activations.findIndex(
+    (entry) => entry.skillId === activation.skillId && entry.agentId === activation.agentId
+  );
+  if (index === -1) {
+    manifest.activations.push(activation);
+    return;
+  }
+  manifest.activations[index] = activation;
+}
+async function resolveTargetAgent3(homeDir, skillmuxHome, agentName) {
+  const agentId = normalizeId(agentName);
+  const agents = await discoverAgents({ homeDir, skillmuxHome });
+  const agent = agents.find((entry) => entry.id === agentId);
+  if (agent === void 0) {
+    throw new Error(`Unknown agent: ${agentName}`);
+  }
+  if (!agent.supportedOnPlatform) {
+    throw new Error(`Agent ${agent.id} is not supported on ${process.platform}`);
+  }
+  return agent;
+}
+async function runEnableSingle(options) {
+  if (options.agent === void 0) {
+    throw new Error("Enable requires one target agent");
+  }
+  const homeDir = options.homeDir ?? homedir3();
+  const { skillmuxHome: defaultSkillmuxHome } = resolveSkillmuxHome(homeDir);
+  const skillmuxHome = options.skillmuxHome ?? defaultSkillmuxHome;
+  const timestamp = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
+  const manifest = await readManifest(skillmuxHome);
+  const skillId = normalizeId(options.skill);
+  const skill = manifest.skills[skillId];
+  if (skill === void 0) {
+    throw new Error(`Managed skill not found: ${skillId}`);
+  }
+  const agent = await resolveTargetAgent3(homeDir, skillmuxHome, options.agent);
+  const linkPath = join9(agent.absoluteSkillsDirectoryPath, skill.id);
+  const currentActivation = manifest.activations.find(
+    (entry) => entry.skillId === skill.id && entry.agentId === agent.id
+  );
+  const agentRecord = buildAgentRecord3(agent, timestamp);
+  manifest.agents[agent.id] = agentRecord;
+  await fs12.mkdir(agent.absoluteSkillsDirectoryPath, { recursive: true });
+  const linkAlreadyEnabled = await isLinkPointingToTarget(linkPath, skill.path);
+  const activationAlreadyEnabled = currentActivation?.state === "enabled" && currentActivation.linkPath === linkPath;
+  if (linkAlreadyEnabled && activationAlreadyEnabled) {
+    return {
+      changed: false,
+      skill,
+      agent: agentRecord,
+      activation: currentActivation,
+      manifest,
+      output: `${skill.id} is already enabled for ${agent.id}
+`
+    };
+  }
+  await createManagedLink(linkPath, skill.path);
+  const activation = buildActivationRecord3(
+    skill.id,
+    agent.id,
+    linkPath,
+    timestamp,
+    "enabled"
+  );
+  upsertActivation3(manifest, activation);
+  await writeManifest(skillmuxHome, manifest);
+  return {
+    changed: true,
+    skill,
+    agent: agentRecord,
+    activation,
+    manifest,
+    output: `Enabled ${skill.id} for ${agent.id}
+`
+  };
+}
+async function runEnable(options) {
+  if (options.agents !== void 0) {
+    const results = [];
+    for (const agent of options.agents) {
+      try {
+        results.push(await runEnableSingle({ ...options, agent, agents: void 0 }));
+      } catch (error) {
+        throw new BatchOperationError({
+          operation: "enable",
+          failedItem: agent,
+          failedAction: `enable ${options.skill} for ${agent}`,
+          completedAction: "enabling",
+          completedItems: results.map((result) => result.agent.id),
+          cause: error
+        });
+      }
+    }
+    if (results.length === 0) {
+      throw new Error("Enable requires at least one target agent");
+    }
+    const lastResult = results[results.length - 1];
+    return {
+      changed: results.some((result) => result.changed),
+      skill: lastResult.skill,
+      results,
+      changedAgents: results.filter((result) => result.changed).map((result) => result.agent.id),
+      manifest: lastResult.manifest,
+      output: results.map((result) => result.output).join("")
+    };
+  }
+  return runEnableSingle(options);
+}
+
+// src/commands/scan.ts
+import { homedir as homedir4 } from "os";
+
+// src/output/format-issue.ts
+function formatIssue(issue) {
+  if (issue.path === void 0) {
+    return `[${issue.severity}] ${issue.code}: ${issue.message}`;
+  }
+  return `[${issue.severity}] ${issue.code} @ ${issue.path}: ${issue.message}`;
+}
+
+// src/output/print-table.ts
+function printTable(rows, columns) {
+  const renderedRows = rows.map(
+    (row) => columns.map((column) => String(row[column.key] ?? ""))
+  );
+  const widths = columns.map(
+    (column, index) => Math.max(
+      column.label.length,
+      ...renderedRows.map((row) => row[index]?.length ?? 0)
+    )
+  );
+  const header = columns.map((column, index) => column.label.padEnd(widths[index])).join("  ");
+  const separator = widths.map((width) => "-".repeat(width)).join("  ");
+  const body = renderedRows.map(
+    (row) => row.map((cell, index) => cell.padEnd(widths[index])).join("  ")
+  );
+  return `${[header, separator, ...body].join("\n")}
+`;
+}
+
+// src/commands/scan.ts
+function buildAgentRecord4(agent, timestamp, previousRecord) {
+  const lastSeenAt = agent.exists ? timestamp : previousRecord?.lastSeenAt ?? null;
+  return {
+    id: agent.id,
+    name: agent.stableName,
+    path: agent.absoluteSkillsDirectoryPath,
+    discovery: agent.discovery,
+    available: agent.exists && agent.supportedOnPlatform,
+    lastSeenAt
+  };
+}
+function buildScanOutput(result, json) {
+  if (json) {
+    return printJson({
+      lastScan: result.manifest.lastScan,
+      agents: result.agents.map((agent) => ({
+        id: agent.id,
+        name: agent.stableName,
+        path: agent.absoluteSkillsDirectoryPath,
+        exists: agent.exists,
+        supportedOnPlatform: agent.supportedOnPlatform
+      })),
+      entries: result.entries
+    });
+  }
+  if (result.entries.length === 0) {
+    return "No skill entries found.\n";
+  }
+  const table = printTable(
+    result.entries.map((entry) => ({
+      agent: entry.agentId,
+      skill: entry.skillName,
+      kind: entry.kind,
+      path: entry.path
+    })),
+    [
+      { key: "agent", label: "Agent" },
+      { key: "skill", label: "Skill" },
+      { key: "kind", label: "Kind" },
+      { key: "path", label: "Path" }
+    ]
+  );
+  if (result.issues.length === 0) {
+    return table;
+  }
+  return `${table}
+${result.issues.map(formatIssue).join("\n")}
+`;
+}
+async function runScan(options = {}) {
+  const homeDir = options.homeDir ?? homedir4();
+  const resolvedPaths = resolveSkillmuxHome(homeDir);
+  const skillmuxHome = options.skillmuxHome ?? resolvedPaths.skillmuxHome;
+  const manifest = await readManifest(skillmuxHome);
+  const agents = await discoverAgents({
+    homeDir,
+    platform: options.platform,
+    skillmuxHome
+  });
+  const timestamp = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
+  const entries = [];
+  const issues = [];
+  for (const agent of agents) {
+    const scannedAgent = await scanAgentSkills(agent, skillmuxHome);
+    entries.push(...scannedAgent.entries);
+    issues.push(...scannedAgent.issues);
+    manifest.agents[agent.id] = buildAgentRecord4(
+      agent,
+      timestamp,
+      manifest.agents[agent.id]
+    );
+  }
+  manifest.lastScan = {
+    at: timestamp,
+    issues
+  };
+  await writeManifest(skillmuxHome, manifest);
+  const resultWithoutOutput = {
+    manifest,
+    agents,
+    entries,
+    issues
+  };
+  return {
+    ...resultWithoutOutput,
+    output: buildScanOutput(resultWithoutOutput, options.json === true)
+  };
+}
+
+// src/commands/remove.ts
+import * as fs13 from "fs/promises";
+import { homedir as homedir5 } from "os";
+import { resolve as resolve10 } from "path";
+function buildManagedSkillPath3(skillmuxHome, skillId) {
+  return resolve10(skillmuxHome, "skills", skillId);
+}
+function buildManifestPath(skillmuxHome) {
+  return resolve10(skillmuxHome, "manifest.json");
+}
+function buildConfigPath2(skillmuxHome) {
+  return resolve10(skillmuxHome, "config.json");
+}
+function resolveManagedSkill(manifest, skillNameOrId) {
+  const skillId = normalizeId(skillNameOrId);
+  const directMatch = manifest.skills[skillId];
+  if (directMatch !== void 0) {
+    return directMatch;
+  }
+  const nameMatches = Object.values(manifest.skills).filter(
+    (skill) => normalizeId(skill.name) === skillId
+  );
+  if (nameMatches.length === 1) {
+    return nameMatches[0];
+  }
+  if (nameMatches.length > 1) {
+    const candidateIds = nameMatches.map((skill) => skill.id).sort((left, right) => left.localeCompare(right));
+    throw new Error(
+      `Ambiguous managed skill name ${skillNameOrId}: ${candidateIds.join(", ")}`
+    );
+  }
+  throw new Error(`Managed skill not found: ${skillId}`);
+}
+function buildHumanOutput(skill, managedSkillPath) {
+  return `Removed ${skill.id} from ${managedSkillPath}
+`;
+}
+function buildJsonOutput(result) {
+  return printJson({
+    changed: result.changed,
+    removedSkillId: result.removedSkillId,
+    skill: result.skill,
+    location: result.location,
+    manifest: result.manifest
+  });
+}
+async function pathExists3(path) {
+  try {
+    await fs13.lstat(path);
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+async function assertManagedSkillRemovalSafety(skillmuxHome, skillPath, skillId) {
+  const expectedSkillPath = buildManagedSkillPath3(skillmuxHome, skillId);
+  if (!pathsAreEqual(skillPath, expectedSkillPath)) {
+    throw new Error(`Refusing to remove unmanaged skill path at ${skillPath}`);
+  }
+  await assertNoSymlinkAncestors(skillPath, { includeLeaf: true });
+  if (!await pathExists3(skillPath)) {
+    return;
+  }
+  const entry = await fs13.lstat(skillPath);
+  if (entry.isSymbolicLink()) {
+    throw new Error(`Refusing to remove symlinked managed skill path at ${skillPath}`);
+  }
+  if (!entry.isDirectory()) {
+    throw new Error(`Refusing to remove non-directory managed skill path at ${skillPath}`);
+  }
+}
+async function runRemoveSingle(options) {
+  if (options.skill === void 0) {
+    throw new Error("Remove requires one target skill");
+  }
+  const homeDir = options.homeDir ?? homedir5();
+  const { skillmuxHome: defaultSkillmuxHome } = resolveSkillmuxHome(homeDir);
+  const skillmuxHome = options.skillmuxHome ?? defaultSkillmuxHome;
+  const manifestPath = buildManifestPath(skillmuxHome);
+  const configPath = buildConfigPath2(skillmuxHome);
+  const manifest = await readManifest(skillmuxHome);
+  const skill = resolveManagedSkill(manifest, options.skill);
+  const managedSkillsDirectory = resolve10(skillmuxHome, "skills");
+  const managedSkillPath = skill.path;
+  const enabledActivations = manifest.activations.filter(
+    (activation) => activation.skillId === skill.id && activation.state === "enabled"
+  );
+  if (enabledActivations.length > 0) {
+    const enabledAgents = [...new Set(enabledActivations.map((activation) => activation.agentId))].sort(
+      (left, right) => left.localeCompare(right)
+    );
+    throw new Error(
+      `Cannot remove ${skill.id}; it is still enabled for: ${enabledAgents.join(", ")}`
+    );
+  }
+  await assertManagedSkillRemovalSafety(skillmuxHome, managedSkillPath, skill.id);
+  if (await pathExists3(managedSkillPath)) {
+    await fs13.rm(managedSkillPath, { recursive: true, force: false });
+  }
+  delete manifest.skills[skill.id];
+  manifest.activations = manifest.activations.filter(
+    (activation) => activation.skillId !== skill.id
+  );
+  await writeManifest(skillmuxHome, manifest);
+  const resultWithoutOutput = {
+    changed: true,
+    removedSkillId: skill.id,
+    skill,
+    location: {
+      skillmuxHome,
+      configPath,
+      manifestPath,
+      managedSkillsDirectory,
+      managedSkillPath
+    },
+    manifest
+  };
+  return {
+    ...resultWithoutOutput,
+    output: options.json === true ? buildJsonOutput(resultWithoutOutput) : buildHumanOutput(skill, managedSkillPath)
+  };
+}
+async function runRemove(options) {
+  if (options.skills !== void 0) {
+    const results = [];
+    for (const skill of options.skills) {
+      try {
+        results.push(await runRemoveSingle({ ...options, skill, skills: void 0 }));
+      } catch (error) {
+        throw new BatchOperationError({
+          operation: "remove",
+          failedItem: skill,
+          failedAction: `remove ${skill}`,
+          completedAction: "removing",
+          completedItems: results.map((result) => result.removedSkillId),
+          cause: error
+        });
+      }
+    }
+    if (results.length === 0) {
+      throw new Error("Remove requires at least one target skill");
+    }
+    const lastResult = results[results.length - 1];
+    const resultWithoutOutput = {
+      changed: results.some((result) => result.changed),
+      removedSkillIds: results.map((result) => result.removedSkillId),
+      results,
+      manifest: lastResult.manifest
+    };
+    return {
+      ...resultWithoutOutput,
+      output: options.json === true ? printJson(resultWithoutOutput) : results.map((result) => result.output).join("")
+    };
+  }
+  return runRemoveSingle(options);
+}
+
+// src/diagnostics/collect-doctor-issues.ts
+import * as fs14 from "fs/promises";
+import { join as join10 } from "path";
+function buildIssue2(code, severity, message, path) {
+  return path === void 0 ? { code, severity, message } : { code, severity, message, path };
+}
+async function pathExists4(path) {
+  try {
+    await fs14.access(path);
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+async function addUnmanagedDirectoryIssues(entries, issues) {
+  for (const entry of entries) {
+    if (entry.kind !== "unmanaged-directory") {
+      continue;
+    }
+    if (await pathExists4(join10(entry.path, "SKILL.md"))) {
+      issues.push(
+        buildIssue2(
+          "unmanaged-skill-directory",
+          "warning",
+          `Unmanaged skill directory is present for ${entry.agentId}/${entry.skillName}`,
+          entry.path
+        )
+      );
+    }
+  }
+}
+async function addMissingManagedSkillIssues(manifest, issues) {
+  for (const skill of Object.values(manifest.skills)) {
+    if (await pathExists4(skill.path)) {
+      continue;
+    }
+    issues.push(
+      buildIssue2(
+        "missing-managed-skill-path",
+        "error",
+        `Managed skill path is missing for ${skill.id}`,
+        skill.path
+      )
+    );
+  }
+}
+function addConflictingAgentPathIssues(agents, issues) {
+  const pathToAgents = /* @__PURE__ */ new Map();
+  for (const agent of agents) {
+    const key = normalizeAbsolutePath(agent.absoluteSkillsDirectoryPath);
+    const current = pathToAgents.get(key) ?? [];
+    current.push(agent);
+    pathToAgents.set(key, current);
+  }
+  for (const conflictedAgents of pathToAgents.values()) {
+    if (conflictedAgents.length < 2) {
+      continue;
+    }
+    const agentIds = conflictedAgents.map((agent) => agent.id).sort((left, right) => left.localeCompare(right));
+    issues.push(
+      buildIssue2(
+        "conflicting-agent-path",
+        "warning",
+        `Multiple agents resolve to the same skills directory: ${agentIds.join(", ")}`,
+        conflictedAgents[0].absoluteSkillsDirectoryPath
+      )
+    );
+  }
+}
+function issueSortKey(issue) {
+  return `${issue.severity}:${issue.code}:${issue.path ?? ""}:${issue.message}`;
+}
+function sortIssues(issues) {
+  return [...issues].sort(
+    (left, right) => issueSortKey(left).localeCompare(issueSortKey(right))
+  );
+}
+function dedupeAndSortIssues(issues) {
+  const issueByKey = /* @__PURE__ */ new Map();
+  for (const issue of issues) {
+    issueByKey.set(issueSortKey(issue), issue);
+  }
+  return sortIssues([...issueByKey.values()]);
+}
+async function collectDoctorIssues(input) {
+  const issues = [];
+  await addUnmanagedDirectoryIssues(input.entries, issues);
+  await addMissingManagedSkillIssues(input.manifest, issues);
+  addConflictingAgentPathIssues(input.agents, issues);
+  return dedupeAndSortIssues(issues);
+}
+
+export {
+  supportedPlatforms,
+  InvalidIdentifierError,
+  ManifestValidationError,
+  UserConfigValidationError,
+  normalizeId,
+  buildConfigPath,
+  resolveSkillmuxHome,
+  loadUserConfig,
+  discoverAgents,
+  isPathInside,
+  scanAgentSkills,
+  assertSkillSourceLayout,
+  copySkillContentsToManagedStore,
+  buildEmptyManifest,
+  manifestSchema,
+  writeManifest,
+  formatValidationIssues2 as formatValidationIssues,
+  readManifest,
+  printJson,
+  runAdopt,
+  printTable,
+  dedupeAndSortIssues,
+  collectDoctorIssues,
+  runDisable,
+  runEnable,
+  runScan,
+  runRemove
+};
+//# sourceMappingURL=chunk-DBEVDI27.js.map