@defai.digital/cli 13.4.11 → 13.5.2

package/dist/integrations/claude-code/hooks-generator.js

@@ -0,0 +1,214 @@
+/**
+ * Claude Code Hooks Generator
+ *
+ * Generates hook scripts in .claude/hooks/ and writes hook configuration
+ * into .claude/settings.json via SettingsManager.
+ *
+ * Supported events: PreToolUse, PostToolUse, SessionStart, SessionEnd
+ * Scripts use `set -euo pipefail` and `jq -cn --arg` for safe JSON output.
+ */
+import { mkdir, writeFile, chmod } from 'node:fs/promises';
+import { join } from 'node:path';
+import { SettingsManager } from './settings-manager.js';
+import { fileExists, writeJsonFile } from './utils/file-utils.js';
+// ─── Default events ───────────────────────────────────────────────────────────
+const DEFAULT_EVENTS = [
+    'PreToolUse',
+    'PostToolUse',
+    'SessionStart',
+    'SessionEnd',
+];
+// ─── Shared bash helper ───────────────────────────────────────────────────────
+function sharedHelpers() {
+    return `
+# Extract a field from JSON safely using jq (if available)
+ax_jq_field() {
+  local field="\$1" default="\$2" input="\$3"
+  if command -v jq &>/dev/null; then
+    jq -re --arg d "\$default" "\$field // \\$d" <<< "\$input" 2>/dev/null || echo "\$default"
+  else
+    echo "\$default"
+  fi
+}
+`;
+}
+// ─── Hook script templates ────────────────────────────────────────────────────
+function preToolUseScript() {
+    return `#!/usr/bin/env bash
+# AutomatosX PreToolUse hook
+# Receives JSON on stdin: { tool_name, tool_input, session_id, cwd }
+# Exit 0 = allow, Exit 2 = block (this script always allows)
+set -euo pipefail
+${sharedHelpers()}
+TRACE_DIR="\${AUTOMATOSX_TRACE_DIR:-.automatosx/logs}"
+mkdir -p "\$TRACE_DIR"
+
+INPUT="\$(cat)"
+TOOL="\$(ax_jq_field '.tool_name' 'unknown' "\$INPUT")"
+SESSION="\$(ax_jq_field '.session_id' '' "\$INPUT")"
+
+if command -v jq &>/dev/null; then
+  jq -cn --arg ts "\$(date -u +"%Y-%m-%dT%H:%M:%SZ")" --arg event "PreToolUse" --arg tool "\$TOOL" --arg session "\$SESSION" \
+    '{ts:\$ts,event:\$event,tool:\$tool,session:\$session}' >> "\$TRACE_DIR/hook-trace.jsonl" 2>/dev/null || true
+else
+  printf '{"ts":"%s","event":"PreToolUse"}\n' "\$(date -u +"%Y-%m-%dT%H:%M:%SZ")" >> "\$TRACE_DIR/hook-trace.jsonl" 2>/dev/null || true
+fi
+
+exit 0
+`;
+}
+function postToolUseScript() {
+    return `#!/usr/bin/env bash
+# AutomatosX PostToolUse hook
+# Receives JSON on stdin: { tool_name, tool_input, tool_response, session_id, cwd }
+# Exit 0 = success
+set -euo pipefail
+${sharedHelpers()}
+TRACE_DIR="\${AUTOMATOSX_TRACE_DIR:-.automatosx/logs}"
+mkdir -p "\$TRACE_DIR"
+
+INPUT="\$(cat)"
+TOOL="\$(ax_jq_field '.tool_name' 'unknown' "\$INPUT")"
+SESSION="\$(ax_jq_field '.session_id' '' "\$INPUT")"
+
+if command -v jq &>/dev/null; then
+  jq -cn --arg ts "\$(date -u +"%Y-%m-%dT%H:%M:%SZ")" --arg event "PostToolUse" --arg tool "\$TOOL" --arg session "\$SESSION" \
+    '{ts:\$ts,event:\$event,tool:\$tool,session:\$session}' >> "\$TRACE_DIR/hook-trace.jsonl" 2>/dev/null || true
+else
+  printf '{"ts":"%s","event":"PostToolUse"}\n' "\$(date -u +"%Y-%m-%dT%H:%M:%SZ")" >> "\$TRACE_DIR/hook-trace.jsonl" 2>/dev/null || true
+fi
+
+exit 0
+`;
+}
+function sessionStartScript() {
+    return `#!/usr/bin/env bash
+# AutomatosX SessionStart hook
+# Receives JSON on stdin: { session_id, cwd }
+set -euo pipefail
+${sharedHelpers()}
+TRACE_DIR="\${AUTOMATOSX_TRACE_DIR:-.automatosx/logs}"
+mkdir -p "\$TRACE_DIR"
+
+INPUT="\$(cat)"
+SESSION="\$(ax_jq_field '.session_id' '' "\$INPUT")"
+CWD="\$(ax_jq_field '.cwd' '' "\$INPUT")"
+
+if command -v jq &>/dev/null; then
+  jq -cn --arg ts "\$(date -u +"%Y-%m-%dT%H:%M:%SZ")" --arg event "SessionStart" --arg session "\$SESSION" --arg cwd "\$CWD" \
+    '{ts:\$ts,event:\$event,session:\$session,cwd:\$cwd}' >> "\$TRACE_DIR/hook-trace.jsonl" 2>/dev/null || true
+else
+  printf '{"ts":"%s","event":"SessionStart"}\n' "\$(date -u +"%Y-%m-%dT%H:%M:%SZ")" >> "\$TRACE_DIR/hook-trace.jsonl" 2>/dev/null || true
+fi
+
+exit 0
+`;
+}
+function sessionEndScript() {
+    return `#!/usr/bin/env bash
+# AutomatosX SessionEnd hook
+# Receives JSON on stdin: { session_id, cwd }
+set -euo pipefail
+${sharedHelpers()}
+TRACE_DIR="\${AUTOMATOSX_TRACE_DIR:-.automatosx/logs}"
+mkdir -p "\$TRACE_DIR"
+
+INPUT="\$(cat)"
+SESSION="\$(ax_jq_field '.session_id' '' "\$INPUT")"
+
+if command -v jq &>/dev/null; then
+  jq -cn --arg ts "\$(date -u +"%Y-%m-%dT%H:%M:%SZ")" --arg event "SessionEnd" --arg session "\$SESSION" \
+    '{ts:\$ts,event:\$event,session:\$session}' >> "\$TRACE_DIR/hook-trace.jsonl" 2>/dev/null || true
+else
+  printf '{"ts":"%s","event":"SessionEnd"}\n' "\$(date -u +"%Y-%m-%dT%H:%M:%SZ")" >> "\$TRACE_DIR/hook-trace.jsonl" 2>/dev/null || true
+fi
+
+exit 0
+`;
+}
+const HOOK_SCRIPTS = {
+    PreToolUse: { filename: 'pre-tool-use.sh', content: preToolUseScript },
+    PostToolUse: { filename: 'post-tool-use.sh', content: postToolUseScript },
+    PostToolUseFailure: { filename: 'post-tool-use.sh', content: postToolUseScript },
+    SessionStart: { filename: 'session-start.sh', content: sessionStartScript },
+    SessionEnd: { filename: 'session-end.sh', content: sessionEndScript },
+    SubagentStart: { filename: 'session-start.sh', content: sessionStartScript },
+    SubagentStop: { filename: 'session-end.sh', content: sessionEndScript },
+};
+export class HooksGenerator {
+    projectDir;
+    enabledEvents;
+    force;
+    constructor(options) {
+        this.projectDir = options.projectDir;
+        this.enabledEvents = options.enabledEvents ?? DEFAULT_EVENTS;
+        this.force = options.force ?? false;
+    }
+    async generate() {
+        const hooksDir = join(this.projectDir, '.claude', 'hooks');
+        await mkdir(hooksDir, { recursive: true });
+        const scriptsWritten = [];
+        const scriptsSkipped = [];
+        const seen = new Set();
+        for (const event of this.enabledEvents) {
+            const def = HOOK_SCRIPTS[event];
+            if (!def || seen.has(def.filename))
+                continue;
+            seen.add(def.filename);
+            const scriptPath = join(hooksDir, def.filename);
+            if ((await fileExists(scriptPath)) && !this.force) {
+                scriptsSkipped.push(def.filename);
+                continue;
+            }
+            await writeFile(scriptPath, def.content(), { encoding: 'utf-8', flag: 'w' });
+            await chmod(scriptPath, 0o755);
+            scriptsWritten.push(def.filename);
+        }
+        const settingsUpdated = await this.writeHookConfig();
+        return { hooksDir, scriptsWritten, scriptsSkipped, settingsUpdated };
+    }
+    buildHooksConfig() {
+        const config = {};
+        for (const event of this.enabledEvents) {
+            const def = HOOK_SCRIPTS[event];
+            if (!def)
+                continue;
+            const scriptPath = `.claude/hooks/${def.filename}`;
+            const matcher = {
+                hooks: [{
+                        type: 'command',
+                        command: scriptPath,
+                        timeout: event === 'SessionStart' || event === 'SessionEnd' ? 15 : 30,
+                    }],
+            };
+            if (event === 'PreToolUse' || event === 'PostToolUse' || event === 'PostToolUseFailure') {
+                matcher.matcher = '.*';
+            }
+            config[event] = [matcher];
+        }
+        return config;
+    }
+    async writeHookConfig() {
+        const mgr = new SettingsManager(this.projectDir);
+        const settings = await mgr.read();
+        const hooksConfig = this.buildHooksConfig();
+        const existing = settings.hooks ?? {};
+        settings.hooks = { ...existing, ...hooksConfig };
+        await writeJsonFile(mgr.getSettingsPath(), settings);
+        return true;
+    }
+    async areHooksGenerated() {
+        const hooksDir = join(this.projectDir, '.claude', 'hooks');
+        const seen = new Set();
+        for (const event of this.enabledEvents) {
+            const def = HOOK_SCRIPTS[event];
+            if (!def || seen.has(def.filename))
+                continue;
+            seen.add(def.filename);
+            if (!(await fileExists(join(hooksDir, def.filename))))
+                return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=hooks-generator.js.map

package/dist/integrations/claude-code/hooks-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-generator.js","sourceRoot":"","sources":["../../../src/integrations/claude-code/hooks-generator.ts"],"names":[],"mappings":"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"}

package/dist/integrations/claude-code/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Claude Code Integration
+ *
+ * Bidirectional integration between AutomatosX and Claude Code 2026:
+ * settings.json management, hooks, .mcp.json, per-agent subagent files.
+ */
+export { ClaudeCodeIntegration } from './claude-code-integration.js';
+export { SettingsManager } from './settings-manager.js';
+export { McpProjectConfigGenerator } from './mcp-project-config.js';
+export { HooksGenerator } from './hooks-generator.js';
+export { SubagentGenerator } from './subagent-generator.js';
+export type { ClaudeCodeSetupOptions, ClaudeCodeSetupResult, } from './claude-code-integration.js';
+export type { HooksGeneratorOptions, HooksGenerateResult } from './hooks-generator.js';
+export type { SubagentGeneratorOptions, SubagentGenerateResult } from './subagent-generator.js';
+export type { ClaudeCodeDiagnostics, ClaudeCodeSettings, HookEvent, HookType, HooksConfig, HookMatcher, HookEntry, McpTransport, ClaudeMCPServer, MCPManifest, ValidationResult, SubagentFrontmatter, SubagentPermissionMode, SubagentMemoryScope, SubagentEffort, AgentClaudeCodeConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/claude-code/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/claude-code/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACvF,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEhG,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/integrations/claude-code/index.js

@@ -0,0 +1,12 @@
+/**
+ * Claude Code Integration
+ *
+ * Bidirectional integration between AutomatosX and Claude Code 2026:
+ * settings.json management, hooks, .mcp.json, per-agent subagent files.
+ */
+export { ClaudeCodeIntegration } from './claude-code-integration.js';
+export { SettingsManager } from './settings-manager.js';
+export { McpProjectConfigGenerator } from './mcp-project-config.js';
+export { HooksGenerator } from './hooks-generator.js';
+export { SubagentGenerator } from './subagent-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/claude-code/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/claude-code/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/integrations/claude-code/mcp-project-config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * .mcp.json Generator
+ *
+ * Generates the team-shared .mcp.json at the project root.
+ * This file is committable and tells Claude Code how to reach the
+ * AutomatosX MCP server without per-user registration.
+ */
+export declare class McpProjectConfigGenerator {
+    private mcpJsonPath;
+    constructor(projectDir: string);
+    /** Generate or merge .mcp.json. Never removes existing mcpServers entries. */
+    generate(): Promise<void>;
+    /** Returns true if the automatosx key is present in .mcp.json */
+    isGenerated(): Promise<boolean>;
+}
+//# sourceMappingURL=mcp-project-config.d.ts.map

package/dist/integrations/claude-code/mcp-project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-project-config.d.ts","sourceRoot":"","sources":["../../../src/integrations/claude-code/mcp-project-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,WAAW,CAAS;gBAEhB,UAAU,EAAE,MAAM;IAI9B,8EAA8E;IACxE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B/B,iEAAiE;IAC3D,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAStC"}

package/dist/integrations/claude-code/mcp-project-config.js

@@ -0,0 +1,55 @@
+/**
+ * .mcp.json Generator
+ *
+ * Generates the team-shared .mcp.json at the project root.
+ * This file is committable and tells Claude Code how to reach the
+ * AutomatosX MCP server without per-user registration.
+ */
+import { join } from 'node:path';
+import { fileExists, readJsonFile, writeJsonFile } from './utils/file-utils.js';
+const AUTOMATOSX_SERVER_NAME = 'automatosx';
+export class McpProjectConfigGenerator {
+    mcpJsonPath;
+    constructor(projectDir) {
+        this.mcpJsonPath = join(projectDir, '.mcp.json');
+    }
+    /** Generate or merge .mcp.json. Never removes existing mcpServers entries. */
+    async generate() {
+        let existing = {};
+        if (await fileExists(this.mcpJsonPath)) {
+            try {
+                existing = await readJsonFile(this.mcpJsonPath);
+            }
+            catch {
+                existing = {};
+            }
+        }
+        const mcpServers = existing.mcpServers ?? {};
+        // Only add if not already present
+        if (!mcpServers[AUTOMATOSX_SERVER_NAME]) {
+            mcpServers[AUTOMATOSX_SERVER_NAME] = {
+                type: 'stdio',
+                command: 'ax',
+                args: ['mcp', 'server'],
+                env: { AUTOMATOSX_LOG_LEVEL: 'warn' },
+            };
+        }
+        await writeJsonFile(this.mcpJsonPath, {
+            ...existing,
+            mcpServers,
+        });
+    }
+    /** Returns true if the automatosx key is present in .mcp.json */
+    async isGenerated() {
+        if (!(await fileExists(this.mcpJsonPath)))
+            return false;
+        try {
+            const config = await readJsonFile(this.mcpJsonPath);
+            return !!config.mcpServers?.[AUTOMATOSX_SERVER_NAME];
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=mcp-project-config.js.map

package/dist/integrations/claude-code/mcp-project-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-project-config.js","sourceRoot":"","sources":["../../../src/integrations/claude-code/mcp-project-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEhF,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAE5C,MAAM,OAAO,yBAAyB;IAC5B,WAAW,CAAS;IAE5B,YAAY,UAAkB;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,QAAQ;QACZ,IAAI,QAAQ,GAAgB,EAAE,CAAC;QAE/B,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,YAAY,CAAc,IAAI,CAAC,WAAW,CAAC,CAAC;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,GAAG,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;QAE7C,kCAAkC;QAClC,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,EAAE,CAAC;YACxC,UAAU,CAAC,sBAAsB,CAAC,GAAG;gBACnC,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;gBACvB,GAAG,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE;aACtC,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE;YACpC,GAAG,QAAQ;YACX,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAc,IAAI,CAAC,WAAW,CAAC,CAAC;YACjE,OAAO,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,sBAAsB,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/integrations/claude-code/settings-manager.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Claude Code Settings Manager
+ *
+ * Manages .claude/settings.json — the project-shared settings file.
+ * Uses a safe merge strategy: adds missing entries, never removes existing ones.
+ */
+import type { ClaudeCodeSettings } from './types.js';
+export declare class SettingsManager {
+    private claudeDir;
+    private settingsPath;
+    constructor(projectDir: string);
+    getSettingsPath(): string;
+    read(): Promise<ClaudeCodeSettings>;
+    /**
+     * Merge MCP permissions into settings.json.
+     * Never removes existing entries — only adds missing ones.
+     */
+    writeMcpPermissions(): Promise<void>;
+    /** Returns true if all 16 AutomatosX permissions are present */
+    hasAutomatosXPermissions(): Promise<boolean>;
+}
+//# sourceMappingURL=settings-manager.d.ts.map

package/dist/integrations/claude-code/settings-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-manager.d.ts","sourceRoot":"","sources":["../../../src/integrations/claude-code/settings-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAuBrD,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;gBAEjB,UAAU,EAAE,MAAM;IAK9B,eAAe,IAAI,MAAM;IAInB,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAWzC;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB1C,gEAAgE;IAC1D,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC;CAKnD"}

package/dist/integrations/claude-code/settings-manager.js

@@ -0,0 +1,75 @@
+/**
+ * Claude Code Settings Manager
+ *
+ * Manages .claude/settings.json — the project-shared settings file.
+ * Uses a safe merge strategy: adds missing entries, never removes existing ones.
+ */
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileExists, readJsonFile, writeJsonFile } from './utils/file-utils.js';
+/** MCP tool permissions AutomatosX needs */
+const AUTOMATOSX_MCP_PERMISSIONS = [
+    'mcp__automatosx__run_agent',
+    'mcp__automatosx__list_agents',
+    'mcp__automatosx__search_memory',
+    'mcp__automatosx__save_memory',
+    'mcp__automatosx__session_create',
+    'mcp__automatosx__session_list',
+    'mcp__automatosx__session_status',
+    'mcp__automatosx__session_close',
+    'mcp__automatosx__get_context',
+    'mcp__automatosx__update_context',
+    'mcp__automatosx__list_workflows',
+    'mcp__automatosx__run_workflow',
+    'mcp__automatosx__get_trace',
+    'mcp__automatosx__list_traces',
+    'mcp__automatosx__get_provider_status',
+    'mcp__automatosx__health_check',
+];
+export class SettingsManager {
+    claudeDir;
+    settingsPath;
+    constructor(projectDir) {
+        this.claudeDir = join(projectDir, '.claude');
+        this.settingsPath = join(this.claudeDir, 'settings.json');
+    }
+    getSettingsPath() {
+        return this.settingsPath;
+    }
+    async read() {
+        if (!(await fileExists(this.settingsPath))) {
+            return {};
+        }
+        try {
+            return await readJsonFile(this.settingsPath);
+        }
+        catch {
+            return {};
+        }
+    }
+    /**
+     * Merge MCP permissions into settings.json.
+     * Never removes existing entries — only adds missing ones.
+     */
+    async writeMcpPermissions() {
+        await mkdir(this.claudeDir, { recursive: true });
+        const settings = await this.read();
+        if (!settings.permissions)
+            settings.permissions = {};
+        if (!settings.permissions.allow)
+            settings.permissions.allow = [];
+        const existing = new Set(settings.permissions.allow);
+        for (const perm of AUTOMATOSX_MCP_PERMISSIONS) {
+            existing.add(perm);
+        }
+        settings.permissions.allow = Array.from(existing);
+        await writeJsonFile(this.settingsPath, settings);
+    }
+    /** Returns true if all 16 AutomatosX permissions are present */
+    async hasAutomatosXPermissions() {
+        const settings = await this.read();
+        const allowed = new Set(settings.permissions?.allow ?? []);
+        return AUTOMATOSX_MCP_PERMISSIONS.every(p => allowed.has(p));
+    }
+}
+//# sourceMappingURL=settings-manager.js.map

package/dist/integrations/claude-code/settings-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-manager.js","sourceRoot":"","sources":["../../../src/integrations/claude-code/settings-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEhF,4CAA4C;AAC5C,MAAM,0BAA0B,GAAa;IAC3C,4BAA4B;IAC5B,8BAA8B;IAC9B,gCAAgC;IAChC,8BAA8B;IAC9B,iCAAiC;IACjC,+BAA+B;IAC/B,iCAAiC;IACjC,gCAAgC;IAChC,8BAA8B;IAC9B,iCAAiC;IACjC,iCAAiC;IACjC,+BAA+B;IAC/B,4BAA4B;IAC5B,8BAA8B;IAC9B,sCAAsC;IACtC,+BAA+B;CAChC,CAAC;AAEF,MAAM,OAAO,eAAe;IAClB,SAAS,CAAS;IAClB,YAAY,CAAS;IAE7B,YAAY,UAAkB;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YAC3C,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,YAAY,CAAqB,IAAI,CAAC,YAAY,CAAC,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB;QACvB,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,CAAC,QAAQ,CAAC,WAAW;YAAE,QAAQ,CAAC,WAAW,GAAG,EAAE,CAAC;QACrD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK;YAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,GAAG,EAAE,CAAC;QAEjE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACrD,KAAK,MAAM,IAAI,IAAI,0BAA0B,EAAE,CAAC;YAC9C,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,QAAQ,CAAC,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAElD,MAAM,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,wBAAwB;QAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO,0BAA0B,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/integrations/claude-code/subagent-generator.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Claude Code Subagent File Generator
+ *
+ * Generates .claude/agents/<name>.md files with Claude Code 2026 YAML
+ * frontmatter for each agent, plus the automatosx-coordinator.md.
+ *
+ * These files enable Claude Code to invoke AutomatosX agents as
+ * native subagents with appropriate permissions and MCP access.
+ */
+import type { AgentClaudeCodeConfig } from './types.js';
+/** Minimal agent shape we need from agent-domain */
+interface AgentLike {
+    name: string;
+    displayName?: string;
+    description?: string;
+    role?: string;
+    systemPrompt?: string;
+    claude_code?: AgentClaudeCodeConfig;
+}
+export interface SubagentGenerateResult {
+    agentsDir: string;
+    filesWritten: string[];
+    filesSkipped: string[];
+}
+export interface SubagentGeneratorOptions {
+    projectDir: string;
+    force?: boolean;
+}
+export declare class SubagentGenerator {
+    private projectDir;
+    private force;
+    constructor(options: SubagentGeneratorOptions);
+    /**
+     * Generate per-agent subagent files plus the coordinator.
+     * Can be called independently (e.g. via `ax init --claude-agents-only`).
+     */
+    generate(agents: AgentLike[]): Promise<SubagentGenerateResult>;
+    /** Returns true if coordinator file exists */
+    areSubagentFilesGenerated(): Promise<boolean>;
+    private buildFrontmatter;
+    private renderFrontmatter;
+    private buildAgentFile;
+    private buildCoordinatorFile;
+    private getDescription;
+}
+export {};
+//# sourceMappingURL=subagent-generator.d.ts.map

package/dist/integrations/claude-code/subagent-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-generator.d.ts","sourceRoot":"","sources":["../../../src/integrations/claude-code/subagent-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAuB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAG7E,oDAAoD;AACpD,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC;AAID,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAU;gBAEX,OAAO,EAAE,wBAAwB;IAK7C;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmCpE,8CAA8C;IACxC,yBAAyB,IAAI,OAAO,CAAC,OAAO,CAAC;IAOnD,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,oBAAoB;IAkD5B,OAAO,CAAC,cAAc;CASvB"}