@3lineas/grooveskills 1.7.0 → 1.7.2

package/dist/{chunk-E63GTCOE.js → chunk-KPDHH2AZ.js}

@@ -1,3 +1,8 @@
+// src/main.ts
+import { basename as basename3 } from "path";
+import { userInfo as userInfo2 } from "os";
+import picocolors5 from "picocolors";
+
 // src/domains/detector/project-detector.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 import { join as join2 } from "path";
@@ -37,11 +42,11 @@ function detectDependencies(targetPath) {
     try {
       const raw = readFileSync(packageJsonPath, "utf-8");
       const parsed = JSON.parse(raw);
-      for (const dep of Object.keys(parsed.dependencies ?? {})) {
-        detected.add(dep);
+      for (const dependencyName of Object.keys(parsed.dependencies ?? {})) {
+        detected.add(dependencyName);
       }
-      for (const dep of Object.keys(parsed.devDependencies ?? {})) {
-        detected.add(dep);
+      for (const dependencyName of Object.keys(parsed.devDependencies ?? {})) {
+        detected.add(dependencyName);
       }
     } catch {
     }
@@ -265,7 +270,9 @@ function detectProjectContext(targetPath) {
     if (skill.dependencies.length === 0) {
       continue;
     }
-    const hasMatch = skill.dependencies.some((dep) => dependencies.includes(dep));
+    const hasMatch = skill.dependencies.some(
+      (dependencyName) => dependencies.includes(dependencyName)
+    );
     if (hasMatch && !suggestedSkillIds.includes(skill.id)) {
       suggestedSkillIds.push(skill.id);
     }
@@ -284,21 +291,21 @@ function detectProjectContext(targetPath) {
 }
 
 // src/domains/ui/ui-orchestrator.ts
-import * as p5 from "@clack/prompts";
-import pc3 from "picocolors";
+import * as prompts6 from "@clack/prompts";
+import picocolors4 from "picocolors";
 
 // src/domains/ui/banners.ts
-import pc from "picocolors";
+import picocolors from "picocolors";
 function renderBanner() {
-  const title = pc.bold(pc.white(" GROOVE SKILLS "));
-  const badge = pc.bgMagenta(pc.black(title));
-  const subtitle = pc.dim("Multi-Agent AI Skills & Architectural Standards");
+  const title = picocolors.bold(picocolors.white(" GROOVE SKILLS "));
+  const badge = picocolors.bgMagenta(picocolors.black(title));
+  const subtitle = picocolors.dim("Multi-Agent AI Skills & Architectural Standards");
   return `${badge}  ${subtitle}
 `;
 }
 
 // src/domains/ui/prompt-skills.ts
-import * as p from "@clack/prompts";
+import * as prompts from "@clack/prompts";
 async function promptSkills(suggestedSkillIds) {
   const selectableSkills = SKILL_CATALOG.filter((skill) => !skill.isCoreHarness);
   const options = selectableSkills.map((skill) => {
@@ -309,7 +316,7 @@ async function promptSkills(suggestedSkillIds) {
       hint: isSuggested ? "Suggested based on your project stack" : skill.description
     };
   });
-  const selected = await p.multiselect({
+  const selected = await prompts.multiselect({
     message: "Which skills would you like to install in this project?",
     options,
     initialValues: suggestedSkillIds,
@@ -319,7 +326,7 @@ async function promptSkills(suggestedSkillIds) {
 }
 
 // src/domains/ui/prompt-agents.ts
-import * as p2 from "@clack/prompts";
+import * as prompts2 from "@clack/prompts";
 async function promptAgents(detectedAgents) {
   const options = [
     { value: "antigravity", label: "Antigravity", hint: ".agents/skills (Google Agentic IDE)" },
@@ -328,7 +335,7 @@ async function promptAgents(detectedAgents) {
     { value: "gemini", label: "Gemini Code Assist", hint: ".gemini/skills (Google Gemini)" }
   ];
   const initialValues = detectedAgents.length > 0 ? detectedAgents : ["antigravity"];
-  const selected = await p2.multiselect({
+  const selected = await prompts2.multiselect({
     message: "Which AI agents should be configured?",
     options,
     initialValues,
@@ -338,16 +345,16 @@ async function promptAgents(detectedAgents) {
 }
 
 // src/domains/ui/prompt-language.ts
-import * as p3 from "@clack/prompts";
+import * as prompts3 from "@clack/prompts";
 async function promptLanguage(defaultLanguage = "es") {
   const options = [
-    { value: "es", label: "Espa\xF1ol (Spanish)", hint: "Recomendado para proyectos en espa\xF1ol" },
+    { value: "es", label: "Espa\xF1ol (Spanish)", hint: "Recommended for Spanish-speaking projects" },
     { value: "en", label: "English", hint: "Standard international English" },
-    { value: "pt", label: "Portugu\xEAs (Portuguese)", hint: "Portugu\xEAs para o Brasil e Portugal" },
-    { value: "it", label: "Italiano (Italian)", hint: "Comunicazione in lingua italiana" },
-    { value: "fr", label: "Fran\xE7ais (French)", hint: "Communication en langue fran\xE7aise" }
+    { value: "pt", label: "Portugu\xEAs (Portuguese)", hint: "Portuguese for Brazil and Portugal" },
+    { value: "it", label: "Italiano (Italian)", hint: "Italian language communication" },
+    { value: "fr", label: "Fran\xE7ais (French)", hint: "French language communication" }
   ];
-  const selected = await p3.select({
+  const selected = await prompts3.select({
     message: "Which language should AI agents use for user-facing copy and communication?",
     options,
     initialValue: defaultLanguage
@@ -356,9 +363,9 @@ async function promptLanguage(defaultLanguage = "es") {
 }
 
 // src/domains/ui/prompt-confirm-overwrite.ts
-import * as p4 from "@clack/prompts";
+import * as prompts4 from "@clack/prompts";
 async function promptConfirmOverwrite() {
-  return await p4.confirm({
+  return await prompts4.confirm({
     message: "Some skills already exist in this project. Would you like to overwrite them with the latest version?",
     initialValue: true
   });
@@ -368,10 +375,10 @@ async function promptConfirmOverwrite() {
 import { lstatSync } from "fs";
 import { join as join3 } from "path";
 var AGENT_DESTINATION_MAP = {
-  antigravity: (dir) => join3(".agents", "skills", dir),
-  claude: (dir) => join3(".claude", "skills", dir),
-  cursor: (dir) => join3(".cursor", "rules", `${dir}.mdc`),
-  gemini: (dir) => join3(".gemini", "skills", dir)
+  antigravity: (directoryName) => join3(".agents", "skills", directoryName),
+  claude: (directoryName) => join3(".claude", "skills", directoryName),
+  cursor: (directoryName) => join3(".cursor", "rules", `${directoryName}.mdc`),
+  gemini: (directoryName) => join3(".gemini", "skills", directoryName)
 };
 function verifySkillExists(targetPath, skillDirectoryName, agents) {
   for (const agent of agents) {
@@ -387,10 +394,10 @@ function verifySkillExists(targetPath, skillDirectoryName, agents) {
 }
 
 // src/domains/installer/install-orchestrator.ts
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 
 // src/domains/adapters/skill-reference-builder.ts
-import { existsSync as existsSync4, lstatSync as lstatSync2, mkdirSync, readFileSync as readFileSync3, rmSync, unlinkSync } from "fs";
+import { existsSync as existsSync5, lstatSync as lstatSync3, mkdirSync, readFileSync as readFileSync3, rmSync as rmSync2, unlinkSync } from "fs";
 import { join as join5 } from "path";
 
 // src/domains/project-store/project-paths.ts
@@ -412,48 +419,194 @@ function getProjectConfigPath(targetPath) {
 }
 
 // src/domains/fs/safe-file-writer.ts
-import { chmodSync, existsSync as existsSync3, writeFileSync } from "fs";
+import { chmodSync, existsSync as existsSync4, renameSync, rmSync, writeFileSync } from "fs";
+
+// src/domains/fs/inspect-file-access.ts
+import { execFileSync } from "child_process";
+import { accessSync, constants, existsSync as existsSync3, lstatSync as lstatSync2 } from "fs";
+import { dirname } from "path";
+var UF_IMMUTABLE = 2;
+var SF_IMMUTABLE = 131072;
+function resolveNearestExistingDir(startDir) {
+  let current = startDir;
+  while (!existsSync3(current)) {
+    const parent = dirname(current);
+    if (parent === current) {
+      break;
+    }
+    current = parent;
+  }
+  return current;
+}
+function detectMacOsImmutableFlag(filePath, lstat) {
+  const rawFlags = lstat.flags;
+  if (typeof rawFlags === "number") {
+    return Boolean(rawFlags & (UF_IMMUTABLE | SF_IMMUTABLE));
+  }
+  if (process.platform !== "darwin") {
+    return false;
+  }
+  try {
+    const out = execFileSync("stat", ["-f", "%f", filePath], {
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    const parsedFlags = Number.parseInt(out, 10);
+    if (Number.isNaN(parsedFlags)) {
+      return false;
+    }
+    return Boolean(parsedFlags & (UF_IMMUTABLE | SF_IMMUTABLE));
+  } catch {
+    return false;
+  }
+}
+function inspectFileAccess(filePath) {
+  const currentUid = typeof process.getuid === "function" ? process.getuid() : null;
+  const parentDir = dirname(filePath);
+  const checkDir = resolveNearestExistingDir(parentDir);
+  let dirWritable = false;
+  try {
+    accessSync(checkDir, constants.W_OK);
+    dirWritable = true;
+  } catch {
+    dirWritable = false;
+  }
+  let lstat = null;
+  try {
+    lstat = lstatSync2(filePath);
+  } catch {
+    lstat = null;
+  }
+  if (!lstat) {
+    return {
+      filePath,
+      exists: false,
+      isSymlink: false,
+      ownedByCurrentUser: true,
+      ownerUid: null,
+      currentUid,
+      mode: null,
+      immutableFlag: false,
+      dirWritable,
+      parentDir
+    };
+  }
+  const isSymlink = lstat.isSymbolicLink();
+  const ownerUid = lstat.uid;
+  const ownedByCurrentUser = currentUid === null || ownerUid === currentUid;
+  const mode = lstat.mode & 511;
+  const immutableFlag = detectMacOsImmutableFlag(filePath, lstat);
+  return {
+    filePath,
+    exists: true,
+    isSymlink,
+    ownedByCurrentUser,
+    ownerUid,
+    currentUid,
+    mode,
+    immutableFlag,
+    dirWritable,
+    parentDir
+  };
+}
+function formatOwnerName(uid) {
+  if (uid === 0) {
+    return "root";
+  }
+  if (uid === null) {
+    return "another user";
+  }
+  return `uid ${uid}`;
+}
 
 // src/errors/file-permission-error.ts
+function buildDiagnosisReason(diagnosis) {
+  if (diagnosis.immutableFlag) {
+    return "immutable flag (uchg) is set";
+  }
+  if (diagnosis.exists && !diagnosis.ownedByCurrentUser) {
+    return `owned by ${formatOwnerName(diagnosis.ownerUid)}`;
+  }
+  if (!diagnosis.dirWritable) {
+    return `parent directory '${diagnosis.parentDir}' is not writable`;
+  }
+  return "permission denied";
+}
+function buildSuggestedFix(diagnosis) {
+  if (diagnosis.immutableFlag) {
+    return `chflags nouchg "${diagnosis.filePath}"`;
+  }
+  if (diagnosis.exists && !diagnosis.ownedByCurrentUser) {
+    return `sudo chown "$(id -un)" "${diagnosis.filePath}"`;
+  }
+  if (!diagnosis.dirWritable) {
+    return `chmod u+w "${diagnosis.parentDir}"`;
+  }
+  return `chmod u+w "${diagnosis.filePath}"`;
+}
 var FilePermissionError = class extends Error {
   code = "EACCES";
   filePath;
+  diagnosis;
   suggestedFixCommand;
-  constructor(filePath) {
-    super(`No tienes permisos de escritura para modificar '${filePath}'.`);
+  constructor(filePath, diagnosis) {
+    const resolved = diagnosis ?? inspectFileAccess(filePath);
+    const reason = buildDiagnosisReason(resolved);
+    super(`Cannot write to ${filePath} (${reason})`);
     this.name = "FilePermissionError";
     this.filePath = filePath;
-    this.suggestedFixCommand = `chmod u+w "${filePath}"`;
+    this.diagnosis = resolved;
+    this.suggestedFixCommand = buildSuggestedFix(resolved);
   }
 };
 
 // src/domains/fs/safe-file-writer.ts
-function safeWriteFileSync(filePath, content) {
+function safeWriteFileSync(filePath, content, options) {
+  const chmodFunction = options?.chmodImpl ?? chmodSync;
   try {
     writeFileSync(filePath, content, "utf-8");
+    return { strategy: "direct", previousOwnerUid: null };
   } catch (error) {
-    const err = error;
-    if (err.code === "EACCES" || err.code === "EPERM") {
-      if (existsSync3(filePath)) {
+    const nodeError = error;
+    if (nodeError.code !== "EACCES" && nodeError.code !== "EPERM") {
+      throw error;
+    }
+  }
+  const diagnosis = inspectFileAccess(filePath);
+  if (diagnosis.exists && diagnosis.ownedByCurrentUser && !diagnosis.immutableFlag) {
+    try {
+      const targetMode = (diagnosis.mode ?? 420) | 128;
+      chmodFunction(filePath, targetMode);
+      writeFileSync(filePath, content, "utf-8");
+      return { strategy: "chmod", previousOwnerUid: diagnosis.ownerUid };
+    } catch {
+    }
+  }
+  if (diagnosis.exists && diagnosis.dirWritable && !diagnosis.immutableFlag) {
+    const tempPath = `${filePath}.groove-tmp-${process.pid}-${Date.now()}`;
+    try {
+      const preservedMode = (diagnosis.mode ?? 420) | 128;
+      writeFileSync(tempPath, content, { encoding: "utf-8", mode: preservedMode });
+      renameSync(tempPath, filePath);
+      return { strategy: "replaced", previousOwnerUid: diagnosis.ownerUid };
+    } catch {
+      if (existsSync4(tempPath)) {
         try {
-          chmodSync(filePath, 420);
-          writeFileSync(filePath, content, "utf-8");
-          return;
+          rmSync(tempPath, { force: true });
         } catch {
         }
       }
-      throw new FilePermissionError(filePath);
     }
-    throw error;
   }
+  throw new FilePermissionError(filePath, diagnosis);
 }
 
 // src/domains/adapters/skill-reference-builder.ts
 function removeExistingPathSafely(path) {
-  const fileExists = existsSync4(path);
+  const fileExists = existsSync5(path);
   if (!fileExists) {
     try {
-      const lstat = lstatSync2(path);
+      const lstat = lstatSync3(path);
       if (lstat.isSymbolicLink()) {
         unlinkSync(path);
       }
@@ -462,13 +615,13 @@ function removeExistingPathSafely(path) {
     return;
   }
   try {
-    const lstat = lstatSync2(path);
+    const lstat = lstatSync3(path);
     if (lstat.isSymbolicLink()) {
       unlinkSync(path);
       return;
     }
     if (lstat.isDirectory()) {
-      rmSync(path, { recursive: true, force: true });
+      rmSync2(path, { recursive: true, force: true });
       return;
     }
     unlinkSync(path);
@@ -476,7 +629,7 @@ function removeExistingPathSafely(path) {
   }
 }
 function extractSkillDescription(canonicalSkillMdPath, fallback) {
-  if (!existsSync4(canonicalSkillMdPath)) {
+  if (!existsSync5(canonicalSkillMdPath)) {
     return fallback;
   }
   try {
@@ -526,7 +679,7 @@ function writeCursorRuleReference(targetPath, cursorRelativeRulesDir, skill, tra
     transaction.recordCreatedDir(rulesDir);
     transaction.recordBeforeWrite(targetFile);
   }
-  if (!existsSync4(rulesDir)) {
+  if (!existsSync5(rulesDir)) {
     mkdirSync(rulesDir, { recursive: true });
   }
   removeExistingPathSafely(targetFile);
@@ -596,31 +749,31 @@ var GeminiAdapter = class {
 };
 
 // src/domains/project-store/sync-project-store.ts
-import { cpSync, existsSync as existsSync6, mkdirSync as mkdirSync2, rmSync as rmSync2 } from "fs";
+import { cpSync, existsSync as existsSync7, mkdirSync as mkdirSync2, rmSync as rmSync3 } from "fs";
 import { join as join7 } from "path";
 
 // src/domains/installer/resolve-skills-source.ts
 import { fileURLToPath } from "url";
-import { dirname, resolve, join as join6 } from "path";
-import { existsSync as existsSync5 } from "fs";
+import { dirname as dirname2, resolve, join as join6 } from "path";
+import { existsSync as existsSync6 } from "fs";
 function resolveSkillsSourceRoot() {
   const currentFilePath = fileURLToPath(import.meta.url);
-  const currentDir = dirname(currentFilePath);
+  const currentDir = dirname2(currentFilePath);
   const candidateFromDist = resolve(currentDir, "../skills");
-  if (existsSync5(candidateFromDist)) {
+  if (existsSync6(candidateFromDist)) {
     return candidateFromDist;
   }
   const candidateFromSrc = resolve(currentDir, "../../../skills");
-  if (existsSync5(candidateFromSrc)) {
+  if (existsSync6(candidateFromSrc)) {
     return candidateFromSrc;
   }
   let searchDir = currentDir;
-  for (let i = 0; i < 5; i++) {
+  for (let depth = 0; depth < 5; depth++) {
     const candidate = join6(searchDir, "skills");
-    if (existsSync5(candidate)) {
+    if (existsSync6(candidate)) {
       return candidate;
     }
-    const parent = dirname(searchDir);
+    const parent = dirname2(searchDir);
     if (parent === searchDir) {
       break;
     }
@@ -638,13 +791,13 @@ function syncProjectStore(targetPath, selectedSkillIds, _selectedAgents, transac
   if (transaction) {
     transaction.recordCreatedDir(projectSkillsDir);
   }
-  if (!existsSync6(projectSkillsDir)) {
+  if (!existsSync7(projectSkillsDir)) {
     mkdirSync2(projectSkillsDir, { recursive: true });
   }
   const legacyCursorRules = join7(targetPath, ".grooveskills", "cursor-rules");
-  if (existsSync6(legacyCursorRules)) {
+  if (existsSync7(legacyCursorRules)) {
     try {
-      rmSync2(legacyCursorRules, { recursive: true, force: true });
+      rmSync3(legacyCursorRules, { recursive: true, force: true });
     } catch {
     }
   }
@@ -658,14 +811,14 @@ function syncProjectStore(targetPath, selectedSkillIds, _selectedAgents, transac
     if (transaction) {
       transaction.recordCreatedDir(destSkillDir);
     }
-    if (existsSync6(sourceSkillDir)) {
+    if (existsSync7(sourceSkillDir)) {
       cpSync(sourceSkillDir, destSkillDir, { recursive: true });
     }
   }
 }
 
 // src/domains/harness/install-harness.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync3 } from "fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync3 } from "fs";
 import { join as join10 } from "path";
 
 // src/domains/harness/harness-languages.ts
@@ -714,14 +867,14 @@ var SUPPORTED_LANGUAGES = {
 
 // src/domains/harness/harness-templates.ts
 function buildContextTemplate(detectedDependencies, language = "es", profile) {
-  const depsFormatted = detectedDependencies.length > 0 ? detectedDependencies.map((d) => `- \`${d}\``).join("\n") : "- (No external dependencies detected)";
-  const langConfig = SUPPORTED_LANGUAGES[language];
+  const dependenciesFormatted = detectedDependencies.length > 0 ? detectedDependencies.map((dependencyName) => `- \`${dependencyName}\``).join("\n") : "- (No external dependencies detected)";
+  const languageConfig = SUPPORTED_LANGUAGES[language];
   const projectName = profile?.projectName ?? "Project";
-  const pkgManager = profile?.packageManager ?? "npm";
+  const packageManager = profile?.packageManager ?? "npm";
   const commandLines = [];
   if (profile?.commands) {
-    for (const [key, cmd] of Object.entries(profile.commands)) {
-      commandLines.push(`- **${key}**: \`${cmd}\``);
+    for (const [commandKey, commandValue] of Object.entries(profile.commands)) {
+      commandLines.push(`- **${commandKey}**: \`${commandValue}\``);
     }
   }
   const commandsSection = commandLines.length > 0 ? commandLines.join("\n") : `- Build: Refer to \`package.json\` scripts.
@@ -729,62 +882,62 @@ function buildContextTemplate(detectedDependencies, language = "es", profile) {
 - Tests: Refer to test runner configuration.`;
   const aliasLines = [];
   if (profile?.pathAliases) {
-    for (const [alias, target] of Object.entries(profile.pathAliases)) {
-      aliasLines.push(`- \`${alias}\` -> \`${target}\``);
+    for (const [aliasPattern, aliasTarget] of Object.entries(profile.pathAliases)) {
+      aliasLines.push(`- \`${aliasPattern}\` -> \`${aliasTarget}\``);
     }
   }
   const aliasesSection = aliasLines.length > 0 ? `
 ### Path Aliases
 ${aliasLines.join("\n")}
 ` : "";
-  const dirLines = [];
+  const directoryLines = [];
   if (profile?.sourceDirectories && profile.sourceDirectories.length > 0) {
-    for (const dir of profile.sourceDirectories) {
-      dirLines.push(`- \`${dir}/\``);
+    for (const directoryName of profile.sourceDirectories) {
+      directoryLines.push(`- \`${directoryName}/\``);
     }
   }
-  const dirsSection = dirLines.length > 0 ? `
+  const directoriesSection = directoryLines.length > 0 ? `
 ### Source Modules
-${dirLines.join("\n")}
+${directoryLines.join("\n")}
 ` : "";
   return `# Project Context & Architecture: ${projectName}
 
 This file provides AI agents with instant architectural orientation for this project.
 
 ## 1. Stack & Dependencies
-- **Package Manager**: \`${pkgManager}\`
-${depsFormatted}
+- **Package Manager**: \`${packageManager}\`
+${dependenciesFormatted}
 
 ## 2. Directory Structure Conventions
 - Follow single-responsibility per file (<200 lines).
 - Maintain direct imports with path aliases; avoid barrel files.
 - Keep domain boundaries explicit and clean.
-${aliasesSection}${dirsSection}
+${aliasesSection}${directoriesSection}
 ## 3. Communication & User Copy Language
-- **Configured Language**: ${langConfig.nativeName} (\`${language}\`).
-- **Policy**: ${langConfig.instruction}
+- **Configured Language**: ${languageConfig.nativeName} (\`${language}\`).
+- **Policy**: ${languageConfig.instruction}
 
 ## 4. Essential Commands
 ${commandsSection}
 `;
 }
 function buildDecisionsTemplate(language = "es") {
-  const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const langConfig = SUPPORTED_LANGUAGES[language];
+  const currentDate = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const languageConfig = SUPPORTED_LANGUAGES[language];
   return `# Architecture Decision Records (ADR)
 
 An append-only log of significant technical and architectural choices.
 
 | Date | Title | Decision | Reason & Consequences |
 | :--- | :--- | :--- | :--- |
-| ${now} | Adopt GrooveSkills Harness | Initialized \`.grooveskills/\` control plane with ODD | Clean, encapsulated agent memory, 3-lane ODD flow, and ${langConfig.nativeName} copy standard |
+| ${currentDate} | Adopt GrooveSkills Harness | Initialized \`.grooveskills/\` control plane with ODD | Clean, encapsulated agent memory, 3-lane ODD flow, and ${languageConfig.nativeName} copy standard |
 `;
 }
 function buildOnboardingTaskTemplate(projectName = "Project") {
-  const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const currentDate = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   return `---
 status: pending
-createdAt: ${now}
+createdAt: ${currentDate}
 ---
 
 # 00 \u2014 Initial Project Onboarding & Architecture Exploration: ${projectName}
@@ -840,7 +993,7 @@ By [Output / Technical Change], [Outcome / Verifiable Behavior] will occur, prov
 `;
 }
 function buildAgentHarnessBlock(language = "es") {
-  const langConfig = SUPPORTED_LANGUAGES[language];
+  const languageConfig = SUPPORTED_LANGUAGES[language];
   return `<!-- grooveskills:harness:start -->
 # GrooveSkills Harness \u2014 Agent Rules & Memory
 
@@ -853,9 +1006,9 @@ This project uses the **GrooveSkills Harness** located in \`.grooveskills/\`.
 - **Lane 2 (Task)**: Direct implementation. Declare Outcome Hypothesis and checklist in \`.grooveskills/memory/tasks/<slug>.md\`. Only check off tasks with observed evidence under \`Evidence\`.
 - **Lane 3 (Spec)**: Ambiguous or high-impact architecture. Clarify and validate the spec in \`.grooveskills/memory/tasks/<slug>.md\` before writing code.
 
-## 2. User Communication Language (${langConfig.nativeName})
-- **Language**: \`${language}\` (${langConfig.nativeName}).
-- **Requirement**: ${langConfig.instruction}
+## 2. User Communication Language (${languageConfig.nativeName})
+- **Language**: \`${language}\` (${languageConfig.nativeName}).
+- **Requirement**: ${languageConfig.instruction}
 
 ## 3. Memory Locations
 - Architecture context: \`.grooveskills/memory/context.md\`
@@ -865,11 +1018,11 @@ This project uses the **GrooveSkills Harness** located in \`.grooveskills/\`.
 }
 
 // src/domains/harness/scan-project-onboarding.ts
-import { existsSync as existsSync7, readdirSync as readdirSync2, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync8, readdirSync as readdirSync2, readFileSync as readFileSync4 } from "fs";
 import { basename, join as join8 } from "path";
 function detectProjectName(targetPath) {
   const packageJsonPath = join8(targetPath, "package.json");
-  if (existsSync7(packageJsonPath)) {
+  if (existsSync8(packageJsonPath)) {
     try {
       const raw = readFileSync4(packageJsonPath, "utf-8");
       const parsed = JSON.parse(raw);
@@ -880,7 +1033,7 @@ function detectProjectName(targetPath) {
     }
   }
   const cargoPath = join8(targetPath, "Cargo.toml");
-  if (existsSync7(cargoPath)) {
+  if (existsSync8(cargoPath)) {
     try {
       const cargoRaw = readFileSync4(cargoPath, "utf-8");
       const nameMatch = cargoRaw.match(/name\s*=\s*"([^"]+)"/);
@@ -891,12 +1044,12 @@ function detectProjectName(targetPath) {
     }
   }
   const pyprojectPath = join8(targetPath, "pyproject.toml");
-  if (existsSync7(pyprojectPath)) {
+  if (existsSync8(pyprojectPath)) {
     try {
-      const pyRaw = readFileSync4(pyprojectPath, "utf-8");
-      const pyMatch = pyRaw.match(/name\s*=\s*"([^"]+)"/);
-      if (pyMatch?.[1]) {
-        return pyMatch[1];
+      const pyprojectRaw = readFileSync4(pyprojectPath, "utf-8");
+      const nameMatch = pyprojectRaw.match(/name\s*=\s*"([^"]+)"/);
+      if (nameMatch?.[1]) {
+        return nameMatch[1];
       }
     } catch {
     }
@@ -904,32 +1057,32 @@ function detectProjectName(targetPath) {
   return basename(targetPath) || "project";
 }
 function detectPackageManager(targetPath) {
-  if (existsSync7(join8(targetPath, "pnpm-lock.yaml"))) {
+  if (existsSync8(join8(targetPath, "pnpm-lock.yaml"))) {
     return "pnpm";
   }
-  if (existsSync7(join8(targetPath, "bun.lockb")) || existsSync7(join8(targetPath, "bun.lock"))) {
+  if (existsSync8(join8(targetPath, "bun.lockb")) || existsSync8(join8(targetPath, "bun.lock"))) {
     return "bun";
   }
-  if (existsSync7(join8(targetPath, "yarn.lock"))) {
+  if (existsSync8(join8(targetPath, "yarn.lock"))) {
     return "yarn";
   }
-  if (existsSync7(join8(targetPath, "package-lock.json"))) {
+  if (existsSync8(join8(targetPath, "package-lock.json"))) {
     return "npm";
   }
-  if (existsSync7(join8(targetPath, "Cargo.lock")) || existsSync7(join8(targetPath, "Cargo.toml"))) {
+  if (existsSync8(join8(targetPath, "Cargo.lock")) || existsSync8(join8(targetPath, "Cargo.toml"))) {
     return "cargo";
   }
-  if (existsSync7(join8(targetPath, "uv.lock"))) {
+  if (existsSync8(join8(targetPath, "uv.lock"))) {
     return "uv";
   }
-  if (existsSync7(join8(targetPath, "poetry.lock"))) {
+  if (existsSync8(join8(targetPath, "poetry.lock"))) {
     return "poetry";
   }
   return "npm";
 }
-function detectCommands(targetPath, pkgManager) {
+function detectCommands(targetPath, packageManager) {
   const packageJsonPath = join8(targetPath, "package.json");
-  if (!existsSync7(packageJsonPath)) {
+  if (!existsSync8(packageJsonPath)) {
     return {};
   }
   try {
@@ -937,7 +1090,7 @@ function detectCommands(targetPath, pkgManager) {
     const parsed = JSON.parse(raw);
     const scripts = parsed.scripts ?? {};
     const commands = {};
-    const runner = pkgManager === "npm" ? "npm run" : pkgManager;
+    const runner = packageManager === "npm" ? "npm run" : packageManager;
     if (scripts.build) {
       commands.build = `${runner} build`;
     }
@@ -964,7 +1117,7 @@ function detectCommands(targetPath, pkgManager) {
 }
 function detectPathAliases(targetPath) {
   const tsconfigPath = join8(targetPath, "tsconfig.json");
-  if (!existsSync7(tsconfigPath)) {
+  if (!existsSync8(tsconfigPath)) {
     return {};
   }
   try {
@@ -972,9 +1125,9 @@ function detectPathAliases(targetPath) {
     const parsed = JSON.parse(raw);
     const paths = parsed.compilerOptions?.paths ?? {};
     const aliases = {};
-    for (const [key, targets] of Object.entries(paths)) {
-      if (Array.isArray(targets) && typeof targets[0] === "string") {
-        aliases[key] = targets[0];
+    for (const [aliasKey, aliasTargets] of Object.entries(paths)) {
+      if (Array.isArray(aliasTargets) && typeof aliasTargets[0] === "string") {
+        aliases[aliasKey] = aliasTargets[0];
       }
     }
     return aliases;
@@ -984,7 +1137,7 @@ function detectPathAliases(targetPath) {
 }
 function detectSourceDirectories(targetPath) {
   const srcPath = join8(targetPath, "src");
-  const scanTarget = existsSync7(srcPath) ? srcPath : targetPath;
+  const scanTarget = existsSync8(srcPath) ? srcPath : targetPath;
   try {
     const entries = readdirSync2(scanTarget, { withFileTypes: true });
     return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => !name.startsWith(".") && name !== "node_modules" && name !== "dist");
@@ -1008,30 +1161,36 @@ function scanProjectOnboarding(targetPath) {
 }
 
 // src/domains/harness/upsert-agent-instructions.ts
-import { existsSync as existsSync8, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync5 } from "fs";
 import { join as join9 } from "path";
 var START_MARKER = "<!-- grooveskills:harness:start -->";
 var END_MARKER = "<!-- grooveskills:harness:end -->";
+function writeWithTransaction(filePath, content, transaction) {
+  const outcome = safeWriteFileSync(filePath, content);
+  if (outcome.strategy === "replaced" && transaction) {
+    transaction.recordReplacedFile(filePath, outcome.previousOwnerUid);
+  }
+}
 function applyHarnessBlock(filePath, language = "es", transaction) {
   if (transaction) {
     transaction.recordBeforeWrite(filePath);
   }
   const block = buildAgentHarnessBlock(language);
-  if (!existsSync8(filePath)) {
-    safeWriteFileSync(filePath, `${block}
-`);
+  if (!existsSync9(filePath)) {
+    writeWithTransaction(filePath, `${block}
+`, transaction);
     return;
   }
   const existingContent = readFileSync5(filePath, "utf-8");
   if (existingContent.includes(START_MARKER) && existingContent.includes(END_MARKER)) {
     const regex = new RegExp(`${START_MARKER}[\\s\\S]*?${END_MARKER}`, "g");
     const updated = existingContent.replace(regex, block);
-    safeWriteFileSync(filePath, updated);
+    writeWithTransaction(filePath, updated, transaction);
     return;
   }
   const separator = existingContent.endsWith("\n") ? "\n" : "\n\n";
-  safeWriteFileSync(filePath, `${existingContent}${separator}${block}
-`);
+  writeWithTransaction(filePath, `${existingContent}${separator}${block}
+`, transaction);
 }
 function upsertAgentInstructions(targetPath, selectedAgents, language = "es", transaction) {
   const updatedFiles = [];
@@ -1047,65 +1206,63 @@ function upsertAgentInstructions(targetPath, selectedAgents, language = "es", tr
 }
 
 // src/domains/harness/install-harness.ts
+function writeTrackedFile(filePath, content, transaction) {
+  if (transaction) {
+    transaction.recordBeforeWrite(filePath);
+  }
+  const outcome = safeWriteFileSync(filePath, content);
+  if (outcome.strategy === "replaced" && transaction) {
+    transaction.recordReplacedFile(filePath, outcome.previousOwnerUid);
+  }
+}
 function installHarness(options) {
   const memoryDir = getProjectMemoryDir(options.targetPath);
   const tasksDir = getProjectTasksDir(options.targetPath);
   const language = options.language ?? "es";
   const forceOnboarding = Boolean(options.forceOnboarding);
-  const tx = options.transaction;
-  if (tx) {
-    tx.recordCreatedDir(memoryDir);
-    tx.recordCreatedDir(tasksDir);
+  const transaction = options.transaction;
+  if (transaction) {
+    transaction.recordCreatedDir(memoryDir);
+    transaction.recordCreatedDir(tasksDir);
   }
-  if (!existsSync9(tasksDir)) {
+  if (!existsSync10(tasksDir)) {
     mkdirSync3(tasksDir, { recursive: true });
   }
   const createdFiles = [];
   const contextPath = join10(memoryDir, "context.md");
-  const shouldWriteContext = !existsSync9(contextPath) || forceOnboarding;
+  const shouldWriteContext = !existsSync10(contextPath) || forceOnboarding;
   if (shouldWriteContext) {
-    if (tx) {
-      tx.recordBeforeWrite(contextPath);
-    }
     const profile = scanProjectOnboarding(options.targetPath);
     const contextContent = buildContextTemplate(
       options.detectedDependencies,
       language,
       profile
     );
-    safeWriteFileSync(contextPath, contextContent);
+    writeTrackedFile(contextPath, contextContent, transaction);
     createdFiles.push(contextPath);
     const onboardingTaskPath = join10(tasksDir, "00-onboarding.md");
-    if (tx) {
-      tx.recordBeforeWrite(onboardingTaskPath);
-    }
-    safeWriteFileSync(
+    writeTrackedFile(
       onboardingTaskPath,
-      buildOnboardingTaskTemplate(profile.projectName)
+      buildOnboardingTaskTemplate(profile.projectName),
+      transaction
     );
     createdFiles.push(onboardingTaskPath);
   }
   const decisionsPath = join10(memoryDir, "decisions.md");
-  if (!existsSync9(decisionsPath)) {
-    if (tx) {
-      tx.recordBeforeWrite(decisionsPath);
-    }
-    safeWriteFileSync(decisionsPath, buildDecisionsTemplate(language));
+  if (!existsSync10(decisionsPath)) {
+    writeTrackedFile(decisionsPath, buildDecisionsTemplate(language), transaction);
     createdFiles.push(decisionsPath);
   }
   const templateTaskPath = join10(tasksDir, "_template.md");
-  if (!existsSync9(templateTaskPath)) {
-    if (tx) {
-      tx.recordBeforeWrite(templateTaskPath);
-    }
-    safeWriteFileSync(templateTaskPath, buildTaskTemplate());
+  if (!existsSync10(templateTaskPath)) {
+    writeTrackedFile(templateTaskPath, buildTaskTemplate(), transaction);
     createdFiles.push(templateTaskPath);
   }
   const instructions = upsertAgentInstructions(
     options.targetPath,
     options.selectedAgents,
     language,
-    tx
+    transaction
   );
   createdFiles.push(...instructions);
   return {
@@ -1115,14 +1272,14 @@ function installHarness(options) {
 }
 
 // src/domains/harness/write-project-config.ts
-import { existsSync as existsSync10, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync6 } from "fs";
 function readExistingConfig(configPath) {
   const fallback = {
     skills: [],
     agents: [],
     harness: false
   };
-  if (!existsSync10(configPath)) {
+  if (!existsSync11(configPath)) {
     return fallback;
   }
   try {
@@ -1156,21 +1313,25 @@ function writeProjectConfig(targetPath, newSkills, newAgents, harnessEnabled, la
     skills: mergedSkills,
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  safeWriteFileSync(configPath, `${JSON.stringify(config, null, 2)}
+  const outcome = safeWriteFileSync(configPath, `${JSON.stringify(config, null, 2)}
 `);
+  if (outcome.strategy === "replaced" && transaction) {
+    transaction.recordReplacedFile(configPath, outcome.previousOwnerUid);
+  }
   return configPath;
 }
 
 // src/domains/fs/install-transaction.ts
-import { existsSync as existsSync11, readdirSync as readdirSync3, readFileSync as readFileSync7, rmSync as rmSync3 } from "fs";
+import { existsSync as existsSync12, readdirSync as readdirSync3, readFileSync as readFileSync7, rmSync as rmSync4 } from "fs";
 var InstallTransaction = class {
   originalFiles = /* @__PURE__ */ new Map();
   createdDirs = [];
+  replacedFiles = [];
   recordBeforeWrite(filePath) {
     if (this.originalFiles.has(filePath)) {
       return;
     }
-    if (existsSync11(filePath)) {
+    if (existsSync12(filePath)) {
       try {
         this.originalFiles.set(filePath, readFileSync7(filePath, "utf-8"));
       } catch {
@@ -1181,42 +1342,118 @@ var InstallTransaction = class {
     }
   }
   recordCreatedDir(dirPath) {
-    if (!existsSync11(dirPath) && !this.createdDirs.includes(dirPath)) {
+    if (!existsSync12(dirPath) && !this.createdDirs.includes(dirPath)) {
       this.createdDirs.push(dirPath);
     }
   }
+  recordReplacedFile(filePath, previousOwnerUid) {
+    if (!this.replacedFiles.some((item) => item.filePath === filePath)) {
+      this.replacedFiles.push({ filePath, previousOwnerUid });
+    }
+  }
+  getReplacedFiles() {
+    return [...this.replacedFiles];
+  }
   rollback() {
     const restoredFiles = [];
     const removedFiles = [];
     const removedDirs = [];
+    const failures = [];
     for (const [filePath, content] of this.originalFiles.entries()) {
       try {
         if (content === null) {
-          if (existsSync11(filePath)) {
-            rmSync3(filePath, { force: true });
+          if (existsSync12(filePath)) {
+            rmSync4(filePath, { force: true });
             removedFiles.push(filePath);
           }
-        } else {
-          safeWriteFileSync(filePath, content);
-          restoredFiles.push(filePath);
+          continue;
         }
-      } catch {
+        if (existsSync12(filePath)) {
+          try {
+            const currentContent = readFileSync7(filePath, "utf-8");
+            if (currentContent === content) {
+              continue;
+            }
+          } catch {
+          }
+        }
+        safeWriteFileSync(filePath, content);
+        restoredFiles.push(filePath);
+      } catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        failures.push({ path: filePath, reason });
       }
     }
-    const sortedDirs = [...this.createdDirs].sort((a, b) => b.length - a.length);
-    for (const dir of sortedDirs) {
+    const sortedDirs = [...this.createdDirs].sort(
+      (firstDir, secondDir) => secondDir.length - firstDir.length
+    );
+    for (const directoryPath of sortedDirs) {
       try {
-        if (existsSync11(dir) && readdirSync3(dir).length === 0) {
-          rmSync3(dir, { recursive: true, force: true });
-          removedDirs.push(dir);
+        if (existsSync12(directoryPath) && readdirSync3(directoryPath).length === 0) {
+          rmSync4(directoryPath, { recursive: true, force: true });
+          removedDirs.push(directoryPath);
         }
-      } catch {
+      } catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        failures.push({ path: directoryPath, reason });
       }
     }
-    return { restoredFiles, removedFiles, removedDirs };
+    return {
+      restoredFiles,
+      removedFiles,
+      removedDirs,
+      failures,
+      isClean: failures.length === 0
+    };
   }
 };
 
+// src/domains/fs/preflight-write-check.ts
+import { join as join11 } from "path";
+function canRecoverOrWriteTarget(filePath) {
+  const diagnosis = inspectFileAccess(filePath);
+  if (diagnosis.immutableFlag) {
+    throw new FilePermissionError(filePath, diagnosis);
+  }
+  if (!diagnosis.exists) {
+    if (!diagnosis.dirWritable) {
+      throw new FilePermissionError(filePath, diagnosis);
+    }
+    return;
+  }
+  const ownerWritable = diagnosis.ownedByCurrentUser && ((diagnosis.mode ?? 0) & 128) !== 0;
+  if (ownerWritable) {
+    return;
+  }
+  if (diagnosis.ownedByCurrentUser) {
+    return;
+  }
+  if (diagnosis.dirWritable) {
+    return;
+  }
+  throw new FilePermissionError(filePath, diagnosis);
+}
+function runPreflightWriteCheck(options) {
+  const memoryDir = getProjectMemoryDir(options.targetPath);
+  const tasksDir = getProjectTasksDir(options.targetPath);
+  const candidatePaths = [
+    join11(options.targetPath, "AGENTS.md")
+  ];
+  if (options.selectedAgents.includes("claude")) {
+    candidatePaths.push(join11(options.targetPath, "CLAUDE.md"));
+  }
+  candidatePaths.push(
+    getProjectConfigPath(options.targetPath),
+    join11(memoryDir, "context.md"),
+    join11(memoryDir, "decisions.md"),
+    join11(tasksDir, "00-onboarding.md"),
+    join11(tasksDir, "_template.md")
+  );
+  for (const filePath of candidatePaths) {
+    canRecoverOrWriteTarget(filePath);
+  }
+}
+
 // src/errors/install-transaction-error.ts
 var InstallTransactionError = class extends Error {
   stage;
@@ -1225,7 +1462,7 @@ var InstallTransactionError = class extends Error {
   suggestedFix;
   constructor(options) {
     const rawMessage = options.cause instanceof Error ? options.cause.message : String(options.cause);
-    super(`Error durante la etapa '${options.stage}': ${rawMessage}`);
+    super(`Error during stage '${options.stage}': ${rawMessage}`);
     this.name = "InstallTransactionError";
     this.stage = options.stage;
     this.causeError = options.cause;
@@ -1245,10 +1482,10 @@ function formatSuggestedFix(cause) {
   if (cause instanceof FilePermissionError) {
     return cause.suggestedFixCommand;
   }
-  const err = cause;
-  if (err?.code === "EACCES" || err?.code === "EPERM") {
-    if (err.path) {
-      return `chmod u+w "${err.path}"`;
+  const nodeError = cause;
+  if (nodeError?.code === "EACCES" || nodeError?.code === "EPERM") {
+    if (nodeError.path) {
+      return `chmod u+w "${nodeError.path}"`;
     }
   }
   return void 0;
@@ -1262,18 +1499,23 @@ async function installSkills(options) {
   if (!skillsToInstall.includes("odd-ai")) {
     skillsToInstall.push("odd-ai");
   }
-  let currentStage = "Sincronizaci\xF3n del almac\xE9n de skills (.grooveskills/skills)";
+  let currentStage = "Preflight check";
   try {
+    runPreflightWriteCheck({
+      targetPath: options.targetPath,
+      selectedAgents: options.selectedAgents
+    });
+    currentStage = "Syncing skills store (.grooveskills/skills)";
     syncProjectStore(options.targetPath, skillsToInstall, options.selectedAgents, transaction);
     const projectSkillsDir = getProjectSkillsDir(options.targetPath);
     const createdFiles = [];
-    currentStage = "Configuraci\xF3n de referencias de agentes (.agents, .claude, etc.)";
+    currentStage = "Configuring agent references (.agents, .claude, etc.)";
     for (const skillId of skillsToInstall) {
-      const skill = SKILL_CATALOG.find((item) => item.id === skillId);
+      const skill = SKILL_CATALOG.find((catalogItem) => catalogItem.id === skillId);
       if (!skill) {
         continue;
       }
-      const skillSourceDir = join11(projectSkillsDir, skill.directoryName);
+      const skillSourceDir = join12(projectSkillsDir, skill.directoryName);
       for (const agentId of options.selectedAgents) {
         const adapter = ADAPTER_REGISTRY[agentId];
         if (!adapter) {
@@ -1288,7 +1530,7 @@ async function installSkills(options) {
         createdFiles.push(...files);
       }
     }
-    currentStage = "Instalaci\xF3n del Groove Harness (contexto, decisiones, tareas e instrucciones)";
+    currentStage = "Installing Groove Harness (context, decisions, tasks, and instructions)";
     const harnessResult = installHarness({
       targetPath: options.targetPath,
       selectedAgents: options.selectedAgents,
@@ -1299,7 +1541,7 @@ async function installSkills(options) {
       transaction
     });
     createdFiles.push(...harnessResult.createdFiles);
-    currentStage = "Persistencia de la configuraci\xF3n del proyecto (.grooveskills/config.json)";
+    currentStage = "Persisting project configuration (.grooveskills/config.json)";
     const configPath = writeProjectConfig(
       options.targetPath,
       skillsToInstall,
@@ -1314,7 +1556,8 @@ async function installSkills(options) {
       configuredAgents: options.selectedAgents,
       createdFiles,
       harnessInitialized: harnessResult.onboardingInitialized,
-      language: options.language
+      language: options.language,
+      replacedFiles: transaction.getReplacedFiles()
     };
   } catch (cause) {
     const rollbackReport = transaction.rollback();
@@ -1329,18 +1572,69 @@ async function installSkills(options) {
 }
 
 // src/domains/ui/render-onboarding-prompt.ts
-import pc2 from "picocolors";
+import picocolors2 from "picocolors";
+
+// src/domains/ui/terminal-layout.ts
+function getTerminalWidth(fallbackWidth = 80) {
+  const terminalColumns = process.stdout.columns;
+  if (typeof terminalColumns === "number" && terminalColumns > 20) {
+    return Math.min(terminalColumns, 100);
+  }
+  return fallbackWidth;
+}
+function wrapText(rawText, maxLineWidth = 76) {
+  return rawText.split("\n").map((line) => {
+    if (line.length <= maxLineWidth) {
+      return line;
+    }
+    const words = line.split(" ");
+    const wrappedLines = [];
+    let currentLine = "";
+    for (const word of words) {
+      const potentialLine = currentLine ? `${currentLine} ${word}` : word;
+      if (potentialLine.length <= maxLineWidth) {
+        currentLine = potentialLine;
+      } else {
+        if (currentLine) {
+          wrappedLines.push(currentLine);
+        }
+        currentLine = word;
+      }
+    }
+    if (currentLine) {
+      wrappedLines.push(currentLine);
+    }
+    return wrappedLines.join("\n");
+  }).join("\n");
+}
+
+// src/domains/ui/render-onboarding-prompt.ts
 function formatOnboardingPrompt(language = "es") {
-  const langConfig = SUPPORTED_LANGUAGES[language] ?? SUPPORTED_LANGUAGES.es;
-  const title = langConfig.onboardingPromptTitle;
-  const prompt = langConfig.onboardingPrompt;
-  const separator = pc2.cyan("\u2500".repeat(60));
+  const languageConfig = SUPPORTED_LANGUAGES[language] ?? SUPPORTED_LANGUAGES.es;
+  const title = languageConfig.onboardingPromptTitle;
+  const prompt = languageConfig.onboardingPrompt;
+  const boxWidth = Math.max(getTerminalWidth(80) - 4, 50);
+  const contentWidth = boxWidth - 4;
+  const wrappedPromptLines = wrapText(prompt, contentWidth).split("\n");
+  const borderHorizontal = "\u2500".repeat(boxWidth - 2);
+  const badgeText = " COPY & PASTE PROMPT FOR YOUR AI AGENT ";
+  const badgePadded = badgeText.padEnd(contentWidth, " ");
+  const topBorder = picocolors2.cyan(`\u256D${borderHorizontal}\u256E`);
+  const badgeLine = `${picocolors2.cyan("\u2502 ")}${picocolors2.bold(picocolors2.bgCyan(picocolors2.black(badgePadded)))}${picocolors2.cyan(" \u2502")}`;
+  const dividerLine = picocolors2.cyan(`\u251C${borderHorizontal}\u2524`);
+  const promptLines = wrappedPromptLines.map((line) => {
+    const paddedLine = line.padEnd(contentWidth, " ");
+    return `${picocolors2.cyan("\u2502 ")}${picocolors2.bold(picocolors2.white(paddedLine))}${picocolors2.cyan(" \u2502")}`;
+  });
+  const bottomBorder = picocolors2.cyan(`\u2570${borderHorizontal}\u256F`);
   const formattedOutput = [
-    separator,
-    pc2.bold(pc2.yellow(title)),
     "",
-    pc2.green(prompt),
-    separator
+    topBorder,
+    badgeLine,
+    dividerLine,
+    ...promptLines,
+    bottomBorder,
+    ""
   ].join("\n");
   return {
     title,
@@ -1349,75 +1643,133 @@ function formatOnboardingPrompt(language = "es") {
   };
 }
 
+// src/domains/ui/render-install-report.ts
+import { basename as basename2 } from "path";
+import { userInfo } from "os";
+import * as prompts5 from "@clack/prompts";
+import picocolors3 from "picocolors";
+function getCurrentUsername() {
+  try {
+    return userInfo().username;
+  } catch {
+    return process.env.USER || process.env.LOGNAME || "current user";
+  }
+}
+function formatReplacedFileNotes(replacedFiles = []) {
+  if (replacedFiles.length === 0) {
+    return [];
+  }
+  const currentUser = getCurrentUsername();
+  return replacedFiles.map((replacedItem) => {
+    const fileName = basename2(replacedItem.filePath);
+    const previousOwner = formatOwnerName(replacedItem.previousOwnerUid);
+    return picocolors3.yellow(
+      `Note: ${fileName} was owned by ${previousOwner}. It was replaced atomically and is now owned by ${currentUser}.`
+    );
+  });
+}
+function renderInstallFailure(error) {
+  const { stage, causeError, rollbackReport, suggestedFix } = error;
+  const causeMessage = causeError instanceof Error ? causeError.message : String(causeError);
+  const nothingTouched = rollbackReport.restoredFiles.length === 0 && rollbackReport.removedFiles.length === 0 && rollbackReport.removedDirs.length === 0 && rollbackReport.failures.length === 0;
+  const safeMaxWidth = Math.max(getTerminalWidth(80) - 10, 50);
+  const lines = [
+    wrapText(`${picocolors3.bold("Failed stage:")}  ${picocolors3.yellow(stage)}`, safeMaxWidth),
+    wrapText(`${picocolors3.bold("Cause:")}         ${picocolors3.red(causeMessage)}`, safeMaxWidth)
+  ];
+  if (nothingTouched) {
+    lines.push(`${picocolors3.bold("Rollback:")}      Nothing to roll back, no files were modified.`);
+  } else {
+    lines.push(
+      "",
+      picocolors3.bold("Rollback summary:"),
+      ` \u2022 Restored files: ${picocolors3.cyan(String(rollbackReport.restoredFiles.length))}`,
+      ` \u2022 Removed temporary files: ${picocolors3.cyan(String(rollbackReport.removedFiles.length))}`,
+      ` \u2022 Removed empty directories: ${picocolors3.cyan(String(rollbackReport.removedDirs.length))}`
+    );
+    if (!rollbackReport.isClean) {
+      lines.push("", picocolors3.red("Rollback was incomplete. These files may need manual review:"));
+      for (const failure of rollbackReport.failures) {
+        lines.push(wrapText(` \u2022 ${failure.path} (${failure.reason})`, safeMaxWidth));
+      }
+    }
+  }
+  if (suggestedFix) {
+    lines.push(wrapText(`${picocolors3.bold("Suggested fix:")} ${picocolors3.green(suggestedFix)}`, safeMaxWidth));
+  }
+  prompts5.note(lines.join("\n"), "Installation Aborted");
+  if (!rollbackReport.isClean) {
+    prompts5.outro(
+      picocolors3.red(
+        "Rollback was incomplete. Please review the files listed above and apply the suggested fix."
+      )
+    );
+    return;
+  }
+  prompts5.outro(
+    picocolors3.yellow(
+      nothingTouched ? "No files were modified. Apply the suggested fix and try again." : "Your project was restored to its previous state. Apply the suggested fix and try again."
+    )
+  );
+}
+
 // src/domains/ui/ui-orchestrator.ts
 async function resolveLanguageSelection(harnessExists, configuredLanguage, forceOnboarding) {
   if (harnessExists && !forceOnboarding) {
     return configuredLanguage ?? "es";
   }
-  const langChoice = await promptLanguage(configuredLanguage ?? "es");
-  if (p5.isCancel(langChoice)) {
-    p5.cancel("Instalaci\xF3n cancelada. \xA1Que tengas un excelente d\xEDa!");
+  const languageSelection = await promptLanguage(configuredLanguage ?? "es");
+  if (prompts6.isCancel(languageSelection)) {
+    prompts6.cancel("Installation cancelled. Have a wonderful day!");
     process.exit(0);
   }
-  return langChoice;
+  return languageSelection;
 }
 async function resolveOverwriteConfirmation(targetPath, selectedSkills, selectedAgents) {
   const anyExists = selectedSkills.some((skillId) => {
-    const meta = SKILL_CATALOG.find((s) => s.id === skillId);
-    return meta ? verifySkillExists(targetPath, meta.directoryName, selectedAgents) : false;
+    const skillMetadata = SKILL_CATALOG.find((skill) => skill.id === skillId);
+    return skillMetadata ? verifySkillExists(targetPath, skillMetadata.directoryName, selectedAgents) : false;
   });
   if (!anyExists) {
     return true;
   }
-  const confirm2 = await promptConfirmOverwrite();
-  if (p5.isCancel(confirm2) || !confirm2) {
-    p5.cancel("Instalaci\xF3n detenida para proteger las skills existentes.");
+  const overwriteConfirmed = await promptConfirmOverwrite();
+  if (prompts6.isCancel(overwriteConfirmed) || !overwriteConfirmed) {
+    prompts6.cancel("Installation stopped to protect existing skills.");
     process.exit(0);
   }
-  return Boolean(confirm2);
-}
-function renderInstallFailure(error) {
-  const { stage, causeError, rollbackReport, suggestedFix } = error;
-  const rawMsg = causeError instanceof Error ? causeError.message : String(causeError);
-  const lines = [
-    `${pc3.bold("Fase afectada:")} ${pc3.yellow(stage)}`,
-    `${pc3.bold("Causa:")} ${pc3.red(rawMsg)}`,
-    "",
-    pc3.bold("Reporte de Rollback autom\xE1tico:"),
-    ` \u2022 Archivos restaurados a su estado previo: ${pc3.cyan(String(rollbackReport.restoredFiles.length))}`,
-    ` \u2022 Archivos temporales eliminados: ${pc3.cyan(String(rollbackReport.removedFiles.length))}`,
-    ` \u2022 Directorios vac\xEDos eliminados: ${pc3.cyan(String(rollbackReport.removedDirs.length))}`
-  ];
-  if (suggestedFix) {
-    lines.push(
-      "",
-      pc3.bold("Soluci\xF3n recomendada:"),
-      ` Ejecuta en tu terminal: ${pc3.green(suggestedFix)}`
-    );
-  }
-  p5.note(lines.join("\n"), "Detalles de la interrupci\xF3n y reversi\xF3n");
-  p5.outro(pc3.yellow("Tu proyecto no sufri\xF3 alteraciones y se preserv\xF3 intacto. Corrige la causa y vuelve a intentarlo cuando gustes."));
+  return Boolean(overwriteConfirmed);
 }
 async function runInteractiveUi(context, forceOnboarding = false) {
   console.log(renderBanner());
-  p5.intro(pc3.magenta("\xA1Bienvenido a GrooveSkills! Configuremos tus agentes de IA con est\xE1ndares limpios de arquitectura."));
+  prompts6.intro(
+    picocolors4.magenta(
+      "Welcome to GrooveSkills! Let's tailor your AI agents with clean architectural standards."
+    )
+  );
+  const safeMaxWidth = Math.max(getTerminalWidth(80) - 10, 50);
   if (context.detectedDependencies.length > 0) {
-    const harnessInfo = context.harnessExists && !forceOnboarding ? pc3.green(`Activo (.grooveskills/memory, idioma: ${context.configuredLanguage ?? "es"})`) : pc3.cyan("Ser\xE1 inicializado");
-    p5.note(
-      `Dependencias detectadas: ${context.detectedDependencies.map((d) => pc3.bold(d)).join(", ")}
-Carpetas de IA activas: ${context.detectedAgents.map((a) => pc3.green(a)).join(", ") || "Ninguna (se crear\xE1n)"}
+    const harnessInfo = context.harnessExists && !forceOnboarding ? picocolors4.green(
+      `Active (.grooveskills/memory, lang: ${context.configuredLanguage ?? "es"})`
+    ) : picocolors4.cyan("Will be initialized");
+    const formattedDependencies = context.detectedDependencies.map((dependencyName) => picocolors4.bold(dependencyName)).join(", ");
+    const formattedAgents = context.detectedAgents.map((agentName) => picocolors4.green(agentName)).join(", ") || "None (will be created)";
+    const environmentNote = wrapText(
+      `Detected dependencies: ${formattedDependencies}
+Active AI folders: ${formattedAgents}
 GrooveSkills Harness: ${harnessInfo}`,
-      "Entorno del Proyecto"
+      safeMaxWidth
     );
+    prompts6.note(environmentNote, "Project Environment");
   }
   const selectedSkills = await promptSkills(context.suggestedSkillIds);
-  if (p5.isCancel(selectedSkills)) {
-    p5.cancel("Instalaci\xF3n cancelada. \xA1Que tengas un excelente d\xEDa!");
+  if (prompts6.isCancel(selectedSkills)) {
+    prompts6.cancel("Installation cancelled. Have a wonderful day!");
     process.exit(0);
   }
   const selectedAgents = await promptAgents(context.detectedAgents);
-  if (p5.isCancel(selectedAgents)) {
-    p5.cancel("Instalaci\xF3n cancelada. \xA1Que tengas un excelente d\xEDa!");
+  if (prompts6.isCancel(selectedAgents)) {
+    prompts6.cancel("Installation cancelled. Have a wonderful day!");
     process.exit(0);
   }
   const selectedLanguage = await resolveLanguageSelection(
@@ -1430,10 +1782,10 @@ GrooveSkills Harness: ${harnessInfo}`,
     selectedSkills,
     selectedAgents
   );
-  const s = p5.spinner();
-  s.start("Instalando y adaptando skills para tus agentes de IA configurados...");
+  const installSpinner = prompts6.spinner();
+  installSpinner.start("Installing and adapting skills across your configured AI agents...");
   try {
-    const result = await installSkills({
+    const installResult = await installSkills({
       targetPath: context.targetPath,
       selectedSkillIds: selectedSkills,
       selectedAgents,
@@ -1443,24 +1795,32 @@ GrooveSkills Harness: ${harnessInfo}`,
       language: selectedLanguage,
       forceOnboarding
     });
-    s.stop(pc3.green("\xA1Todas las skills y el harness fueron configurados exitosamente!"));
-    const harnessStatus = result.harnessInitialized ? pc3.green(`Inicializado en .grooveskills/ (Idioma: ${selectedLanguage})`) : pc3.cyan(`Preservado en .grooveskills/ (Idioma: ${selectedLanguage})`);
-    p5.note(
-      `Skills configuradas: ${result.installedSkills.map((sk) => pc3.bold(sk)).join(", ")}
-Agentes objetivo: ${result.configuredAgents.map((a) => pc3.cyan(a)).join(", ")}
-GrooveSkills Harness: ${harnessStatus}`,
-      "Resumen de Instalaci\xF3n"
+    installSpinner.stop(
+      picocolors4.green("All skills and harness have been successfully configured!")
     );
-    if (result.harnessInitialized) {
+    const harnessStatus = installResult.harnessInitialized ? picocolors4.green(`Initialized in .grooveskills/ (Language: ${selectedLanguage})`) : picocolors4.cyan(`Preserved in .grooveskills/ (Language: ${selectedLanguage})`);
+    const formattedInstalledSkills = installResult.installedSkills.map((skillId) => picocolors4.bold(skillId)).join(", ");
+    const formattedConfiguredAgents = installResult.configuredAgents.map((agentId) => picocolors4.cyan(agentId)).join(", ");
+    const summaryLines = [
+      wrapText(`Configured skills: ${formattedInstalledSkills}`, safeMaxWidth),
+      `Target agents: ${formattedConfiguredAgents}`,
+      `GrooveSkills Harness: ${harnessStatus}`,
+      ...formatReplacedFileNotes(installResult.replacedFiles).map(
+        (note3) => wrapText(note3, safeMaxWidth)
+      )
+    ];
+    prompts6.note(summaryLines.join("\n"), "Installation Summary");
+    if (installResult.harnessInitialized) {
       const promptRender = formatOnboardingPrompt(selectedLanguage);
-      p5.note(
-        pc3.green(promptRender.prompt),
-        promptRender.title
-      );
+      console.log(promptRender.formattedOutput);
     }
-    p5.outro(pc3.green("\xA1Tus agentes de IA ahora est\xE1n potenciados con los h\xE1bitos arquitect\xF3nicos de tu equipo! \u{1F680}"));
+    prompts6.outro(
+      picocolors4.green(
+        "Your AI programming pair is now empowered with your team's architectural habits! \u{1F680}"
+      )
+    );
   } catch (error) {
-    s.stop(pc3.yellow("La instalaci\xF3n no pudo completarse."));
+    installSpinner.stop(picocolors4.yellow("Installation could not be completed."));
     if (error instanceof InstallTransactionError) {
       renderInstallFailure(error);
       return;
@@ -1470,6 +1830,13 @@ GrooveSkills Harness: ${harnessStatus}`,
 }
 
 // src/main.ts
+function resolveUsername() {
+  try {
+    return userInfo2().username;
+  } catch {
+    return process.env.USER || process.env.LOGNAME || "current user";
+  }
+}
 async function runGrooveSkills(options = {}) {
   const targetPath = process.cwd();
   const context = detectProjectContext(targetPath);
@@ -1489,6 +1856,18 @@ async function runGrooveSkills(options = {}) {
       language,
       forceOnboarding: options.forceOnboarding
     });
+    if (result.replacedFiles && result.replacedFiles.length > 0) {
+      const currentUser = resolveUsername();
+      for (const replacedItem of result.replacedFiles) {
+        const fileName = basename3(replacedItem.filePath);
+        const previousOwner = formatOwnerName(replacedItem.previousOwnerUid);
+        console.log(
+          picocolors5.yellow(
+            `Note: ${fileName} was owned by ${previousOwner}. It was replaced atomically and is now owned by ${currentUser}.`
+          )
+        );
+      }
+    }
     if (result.harnessInitialized) {
       const promptRender = formatOnboardingPrompt(language);
       console.log(`
@@ -1504,4 +1883,4 @@ export {
   InstallTransactionError,
   runGrooveSkills
 };
-//# sourceMappingURL=chunk-E63GTCOE.js.map
+//# sourceMappingURL=chunk-KPDHH2AZ.js.map