@alessandroraffa/tangyr 0.10.0 → 0.11.0

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) {
@@ -26497,6 +26501,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;
@@ -28867,12 +28872,13 @@ function runSyncCommand(options, logger) {
     printManifestDiff(logger, kitInfo.name, kitSync.diff);
   }
   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) {
     if (target === "claude-code") {
-      const claudeRoots = syncOptions.scope === "global" && allMappings ? resolveClaudeGlobalRoots({
-        flag: options.claudeConfigDir,
-        config: config.claudeCodeGlobalPaths
-      }) : void 0;
       if (claudeRoots && claudeRoots.length > 1) {
         for (const claudeRoot of claudeRoots) {
           logger.info(`  claude-code: syncing root ${claudeRoot}`);
@@ -28990,9 +28996,6 @@ function runSyncCommand(options, logger) {
   }
   writeLossReport(options.lossReport, lossReport);
   printOutcomeTable(results);
-  exitOnErrorSeverityLoss(lossReport, logger, {
-    ignoreErrors: options.ignoreErrors ?? false
-  });
   if (kitInfo && kitSync && !options.dryRun) {
     cleanupRemovedManagedArtifacts(
       config,
@@ -29002,11 +29005,17 @@ function runSyncCommand(options, logger) {
       kitSync.diff.removed,
       logger
     );
+    if (claudeRoots && claudeRoots.length > 0) {
+      kitSync.manifest.claudeCodeGlobalRoots = claudeRoots;
+    }
     updateManifest(kitInfo, kitSync);
     logger.info(
       `Sync complete for kit '${kitInfo.name}': ${kitSync.diff.added.length} added, ${kitSync.diff.modified.length} modified, ${kitSync.diff.removed.length} removed, ${kitSync.diff.unchanged.length} unchanged.`
     );
   }
+  exitOnErrorSeverityLoss(lossReport, logger, {
+    ignoreErrors: options.ignoreErrors ?? false
+  });
 }
 function toSyncOptions(options, config) {
   const component = options.component ? validateComponent(options.component) : void 0;

package/package.json

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