agentsmesh 0.21.0 → 0.23.0

package/dist/canonical.js

@@ -1,5 +1,6 @@
 import { join, basename, dirname, relative, extname, resolve, posix, win32 } from 'path';
 import { access, readdir, readFile, realpath, stat, rm, mkdir, lstat, unlink, writeFile, rename, chmod, mkdtemp, cp } from 'fs/promises';
+import { setTimeout } from 'timers/promises';
 import { constants, existsSync, realpathSync, statSync } from 'fs';
 import { stringify, parse } from 'yaml';
 import { z } from 'zod';
@@ -220,6 +221,27 @@ var init_fs_traverse = __esm({
     MAX_SEGMENT_REPETITIONS = 3;
   }
 });
+async function renameWithRetry(from, to, options = {}) {
+  const attempts = options.attempts ?? 5;
+  const delayMs = options.delayMs ?? 50;
+  for (let attempt = 0; ; attempt++) {
+    try {
+      await rename(from, to);
+      return;
+    } catch (err) {
+      const code = err.code;
+      const transient = code !== void 0 && TRANSIENT_RENAME_CODES.has(code);
+      if (!transient || attempt >= attempts - 1) throw err;
+      await setTimeout(delayMs * 2 ** attempt);
+    }
+  }
+}
+var TRANSIENT_RENAME_CODES;
+var init_rename_retry = __esm({
+  "src/utils/filesystem/rename-retry.ts"() {
+    TRANSIENT_RENAME_CODES = /* @__PURE__ */ new Set(["EPERM", "EACCES", "EBUSY", "ENOTEMPTY", "EEXIST"]);
+  }
+});
 async function readFileSafe(path) {
   try {
     const data = await readFile(path, "utf-8");
@@ -306,6 +328,7 @@ var init_fs = __esm({
     init_fs_text_encoding();
     init_fs_traverse();
     init_fs_text_encoding();
+    init_rename_retry();
   }
 });
 function parseFrontmatter(content) {
@@ -487,7 +510,7 @@ function validateCapabilityImplementations(descriptor31, capabilities17, ctx, pa
     });
   }
 }
-var capabilityLevelSchema, capabilitiesSchema, generatorsSchema, pathResolversSchema, layoutSchema, globalSupportSchema, legacyGlobalKeys, generatorRequirements, settingsBackedFeatures, conversionDefaultsSchema, metadataSchema, targetDescriptorSchemaBase;
+var capabilityLevelSchema, capabilitiesSchema, generatorsSchema, pathResolversSchema, layoutSchema, globalSupportSchema, legacyGlobalKeys, generatorRequirements, settingsBackedFeatures, conversionDefaultsSchema, metadataSchema, nativePickStrategySchema, nativeInstallSchema, targetDescriptorSchemaBase;
 var init_target_descriptor_schema = __esm({
   "src/targets/catalog/target-descriptor.schema.ts"() {
     capabilityLevelSchema = z.union([
@@ -561,6 +584,22 @@ var init_target_descriptor_schema = __esm({
       officialUrl: z.string().min(1),
       shortDescription: z.string().min(1)
     }).passthrough();
+    nativePickStrategySchema = z.discriminatedUnion("kind", [
+      z.object({ kind: z.literal("basename"), suffix: z.string().min(1) }),
+      z.object({ kind: z.literal("skillDir") }),
+      z.object({ kind: z.literal("firstSegment") })
+    ]);
+    nativeInstallSchema = z.object({
+      pickPaths: z.array(
+        z.object({
+          prefix: z.string().min(1),
+          feature: z.enum(["commands", "rules", "agents", "skills"]),
+          strategy: nativePickStrategySchema
+        })
+      ).optional(),
+      inferPick: z.function().optional(),
+      dialectHints: z.array(z.object({ frontmatterKey: z.string().min(1) })).optional()
+    }).strict();
     targetDescriptorSchemaBase = z.object({
       id: z.string().regex(/^[a-z][a-z0-9-]*$/, "Target id must be lowercase with hyphens"),
       metadata: metadataSchema,
@@ -572,6 +611,7 @@ var init_target_descriptor_schema = __esm({
       globalSupport: globalSupportSchema.optional(),
       buildImportPaths: z.function(),
       detectionPaths: z.array(z.string()),
+      nativeInstall: nativeInstallSchema.optional(),
       excludeFromStarterInit: z.boolean().optional(),
       conversionDefaults: conversionDefaultsSchema.optional(),
       emitScopedSettings: z.function().optional(),
@@ -1050,7 +1090,7 @@ ${legacy}`, "");
   }
   return result.trim();
 }
-var ROOT_INSTRUCTION_BODY_V1, ROOT_INSTRUCTION_BODY_V2, ROOT_INSTRUCTION_BODY_V3, ROOT_INSTRUCTION_BODY_V4, ROOT_INSTRUCTION_BODY_V5, ROOT_INSTRUCTION_BODY_V6, ROOT_INSTRUCTION_BODY_V7, ROOT_INSTRUCTION_BODY_V8, ROOT_INSTRUCTION_BODY, LEGACY_AGENTSMESH_ROOT_INSTRUCTION_PARAGRAPH, LEGACY_AGENTSMESH_ROOT_INSTRUCTION_SECTION, AGENTSMESH_CONTRACT_WITH_V1_BODY, AGENTSMESH_CONTRACT_WITH_V2_BODY, AGENTSMESH_CONTRACT_WITH_V3_BODY, AGENTSMESH_CONTRACT_WITH_V4_BODY, AGENTSMESH_CONTRACT_WITH_V5_BODY, AGENTSMESH_CONTRACT_WITH_V6_BODY, AGENTSMESH_CONTRACT_WITH_V7_BODY, AGENTSMESH_CONTRACT_WITH_V8_BODY, AGENTSMESH_ROOT_INSTRUCTION_PARAGRAPH, LEGACY_FORMS;
+var ROOT_INSTRUCTION_BODY_V1, ROOT_INSTRUCTION_BODY_V2, ROOT_INSTRUCTION_BODY_V3, ROOT_INSTRUCTION_BODY_V4, ROOT_INSTRUCTION_BODY_V5, ROOT_INSTRUCTION_BODY_V6, ROOT_INSTRUCTION_BODY_V7, ROOT_INSTRUCTION_BODY_V8, ROOT_INSTRUCTION_BODY_V9, ROOT_INSTRUCTION_BODY_V10, ROOT_INSTRUCTION_BODY, LEGACY_AGENTSMESH_ROOT_INSTRUCTION_PARAGRAPH, LEGACY_AGENTSMESH_ROOT_INSTRUCTION_SECTION, AGENTSMESH_CONTRACT_WITH_V1_BODY, AGENTSMESH_CONTRACT_WITH_V2_BODY, AGENTSMESH_CONTRACT_WITH_V3_BODY, AGENTSMESH_CONTRACT_WITH_V4_BODY, AGENTSMESH_CONTRACT_WITH_V5_BODY, AGENTSMESH_CONTRACT_WITH_V6_BODY, AGENTSMESH_CONTRACT_WITH_V7_BODY, AGENTSMESH_CONTRACT_WITH_V8_BODY, AGENTSMESH_CONTRACT_WITH_V9_BODY, AGENTSMESH_CONTRACT_WITH_V10_BODY, AGENTSMESH_ROOT_INSTRUCTION_PARAGRAPH, LEGACY_FORMS;
 var init_root_instruction_paragraph = __esm({
   "src/targets/projection/root-instruction-paragraph.ts"() {
     init_managed_blocks();
@@ -1062,7 +1102,9 @@ var init_root_instruction_paragraph = __esm({
     ROOT_INSTRUCTION_BODY_V6 = "Create canonical files in `.agentsmesh`: `rules/_root.md` and `rules/*.md` are Markdown rules; `commands/*.md`, `agents/*.md`, and `skills/*/SKILL.md` plus supporting files use Claude-style frontmatter Markdown; `mcp.json` is MCP JSON; `hooks.yaml` and `permissions.yaml` are YAML; `ignore` is gitignore-style text. Then run `agentsmesh generate`.";
     ROOT_INSTRUCTION_BODY_V7 = "`.agentsmesh` is the only folder you edit or add these files in: `rules/_root.md` and `rules/*.md` are Markdown rules; `commands/*.md`, `agents/*.md`, and `skills/*/SKILL.md` plus supporting files use Claude-style frontmatter Markdown; `mcp.json` is MCP JSON; `hooks.yaml` and `permissions.yaml` are YAML; `ignore` is gitignore-style text. Do not edit generated tool files; run `agentsmesh generate`.";
     ROOT_INSTRUCTION_BODY_V8 = "`agentsmesh.yaml` selects targets/features (`agentsmesh.local.yaml` overrides locally), and `.agentsmesh` is the only place to add or edit canonical items: `rules/_root.md`, `rules/*.md`, `commands/*.md`, `agents/*.md`, `skills/*/SKILL.md` plus supporting files, `mcp.json`, `hooks.yaml`, `permissions.yaml`, and `ignore`; if missing run `agentsmesh init`, use `agentsmesh import --from <tool>` for native configs, `agentsmesh install <source>` or `install --sync` for reusable packs, then run `agentsmesh generate`. Use `diff`, `lint`, `check`, `watch`, `matrix`, and `merge` as needed; never edit generated tool files.";
-    ROOT_INSTRUCTION_BODY = "`agentsmesh.yaml` selects targets/features (`agentsmesh.local.yaml` overrides locally), and `.agentsmesh` is the only place to add or edit canonical items: `rules/_root.md`, `rules/*.md`, `commands/*.md`, `agents/*.md`, `skills/*/SKILL.md` plus supporting files, `mcp.json`, `hooks.yaml`, `permissions.yaml`, and `ignore`; if missing run `agentsmesh init`, use `agentsmesh import --from <tool>` for native configs, `agentsmesh install <source>` or `install --sync` for reusable packs, then run `agentsmesh generate`. Use `diff`, `lint`, `check`, `watch`, `matrix`, `merge`, and `refresh` as needed; never edit generated tool files.";
+    ROOT_INSTRUCTION_BODY_V9 = "`agentsmesh.yaml` selects targets/features (`agentsmesh.local.yaml` overrides locally), and `.agentsmesh` is the only place to add or edit canonical items: `rules/_root.md`, `rules/*.md`, `commands/*.md`, `agents/*.md`, `skills/*/SKILL.md` plus supporting files, `mcp.json`, `hooks.yaml`, `permissions.yaml`, and `ignore`; if missing run `agentsmesh init`, use `agentsmesh import --from <tool>` for native configs, `agentsmesh install <source>` or `install --sync` for reusable packs, then run `agentsmesh generate`. Use `diff`, `lint`, `check`, `watch`, `matrix`, `merge`, and `refresh` as needed; never edit generated tool files.";
+    ROOT_INSTRUCTION_BODY_V10 = "**MUST follow when changing any rule, agent, command, skill, hook, MCP server, permission, or ignore pattern.** `agentsmesh.yaml` selects targets/features (`agentsmesh.local.yaml` overrides locally), and `.agentsmesh` is the only place to add or edit canonical items: `rules/_root.md`, `rules/*.md`, `commands/*.md`, `agents/*.md`, `skills/*/SKILL.md` plus supporting files, `mcp.json`, `hooks.yaml`, `permissions.yaml`, and `ignore`; if missing run `agentsmesh init`, use `agentsmesh import --from <tool>` for native configs, `agentsmesh install <source>` or `install --sync` for reusable packs, then run `agentsmesh generate`. Use `diff`, `lint`, `check`, `watch`, `matrix`, `merge`, and `refresh` as needed; never edit generated tool files.";
+    ROOT_INSTRUCTION_BODY = "**NEVER edit generated files** (`.claude/`, `.cursor/`, `AGENTS.md`, `.github/copilot-instructions.md`, and similar target outputs) \u2014 `agentsmesh generate` overwrites them. **All changes MUST go through `.agentsmesh` first**: edit `rules/_root.md`, `rules/*.md`, `commands/*.md`, `agents/*.md`, `skills/*/SKILL.md` plus supporting files, `mcp.json`, `hooks.yaml`, `permissions.yaml`, and `ignore`; `agentsmesh.yaml` selects targets/features (`agentsmesh.local.yaml` overrides locally); if missing run `agentsmesh init`, use `agentsmesh import --from <tool>` for native configs, `agentsmesh install <source>` or `install --sync` for reusable packs, then run `agentsmesh generate`. Use `diff`, `lint`, `check`, `watch`, `matrix`, `merge`, and `refresh` as needed.";
     LEGACY_AGENTSMESH_ROOT_INSTRUCTION_PARAGRAPH = ROOT_INSTRUCTION_BODY_V1;
     LEGACY_AGENTSMESH_ROOT_INSTRUCTION_SECTION = `## Project-Specific Rules
 
@@ -1091,12 +1133,20 @@ ${ROOT_INSTRUCTION_BODY_V7}`;
     AGENTSMESH_CONTRACT_WITH_V8_BODY = `## AgentsMesh Generation Contract
 
 ${ROOT_INSTRUCTION_BODY_V8}`;
+    AGENTSMESH_CONTRACT_WITH_V9_BODY = `## AgentsMesh Generation Contract
+
+${ROOT_INSTRUCTION_BODY_V9}`;
+    AGENTSMESH_CONTRACT_WITH_V10_BODY = `## AgentsMesh Generation Contract
+
+${ROOT_INSTRUCTION_BODY_V10}`;
     AGENTSMESH_ROOT_INSTRUCTION_PARAGRAPH = `${ROOT_CONTRACT_START}
 ## AgentsMesh Generation Contract
 
 ${ROOT_INSTRUCTION_BODY}
 ${ROOT_CONTRACT_END}`;
     LEGACY_FORMS = [
+      AGENTSMESH_CONTRACT_WITH_V10_BODY,
+      AGENTSMESH_CONTRACT_WITH_V9_BODY,
       AGENTSMESH_CONTRACT_WITH_V8_BODY,
       AGENTSMESH_CONTRACT_WITH_V7_BODY,
       AGENTSMESH_CONTRACT_WITH_V6_BODY,
@@ -2000,9 +2050,8 @@ function shouldRewritePathToken(fullContent, start, end, matchText, rewriteBareP
   const before = fullContent[start - 1];
   const after = fullContent[end];
   if (isMarkdownReferenceDefinitionDestination(fullContent, start, candidateEnd)) return true;
-  if (before === "'" && after === "'" || before === '"' && after === '"' || before === "`" && after === "`") {
-    return true;
-  }
+  if (before === "`" && after === "`") return true;
+  if (before === "'" && after === "'" || before === '"' && after === '"') return false;
   if (before === "<" && after === ">") return true;
   if (before === "[" && after === "]") {
     if (!rewriteBarePathTokens && !isRootRelativePathToken(normalizedCandidate) && markdownBracketLabelDuplicatesDestination(fullContent, start, matchText)) {
@@ -3250,12 +3299,12 @@ var init_augment_code = __esm({
 });
 
 // src/targets/claude-code/constants.ts
-var CLAUDE_CODE_TARGET, CLAUDE_ROOT, CLAUDE_LEGACY_ROOT, CLAUDE_RULES_DIR, CLAUDE_COMMANDS_DIR, CLAUDE_AGENTS_DIR, CLAUDE_SKILLS_DIR, CLAUDE_SETTINGS, CLAUDE_HOOKS_JSON, CLAUDE_OUTPUT_STYLES_DIR, CLAUDE_IGNORE, CLAUDE_MCP_JSON, CLAUDE_GLOBAL_MCP_JSON, CLAUDE_CANONICAL_RULES_DIR, CLAUDE_CANONICAL_COMMANDS_DIR, CLAUDE_CANONICAL_AGENTS_DIR, CLAUDE_CANONICAL_SKILLS_DIR, CLAUDE_CANONICAL_MCP, CLAUDE_CANONICAL_PERMISSIONS, CLAUDE_CANONICAL_HOOKS, CLAUDE_CANONICAL_IGNORE;
+var CLAUDE_CODE_TARGET, CLAUDE_ROOT, CLAUDE_NESTED_ROOT, CLAUDE_RULES_DIR, CLAUDE_COMMANDS_DIR, CLAUDE_AGENTS_DIR, CLAUDE_SKILLS_DIR, CLAUDE_SETTINGS, CLAUDE_HOOKS_JSON, CLAUDE_OUTPUT_STYLES_DIR, CLAUDE_IGNORE, CLAUDE_MCP_JSON, CLAUDE_GLOBAL_MCP_JSON, CLAUDE_CANONICAL_RULES_DIR, CLAUDE_CANONICAL_COMMANDS_DIR, CLAUDE_CANONICAL_AGENTS_DIR, CLAUDE_CANONICAL_SKILLS_DIR, CLAUDE_CANONICAL_MCP, CLAUDE_CANONICAL_PERMISSIONS, CLAUDE_CANONICAL_HOOKS, CLAUDE_CANONICAL_IGNORE;
 var init_constants7 = __esm({
   "src/targets/claude-code/constants.ts"() {
     CLAUDE_CODE_TARGET = "claude-code";
-    CLAUDE_ROOT = ".claude/CLAUDE.md";
-    CLAUDE_LEGACY_ROOT = "CLAUDE.md";
+    CLAUDE_ROOT = "CLAUDE.md";
+    CLAUDE_NESTED_ROOT = ".claude/CLAUDE.md";
     CLAUDE_RULES_DIR = ".claude/rules";
     CLAUDE_COMMANDS_DIR = ".claude/commands";
     CLAUDE_AGENTS_DIR = ".claude/agents";
@@ -5117,7 +5166,8 @@ var init_amp2 = __esm({
           markAsRoot: true
         }
       },
-      emitScopedSettings(canonical, _scope) {
+      emitScopedSettings(canonical, _scope, enabledFeatures) {
+        if (!enabledFeatures.has("mcp")) return [];
         if (!canonical.mcp || Object.keys(canonical.mcp.mcpServers).length === 0) return [];
         return [
           {
@@ -5869,12 +5919,12 @@ function mergeAugmentSettings(existing, newContent) {
   if (overlay.hooks !== void 0) base.hooks = overlay.hooks;
   return JSON.stringify(base, null, 2);
 }
-function buildSettingsContent(canonical) {
+function buildSettingsContent(canonical, enabledFeatures) {
   const settings = {};
-  if (canonical.mcp && Object.keys(canonical.mcp.mcpServers).length > 0) {
+  if (enabledFeatures.has("mcp") && canonical.mcp && Object.keys(canonical.mcp.mcpServers).length > 0) {
     settings.mcpServers = canonical.mcp.mcpServers;
   }
-  if (canonical.hooks && Object.keys(canonical.hooks).length > 0) {
+  if (enabledFeatures.has("hooks") && canonical.hooks && Object.keys(canonical.hooks).length > 0) {
     settings.hooks = serializeHooksForSettings(canonical.hooks);
   }
   if (Object.keys(settings).length === 0) return null;
@@ -6003,8 +6053,8 @@ var init_augment_code2 = __esm({
         ],
         layout: globalLayout5
       },
-      emitScopedSettings(canonical) {
-        const content = buildSettingsContent(canonical);
+      emitScopedSettings(canonical, _scope, enabledFeatures) {
+        const content = buildSettingsContent(canonical, enabledFeatures);
         if (content === null) return [];
         return [{ path: AUGMENT_CODE_SETTINGS_FILE, content }];
       },
@@ -6552,7 +6602,10 @@ var init_claude_code2 = __esm({
       skillDir: ".claude/skills",
       managedOutputs: {
         dirs: [".claude/agents", ".claude/commands", ".claude/rules", ".claude/skills"],
-        files: [".claude/CLAUDE.md", ".claude/settings.json", ".claudeignore", ".mcp.json"]
+        // CLAUDE_NESTED_ROOT is the pre-migration project location; listing it here lets
+        // `cleanupStaleGeneratedOutputs` evict a leftover `.claude/CLAUDE.md` once generation
+        // writes the root `CLAUDE.md`, so Claude Code never concatenates both into context.
+        files: [CLAUDE_ROOT, CLAUDE_NESTED_ROOT, ".claude/settings.json", ".claudeignore", ".mcp.json"]
       },
       paths: {
         rulePath(slug, _rule) {
@@ -6567,7 +6620,7 @@ var init_claude_code2 = __esm({
       }
     };
     globalLayout6 = {
-      rootInstructionPath: CLAUDE_ROOT,
+      rootInstructionPath: CLAUDE_NESTED_ROOT,
       skillDir: ".claude/skills",
       renderPrimaryRootInstruction: renderClaudeGlobalPrimaryInstructions,
       managedOutputs: {
@@ -6580,7 +6633,7 @@ var init_claude_code2 = __esm({
           ".agents/skills"
         ],
         files: [
-          ".claude/CLAUDE.md",
+          CLAUDE_NESTED_ROOT,
           ".claude/settings.json",
           CLAUDE_GLOBAL_MCP_JSON,
           CLAUDE_HOOKS_JSON,
@@ -6588,6 +6641,7 @@ var init_claude_code2 = __esm({
         ]
       },
       rewriteGeneratedPath(path) {
+        if (path === CLAUDE_ROOT) return CLAUDE_NESTED_ROOT;
         if (path === CLAUDE_MCP_JSON) return CLAUDE_GLOBAL_MCP_JSON;
         return path;
       },
@@ -6651,10 +6705,11 @@ var init_claude_code2 = __esm({
       importer: {
         rules: [
           {
-            // Root rule: prefer .claude/CLAUDE.md, fall back to legacy CLAUDE.md (project only).
+            // Root rule: project prefers root CLAUDE.md, falls back to nested .claude/CLAUDE.md;
+            // global reads the nested .claude/CLAUDE.md.
             feature: "rules",
             mode: "singleFile",
-            source: { project: [CLAUDE_ROOT, CLAUDE_LEGACY_ROOT], global: [CLAUDE_ROOT] },
+            source: { project: [CLAUDE_ROOT, CLAUDE_NESTED_ROOT], global: [CLAUDE_NESTED_ROOT] },
             canonicalDir: CLAUDE_CANONICAL_RULES_DIR,
             canonicalRootFilename: "_root.md",
             markAsRoot: true
@@ -6700,7 +6755,23 @@ var init_claude_code2 = __esm({
         }
       },
       buildImportPaths: buildClaudeCodeImportPaths,
-      detectionPaths: ["CLAUDE.md", ".claude/rules", ".claude/commands"]
+      detectionPaths: [CLAUDE_ROOT, CLAUDE_NESTED_ROOT, ".claude/rules", ".claude/commands"],
+      nativeInstall: {
+        pickPaths: [
+          {
+            prefix: ".claude/commands",
+            feature: "commands",
+            strategy: { kind: "basename", suffix: ".md" }
+          },
+          { prefix: ".claude/rules", feature: "rules", strategy: { kind: "basename", suffix: ".md" } },
+          {
+            prefix: ".claude/agents",
+            feature: "agents",
+            strategy: { kind: "basename", suffix: ".md" }
+          },
+          { prefix: ".claude/skills/", feature: "skills", strategy: { kind: "firstSegment" } }
+        ]
+      }
     };
   }
 });
@@ -7579,6 +7650,16 @@ var init_cline2 = __esm({
       },
       buildImportPaths: buildClineImportPaths,
       detectionPaths: [".clinerules", ".cline"],
+      nativeInstall: {
+        pickPaths: [
+          { prefix: CLINE_SKILLS_DIR, feature: "skills", strategy: { kind: "skillDir" } },
+          {
+            prefix: CLINE_WORKFLOWS_DIR,
+            feature: "commands",
+            strategy: { kind: "basename", suffix: ".md" }
+          }
+        ]
+      },
       conversionDefaults: { agentsToSkills: true }
     };
   }
@@ -8497,6 +8578,11 @@ var init_codex_cli2 = __esm({
         ".codex/agents",
         ".codex/rules"
       ],
+      nativeInstall: {
+        pickPaths: [
+          { prefix: ".codex", feature: "rules", strategy: { kind: "basename", suffix: ".md" } }
+        ]
+      },
       excludeFromStarterInit: true,
       conversionDefaults: { commandsToSkills: true, agentsToSkills: false }
     };
@@ -9000,6 +9086,21 @@ var init_continue2 = __esm({
       },
       buildImportPaths: buildContinueImportPaths,
       detectionPaths: [".continue/rules", ".continue/skills", ".continue/mcpServers"],
+      nativeInstall: {
+        pickPaths: [
+          {
+            prefix: ".continue/rules",
+            feature: "rules",
+            strategy: { kind: "basename", suffix: ".md" }
+          },
+          {
+            prefix: ".continue/prompts",
+            feature: "commands",
+            strategy: { kind: "basename", suffix: ".md" }
+          },
+          { prefix: ".continue/skills", feature: "skills", strategy: { kind: "skillDir" } }
+        ]
+      },
       conversionDefaults: { agentsToSkills: true }
     };
   }
@@ -9367,6 +9468,80 @@ var init_importer10 = __esm({
     init_copilot2();
   }
 });
+async function skillNamesFromNativeSkillDir(scanRoot) {
+  const files = await readDirRecursive(scanRoot);
+  const names = /* @__PURE__ */ new Set();
+  for (const f of files) {
+    if (basename(f) === "SKILL.md") {
+      names.add(basename(dirname(f)));
+      continue;
+    }
+    const rel2 = relative(scanRoot, f).replace(/\\/g, "/");
+    if (!rel2.includes("/") && f.toLowerCase().endsWith(".md")) {
+      names.add(basename(f, ".md"));
+    }
+  }
+  return [...names].filter(Boolean).sort();
+}
+var init_native_skill_scan = __esm({
+  "src/install/native/native-skill-scan.ts"() {
+    init_fs();
+  }
+});
+async function inferCopilotPickFromPath(repoRoot, posixPath) {
+  const scan = join(repoRoot, ...posixPath.split("/"));
+  if (posixPath.startsWith(COPILOT_PROMPTS_DIR)) {
+    const files = await readDirRecursive(scan);
+    const commands = [
+      ...new Set(
+        files.filter((f) => f.toLowerCase().endsWith(".prompt.md")).map((f) => basename(f, ".prompt.md"))
+      )
+    ].sort();
+    return commands.length ? { commands } : {};
+  }
+  if (posixPath.startsWith(".github/copilot") && !posixPath.includes("copilot-instructions.md")) {
+    const files = await readDirRecursive(scan);
+    const rules = [
+      ...new Set(
+        files.filter((f) => f.includes(".instructions.md")).map((f) => basename(f).replace(/\.instructions\.md$/i, ""))
+      )
+    ].sort();
+    return rules.length ? { rules } : {};
+  }
+  if (posixPath.startsWith(".github/instructions")) {
+    const files = await readDirRecursive(scan);
+    const names = /* @__PURE__ */ new Set();
+    for (const f of files) {
+      const b = basename(f);
+      if (b.toLowerCase().endsWith(".instructions.md"))
+        names.add(b.replace(/\.instructions\.md$/i, ""));
+      else if (b.toLowerCase().endsWith(".md")) names.add(basename(f, ".md"));
+    }
+    const rules = [...names].sort();
+    return rules.length ? { rules } : {};
+  }
+  if (posixPath.startsWith(".github/skills")) {
+    const skills = await skillNamesFromNativeSkillDir(scan);
+    return skills.length ? { skills } : {};
+  }
+  if (posixPath.startsWith(".github/agents")) {
+    const files = await readDirRecursive(scan);
+    const agents = [
+      ...new Set(
+        files.filter((f) => f.toLowerCase().endsWith(".agent.md")).map((f) => basename(f, ".agent.md"))
+      )
+    ].sort();
+    return agents.length ? { agents } : {};
+  }
+  return {};
+}
+var init_native_path_pick_infer_copilot = __esm({
+  "src/install/native/native-path-pick-infer-copilot.ts"() {
+    init_fs();
+    init_constants29();
+    init_native_skill_scan();
+  }
+});
 function pruneUndefined3(record) {
   for (const key of Object.keys(record)) {
     if (record[key] === void 0) delete record[key];
@@ -9656,6 +9831,7 @@ var init_copilot2 = __esm({
     init_generator11();
     init_constants29();
     init_importer10();
+    init_native_path_pick_infer_copilot();
     init_import_mappers4();
     init_linter10();
     init_import_map_builders();
@@ -9870,7 +10046,8 @@ var init_copilot2 = __esm({
         ".github/skills",
         ".github/agents",
         ".github/hooks"
-      ]
+      ],
+      nativeInstall: { inferPick: inferCopilotPickFromPath }
     };
   }
 });
@@ -11370,6 +11547,23 @@ var init_cursor2 = __esm({
       },
       buildImportPaths: buildCursorImportPaths,
       detectionPaths: [".cursor/rules", ".cursor/mcp.json"],
+      nativeInstall: {
+        pickPaths: [
+          { prefix: ".cursor/rules", feature: "rules", strategy: { kind: "basename", suffix: ".mdc" } },
+          {
+            prefix: ".cursor/commands",
+            feature: "commands",
+            strategy: { kind: "basename", suffix: ".md" }
+          },
+          {
+            prefix: ".cursor/agents",
+            feature: "agents",
+            strategy: { kind: "basename", suffix: ".md" }
+          },
+          { prefix: ".cursor/skills", feature: "skills", strategy: { kind: "skillDir" } }
+        ],
+        dialectHints: [{ frontmatterKey: "alwaysApply" }]
+      },
       preservesManualActivation: true
     };
   }
@@ -12131,18 +12325,18 @@ function mapHookEvent2(event) {
       return null;
   }
 }
-function generateGeminiSettingsFiles(canonical) {
+function generateGeminiSettingsFiles(canonical, enabledFeatures) {
   const settings = {};
   let hasAnyNativeSettings = false;
-  if (canonical.mcp && Object.keys(canonical.mcp.mcpServers).length > 0) {
+  if (enabledFeatures.has("mcp") && canonical.mcp && Object.keys(canonical.mcp.mcpServers).length > 0) {
     settings.mcpServers = canonical.mcp.mcpServers;
     hasAnyNativeSettings = true;
   }
-  if (canonical.agents.length > 0) {
+  if (enabledFeatures.has("agents") && canonical.agents.length > 0) {
     settings.experimental = { enableAgents: true };
     hasAnyNativeSettings = true;
   }
-  if (canonical.hooks) {
+  if (enabledFeatures.has("hooks") && canonical.hooks) {
     const hookEntries = Object.entries(canonical.hooks).flatMap(([event, entries]) => {
       const mappedEvent = mapHookEvent2(event);
       if (!mappedEvent || !Array.isArray(entries)) return [];
@@ -12758,6 +12952,36 @@ var init_importer15 = __esm({
     init_importer_skills_agents();
   }
 });
+function isUnderGeminiCommands(pathInRepoPosix) {
+  const p = pathInRepoPosix.replace(/^\/+|\/+$/g, "");
+  return p === ".gemini/commands" || p.startsWith(".gemini/commands/");
+}
+async function inferGeminiCommandNamesFromFiles(repoRoot, pathInRepoPosix) {
+  const commandsRoot = join(repoRoot, ...GEMINI_COMMANDS_DIR.split("/"));
+  const scanDir = join(repoRoot, ...pathInRepoPosix.split("/"));
+  const files = await readDirRecursive(scanDir);
+  const names = [];
+  for (const f of files) {
+    if (!/\.(toml|md)$/i.test(f)) continue;
+    const rel2 = relative(commandsRoot, f).replace(/\\/g, "/");
+    if (rel2.startsWith("..") || rel2 === "") continue;
+    const noExt = rel2.replace(/\.(toml|md)$/i, "");
+    const name = noExt.split("/").filter(Boolean).join(":");
+    if (name) names.push(name);
+  }
+  return [...new Set(names)].sort();
+}
+async function inferGeminiPick(repoRoot, posixPath) {
+  if (!isUnderGeminiCommands(posixPath)) return {};
+  const commands = await inferGeminiCommandNamesFromFiles(repoRoot, posixPath);
+  return commands.length ? { commands } : {};
+}
+var init_gemini_install_commands = __esm({
+  "src/install/native/gemini-install-commands.ts"() {
+    init_fs();
+    init_constants30();
+  }
+});
 async function mapGeminiRuleFile(relativePath, destDir, normalizeTo) {
   const relativeMdPath = relativePath.replace(/\\/g, "/");
   const destPath = join(destDir, relativeMdPath);
@@ -12869,12 +13093,12 @@ var init_lint12 = __esm({
 });
 
 // src/targets/gemini-cli/scoped-settings-emit.ts
-function emitScopedGeminiSettings(canonical, scope) {
+function emitScopedGeminiSettings(canonical, scope, enabledFeatures) {
   if (scope === "project") {
     const caps = getTargetCapabilities("gemini-cli", scope);
     if (caps?.ignore.flavor !== "settings-embedded") return [];
   }
-  return generateGeminiSettingsFiles(canonical);
+  return generateGeminiSettingsFiles(canonical, enabledFeatures);
 }
 var init_scoped_settings_emit = __esm({
   "src/targets/gemini-cli/scoped-settings-emit.ts"() {
@@ -12892,6 +13116,7 @@ var init_gemini_cli2 = __esm({
     init_policies_generator();
     init_constants30();
     init_importer15();
+    init_gemini_install_commands();
     init_import_mappers6();
     init_linter15();
     init_import_map_builders();
@@ -13087,6 +13312,7 @@ var init_gemini_cli2 = __esm({
       },
       buildImportPaths: buildGeminiCliImportPaths,
       detectionPaths: ["GEMINI.md", ".gemini"],
+      nativeInstall: { inferPick: inferGeminiPick },
       conversionDefaults: { agentsToSkills: false }
     };
   }
@@ -13928,7 +14154,23 @@ var init_junie2 = __esm({
         ".junie/skills",
         ".junie/mcp/mcp.json",
         ".aiignore"
-      ]
+      ],
+      nativeInstall: {
+        pickPaths: [
+          {
+            prefix: ".junie/commands",
+            feature: "commands",
+            strategy: { kind: "basename", suffix: ".md" }
+          },
+          { prefix: ".junie/rules", feature: "rules", strategy: { kind: "basename", suffix: ".md" } },
+          {
+            prefix: ".junie/agents",
+            feature: "agents",
+            strategy: { kind: "basename", suffix: ".md" }
+          },
+          { prefix: ".junie/skills", feature: "skills", strategy: { kind: "skillDir" } }
+        ]
+      }
     };
   }
 });
@@ -15783,9 +16025,18 @@ function generateIgnore12(canonical) {
   if (!canonical.ignore || canonical.ignore.length === 0) return [];
   return [{ path: QWEN_IGNORE, content: canonical.ignore.join("\n") }];
 }
+function renderQwenGlobalInstructions(canonical) {
+  const root = canonical.rules.find((rule) => rule.root);
+  const nonRootRules = canonical.rules.filter((rule) => {
+    if (rule.root) return false;
+    return rule.targets.length === 0 || rule.targets.includes(QWEN_CODE_TARGET);
+  });
+  return appendEmbeddedRulesBlock(root?.body.trim() ?? "", nonRootRules);
+}
 var init_generator26 = __esm({
   "src/targets/qwen-code/generator.ts"() {
     init_markdown();
+    init_managed_blocks();
     init_constants21();
   }
 });
@@ -15868,6 +16119,7 @@ var init_qwen_code2 = __esm({
     };
     globalLayout22 = {
       rootInstructionPath: QWEN_GLOBAL_ROOT,
+      renderPrimaryRootInstruction: renderQwenGlobalInstructions,
       skillDir: QWEN_GLOBAL_SKILLS_DIR,
       managedOutputs: {
         dirs: [QWEN_GLOBAL_COMMANDS_DIR, QWEN_GLOBAL_AGENTS_DIR, QWEN_GLOBAL_SKILLS_DIR],
@@ -18268,6 +18520,16 @@ var init_windsurf2 = __esm({
       },
       buildImportPaths: buildWindsurfImportPaths,
       detectionPaths: [".windsurfrules", ".windsurf"],
+      nativeInstall: {
+        pickPaths: [
+          {
+            prefix: ".windsurf/rules",
+            feature: "rules",
+            strategy: { kind: "basename", suffix: ".md" }
+          }
+        ],
+        dialectHints: [{ frontmatterKey: "trigger" }]
+      },
       conversionDefaults: { agentsToSkills: true }
     };
   }
@@ -18542,7 +18804,8 @@ var init_zed2 = __esm({
           markAsRoot: true
         }
       },
-      emitScopedSettings(canonical, _scope) {
+      emitScopedSettings(canonical, _scope, enabledFeatures) {
+        if (!enabledFeatures.has("mcp")) return [];
         if (!canonical.mcp || Object.keys(canonical.mcp.mcpServers).length === 0) return [];
         const contextServers = {};
         for (const [name, server] of Object.entries(canonical.mcp.mcpServers)) {
@@ -18597,7 +18860,10 @@ function getBuiltinTargetDefinition(target31) {
 function getTargetCapabilities(target31, scope = "project") {
   const descriptor31 = getBuiltinTargetDefinition(target31) ?? getDescriptor(target31);
   if (!descriptor31) return void 0;
-  const raw = scope === "global" ? descriptor31.globalSupport?.capabilities ?? descriptor31.capabilities : descriptor31.capabilities;
+  if (scope === "global" && !descriptor31.globalSupport) {
+    return normalizeTargetCapabilities(ALL_NONE_CAPABILITIES);
+  }
+  const raw = scope === "global" ? descriptor31.globalSupport.capabilities : descriptor31.capabilities;
   return normalizeTargetCapabilities(raw);
 }
 function getTargetDetectionPaths(target31, scope = "project") {
@@ -18653,6 +18919,7 @@ function isConversionUpgrading(descriptor31, feature, config, scope) {
 function getEffectiveTargetSupportLevel(target31, feature, config, scope = "project") {
   const baseLevel = getTargetCapabilities(target31, scope)?.[feature]?.level ?? "none";
   const descriptor31 = getBuiltinTargetDefinition(target31) ?? getDescriptor(target31);
+  if (scope === "global" && descriptor31 && !descriptor31.globalSupport) return "none";
   if (baseLevel === "none" && isConversionUpgrading(descriptor31, feature, config, scope)) {
     return "embedded";
   }
@@ -18666,7 +18933,7 @@ function resolveTargetFeatureGenerator(target31, feature, config, scope = "proje
   const pick = PICK_FEATURE_GENERATOR[feature];
   return pick === null ? void 0 : pick(descriptor31.generators);
 }
-var BUILTIN_TARGETS, _builtinTargetsMap, PICK_FEATURE_GENERATOR;
+var ALL_NONE_CAPABILITIES, BUILTIN_TARGETS, _builtinTargetsMap, PICK_FEATURE_GENERATOR;
 var init_builtin_targets = __esm({
   "src/targets/catalog/builtin-targets.ts"() {
     init_conversions();
@@ -18704,6 +18971,17 @@ var init_builtin_targets = __esm({
     init_warp2();
     init_windsurf2();
     init_zed2();
+    ALL_NONE_CAPABILITIES = {
+      rules: "none",
+      additionalRules: "none",
+      commands: "none",
+      agents: "none",
+      skills: "none",
+      mcp: "none",
+      hooks: "none",
+      ignore: "none",
+      permissions: "none"
+    };
     BUILTIN_TARGETS = [
       descriptor,
       descriptor2,
@@ -18798,7 +19076,7 @@ async function fetchGitRemoteExtend(parsed, extendName, options, cacheDir, build
     await cloneRepo(resolveCloneUrl(parsed), stagedRepoDir);
     if (parsed.ref) await checkoutRef(stagedRepoDir, parsed.ref);
     await rm(cacheRoot, { recursive: true, force: true });
-    await rename(stagedRoot, cacheRoot);
+    await renameWithRetry(stagedRoot, cacheRoot);
     return readCachedRepo(cacheRepoDir);
   } catch (err) {
     await rm(stagedRoot, { recursive: true, force: true });
@@ -19360,6 +19638,23 @@ function assertNoBasenameCollisions(feature, paths, stripExt) {
   }
 }
 
+// src/utils/output/color.ts
+function noColorRequested() {
+  const value = process.env.NO_COLOR;
+  return value !== void 0 && value !== "";
+}
+function forceColorRequested() {
+  const value = process.env.FORCE_COLOR;
+  if (value === void 0) return void 0;
+  return value !== "0" && value !== "false";
+}
+function colorEnabled(stream = process.stdout) {
+  const forced = forceColorRequested();
+  if (forced !== void 0) return forced;
+  if (noColorRequested()) return false;
+  return stream.isTTY === true;
+}
+
 // src/utils/output/logger.ts
 var C = {
   green: "\x1B[32m",
@@ -19368,16 +19663,14 @@ var C = {
   cyan: "\x1B[36m",
   reset: "\x1B[0m"
 };
-function out(text) {
-  {
-    process.stdout.write(text);
-  }
+function outStream() {
+  return process.stdout;
 }
-function noColor() {
-  return process.env.NO_COLOR !== void 0 && process.env.NO_COLOR !== "";
+function out(text) {
+  outStream().write(text);
 }
-function c(code, text) {
-  return noColor() ? text : `${code}${text}${C.reset}`;
+function c(code, text, stream) {
+  return colorEnabled(stream) ? `${code}${text}${C.reset}` : text;
 }
 function pad(str, width) {
   const len = [...str].length;
@@ -19385,20 +19678,20 @@ function pad(str, width) {
 }
 var logger = {
   info(msg) {
-    out(c(C.cyan, msg) + "\n");
+    out(c(C.cyan, msg, outStream()) + "\n");
   },
   warn(msg) {
-    process.stderr.write(c(C.yellow, "\u26A0 ") + msg + "\n");
+    process.stderr.write(c(C.yellow, "\u26A0 ", process.stderr) + msg + "\n");
   },
   error(msg) {
-    process.stderr.write(c(C.red, "\u2717 ") + msg + "\n");
+    process.stderr.write(c(C.red, "\u2717 ", process.stderr) + msg + "\n");
   },
   success(msg) {
-    out(c(C.green, "\u2713 ") + msg + "\n");
+    out(c(C.green, "\u2713 ", outStream()) + msg + "\n");
   },
   debug(msg) {
     if (process.env.AGENTSMESH_DEBUG === "1") {
-      out(c(C.cyan, "[debug] ") + msg + "\n");
+      out(c(C.cyan, "[debug] ", outStream()) + msg + "\n");
     }
   },
   table(rows) {