@ariestools/toolchain 9.1.1 → 9.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/bin/xy.mjs CHANGED
@@ -10635,7 +10635,7 @@ In-flight workspace loads — concurrent jobs for the same dir share one search.
10635
10635
  */
10636
10636
  const workspaceConfigLoadPromises = /* @__PURE__ */ new Map();
10637
10637
  const deprecationWarned = /* @__PURE__ */ new Set();
10638
- function isRecord$10(value) {
10638
+ function isRecord$11(value) {
10639
10639
  return typeof value === "object" && value !== null && !Array.isArray(value);
10640
10640
  }
10641
10641
  const explorerState = {};
@@ -10716,12 +10716,12 @@ function warnOnce(key, message) {
10716
10716
  */
10717
10717
  function resolveCommandField(cfg, commandName, configPath) {
10718
10718
  const configKey = canonicalRuleConfigKey(commandName);
10719
- const commands = isRecord$10(cfg.commands) ? cfg.commands : void 0;
10719
+ const commands = isRecord$11(cfg.commands) ? cfg.commands : void 0;
10720
10720
  const fromCommands = commands?.[configKey];
10721
- if (isRecord$10(fromCommands)) return fromCommands;
10721
+ if (isRecord$11(fromCommands)) return fromCommands;
10722
10722
  for (const alias of deprecatedRuleConfigAliases(configKey)) {
10723
10723
  const fromAlias = commands?.[alias];
10724
- if (!isRecord$10(fromAlias)) continue;
10724
+ if (!isRecord$11(fromAlias)) continue;
10725
10725
  warnOnce(`${configPath ?? "unknown"}:commands.${alias}`, `[xy] Deprecated: "commands.${alias}" in ${configPath ?? "xy.config"} — use "commands.${configKey}"`);
10726
10726
  return fromAlias;
10727
10727
  }
@@ -10733,7 +10733,7 @@ function resolveCommandField(cfg, commandName, configPath) {
10733
10733
  return {};
10734
10734
  }
10735
10735
  function mergeRuleConfigs(target, source) {
10736
- if (isRecord$10(target) && isRecord$10(source)) return {
10736
+ if (isRecord$11(target) && isRecord$11(source)) return {
10737
10737
  ...target,
10738
10738
  ...source
10739
10739
  };
@@ -19474,7 +19474,7 @@ const SEVERITIES = /* @__PURE__ */ new Set([
19474
19474
  ]);
19475
19475
  const SCOPES = /* @__PURE__ */ new Set(["development", "runtime"]);
19476
19476
  const RELATIONSHIPS = /* @__PURE__ */ new Set(["direct", "transitive"]);
19477
- function isRecord$9(value) {
19477
+ function isRecord$10(value) {
19478
19478
  return typeof value === "object" && value !== null && !Array.isArray(value);
19479
19479
  }
19480
19480
  function readString(value) {
@@ -19493,13 +19493,13 @@ function readRelationship(value) {
19493
19493
  return RELATIONSHIPS.has(raw) ? raw : "unknown";
19494
19494
  }
19495
19495
  function parseDependabotAlert(raw) {
19496
- if (!isRecord$9(raw)) return void 0;
19497
- const dependency = isRecord$9(raw.dependency) ? raw.dependency : {};
19498
- const dependencyPackage = isRecord$9(dependency.package) ? dependency.package : {};
19499
- const advisory = isRecord$9(raw.security_advisory) ? raw.security_advisory : {};
19500
- const vulnerability = isRecord$9(raw.security_vulnerability) ? raw.security_vulnerability : {};
19501
- const patched = isRecord$9(vulnerability.first_patched_version) ? vulnerability.first_patched_version : {};
19502
- const repository = isRecord$9(raw.repository) ? raw.repository : {};
19496
+ if (!isRecord$10(raw)) return void 0;
19497
+ const dependency = isRecord$10(raw.dependency) ? raw.dependency : {};
19498
+ const dependencyPackage = isRecord$10(dependency.package) ? dependency.package : {};
19499
+ const advisory = isRecord$10(raw.security_advisory) ? raw.security_advisory : {};
19500
+ const vulnerability = isRecord$10(raw.security_vulnerability) ? raw.security_vulnerability : {};
19501
+ const patched = isRecord$10(vulnerability.first_patched_version) ? vulnerability.first_patched_version : {};
19502
+ const repository = isRecord$10(raw.repository) ? raw.repository : {};
19503
19503
  const packageName = readString(dependencyPackage.name);
19504
19504
  if (packageName.length === 0) return void 0;
19505
19505
  const patchedVersion = readString(patched.identifier);
@@ -23068,7 +23068,7 @@ const RULE_LEVELS$2 = /* @__PURE__ */ new Set([
23068
23068
  "off",
23069
23069
  "warn"
23070
23070
  ]);
23071
- function isRecord$8(value) {
23071
+ function isRecord$9(value) {
23072
23072
  return typeof value === "object" && value !== null && !Array.isArray(value);
23073
23073
  }
23074
23074
  function isValidWeight(value) {
@@ -23085,7 +23085,7 @@ function parseTupleRuleSetting(location, setting) {
23085
23085
  if (setting.length !== 2) throw new TypeError(`${location} tuple must be [level, options]`);
23086
23086
  const [level, options] = setting;
23087
23087
  if (!isRuleLevel$5(level)) throw new TypeError(`${location} level must be "error", "warn", or "off"`);
23088
- if (!isRecord$8(options)) throw new TypeError(`${location} options must be an object`);
23088
+ if (!isRecord$9(options)) throw new TypeError(`${location} options must be an object`);
23089
23089
  return {
23090
23090
  enabled: level !== "off",
23091
23091
  level,
@@ -23118,7 +23118,7 @@ function parseRuleSetting(location, setting) {
23118
23118
  weight: parseWeight(location, setting)
23119
23119
  };
23120
23120
  if (Array.isArray(setting)) return parseTupleRuleSetting(location, setting);
23121
- if (isRecord$8(setting)) return parseObjectRuleSetting(location, setting);
23121
+ if (isRecord$9(setting)) return parseObjectRuleSetting(location, setting);
23122
23122
  throw new TypeError(`${location} must be a boolean, rule level, number, "infinite", [level, options], or { enabled?, level?, weight? } object`);
23123
23123
  }
23124
23124
  function validateRuleIds(location, rules) {
@@ -26429,11 +26429,11 @@ function applyPackageEditsToTsSource(text, edits) {
26429
26429
  }
26430
26430
  return result;
26431
26431
  }
26432
- function isRecord$7(value) {
26432
+ function isRecord$8(value) {
26433
26433
  return typeof value === "object" && value !== null && !Array.isArray(value);
26434
26434
  }
26435
26435
  function readJsonPackageConfig(value) {
26436
- if (!isRecord$7(value)) return void 0;
26436
+ if (!isRecord$8(value)) return void 0;
26437
26437
  const config = {};
26438
26438
  if (typeof value.placement === "string") config.placement = value.placement;
26439
26439
  if (typeof value.presence === "string") config.presence = value.presence;
@@ -26442,10 +26442,10 @@ function readJsonPackageConfig(value) {
26442
26442
  return config;
26443
26443
  }
26444
26444
  function resolveJsonDeplintObject(root) {
26445
- const commands = isRecord$7(root.commands) ? root.commands : void 0;
26446
- if (commands !== void 0 && isRecord$7(commands.deplint)) return commands.deplint;
26447
- if (isRecord$7(root.deplint)) return root.deplint;
26448
- if (!isRecord$7(root.commands)) root.commands = {};
26445
+ const commands = isRecord$8(root.commands) ? root.commands : void 0;
26446
+ if (commands !== void 0 && isRecord$8(commands.deplint)) return commands.deplint;
26447
+ if (isRecord$8(root.deplint)) return root.deplint;
26448
+ if (!isRecord$8(root.commands)) root.commands = {};
26449
26449
  const cmds = root.commands;
26450
26450
  const deplint = {};
26451
26451
  cmds.deplint = deplint;
@@ -26458,7 +26458,7 @@ function applyPackageEditsToJsonSource(text, edits) {
26458
26458
  if (edits.length === 0) return text;
26459
26459
  const root = JSON.parse(text);
26460
26460
  const deplint = resolveJsonDeplintObject(root);
26461
- const packages = isRecord$7(deplint.packages) ? deplint.packages : deplint.packages = {};
26461
+ const packages = isRecord$8(deplint.packages) ? deplint.packages : deplint.packages = {};
26462
26462
  for (const edit of edits) if (edit.config === void 0) delete packages[edit.dependency];
26463
26463
  else packages[edit.dependency] = edit.config;
26464
26464
  if (Object.keys(packages).length === 0) delete deplint.packages;
@@ -26493,9 +26493,9 @@ function readPackagesFromConfigFile(configPath) {
26493
26493
  const result = /* @__PURE__ */ new Map();
26494
26494
  if (isJsonConfigPath$1(configPath)) try {
26495
26495
  const root = JSON.parse(text);
26496
- const commands = isRecord$7(root.commands) ? root.commands : void 0;
26497
- const deplint = commands !== void 0 && isRecord$7(commands.deplint) ? commands.deplint : isRecord$7(root.deplint) ? root.deplint : void 0;
26498
- const packages = deplint !== void 0 && isRecord$7(deplint.packages) ? deplint.packages : void 0;
26496
+ const commands = isRecord$8(root.commands) ? root.commands : void 0;
26497
+ const deplint = commands !== void 0 && isRecord$8(commands.deplint) ? commands.deplint : isRecord$8(root.deplint) ? root.deplint : void 0;
26498
+ const packages = deplint !== void 0 && isRecord$8(deplint.packages) ? deplint.packages : void 0;
26499
26499
  if (packages === void 0) return result;
26500
26500
  for (const [name, value] of Object.entries(packages)) {
26501
26501
  const config = readJsonPackageConfig(value);
@@ -26841,7 +26841,7 @@ const BUILT_IN_RULE_OPTION_KEYS = {
26841
26841
  ]),
26842
26842
  "dep.workspace.protocol": /* @__PURE__ */ new Set(["ignore", "protocol"])
26843
26843
  };
26844
- function isRecord$6(value) {
26844
+ function isRecord$7(value) {
26845
26845
  return typeof value === "object" && value !== null && !Array.isArray(value);
26846
26846
  }
26847
26847
  function isRuleLevel$4(value) {
@@ -26878,7 +26878,7 @@ function parseRuleConfig$1(ruleId, value) {
26878
26878
  const level = value[0];
26879
26879
  if (!isRuleLevel$4(level)) throw new TypeError(`${formatRuleConfigLocation$1(ruleId)} level must be one of "off", "warn", or "error"`);
26880
26880
  const options = value[1];
26881
- if (!isRecord$6(options)) throw new TypeError(`${formatRuleConfigLocation$1(ruleId)} options must be an object`);
26881
+ if (!isRecord$7(options)) throw new TypeError(`${formatRuleConfigLocation$1(ruleId)} options must be an object`);
26882
26882
  return {
26883
26883
  level,
26884
26884
  options: { ...options }
@@ -34259,7 +34259,7 @@ function formatExportPath$1(pathParts) {
34259
34259
  function ensureExportsPath$1(value) {
34260
34260
  return value.startsWith("./") ? value : `./${value}`;
34261
34261
  }
34262
- function isRecord$5(value) {
34262
+ function isRecord$6(value) {
34263
34263
  return typeof value === "object" && value !== null && !Array.isArray(value);
34264
34264
  }
34265
34265
  function normalizeTarget(target) {
@@ -34296,7 +34296,7 @@ function collectExportLeaves(value, subpath = ".", pathParts = ["exports"], cond
34296
34296
  }];
34297
34297
  }
34298
34298
  if (Array.isArray(value)) return value.flatMap((entry, index) => collectExportLeaves(entry, subpath, [...pathParts, `[${index}]`], conditionPath));
34299
- if (!isRecord$5(value)) return [];
34299
+ if (!isRecord$6(value)) return [];
34300
34300
  return Object.entries(value).flatMap(([key, nested]) => {
34301
34301
  if (isSubpathExportKey$1(key)) return collectExportLeaves(nested, key, [...pathParts, key], conditionPath);
34302
34302
  return collectExportLeaves(nested, subpath, [...pathParts, key], [...conditionPath, key]);
@@ -34394,14 +34394,14 @@ function shouldNormalizeExportsForFix(pkg) {
34394
34394
  pkg.exports = { ".": pkg.exports };
34395
34395
  return true;
34396
34396
  }
34397
- if (isRecord$5(pkg.exports) && !hasSubpathKeys(pkg.exports)) {
34397
+ if (isRecord$6(pkg.exports) && !hasSubpathKeys(pkg.exports)) {
34398
34398
  pkg.exports = { ".": pkg.exports };
34399
34399
  return true;
34400
34400
  }
34401
34401
  return false;
34402
34402
  }
34403
34403
  function isRecordObject(value) {
34404
- return isRecord$5(value);
34404
+ return isRecord$6(value);
34405
34405
  }
34406
34406
  function ensureSubpath(exports, subpath) {
34407
34407
  const existing = exports[subpath];
@@ -39970,7 +39970,7 @@ const VALID_RULE_LEVELS = /* @__PURE__ */ new Set([
39970
39970
  "warn",
39971
39971
  "error"
39972
39972
  ]);
39973
- function isRecord$4(value) {
39973
+ function isRecord$5(value) {
39974
39974
  return typeof value === "object" && value !== null && !Array.isArray(value);
39975
39975
  }
39976
39976
  function isRuleLevel$1(value) {
@@ -39995,13 +39995,13 @@ function parseRuleConfig(ruleId, value) {
39995
39995
  const level = value[0];
39996
39996
  if (!isRuleLevel$1(level)) throw new TypeError(`${formatRuleConfigLocation(ruleId)} level must be one of "off", "warn", or "error"`);
39997
39997
  const options = value[1];
39998
- if (!isRecord$4(options)) throw new TypeError(`${formatRuleConfigLocation(ruleId)} options must be an object`);
39998
+ if (!isRecord$5(options)) throw new TypeError(`${formatRuleConfigLocation(ruleId)} options must be an object`);
39999
39999
  return {
40000
40000
  level,
40001
40001
  options: { ...options }
40002
40002
  };
40003
40003
  }
40004
- if (isRecord$4(value)) return {
40004
+ if (isRecord$5(value)) return {
40005
40005
  level: "warn",
40006
40006
  options: { ...value }
40007
40007
  };
@@ -41135,7 +41135,7 @@ function applyCompileCompilerToTsSource(text, compiler) {
41135
41135
  if ((ts.isStringLiteral(validator.initializer) || ts.isNoSubstitutionTemplateLiteral(validator.initializer)) && validator.initializer.text === "shared") result = removePropertyFromObject(result, validator, afterCompiler);
41136
41136
  return result;
41137
41137
  }
41138
- function isRecord$3(value) {
41138
+ function isRecord$4(value) {
41139
41139
  return typeof value === "object" && value !== null && !Array.isArray(value);
41140
41140
  }
41141
41141
  /**
@@ -41143,7 +41143,7 @@ function isRecord$3(value) {
41143
41143
  */
41144
41144
  function applyCompileCompilerToJsonSource(text, compiler) {
41145
41145
  const root = JSON.parse(text);
41146
- const compile = isRecord$3(root.compile) ? { ...root.compile } : {};
41146
+ const compile = isRecord$4(root.compile) ? { ...root.compile } : {};
41147
41147
  compile.compiler = compiler;
41148
41148
  if (compiler === "native" && compile.validator === "shared") delete compile.validator;
41149
41149
  root.compile = compile;
@@ -43105,12 +43105,12 @@ function checkPnpmReleaseAgeExcludes(cwd, pm, workspaces = []) {
43105
43105
  for (const pattern of unnecessary) result.fixable.push(`pnpm-workspace.yaml minimumReleaseAgeExclude includes '${pattern}' but the repo does not use that scope`);
43106
43106
  return result;
43107
43107
  }
43108
- function isRecord$2(value) {
43108
+ function isRecord$3(value) {
43109
43109
  return typeof value === "object" && value !== null && !Array.isArray(value);
43110
43110
  }
43111
43111
  function isConfiguredValue(value) {
43112
43112
  if (value === void 0 || value === null) return false;
43113
- if (isRecord$2(value)) return Object.keys(value).length > 0;
43113
+ if (isRecord$3(value)) return Object.keys(value).length > 0;
43114
43114
  if (Array.isArray(value)) return value.length > 0;
43115
43115
  return value !== "";
43116
43116
  }
@@ -43138,8 +43138,8 @@ function formatOverrideWarning(location, keys) {
43138
43138
  function checkPnpmDependencyOverrides(cwd, pm, rootPkg) {
43139
43139
  const result = emptyResult$2();
43140
43140
  if (pm !== "pnpm") return result;
43141
- const packageJsonOverrides = (isRecord$2(rootPkg.pnpm) ? rootPkg.pnpm : void 0)?.overrides;
43142
- if (isConfiguredValue(packageJsonOverrides)) result.warnings.push(formatOverrideWarning("Root package.json pnpm.overrides field", isRecord$2(packageJsonOverrides) ? Object.keys(packageJsonOverrides) : []));
43141
+ const packageJsonOverrides = (isRecord$3(rootPkg.pnpm) ? rootPkg.pnpm : void 0)?.overrides;
43142
+ if (isConfiguredValue(packageJsonOverrides)) result.warnings.push(formatOverrideWarning("Root package.json pnpm.overrides field", isRecord$3(packageJsonOverrides) ? Object.keys(packageJsonOverrides) : []));
43143
43143
  const workspaceOverrides = readPnpmWorkspaceDocument(cwd)?.get("overrides");
43144
43144
  if (isConfiguredYamlNode(workspaceOverrides)) result.warnings.push(formatOverrideWarning("pnpm-workspace.yaml overrides field", configuredYamlKeys(workspaceOverrides)));
43145
43145
  return result;
@@ -45298,15 +45298,14 @@ const SKILLS_COMMANDS = [
45298
45298
  "init",
45299
45299
  "experimental_sync",
45300
45300
  "defaults",
45301
- "lint",
45302
- "updo"
45301
+ "lint"
45303
45302
  ].join("|");
45304
45303
  const NPX_SKILLS_PATTERN = new RegExp(String.raw`${COMMAND_PREFIX}npx(?:\s+-y)?\s+skills(?:@latest)?(?=\W|$)`, "g");
45305
45304
  const BARE_USAGE_SKILLS_PATTERN = new RegExp(String.raw`^(\s*(?:${ANSI_PREFIX})*Usage:(?:${ANSI_PREFIX})*\s*)skills(?=\s+<command>)`, "gm");
45306
45305
  const BARE_PROMPT_SKILLS_PATTERN = new RegExp(String.raw`^(\s*(?:${ANSI_PREFIX})*\$(?:${ANSI_PREFIX})*\s*)skills(?=\s+(?:${SKILLS_COMMANDS})(?:\W|$))`, "gm");
45307
45306
  const require$3 = createRequire(import.meta.url);
45308
45307
  const YES_FLAGS = /* @__PURE__ */ new Set(["-y", "--yes"]);
45309
- const SCOPE_FLAGS$1 = /* @__PURE__ */ new Set([
45308
+ const SCOPE_FLAGS = /* @__PURE__ */ new Set([
45310
45309
  "-g",
45311
45310
  "--global",
45312
45311
  "-p",
@@ -45333,7 +45332,7 @@ const needsSkillsInteractive = (args) => {
45333
45332
  if (command === void 0 || !INTERACTIVE_COMMANDS.has(command)) return false;
45334
45333
  switch (command) {
45335
45334
  case "update":
45336
- case "upgrade": return !hasSkillsFlag(tail, SCOPE_FLAGS$1) && !hasSkillsFlag(tail, YES_FLAGS) && skillsPositionalArgs(tail).length === 0;
45335
+ case "upgrade": return !hasSkillsFlag(tail, SCOPE_FLAGS) && !hasSkillsFlag(tail, YES_FLAGS) && skillsPositionalArgs(tail).length === 0;
45337
45336
  case "add":
45338
45337
  case "a":
45339
45338
  case "experimental_sync": return !hasSkillsFlag(tail, YES_FLAGS);
@@ -45418,6 +45417,7 @@ const ARIESTOOLS_SKILLS = [
45418
45417
  ];
45419
45418
  const XYO_STACK_SKILLS = [
45420
45419
  "xl1-build",
45420
+ "xl1-dapp-kit",
45421
45421
  "xl1-knowledge",
45422
45422
  "xl1-patterns",
45423
45423
  "xl1-scaffold",
@@ -45425,6 +45425,19 @@ const XYO_STACK_SKILLS = [
45425
45425
  "xyo-knowledge"
45426
45426
  ];
45427
45427
  /**
45428
+ * Skills that used to live in xyo-skills and now live in ariestools-skills.
45429
+ * `xy skills lint` reports (and `--fix` reinstalls) lockfile entries still on `from`.
45430
+ */
45431
+ const MIGRATED_SKILLS = [{
45432
+ from: XYO_SKILLS_SOURCE,
45433
+ name: "xy-development",
45434
+ to: ARIESTOOLS_SKILLS_SOURCE
45435
+ }, {
45436
+ from: XYO_SKILLS_SOURCE,
45437
+ name: "xy-toolchain",
45438
+ to: ARIESTOOLS_SKILLS_SOURCE
45439
+ }];
45440
+ /**
45428
45441
  All skills managed by `xy skills` conveniences (both sources).
45429
45442
  */
45430
45443
  const XYO_DEFAULT_SKILLS = [...ARIESTOOLS_SKILLS, ...XYO_STACK_SKILLS];
@@ -45473,6 +45486,7 @@ const SKILL_ORDER = [
45473
45486
  "xyo-knowledge",
45474
45487
  "xl1-knowledge",
45475
45488
  "xl1-patterns",
45489
+ "xl1-dapp-kit",
45476
45490
  "xl1-testing",
45477
45491
  "xl1-scaffold",
45478
45492
  "xl1-build"
@@ -45491,7 +45505,11 @@ const XL1_SKILLS = [
45491
45505
  "xl1-patterns",
45492
45506
  "xl1-testing"
45493
45507
  ];
45494
- const XL1_OPTIONAL_SKILLS = ["xl1-scaffold", "xl1-build"];
45508
+ const XL1_OPTIONAL_SKILLS = [
45509
+ "xl1-dapp-kit",
45510
+ "xl1-scaffold",
45511
+ "xl1-build"
45512
+ ];
45495
45513
  const TIER_REQUIRED_SKILLS = {
45496
45514
  xy: XY_SKILLS,
45497
45515
  xyo: [...XY_SKILLS, ...XYO_SKILLS],
@@ -51979,6 +51997,64 @@ const listSkillDirsAt = (root) => {
51979
51997
  return listSkillDirs(root);
51980
51998
  };
51981
51999
  //#endregion
52000
+ //#region src/actions/skills/lock.ts
52001
+ const SKILLS_LOCK_FILE = "skills-lock.json";
52002
+ const normalizeSkillSource = (source) => {
52003
+ return source.trim().replace(/^https?:\/\/github\.com\//i, "").replace(/^github:/i, "").replace(/\.git$/i, "").replace(/\/+$/, "").toLowerCase();
52004
+ };
52005
+ const isRecord$2 = (value) => {
52006
+ return typeof value === "object" && value !== null && !Array.isArray(value);
52007
+ };
52008
+ const parseLockEntry = (value) => {
52009
+ if (!isRecord$2(value) || typeof value.source !== "string" || value.source.length === 0) return void 0;
52010
+ return {
52011
+ computedHash: typeof value.computedHash === "string" ? value.computedHash : void 0,
52012
+ skillPath: typeof value.skillPath === "string" ? value.skillPath : void 0,
52013
+ source: value.source,
52014
+ sourceType: typeof value.sourceType === "string" ? value.sourceType : void 0
52015
+ };
52016
+ };
52017
+ const parseSkillsLock = (value) => {
52018
+ if (!isRecord$2(value) || !isRecord$2(value.skills)) return void 0;
52019
+ const skills = {};
52020
+ for (const [name, entry] of Object.entries(value.skills)) {
52021
+ const parsed = parseLockEntry(entry);
52022
+ if (parsed == null) continue;
52023
+ skills[name] = parsed;
52024
+ }
52025
+ return {
52026
+ skills,
52027
+ version: typeof value.version === "number" ? value.version : 1
52028
+ };
52029
+ };
52030
+ const readSkillsLock = (cwd) => {
52031
+ const lockPath = PATH.resolve(cwd, SKILLS_LOCK_FILE);
52032
+ if (!existsSync(lockPath)) return void 0;
52033
+ try {
52034
+ return parseSkillsLock(JSON.parse(readFileSync(lockPath, "utf8")));
52035
+ } catch {
52036
+ return;
52037
+ }
52038
+ };
52039
+ const unmigratedSkillsFromLock = (lock) => {
52040
+ if (lock == null) return [];
52041
+ const unmigrated = [];
52042
+ for (const skill of MIGRATED_SKILLS) {
52043
+ const entry = lock.skills[skill.name];
52044
+ if (entry == null) continue;
52045
+ if (normalizeSkillSource(entry.source) !== normalizeSkillSource(skill.from)) continue;
52046
+ unmigrated.push({
52047
+ currentSource: entry.source,
52048
+ expectedSource: skill.to,
52049
+ name: skill.name
52050
+ });
52051
+ }
52052
+ return unmigrated;
52053
+ };
52054
+ const findUnmigratedSkills = (cwd) => {
52055
+ return unmigratedSkillsFromLock(readSkillsLock(cwd));
52056
+ };
52057
+ //#endregion
51982
52058
  //#region src/actions/skills/versions.ts
51983
52059
  const VERSION_PATTERN = /metadata:\s*\n(?:[ \t]+[^\n]+\n)*?[ \t]+version:\s*([^\s#]+)/;
51984
52060
  const upstreamSkillUrl = (skillName) => {
@@ -52037,21 +52113,23 @@ const logWarning = (message) => {
52037
52113
  const logInfo = (message) => {
52038
52114
  console.log(chalk.gray(` \u{2139} ${message}`));
52039
52115
  };
52040
- const installMissingSkill = async (skillName) => {
52041
- return runSkills([
52042
- "add",
52043
- skillSourceForName(skillName),
52044
- "--skill",
52045
- skillName,
52046
- "-y"
52047
- ]);
52116
+ const createSkillInstaller = (cwd) => {
52117
+ return async (skillName) => {
52118
+ return runSkills([
52119
+ "add",
52120
+ skillSourceForName(skillName),
52121
+ "--skill",
52122
+ skillName,
52123
+ "-y"
52124
+ ], { cwd });
52125
+ };
52048
52126
  };
52049
52127
  const missingSkillReason = (profile, skillName) => {
52050
52128
  if (skillName === "ariestools-sdk" && profile.isUsingAriestoolsSdk) return "repo uses packages from ariestools/sdk-js";
52051
52129
  if (skillName === "xy-toolchain" && profile.isUsingToolchain) return "repo uses @ariestools/toolchain";
52052
52130
  return "required for repo profile";
52053
52131
  };
52054
- const checkRequiredSkills = (required, installed, latestVersions, profile, isOffline) => {
52132
+ const checkRequiredSkills = (required, installed, latestVersions) => {
52055
52133
  const current = [];
52056
52134
  const missing = [];
52057
52135
  const outdated = [];
@@ -52063,7 +52141,7 @@ const checkRequiredSkills = (required, installed, latestVersions, profile, isOff
52063
52141
  }
52064
52142
  const installedVersion = installedSkill.version;
52065
52143
  const latestVersion = latestVersions.get(skillName);
52066
- if (!isOffline && isSkillVersionOutdated(installedVersion, latestVersion)) {
52144
+ if (isSkillVersionOutdated(installedVersion, latestVersion)) {
52067
52145
  outdated.push({
52068
52146
  latest: latestVersion,
52069
52147
  name: skillName,
@@ -52083,6 +52161,11 @@ const checkRequiredSkills = (required, installed, latestVersions, profile, isOff
52083
52161
  outdated
52084
52162
  };
52085
52163
  };
52164
+ const resolveLatestSkillVersions = async (skillNames, options) => {
52165
+ if (options.latestVersions != null) return new Map(options.latestVersions);
52166
+ if (options.isOffline === true) return /* @__PURE__ */ new Map();
52167
+ return fetchLatestSkillVersions(skillNames);
52168
+ };
52086
52169
  const findDuplicateSkills = (cwd, globalDir) => {
52087
52170
  const projectClaudeDir = PATH.resolve(cwd, ".claude", "skills");
52088
52171
  const projectSkills = listSkillDirsAt(projectClaudeDir);
@@ -52113,22 +52196,22 @@ const skillDiagnostics = (rule, messages) => {
52113
52196
  rule
52114
52197
  }));
52115
52198
  };
52116
- const installMissingSkills = async (missing) => {
52199
+ const installSkills = async (skillNames, installSkill, heading, success) => {
52117
52200
  console.log();
52118
- console.log(chalk.gray("Installing missing required skills..."));
52119
- for (const skillName of missing) {
52120
- const code = await installMissingSkill(skillName);
52201
+ console.log(chalk.gray(heading));
52202
+ for (const skillName of skillNames) {
52203
+ const code = await installSkill(skillName);
52121
52204
  if (code !== 0) return code;
52122
52205
  }
52123
- console.log(chalk.green("Missing skills installed. Re-run `xy skills lint` to verify versions."));
52206
+ console.log(chalk.green(success));
52124
52207
  return 0;
52125
52208
  };
52126
52209
  const SKILLS_LINT_RULES = [
52127
52210
  {
52128
- check: async ({ missing, profile }, { fix }) => {
52211
+ check: async ({ installSkill, missing, profile }, { fix }) => {
52129
52212
  if (missing.length === 0) return {};
52130
52213
  if (fix) {
52131
- if (await installMissingSkills(missing) === 0) return { fixedCount: missing.length };
52214
+ if (await installSkills(missing, installSkill, "Installing missing required skills...", "Missing skills installed. Re-run `xy skills lint` to verify versions.") === 0) return { fixedCount: missing.length };
52132
52215
  }
52133
52216
  return { diagnostics: skillDiagnostics("skills.required-installed", missing.map((skillName) => `${skillName} — missing (${missingSkillReason(profile, skillName)})`)) };
52134
52217
  },
@@ -52138,11 +52221,35 @@ const SKILLS_LINT_RULES = [
52138
52221
  id: "skills.required-installed"
52139
52222
  },
52140
52223
  {
52141
- check: ({ outdated }) => ({ diagnostics: skillDiagnostics("skills.required-current", outdated.map((skill) => `${skill.name} v${skill.version ?? "unknown"} — outdated (latest ${skill.latest ?? "unknown"})`)) }),
52224
+ check: async ({ installSkill, outdated }, { fix }) => {
52225
+ if (outdated.length === 0) return {};
52226
+ if (fix) {
52227
+ if (await installSkills(outdated.map((skill) => skill.name), installSkill, "Updating outdated skills...", "Outdated skills updated. Re-run `xy skills lint` to verify versions.") === 0) return { fixedCount: outdated.length };
52228
+ }
52229
+ return { diagnostics: skillDiagnostics("skills.required-current", outdated.map((skill) => `${skill.name} v${skill.version ?? "unknown"} — outdated (latest ${skill.latest ?? "unknown"})`)) };
52230
+ },
52142
52231
  defaultLevel: "error",
52143
52232
  description: "Installed required skills are up to date",
52233
+ fixable: true,
52144
52234
  id: "skills.required-current"
52145
52235
  },
52236
+ {
52237
+ check: async ({ installSkill, unmigrated }, { fix }) => {
52238
+ if (unmigrated.length === 0) return {};
52239
+ if (fix) {
52240
+ if (await installSkills(unmigrated.map((skill) => skill.name), installSkill, "Migrating skills to canonical sources...", "Migrated skills reinstalled from ariestools/ariestools-skills. Re-run `xy skills lint` to verify versions.") === 0) return { fixedCount: unmigrated.length };
52241
+ }
52242
+ return { diagnostics: unmigrated.map((skill) => ({
52243
+ file: SKILLS_LOCK_FILE,
52244
+ message: `${skill.name} — installed from ${skill.currentSource}; migrate to ${skill.expectedSource}`,
52245
+ rule: "skills.migrated-source"
52246
+ })) };
52247
+ },
52248
+ defaultLevel: "error",
52249
+ description: "xy-development and xy-toolchain are installed from ariestools/ariestools-skills, not XYOracleNetwork/xyo-skills",
52250
+ fixable: true,
52251
+ id: "skills.migrated-source"
52252
+ },
52146
52253
  {
52147
52254
  check: ({ unnecessary }) => ({ diagnostics: skillDiagnostics("skills.unnecessary", unnecessary.map((skillName) => `${skillName} — installed but not required for this repo profile`)) }),
52148
52255
  defaultLevel: "warn",
@@ -52166,23 +52273,48 @@ function logCurrentRequiredSkills(requiredCheck) {
52166
52273
  logOk(`${skill.name}${versionSuffix}`);
52167
52274
  }
52168
52275
  }
52276
+ function logSkillsLintHints(diagnostics) {
52277
+ const hasMissingDiagnostic = diagnostics.some((diagnostic) => diagnostic.rule === "skills.required-installed");
52278
+ const hasMigratedDiagnostic = diagnostics.some((diagnostic) => diagnostic.rule === "skills.migrated-source");
52279
+ const hasOutdatedDiagnostic = diagnostics.some((diagnostic) => diagnostic.rule === "skills.required-current");
52280
+ if (!hasMissingDiagnostic && !hasMigratedDiagnostic && !hasOutdatedDiagnostic) return;
52281
+ const hints = [];
52282
+ const fixReasons = [];
52283
+ if (hasMissingDiagnostic) fixReasons.push("install missing required skills");
52284
+ if (hasMigratedDiagnostic) fixReasons.push("migrate xy-development and xy-toolchain to ariestools-skills");
52285
+ if (hasOutdatedDiagnostic) fixReasons.push("update outdated skills");
52286
+ if (fixReasons.length > 0) hints.push(`run \`xy skills lint --fix\` to ${fixReasons.join(" and ")}`);
52287
+ console.log(chalk.yellow(`${hints.join(", or ")}.`));
52288
+ }
52289
+ function reportSkillsLintResult(result, profile, optional, installed) {
52290
+ logOptionalSkills(profile.tier, optional, installed);
52291
+ console.log();
52292
+ const { diagnostics, fixedCount } = result.envelope.data;
52293
+ if (fixedCount === 0 && diagnostics.length === 0) {
52294
+ console.log(chalk.green("All required skills are installed and up to date."));
52295
+ return result;
52296
+ }
52297
+ logSkillsLintHints(diagnostics);
52298
+ return result;
52299
+ }
52169
52300
  const skillsLint = async (options = {}) => {
52170
52301
  const cwd = options.cwd ?? INIT_CWD();
52171
52302
  const projectDirs = options.projectDirs ?? [...PROJECT_SKILL_DIRS];
52172
52303
  const globalDir = options.globalDir ?? DEFAULT_GLOBAL_DIR;
52173
- const isOffline = options.isOffline === true;
52174
52304
  const isStrict = options.isStrict === true || options.strict === true;
52175
52305
  const profile = detectRepoProfile(cwd);
52176
52306
  const required = requiredSkillsForProfile(profile);
52177
52307
  const optional = optionalSkillsForTier(profile.tier);
52178
52308
  const installed = scanInstalledSkills(cwd, projectDirs);
52179
52309
  logProfileHeader(profile);
52180
- const latestVersions = isOffline ? /* @__PURE__ */ new Map() : await fetchLatestSkillVersions(collectSkillNamesToCheck(required, installed));
52181
- const requiredCheck = checkRequiredSkills(required, installed, latestVersions, profile, isOffline);
52310
+ const latestVersions = await resolveLatestSkillVersions(collectSkillNamesToCheck(required, installed), options);
52311
+ const requiredCheck = checkRequiredSkills(required, installed, latestVersions);
52182
52312
  logCurrentRequiredSkills(requiredCheck);
52183
52313
  const unnecessary = collectUnnecessarySkills(profile, installed);
52184
52314
  const duplicates = findDuplicateSkills(cwd, globalDir);
52185
- const result = await runRuleChecks({
52315
+ const unmigrated = findUnmigratedSkills(cwd);
52316
+ const installSkill = options.installSkill ?? createSkillInstaller(cwd);
52317
+ return reportSkillsLintResult(await runRuleChecks({
52186
52318
  commandName: "skills lint",
52187
52319
  configKey: "skillsLint",
52188
52320
  config: await loadWorkspaceCommandConfig(cwd, "skillsLint"),
@@ -52190,31 +52322,18 @@ const skillsLint = async (options = {}) => {
52190
52322
  cwd,
52191
52323
  duplicates,
52192
52324
  globalDir,
52325
+ installSkill,
52193
52326
  missing: requiredCheck.missing,
52194
52327
  outdated: requiredCheck.outdated,
52195
52328
  profile,
52329
+ unmigrated,
52196
52330
  unnecessary
52197
52331
  },
52198
52332
  fix: options.fix === true,
52199
52333
  reporter: { diagnostic: logSkillsDiagnostic },
52200
52334
  rules: SKILLS_LINT_RULES,
52201
52335
  strict: isStrict
52202
- });
52203
- logOptionalSkills(profile.tier, optional, installed);
52204
- console.log();
52205
- if (result.envelope.data.diagnostics.length === 0 && result.envelope.data.fixedCount === 0) {
52206
- console.log(chalk.green("All required skills are installed and up to date."));
52207
- return result;
52208
- }
52209
- const hasMissingDiagnostic = result.envelope.data.diagnostics.some((diagnostic) => diagnostic.rule === "skills.required-installed");
52210
- const hasOutdatedDiagnostic = result.envelope.data.diagnostics.some((diagnostic) => diagnostic.rule === "skills.required-current");
52211
- if (hasMissingDiagnostic || hasOutdatedDiagnostic) {
52212
- const hints = [];
52213
- if (hasMissingDiagnostic) hints.push("run `xy skills lint --fix` to install missing required skills");
52214
- if (hasOutdatedDiagnostic) hints.push("run `xy skills updo` to update outdated skills");
52215
- console.log(chalk.yellow(`${hints.join(", or ")}.`));
52216
- }
52217
- return result;
52336
+ }), profile, optional, installed);
52218
52337
  };
52219
52338
  //#endregion
52220
52339
  //#region src/actions/work/id.ts
@@ -53853,21 +53972,6 @@ const sitemap = () => {
53853
53972
  return runSteps("Sitemap", [["ts-node-script", "./scripts/sitemap.ts"]]);
53854
53973
  };
53855
53974
  //#endregion
53856
- //#region src/actions/skills/updo.ts
53857
- const SCOPE_FLAGS = /* @__PURE__ */ new Set([
53858
- "-g",
53859
- "--global",
53860
- "-p",
53861
- "--project"
53862
- ]);
53863
- const hasSkillsScopeFlag = (args) => args.some((a) => SCOPE_FLAGS.has(a));
53864
- const skillsUpdoArgs = (args) => {
53865
- return ["update", ...hasSkillsScopeFlag(args) ? args : ["-p", ...args]];
53866
- };
53867
- const skillsUpdo = (args) => {
53868
- return runSkills(skillsUpdoArgs(args));
53869
- };
53870
- //#endregion
53871
53975
  //#region src/actions/sonar.ts
53872
53976
  const sonar = () => {
53873
53977
  return runSteps("Sonar", [["eslint", [
@@ -55451,11 +55555,7 @@ const secureCommand = {
55451
55555
  };
55452
55556
  //#endregion
55453
55557
  //#region src/xy/common/skills/index.ts
55454
- const CUSTOM_SKILLS_COMMANDS = /* @__PURE__ */ new Set([
55455
- "defaults",
55456
- "lint",
55457
- "updo"
55458
- ]);
55558
+ const CUSTOM_SKILLS_COMMANDS = /* @__PURE__ */ new Set(["defaults", "lint"]);
55459
55559
  const HELP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h"]);
55460
55560
  const hasHelpFlag = (args) => args.some((arg) => HELP_FLAGS.has(arg));
55461
55561
  const printDefaultsHelp = () => {
@@ -55501,34 +55601,20 @@ Checks:
55501
55601
  - Detect repo tier (xy, xyo, xl1) from package.json and toolchain signals
55502
55602
  - Require ariestools-sdk when packages from ariestools/sdk-js are used
55503
55603
  - Required skills installed in .claude/skills and/or .agents/skills
55604
+ - xy-development and xy-toolchain are locked to ariestools-skills, not xyo-skills
55504
55605
  - Installed skill versions vs upstream main
55505
55606
  (ariestools/ariestools-skills for xy/ariestools-sdk skills;
55506
55607
  XYOracleNetwork/xyo-skills for xyo/xl1 skills)
55507
55608
  - Project/global duplicate installs
55508
55609
 
55509
55610
  Options:
55510
- --fix Install missing required skills (project scope)
55611
+ --fix Install missing, migrate relocated, and update outdated skills (project scope)
55511
55612
  --offline Skip upstream version checks
55512
55613
  --rules List supported skills lint rules and their effective levels
55513
55614
  --strict Fail on warnings (duplicates, unnecessary skills)
55514
55615
  -h, --help Show this help
55515
55616
  `);
55516
55617
  };
55517
- const printUpdoHelp = () => {
55518
- console.log(`xy skills updo
55519
-
55520
- Update installed Skills.sh skills. Defaults to project scope.
55521
-
55522
- Usage:
55523
- xy skills updo [skills..] [options]
55524
-
55525
- Options:
55526
- -g, --global Update global skills instead of project skills
55527
- -p, --project Update project skills (default)
55528
- -y, --yes Skip confirmation prompts
55529
- -h, --help Show this help
55530
- `);
55531
- };
55532
55618
  const runSkillsTail = async (tail) => {
55533
55619
  const [subcommand, ...args] = tail;
55534
55620
  if (subcommand === "defaults" && hasHelpFlag(args)) {
@@ -55539,10 +55625,6 @@ const runSkillsTail = async (tail) => {
55539
55625
  printLintHelp();
55540
55626
  return 0;
55541
55627
  }
55542
- if (subcommand === "updo" && hasHelpFlag(args)) {
55543
- printUpdoHelp();
55544
- return 0;
55545
- }
55546
55628
  if (subcommand === "defaults") return skillsDefaults(args);
55547
55629
  if (subcommand === "lint") {
55548
55630
  if (args.includes("--rules")) return ruleCatalogResult(await getSkillsLintRuleCatalog(), RULE_COMMANDS.skillsLint.title);
@@ -55553,7 +55635,6 @@ const runSkillsTail = async (tail) => {
55553
55635
  }
55554
55636
  return skillsLint(parseLintArgs(args));
55555
55637
  }
55556
- if (subcommand === "updo") return skillsUpdo(args);
55557
55638
  return runSkills(tail);
55558
55639
  };
55559
55640
  const skillsCommand = {
@@ -55565,7 +55646,7 @@ const skillsCommand = {
55565
55646
  }).help(false).strict(false).version(false);
55566
55647
  },
55567
55648
  command: "skills [args..]",
55568
- describe: "Manage agent skills via the bundled Skills.sh CLI; forwards unknown commands and adds XY conveniences: defaults, lint, updo",
55649
+ describe: "Manage agent skills via the bundled Skills.sh CLI; forwards unknown commands and adds XY conveniences: defaults, lint",
55569
55650
  handler: async () => {
55570
55651
  const tail = argvAfterCommand("skills");
55571
55652
  await withEnvelope(CUSTOM_SKILLS_COMMANDS.has(tail[0] ?? "") ? `skills ${tail[0]}` : "skills", () => runSkillsTail(tail));