argos-harness 0.1.0

package/dist/lib/openclaw-agents.d.ts

@@ -0,0 +1,53 @@
+/**
+ * OpenClaw fixes one cwd per "agent". `argos workspace agents <name>` needs
+ * one OpenClaw agent per repo registered in an Argos workspace so that
+ * Claude Code sessions anchor inside each repo and use the global motor from
+ * that repo's own working directory. This module holds the pure per-repo
+ * planning/classification logic so `commands/workspace.ts` stays a thin
+ * formatter — mirroring how `commands/adopt.ts` exports `runAdopt` for the
+ * same reason. Ported from the proven design in navori-harness (F2 spec's
+ * "hereda de navori-harness" list).
+ */
+export declare const OPENCLAW_BINARY = "openclaw";
+/** OpenClaw agent name for a repo: optional prefix + repo name, no other transform. */
+export declare function buildAgentName(repoName: string, prefix?: string): string;
+export declare function buildOpenclawAddArgs(agentName: string, repoPath: string): string[];
+/** Human-readable form of the command, for preview output only (never parsed back). */
+export declare function formatOpenclawAddCommand(agentName: string, repoPath: string): string;
+export type OpenclawAddOutcome = "created" | "exists" | "error";
+export interface OpenclawAddResult {
+    outcome: OpenclawAddOutcome;
+    detail: string;
+}
+/** Classify a finished `openclaw agents add` invocation into created/exists/error. */
+export declare function classifyOpenclawAddResult(status: number | null, stdout: string, stderr: string): OpenclawAddResult;
+/** Runs `openclaw agents add ...` for real. Injectable so tests never shell out. */
+export type OpenclawRunner = (agentName: string, repoPath: string) => OpenclawAddResult;
+export declare const runOpenclawAgentAdd: OpenclawRunner;
+export type WorkspaceAgentStatus = "created" | "would-create" | "exists" | "missing" | "error";
+export interface WorkspaceAgentRow {
+    name: string;
+    status: WorkspaceAgentStatus;
+    detail: string;
+}
+export interface PlanWorkspaceAgentsOptions {
+    /** true = preview only, never calls the runner. */
+    preview: boolean;
+    prefix?: string;
+    /** Injectable for tests; defaults to runOpenclawAgentAdd. */
+    runner?: OpenclawRunner;
+    /** Injectable for tests; defaults to node:fs existsSync. */
+    pathExists?: (path: string) => boolean;
+}
+/**
+ * Build the per-repo plan for `workspace agents`: one OpenClaw agent per
+ * registered repo. Preview mode never shells out — it only formats the
+ * command that would run. Apply mode calls the runner per repo and keeps
+ * going on a per-repo failure (e.g. the agent already exists), since one
+ * bad repo must not abort the rest of the workspace.
+ */
+export declare function planWorkspaceAgents(repos: Array<{
+    name: string;
+    path: string;
+}>, options: PlanWorkspaceAgentsOptions): WorkspaceAgentRow[];
+//# sourceMappingURL=openclaw-agents.d.ts.map

package/dist/lib/openclaw-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-agents.d.ts","sourceRoot":"","sources":["../../src/lib/openclaw-agents.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAElF;AAED,uFAAuF;AACvF,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,sFAAsF;AACtF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,iBAAiB,CAYnB;AAED,oFAAoF;AACpF,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,iBAAiB,CAAC;AAQxF,eAAO,MAAM,mBAAmB,EAAE,cAmBjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5C,OAAO,EAAE,0BAA0B,GAClC,iBAAiB,EAAE,CAiBrB"}

package/dist/lib/openclaw-agents.js

@@ -0,0 +1,118 @@
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+/**
+ * OpenClaw fixes one cwd per "agent". `argos workspace agents <name>` needs
+ * one OpenClaw agent per repo registered in an Argos workspace so that
+ * Claude Code sessions anchor inside each repo and use the global motor from
+ * that repo's own working directory. This module holds the pure per-repo
+ * planning/classification logic so `commands/workspace.ts` stays a thin
+ * formatter — mirroring how `commands/adopt.ts` exports `runAdopt` for the
+ * same reason. Ported from the proven design in navori-harness (F2 spec's
+ * "hereda de navori-harness" list).
+ */ export const OPENCLAW_BINARY = "openclaw";
+/** OpenClaw agent name for a repo: optional prefix + repo name, no other transform. */ export function buildAgentName(repoName, prefix = "") {
+    return `${prefix}${repoName}`;
+}
+export function buildOpenclawAddArgs(agentName, repoPath) {
+    return [
+        "agents",
+        "add",
+        agentName,
+        "--workspace",
+        repoPath,
+        "--non-interactive"
+    ];
+}
+/** Human-readable form of the command, for preview output only (never parsed back). */ export function formatOpenclawAddCommand(agentName, repoPath) {
+    return `${OPENCLAW_BINARY} ${buildOpenclawAddArgs(agentName, repoPath).join(" ")}`;
+}
+// openclaw's exact wording for "this agent name is already registered" isn't
+// part of any published contract, so this is a best-effort classifier over
+// common phrasings. Widen it here if a real openclaw error message doesn't match.
+// Deliberately does NOT match a bare "duplicate" — that also fires on unrelated
+// errors like "duplicate key violation in database", which must surface as a
+// real failure instead of being swallowed as a benign "already exists".
+const DUPLICATE_PATTERN = /\bagent\b[^\n]{0,80}\balready (?:exists|registered)\b|\bname\b[^\n]{0,80}\balready in use\b|\balready exists\b|\balready registered\b/i;
+/** Classify a finished `openclaw agents add` invocation into created/exists/error. */ export function classifyOpenclawAddResult(status, stdout, stderr) {
+    if (status === 0) {
+        return {
+            outcome: "created",
+            detail: stdout.trim()
+        };
+    }
+    const combined = `${stderr}\n${stdout}`;
+    if (DUPLICATE_PATTERN.test(combined)) {
+        return {
+            outcome: "exists",
+            detail: stderr.trim() || stdout.trim() || "agent already exists"
+        };
+    }
+    return {
+        outcome: "error",
+        detail: stderr.trim() || stdout.trim() || `openclaw exited with status ${status}`
+    };
+}
+// A non-interactive "register an agent" call should never legitimately run
+// for minutes, but stays bounded so a hang (e.g. openclaw waiting on a stuck
+// interactive prompt) can't freeze the whole per-repo agent-add loop forever
+// — a real risk when this runs unattended from cron on the VPS.
+const OPENCLAW_ADD_TIMEOUT_MS = 120_000; // 120s, per spec
+export const runOpenclawAgentAdd = (agentName, repoPath)=>{
+    const result = spawnSync(OPENCLAW_BINARY, buildOpenclawAddArgs(agentName, repoPath), {
+        encoding: "utf-8",
+        stdio: [
+            "ignore",
+            "pipe",
+            "pipe"
+        ],
+        timeout: OPENCLAW_ADD_TIMEOUT_MS
+    });
+    if (result.error) {
+        // spawnSync sets result.error with this code when the timeout fires.
+        if (result.error.code === "ETIMEDOUT") {
+            return {
+                outcome: "error",
+                detail: `Timed out adding agent '${agentName}' after ${OPENCLAW_ADD_TIMEOUT_MS / 1000}s. ` + `openclaw may be waiting for interactive input — check for a stuck prompt.`
+            };
+        }
+        return {
+            outcome: "error",
+            detail: result.error.message
+        };
+    }
+    return classifyOpenclawAddResult(result.status, result.stdout ?? "", result.stderr ?? "");
+};
+/**
+ * Build the per-repo plan for `workspace agents`: one OpenClaw agent per
+ * registered repo. Preview mode never shells out — it only formats the
+ * command that would run. Apply mode calls the runner per repo and keeps
+ * going on a per-repo failure (e.g. the agent already exists), since one
+ * bad repo must not abort the rest of the workspace.
+ */ export function planWorkspaceAgents(repos, options) {
+    const { preview, prefix = "", runner = runOpenclawAgentAdd, pathExists = existsSync } = options;
+    return repos.map((repo)=>{
+        const agentName = buildAgentName(repo.name, prefix);
+        if (!pathExists(repo.path)) {
+            return {
+                name: repo.name,
+                status: "missing",
+                detail: repo.path
+            };
+        }
+        if (preview) {
+            return {
+                name: repo.name,
+                status: "would-create",
+                detail: formatOpenclawAddCommand(agentName, repo.path)
+            };
+        }
+        const result = runner(agentName, repo.path);
+        return {
+            name: repo.name,
+            status: result.outcome,
+            detail: result.detail
+        };
+    });
+}
+
+//# sourceMappingURL=openclaw-agents.js.map

package/dist/lib/openclaw-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/openclaw-agents.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { spawnSync } from \"node:child_process\";\n\n/**\n * OpenClaw fixes one cwd per \"agent\". `argos workspace agents <name>` needs\n * one OpenClaw agent per repo registered in an Argos workspace so that\n * Claude Code sessions anchor inside each repo and use the global motor from\n * that repo's own working directory. This module holds the pure per-repo\n * planning/classification logic so `commands/workspace.ts` stays a thin\n * formatter — mirroring how `commands/adopt.ts` exports `runAdopt` for the\n * same reason. Ported from the proven design in navori-harness (F2 spec's\n * \"hereda de navori-harness\" list).\n */\n\nexport const OPENCLAW_BINARY = \"openclaw\";\n\n/** OpenClaw agent name for a repo: optional prefix + repo name, no other transform. */\nexport function buildAgentName(repoName: string, prefix = \"\"): string {\n  return `${prefix}${repoName}`;\n}\n\nexport function buildOpenclawAddArgs(agentName: string, repoPath: string): string[] {\n  return [\"agents\", \"add\", agentName, \"--workspace\", repoPath, \"--non-interactive\"];\n}\n\n/** Human-readable form of the command, for preview output only (never parsed back). */\nexport function formatOpenclawAddCommand(agentName: string, repoPath: string): string {\n  return `${OPENCLAW_BINARY} ${buildOpenclawAddArgs(agentName, repoPath).join(\" \")}`;\n}\n\nexport type OpenclawAddOutcome = \"created\" | \"exists\" | \"error\";\n\nexport interface OpenclawAddResult {\n  outcome: OpenclawAddOutcome;\n  detail: string;\n}\n\n// openclaw's exact wording for \"this agent name is already registered\" isn't\n// part of any published contract, so this is a best-effort classifier over\n// common phrasings. Widen it here if a real openclaw error message doesn't match.\n// Deliberately does NOT match a bare \"duplicate\" — that also fires on unrelated\n// errors like \"duplicate key violation in database\", which must surface as a\n// real failure instead of being swallowed as a benign \"already exists\".\nconst DUPLICATE_PATTERN =\n  /\\bagent\\b[^\\n]{0,80}\\balready (?:exists|registered)\\b|\\bname\\b[^\\n]{0,80}\\balready in use\\b|\\balready exists\\b|\\balready registered\\b/i;\n\n/** Classify a finished `openclaw agents add` invocation into created/exists/error. */\nexport function classifyOpenclawAddResult(\n  status: number | null,\n  stdout: string,\n  stderr: string,\n): OpenclawAddResult {\n  if (status === 0) {\n    return { outcome: \"created\", detail: stdout.trim() };\n  }\n  const combined = `${stderr}\\n${stdout}`;\n  if (DUPLICATE_PATTERN.test(combined)) {\n    return { outcome: \"exists\", detail: stderr.trim() || stdout.trim() || \"agent already exists\" };\n  }\n  return {\n    outcome: \"error\",\n    detail: stderr.trim() || stdout.trim() || `openclaw exited with status ${status}`,\n  };\n}\n\n/** Runs `openclaw agents add ...` for real. Injectable so tests never shell out. */\nexport type OpenclawRunner = (agentName: string, repoPath: string) => OpenclawAddResult;\n\n// A non-interactive \"register an agent\" call should never legitimately run\n// for minutes, but stays bounded so a hang (e.g. openclaw waiting on a stuck\n// interactive prompt) can't freeze the whole per-repo agent-add loop forever\n// — a real risk when this runs unattended from cron on the VPS.\nconst OPENCLAW_ADD_TIMEOUT_MS = 120_000; // 120s, per spec\n\nexport const runOpenclawAgentAdd: OpenclawRunner = (agentName, repoPath) => {\n  const result = spawnSync(OPENCLAW_BINARY, buildOpenclawAddArgs(agentName, repoPath), {\n    encoding: \"utf-8\",\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    timeout: OPENCLAW_ADD_TIMEOUT_MS,\n  });\n  if (result.error) {\n    // spawnSync sets result.error with this code when the timeout fires.\n    if ((result.error as NodeJS.ErrnoException).code === \"ETIMEDOUT\") {\n      return {\n        outcome: \"error\",\n        detail:\n          `Timed out adding agent '${agentName}' after ${OPENCLAW_ADD_TIMEOUT_MS / 1000}s. ` +\n          `openclaw may be waiting for interactive input — check for a stuck prompt.`,\n      };\n    }\n    return { outcome: \"error\", detail: (result.error as Error).message };\n  }\n  return classifyOpenclawAddResult(result.status, result.stdout ?? \"\", result.stderr ?? \"\");\n};\n\nexport type WorkspaceAgentStatus = \"created\" | \"would-create\" | \"exists\" | \"missing\" | \"error\";\n\nexport interface WorkspaceAgentRow {\n  name: string;\n  status: WorkspaceAgentStatus;\n  detail: string;\n}\n\nexport interface PlanWorkspaceAgentsOptions {\n  /** true = preview only, never calls the runner. */\n  preview: boolean;\n  prefix?: string;\n  /** Injectable for tests; defaults to runOpenclawAgentAdd. */\n  runner?: OpenclawRunner;\n  /** Injectable for tests; defaults to node:fs existsSync. */\n  pathExists?: (path: string) => boolean;\n}\n\n/**\n * Build the per-repo plan for `workspace agents`: one OpenClaw agent per\n * registered repo. Preview mode never shells out — it only formats the\n * command that would run. Apply mode calls the runner per repo and keeps\n * going on a per-repo failure (e.g. the agent already exists), since one\n * bad repo must not abort the rest of the workspace.\n */\nexport function planWorkspaceAgents(\n  repos: Array<{ name: string; path: string }>,\n  options: PlanWorkspaceAgentsOptions,\n): WorkspaceAgentRow[] {\n  const { preview, prefix = \"\", runner = runOpenclawAgentAdd, pathExists = existsSync } = options;\n  return repos.map((repo) => {\n    const agentName = buildAgentName(repo.name, prefix);\n    if (!pathExists(repo.path)) {\n      return { name: repo.name, status: \"missing\", detail: repo.path };\n    }\n    if (preview) {\n      return {\n        name: repo.name,\n        status: \"would-create\",\n        detail: formatOpenclawAddCommand(agentName, repo.path),\n      };\n    }\n    const result = runner(agentName, repo.path);\n    return { name: repo.name, status: result.outcome, detail: result.detail };\n  });\n}\n"],"names":["existsSync","spawnSync","OPENCLAW_BINARY","buildAgentName","repoName","prefix","buildOpenclawAddArgs","agentName","repoPath","formatOpenclawAddCommand","join","DUPLICATE_PATTERN","classifyOpenclawAddResult","status","stdout","stderr","outcome","detail","trim","combined","test","OPENCLAW_ADD_TIMEOUT_MS","runOpenclawAgentAdd","result","encoding","stdio","timeout","error","code","message","planWorkspaceAgents","repos","options","preview","runner","pathExists","map","repo","name","path"],"mappings":"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"}

package/dist/lib/package-root.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve the `@argos/cli` package root (the directory holding both
+ * `package.json` and `assets/`) relative to the currently running module.
+ *
+ * Walks up from the calling module's directory. This works from compiled
+ * `dist/**` (package root is the parent of `dist/`) and from `src/**` during
+ * ts-node/vitest dev runs, without depending on a fixed nesting depth or a
+ * build-time asset-copy step.
+ */
+export declare function resolvePackageRoot(fromUrl?: string): string;
+//# sourceMappingURL=package-root.d.ts.map

package/dist/lib/package-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-root.d.ts","sourceRoot":"","sources":["../../src/lib/package-root.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,MAAwB,GAAG,MAAM,CAS5E"}

package/dist/lib/package-root.js

@@ -0,0 +1,23 @@
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Resolve the `@argos/cli` package root (the directory holding both
+ * `package.json` and `assets/`) relative to the currently running module.
+ *
+ * Walks up from the calling module's directory. This works from compiled
+ * `dist/**` (package root is the parent of `dist/`) and from `src/**` during
+ * ts-node/vitest dev runs, without depending on a fixed nesting depth or a
+ * build-time asset-copy step.
+ */ export function resolvePackageRoot(fromUrl = import.meta.url) {
+    let dir = dirname(fileURLToPath(fromUrl));
+    for(let i = 0; i < 8; i++){
+        if (existsSync(join(dir, "package.json")) && existsSync(join(dir, "assets"))) return dir;
+        const parent = dirname(dir);
+        if (parent === dir) break;
+        dir = parent;
+    }
+    throw new Error(`Could not resolve the @argos/cli package root from ${fromUrl}`);
+}
+
+//# sourceMappingURL=package-root.js.map

package/dist/lib/package-root.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/package-root.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/**\n * Resolve the `@argos/cli` package root (the directory holding both\n * `package.json` and `assets/`) relative to the currently running module.\n *\n * Walks up from the calling module's directory. This works from compiled\n * `dist/**` (package root is the parent of `dist/`) and from `src/**` during\n * ts-node/vitest dev runs, without depending on a fixed nesting depth or a\n * build-time asset-copy step.\n */\nexport function resolvePackageRoot(fromUrl: string = import.meta.url): string {\n  let dir = dirname(fileURLToPath(fromUrl));\n  for (let i = 0; i < 8; i++) {\n    if (existsSync(join(dir, \"package.json\")) && existsSync(join(dir, \"assets\"))) return dir;\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  throw new Error(`Could not resolve the @argos/cli package root from ${fromUrl}`);\n}\n"],"names":["existsSync","dirname","join","fileURLToPath","resolvePackageRoot","fromUrl","url","dir","i","parent","Error"],"mappings":"AAAA,SAASA,UAAU,QAAQ,UAAU;AACrC,SAASC,OAAO,EAAEC,IAAI,QAAQ,YAAY;AAC1C,SAASC,aAAa,QAAQ,WAAW;AAEzC;;;;;;;;CAQC,GACD,OAAO,SAASC,mBAAmBC,UAAkB,YAAYC,GAAG;IAClE,IAAIC,MAAMN,QAAQE,cAAcE;IAChC,IAAK,IAAIG,IAAI,GAAGA,IAAI,GAAGA,IAAK;QAC1B,IAAIR,WAAWE,KAAKK,KAAK,oBAAoBP,WAAWE,KAAKK,KAAK,YAAY,OAAOA;QACrF,MAAME,SAASR,QAAQM;QACvB,IAAIE,WAAWF,KAAK;QACpBA,MAAME;IACR;IACA,MAAM,IAAIC,MAAM,CAAC,mDAAmD,EAAEL,SAAS;AACjF"}

package/dist/lib/paths.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve the Argos state directory (`~/.argos` by default).
+ * Overridable via `ARGOS_HOME` so tests never touch the real home directory.
+ */
+export declare function resolveArgosHome(): string;
+/**
+ * Resolve the Claude Code config directory (`~/.claude` by default).
+ * Overridable via `CLAUDE_CONFIG_DIR` so tests never touch the real home directory.
+ */
+export declare function resolveClaudeDir(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/lib/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/lib/paths.js

@@ -0,0 +1,16 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Resolve the Argos state directory (`~/.argos` by default).
+ * Overridable via `ARGOS_HOME` so tests never touch the real home directory.
+ */ export function resolveArgosHome() {
+    return process.env.ARGOS_HOME || join(homedir(), ".argos");
+}
+/**
+ * Resolve the Claude Code config directory (`~/.claude` by default).
+ * Overridable via `CLAUDE_CONFIG_DIR` so tests never touch the real home directory.
+ */ export function resolveClaudeDir() {
+    return process.env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude");
+}
+
+//# sourceMappingURL=paths.js.map

package/dist/lib/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/paths.ts"],"sourcesContent":["import { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\n/**\n * Resolve the Argos state directory (`~/.argos` by default).\n * Overridable via `ARGOS_HOME` so tests never touch the real home directory.\n */\nexport function resolveArgosHome(): string {\n  return process.env.ARGOS_HOME || join(homedir(), \".argos\");\n}\n\n/**\n * Resolve the Claude Code config directory (`~/.claude` by default).\n * Overridable via `CLAUDE_CONFIG_DIR` so tests never touch the real home directory.\n */\nexport function resolveClaudeDir(): string {\n  return process.env.CLAUDE_CONFIG_DIR || join(homedir(), \".claude\");\n}\n"],"names":["homedir","join","resolveArgosHome","process","env","ARGOS_HOME","resolveClaudeDir","CLAUDE_CONFIG_DIR"],"mappings":"AAAA,SAASA,OAAO,QAAQ,UAAU;AAClC,SAASC,IAAI,QAAQ,YAAY;AAEjC;;;CAGC,GACD,OAAO,SAASC;IACd,OAAOC,QAAQC,GAAG,CAACC,UAAU,IAAIJ,KAAKD,WAAW;AACnD;AAEA;;;CAGC,GACD,OAAO,SAASM;IACd,OAAOH,QAAQC,GAAG,CAACG,iBAAiB,IAAIN,KAAKD,WAAW;AAC1D"}

package/dist/lib/settings-merge.d.ts

@@ -0,0 +1,125 @@
+/**
+ * True when a hook `command` string points at an Argos-owned script (`.../hooks/argos-*`).
+ *
+ * This is a bare substring match — good enough for the non-destructive
+ * `doctor` diagnostic that uses it, but NOT anchored to any real directory.
+ * Destructive operations (deleting hook entries from the user's
+ * settings.json) must use `isArgosOwnedHookCommand` below instead, which
+ * requires the script to actually resolve inside the managed hooks
+ * directory.
+ */
+export declare function isArgosHookCommand(command: unknown): command is string;
+export interface ArgosHookSpec {
+    /** Absolute path to the installed hook script, e.g. `<claudeDir>/hooks/argos-guard-destructive.sh`. */
+    scriptPath: string;
+    /** Claude Code hook matcher, e.g. "Bash". */
+    matcher: string;
+    /** Hook timeout in seconds (Claude Code's own outer bound on the hook process). */
+    timeout?: number;
+    statusMessage?: string;
+}
+export type SettingsMergeStatus = "created" | "updated" | "unchanged" | "error";
+export interface SettingsMergeResult {
+    status: SettingsMergeStatus;
+    detail?: string;
+}
+export interface MergeHooksOptions {
+    /**
+     * Script paths whose entries should be stripped out of `hooks.PreToolUse`
+     * entirely (not overwritten with a new `specs` entry — REMOVED), wherever
+     * they're found. Used by `argos init` for a hook whose script write just
+     * failed: an entry pointing at a script that doesn't exist (or is broken)
+     * is a dangling PreToolUse entry that hard-blocks every Bash call, whether
+     * it was never written this run or used to work and just broke.
+     */
+    removeScriptPaths?: string[];
+    /**
+     * Test-only seam: invoked immediately before the pre-write mtime re-check
+     * (see the concurrency guard below), so a test can simulate a concurrent
+     * writer racing this merge — mutate `settingsPath` from inside the
+     * callback, then let the merge proceed and observe it refuse. Never used
+     * outside tests.
+     */
+    onBeforeWrite?: () => void;
+}
+/**
+ * Merge `specs` into `settingsPath` (normally `resolveClaudeDir()/settings.json`).
+ *
+ * - Missing file → starts from `{}` (created).
+ * - An existing hook entry whose command already targets a spec's
+ *   `scriptPath` → overwritten in place, at its current array index (never
+ *   moved, never removed).
+ * - No existing entry for a spec → appended into the first `PreToolUse`
+ *   bucket whose `matcher` equals the spec's matcher, or a new bucket is
+ *   pushed at the end of `PreToolUse` if none matches. Every other bucket,
+ *   hook, and top-level key is left exactly as found.
+ * - `options.removeScriptPaths` → any existing entry whose command targets
+ *   one of those paths is stripped out entirely (not replaced) — for a hook
+ *   whose script write just failed, so it never leaves a dangling entry.
+ * - Corrupt JSON (unparsable, not an object, `hooks` present but not an
+ *   object, or `hooks.PreToolUse` present but not an array) → returns
+ *   `status: "error"` and writes NOTHING. Never clobber a file the caller
+ *   can't safely reason about, and never silently discard a foreign `hooks`
+ *   value just because its shape is unexpected.
+ * - Concurrency guard: the file's mtime is captured at read time and
+ *   re-checked immediately before the write; if it moved, someone else wrote
+ *   settings.json in the meantime and this call refuses with `status:
+ *   "error"` rather than silently clobbering that write (last-writer-wins).
+ * - The write itself is atomic (temp file + rename, see
+ *   lib/atomic-write.ts) — a crash mid-write can never leave settings.json
+ *   torn, which would otherwise hard-block every subsequent Bash call.
+ *
+ * The file is always re-serialized with 2-space indentation on a write —
+ * this normalizes the user's original formatting/whitespace, but every key
+ * and value it did not own is preserved (structurally byte-identical
+ * content, not necessarily byte-identical bytes).
+ */
+export declare function mergeHooksIntoSettings(settingsPath: string, specs: ArgosHookSpec[], options?: MergeHooksOptions): SettingsMergeResult;
+export type RemoveHooksStatus = "removed" | "unchanged" | "error";
+export interface RemoveHooksResult {
+    status: RemoveHooksStatus;
+    detail?: string;
+    /** Count of Argos-owned hook entries actually removed (0 for "unchanged"/"error"). */
+    removedCount: number;
+}
+export interface RemoveHooksOptions {
+    /**
+     * Compute what WOULD be removed without writing anything — `argos remove`'s
+     * preview mode. Corrupt-JSON refusal still applies identically in dry-run:
+     * a caller must not be told "removed" for a file it can't safely reason
+     * about.
+     */
+    dryRun?: boolean;
+    /** Same test-only seam as `MergeHooksOptions.onBeforeWrite` above. */
+    onBeforeWrite?: () => void;
+}
+/**
+ * Symmetric counterpart to `mergeHooksIntoSettings`: strips every Argos-owned
+ * hook entry (any command matched by `isArgosOwnedHookCommand` against
+ * `hooksDir`, not just the current `HOOK_IDS`) out of `hooks.PreToolUse`,
+ * wherever it's found. Foreign hooks, buckets, and every other top-level key
+ * are left exactly as found — same ownership/refusal contract as the merge
+ * path:
+ * - `hooksDir` is the resolved `<claudeDir>/hooks` directory this install
+ *   manages (normally `join(resolveClaudeDir(), "hooks")`). A hook is only
+ *   ever treated as Argos-owned — and therefore deletable — when its script
+ *   path actually resolves inside `hooksDir` AND its basename starts with
+ *   `argos-`; this is deliberately NOT the same as `isArgosHookCommand`'s
+ *   bare `/hooks/argos-` substring match, which would also match (and
+ *   delete) an unrelated user hook at a path like
+ *   `/Users/x/my/hooks/argos-custom.sh`.
+ * - Missing file, or no `hooks`/`hooks.PreToolUse` at all → "unchanged",
+ *   nothing to remove.
+ * - Corrupt JSON (unparsable, not an object, `hooks` present but not an
+ *   object, or `hooks.PreToolUse` present but not an array) → `status:
+ *   "error"`, writes NOTHING. Never guess at a shape it can't verify.
+ * - A `PreToolUse` bucket that becomes empty after removing Argos's own
+ *   entries is dropped entirely (it only ever existed to hold them — see
+ *   `mergeHooksIntoSettings`, which creates a fresh bucket per matcher on
+ *   demand); a bucket that still has foreign hooks left (including one with
+ *   ZERO Argos-owned hooks in it) keeps its matcher, its hooks, and its
+ *   position untouched.
+ * - Same mtime concurrency guard and atomic write as the merge path.
+ */
+export declare function removeAllArgosHooksFromSettings(settingsPath: string, hooksDir: string, options?: RemoveHooksOptions): RemoveHooksResult;
+//# sourceMappingURL=settings-merge.d.ts.map

package/dist/lib/settings-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-merge.d.ts","sourceRoot":"","sources":["../../src/lib/settings-merge.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,MAAM,CAEtE;AAqCD,MAAM,WAAW,aAAa;IAC5B,uGAAuG;IACvG,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAEhF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,GAAE,iBAAsB,GAC9B,mBAAmB,CA8HrB;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAmGnB"}