codexkit 1.0.0

package/install/plugin.sh

@@ -0,0 +1,565 @@
+#!/usr/bin/env bash
+# ──────────────────────────────────────────────────────────────
+# codexkit plugin manager
+# Manages plugins (bundles of skills/agents/prompts/hooks)
+# ──────────────────────────────────────────────────────────────
+set -euo pipefail
+
+CODEXKIT_HOME="${CODEXKIT_HOME:-$HOME/.codexkit}"
+PLUGINS_DIR="$CODEXKIT_HOME/plugins"
+REGISTRY_FILE="$CODEXKIT_HOME/registry.json"
+
+# ── Colors ────────────────────────────────────────────────────
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+# ── Helpers ───────────────────────────────────────────────────
+
+info()  { echo -e "${BLUE}ℹ${NC} $1"; }
+ok()    { echo -e "${GREEN}✓${NC} $1"; }
+warn()  { echo -e "${YELLOW}⚠${NC} $1"; }
+err()   { echo -e "${RED}✗${NC} $1" >&2; }
+
+ensure_dirs() {
+  mkdir -p "$PLUGINS_DIR"
+  if [ ! -f "$REGISTRY_FILE" ]; then
+    echo '{"plugins":{},"templates":{}}' > "$REGISTRY_FILE"
+  fi
+}
+
+# ── Registry helpers (pure bash + sed, no jq dependency) ──────
+
+# Read a plugin field from registry
+registry_get_plugin() {
+  local name="$1"
+  if [ -f "$REGISTRY_FILE" ] && grep -q "\"$name\"" "$REGISTRY_FILE" 2>/dev/null; then
+    return 0
+  fi
+  return 1
+}
+
+# Add plugin to registry
+registry_add_plugin() {
+  local name="$1" version="$2" source="$3"
+  local date_now
+  date_now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  if command -v jq &>/dev/null; then
+    local tmp
+    tmp=$(mktemp)
+    jq --arg n "$name" --arg v "$version" --arg s "$source" --arg d "$date_now" \
+      '.plugins[$n] = {"version": $v, "source": $s, "installed": $d}' \
+      "$REGISTRY_FILE" > "$tmp" && mv "$tmp" "$REGISTRY_FILE"
+  else
+    # Fallback: rewrite registry without jq
+    _registry_add_entry "plugins" "$name" "$version" "$source" "$date_now"
+  fi
+}
+
+# Remove plugin from registry
+registry_remove_plugin() {
+  local name="$1"
+  if command -v jq &>/dev/null; then
+    local tmp
+    tmp=$(mktemp)
+    jq --arg n "$name" 'del(.plugins[$n])' "$REGISTRY_FILE" > "$tmp" && mv "$tmp" "$REGISTRY_FILE"
+  else
+    _registry_remove_entry "plugins" "$name"
+  fi
+}
+
+# Minimal JSON manipulation without jq
+_registry_add_entry() {
+  local section="$1" name="$2" version="$3" source="$4" date="$5"
+  local tmp
+  tmp=$(mktemp)
+  # Read current registry, build new one
+  python3 -c "
+import json, sys
+with open('$REGISTRY_FILE') as f:
+    reg = json.load(f)
+reg.setdefault('$section', {})
+reg['$section']['$name'] = {'version': '$version', 'source': '$source', 'installed': '$date'}
+with open('$tmp', 'w') as f:
+    json.dump(reg, f, indent=2)
+" 2>/dev/null && mv "$tmp" "$REGISTRY_FILE"
+}
+
+_registry_remove_entry() {
+  local section="$1" name="$2"
+  local tmp
+  tmp=$(mktemp)
+  python3 -c "
+import json
+with open('$REGISTRY_FILE') as f:
+    reg = json.load(f)
+reg.get('$section', {}).pop('$name', None)
+with open('$tmp', 'w') as f:
+    json.dump(reg, f, indent=2)
+" 2>/dev/null && mv "$tmp" "$REGISTRY_FILE"
+}
+
+# ── Validate plugin.json ─────────────────────────────────────
+
+validate_plugin_manifest() {
+  local manifest="$1"
+  if [ ! -f "$manifest" ]; then
+    err "No plugin.json found at $manifest"
+    return 1
+  fi
+
+  # Check required fields
+  local has_name has_version
+  has_name=$(grep -c '"name"' "$manifest" 2>/dev/null || echo 0)
+  has_version=$(grep -c '"version"' "$manifest" 2>/dev/null || echo 0)
+
+  if [ "$has_name" -eq 0 ]; then
+    err "plugin.json missing required field: name"
+    return 1
+  fi
+  if [ "$has_version" -eq 0 ]; then
+    err "plugin.json missing required field: version"
+    return 1
+  fi
+
+  return 0
+}
+
+# ── Extract fields from plugin.json (no jq fallback) ─────────
+
+get_plugin_field() {
+  local manifest="$1" field="$2"
+  if command -v jq &>/dev/null; then
+    jq -r ".$field // empty" "$manifest"
+  else
+    # Simple grep-based extraction for flat fields
+    grep "\"$field\"" "$manifest" | head -1 | sed 's/.*"'"$field"'"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/'
+  fi
+}
+
+# ── Source type detection ─────────────────────────────────────
+
+detect_source_type() {
+  local source="$1"
+  if [[ "$source" == git+* ]] || [[ "$source" == *.git ]] || [[ "$source" == https://github.com/* ]] || [[ "$source" == git@* ]]; then
+    echo "git"
+  elif [[ "$source" == npm:* ]]; then
+    echo "npm"
+  elif [[ "$source" == local:* ]]; then
+    echo "local"
+  elif [ -d "$source" ]; then
+    echo "local"
+  else
+    echo "unknown"
+  fi
+}
+
+# ── Resolve git URL ───────────────────────────────────────────
+
+resolve_git_url() {
+  local source="$1"
+  # Strip git+ prefix
+  echo "$source" | sed 's|^git+||'
+}
+
+# ── Commands ──────────────────────────────────────────────────
+
+cmd_add() {
+  local source="${1:-}"
+  if [ -z "$source" ]; then
+    err "Usage: codexkit plugin add <source>"
+    echo ""
+    echo "Sources:"
+    echo "  git+https://github.com/user/repo.git    Git repository"
+    echo "  https://github.com/user/repo             GitHub shorthand"
+    echo "  /path/to/local/plugin                    Local directory"
+    echo "  npm:package-name                         npm package"
+    return 1
+  fi
+
+  ensure_dirs
+
+  local source_type
+  source_type=$(detect_source_type "$source")
+  local tmp_dir
+  tmp_dir=$(mktemp -d)
+
+  info "Installing plugin from $source..."
+
+  case "$source_type" in
+    git)
+      local git_url
+      git_url=$(resolve_git_url "$source")
+      info "Cloning $git_url..."
+      if ! git clone --depth 1 "$git_url" "$tmp_dir/plugin" 2>/dev/null; then
+        err "Failed to clone $git_url"
+        rm -rf "$tmp_dir"
+        return 1
+      fi
+      ;;
+    local)
+      local local_path="$source"
+      # Strip local: prefix if present
+      [[ "$local_path" == local:* ]] && local_path="${local_path#local:}"
+      if [ ! -d "$local_path" ]; then
+        err "Directory not found: $local_path"
+        rm -rf "$tmp_dir"
+        return 1
+      fi
+      mkdir -p "$tmp_dir/plugin"
+      cp -R "$local_path"/. "$tmp_dir/plugin/"
+      ;;
+    npm)
+      local pkg_name="${source#npm:}"
+      info "Fetching npm package $pkg_name..."
+      if ! npm pack "$pkg_name" --pack-destination "$tmp_dir" 2>/dev/null; then
+        err "Failed to fetch npm package: $pkg_name"
+        rm -rf "$tmp_dir"
+        return 1
+      fi
+      mkdir -p "$tmp_dir/plugin"
+      tar xzf "$tmp_dir"/*.tgz -C "$tmp_dir/plugin" --strip-components=1 2>/dev/null
+      ;;
+    *)
+      err "Unknown source type: $source"
+      err "Use git+<url>, /local/path, or npm:<package>"
+      rm -rf "$tmp_dir"
+      return 1
+      ;;
+  esac
+
+  # Validate plugin manifest
+  if ! validate_plugin_manifest "$tmp_dir/plugin/plugin.json"; then
+    rm -rf "$tmp_dir"
+    return 1
+  fi
+
+  local plugin_name plugin_version
+  plugin_name=$(get_plugin_field "$tmp_dir/plugin/plugin.json" "name")
+  plugin_version=$(get_plugin_field "$tmp_dir/plugin/plugin.json" "version")
+
+  if [ -z "$plugin_name" ]; then
+    err "Could not read plugin name from plugin.json"
+    rm -rf "$tmp_dir"
+    return 1
+  fi
+
+  # Check if already installed
+  if [ -d "$PLUGINS_DIR/$plugin_name" ]; then
+    warn "Plugin '$plugin_name' already installed. Replacing..."
+    rm -rf "${PLUGINS_DIR:?}/$plugin_name"
+  fi
+
+  # Install
+  mv "$tmp_dir/plugin" "$PLUGINS_DIR/$plugin_name"
+  rm -rf "$tmp_dir"
+
+  # Update registry
+  registry_add_plugin "$plugin_name" "${plugin_version:-0.0.0}" "$source"
+
+  ok "Plugin ${BOLD}$plugin_name${NC} v${plugin_version:-0.0.0} installed"
+  echo ""
+  info "Run ${CYAN}codexkit plugin sync${NC} to install into your project"
+}
+
+cmd_remove() {
+  local name="${1:-}"
+  if [ -z "$name" ]; then
+    err "Usage: codexkit plugin remove <name>"
+    return 1
+  fi
+
+  ensure_dirs
+
+  if [ ! -d "$PLUGINS_DIR/$name" ]; then
+    err "Plugin '$name' not found"
+    return 1
+  fi
+
+  rm -rf "${PLUGINS_DIR:?}/$name"
+  registry_remove_plugin "$name"
+
+  ok "Plugin ${BOLD}$name${NC} removed"
+}
+
+cmd_list() {
+  ensure_dirs
+
+  local count=0
+  echo -e "${BOLD}Installed plugins:${NC}"
+  echo ""
+
+  if [ -d "$PLUGINS_DIR" ]; then
+    for plugin_dir in "$PLUGINS_DIR"/*/; do
+      [ -d "$plugin_dir" ] || continue
+      local manifest="$plugin_dir/plugin.json"
+      if [ -f "$manifest" ]; then
+        local name version description
+        name=$(get_plugin_field "$manifest" "name")
+        version=$(get_plugin_field "$manifest" "version")
+        description=$(get_plugin_field "$manifest" "description")
+        echo -e "  ${CYAN}$name${NC} v$version"
+        [ -n "$description" ] && echo "    $description"
+
+        # Show contents summary
+        local skills_count=0 agents_count=0 prompts_count=0
+        [ -d "$plugin_dir/skills" ] && skills_count=$(find "$plugin_dir/skills" -name "SKILL.md" 2>/dev/null | wc -l | tr -d ' ')
+        [ -d "$plugin_dir/agents" ] && agents_count=$(find "$plugin_dir/agents" -name "*.toml" 2>/dev/null | wc -l | tr -d ' ')
+        [ -d "$plugin_dir/prompts" ] && prompts_count=$(find "$plugin_dir/prompts" -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
+        echo "    Contents: ${skills_count} skills, ${agents_count} agents, ${prompts_count} prompts"
+        echo ""
+        count=$((count + 1))
+      fi
+    done
+  fi
+
+  if [ "$count" -eq 0 ]; then
+    echo -e "  ${YELLOW}(none)${NC}"
+    echo ""
+    echo "  Install with: codexkit plugin add <source>"
+  fi
+}
+
+cmd_sync() {
+  local target="${1:-.}"
+
+  ensure_dirs
+
+  if [ ! -d "$target/.codex" ]; then
+    err "No .codex/ directory found in $target"
+    err "Run 'codexkit install' first, then sync plugins"
+    return 1
+  fi
+
+  local synced=0
+
+  for plugin_dir in "$PLUGINS_DIR"/*/; do
+    [ -d "$plugin_dir" ] || continue
+    local manifest="$plugin_dir/plugin.json"
+    [ -f "$manifest" ] || continue
+
+    local plugin_name
+    plugin_name=$(get_plugin_field "$manifest" "name")
+    info "Syncing plugin: $plugin_name..."
+
+    # Sync skills
+    if [ -d "$plugin_dir/skills" ]; then
+      for skill_dir in "$plugin_dir/skills"/*/; do
+        [ -d "$skill_dir" ] || continue
+        local skill_name
+        skill_name=$(basename "$skill_dir")
+        local target_skill="$target/.codex/skills/$skill_name"
+
+        if [ -d "$target_skill" ]; then
+          warn "  Skill '$skill_name' exists, skipping (use --force to overwrite)"
+        else
+          cp -R "$skill_dir" "$target_skill"
+          ok "  Skill: $skill_name"
+        fi
+      done
+    fi
+
+    # Sync agents
+    if [ -d "$plugin_dir/agents" ]; then
+      for agent_file in "$plugin_dir/agents"/*.toml; do
+        [ -f "$agent_file" ] || continue
+        local agent_name
+        agent_name=$(basename "$agent_file")
+        local target_agent="$target/.codex/agents/$agent_name"
+
+        if [ -f "$target_agent" ]; then
+          warn "  Agent '$agent_name' exists, skipping"
+        else
+          cp "$agent_file" "$target_agent"
+          ok "  Agent: $agent_name"
+        fi
+      done
+    fi
+
+    # Sync prompts
+    if [ -d "$plugin_dir/prompts" ]; then
+      for prompt_file in "$plugin_dir/prompts"/*.md; do
+        [ -f "$prompt_file" ] || continue
+        local prompt_name
+        prompt_name=$(basename "$prompt_file")
+        local target_prompt="$target/.codex/prompts/$prompt_name"
+
+        if [ -f "$target_prompt" ]; then
+          warn "  Prompt '$prompt_name' exists, skipping"
+        else
+          cp "$prompt_file" "$target_prompt"
+          ok "  Prompt: $prompt_name"
+        fi
+      done
+    fi
+
+    # Sync hooks
+    if [ -d "$plugin_dir/hooks" ]; then
+      for hook_file in "$plugin_dir/hooks"/*.sh; do
+        [ -f "$hook_file" ] || continue
+        local hook_name
+        hook_name=$(basename "$hook_file")
+        local target_hook="$target/.codex/hooks/$hook_name"
+
+        if [ -f "$target_hook" ]; then
+          warn "  Hook '$hook_name' exists, skipping"
+        else
+          cp "$hook_file" "$target_hook"
+          chmod +x "$target_hook"
+          ok "  Hook: $hook_name"
+        fi
+      done
+    fi
+
+    # Sync scripts
+    if [ -d "$plugin_dir/scripts" ]; then
+      for script_file in "$plugin_dir/scripts"/*.sh; do
+        [ -f "$script_file" ] || continue
+        local script_name
+        script_name=$(basename "$script_file")
+        local target_script="$target/.codex/scripts/$script_name"
+
+        if [ -f "$target_script" ]; then
+          warn "  Script '$script_name' exists, skipping"
+        else
+          cp "$script_file" "$target_script"
+          chmod +x "$target_script"
+          ok "  Script: $script_name"
+        fi
+      done
+    fi
+
+    synced=$((synced + 1))
+  done
+
+  if [ "$synced" -eq 0 ]; then
+    warn "No plugins to sync"
+    echo "  Install plugins first: codexkit plugin add <source>"
+  else
+    echo ""
+    ok "Synced $synced plugin(s) into $target/.codex/"
+  fi
+}
+
+cmd_update() {
+  local name="${1:-}"
+
+  ensure_dirs
+
+  if [ -n "$name" ]; then
+    # Update specific plugin
+    if [ ! -d "$PLUGINS_DIR/$name" ]; then
+      err "Plugin '$name' not found"
+      return 1
+    fi
+
+    local manifest="$PLUGINS_DIR/$name/plugin.json"
+    local source
+    source=$(get_plugin_field "$manifest" "source")
+
+    if [ -z "$source" ]; then
+      # Try registry
+      if command -v jq &>/dev/null && [ -f "$REGISTRY_FILE" ]; then
+        source=$(jq -r ".plugins[\"$name\"].source // empty" "$REGISTRY_FILE")
+      fi
+    fi
+
+    if [ -z "$source" ]; then
+      err "Cannot determine source for plugin '$name'"
+      return 1
+    fi
+
+    info "Updating $name from $source..."
+    cmd_add "$source"
+  else
+    # Update all plugins
+    info "Updating all plugins..."
+    local updated=0
+
+    for plugin_dir in "$PLUGINS_DIR"/*/; do
+      [ -d "$plugin_dir" ] || continue
+      local pname
+      pname=$(basename "$plugin_dir")
+      local manifest="$plugin_dir/plugin.json"
+
+      local source=""
+      if [ -f "$manifest" ]; then
+        source=$(get_plugin_field "$manifest" "source")
+      fi
+      if [ -z "$source" ] && command -v jq &>/dev/null && [ -f "$REGISTRY_FILE" ]; then
+        source=$(jq -r ".plugins[\"$pname\"].source // empty" "$REGISTRY_FILE")
+      fi
+
+      if [ -n "$source" ]; then
+        info "Updating $pname..."
+        cmd_add "$source" && updated=$((updated + 1))
+      else
+        warn "Skipping $pname (no source URL)"
+      fi
+    done
+
+    ok "Updated $updated plugin(s)"
+  fi
+}
+
+# ── Usage ─────────────────────────────────────────────────────
+
+usage() {
+  echo -e "${BOLD}codexkit plugin${NC} — Manage codexkit plugins"
+  echo ""
+  echo "Usage:"
+  echo "  codexkit plugin add <source>          Install plugin from git/local/npm"
+  echo "  codexkit plugin remove <name>         Remove installed plugin"
+  echo "  codexkit plugin list                  List installed plugins"
+  echo "  codexkit plugin sync [target-dir]     Sync plugins into project .codex/"
+  echo "  codexkit plugin update [name]         Update plugin(s) to latest"
+  echo ""
+  echo "Sources:"
+  echo "  git+https://github.com/user/repo.git  Git repository"
+  echo "  https://github.com/user/repo           GitHub shorthand"
+  echo "  /path/to/local/plugin                  Local directory"
+  echo "  npm:package-name                       npm package"
+  echo ""
+  echo "Plugin structure:"
+  echo "  plugin.json    Required manifest (name, version)"
+  echo "  skills/        Skill folders with SKILL.md"
+  echo "  agents/        Agent .toml files"
+  echo "  prompts/       Prompt .md files"
+  echo "  hooks/         Hook .sh scripts"
+  echo "  scripts/       Helper scripts"
+  echo ""
+  echo "Examples:"
+  echo "  codexkit plugin add git+https://github.com/user/codexkit-plugin-react.git"
+  echo "  codexkit plugin add /path/to/my/plugin"
+  echo "  codexkit plugin add npm:codexkit-plugin-docker"
+  echo "  codexkit plugin sync"
+  echo "  codexkit plugin list"
+}
+
+# ── Main ──────────────────────────────────────────────────────
+
+main() {
+  local subcmd="${1:-help}"
+  shift || true
+
+  case "$subcmd" in
+    add)      cmd_add "$@" ;;
+    remove)   cmd_remove "$@" ;;
+    list)     cmd_list ;;
+    sync)     cmd_sync "$@" ;;
+    update)   cmd_update "$@" ;;
+    help|-h|--help) usage ;;
+    *)
+      err "Unknown plugin command: $subcmd"
+      usage
+      return 1
+      ;;
+  esac
+}
+
+main "$@"

package/install/run-codex.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+set -euo pipefail
+
+find_project_root() {
+    if git_root=$(git rev-parse --show-toplevel 2>/dev/null); then
+        printf '%s\n' "$git_root"
+    else
+        pwd
+    fi
+}
+
+load_project_env() {
+    local env_file="$1"
+    local line_no=0
+    local raw_line trimmed line key value
+
+    [ -f "$env_file" ] || return 0
+
+    if ! bash -n "$env_file" >/dev/null 2>&1; then
+        echo "✗ Invalid shell syntax in $env_file" >&2
+        exit 1
+    fi
+
+    while IFS= read -r raw_line || [ -n "$raw_line" ]; do
+        line_no=$((line_no + 1))
+        trimmed="${raw_line#"${raw_line%%[![:space:]]*}"}"
+
+        if [ -z "$trimmed" ] || [[ "$trimmed" == \#* ]]; then
+            continue
+        fi
+
+        line="$trimmed"
+        if [[ "$line" =~ ^export[[:space:]]+ ]]; then
+            line="${line#export }"
+            line="${line#"${line%%[![:space:]]*}"}"
+        fi
+
+        if ! [[ "$line" =~ ^[A-Za-z_][A-Za-z0-9_]*= ]]; then
+            echo "✗ Invalid assignment in $env_file:$line_no" >&2
+            exit 1
+        fi
+
+        key="${line%%=*}"
+        if [ -n "${!key+x}" ]; then
+            continue
+        fi
+
+        if ! value=$(ENV_FILE="$env_file" ENV_KEY="$key" bash -lc 'source "$ENV_FILE"; printf "%s" "${!ENV_KEY-}"'); then
+            echo "✗ Failed to read $key from $env_file" >&2
+            exit 1
+        fi
+
+        export "$key=$value"
+    done < "$env_file"
+}
+
+main() {
+    local project_root env_file
+
+    project_root="$(find_project_root)"
+    env_file="$project_root/.codex/.env"
+
+    load_project_env "$env_file"
+
+    exec codex "$@"
+}
+
+main "$@"