argos-harness 0.1.0

package/dist/commands/remove.js

@@ -0,0 +1,487 @@
+import { defineCommand } from "citty";
+import { existsSync, readdirSync, readFileSync, rmSync, rmdirSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import pc from "picocolors";
+import { listSkillFiles, listSkillIds, MANAGED_BLOCK_IDS, resolveAssetsDir } from "../lib/assets.js";
+import { writeFileAtomic } from "../lib/atomic-write.js";
+import { createBackup } from "../lib/backup.js";
+import { listBlocks, removeBlock } from "../lib/markers.js";
+import { hasArgosFileMarker, hasArgosShellFileMarker } from "../lib/managed-files.js";
+import { resolveArgosHome, resolveClaudeDir } from "../lib/paths.js";
+import { removeAllArgosHooksFromSettings } from "../lib/settings-merge.js";
+const STATUS_COUNT_ORDER = [
+    "removed",
+    "would-remove",
+    "skipped-foreign",
+    "info",
+    "warning",
+    "error"
+];
+function summarize(rows, apply) {
+    const counts = {
+        removed: 0,
+        "would-remove": 0,
+        "skipped-foreign": 0,
+        info: 0,
+        warning: 0,
+        error: 0
+    };
+    for (const row of rows)counts[row.status]++;
+    const parts = STATUS_COUNT_ORDER.filter((s)=>counts[s] > 0).map((s)=>`${counts[s]} ${s}`);
+    const verb = apply ? "argos remove" : "argos remove (preview — nada se tocó)";
+    return parts.length === 0 ? `${verb}: nada que hacer.` : `${verb}: ${parts.join(", ")}.`;
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Strip every present managed block from CLAUDE.md; delete the file entirely if it becomes empty. */ function processClaudeMd(claudeDir, apply, rows) {
+    const claudeMdPath = join(claudeDir, "CLAUDE.md");
+    if (!existsSync(claudeMdPath)) return;
+    let claudeMd;
+    try {
+        claudeMd = readFileSync(claudeMdPath, "utf-8");
+    } catch (err) {
+        rows.push({
+            path: "CLAUDE.md",
+            category: "claude-md-block",
+            status: "error",
+            detail: errorMessage(err)
+        });
+        return;
+    }
+    let next = claudeMd;
+    const removedIds = [];
+    for (const id of MANAGED_BLOCK_IDS){
+        const hadBlock = listBlocks(next).some((b)=>b.id === id);
+        if (!hadBlock) continue;
+        const beforeThisId = next;
+        // removeBlock only strips the first occurrence — loop to self-heal any
+        // crash-residue duplicates left by injectBlock (see lib/markers.ts).
+        // Progress-guarded: a dangling open marker with no matching close (see
+        // lib/markers.ts's findBlock/listDanglingBlockIds) makes removeBlock a
+        // no-op — its output equals its input — which would otherwise spin this
+        // loop forever since listBlocks still reports the id as present. Break
+        // and surface it as a warning instead of hanging.
+        while(listBlocks(next).some((b)=>b.id === id)){
+            const before = next;
+            next = removeBlock(next, id);
+            if (next === before) {
+                rows.push({
+                    path: "CLAUDE.md",
+                    category: "claude-md-block",
+                    status: "warning",
+                    detail: "marker argos huérfano sin cierre en CLAUDE.md — remuévelo a mano"
+                });
+                break;
+            }
+        }
+        if (next !== beforeThisId) removedIds.push(id);
+    }
+    if (removedIds.length === 0) return;
+    for (const id of removedIds){
+        rows.push({
+            path: `CLAUDE.md#${id}`,
+            category: "claude-md-block",
+            status: apply ? "removed" : "would-remove"
+        });
+    }
+    if (!apply) return;
+    try {
+        if (next.trim().length === 0) {
+            rmSync(claudeMdPath, {
+                force: true
+            });
+        } else {
+            writeFileAtomic(claudeMdPath, next);
+        }
+    } catch (err) {
+        rows.push({
+            path: "CLAUDE.md",
+            category: "claude-md-block",
+            status: "error",
+            detail: errorMessage(err)
+        });
+    }
+}
+function walkFiles(dir) {
+    if (!existsSync(dir)) return [];
+    const out = [];
+    for (const entry of readdirSync(dir, {
+        withFileTypes: true
+    })){
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) out.push(...walkFiles(full));
+        else if (entry.isFile()) out.push(full);
+    }
+    return out;
+}
+/** Remove now-empty directories bottom-up under `dir`, leaving any dir that still holds foreign content. */ function removeEmptyDirsUnder(dir) {
+    if (!existsSync(dir)) return;
+    for (const entry of readdirSync(dir, {
+        withFileTypes: true
+    })){
+        if (entry.isDirectory()) removeEmptyDirsUnder(join(dir, entry.name));
+    }
+    const remaining = existsSync(dir) ? readdirSync(dir) : [];
+    if (remaining.length === 0) {
+        try {
+            rmdirSync(dir);
+        } catch  {
+        // Best-effort cleanup — a leftover empty dir is cosmetic, not an error.
+        }
+    }
+}
+/**
+ * Remove every Argos-owned file (carrying the ownership marker) under
+ * `claudeDir/<topDir>`, recursively — skills live in subdirectories, hence
+ * the recursive walk. Foreign files (no marker) are reported
+ * "skipped-foreign" and left byte-identical.
+ */ function processManagedDir(claudeDir, topDir, category, hasMarker, apply, rows) {
+    const dirPath = join(claudeDir, topDir);
+    const files = walkFiles(dirPath);
+    for (const file of files){
+        const relPath = relative(claudeDir, file);
+        let content;
+        try {
+            content = readFileSync(file, "utf-8");
+        } catch (err) {
+            rows.push({
+                path: relPath,
+                category,
+                status: "error",
+                detail: errorMessage(err)
+            });
+            continue;
+        }
+        if (!hasMarker(content)) {
+            rows.push({
+                path: relPath,
+                category,
+                status: "skipped-foreign"
+            });
+            continue;
+        }
+        if (!apply) {
+            rows.push({
+                path: relPath,
+                category,
+                status: "would-remove"
+            });
+            continue;
+        }
+        try {
+            rmSync(file, {
+                force: true
+            });
+            rows.push({
+                path: relPath,
+                category,
+                status: "removed"
+            });
+        } catch (err) {
+            rows.push({
+                path: relPath,
+                category,
+                status: "error",
+                detail: errorMessage(err)
+            });
+        }
+    }
+    if (apply) removeEmptyDirsUnder(dirPath);
+}
+/**
+ * Remove Argos-owned skill directories under `claudeDir/skills/`.
+ *
+ * Unlike `processManagedDir` (per-file marker check), ownership here is
+ * decided PER SKILL DIRECTORY: the skill's `SKILL.md` `argos:file` marker is
+ * the sentinel (mirrors the install policy in commands/init.ts). Supporting
+ * files (`references/*.md`, `phases/*.md`, etc.) never carry a marker of
+ * their own, so a per-file marker check would wrongly treat every one of
+ * them as foreign.
+ * - `SKILL.md` missing, or present without the marker → the whole directory
+ *   is foreign (or not argos-installed at all); every file under it is left
+ *   untouched, reported "skipped-foreign".
+ * - `SKILL.md` present with the marker → argos-owned. Only the files the
+ *   CURRENTLY shipped asset manifest lists for that skill id
+ *   (`listSkillFiles`) are removed; anything else in the directory — a
+ *   user-added extra file, or every file if this CLI version no longer
+ *   ships the skill at all — is left in place.
+ */ function processSkillsDir(claudeDir, apply, rows) {
+    const skillsRoot = join(claudeDir, "skills");
+    if (!existsSync(skillsRoot)) return;
+    const assetsDir = resolveAssetsDir();
+    const shippedSkillIds = new Set(listSkillIds(assetsDir));
+    for (const entry of readdirSync(skillsRoot, {
+        withFileTypes: true
+    })){
+        if (!entry.isDirectory()) continue; // skills/ only ever holds skill subdirectories
+        const skillId = entry.name;
+        const skillDir = join(skillsRoot, skillId);
+        const skillMdPath = join(skillDir, "SKILL.md");
+        let skillMdContent = null;
+        if (existsSync(skillMdPath)) {
+            try {
+                skillMdContent = readFileSync(skillMdPath, "utf-8");
+            } catch (err) {
+                rows.push({
+                    path: relative(claudeDir, skillMdPath),
+                    category: "skills-file",
+                    status: "error",
+                    detail: errorMessage(err)
+                });
+                continue;
+            }
+        }
+        const isArgosOwned = skillMdContent !== null && hasArgosFileMarker(skillMdContent);
+        const manifest = isArgosOwned && shippedSkillIds.has(skillId) ? new Set(listSkillFiles(assetsDir, skillId)) : new Set();
+        for (const file of walkFiles(skillDir)){
+            const relToClaudeDir = relative(claudeDir, file);
+            if (!isArgosOwned || !manifest.has(relative(skillDir, file).split(sep).join("/"))) {
+                rows.push({
+                    path: relToClaudeDir,
+                    category: "skills-file",
+                    status: "skipped-foreign"
+                });
+                continue;
+            }
+            if (!apply) {
+                rows.push({
+                    path: relToClaudeDir,
+                    category: "skills-file",
+                    status: "would-remove"
+                });
+                continue;
+            }
+            try {
+                rmSync(file, {
+                    force: true
+                });
+                rows.push({
+                    path: relToClaudeDir,
+                    category: "skills-file",
+                    status: "removed"
+                });
+            } catch (err) {
+                rows.push({
+                    path: relToClaudeDir,
+                    category: "skills-file",
+                    status: "error",
+                    detail: errorMessage(err)
+                });
+            }
+        }
+    }
+    if (apply) removeEmptyDirsUnder(skillsRoot);
+}
+const PURGE_FILES = [
+    "global.json",
+    "workspaces.json"
+];
+function processPurge(apply, rows, warnings) {
+    const argosHome = resolveArgosHome();
+    for (const name of PURGE_FILES){
+        const p = join(argosHome, name);
+        if (!existsSync(p)) continue;
+        const label = join("~", ".argos", name);
+        if (!apply) {
+            rows.push({
+                path: label,
+                category: "argos-home",
+                status: "would-remove"
+            });
+            continue;
+        }
+        try {
+            rmSync(p, {
+                force: true
+            });
+            rows.push({
+                path: label,
+                category: "argos-home",
+                status: "removed"
+            });
+        } catch (err) {
+            rows.push({
+                path: label,
+                category: "argos-home",
+                status: "error",
+                detail: errorMessage(err)
+            });
+        }
+    }
+    // Backups LAST, and always explicitly flagged: they're the safety net for
+    // every previous (and this very) destructive operation, so purging them
+    // removes the one thing that could otherwise undo a mistake.
+    const backupsDir = join(argosHome, "backups");
+    const backupsLabel = join("~", ".argos", "backups");
+    if (existsSync(backupsDir)) {
+        warnings.push("--purge elimina ~/.argos/backups — se pierde la red de seguridad de esta y de toda operación anterior.");
+        if (!apply) {
+            rows.push({
+                path: backupsLabel,
+                category: "argos-home",
+                status: "would-remove"
+            });
+        } else {
+            try {
+                rmSync(backupsDir, {
+                    recursive: true,
+                    force: true
+                });
+                rows.push({
+                    path: backupsLabel,
+                    category: "argos-home",
+                    status: "removed"
+                });
+            } catch (err) {
+                rows.push({
+                    path: backupsLabel,
+                    category: "argos-home",
+                    status: "error",
+                    detail: errorMessage(err)
+                });
+            }
+        }
+    }
+}
+/**
+ * Core, testable implementation of `argos remove`: uninstalls everything
+ * `runInit` (commands/init.ts) installs into `resolveClaudeDir()`. Pure
+ * function of the filesystem — no process.exit, no console output.
+ *
+ * Preview by default (`apply: false`): computes the full report without
+ * writing anything. `apply: true` performs the removal, backing up
+ * everything affected first (same `createBackup` call `runInit` makes,
+ * before any mutation). `purge: true` additionally removes `~/.argos` data
+ * (kept by default) — backups are removed last and always warned about.
+ */ export function runRemove(options = {}) {
+    const apply = options.apply ?? false;
+    const purge = options.purge ?? false;
+    const claudeDir = resolveClaudeDir();
+    const rows = [];
+    const warnings = [];
+    let backupPath;
+    if (apply) {
+        try {
+            backupPath = createBackup(claudeDir, [
+                "CLAUDE.md",
+                "agents",
+                "skills",
+                "output-styles",
+                "hooks",
+                "settings.json"
+            ]);
+        } catch (err) {
+            const detail = errorMessage(err);
+            rows.push({
+                path: "backup",
+                category: "argos-home",
+                status: "error",
+                detail
+            });
+            return {
+                rows,
+                summary: `backup falló — no se tocó nada (${detail}).`,
+                exitCode: 1,
+                warnings
+            };
+        }
+    }
+    processClaudeMd(claudeDir, apply, rows);
+    processManagedDir(claudeDir, "agents", "agents-file", hasArgosFileMarker, apply, rows);
+    processSkillsDir(claudeDir, apply, rows);
+    processManagedDir(claudeDir, "output-styles", "output-styles-file", hasArgosFileMarker, apply, rows);
+    processManagedDir(claudeDir, "hooks", "hooks-file", hasArgosShellFileMarker, apply, rows);
+    const settingsPath = join(claudeDir, "settings.json");
+    const settingsResult = removeAllArgosHooksFromSettings(settingsPath, join(claudeDir, "hooks"), {
+        dryRun: !apply
+    });
+    if (settingsResult.status === "error") {
+        rows.push({
+            path: "settings.json",
+            category: "settings-entries",
+            status: "error",
+            detail: settingsResult.detail
+        });
+    } else if (settingsResult.removedCount > 0) {
+        const noun = settingsResult.removedCount === 1 ? "entry" : "entries";
+        rows.push({
+            path: "settings.json",
+            category: "settings-entries",
+            status: apply ? "removed" : "would-remove",
+            detail: `${settingsResult.removedCount} hook ${noun}`
+        });
+    }
+    if (purge) processPurge(apply, rows, warnings);
+    // Always-present closing note: repo-side artifacts (argos.config.json, the
+    // ficha block in a repo's own CLAUDE.md) are out of scope for `remove` —
+    // see the module doc comment above.
+    rows.push({
+        path: "scope",
+        category: "scope-note",
+        status: "info",
+        detail: "los repos adoptados conservan su argos.config.json y ficha — este comando solo limpia ~/.claude y ~/.argos"
+    });
+    const exitCode = rows.some((r)=>r.status === "error") ? 1 : 0;
+    return {
+        rows,
+        summary: summarize(rows, apply),
+        exitCode,
+        backupPath,
+        warnings
+    };
+}
+export const removeCommand = defineCommand({
+    meta: {
+        name: "remove",
+        description: "Uninstall the Argos engine from the global Claude Code home (preview by default)."
+    },
+    args: {
+        apply: {
+            type: "boolean",
+            default: false,
+            description: "Actually perform the removal (default: dry-run preview, touches nothing)."
+        },
+        purge: {
+            type: "boolean",
+            default: false,
+            description: "Also remove ~/.argos data (registry, global.json, backups). Irreversible."
+        }
+    },
+    run ({ args }) {
+        const report = runRemove({
+            apply: args.apply,
+            purge: args.purge
+        });
+        const colorize = (status)=>{
+            const padded = status.padEnd(18);
+            switch(status){
+                case "skipped-foreign":
+                    return pc.yellow(padded);
+                case "removed":
+                    return pc.cyan(padded);
+                case "would-remove":
+                    return pc.dim(padded);
+                case "warning":
+                    return pc.yellow(padded);
+                case "info":
+                    return pc.dim(padded);
+                case "error":
+                    return pc.red(padded);
+                default:
+                    return padded;
+            }
+        };
+        for (const row of report.rows){
+            const suffix = row.detail ? ` (${row.detail})` : "";
+            console.log(`${colorize(row.status)} ${row.path}${suffix}`);
+        }
+        console.log("");
+        console.log(report.summary);
+        if (report.backupPath) console.log(`backup en ${report.backupPath}`);
+        for (const warning of report.warnings)console.log(pc.yellow(`aviso: ${warning}`));
+        process.exit(report.exitCode);
+    }
+});
+
+//# sourceMappingURL=remove.js.map

package/dist/commands/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/remove.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { existsSync, readdirSync, readFileSync, rmSync, rmdirSync } from \"node:fs\";\nimport { join, relative, sep } from \"node:path\";\nimport pc from \"picocolors\";\nimport { listSkillFiles, listSkillIds, MANAGED_BLOCK_IDS, resolveAssetsDir } from \"../lib/assets.js\";\nimport { writeFileAtomic } from \"../lib/atomic-write.js\";\nimport { createBackup } from \"../lib/backup.js\";\nimport { listBlocks, removeBlock } from \"../lib/markers.js\";\nimport { hasArgosFileMarker, hasArgosShellFileMarker } from \"../lib/managed-files.js\";\nimport { resolveArgosHome, resolveClaudeDir } from \"../lib/paths.js\";\nimport { removeAllArgosHooksFromSettings } from \"../lib/settings-merge.js\";\n\n/**\n * Uninstaller for `argos init`: the mirror image of `runInit` (see\n * commands/init.ts). Removes only what Argos itself owns — a managed\n * CLAUDE.md block, a file carrying the `argos:file`/shell marker, or a\n * settings.json hook entry pointing at an Argos script — and leaves every\n * foreign file, block, and entry byte-identical.\n *\n * Scope: this command only touches `~/.claude` (via `resolveClaudeDir()`)\n * and, with `--purge`, `~/.argos` (via `resolveArgosHome()`) — the global\n * Argos engine and its registry. Repo-side artifacts are intentionally out\n * of scope and are NEVER touched here: a repo's own `argos.config.json` and\n * the \"ficha\" managed block `argos adopt` writes into that repo's own\n * `CLAUDE.md` both survive `remove` untouched, including `remove --purge`.\n * (See the final \"scope\" row every report ends with.)\n */\n\nexport type RemoveRowStatus = \"removed\" | \"would-remove\" | \"skipped-foreign\" | \"warning\" | \"info\" | \"error\";\n\nexport type RemoveRowCategory =\n  | \"claude-md-block\"\n  | \"agents-file\"\n  | \"skills-file\"\n  | \"output-styles-file\"\n  | \"hooks-file\"\n  | \"settings-entries\"\n  | \"argos-home\"\n  | \"scope-note\";\n\nexport interface RemoveRow {\n  path: string;\n  category: RemoveRowCategory;\n  status: RemoveRowStatus;\n  detail?: string;\n}\n\nexport interface RemoveOptions {\n  /** Actually perform the removal. Default false = dry-run preview, touches nothing on disk. */\n  apply?: boolean;\n  /** Also remove ~/.argos data (registry, global.json, backups). Backups are removed LAST. */\n  purge?: boolean;\n}\n\nexport interface RemoveReport {\n  rows: RemoveRow[];\n  summary: string;\n  exitCode: 0 | 1;\n  backupPath?: string;\n  /** Non-fatal warnings surfaced alongside the report, e.g. the --purge/backups tradeoff. */\n  warnings: string[];\n}\n\nconst STATUS_COUNT_ORDER: RemoveRowStatus[] = [\n  \"removed\",\n  \"would-remove\",\n  \"skipped-foreign\",\n  \"info\",\n  \"warning\",\n  \"error\",\n];\n\nfunction summarize(rows: RemoveRow[], apply: boolean): string {\n  const counts: Record<RemoveRowStatus, number> = {\n    removed: 0,\n    \"would-remove\": 0,\n    \"skipped-foreign\": 0,\n    info: 0,\n    warning: 0,\n    error: 0,\n  };\n  for (const row of rows) counts[row.status]++;\n\n  const parts = STATUS_COUNT_ORDER.filter((s) => counts[s] > 0).map((s) => `${counts[s]} ${s}`);\n  const verb = apply ? \"argos remove\" : \"argos remove (preview — nada se tocó)\";\n  return parts.length === 0 ? `${verb}: nada que hacer.` : `${verb}: ${parts.join(\", \")}.`;\n}\n\nfunction errorMessage(err: unknown): string {\n  return err instanceof Error ? err.message : String(err);\n}\n\n/** Strip every present managed block from CLAUDE.md; delete the file entirely if it becomes empty. */\nfunction processClaudeMd(claudeDir: string, apply: boolean, rows: RemoveRow[]): void {\n  const claudeMdPath = join(claudeDir, \"CLAUDE.md\");\n  if (!existsSync(claudeMdPath)) return;\n\n  let claudeMd: string;\n  try {\n    claudeMd = readFileSync(claudeMdPath, \"utf-8\");\n  } catch (err) {\n    rows.push({ path: \"CLAUDE.md\", category: \"claude-md-block\", status: \"error\", detail: errorMessage(err) });\n    return;\n  }\n\n  let next = claudeMd;\n  const removedIds: string[] = [];\n  for (const id of MANAGED_BLOCK_IDS) {\n    const hadBlock = listBlocks(next).some((b) => b.id === id);\n    if (!hadBlock) continue;\n    const beforeThisId = next;\n    // removeBlock only strips the first occurrence — loop to self-heal any\n    // crash-residue duplicates left by injectBlock (see lib/markers.ts).\n    // Progress-guarded: a dangling open marker with no matching close (see\n    // lib/markers.ts's findBlock/listDanglingBlockIds) makes removeBlock a\n    // no-op — its output equals its input — which would otherwise spin this\n    // loop forever since listBlocks still reports the id as present. Break\n    // and surface it as a warning instead of hanging.\n    while (listBlocks(next).some((b) => b.id === id)) {\n      const before = next;\n      next = removeBlock(next, id);\n      if (next === before) {\n        rows.push({\n          path: \"CLAUDE.md\",\n          category: \"claude-md-block\",\n          status: \"warning\",\n          detail: \"marker argos huérfano sin cierre en CLAUDE.md — remuévelo a mano\",\n        });\n        break;\n      }\n    }\n    if (next !== beforeThisId) removedIds.push(id);\n  }\n\n  if (removedIds.length === 0) return;\n  for (const id of removedIds) {\n    rows.push({ path: `CLAUDE.md#${id}`, category: \"claude-md-block\", status: apply ? \"removed\" : \"would-remove\" });\n  }\n\n  if (!apply) return;\n\n  try {\n    if (next.trim().length === 0) {\n      rmSync(claudeMdPath, { force: true });\n    } else {\n      writeFileAtomic(claudeMdPath, next);\n    }\n  } catch (err) {\n    rows.push({ path: \"CLAUDE.md\", category: \"claude-md-block\", status: \"error\", detail: errorMessage(err) });\n  }\n}\n\nfunction walkFiles(dir: string): string[] {\n  if (!existsSync(dir)) return [];\n  const out: string[] = [];\n  for (const entry of readdirSync(dir, { withFileTypes: true })) {\n    const full = join(dir, entry.name);\n    if (entry.isDirectory()) out.push(...walkFiles(full));\n    else if (entry.isFile()) out.push(full);\n  }\n  return out;\n}\n\n/** Remove now-empty directories bottom-up under `dir`, leaving any dir that still holds foreign content. */\nfunction removeEmptyDirsUnder(dir: string): void {\n  if (!existsSync(dir)) return;\n  for (const entry of readdirSync(dir, { withFileTypes: true })) {\n    if (entry.isDirectory()) removeEmptyDirsUnder(join(dir, entry.name));\n  }\n  const remaining = existsSync(dir) ? readdirSync(dir) : [];\n  if (remaining.length === 0) {\n    try {\n      rmdirSync(dir);\n    } catch {\n      // Best-effort cleanup — a leftover empty dir is cosmetic, not an error.\n    }\n  }\n}\n\n/**\n * Remove every Argos-owned file (carrying the ownership marker) under\n * `claudeDir/<topDir>`, recursively — skills live in subdirectories, hence\n * the recursive walk. Foreign files (no marker) are reported\n * \"skipped-foreign\" and left byte-identical.\n */\nfunction processManagedDir(\n  claudeDir: string,\n  topDir: \"agents\" | \"output-styles\" | \"hooks\",\n  category: RemoveRowCategory,\n  hasMarker: (content: string) => boolean,\n  apply: boolean,\n  rows: RemoveRow[],\n): void {\n  const dirPath = join(claudeDir, topDir);\n  const files = walkFiles(dirPath);\n  for (const file of files) {\n    const relPath = relative(claudeDir, file);\n    let content: string;\n    try {\n      content = readFileSync(file, \"utf-8\");\n    } catch (err) {\n      rows.push({ path: relPath, category, status: \"error\", detail: errorMessage(err) });\n      continue;\n    }\n\n    if (!hasMarker(content)) {\n      rows.push({ path: relPath, category, status: \"skipped-foreign\" });\n      continue;\n    }\n\n    if (!apply) {\n      rows.push({ path: relPath, category, status: \"would-remove\" });\n      continue;\n    }\n\n    try {\n      rmSync(file, { force: true });\n      rows.push({ path: relPath, category, status: \"removed\" });\n    } catch (err) {\n      rows.push({ path: relPath, category, status: \"error\", detail: errorMessage(err) });\n    }\n  }\n\n  if (apply) removeEmptyDirsUnder(dirPath);\n}\n\n/**\n * Remove Argos-owned skill directories under `claudeDir/skills/`.\n *\n * Unlike `processManagedDir` (per-file marker check), ownership here is\n * decided PER SKILL DIRECTORY: the skill's `SKILL.md` `argos:file` marker is\n * the sentinel (mirrors the install policy in commands/init.ts). Supporting\n * files (`references/*.md`, `phases/*.md`, etc.) never carry a marker of\n * their own, so a per-file marker check would wrongly treat every one of\n * them as foreign.\n * - `SKILL.md` missing, or present without the marker → the whole directory\n *   is foreign (or not argos-installed at all); every file under it is left\n *   untouched, reported \"skipped-foreign\".\n * - `SKILL.md` present with the marker → argos-owned. Only the files the\n *   CURRENTLY shipped asset manifest lists for that skill id\n *   (`listSkillFiles`) are removed; anything else in the directory — a\n *   user-added extra file, or every file if this CLI version no longer\n *   ships the skill at all — is left in place.\n */\nfunction processSkillsDir(claudeDir: string, apply: boolean, rows: RemoveRow[]): void {\n  const skillsRoot = join(claudeDir, \"skills\");\n  if (!existsSync(skillsRoot)) return;\n\n  const assetsDir = resolveAssetsDir();\n  const shippedSkillIds = new Set(listSkillIds(assetsDir));\n\n  for (const entry of readdirSync(skillsRoot, { withFileTypes: true })) {\n    if (!entry.isDirectory()) continue; // skills/ only ever holds skill subdirectories\n    const skillId = entry.name;\n    const skillDir = join(skillsRoot, skillId);\n    const skillMdPath = join(skillDir, \"SKILL.md\");\n\n    let skillMdContent: string | null = null;\n    if (existsSync(skillMdPath)) {\n      try {\n        skillMdContent = readFileSync(skillMdPath, \"utf-8\");\n      } catch (err) {\n        rows.push({\n          path: relative(claudeDir, skillMdPath),\n          category: \"skills-file\",\n          status: \"error\",\n          detail: errorMessage(err),\n        });\n        continue;\n      }\n    }\n\n    const isArgosOwned = skillMdContent !== null && hasArgosFileMarker(skillMdContent);\n    const manifest =\n      isArgosOwned && shippedSkillIds.has(skillId) ? new Set(listSkillFiles(assetsDir, skillId)) : new Set<string>();\n\n    for (const file of walkFiles(skillDir)) {\n      const relToClaudeDir = relative(claudeDir, file);\n\n      if (!isArgosOwned || !manifest.has(relative(skillDir, file).split(sep).join(\"/\"))) {\n        rows.push({ path: relToClaudeDir, category: \"skills-file\", status: \"skipped-foreign\" });\n        continue;\n      }\n\n      if (!apply) {\n        rows.push({ path: relToClaudeDir, category: \"skills-file\", status: \"would-remove\" });\n        continue;\n      }\n\n      try {\n        rmSync(file, { force: true });\n        rows.push({ path: relToClaudeDir, category: \"skills-file\", status: \"removed\" });\n      } catch (err) {\n        rows.push({ path: relToClaudeDir, category: \"skills-file\", status: \"error\", detail: errorMessage(err) });\n      }\n    }\n  }\n\n  if (apply) removeEmptyDirsUnder(skillsRoot);\n}\n\nconst PURGE_FILES = [\"global.json\", \"workspaces.json\"] as const;\n\nfunction processPurge(apply: boolean, rows: RemoveRow[], warnings: string[]): void {\n  const argosHome = resolveArgosHome();\n\n  for (const name of PURGE_FILES) {\n    const p = join(argosHome, name);\n    if (!existsSync(p)) continue;\n    const label = join(\"~\", \".argos\", name);\n    if (!apply) {\n      rows.push({ path: label, category: \"argos-home\", status: \"would-remove\" });\n      continue;\n    }\n    try {\n      rmSync(p, { force: true });\n      rows.push({ path: label, category: \"argos-home\", status: \"removed\" });\n    } catch (err) {\n      rows.push({ path: label, category: \"argos-home\", status: \"error\", detail: errorMessage(err) });\n    }\n  }\n\n  // Backups LAST, and always explicitly flagged: they're the safety net for\n  // every previous (and this very) destructive operation, so purging them\n  // removes the one thing that could otherwise undo a mistake.\n  const backupsDir = join(argosHome, \"backups\");\n  const backupsLabel = join(\"~\", \".argos\", \"backups\");\n  if (existsSync(backupsDir)) {\n    warnings.push(\n      \"--purge elimina ~/.argos/backups — se pierde la red de seguridad de esta y de toda operación anterior.\",\n    );\n    if (!apply) {\n      rows.push({ path: backupsLabel, category: \"argos-home\", status: \"would-remove\" });\n    } else {\n      try {\n        rmSync(backupsDir, { recursive: true, force: true });\n        rows.push({ path: backupsLabel, category: \"argos-home\", status: \"removed\" });\n      } catch (err) {\n        rows.push({ path: backupsLabel, category: \"argos-home\", status: \"error\", detail: errorMessage(err) });\n      }\n    }\n  }\n}\n\n/**\n * Core, testable implementation of `argos remove`: uninstalls everything\n * `runInit` (commands/init.ts) installs into `resolveClaudeDir()`. Pure\n * function of the filesystem — no process.exit, no console output.\n *\n * Preview by default (`apply: false`): computes the full report without\n * writing anything. `apply: true` performs the removal, backing up\n * everything affected first (same `createBackup` call `runInit` makes,\n * before any mutation). `purge: true` additionally removes `~/.argos` data\n * (kept by default) — backups are removed last and always warned about.\n */\nexport function runRemove(options: RemoveOptions = {}): RemoveReport {\n  const apply = options.apply ?? false;\n  const purge = options.purge ?? false;\n  const claudeDir = resolveClaudeDir();\n  const rows: RemoveRow[] = [];\n  const warnings: string[] = [];\n\n  let backupPath: string | undefined;\n  if (apply) {\n    try {\n      backupPath = createBackup(claudeDir, [\n        \"CLAUDE.md\",\n        \"agents\",\n        \"skills\",\n        \"output-styles\",\n        \"hooks\",\n        \"settings.json\",\n      ]);\n    } catch (err) {\n      const detail = errorMessage(err);\n      rows.push({ path: \"backup\", category: \"argos-home\", status: \"error\", detail });\n      return { rows, summary: `backup falló — no se tocó nada (${detail}).`, exitCode: 1, warnings };\n    }\n  }\n\n  processClaudeMd(claudeDir, apply, rows);\n\n  processManagedDir(claudeDir, \"agents\", \"agents-file\", hasArgosFileMarker, apply, rows);\n  processSkillsDir(claudeDir, apply, rows);\n  processManagedDir(claudeDir, \"output-styles\", \"output-styles-file\", hasArgosFileMarker, apply, rows);\n  processManagedDir(claudeDir, \"hooks\", \"hooks-file\", hasArgosShellFileMarker, apply, rows);\n\n  const settingsPath = join(claudeDir, \"settings.json\");\n  const settingsResult = removeAllArgosHooksFromSettings(settingsPath, join(claudeDir, \"hooks\"), { dryRun: !apply });\n  if (settingsResult.status === \"error\") {\n    rows.push({ path: \"settings.json\", category: \"settings-entries\", status: \"error\", detail: settingsResult.detail });\n  } else if (settingsResult.removedCount > 0) {\n    const noun = settingsResult.removedCount === 1 ? \"entry\" : \"entries\";\n    rows.push({\n      path: \"settings.json\",\n      category: \"settings-entries\",\n      status: apply ? \"removed\" : \"would-remove\",\n      detail: `${settingsResult.removedCount} hook ${noun}`,\n    });\n  }\n\n  if (purge) processPurge(apply, rows, warnings);\n\n  // Always-present closing note: repo-side artifacts (argos.config.json, the\n  // ficha block in a repo's own CLAUDE.md) are out of scope for `remove` —\n  // see the module doc comment above.\n  rows.push({\n    path: \"scope\",\n    category: \"scope-note\",\n    status: \"info\",\n    detail: \"los repos adoptados conservan su argos.config.json y ficha — este comando solo limpia ~/.claude y ~/.argos\",\n  });\n\n  const exitCode: 0 | 1 = rows.some((r) => r.status === \"error\") ? 1 : 0;\n  return { rows, summary: summarize(rows, apply), exitCode, backupPath, warnings };\n}\n\nexport const removeCommand = defineCommand({\n  meta: {\n    name: \"remove\",\n    description: \"Uninstall the Argos engine from the global Claude Code home (preview by default).\",\n  },\n  args: {\n    apply: {\n      type: \"boolean\",\n      default: false,\n      description: \"Actually perform the removal (default: dry-run preview, touches nothing).\",\n    },\n    purge: {\n      type: \"boolean\",\n      default: false,\n      description: \"Also remove ~/.argos data (registry, global.json, backups). Irreversible.\",\n    },\n  },\n  run({ args }) {\n    const report = runRemove({ apply: args.apply, purge: args.purge });\n\n    const colorize = (status: RemoveRowStatus): string => {\n      const padded = status.padEnd(18);\n      switch (status) {\n        case \"skipped-foreign\":\n          return pc.yellow(padded);\n        case \"removed\":\n          return pc.cyan(padded);\n        case \"would-remove\":\n          return pc.dim(padded);\n        case \"warning\":\n          return pc.yellow(padded);\n        case \"info\":\n          return pc.dim(padded);\n        case \"error\":\n          return pc.red(padded);\n        default:\n          return padded;\n      }\n    };\n    for (const row of report.rows) {\n      const suffix = row.detail ? ` (${row.detail})` : \"\";\n      console.log(`${colorize(row.status)} ${row.path}${suffix}`);\n    }\n    console.log(\"\");\n    console.log(report.summary);\n    if (report.backupPath) console.log(`backup en ${report.backupPath}`);\n    for (const warning of report.warnings) console.log(pc.yellow(`aviso: ${warning}`));\n\n    process.exit(report.exitCode);\n  },\n});\n"],"names":["defineCommand","existsSync","readdirSync","readFileSync","rmSync","rmdirSync","join","relative","sep","pc","listSkillFiles","listSkillIds","MANAGED_BLOCK_IDS","resolveAssetsDir","writeFileAtomic","createBackup","listBlocks","removeBlock","hasArgosFileMarker","hasArgosShellFileMarker","resolveArgosHome","resolveClaudeDir","removeAllArgosHooksFromSettings","STATUS_COUNT_ORDER","summarize","rows","apply","counts","removed","info","warning","error","row","status","parts","filter","s","map","verb","length","errorMessage","err","Error","message","String","processClaudeMd","claudeDir","claudeMdPath","claudeMd","push","path","category","detail","next","removedIds","id","hadBlock","some","b","beforeThisId","before","trim","force","walkFiles","dir","out","entry","withFileTypes","full","name","isDirectory","isFile","removeEmptyDirsUnder","remaining","processManagedDir","topDir","hasMarker","dirPath","files","file","relPath","content","processSkillsDir","skillsRoot","assetsDir","shippedSkillIds","Set","skillId","skillDir","skillMdPath","skillMdContent","isArgosOwned","manifest","has","relToClaudeDir","split","PURGE_FILES","processPurge","warnings","argosHome","p","label","backupsDir","backupsLabel","recursive","runRemove","options","purge","backupPath","summary","exitCode","settingsPath","settingsResult","dryRun","removedCount","noun","r","removeCommand","meta","description","args","type","default","run","report","colorize","padded","padEnd","yellow","cyan","dim","red","suffix","console","log","process","exit"],"mappings":"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"}

package/dist/commands/workspace.d.ts

@@ -0,0 +1,73 @@
+import { type OpenclawRunner, type WorkspaceAgentRow } from "../lib/openclaw-agents.js";
+import { type LinkAction } from "../lib/workspaces.js";
+export interface WorkspaceLinkOptions {
+    cwd: string;
+    /** Explicit workspace name passed on the command line, if any. */
+    explicit?: string;
+    /** Overwrite a name collision (same config.name, different physical repo) instead of refusing. */
+    force?: boolean;
+}
+export interface WorkspaceLinkReport {
+    exitCode: 0 | 1;
+    error?: string;
+    ambiguousCandidates?: string[];
+    workspaceName?: string;
+    action?: LinkAction;
+    createdWorkspace?: boolean;
+    /** Remote identity persisted as a new match rule, if the offer fired. */
+    matchRuleAdded?: string;
+}
+/**
+ * Core, testable implementation of `argos workspace link [nombre]`: resolves
+ * which workspace the repo at `cwd` belongs to (explicit name > config >
+ * match rules) and registers it. When a brand-new workspace was created via
+ * an explicit name and the repo has a remote, teaches the registry that
+ * remote as a match rule so future repos under the same identity auto-link.
+ */
+export declare function runWorkspaceLink(options: WorkspaceLinkOptions): WorkspaceLinkReport;
+export interface WorkspaceShowRepoRow {
+    workspace: string;
+    name: string;
+    path: string;
+    missing: boolean;
+}
+export interface WorkspaceShowReport {
+    rows: WorkspaceShowRepoRow[];
+    exitCode: 0 | 1;
+    error?: string;
+}
+export interface WorkspaceShowOptions {
+    /** Injectable for tests; defaults to node:fs existsSync. */
+    pathExists?: (path: string) => boolean;
+}
+/** Core, testable implementation of `argos workspace show [nombre]`. */
+export declare function runWorkspaceShow(name?: string, options?: WorkspaceShowOptions): WorkspaceShowReport;
+export interface RunWorkspaceAgentsOptions {
+    /** false (default) = preview only; true = actually run `openclaw agents add`. */
+    apply?: boolean;
+    prefix?: string;
+    /** Injectable for tests; defaults to lib/which.ts hasBinary. */
+    hasBinary?: (name: string) => boolean;
+    /** Injectable for tests; forwarded to planWorkspaceAgents. */
+    runner?: OpenclawRunner;
+    /** Injectable for tests; forwarded to planWorkspaceAgents. */
+    pathExists?: (path: string) => boolean;
+}
+export type RunWorkspaceAgentsEarlyReason = "workspace-not-found" | "no-repos" | "binary-missing";
+export interface RunWorkspaceAgentsResult {
+    exitCode: 0 | 1;
+    preview: boolean;
+    reason?: RunWorkspaceAgentsEarlyReason;
+    error?: string;
+    rows: WorkspaceAgentRow[];
+}
+/**
+ * Core logic for `workspace agents <nombre>`. Preview (default) never
+ * spawns anything — it only formats the commands that would run. `--apply`
+ * requires the `openclaw` binary on PATH; a per-repo failure never aborts
+ * the rest of the workspace (planWorkspaceAgents already guarantees this),
+ * so the exit code reflects the honest partial summary.
+ */
+export declare function runWorkspaceAgents(name: string, options?: RunWorkspaceAgentsOptions): RunWorkspaceAgentsResult;
+export declare const workspaceCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/commands/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/commands/workspace.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAEvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAML,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAS9B,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kGAAkG;IAClG,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CA4EnF;AAiDD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,oBAAoB,EAAE,CAAC;IAC7B,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CA8BvG;AAkCD,MAAM,WAAW,yBAAyB;IACxC,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC;AAED,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAElG,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,iBAAiB,EAAE,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CAsC1B;AAkED,eAAO,MAAM,gBAAgB,qDAU3B,CAAC"}