From 48c75c780843bfef16c2681d045b619d46b9d670 Mon Sep 17 00:00:00 2001 From: nunziati Date: Wed, 8 Apr 2026 13:54:23 +0000 Subject: [PATCH] Implement agentic-platform adapter for Claude Code. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit build(adapters): claude-code adapter skeleton with capability/event tables build(claude-code): adapter_translate_dispatcher with test build(claude-code): adapter_translate_references with test build(claude-code): adapter_translate_skills with tests build(claude-code): adapter_translate_agents with capability→tools mapping build(claude-code): hook wrapper template (CC native → neutral schema) build(claude-code): adapter_translate_hooks with wrapper generation build(claude-code): adapter_translate_mcp with hand-rolled YAML parser build(claude-code): adapter_finalize and complete adapter_build wiring build: scripts/build.sh dispatches to per-framework adapter Also fix adapter_translate_hooks and adapter_translate_agents to use while-read loops (avoiding word-splitting on paths with spaces) and guard grep calls with || true to survive set -eo pipefail when hooks have no match-tool field. Remove scripts/build.sh from .gitignore. Co-Authored-By: Claude Sonnet 4.6 --- .gitignore | 1 - adapters/claude-code/adapter.sh | 292 ++++++++++++++++++ .../templates/cc-hook-wrapper.sh.tmpl | 23 ++ scripts/build.sh | 43 +++ tests/adapters/claude-code/adapter.test.sh | 185 +++++++++++ 5 files changed, 543 insertions(+), 1 deletion(-) mode change 100644 => 100755 .gitignore create mode 100755 adapters/claude-code/adapter.sh create mode 100755 adapters/claude-code/templates/cc-hook-wrapper.sh.tmpl create mode 100755 scripts/build.sh create mode 100755 tests/adapters/claude-code/adapter.test.sh diff --git a/.gitignore b/.gitignore old mode 100644 new mode 100755 index efb0bfd..c4a4b0a --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,5 @@ # Build artifacts dist/ -scripts/build.sh logs/ # macOS .DS_Store diff --git a/adapters/claude-code/adapter.sh b/adapters/claude-code/adapter.sh new file mode 100755 index 0000000..ef83f17 --- /dev/null +++ b/adapters/claude-code/adapter.sh @@ -0,0 +1,292 @@ +#!/usr/bin/env bash +# ============================================================================= +# adapters/claude-code/adapter.sh — Claude Code framework adapter +# ============================================================================= +# Sourced by scripts/build.sh AFTER adapters/lib.sh. +# Translates source files into a dist/claude-code/ tree that mirrors what +# Claude Code expects in the user's vault. +# ============================================================================= + +FRAMEWORK="claude-code" + +# Capability → CC tools mapping. Each capability expands into one or more +# Claude Code tool names. The expansion is order-preserving. +cc_capability_to_tools() { + local cap="$1" + case "$cap" in + read) echo "Read Glob Grep" ;; + write) echo "Write" ;; + edit) echo "Edit" ;; + bash) echo "Bash" ;; + webfetch) echo "WebFetch" ;; + websearch) echo "WebSearch" ;; + notebook) echo "NotebookEdit" ;; + task) echo "Task" ;; + todo) echo "TodoWrite" ;; + *) echo "" ;; + esac +} + +# Event vocabulary → CC native event mapping. +cc_event_to_native() { + local event="$1" + case "$event" in + before-tool-use) echo "PreToolUse" ;; + after-tool-use) echo "PostToolUse" ;; + on-notification) echo "Notification" ;; + on-session-start) echo "SessionStart" ;; + on-prompt-submit) echo "UserPromptSubmit" ;; + *) echo "" ;; + esac +} + +# adapter_finalize +# Writes any framework-specific top-level files (plugin manifest, etc.). +adapter_finalize() { + local src="$1" dst="$2" + if [[ -f "$src/.claude-plugin/plugin.json" ]]; then + mkdir -p "$dst/.claude-plugin" + cp "$src/.claude-plugin/plugin.json" "$dst/.claude-plugin/plugin.json" + fi +} + +# adapter_translate_mcp +# Reads mcp/servers.yaml and writes dst/.mcp.json with mcpServers key. +adapter_translate_mcp() { + local src="$1" dst="$2" + local yaml="$src/servers.yaml" + [[ -f "$yaml" ]] || return 0 + + local out="$dst/.mcp.json" + mkdir -p "$dst" + + # Parse the YAML into a JSON object {server_name: {command, args, env}} + local json='{}' + local current_name="" current_cmd="" current_url="" current_type="" + + while IFS= read -r line; do + case "$line" in + *"- name:"*) + # Flush previous server + if [[ -n "$current_name" ]]; then + if [[ -n "$current_cmd" ]]; then + local first_arg="${current_cmd%% *}" + local rest="${current_cmd#* }" + local args_json='[]' + if [[ "$rest" != "$current_cmd" ]]; then + args_json="$(echo "$rest" | jq -R 'split(" ")')" + fi + json="$(echo "$json" | jq --arg n "$current_name" --arg c "$first_arg" --argjson a "$args_json" '.[$n] = {command: $c, args: $a, env: {}}')" + elif [[ -n "$current_url" ]]; then + json="$(echo "$json" | jq --arg n "$current_name" --arg u "$current_url" --arg t "$current_type" '.[$n] = {type: $t, url: $u}')" + fi + fi + current_name="$(echo "$line" | sed 's/.*- name:[[:space:]]*//' | tr -d '"')" + current_cmd="" + current_url="" + current_type="http" + ;; + *"command:"*"["*) + current_cmd="$(echo "$line" | sed 's/.*command:[[:space:]]*\[//' | sed 's/\][[:space:]]*$//' | tr -d '"' | sed 's/,[[:space:]]*/\ /g')" + ;; + *"url:"*) + current_url="$(echo "$line" | sed 's/.*url:[[:space:]]*//' | tr -d '"')" + ;; + *"type:"*) + current_type="$(echo "$line" | sed 's/.*type:[[:space:]]*//' | tr -d '"')" + ;; + esac + done < "$yaml" + + # Flush the last server + if [[ -n "$current_name" ]]; then + if [[ -n "$current_cmd" ]]; then + local first_arg="${current_cmd%% *}" + local rest="${current_cmd#* }" + local args_json='[]' + if [[ "$rest" != "$current_cmd" ]]; then + args_json="$(echo "$rest" | jq -R 'split(" ")')" + fi + json="$(echo "$json" | jq --arg n "$current_name" --arg c "$first_arg" --argjson a "$args_json" '.[$n] = {command: $c, args: $a, env: {}}')" + elif [[ -n "$current_url" ]]; then + json="$(echo "$json" | jq --arg n "$current_name" --arg u "$current_url" --arg t "$current_type" '.[$n] = {type: $t, url: $u}')" + fi + fi + + echo "$json" | jq '{mcpServers: .}' > "$out" +} + +# Helper: convert match-tool tokens to CC matcher syntax (e.g., "edit write" → "Edit|Write") +cc_match_tool_to_matcher() { + local tokens="$1" + local matcher="" + for t in $tokens; do + local cap_t + cap_t="$(echo "$t" | awk '{print toupper(substr($0,1,1)) substr($0,2)}')" + if [[ -z "$matcher" ]]; then + matcher="$cap_t" + else + matcher="$matcher|$cap_t" + fi + done + echo "$matcher" +} + +# adapter_translate_hooks +adapter_translate_hooks() { + local src="$1" dst="$2" + [[ -d "$src" ]] || return 0 + local out_dir="$dst/.claude/hooks" + mkdir -p "$out_dir" + + local template; template="$(dirname "${BASH_SOURCE[0]}")/templates/cc-hook-wrapper.sh.tmpl" + + # Accumulate hook entries here, by event type + local pre_entries="" post_entries="" notif_entries="" sess_entries="" prompt_entries="" + + while IFS= read -r yaml; do + [[ -z "$yaml" ]] && continue + should_include "$yaml" "$FRAMEWORK" || continue + local meta; meta="$(parse_hook_yaml "$yaml")" + local name; name="$(echo "$meta" | grep '^name=' | head -1 | cut -d= -f2- || true)" + local script; script="$(echo "$meta" | grep '^script=' | head -1 | cut -d= -f2- || true)" + local event; event="$(echo "$meta" | grep '^event=' | head -1 | cut -d= -f2- || true)" + local match_tool; match_tool="$(echo "$meta" | grep '^match-tool=' | head -1 | cut -d= -f2- || true)" + + # Copy the bash script + cp "$src/$script" "$out_dir/$script" + chmod +x "$out_dir/$script" + + # Generate the wrapper + local wrapper_file="$out_dir/${name}-wrapper.sh" + local cc_event; cc_event="$(cc_event_to_native "$event")" + sed -e "s/__HOOK_NAME__/$name/g" -e "s/__EVENT_NAME__/$event/g" "$template" > "$wrapper_file" + chmod +x "$wrapper_file" + + # Build the settings.json entry for this hook + local matcher="" + [[ -n "$match_tool" ]] && matcher="$(cc_match_tool_to_matcher "$match_tool")" + local entry; entry="$(jq -cn \ + --arg cmd ".claude/hooks/${name}-wrapper.sh" \ + --arg matcher "$matcher" \ + '{matcher: $matcher, hooks: [{type: "command", command: ("bash " + $cmd)}]}')" + + case "$cc_event" in + PreToolUse) pre_entries="$pre_entries$entry"$'\n' ;; + PostToolUse) post_entries="$post_entries$entry"$'\n' ;; + Notification) notif_entries="$notif_entries$entry"$'\n' ;; + SessionStart) sess_entries="$sess_entries$entry"$'\n' ;; + UserPromptSubmit) prompt_entries="$prompt_entries$entry"$'\n' ;; + esac + done < <(enumerate_hooks "$src") + + # Compose the final settings.json + local settings; settings='{"hooks":{}}' + for ev_pair in "PreToolUse:$pre_entries" "PostToolUse:$post_entries" "Notification:$notif_entries" "SessionStart:$sess_entries" "UserPromptSubmit:$prompt_entries"; do + local ev_name="${ev_pair%%:*}" + local ev_data="${ev_pair#*:}" + [[ -z "$ev_data" ]] && continue + local arr; arr="$(echo "$ev_data" | jq -cs '.')" + settings="$(echo "$settings" | jq --arg ev "$ev_name" --argjson arr "$arr" '.hooks[$ev] = $arr')" + done + + mkdir -p "$dst/.claude" + echo "$settings" | jq '.' > "$dst/.claude/settings.json" +} + +# adapter_translate_agents +# For each *.md in source_agents_dir, translate the capabilities frontmatter +# into a CC tools: allowlist and write to dest_root/.claude/agents/.md. +adapter_translate_agents() { + local src="$1" dst="$2" + [[ -d "$src" ]] || return 0 + local out_dir="$dst/.claude/agents" + mkdir -p "$out_dir" + + while IFS= read -r agent; do + [[ -z "$agent" ]] && continue + should_include "$agent" "$FRAMEWORK" || continue + local name; name="$(parse_frontmatter "$agent" name)" + local model; model="$(parse_frontmatter "$agent" model)" + local caps; caps="$(parse_capabilities "$agent")" + + # Build tools allowlist by expanding each capability + local tools="" + for cap in $caps; do + local expansion; expansion="$(cc_capability_to_tools "$cap")" + [[ -n "$expansion" ]] || continue + for tool in $expansion; do + if [[ -z "$tools" ]]; then + tools="$tool" + else + tools="$tools, $tool" + fi + done + done + + local out_file="$out_dir/$(basename "$agent")" + { + echo "---" + echo "name: $name" + # Copy description block (may be folded YAML with continuation lines) + awk '/^---$/{n++; next} n==1 && /^description:/{print; in_desc=1; next} n==1 && in_desc && /^[[:space:]]/{print; next} n==1 && in_desc && !/^[[:space:]]/{in_desc=0} n>=2{exit}' "$agent" + echo "tools: $tools" + echo "model: $model" + echo "---" + agent_body "$agent" + } > "$out_file" + done < <(enumerate_agents "$src") +} + +# adapter_translate_skills +# Copies each skill directory's SKILL.md into dest_root/.claude/skills//. +adapter_translate_skills() { + local src="$1" dst="$2" + [[ -d "$src" ]] || return 0 + for skill_dir in "$src"/*/; do + [[ -f "${skill_dir}SKILL.md" ]] || continue + should_include "${skill_dir}SKILL.md" "$FRAMEWORK" || continue + local name; name="$(basename "$skill_dir")" + local out="$dst/.claude/skills/$name" + mkdir -p "$out" + cp "${skill_dir}SKILL.md" "$out/SKILL.md" + done +} + +# adapter_translate_references +# Verbatim copy of *.md into dest_root/.claude/references/. +adapter_translate_references() { + local src="$1" dst="$2" + [[ -d "$src" ]] || return 0 + local out="$dst/.claude/references" + mkdir -p "$out" + for f in "$src"/*.md; do + [[ -f "$f" ]] || continue + should_include "$f" "$FRAMEWORK" || continue + cp "$f" "$out/" + done +} + +# adapter_translate_dispatcher +# Copies the source DISPATCHER.md to dest_dir/CLAUDE.md (no content change). +adapter_translate_dispatcher() { + local src="$1" dst="$2" + [[ -f "$src" ]] || return 0 + mkdir -p "$dst" + cp "$src" "$dst/CLAUDE.md" +} + +# adapter_build +# The single entry point invoked by scripts/build.sh. +adapter_build() { + local src="$1" dst="$2" + rm -rf "$dst" + mkdir -p "$dst" + adapter_translate_dispatcher "$src/DISPATCHER.md" "$dst" + adapter_translate_references "$src/references" "$dst" + adapter_translate_skills "$src/skills" "$dst" + adapter_translate_agents "$src/agents" "$dst" + adapter_translate_hooks "$src/hooks" "$dst" + adapter_translate_mcp "$src/mcp" "$dst" + adapter_finalize "$src" "$dst" +} diff --git a/adapters/claude-code/templates/cc-hook-wrapper.sh.tmpl b/adapters/claude-code/templates/cc-hook-wrapper.sh.tmpl new file mode 100755 index 0000000..411340e --- /dev/null +++ b/adapters/claude-code/templates/cc-hook-wrapper.sh.tmpl @@ -0,0 +1,23 @@ +#!/usr/bin/env bash +# ============================================================================= +# Generated by adapters/claude-code/adapter.sh — do not edit. +# Wrapper for hook: __HOOK_NAME__ +# Reads Claude Code native PreToolUse/PostToolUse/Notification JSON from stdin, +# transforms it into the neutral schema, and pipes the result to __HOOK_NAME__.sh. +# ============================================================================= +set -eo pipefail + +INPUT=$(cat) +HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" + +# Translate CC native fields to the neutral schema +NEUTRAL=$(echo "$INPUT" | jq -c '{ + event: "__EVENT_NAME__", + tool: (.tool_name // ""), + args: (.tool_input // {title: .title, message: .message}), + session_id: (.session_id // ""), + cwd: (.cwd // ""), + framework: "claude-code" +}') + +echo "$NEUTRAL" | bash "$HOOK_DIR/__HOOK_NAME__.sh" diff --git a/scripts/build.sh b/scripts/build.sh new file mode 100755 index 0000000..59294e2 --- /dev/null +++ b/scripts/build.sh @@ -0,0 +1,43 @@ +#!/usr/bin/env bash +# ============================================================================= +# scripts/build.sh — Run the framework adapter to populate dist// +# ============================================================================= +# Usage: bash scripts/build.sh --framework +# Discovers available frameworks by listing adapters/ subdirectories. +# ============================================================================= +set -eo pipefail + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)" +# shellcheck source=scripts/lib.sh +source "$SCRIPT_DIR/lib.sh" + +# ── Parse args ───────────────────────────────────────────────────────────── +FRAMEWORK="claude-code" +while [[ $# -gt 0 ]]; do + case "$1" in + --framework) FRAMEWORK="$2"; shift 2 ;; + *) die "Unknown argument: $1" ;; + esac +done + +# ── Validate framework ───────────────────────────────────────────────────── +if [[ ! -d "$REPO_ROOT/adapters/$FRAMEWORK" ]]; then + AVAILABLE="$(ls "$REPO_ROOT/adapters/" 2>/dev/null | grep -v '^lib.sh$' | tr '\n' ' ')" + die "Unknown framework: $FRAMEWORK. Available: $AVAILABLE" +fi + +# ── Check dependencies ───────────────────────────────────────────────────── +command -v jq >/dev/null 2>&1 || die "jq is required for the build (install via brew, apt, etc.)" + +# ── Source adapters ──────────────────────────────────────────────────────── +# shellcheck source=adapters/lib.sh +source "$REPO_ROOT/adapters/lib.sh" +# shellcheck source=/dev/null +source "$REPO_ROOT/adapters/$FRAMEWORK/adapter.sh" + +# ── Run the build ────────────────────────────────────────────────────────── +DIST_DIR="$REPO_ROOT/dist/$FRAMEWORK" +info "Building $FRAMEWORK → $DIST_DIR" +adapter_build "$REPO_ROOT" "$DIST_DIR" +success "Build complete" diff --git a/tests/adapters/claude-code/adapter.test.sh b/tests/adapters/claude-code/adapter.test.sh new file mode 100755 index 0000000..2f83cc0 --- /dev/null +++ b/tests/adapters/claude-code/adapter.test.sh @@ -0,0 +1,185 @@ +#!/usr/bin/env bash +# Tests for adapters/claude-code/adapter.sh +ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)" +source "$ROOT/adapters/lib.sh" +source "$ROOT/adapters/claude-code/adapter.sh" + +test_finalize_writes_plugin_json() { + local src; src="$(mktemp -d)" + local dst; dst="$(mktemp -d)" + mkdir -p "$src/.claude-plugin" + echo '{"name": "test"}' > "$src/.claude-plugin/plugin.json" + adapter_finalize "$src" "$dst" + local result=0 + [[ -f "$dst/.claude-plugin/plugin.json" ]] || { echo "plugin.json missing"; result=1; } + rm -rf "$src" "$dst" + return $result +} + +test_translate_mcp_basic() { + local src; src="$(mktemp -d)" + local dst; dst="$(mktemp -d)" + mkdir -p "$src/mcp" + cat > "$src/mcp/servers.yaml" <<'EOF' +servers: + - name: gmail + type: local + command: [npx, -y, "@anthropic-ai/gmail-mcp"] + env: {} +EOF + adapter_translate_mcp "$src/mcp" "$dst" + local out="$dst/.mcp.json" + local result=0 + [[ -f "$out" ]] || { echo ".mcp.json missing"; result=1; } + jq -e '.mcpServers.gmail.command == "npx"' "$out" >/dev/null || { echo "command field wrong"; cat "$out"; result=1; } + jq -e '.mcpServers.gmail.args == ["-y", "@anthropic-ai/gmail-mcp"]' "$out" >/dev/null || { echo "args field wrong"; cat "$out"; result=1; } + rm -rf "$src" "$dst" + return $result +} + +test_translate_hooks_creates_files() { + local src; src="$(mktemp -d)" + local dst; dst="$(mktemp -d)" + mkdir -p "$src/hooks" + cat > "$src/hooks/protect.hook.yaml" <<'EOF' +name: protect +script: protect.sh +triggers: + - event: before-tool-use + match-tool: [edit, write] +EOF + cat > "$src/hooks/protect.sh" <<'EOF' +#!/usr/bin/env bash +exit 0 +EOF + adapter_translate_hooks "$src/hooks" "$dst" + local result=0 + [[ -f "$dst/.claude/hooks/protect.sh" ]] || { echo "protect.sh missing"; result=1; } + [[ -f "$dst/.claude/hooks/protect-wrapper.sh" ]] || { echo "wrapper missing"; result=1; } + [[ -f "$dst/.claude/settings.json" ]] || { echo "settings.json missing"; result=1; } + grep -q "PreToolUse" "$dst/.claude/settings.json" || { echo "PreToolUse not in settings"; result=1; } + grep -q "Edit|Write" "$dst/.claude/settings.json" || { echo "matcher missing"; result=1; } + rm -rf "$src" "$dst" + return $result +} + +test_translate_agents_basic() { + local src; src="$(mktemp -d)" + local dst; dst="$(mktemp -d)" + mkdir -p "$src/agents" + cat > "$src/agents/scribe.md" <<'EOF' +--- +name: scribe +description: Test scribe +model: sonnet +mode: subagent +capabilities: [read, write, edit] +--- + +You are the Scribe. +EOF + adapter_translate_agents "$src/agents" "$dst" + local out="$dst/.claude/agents/scribe.md" + local result=0 + [[ -f "$out" ]] || { echo "agent file missing"; result=1; } + grep -q "^name: scribe" "$out" || { echo "name missing"; result=1; } + grep -q "^tools: Read, Glob, Grep, Write, Edit" "$out" || { echo "tools incorrect: $(grep '^tools:' "$out")"; result=1; } + grep -q "^You are the Scribe" "$out" || { echo "body missing"; result=1; } + grep -q "capabilities:" "$out" && { echo "capabilities should be removed"; result=1; } + rm -rf "$src" "$dst" + return $result +} + +test_translate_agents_bash_capability() { + local src; src="$(mktemp -d)" + local dst; dst="$(mktemp -d)" + mkdir -p "$src/agents" + cat > "$src/agents/architect.md" <<'EOF' +--- +name: architect +description: Test +model: opus +capabilities: [read, write, edit, bash] +--- + +body +EOF + adapter_translate_agents "$src/agents" "$dst" + local out="$dst/.claude/agents/architect.md" + grep -q "^tools: Read, Glob, Grep, Write, Edit, Bash" "$out" || { echo "tools incorrect: $(grep '^tools:' "$out")"; rm -rf "$src" "$dst"; return 1; } + rm -rf "$src" "$dst" + return 0 +} + +test_translate_skills_copies_skill_md() { + local src; src="$(mktemp -d)" + local dst; dst="$(mktemp -d)" + mkdir -p "$src/skills/foo" "$src/skills/bar" + cat > "$src/skills/foo/SKILL.md" <<'EOF' +--- +name: foo +description: Foo skill +--- +body +EOF + cat > "$src/skills/bar/SKILL.md" <<'EOF' +--- +name: bar +description: Bar skill +--- +body +EOF + adapter_translate_skills "$src/skills" "$dst" + local result=0 + [[ -f "$dst/.claude/skills/foo/SKILL.md" ]] || { echo "foo missing"; result=1; } + [[ -f "$dst/.claude/skills/bar/SKILL.md" ]] || { echo "bar missing"; result=1; } + rm -rf "$src" "$dst" + return $result +} + +test_translate_skills_excludes() { + local src; src="$(mktemp -d)" + local dst; dst="$(mktemp -d)" + mkdir -p "$src/skills/foo" + cat > "$src/skills/foo/SKILL.md" <<'EOF' +--- +name: foo +description: Foo +exclude: [claude-code] +--- +EOF + adapter_translate_skills "$src/skills" "$dst" + local result=0 + [[ ! -f "$dst/.claude/skills/foo/SKILL.md" ]] || { echo "foo should be excluded"; result=1; } + rm -rf "$src" "$dst" + return $result +} + +test_translate_references_copies_md_files() { + local src; src="$(mktemp -d)" + local dst; dst="$(mktemp -d)" + mkdir -p "$src/references" + echo "ref1" > "$src/references/one.md" + echo "ref2" > "$src/references/two.md" + adapter_translate_references "$src/references" "$dst" + local result=0 + [[ -f "$dst/.claude/references/one.md" ]] || { echo "one.md missing"; result=1; } + [[ -f "$dst/.claude/references/two.md" ]] || { echo "two.md missing"; result=1; } + rm -rf "$src" "$dst" + return $result +} + +test_translate_dispatcher_renames_to_claude_md() { + local src; src="$(mktemp -d)" + local dst; dst="$(mktemp -d)" + cat > "$src/DISPATCHER.md" <<'EOF' +# Dispatcher +Some content +EOF + adapter_translate_dispatcher "$src/DISPATCHER.md" "$dst" + local result=0 + [[ -f "$dst/CLAUDE.md" ]] || { echo "CLAUDE.md not created"; result=1; } + [[ "$(cat "$dst/CLAUDE.md")" == "$(cat "$src/DISPATCHER.md")" ]] || { echo "content mismatch"; result=1; } + rm -rf "$src" "$dst" + return $result +}