@alessandroraffa/tangyr 0.10.1 → 0.11.1

package/README.md

@@ -107,13 +107,24 @@ claudeCodeGlobalPaths:
   - ~/.claude-work
 ```
 
-**Via CLI flag** (repeatable, overrides the config field):
+**Via environment variable** (`TANGYR_CLAUDE_CONFIG_DIRS`):
+
+A colon-separated list of Claude Code global root directories. Entries support `~/` expansion. This layer is designed for machine-specific configuration that must not be committed to a shared kit config.
+
+```sh
+export TANGYR_CLAUDE_CONFIG_DIRS="~/.claude:~/.claude-work"
+tangyr sync
+```
+
+Auto-sync use case: if a kit-change hook or automation runs `tangyr sync`, exporting `TANGYR_CLAUDE_CONFIG_DIRS` in the shell environment keeps multiple Claude configs in sync automatically — without putting machine-specific paths in a shared `tangyr.config.yaml`.
+
+**Via CLI flag** (repeatable):
 
 ```sh
 tangyr sync --claude-config-dir ~/.claude --claude-config-dir ~/.claude-work
 ```
 
-Precedence: `--claude-config-dir` flag > `claudeCodeGlobalPaths` in config > default `~/.claude`.
+Precedence: `--claude-config-dir` flag > `TANGYR_CLAUDE_CONFIG_DIRS` env > `claudeCodeGlobalPaths` in config > default `~/.claude`.
 
 Per-root artifacts (instructions, agents, skills, commands, rules, output-styles, hooks settings) are written under each root. Shared artifacts (`~/.claude.json` for MCP, `~/.agents/hooks` for hooks) are resolved from the platform default and written once regardless of how many roots are configured.
 

package/dist/index.js

@@ -15644,8 +15644,12 @@ function resolveClineProfile(scope, projectRoot, mappings) {
   };
 }
 var DEFAULT_CLAUDE_ROOT_RAW = "~/.claude";
+function parseEnvDirs(raw) {
+  return raw.split(":").map((s) => s.trim()).filter((s) => s.length > 0);
+}
 function resolveClaudeGlobalRoots(input) {
-  const rawRoots = (input.flag?.length ?? 0) > 0 ? input.flag : (input.config?.length ?? 0) > 0 ? input.config : [DEFAULT_CLAUDE_ROOT_RAW];
+  const envEntries = input.env !== void 0 ? parseEnvDirs(input.env) : void 0;
+  const rawRoots = (input.flag?.length ?? 0) > 0 ? input.flag : envEntries !== void 0 && envEntries.length > 0 ? envEntries : (input.config?.length ?? 0) > 0 ? input.config : [DEFAULT_CLAUDE_ROOT_RAW];
   const seen = /* @__PURE__ */ new Set();
   const roots = [];
   for (const raw of rawRoots) {
@@ -20135,7 +20139,7 @@ import path17 from "path";
 var import_yaml5 = __toESM(require_dist(), 1);
 import fs16 from "fs";
 import path16 from "path";
-function resolveKitHookNames(sourceRoot) {
+function resolveKitComponentNames(sourceRoot, category) {
   const manifestPath = path16.resolve(sourceRoot, "tangyr-kit.yaml");
   if (!fs16.existsSync(manifestPath)) {
     return void 0;
@@ -20145,10 +20149,10 @@ function resolveKitHookNames(sourceRoot) {
     const doc = (0, import_yaml5.parse)(raw);
     if (doc && typeof doc === "object" && !Array.isArray(doc) && "components" in doc) {
       const components = doc.components;
-      if (components && typeof components === "object" && !Array.isArray(components) && "hooks" in components) {
-        const hooks = components.hooks;
-        if (Array.isArray(hooks) && hooks.every((h) => typeof h === "string")) {
-          return hooks;
+      if (components && typeof components === "object" && !Array.isArray(components) && category in components) {
+        const names = components[category];
+        if (Array.isArray(names) && names.every((n7) => typeof n7 === "string")) {
+          return names;
         }
       }
     }
@@ -20156,6 +20160,12 @@ function resolveKitHookNames(sourceRoot) {
   }
   return void 0;
 }
+function resolveKitHookNames(sourceRoot) {
+  return resolveKitComponentNames(sourceRoot, "hooks");
+}
+function resolveKitSkillNames(sourceRoot) {
+  return resolveKitComponentNames(sourceRoot, "skills");
+}
 function resolveHooksSourceFile(sourceRoot, config) {
   return path16.resolve(sourceRoot, config.source.hooks, "hooks.json");
 }
@@ -26497,6 +26507,7 @@ function installForTool(tool, config, kitInfo, manifest, options, mappings, logg
   );
   const claudeRoots = scope === "global" && mappings ? resolveClaudeGlobalRoots({
     flag: options.claudeConfigDir,
+    env: process.env.TANGYR_CLAUDE_CONFIG_DIRS,
     config: config.claudeCodeGlobalPaths
   }) : void 0;
   let count = 0;
@@ -28414,12 +28425,6 @@ function buildDirectComponents(profile) {
       destination: profile.agents,
       type: "dir"
     },
-    {
-      component: "skills",
-      sourceKey: "skills",
-      destination: profile.skills,
-      type: "dir"
-    },
     {
       component: "commands",
       sourceKey: "commands",
@@ -28485,6 +28490,19 @@ function syncClaudeCode(config, sourceRoot, options, logger, mappings, manifest,
       )
     );
   }
+  if (!shouldSkipComponent6(options, "skills")) {
+    outcomes.push(
+      ...syncClaudeCodeSkills(
+        config,
+        sourceRoot,
+        options,
+        logger,
+        profile.skills,
+        manifest,
+        scopePath
+      )
+    );
+  }
   if (!shouldSkipComponent6(options, "instructions") && manifest && scopePath) {
     const shimPath = profile.instructions_shim;
     const agentsMdPath = path36.resolve(sourceRoot, config.source.instructions);
@@ -28657,6 +28675,128 @@ function syncDirectComponent(config, sourceRoot, options, logger, directComponen
     path: destination
   };
 }
+function syncClaudeCodeSkills(config, sourceRoot, options, logger, destination, manifest, scopePath) {
+  const source = path36.resolve(sourceRoot, config.source.skills);
+  if (!fs34.existsSync(source)) {
+    return [skippedMissingSource6("skills", source)];
+  }
+  const declaredNames = resolveKitSkillNames(sourceRoot);
+  const isLegacyWholesaleSymlink = isSymlinkPath(destination);
+  if (options.dryRun) {
+    const outcomes2 = [];
+    if (isLegacyWholesaleSymlink) {
+      for (const name of foreignSkillNames(source, declaredNames)) {
+        logger.info(
+          `[dry-run] skills: migrate foreign skill ${path36.join(source, name)} -> ${path36.join(destination, name)}`
+        );
+      }
+      logger.info(
+        `[dry-run] skills: replace wholesale symlink with real directory ${destination}`
+      );
+    }
+    for (const name of declaredNames ?? listSkillDirNames(source)) {
+      const skillDestination = path36.join(destination, name);
+      logger.info(
+        `[dry-run] skills: symlink ${path36.join(source, name)} -> ${skillDestination}`
+      );
+      outcomes2.push({
+        component: "skills",
+        status: "dry-run",
+        path: skillDestination
+      });
+    }
+    return outcomes2;
+  }
+  if (isLegacyWholesaleSymlink) {
+    migrateWholesaleSkillsSymlink(source, destination, declaredNames, logger);
+  }
+  ensureDir(destination);
+  const outcomes = [];
+  for (const name of declaredNames ?? listSkillDirNames(source)) {
+    outcomes.push(
+      syncSingleSkill(
+        config,
+        sourceRoot,
+        options,
+        logger,
+        source,
+        destination,
+        name,
+        manifest,
+        scopePath
+      )
+    );
+  }
+  return outcomes;
+}
+function syncSingleSkill(config, sourceRoot, options, logger, source, destination, name, manifest, scopePath) {
+  const skillSource = path36.join(source, name);
+  const skillDestination = path36.join(destination, name);
+  if (!fs34.existsSync(skillSource)) {
+    return skippedMissingSource6("skills", skillSource);
+  }
+  const artifactClass = classifyArtifact(skillDestination, config, sourceRoot);
+  if (artifactClass === "managed-symlink" && isSymlinkTo6(skillDestination, skillSource)) {
+    return {
+      component: "skills",
+      status: "skipped-current",
+      path: skillDestination
+    };
+  }
+  if (artifactClass === "managed-stale" && isOurStaleSymlink(skillDestination, /* @__PURE__ */ new Set([skillDestination]), config)) {
+    fs34.unlinkSync(skillDestination);
+  } else if (artifactClass === "unmanaged-conflict" && !handleConflict6(
+    skillDestination,
+    config,
+    options,
+    logger,
+    manifest,
+    scopePath
+  )) {
+    return { component: "skills", status: "conflict", path: skillDestination };
+  } else if (artifactClass === "managed-symlink") {
+    fs34.unlinkSync(skillDestination);
+  }
+  createRelativeSymlink(skillSource, skillDestination, "dir");
+  return { component: "skills", status: "success", path: skillDestination };
+}
+function migrateWholesaleSkillsSymlink(source, destination, declaredNames, logger) {
+  const foreignNames = foreignSkillNames(source, declaredNames);
+  fs34.unlinkSync(destination);
+  ensureDir(destination);
+  for (const name of foreignNames) {
+    const from = path36.join(source, name);
+    const to = path36.join(destination, name);
+    if (fs34.existsSync(to)) {
+      logger.warn(
+        `skills migration: ${to} already exists \u2014 skipping move of ${from} to avoid overwrite`
+      );
+      continue;
+    }
+    fs34.renameSync(from, to);
+    logger.info(`skills migration: moved ${from} -> ${to}`);
+  }
+}
+function foreignSkillNames(source, declaredNames) {
+  if (!declaredNames) {
+    return [];
+  }
+  const declaredSet = new Set(declaredNames);
+  return listSkillDirNames(source).filter((name) => !declaredSet.has(name));
+}
+function listSkillDirNames(dir) {
+  if (!fs34.existsSync(dir)) {
+    return [];
+  }
+  return fs34.readdirSync(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.name.startsWith(".")).map((entry) => entry.name);
+}
+function isSymlinkPath(filePath) {
+  try {
+    return fs34.lstatSync(filePath).isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
 function syncHookScriptsBridge(config, sourceRoot, options, logger, destination, manifest, scopePath) {
   const source = path36.resolve(sourceRoot, config.source.hooks);
   if (!fs34.existsSync(source)) {
@@ -28869,6 +29009,7 @@ function runSyncCommand(options, logger) {
   const allMappings = mappings ?? (targets.includes("claude-code") ? loadMappings(sourceRoot, config, configDir) : void 0);
   const claudeRoots = targets.includes("claude-code") && syncOptions.scope === "global" && allMappings ? resolveClaudeGlobalRoots({
     flag: options.claudeConfigDir,
+    env: process.env.TANGYR_CLAUDE_CONFIG_DIRS,
     config: config.claudeCodeGlobalPaths
   }) : void 0;
   for (const target of targets) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alessandroraffa/tangyr",
-  "version": "0.10.1",
+  "version": "0.11.1",
   "description": "CLI for the Tangyr discipline — install and manage operating kits for AI coding tools",
   "license": "MIT",
   "type": "module",