@light-merlin-dark/skill-sync 0.1.1

package/dist/index.js

@@ -0,0 +1,1713 @@
+#!/usr/bin/env node
+
+// node_modules/cac/dist/index.mjs
+import { EventEmitter } from "events";
+function toArr(any) {
+  return any == null ? [] : Array.isArray(any) ? any : [any];
+}
+function toVal(out, key, val, opts) {
+  var x, old = out[key], nxt = ~opts.string.indexOf(key) ? val == null || val === true ? "" : String(val) : typeof val === "boolean" ? val : ~opts.boolean.indexOf(key) ? val === "false" ? false : val === "true" || (out._.push((x = +val, x * 0 === 0) ? x : val), !!val) : (x = +val, x * 0 === 0) ? x : val;
+  out[key] = old == null ? nxt : Array.isArray(old) ? old.concat(nxt) : [old, nxt];
+}
+function mri2(args, opts) {
+  args = args || [];
+  opts = opts || {};
+  var k, arr, arg, name, val, out = { _: [] };
+  var i = 0, j = 0, idx = 0, len = args.length;
+  const alibi = opts.alias !== undefined;
+  const strict = opts.unknown !== undefined;
+  const defaults = opts.default !== undefined;
+  opts.alias = opts.alias || {};
+  opts.string = toArr(opts.string);
+  opts.boolean = toArr(opts.boolean);
+  if (alibi) {
+    for (k in opts.alias) {
+      arr = opts.alias[k] = toArr(opts.alias[k]);
+      for (i = 0;i < arr.length; i++) {
+        (opts.alias[arr[i]] = arr.concat(k)).splice(i, 1);
+      }
+    }
+  }
+  for (i = opts.boolean.length;i-- > 0; ) {
+    arr = opts.alias[opts.boolean[i]] || [];
+    for (j = arr.length;j-- > 0; )
+      opts.boolean.push(arr[j]);
+  }
+  for (i = opts.string.length;i-- > 0; ) {
+    arr = opts.alias[opts.string[i]] || [];
+    for (j = arr.length;j-- > 0; )
+      opts.string.push(arr[j]);
+  }
+  if (defaults) {
+    for (k in opts.default) {
+      name = typeof opts.default[k];
+      arr = opts.alias[k] = opts.alias[k] || [];
+      if (opts[name] !== undefined) {
+        opts[name].push(k);
+        for (i = 0;i < arr.length; i++) {
+          opts[name].push(arr[i]);
+        }
+      }
+    }
+  }
+  const keys = strict ? Object.keys(opts.alias) : [];
+  for (i = 0;i < len; i++) {
+    arg = args[i];
+    if (arg === "--") {
+      out._ = out._.concat(args.slice(++i));
+      break;
+    }
+    for (j = 0;j < arg.length; j++) {
+      if (arg.charCodeAt(j) !== 45)
+        break;
+    }
+    if (j === 0) {
+      out._.push(arg);
+    } else if (arg.substring(j, j + 3) === "no-") {
+      name = arg.substring(j + 3);
+      if (strict && !~keys.indexOf(name)) {
+        return opts.unknown(arg);
+      }
+      out[name] = false;
+    } else {
+      for (idx = j + 1;idx < arg.length; idx++) {
+        if (arg.charCodeAt(idx) === 61)
+          break;
+      }
+      name = arg.substring(j, idx);
+      val = arg.substring(++idx) || (i + 1 === len || ("" + args[i + 1]).charCodeAt(0) === 45 || args[++i]);
+      arr = j === 2 ? [name] : name;
+      for (idx = 0;idx < arr.length; idx++) {
+        name = arr[idx];
+        if (strict && !~keys.indexOf(name))
+          return opts.unknown("-".repeat(j) + name);
+        toVal(out, name, idx + 1 < arr.length || val, opts);
+      }
+    }
+  }
+  if (defaults) {
+    for (k in opts.default) {
+      if (out[k] === undefined) {
+        out[k] = opts.default[k];
+      }
+    }
+  }
+  if (alibi) {
+    for (k in out) {
+      arr = opts.alias[k] || [];
+      while (arr.length > 0) {
+        out[arr.shift()] = out[k];
+      }
+    }
+  }
+  return out;
+}
+var removeBrackets = (v) => v.replace(/[<[].+/, "").trim();
+var findAllBrackets = (v) => {
+  const ANGLED_BRACKET_RE_GLOBAL = /<([^>]+)>/g;
+  const SQUARE_BRACKET_RE_GLOBAL = /\[([^\]]+)\]/g;
+  const res = [];
+  const parse = (match) => {
+    let variadic = false;
+    let value = match[1];
+    if (value.startsWith("...")) {
+      value = value.slice(3);
+      variadic = true;
+    }
+    return {
+      required: match[0].startsWith("<"),
+      value,
+      variadic
+    };
+  };
+  let angledMatch;
+  while (angledMatch = ANGLED_BRACKET_RE_GLOBAL.exec(v)) {
+    res.push(parse(angledMatch));
+  }
+  let squareMatch;
+  while (squareMatch = SQUARE_BRACKET_RE_GLOBAL.exec(v)) {
+    res.push(parse(squareMatch));
+  }
+  return res;
+};
+var getMriOptions = (options) => {
+  const result = { alias: {}, boolean: [] };
+  for (const [index, option] of options.entries()) {
+    if (option.names.length > 1) {
+      result.alias[option.names[0]] = option.names.slice(1);
+    }
+    if (option.isBoolean) {
+      if (option.negated) {
+        const hasStringTypeOption = options.some((o, i) => {
+          return i !== index && o.names.some((name) => option.names.includes(name)) && typeof o.required === "boolean";
+        });
+        if (!hasStringTypeOption) {
+          result.boolean.push(option.names[0]);
+        }
+      } else {
+        result.boolean.push(option.names[0]);
+      }
+    }
+  }
+  return result;
+};
+var findLongest = (arr) => {
+  return arr.sort((a, b) => {
+    return a.length > b.length ? -1 : 1;
+  })[0];
+};
+var padRight = (str, length) => {
+  return str.length >= length ? str : `${str}${" ".repeat(length - str.length)}`;
+};
+var camelcase = (input) => {
+  return input.replace(/([a-z])-([a-z])/g, (_, p1, p2) => {
+    return p1 + p2.toUpperCase();
+  });
+};
+var setDotProp = (obj, keys, val) => {
+  let i = 0;
+  let length = keys.length;
+  let t = obj;
+  let x;
+  for (;i < length; ++i) {
+    x = t[keys[i]];
+    t = t[keys[i]] = i === length - 1 ? val : x != null ? x : !!~keys[i + 1].indexOf(".") || !(+keys[i + 1] > -1) ? {} : [];
+  }
+};
+var setByType = (obj, transforms) => {
+  for (const key of Object.keys(transforms)) {
+    const transform = transforms[key];
+    if (transform.shouldTransform) {
+      obj[key] = Array.prototype.concat.call([], obj[key]);
+      if (typeof transform.transformFunction === "function") {
+        obj[key] = obj[key].map(transform.transformFunction);
+      }
+    }
+  }
+};
+var getFileName = (input) => {
+  const m = /([^\\\/]+)$/.exec(input);
+  return m ? m[1] : "";
+};
+var camelcaseOptionName = (name) => {
+  return name.split(".").map((v, i) => {
+    return i === 0 ? camelcase(v) : v;
+  }).join(".");
+};
+
+class CACError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = this.constructor.name;
+    if (typeof Error.captureStackTrace === "function") {
+      Error.captureStackTrace(this, this.constructor);
+    } else {
+      this.stack = new Error(message).stack;
+    }
+  }
+}
+
+class Option {
+  constructor(rawName, description, config) {
+    this.rawName = rawName;
+    this.description = description;
+    this.config = Object.assign({}, config);
+    rawName = rawName.replace(/\.\*/g, "");
+    this.negated = false;
+    this.names = removeBrackets(rawName).split(",").map((v) => {
+      let name = v.trim().replace(/^-{1,2}/, "");
+      if (name.startsWith("no-")) {
+        this.negated = true;
+        name = name.replace(/^no-/, "");
+      }
+      return camelcaseOptionName(name);
+    }).sort((a, b) => a.length > b.length ? 1 : -1);
+    this.name = this.names[this.names.length - 1];
+    if (this.negated && this.config.default == null) {
+      this.config.default = true;
+    }
+    if (rawName.includes("<")) {
+      this.required = true;
+    } else if (rawName.includes("[")) {
+      this.required = false;
+    } else {
+      this.isBoolean = true;
+    }
+  }
+}
+var processArgs = process.argv;
+var platformInfo = `${process.platform}-${process.arch} node-${process.version}`;
+
+class Command {
+  constructor(rawName, description, config = {}, cli) {
+    this.rawName = rawName;
+    this.description = description;
+    this.config = config;
+    this.cli = cli;
+    this.options = [];
+    this.aliasNames = [];
+    this.name = removeBrackets(rawName);
+    this.args = findAllBrackets(rawName);
+    this.examples = [];
+  }
+  usage(text) {
+    this.usageText = text;
+    return this;
+  }
+  allowUnknownOptions() {
+    this.config.allowUnknownOptions = true;
+    return this;
+  }
+  ignoreOptionDefaultValue() {
+    this.config.ignoreOptionDefaultValue = true;
+    return this;
+  }
+  version(version, customFlags = "-v, --version") {
+    this.versionNumber = version;
+    this.option(customFlags, "Display version number");
+    return this;
+  }
+  example(example) {
+    this.examples.push(example);
+    return this;
+  }
+  option(rawName, description, config) {
+    const option = new Option(rawName, description, config);
+    this.options.push(option);
+    return this;
+  }
+  alias(name) {
+    this.aliasNames.push(name);
+    return this;
+  }
+  action(callback) {
+    this.commandAction = callback;
+    return this;
+  }
+  isMatched(name) {
+    return this.name === name || this.aliasNames.includes(name);
+  }
+  get isDefaultCommand() {
+    return this.name === "" || this.aliasNames.includes("!");
+  }
+  get isGlobalCommand() {
+    return this instanceof GlobalCommand;
+  }
+  hasOption(name) {
+    name = name.split(".")[0];
+    return this.options.find((option) => {
+      return option.names.includes(name);
+    });
+  }
+  outputHelp() {
+    const { name, commands } = this.cli;
+    const {
+      versionNumber,
+      options: globalOptions,
+      helpCallback
+    } = this.cli.globalCommand;
+    let sections = [
+      {
+        body: `${name}${versionNumber ? `/${versionNumber}` : ""}`
+      }
+    ];
+    sections.push({
+      title: "Usage",
+      body: `  $ ${name} ${this.usageText || this.rawName}`
+    });
+    const showCommands = (this.isGlobalCommand || this.isDefaultCommand) && commands.length > 0;
+    if (showCommands) {
+      const longestCommandName = findLongest(commands.map((command) => command.rawName));
+      sections.push({
+        title: "Commands",
+        body: commands.map((command) => {
+          return `  ${padRight(command.rawName, longestCommandName.length)}  ${command.description}`;
+        }).join(`
+`)
+      });
+      sections.push({
+        title: `For more info, run any command with the \`--help\` flag`,
+        body: commands.map((command) => `  $ ${name}${command.name === "" ? "" : ` ${command.name}`} --help`).join(`
+`)
+      });
+    }
+    let options = this.isGlobalCommand ? globalOptions : [...this.options, ...globalOptions || []];
+    if (!this.isGlobalCommand && !this.isDefaultCommand) {
+      options = options.filter((option) => option.name !== "version");
+    }
+    if (options.length > 0) {
+      const longestOptionName = findLongest(options.map((option) => option.rawName));
+      sections.push({
+        title: "Options",
+        body: options.map((option) => {
+          return `  ${padRight(option.rawName, longestOptionName.length)}  ${option.description} ${option.config.default === undefined ? "" : `(default: ${option.config.default})`}`;
+        }).join(`
+`)
+      });
+    }
+    if (this.examples.length > 0) {
+      sections.push({
+        title: "Examples",
+        body: this.examples.map((example) => {
+          if (typeof example === "function") {
+            return example(name);
+          }
+          return example;
+        }).join(`
+`)
+      });
+    }
+    if (helpCallback) {
+      sections = helpCallback(sections) || sections;
+    }
+    console.log(sections.map((section) => {
+      return section.title ? `${section.title}:
+${section.body}` : section.body;
+    }).join(`
+
+`));
+  }
+  outputVersion() {
+    const { name } = this.cli;
+    const { versionNumber } = this.cli.globalCommand;
+    if (versionNumber) {
+      console.log(`${name}/${versionNumber} ${platformInfo}`);
+    }
+  }
+  checkRequiredArgs() {
+    const minimalArgsCount = this.args.filter((arg) => arg.required).length;
+    if (this.cli.args.length < minimalArgsCount) {
+      throw new CACError(`missing required args for command \`${this.rawName}\``);
+    }
+  }
+  checkUnknownOptions() {
+    const { options, globalCommand } = this.cli;
+    if (!this.config.allowUnknownOptions) {
+      for (const name of Object.keys(options)) {
+        if (name !== "--" && !this.hasOption(name) && !globalCommand.hasOption(name)) {
+          throw new CACError(`Unknown option \`${name.length > 1 ? `--${name}` : `-${name}`}\``);
+        }
+      }
+    }
+  }
+  checkOptionValue() {
+    const { options: parsedOptions, globalCommand } = this.cli;
+    const options = [...globalCommand.options, ...this.options];
+    for (const option of options) {
+      const value = parsedOptions[option.name.split(".")[0]];
+      if (option.required) {
+        const hasNegated = options.some((o) => o.negated && o.names.includes(option.name));
+        if (value === true || value === false && !hasNegated) {
+          throw new CACError(`option \`${option.rawName}\` value is missing`);
+        }
+      }
+    }
+  }
+}
+
+class GlobalCommand extends Command {
+  constructor(cli) {
+    super("@@global@@", "", {}, cli);
+  }
+}
+var __assign = Object.assign;
+
+class CAC extends EventEmitter {
+  constructor(name = "") {
+    super();
+    this.name = name;
+    this.commands = [];
+    this.rawArgs = [];
+    this.args = [];
+    this.options = {};
+    this.globalCommand = new GlobalCommand(this);
+    this.globalCommand.usage("<command> [options]");
+  }
+  usage(text) {
+    this.globalCommand.usage(text);
+    return this;
+  }
+  command(rawName, description, config) {
+    const command = new Command(rawName, description || "", config, this);
+    command.globalCommand = this.globalCommand;
+    this.commands.push(command);
+    return command;
+  }
+  option(rawName, description, config) {
+    this.globalCommand.option(rawName, description, config);
+    return this;
+  }
+  help(callback) {
+    this.globalCommand.option("-h, --help", "Display this message");
+    this.globalCommand.helpCallback = callback;
+    this.showHelpOnExit = true;
+    return this;
+  }
+  version(version, customFlags = "-v, --version") {
+    this.globalCommand.version(version, customFlags);
+    this.showVersionOnExit = true;
+    return this;
+  }
+  example(example) {
+    this.globalCommand.example(example);
+    return this;
+  }
+  outputHelp() {
+    if (this.matchedCommand) {
+      this.matchedCommand.outputHelp();
+    } else {
+      this.globalCommand.outputHelp();
+    }
+  }
+  outputVersion() {
+    this.globalCommand.outputVersion();
+  }
+  setParsedInfo({ args, options }, matchedCommand, matchedCommandName) {
+    this.args = args;
+    this.options = options;
+    if (matchedCommand) {
+      this.matchedCommand = matchedCommand;
+    }
+    if (matchedCommandName) {
+      this.matchedCommandName = matchedCommandName;
+    }
+    return this;
+  }
+  unsetMatchedCommand() {
+    this.matchedCommand = undefined;
+    this.matchedCommandName = undefined;
+  }
+  parse(argv = processArgs, {
+    run = true
+  } = {}) {
+    this.rawArgs = argv;
+    if (!this.name) {
+      this.name = argv[1] ? getFileName(argv[1]) : "cli";
+    }
+    let shouldParse = true;
+    for (const command of this.commands) {
+      const parsed = this.mri(argv.slice(2), command);
+      const commandName = parsed.args[0];
+      if (command.isMatched(commandName)) {
+        shouldParse = false;
+        const parsedInfo = __assign(__assign({}, parsed), {
+          args: parsed.args.slice(1)
+        });
+        this.setParsedInfo(parsedInfo, command, commandName);
+        this.emit(`command:${commandName}`, command);
+      }
+    }
+    if (shouldParse) {
+      for (const command of this.commands) {
+        if (command.name === "") {
+          shouldParse = false;
+          const parsed = this.mri(argv.slice(2), command);
+          this.setParsedInfo(parsed, command);
+          this.emit(`command:!`, command);
+        }
+      }
+    }
+    if (shouldParse) {
+      const parsed = this.mri(argv.slice(2));
+      this.setParsedInfo(parsed);
+    }
+    if (this.options.help && this.showHelpOnExit) {
+      this.outputHelp();
+      run = false;
+      this.unsetMatchedCommand();
+    }
+    if (this.options.version && this.showVersionOnExit && this.matchedCommandName == null) {
+      this.outputVersion();
+      run = false;
+      this.unsetMatchedCommand();
+    }
+    const parsedArgv = { args: this.args, options: this.options };
+    if (run) {
+      this.runMatchedCommand();
+    }
+    if (!this.matchedCommand && this.args[0]) {
+      this.emit("command:*");
+    }
+    return parsedArgv;
+  }
+  mri(argv, command) {
+    const cliOptions = [
+      ...this.globalCommand.options,
+      ...command ? command.options : []
+    ];
+    const mriOptions = getMriOptions(cliOptions);
+    let argsAfterDoubleDashes = [];
+    const doubleDashesIndex = argv.indexOf("--");
+    if (doubleDashesIndex > -1) {
+      argsAfterDoubleDashes = argv.slice(doubleDashesIndex + 1);
+      argv = argv.slice(0, doubleDashesIndex);
+    }
+    let parsed = mri2(argv, mriOptions);
+    parsed = Object.keys(parsed).reduce((res, name) => {
+      return __assign(__assign({}, res), {
+        [camelcaseOptionName(name)]: parsed[name]
+      });
+    }, { _: [] });
+    const args = parsed._;
+    const options = {
+      "--": argsAfterDoubleDashes
+    };
+    const ignoreDefault = command && command.config.ignoreOptionDefaultValue ? command.config.ignoreOptionDefaultValue : this.globalCommand.config.ignoreOptionDefaultValue;
+    let transforms = Object.create(null);
+    for (const cliOption of cliOptions) {
+      if (!ignoreDefault && cliOption.config.default !== undefined) {
+        for (const name of cliOption.names) {
+          options[name] = cliOption.config.default;
+        }
+      }
+      if (Array.isArray(cliOption.config.type)) {
+        if (transforms[cliOption.name] === undefined) {
+          transforms[cliOption.name] = Object.create(null);
+          transforms[cliOption.name]["shouldTransform"] = true;
+          transforms[cliOption.name]["transformFunction"] = cliOption.config.type[0];
+        }
+      }
+    }
+    for (const key of Object.keys(parsed)) {
+      if (key !== "_") {
+        const keys = key.split(".");
+        setDotProp(options, keys, parsed[key]);
+        setByType(options, transforms);
+      }
+    }
+    return {
+      args,
+      options
+    };
+  }
+  runMatchedCommand() {
+    const { args, options, matchedCommand: command } = this;
+    if (!command || !command.commandAction)
+      return;
+    command.checkUnknownOptions();
+    command.checkOptionValue();
+    command.checkRequiredArgs();
+    const actionArgs = [];
+    command.args.forEach((arg, index) => {
+      if (arg.variadic) {
+        actionArgs.push(args.slice(index));
+      } else {
+        actionArgs.push(args[index]);
+      }
+    });
+    actionArgs.push(options);
+    return command.commandAction.apply(this, actionArgs);
+  }
+}
+var cac = (name = "") => new CAC(name);
+
+// src/index.ts
+import { mkdirSync as mkdirSync3 } from "node:fs";
+
+// src/core/backup.ts
+import { existsSync as existsSync2, lstatSync as lstatSync2, mkdirSync as mkdirSync2, readdirSync as readdirSync2, readFileSync as readFileSync2, readlinkSync as readlinkSync2, realpathSync as realpathSync2, symlinkSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { dirname as dirname2, join as join2, relative, resolve as resolve2 } from "node:path";
+
+// src/core/utils.ts
+import { createHash } from "node:crypto";
+import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, realpathSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+function resolveHomeDir(explicitHome) {
+  const envHome = process.env.SKILL_SYNC_HOME;
+  if (explicitHome) {
+    return resolve(explicitHome);
+  }
+  if (envHome) {
+    return resolve(envHome);
+  }
+  return homedir();
+}
+function buildRuntimeContext(options) {
+  const homeDir = resolveHomeDir(options.home);
+  const stateDir = join(homeDir, ".skill-sync");
+  return {
+    homeDir,
+    stateDir,
+    configPath: join(stateDir, "config.json"),
+    statePath: join(stateDir, "state.json"),
+    json: Boolean(options.json)
+  };
+}
+function expandHomePath(input, homeDir) {
+  if (input === "~") {
+    return homeDir;
+  }
+  if (input.startsWith("~/")) {
+    return join(homeDir, input.slice(2));
+  }
+  return resolve(input);
+}
+function ensureDir(path) {
+  mkdirSync(path, { recursive: true });
+}
+function readJsonFile(path) {
+  if (!existsSync(path)) {
+    return null;
+  }
+  return JSON.parse(readFileSync(path, "utf8"));
+}
+function writeJsonFile(path, value) {
+  ensureDir(dirname(path));
+  writeFileSync(path, `${JSON.stringify(value, null, 2)}
+`, "utf8");
+}
+function nowIso() {
+  return new Date().toISOString();
+}
+function timestampId() {
+  return nowIso().replace(/[:.]/g, "-");
+}
+function slugify(input) {
+  return input.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[_\s]+/g, "-").replace(/[^a-zA-Z0-9.-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").toLowerCase();
+}
+function parseSkillFrontmatterName(skillFilePath) {
+  const content = readFileSync(skillFilePath, "utf8");
+  if (!content.startsWith("---")) {
+    return;
+  }
+  const parts = content.split(`
+---`);
+  if (parts.length < 2) {
+    return;
+  }
+  const match = parts[0].match(/^name:\s*(.+)\s*$/m);
+  return match?.[1]?.trim();
+}
+function hashContent(content) {
+  return createHash("sha1").update(content).digest("hex");
+}
+function listImmediateDirectories(path) {
+  if (!existsSync(path)) {
+    return [];
+  }
+  return readdirSync(path).map((name) => join(path, name)).filter((candidate) => {
+    try {
+      return lstatSync(candidate).isDirectory();
+    } catch {
+      return false;
+    }
+  });
+}
+function inspectEntry(path) {
+  if (!existsSync(path)) {
+    return { exists: false, type: "missing" };
+  }
+  const stats = lstatSync(path);
+  if (stats.isSymbolicLink()) {
+    const linkTarget = readFileSyncLink(path);
+    let resolvedTarget;
+    try {
+      resolvedTarget = realpathSync(path);
+    } catch {
+      resolvedTarget = undefined;
+    }
+    return { exists: true, type: "symlink", linkTarget, resolvedTarget };
+  }
+  if (stats.isDirectory()) {
+    return { exists: true, type: "directory" };
+  }
+  return { exists: true, type: "file" };
+}
+function readFileSyncLink(path) {
+  return readlinkSync(path);
+}
+function pathOwnsEntry(rootPath, entryPath) {
+  const normalizedRoot = resolve(rootPath);
+  const normalizedEntry = resolve(entryPath);
+  return normalizedEntry === normalizedRoot || normalizedEntry.startsWith(`${normalizedRoot}/`);
+}
+function removePath(path) {
+  rmSync(path, { recursive: true, force: true });
+}
+
+// src/core/backup.ts
+function createBackup(runtime, harnesses, state) {
+  const id = timestampId();
+  const backupDir = join2(runtime.stateDir, "backups", id);
+  ensureDir(backupDir);
+  const harnessSnapshots = harnesses.map((harness) => snapshotHarness(backupDir, harness));
+  const manifest = {
+    version: 1,
+    id,
+    createdAt: new Date().toISOString(),
+    homeDir: runtime.homeDir,
+    stateSnapshotIncluded: true,
+    harnesses: harnessSnapshots
+  };
+  writeJsonFile(join2(backupDir, "manifest.json"), manifest);
+  writeJsonFile(join2(backupDir, "state.json"), state);
+  return manifest;
+}
+function snapshotHarness(_backupDir, harness) {
+  const exists = existsSync2(harness.rootPath);
+  const entries = [];
+  if (exists) {
+    for (const name of readdirSync2(harness.rootPath).sort()) {
+      const entryPath = join2(harness.rootPath, name);
+      const stats = lstatSync2(entryPath);
+      const snapshot = {
+        name,
+        path: entryPath,
+        type: stats.isSymbolicLink() ? "symlink" : stats.isDirectory() ? "directory" : "file",
+        skillFiles: []
+      };
+      if (stats.isSymbolicLink()) {
+        snapshot.linkTarget = readlinkSync2(entryPath);
+        const inspection = inspectEntry(entryPath);
+        snapshot.targetExists = inspection.resolvedTarget !== undefined;
+        if (inspection.resolvedTarget) {
+          snapshot.targetType = lstatSync2(inspection.resolvedTarget).isDirectory() ? "directory" : "file";
+          snapshot.skillFiles = collectSkillFiles(inspection.resolvedTarget, snapshot.targetType);
+        }
+      } else {
+        snapshot.targetType = stats.isDirectory() ? "directory" : "file";
+        snapshot.skillFiles = collectSkillFiles(entryPath, snapshot.type);
+      }
+      entries.push(snapshot);
+    }
+  }
+  return {
+    id: harness.id,
+    label: harness.label,
+    rootPath: harness.rootPath,
+    exists,
+    entries
+  };
+}
+function listBackups(runtime) {
+  const backupsDir = join2(runtime.stateDir, "backups");
+  if (!existsSync2(backupsDir)) {
+    return [];
+  }
+  return readdirSync2(backupsDir).sort().reverse().map((id) => readJsonFile(join2(backupsDir, id, "manifest.json"))).filter((manifest) => manifest !== null);
+}
+function restoreBackup(runtime, backupId, selectedHarnessIds, dryRun, currentState) {
+  const backupDir = join2(runtime.stateDir, "backups", backupId);
+  const manifest = readJsonFile(join2(backupDir, "manifest.json"));
+  if (!manifest) {
+    throw new Error(`Backup not found: ${backupId}`);
+  }
+  const backupState = readJsonFile(join2(backupDir, "state.json"));
+  const selected = selectedHarnessIds.length > 0 ? manifest.harnesses.filter((harness) => selectedHarnessIds.includes(harness.id)) : manifest.harnesses;
+  for (const harness of selected) {
+    if (!dryRun) {
+      ensureDir(harness.rootPath);
+    }
+    const currentEntries = existsSync2(harness.rootPath) ? readdirSync2(harness.rootPath) : [];
+    const desiredEntries = new Set(harness.entries.map((entry) => entry.name));
+    for (const name of currentEntries) {
+      if (desiredEntries.has(name)) {
+        continue;
+      }
+      if (!dryRun) {
+        removePath(join2(harness.rootPath, name));
+      }
+    }
+    for (const entry of harness.entries) {
+      restoreEntry(backupDir, harness, entry, dryRun);
+    }
+  }
+  let nextState = currentState;
+  if (backupState) {
+    const selectedRoots = selected.map((harness) => harness.rootPath);
+    const managedEntries = { ...currentState.managedEntries };
+    for (const key of Object.keys(managedEntries)) {
+      if (selectedRoots.some((root) => pathOwnsEntry(root, key))) {
+        delete managedEntries[key];
+      }
+    }
+    for (const [entryPath, managed] of Object.entries(backupState.managedEntries)) {
+      if (selectedRoots.some((root) => pathOwnsEntry(root, entryPath))) {
+        managedEntries[entryPath] = managed;
+      }
+    }
+    nextState = {
+      version: backupState.version,
+      managedEntries
+    };
+  }
+  return { manifest, nextState };
+}
+function restoreEntry(_backupDir, harness, entry, dryRun) {
+  const destinationPath = join2(harness.rootPath, entry.name);
+  if (dryRun) {
+    return;
+  }
+  removePath(destinationPath);
+  const linkTargetExists = entry.linkTarget ? existsSync2(resolve2(dirname2(destinationPath), entry.linkTarget)) : false;
+  if (entry.type === "symlink" && entry.linkTarget && linkTargetExists) {
+    symlinkSync(entry.linkTarget, destinationPath);
+    return;
+  }
+  if (entry.skillFiles.length > 0) {
+    restoreSkillFiles(destinationPath, entry);
+    return;
+  }
+  throw new Error(`Cannot restore ${relative(harness.rootPath, destinationPath)}: no valid link target or backed-up SKILL.md files`);
+}
+function restoreSkillFiles(destinationPath, entry) {
+  const treatAsDirectory = entry.type === "directory" || entry.type === "symlink" || entry.targetType === "directory" || entry.skillFiles.some((file) => file.relativePath.includes("/"));
+  if (treatAsDirectory) {
+    mkdirSync2(destinationPath, { recursive: true });
+    for (const skillFile2 of entry.skillFiles) {
+      const targetPath = join2(destinationPath, skillFile2.relativePath);
+      mkdirSync2(dirname2(targetPath), { recursive: true });
+      writeFileSync2(targetPath, skillFile2.content, "utf8");
+    }
+    return;
+  }
+  const skillFile = entry.skillFiles[0];
+  mkdirSync2(dirname2(destinationPath), { recursive: true });
+  writeFileSync2(destinationPath, skillFile.content, "utf8");
+}
+function collectSkillFiles(entryPath, entryType) {
+  if (!existsSync2(entryPath)) {
+    return [];
+  }
+  if (entryType === "file") {
+    if (!entryPath.endsWith("SKILL.md")) {
+      return [];
+    }
+    return [{ relativePath: "SKILL.md", content: readFileSync2(entryPath, "utf8") }];
+  }
+  return walkForSkillFiles(entryPath, "", new Set);
+}
+function walkForSkillFiles(absoluteCurrent, currentRelative, visited) {
+  const stats = lstatSync2(absoluteCurrent);
+  const canonicalPath = getCanonicalPath(absoluteCurrent);
+  if (canonicalPath && visited.has(canonicalPath)) {
+    return [];
+  }
+  if (stats.isSymbolicLink()) {
+    const inspection = inspectEntry(absoluteCurrent);
+    if (!inspection.resolvedTarget) {
+      return [];
+    }
+    if (canonicalPath) {
+      visited.add(canonicalPath);
+    }
+    const resolvedStats = lstatSync2(inspection.resolvedTarget);
+    if (resolvedStats.isDirectory()) {
+      return walkForSkillFiles(inspection.resolvedTarget, currentRelative, visited);
+    }
+    if (absoluteCurrent.endsWith("SKILL.md")) {
+      return [{ relativePath: currentRelative || "SKILL.md", content: readFileSync2(absoluteCurrent, "utf8") }];
+    }
+    return [];
+  }
+  if (stats.isFile()) {
+    if (absoluteCurrent.endsWith("SKILL.md")) {
+      return [{ relativePath: currentRelative || "SKILL.md", content: readFileSync2(absoluteCurrent, "utf8") }];
+    }
+    return [];
+  }
+  if (!stats.isDirectory()) {
+    return [];
+  }
+  if (canonicalPath) {
+    visited.add(canonicalPath);
+  }
+  const snapshots = [];
+  for (const name of readdirSync2(absoluteCurrent).sort()) {
+    if (IGNORED_BACKUP_DIR_NAMES.has(name)) {
+      continue;
+    }
+    const nextRelative = currentRelative ? join2(currentRelative, name) : name;
+    snapshots.push(...walkForSkillFiles(join2(absoluteCurrent, name), nextRelative, visited));
+  }
+  return snapshots;
+}
+function getCanonicalPath(path) {
+  try {
+    return realpathSync2(path);
+  } catch {
+    return;
+  }
+}
+var IGNORED_BACKUP_DIR_NAMES = new Set([
+  ".git",
+  "node_modules",
+  "dist",
+  "build",
+  ".next",
+  "coverage",
+  "tmp",
+  "temp"
+]);
+
+// src/core/config.ts
+import { existsSync as existsSync3 } from "node:fs";
+import { join as join3, resolve as resolve3 } from "node:path";
+function getDefaultConfig(homeDir) {
+  return {
+    version: 1,
+    projectsRoots: [join3(homeDir, "_dev")],
+    discovery: {
+      ignorePathPrefixes: [],
+      preferPathPrefixes: []
+    },
+    harnesses: {
+      custom: []
+    },
+    aliases: {}
+  };
+}
+function getDefaultState() {
+  return {
+    version: 1,
+    managedEntries: {}
+  };
+}
+function loadConfig(runtime) {
+  const config = readJsonFile(runtime.configPath);
+  if (!config) {
+    return getDefaultConfig(runtime.homeDir);
+  }
+  return {
+    ...getDefaultConfig(runtime.homeDir),
+    ...config,
+    projectsRoots: (config.projectsRoots || []).map((root) => expandHomePath(root, runtime.homeDir)),
+    discovery: {
+      ignorePathPrefixes: (config.discovery?.ignorePathPrefixes || []).map((path) => expandHomePath(path, runtime.homeDir)),
+      preferPathPrefixes: (config.discovery?.preferPathPrefixes || []).map((path) => expandHomePath(path, runtime.homeDir))
+    },
+    harnesses: {
+      custom: config.harnesses?.custom || []
+    },
+    aliases: config.aliases || {}
+  };
+}
+function saveConfig(runtime, config) {
+  ensureDir(runtime.stateDir);
+  writeJsonFile(runtime.configPath, config);
+}
+function loadState(runtime) {
+  return readJsonFile(runtime.statePath) || getDefaultState();
+}
+function saveState(runtime, state) {
+  ensureDir(runtime.stateDir);
+  writeJsonFile(runtime.statePath, state);
+}
+function initConfig(runtime) {
+  const config = loadConfig(runtime);
+  saveConfig(runtime, config);
+  if (!existsSync3(runtime.statePath)) {
+    saveState(runtime, getDefaultState());
+  }
+  return config;
+}
+function addProjectsRoot(runtime, rootPath) {
+  const config = loadConfig(runtime);
+  const normalized = resolve3(expandHomePath(rootPath, runtime.homeDir));
+  if (!config.projectsRoots.includes(normalized)) {
+    config.projectsRoots.push(normalized);
+    config.projectsRoots.sort();
+  }
+  saveConfig(runtime, config);
+  return config;
+}
+function removeProjectsRoot(runtime, rootPath) {
+  const config = loadConfig(runtime);
+  const normalized = resolve3(expandHomePath(rootPath, runtime.homeDir));
+  config.projectsRoots = config.projectsRoots.filter((root) => resolve3(root) !== normalized);
+  saveConfig(runtime, config);
+  return config;
+}
+function addHarness(runtime, id, rootPath) {
+  const config = loadConfig(runtime);
+  const normalized = resolve3(expandHomePath(rootPath, runtime.homeDir));
+  const remaining = config.harnesses.custom.filter((entry) => entry.id !== id);
+  remaining.push({ id, rootPath: normalized, enabled: true });
+  remaining.sort((a, b) => a.id.localeCompare(b.id));
+  config.harnesses.custom = remaining;
+  saveConfig(runtime, config);
+  return config;
+}
+function removeHarness(runtime, id) {
+  const config = loadConfig(runtime);
+  config.harnesses.custom = config.harnesses.custom.filter((entry) => entry.id !== id);
+  saveConfig(runtime, config);
+  return config;
+}
+
+// src/core/harnesses.ts
+import { existsSync as existsSync4 } from "node:fs";
+var BUILT_IN_HARNESSES = [
+  { id: "agents", label: "Agents", rootPath: "~/.agents/skills", aliases: ["cline", "warp", "amp", "kimi-cli", "replit", "universal"] },
+  { id: "antigravity", label: "Antigravity", rootPath: "~/.gemini/antigravity/skills" },
+  { id: "claude-code", label: "Claude Code", rootPath: "~/.claude/skills" },
+  { id: "codex", label: "Codex", rootPath: "~/.codex/skills" },
+  { id: "cursor", label: "Cursor", rootPath: "~/.cursor/skills" },
+  { id: "droid", label: "Droid", rootPath: "~/.factory/skills" },
+  { id: "gemini-cli", label: "Gemini CLI", rootPath: "~/.gemini/skills" },
+  { id: "github-copilot", label: "GitHub Copilot", rootPath: "~/.copilot/skills" },
+  { id: "hermes", label: "Hermes", rootPath: "~/.hermes/skills" },
+  { id: "skills", label: "Skills Root", rootPath: "~/.skills" }
+];
+function resolveHarnesses(homeDir, config) {
+  const builtIns = BUILT_IN_HARNESSES.map((entry) => {
+    const rootPath = expandHomePath(entry.rootPath, homeDir);
+    return {
+      id: entry.id,
+      label: entry.label,
+      rootPath,
+      aliases: entry.aliases,
+      kind: "built-in",
+      detected: existsSync4(rootPath),
+      enabled: existsSync4(rootPath)
+    };
+  });
+  const custom = (config.harnesses.custom || []).map((entry) => {
+    const rootPath = expandHomePath(entry.rootPath, homeDir);
+    return {
+      id: entry.id,
+      label: entry.label || entry.id,
+      rootPath,
+      kind: "custom",
+      detected: existsSync4(rootPath),
+      enabled: entry.enabled !== false
+    };
+  });
+  const merged = new Map;
+  for (const harness of [...builtIns, ...custom]) {
+    merged.set(harness.id, harness);
+  }
+  return [...merged.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+function filterHarnesses(harnesses, selectedIds) {
+  if (selectedIds.length === 0) {
+    return harnesses.filter((harness) => harness.enabled);
+  }
+  const selected = new Set(selectedIds);
+  return harnesses.filter((harness) => selected.has(harness.id));
+}
+
+// src/core/sources.ts
+import { existsSync as existsSync5, readFileSync as readFileSync3 } from "node:fs";
+import { basename as basename2, join as join4, relative as relative2, resolve as resolve4 } from "node:path";
+function discoverSkillSet(config) {
+  const discovered = [];
+  const discovery = getDiscoveryConfig(config);
+  for (const projectsRoot of config.projectsRoots) {
+    for (const repoPath of listImmediateDirectories(projectsRoot)) {
+      const topLevelSkill = join4(repoPath, "SKILL.md");
+      if (existsSync5(topLevelSkill)) {
+        discovered.push(buildDiscoveredSkill(projectsRoot, repoPath, repoPath, topLevelSkill, "repo-root"));
+      }
+      const nestedSkillsRoot = join4(repoPath, "skills");
+      for (const nestedSkillDir of listImmediateDirectories(nestedSkillsRoot)) {
+        const nestedSkillFile = join4(nestedSkillDir, "SKILL.md");
+        if (!existsSync5(nestedSkillFile)) {
+          continue;
+        }
+        discovered.push(buildDiscoveredSkill(projectsRoot, repoPath, nestedSkillDir, nestedSkillFile, "nested"));
+      }
+    }
+  }
+  const filtered = discovered.filter((skill) => !isIgnoredSource(skill.sourcePath, discovery.ignorePathPrefixes));
+  const deduped = new Map;
+  for (const skill of filtered) {
+    const key = `${skill.repoPath}::${skill.canonicalSlug}`;
+    const existing = deduped.get(key);
+    if (!existing) {
+      deduped.set(key, skill);
+      continue;
+    }
+    if (existing.sourceType === "nested" && skill.sourceType === "repo-root") {
+      deduped.set(key, skill);
+    }
+  }
+  const { skills, sourceDiagnostics } = resolveGlobalDuplicates([...deduped.values()], discovery.preferPathPrefixes);
+  return {
+    skills: skills.sort((a, b) => a.sourceKey.localeCompare(b.sourceKey)),
+    sourceDiagnostics
+  };
+}
+function buildDiscoveredSkill(projectsRoot, repoPath, sourcePath, skillFilePath, sourceType) {
+  const metadataName = parseSkillFrontmatterName(skillFilePath);
+  const contentHash = hashContent(readFileSync3(skillFilePath, "utf8"));
+  const fallbackName = sourceType === "repo-root" ? basename2(repoPath) : basename2(sourcePath);
+  const canonicalSlug = slugify(metadataName || fallbackName);
+  const sourceKey = resolve4(sourcePath);
+  return {
+    sourceKey,
+    sourcePath: resolve4(sourcePath),
+    skillFilePath: resolve4(skillFilePath),
+    repoPath: resolve4(repoPath),
+    projectsRoot: resolve4(projectsRoot),
+    sourceType,
+    metadataName,
+    canonicalSlug,
+    contentHash
+  };
+}
+function describeSkill(skill) {
+  const repoRelative = relative2(skill.projectsRoot, skill.sourcePath) || basename2(skill.sourcePath);
+  return `${skill.canonicalSlug} <= ${repoRelative}`;
+}
+function isIgnoredSource(sourcePath, ignorePrefixes) {
+  return ignorePrefixes.some((prefix) => sourcePath === prefix || sourcePath.startsWith(`${prefix}/`));
+}
+function resolveGlobalDuplicates(skills, preferPrefixes) {
+  const grouped = new Map;
+  for (const skill of skills) {
+    const group = grouped.get(skill.canonicalSlug) || [];
+    group.push(skill);
+    grouped.set(skill.canonicalSlug, group);
+  }
+  const resolved = [];
+  const warnings = [];
+  const errors = [];
+  for (const group of grouped.values()) {
+    if (group.length === 1) {
+      resolved.push(group[0]);
+      continue;
+    }
+    const distinctHashes = new Set(group.map((skill) => skill.contentHash));
+    if (distinctHashes.size !== 1) {
+      resolved.push(...group);
+      errors.push({
+        slug: group[0].canonicalSlug,
+        severity: "error",
+        resolution: "unresolved",
+        sourcePaths: group.map((skill) => skill.sourcePath).sort()
+      });
+      continue;
+    }
+    const sorted = [...group].sort((a, b) => compareDiscoveredSkills(a, b, preferPrefixes));
+    resolved.push(sorted[0]);
+    warnings.push({
+      slug: group[0].canonicalSlug,
+      severity: "warning",
+      resolution: "resolved-by-preference",
+      chosenSourcePath: sorted[0].sourcePath,
+      sourcePaths: group.map((skill) => skill.sourcePath).sort()
+    });
+  }
+  return {
+    skills: resolved,
+    sourceDiagnostics: {
+      warnings: warnings.sort(compareDiagnostics),
+      errors: errors.sort(compareDiagnostics)
+    }
+  };
+}
+function getDiscoveryConfig(config) {
+  return {
+    ignorePathPrefixes: config.discovery?.ignorePathPrefixes ?? [],
+    preferPathPrefixes: config.discovery?.preferPathPrefixes ?? []
+  };
+}
+function compareDiscoveredSkills(a, b, preferPrefixes) {
+  const rankA = getPreferenceRank(a.sourcePath, preferPrefixes);
+  const rankB = getPreferenceRank(b.sourcePath, preferPrefixes);
+  if (rankA !== rankB) {
+    return rankA - rankB;
+  }
+  return a.sourcePath.localeCompare(b.sourcePath);
+}
+function getPreferenceRank(sourcePath, preferPrefixes) {
+  const matchIndex = preferPrefixes.findIndex((prefix) => sourcePath === prefix || sourcePath.startsWith(`${prefix}/`));
+  return matchIndex === -1 ? Number.MAX_SAFE_INTEGER : matchIndex;
+}
+function compareDiagnostics(a, b) {
+  return a.slug.localeCompare(b.slug) || a.sourcePaths.join(`
+`).localeCompare(b.sourcePaths.join(`
+`));
+}
+
+// src/core/sync.ts
+import { join as join5, resolve as resolve5 } from "node:path";
+import { existsSync as existsSync6, readdirSync as readdirSync3, readFileSync as readFileSync4, symlinkSync as symlinkSync2 } from "node:fs";
+function buildSyncPlan(skills, harnesses, config, state, sourceDiagnostics) {
+  const harnessPlans = harnesses.map((harness) => ({
+    harness,
+    entries: []
+  }));
+  const desiredByHarness = new Map;
+  let conflicts = 0;
+  let changes = 0;
+  let ok = 0;
+  for (const harnessPlan of harnessPlans) {
+    desiredByHarness.set(harnessPlan.harness.id, new Set);
+    const pathClaims = new Map;
+    for (const skill of skills) {
+      const installName = resolveInstallName(skill, harnessPlan.harness.id, config);
+      const destinationPath = join5(harnessPlan.harness.rootPath, installName);
+      const existingClaim = pathClaims.get(destinationPath);
+      if (existingClaim) {
+        harnessPlan.entries.push({
+          harnessId: harnessPlan.harness.id,
+          harnessRoot: harnessPlan.harness.rootPath,
+          installName,
+          destinationPath,
+          action: "conflict",
+          sourcePath: skill.sourcePath,
+          sourceKey: skill.sourceKey,
+          message: `slug collision between ${existingClaim.sourcePath} and ${skill.sourcePath}`
+        });
+        conflicts += 1;
+        continue;
+      }
+      pathClaims.set(destinationPath, skill);
+      desiredByHarness.get(harnessPlan.harness.id)?.add(destinationPath);
+      const planned = buildPlannedEntry(skill, harnessPlan.harness, installName, destinationPath, state, config);
+      harnessPlan.entries.push(planned);
+      if (planned.action === "conflict") {
+        conflicts += 1;
+      } else if (planned.action === "ok") {
+        ok += 1;
+      } else {
+        changes += 1;
+      }
+    }
+    for (const [entryPath, managed] of Object.entries(state.managedEntries)) {
+      if (managed.harnessId !== harnessPlan.harness.id) {
+        continue;
+      }
+      if (desiredByHarness.get(harnessPlan.harness.id)?.has(entryPath)) {
+        continue;
+      }
+      const inspection = inspectEntry(entryPath);
+      harnessPlan.entries.push({
+        harnessId: harnessPlan.harness.id,
+        harnessRoot: harnessPlan.harness.rootPath,
+        installName: managed.installName,
+        destinationPath: entryPath,
+        action: inspection.exists ? "remove-managed" : "prune-state",
+        sourcePath: managed.sourcePath,
+        message: inspection.exists ? "managed entry is stale and will be removed" : "stale state entry will be pruned"
+      });
+      changes += 1;
+    }
+    harnessPlan.entries.sort((a, b) => a.destinationPath.localeCompare(b.destinationPath));
+  }
+  return {
+    harnesses: harnessPlans,
+    changes,
+    conflicts,
+    ok,
+    sourceDiagnostics: sourceDiagnostics || { warnings: [], errors: [] }
+  };
+}
+function buildPlannedEntry(skill, harness, installName, destinationPath, state, config) {
+  const inspection = inspectEntry(destinationPath);
+  const stateEntry = state.managedEntries[destinationPath];
+  const sameSource = inspection.type === "symlink" && inspection.resolvedTarget === resolve5(skill.sourcePath);
+  const compatibility = inspectCompatibility(destinationPath, skill);
+  if (!inspection.exists) {
+    return makePlannedEntry(skill, harness, installName, destinationPath, "create", "missing entry will be created");
+  }
+  if (sameSource) {
+    return makePlannedEntry(skill, harness, installName, destinationPath, "ok", "already synced");
+  }
+  if (compatibility === "matching-skill") {
+    return makePlannedEntry(skill, harness, installName, destinationPath, "ok", "compatible existing install");
+  }
+  if (stateEntry) {
+    return makePlannedEntry(skill, harness, installName, destinationPath, "repair", "managed entry drift will be repaired");
+  }
+  if (compatibility === "empty-directory") {
+    return makePlannedEntry(skill, harness, installName, destinationPath, "repair", "empty directory will be replaced");
+  }
+  return makePlannedEntry(skill, harness, installName, destinationPath, "conflict", inspection.type === "symlink" ? `existing symlink points elsewhere: ${inspection.linkTarget || "unknown target"}` : `existing ${inspection.type} is unmanaged`);
+}
+function inspectCompatibility(destinationPath, skill) {
+  const inspection = inspectEntry(destinationPath);
+  if (!inspection.exists) {
+    return "none";
+  }
+  const sourceSkillText = readFileSync4(skill.skillFilePath, "utf8");
+  if (inspection.type === "directory") {
+    if (readdirSync3(destinationPath).length === 0) {
+      return "empty-directory";
+    }
+    const installedSkillPath = join5(destinationPath, "SKILL.md");
+    if (existsSync6(installedSkillPath) && readFileSync4(installedSkillPath, "utf8") === sourceSkillText) {
+      return "matching-skill";
+    }
+    return "none";
+  }
+  if (inspection.type === "file") {
+    return readFileSync4(destinationPath, "utf8") === sourceSkillText ? "matching-skill" : "none";
+  }
+  if (inspection.type === "symlink" && inspection.resolvedTarget) {
+    const installedSkillPath = join5(inspection.resolvedTarget, "SKILL.md");
+    if (existsSync6(installedSkillPath) && readFileSync4(installedSkillPath, "utf8") === sourceSkillText) {
+      return "matching-skill";
+    }
+  }
+  return "none";
+}
+function makePlannedEntry(skill, harness, installName, destinationPath, action, message) {
+  return {
+    harnessId: harness.id,
+    harnessRoot: harness.rootPath,
+    installName,
+    destinationPath,
+    action,
+    sourcePath: skill.sourcePath,
+    sourceKey: skill.sourceKey,
+    message
+  };
+}
+function resolveInstallName(skill, harnessId, config) {
+  const override = config.aliases[skill.sourceKey];
+  if (override?.harnesses?.[harnessId]) {
+    return override.harnesses[harnessId];
+  }
+  if (override?.default) {
+    return override.default;
+  }
+  return skill.canonicalSlug;
+}
+function applySyncPlan(plan, state, dryRun) {
+  const nextState = {
+    version: state.version,
+    managedEntries: { ...state.managedEntries }
+  };
+  for (const harnessPlan of plan.harnesses) {
+    ensureDir(harnessPlan.harness.rootPath);
+    for (const entry of harnessPlan.entries) {
+      if (entry.action === "ok" || entry.action === "conflict") {
+        continue;
+      }
+      if (entry.action === "prune-state") {
+        delete nextState.managedEntries[entry.destinationPath];
+        continue;
+      }
+      if (dryRun) {
+        continue;
+      }
+      if (entry.action === "remove-managed") {
+        removePath(entry.destinationPath);
+        delete nextState.managedEntries[entry.destinationPath];
+        continue;
+      }
+      removePath(entry.destinationPath);
+      symlinkSync2(entry.sourcePath, entry.destinationPath);
+      nextState.managedEntries[entry.destinationPath] = {
+        harnessId: entry.harnessId,
+        sourcePath: entry.sourcePath,
+        installName: entry.installName,
+        updatedAt: nowIso()
+      };
+    }
+  }
+  return nextState;
+}
+function countPlanActions(plan) {
+  const counts = {};
+  for (const harness of plan.harnesses) {
+    for (const entry of harness.entries) {
+      counts[entry.action] = (counts[entry.action] || 0) + 1;
+    }
+  }
+  return counts;
+}
+function hasConflicts(plan) {
+  return plan.conflicts > 0 || plan.sourceDiagnostics.errors.length > 0;
+}
+function hasDrift(plan) {
+  return plan.changes > 0;
+}
+
+// src/index.ts
+var cli = cac("skill-sync");
+var version = "0.1.1";
+function normalizeList(value) {
+  if (!value) {
+    return [];
+  }
+  const raw = Array.isArray(value) ? value : [value];
+  return raw.flatMap((item) => item.split(",")).map((item) => item.trim()).filter(Boolean);
+}
+function withRuntime(options, fn) {
+  const runtime = buildRuntimeContext({ home: options.home, json: options.json });
+  mkdirSync3(runtime.stateDir, { recursive: true });
+  return fn(runtime);
+}
+function resolveProjectsOverride(configProjectsRoots, options) {
+  const override = normalizeList(options.projectsRoot);
+  return override.length > 0 ? override : configProjectsRoots;
+}
+function resolveSelectedHarnesses(allHarnesses, options) {
+  return filterHarnesses(allHarnesses, normalizeList(options.harness));
+}
+function print(value, json) {
+  if (json) {
+    console.log(typeof value === "string" ? JSON.stringify({ message: value }, null, 2) : JSON.stringify(value, null, 2));
+    return;
+  }
+  console.log(value);
+}
+function renderPlan(plan) {
+  const lines = [];
+  appendSourceDiagnostics(lines, plan.sourceDiagnostics);
+  const counts = countPlanActions(plan);
+  if (lines.length > 0) {
+    lines.push("");
+  }
+  lines.push(`Summary: ${plan.ok} ok, ${plan.changes} change(s), ${plan.conflicts} conflict(s)`);
+  lines.push(`Actions: ${Object.entries(counts).map(([action, count]) => `${action}=${count}`).join(", ")}`);
+  for (const harnessPlan of plan.harnesses) {
+    lines.push("");
+    lines.push(`${harnessPlan.harness.id}  ${harnessPlan.harness.rootPath}`);
+    const interestingEntries = harnessPlan.entries.filter((entry) => entry.action !== "ok");
+    const entriesToShow = interestingEntries.length > 0 ? interestingEntries : harnessPlan.entries;
+    for (const entry of entriesToShow) {
+      const sourceSuffix = entry.sourcePath ? ` <= ${entry.sourcePath}` : "";
+      lines.push(`  ${entry.action.padEnd(14)} ${entry.installName}${sourceSuffix}`);
+      if (entry.message !== "already synced") {
+        lines.push(`    ${entry.message}`);
+      }
+    }
+  }
+  return lines.join(`
+`);
+}
+function appendSourceDiagnostics(lines, sourceDiagnostics) {
+  if (sourceDiagnostics.errors.length === 0 && sourceDiagnostics.warnings.length === 0) {
+    return;
+  }
+  if (sourceDiagnostics.errors.length > 0) {
+    lines.push("Source errors:");
+    for (const diagnostic of sourceDiagnostics.errors) {
+      appendSourceDiagnostic(lines, diagnostic);
+    }
+  }
+  if (sourceDiagnostics.warnings.length > 0) {
+    if (lines.length > 0) {
+      lines.push("");
+    }
+    lines.push("Source warnings:");
+    for (const diagnostic of sourceDiagnostics.warnings) {
+      appendSourceDiagnostic(lines, diagnostic);
+    }
+  }
+}
+function appendSourceDiagnostic(lines, diagnostic) {
+  lines.push(`- duplicate slug: ${diagnostic.slug}`);
+  for (const sourcePath of diagnostic.sourcePaths) {
+    lines.push(`  ${sourcePath}`);
+  }
+  if (diagnostic.resolution === "resolved-by-preference" && diagnostic.chosenSourcePath) {
+    lines.push(`  resolved by preference: ${diagnostic.chosenSourcePath}`);
+    return;
+  }
+  lines.push("  sync blocked until one source is excluded or preferred");
+}
+function planSync(options) {
+  return withRuntime(options, (runtime) => {
+    const config = loadConfig(runtime);
+    config.projectsRoots = resolveProjectsOverride(config.projectsRoots, options);
+    const harnesses = resolveSelectedHarnesses(resolveHarnesses(runtime.homeDir, config), options);
+    const { skills, sourceDiagnostics } = discoverSkillSet(config);
+    const state = loadState(runtime);
+    const plan = buildSyncPlan(skills, harnesses, config, state, sourceDiagnostics);
+    return { runtime, plan, harnesses, skillsCount: skills.length };
+  });
+}
+function printCheckResult(plan, json) {
+  print(json ? plan : renderPlan(plan), json);
+  process.exit(hasConflicts(plan) ? 3 : hasDrift(plan) ? 2 : 0);
+}
+cli.command("check", "Show drift without changing anything").option("--json", "Output JSON").option("--dry-run", "Accepted for parity; check is always read-only").option("--projects-root <path>", "Override configured projects root").option("--harness <id>", "Filter to one or more harness ids").option("--home <path>", "Override HOME for skill-sync state and harness resolution").action((options) => {
+  const { plan } = planSync(options);
+  printCheckResult(plan, Boolean(options.json));
+});
+cli.command("sync", "Apply the desired symlink state").option("--json", "Output JSON").option("--dry-run", "Show changes without mutating").option("--projects-root <path>", "Override configured projects root").option("--harness <id>", "Filter to one or more harness ids").option("--home <path>", "Override HOME for skill-sync state and harness resolution").action((options) => {
+  const { runtime, plan } = planSync(options);
+  if (hasConflicts(plan)) {
+    print(options.json ? plan : renderPlan(plan), Boolean(options.json));
+    process.exit(3);
+  }
+  const state = loadState(runtime);
+  const nextState = applySyncPlan(plan, state, Boolean(options.dryRun));
+  if (!options.dryRun) {
+    saveState(runtime, nextState);
+  }
+  print(options.json ? plan : renderPlan(plan), Boolean(options.json));
+});
+cli.command("sources", "List discovered source skills").option("--json", "Output JSON").option("--projects-root <path>", "Override configured projects root").option("--home <path>", "Override HOME for skill-sync state and harness resolution").action((options) => {
+  withRuntime(options, (runtime) => {
+    const config = loadConfig(runtime);
+    config.projectsRoots = resolveProjectsOverride(config.projectsRoots, options);
+    const { skills, sourceDiagnostics } = discoverSkillSet(config);
+    if (options.json) {
+      print({ skills, sourceDiagnostics }, true);
+      return;
+    }
+    console.log(`Discovered ${skills.length} skill source(s)`);
+    const sourceLines = [];
+    appendSourceDiagnostics(sourceLines, sourceDiagnostics);
+    if (sourceLines.length > 0) {
+      console.log(sourceLines.join(`
+`));
+      console.log("");
+    }
+    for (const skill of skills) {
+      console.log(`- ${describeSkill(skill)}`);
+    }
+  });
+});
+cli.command("harnesses", "List known harness roots and detection status").option("--json", "Output JSON").option("--home <path>", "Override HOME for skill-sync state and harness resolution").action((options) => {
+  withRuntime(options, (runtime) => {
+    const harnesses = resolveHarnesses(runtime.homeDir, loadConfig(runtime));
+    if (options.json) {
+      print(harnesses, true);
+      return;
+    }
+    for (const harness of harnesses) {
+      console.log(`${harness.id}  ${harness.rootPath}`);
+      console.log(`  kind: ${harness.kind}`);
+      console.log(`  detected: ${harness.detected ? "yes" : "no"}`);
+      console.log(`  enabled: ${harness.enabled ? "yes" : "no"}`);
+    }
+  });
+});
+cli.command("backup <action> [target]", "Backup commands: create, list, restore").option("--json", "Output JSON").option("--dry-run", "Show what would happen without mutating").option("--home <path>", "Override HOME for skill-sync state and harness resolution").option("--harness <id>", "Filter to one or more harness ids").action((action, target, options) => {
+  withRuntime(options, (runtime) => {
+    if (action === "create") {
+      const config = loadConfig(runtime);
+      const harnesses = resolveSelectedHarnesses(resolveHarnesses(runtime.homeDir, config), options);
+      const manifest = createBackup(runtime, harnesses, loadState(runtime));
+      if (options.json) {
+        print(manifest, true);
+        return;
+      }
+      console.log(`Created backup ${manifest.id}`);
+      for (const harness of manifest.harnesses) {
+        console.log(`- ${harness.id}: ${harness.entries.length} entr${harness.entries.length === 1 ? "y" : "ies"}`);
+      }
+      return;
+    }
+    if (action === "list") {
+      const backups = listBackups(runtime);
+      if (options.json) {
+        print(backups, true);
+        return;
+      }
+      if (backups.length === 0) {
+        console.log("No backups found");
+        return;
+      }
+      for (const backupEntry of backups) {
+        console.log(`${backupEntry.id}  ${backupEntry.createdAt}`);
+        console.log(`  harnesses: ${backupEntry.harnesses.map((harness) => harness.id).join(", ") || "-"}`);
+      }
+      return;
+    }
+    if (action === "restore") {
+      if (!target) {
+        throw new Error("backup restore requires a backup id");
+      }
+      const { manifest, nextState } = restoreBackup(runtime, target, normalizeList(options.harness), Boolean(options.dryRun), loadState(runtime));
+      if (!options.dryRun) {
+        saveState(runtime, nextState);
+      }
+      if (options.json) {
+        print(manifest, true);
+        return;
+      }
+      console.log(`${options.dryRun ? "Would restore" : "Restored"} backup ${manifest.id}`);
+      const selectedIds = normalizeList(options.harness);
+      for (const harness of manifest.harnesses) {
+        if (selectedIds.length > 0 && !selectedIds.includes(harness.id)) {
+          continue;
+        }
+        console.log(`- ${harness.id}: ${harness.entries.length} entr${harness.entries.length === 1 ? "y" : "ies"}`);
+      }
+      return;
+    }
+    throw new Error(`Unknown backup action: ${action}`);
+  });
+});
+cli.command("config <action>", "Config commands: init").option("--json", "Output JSON").option("--home <path>", "Override HOME for skill-sync state and harness resolution").action((action, options) => {
+  if (action !== "init") {
+    throw new Error(`Unknown config action: ${action}`);
+  }
+  withRuntime(options, (runtime) => {
+    const config = initConfig(runtime);
+    print(config, Boolean(options.json));
+  });
+});
+cli.command("harness <action> [id] [rootPath]", "Harness commands: list, add, remove").option("--json", "Output JSON").option("--home <path>", "Override HOME for skill-sync state and harness resolution").action((action, id, rootPath, options) => {
+  if (action === "list") {
+    withRuntime(options, (runtime) => {
+      const harnesses = resolveHarnesses(runtime.homeDir, loadConfig(runtime));
+      print(options.json ? harnesses : harnesses.map((item) => `${item.id} ${item.rootPath}`).join(`
+`), Boolean(options.json));
+    });
+    return;
+  }
+  if (!id) {
+    throw new Error(`harness ${action} requires an id`);
+  }
+  if (action === "add") {
+    if (!rootPath) {
+      throw new Error("harness add requires a root path");
+    }
+    const config = withRuntime(options, (runtime) => addHarness(runtime, id, rootPath));
+    print(config, Boolean(options.json));
+    return;
+  }
+  if (action === "remove") {
+    const config = withRuntime(options, (runtime) => removeHarness(runtime, id));
+    print(config, Boolean(options.json));
+    return;
+  }
+  throw new Error(`Unknown harness action: ${action}`);
+});
+cli.command("roots <action> [rootPath]", "Projects root commands: list, add, remove").option("--json", "Output JSON").option("--home <path>", "Override HOME for skill-sync state and harness resolution").action((action, rootPath, options) => {
+  if (action === "list") {
+    withRuntime(options, (runtime) => {
+      const config = loadConfig(runtime);
+      print(config.projectsRoots, Boolean(options.json));
+    });
+    return;
+  }
+  if (!rootPath) {
+    throw new Error(`roots ${action} requires a path`);
+  }
+  if (action === "add") {
+    const config = withRuntime(options, (runtime) => addProjectsRoot(runtime, rootPath));
+    print(config, Boolean(options.json));
+    return;
+  }
+  if (action === "remove") {
+    const config = withRuntime(options, (runtime) => removeProjectsRoot(runtime, rootPath));
+    print(config, Boolean(options.json));
+    return;
+  }
+  throw new Error(`Unknown roots action: ${action}`);
+});
+cli.help();
+cli.version(version);
+cli.option("--json", "Output JSON");
+cli.option("--dry-run", "Show changes without mutating");
+cli.option("--projects-root <path>", "Override configured projects root");
+cli.option("--harness <id>", "Filter to one or more harness ids");
+cli.option("--home <path>", "Override HOME for skill-sync state and harness resolution");
+var rawArgs = process.argv.slice(2);
+cli.parse();
+var shouldRunDefaultSync = !rawArgs.includes("--help") && !rawArgs.includes("-h") && !rawArgs.includes("--version") && !rawArgs.includes("-v") && !cli.matchedCommand;
+if (shouldRunDefaultSync) {
+  const options = cli.options;
+  const { runtime, plan } = planSync(options);
+  if (hasConflicts(plan)) {
+    console.log(renderPlan(plan));
+    process.exit(3);
+  }
+  const nextState = applySyncPlan(plan, loadState(runtime), Boolean(options.dryRun));
+  if (!options.dryRun) {
+    saveState(runtime, nextState);
+  }
+  console.log(renderPlan(plan));
+}