codexkit 1.0.0

package/install/template.sh

@@ -0,0 +1,620 @@
+#!/usr/bin/env bash
+# ──────────────────────────────────────────────────────────────
+# codexkit template manager
+# Manages custom project templates with variable substitution
+# ──────────────────────────────────────────────────────────────
+set -euo pipefail
+
+CODEXKIT_HOME="${CODEXKIT_HOME:-$HOME/.codexkit}"
+TEMPLATES_DIR="$CODEXKIT_HOME/templates"
+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 "$TEMPLATES_DIR"
+  if [ ! -f "$REGISTRY_FILE" ]; then
+    echo '{"plugins":{},"templates":{}}' > "$REGISTRY_FILE"
+  fi
+}
+
+# ── Registry helpers ──────────────────────────────────────────
+
+registry_add_template() {
+  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" \
+      '.templates[$n] = {"version": $v, "source": $s, "installed": $d}' \
+      "$REGISTRY_FILE" > "$tmp" && mv "$tmp" "$REGISTRY_FILE"
+  else
+    python3 -c "
+import json
+with open('$REGISTRY_FILE') as f:
+    reg = json.load(f)
+reg.setdefault('templates', {})
+reg['templates']['$name'] = {'version': '$version', 'source': '$source', 'installed': '$date_now'}
+with open('$REGISTRY_FILE', 'w') as f:
+    json.dump(reg, f, indent=2)
+"
+  fi
+}
+
+registry_remove_template() {
+  local name="$1"
+  if command -v jq &>/dev/null; then
+    local tmp
+    tmp=$(mktemp)
+    jq --arg n "$name" 'del(.templates[$n])' "$REGISTRY_FILE" > "$tmp" && mv "$tmp" "$REGISTRY_FILE"
+  else
+    python3 -c "
+import json
+with open('$REGISTRY_FILE') as f:
+    reg = json.load(f)
+reg.get('templates', {}).pop('$name', None)
+with open('$REGISTRY_FILE', 'w') as f:
+    json.dump(reg, f, indent=2)
+"
+  fi
+}
+
+# ── Field extraction ──────────────────────────────────────────
+
+get_field() {
+  local file="$1" field="$2"
+  if command -v jq &>/dev/null; then
+    jq -r ".$field // empty" "$file"
+  else
+    grep "\"$field\"" "$file" | head -1 | sed 's/.*"'"$field"'"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/'
+  fi
+}
+
+# Get variable names from template.json
+get_variables() {
+  local manifest="$1"
+  if command -v jq &>/dev/null; then
+    jq -r '.variables // {} | keys[]' "$manifest" 2>/dev/null
+  else
+    python3 -c "
+import json
+with open('$manifest') as f:
+    t = json.load(f)
+for k in t.get('variables', {}):
+    print(k)
+" 2>/dev/null
+  fi
+}
+
+# Get variable properties
+get_variable_prop() {
+  local manifest="$1" var_name="$2" prop="$3"
+  if command -v jq &>/dev/null; then
+    jq -r ".variables[\"$var_name\"].$prop // empty" "$manifest" 2>/dev/null
+  else
+    python3 -c "
+import json
+with open('$manifest') as f:
+    t = json.load(f)
+v = t.get('variables', {}).get('$var_name', {})
+val = v.get('$prop', '')
+if val:
+    print(val)
+" 2>/dev/null
+  fi
+}
+
+# ── Validate template.json ────────────────────────────────────
+
+validate_template_manifest() {
+  local manifest="$1"
+  if [ ! -f "$manifest" ]; then
+    err "No template.json found at $manifest"
+    return 1
+  fi
+
+  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 "template.json missing required field: name"
+    return 1
+  fi
+  if [ "$has_version" -eq 0 ]; then
+    err "template.json missing required field: version"
+    return 1
+  fi
+
+  return 0
+}
+
+# ── Source 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() {
+  local source="$1"
+  echo "$source" | sed 's|^git+||'
+}
+
+# ── Variable substitution engine ──────────────────────────────
+
+substitute_variables() {
+  local file="$1"
+  shift
+  # Remaining args are KEY=VALUE pairs
+  for pair in "$@"; do
+    local key="${pair%%=*}"
+    local value="${pair#*=}"
+    # Replace {{KEY}} and {{ KEY }} patterns
+    sed -i.bak "s|{{[[:space:]]*${key}[[:space:]]*}}|${value}|g" "$file"
+    rm -f "${file}.bak"
+  done
+}
+
+# ── Prompt for variables ──────────────────────────────────────
+
+collect_variables() {
+  local manifest="$1"
+  # Outputs KEY=VALUE pairs to stdout, one per line
+
+  local variables
+  variables=$(get_variables "$manifest")
+
+  if [ -z "$variables" ]; then
+    return 0
+  fi
+
+  echo "" >&2
+  echo -e "${BOLD}Template variables:${NC}" >&2
+  echo "" >&2
+
+  while IFS= read -r var_name; do
+    [ -z "$var_name" ] && continue
+    local prompt default
+    prompt=$(get_variable_prop "$manifest" "$var_name" "prompt")
+    default=$(get_variable_prop "$manifest" "$var_name" "default")
+
+    # Build prompt string
+    local prompt_str="${prompt:-$var_name}"
+    [ -n "$default" ] && prompt_str="$prompt_str [${default}]"
+
+    # Read user input (prompts go to stderr so stdout is clean for capture)
+    echo -n -e "  ${CYAN}?${NC} ${prompt_str}: " >&2
+    local input=""
+    if [ -t 0 ]; then
+      read -r input
+    fi
+
+    # Use default if empty
+    if [ -z "$input" ] && [ -n "$default" ]; then
+      input="$default"
+    fi
+
+    echo "${var_name}=${input}"
+  done <<< "$variables"
+}
+
+# ── Commands ──────────────────────────────────────────────────
+
+cmd_add() {
+  local source="${1:-}"
+  if [ -z "$source" ]; then
+    err "Usage: codexkit template add <source>"
+    echo ""
+    echo "Sources:"
+    echo "  git+https://github.com/user/repo.git    Git repository"
+    echo "  /path/to/local/template                  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 "Adding template from $source..."
+
+  case "$source_type" in
+    git)
+      local git_url
+      git_url=$(resolve_git_url "$source")
+      if ! git clone --depth 1 "$git_url" "$tmp_dir/template" 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/template"
+      cp -R "$local_path"/. "$tmp_dir/template/"
+      ;;
+    npm)
+      local pkg_name="${source#npm:}"
+      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/template"
+      tar xzf "$tmp_dir"/*.tgz -C "$tmp_dir/template" --strip-components=1 2>/dev/null
+      ;;
+    *)
+      err "Unknown source type: $source"
+      rm -rf "$tmp_dir"
+      return 1
+      ;;
+  esac
+
+  if ! validate_template_manifest "$tmp_dir/template/template.json"; then
+    rm -rf "$tmp_dir"
+    return 1
+  fi
+
+  local tpl_name tpl_version
+  tpl_name=$(get_field "$tmp_dir/template/template.json" "name")
+  tpl_version=$(get_field "$tmp_dir/template/template.json" "version")
+
+  if [ -z "$tpl_name" ]; then
+    err "Could not read template name"
+    rm -rf "$tmp_dir"
+    return 1
+  fi
+
+  # Check files/ directory exists
+  if [ ! -d "$tmp_dir/template/files" ]; then
+    warn "Template has no files/ directory - template may be empty"
+  fi
+
+  if [ -d "$TEMPLATES_DIR/$tpl_name" ]; then
+    warn "Template '$tpl_name' already exists. Replacing..."
+    rm -rf "${TEMPLATES_DIR:?}/$tpl_name"
+  fi
+
+  mv "$tmp_dir/template" "$TEMPLATES_DIR/$tpl_name"
+  rm -rf "$tmp_dir"
+
+  registry_add_template "$tpl_name" "${tpl_version:-0.0.0}" "$source"
+
+  ok "Template ${BOLD}$tpl_name${NC} v${tpl_version:-0.0.0} added"
+  echo ""
+  info "Use with: ${CYAN}codexkit template use $tpl_name${NC}"
+}
+
+cmd_remove() {
+  local name="${1:-}"
+  if [ -z "$name" ]; then
+    err "Usage: codexkit template remove <name>"
+    return 1
+  fi
+
+  ensure_dirs
+
+  if [ ! -d "$TEMPLATES_DIR/$name" ]; then
+    err "Template '$name' not found"
+    return 1
+  fi
+
+  rm -rf "${TEMPLATES_DIR:?}/$name"
+  registry_remove_template "$name"
+
+  ok "Template ${BOLD}$name${NC} removed"
+}
+
+cmd_list() {
+  ensure_dirs
+
+  local count=0
+  echo -e "${BOLD}Available templates:${NC}"
+  echo ""
+
+  # Show built-in
+  echo -e "  ${CYAN}default${NC} (built-in)"
+  echo "    Standard codexkit project template"
+  echo ""
+
+  if [ -d "$TEMPLATES_DIR" ]; then
+    for tpl_dir in "$TEMPLATES_DIR"/*/; do
+      [ -d "$tpl_dir" ] || continue
+      local manifest="$tpl_dir/template.json"
+      if [ -f "$manifest" ]; then
+        local name version description extends
+        name=$(get_field "$manifest" "name")
+        version=$(get_field "$manifest" "version")
+        description=$(get_field "$manifest" "description")
+        extends=$(get_field "$manifest" "extends")
+
+        echo -e "  ${CYAN}$name${NC} v$version"
+        [ -n "$description" ] && echo "    $description"
+        [ -n "$extends" ] && echo "    Extends: $extends"
+
+        # Count variables
+        local var_count
+        var_count=$(get_variables "$manifest" | wc -l | tr -d ' ')
+        [ "$var_count" -gt 0 ] && echo "    Variables: $var_count"
+
+        # Count files
+        if [ -d "$tpl_dir/files" ]; then
+          local file_count
+          file_count=$(find "$tpl_dir/files" -type f 2>/dev/null | wc -l | tr -d ' ')
+          echo "    Files: $file_count"
+        fi
+
+        echo ""
+        count=$((count + 1))
+      fi
+    done
+  fi
+
+  if [ "$count" -eq 0 ]; then
+    echo -e "  ${YELLOW}(no custom templates)${NC}"
+    echo ""
+    echo "  Add templates with: codexkit template add <source>"
+    echo "  Create from project: codexkit template create <name>"
+  fi
+}
+
+cmd_use() {
+  local name="${1:-}"
+  local target="${2:-.}"
+
+  if [ -z "$name" ]; then
+    err "Usage: codexkit template use <name> [target-dir]"
+    return 1
+  fi
+
+  ensure_dirs
+
+  # Handle built-in default template
+  if [ "$name" = "default" ]; then
+    info "Using built-in default template"
+    info "Run 'codexkit install' instead for the default template"
+    return 0
+  fi
+
+  local tpl_dir="$TEMPLATES_DIR/$name"
+  if [ ! -d "$tpl_dir" ]; then
+    err "Template '$name' not found"
+    err "Available templates:"
+    cmd_list
+    return 1
+  fi
+
+  local manifest="$tpl_dir/template.json"
+
+  info "Using template: ${BOLD}$name${NC}"
+
+  # Check extends field — run default install first
+  local extends
+  extends=$(get_field "$manifest" "extends")
+  if [ "$extends" = "default" ]; then
+    info "Template extends 'default' — running base install first..."
+    local script_dir
+    script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    if [ -f "$script_dir/install-project.sh" ]; then
+      bash "$script_dir/install-project.sh" "$target"
+    else
+      warn "Cannot find install-project.sh for base install"
+    fi
+  fi
+
+  # Collect variables from user (stdout-based: one KEY=VALUE per line)
+  local var_pairs_raw
+  var_pairs_raw=$(collect_variables "$manifest")
+  local var_pairs=()
+  if [ -n "$var_pairs_raw" ]; then
+    while IFS= read -r line; do
+      [ -n "$line" ] && var_pairs+=("$line")
+    done <<< "$var_pairs_raw"
+  fi
+
+  # Run pre-install hook
+  if [ -f "$tpl_dir/hooks/pre-install.sh" ]; then
+    info "Running pre-install hook..."
+    # Export variables for hook
+    for pair in "${var_pairs[@]:-}"; do
+      [ -z "$pair" ] && continue
+      export "${pair?}"
+    done
+    bash "$tpl_dir/hooks/pre-install.sh" "$target"
+  fi
+
+  # Copy template files
+  if [ -d "$tpl_dir/files" ]; then
+    info "Copying template files..."
+
+    find "$tpl_dir/files" -type f | while IFS= read -r src_file; do
+      local rel_path="${src_file#$tpl_dir/files/}"
+      local dest_file="$target/$rel_path"
+      local dest_dir
+      dest_dir=$(dirname "$dest_file")
+
+      mkdir -p "$dest_dir"
+      cp "$src_file" "$dest_file"
+
+      # Apply variable substitution
+      if [ ${#var_pairs[@]} -gt 0 ]; then
+        substitute_variables "$dest_file" "${var_pairs[@]}"
+      fi
+
+      ok "  $rel_path"
+    done
+  fi
+
+  # Run post-install hook
+  if [ -f "$tpl_dir/hooks/post-install.sh" ]; then
+    info "Running post-install hook..."
+    for pair in "${var_pairs[@]:-}"; do
+      [ -z "$pair" ] && continue
+      export "${pair?}"
+    done
+    bash "$tpl_dir/hooks/post-install.sh" "$target"
+  fi
+
+  echo ""
+  ok "Template ${BOLD}$name${NC} applied to $target"
+}
+
+cmd_create() {
+  local name="${1:-}"
+  local source="${2:-.}"
+
+  if [ -z "$name" ]; then
+    err "Usage: codexkit template create <name> [source-dir]"
+    echo ""
+    echo "Creates a template from an existing project's .codex/ directory"
+    return 1
+  fi
+
+  ensure_dirs
+
+  if [ ! -d "$source/.codex" ]; then
+    err "No .codex/ directory found in $source"
+    return 1
+  fi
+
+  local tpl_dir="$TEMPLATES_DIR/$name"
+
+  if [ -d "$tpl_dir" ]; then
+    warn "Template '$name' already exists. Replacing..."
+    rm -rf "$tpl_dir"
+  fi
+
+  mkdir -p "$tpl_dir/files"
+
+  # Copy .codex/ structure
+  cp -R "$source/.codex" "$tpl_dir/files/.codex"
+
+  # Copy AGENTS.md if present
+  [ -f "$source/AGENTS.md" ] && cp "$source/AGENTS.md" "$tpl_dir/files/AGENTS.md"
+
+  # Create template.json
+  cat > "$tpl_dir/template.json" <<MANIFEST
+{
+  "name": "$name",
+  "version": "1.0.0",
+  "description": "Custom template created from project",
+  "author": "$(git config user.name 2>/dev/null || echo 'unknown')",
+  "variables": {
+    "PROJECT_NAME": {
+      "prompt": "Project name?",
+      "default": "$name"
+    }
+  },
+  "extends": null,
+  "hooks": {}
+}
+MANIFEST
+
+  # Create hooks directory with examples
+  mkdir -p "$tpl_dir/hooks"
+
+  registry_add_template "$name" "1.0.0" "local:$source"
+
+  ok "Template ${BOLD}$name${NC} created from $source"
+  echo ""
+  echo "Template location: $tpl_dir"
+  echo ""
+  echo "Next steps:"
+  echo "  1. Edit $tpl_dir/template.json to customize variables"
+  echo "  2. Edit files in $tpl_dir/files/ to add {{VARIABLE}} placeholders"
+  echo "  3. Add hooks in $tpl_dir/hooks/ (pre-install.sh, post-install.sh)"
+  echo "  4. Use with: codexkit template use $name"
+}
+
+# ── Usage ─────────────────────────────────────────────────────
+
+usage() {
+  echo -e "${BOLD}codexkit template${NC} — Manage project templates"
+  echo ""
+  echo "Usage:"
+  echo "  codexkit template list                         List available templates"
+  echo "  codexkit template add <source>                 Add template from git/local/npm"
+  echo "  codexkit template remove <name>                Remove template"
+  echo "  codexkit template use <name> [target-dir]      Scaffold project with template"
+  echo "  codexkit template create <name> [source-dir]   Create template from project"
+  echo ""
+  echo "Sources:"
+  echo "  git+https://github.com/user/repo.git    Git repository"
+  echo "  /path/to/local/template                  Local directory"
+  echo "  npm:package-name                         npm package"
+  echo ""
+  echo "Template structure:"
+  echo "  template.json    Required manifest (name, version, variables)"
+  echo "  files/           Template files (copied to target project)"
+  echo "  hooks/           Optional pre/post install scripts"
+  echo ""
+  echo "Variables:"
+  echo "  Templates can use {{VARIABLE}} placeholders in files."
+  echo "  Variables are defined in template.json and prompted during 'use'."
+  echo ""
+  echo "Examples:"
+  echo "  codexkit template add git+https://github.com/user/codexkit-template-react.git"
+  echo "  codexkit template create my-template"
+  echo "  codexkit template use my-template ./new-project"
+}
+
+# ── Main ──────────────────────────────────────────────────────
+
+main() {
+  local subcmd="${1:-help}"
+  shift || true
+
+  case "$subcmd" in
+    add)      cmd_add "$@" ;;
+    remove)   cmd_remove "$@" ;;
+    list)     cmd_list ;;
+    use)      cmd_use "$@" ;;
+    create)   cmd_create "$@" ;;
+    help|-h|--help) usage ;;
+    *)
+      err "Unknown template command: $subcmd"
+      usage
+      return 1
+      ;;
+  esac
+}
+
+main "$@"