📦 deps(thirdparty): update snapshots
This commit is contained in:
ci[bot]
+588
@@ -0,0 +1,588 @@
|
||||
#!/usr/bin/env bash
|
||||
|
||||
# init-plugin.sh - Interactive plugin initialization wizard
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
# Colors for output
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
CYAN='\033[0;36m'
|
||||
NC='\033[0m' # No Color
|
||||
|
||||
# Print colored output
|
||||
print_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
|
||||
print_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
|
||||
print_error() { echo -e "${RED}[ERROR]${NC} $1"; }
|
||||
print_step() { echo -e "${BLUE}[STEP]${NC} $1"; }
|
||||
print_prompt() { echo -e "${CYAN}[?]${NC} $1"; }
|
||||
|
||||
# Usage information
|
||||
usage() {
|
||||
cat << EOF
|
||||
Usage: $0 [options]
|
||||
|
||||
Interactive wizard to initialize a new Claude Code plugin.
|
||||
|
||||
Options:
|
||||
-d, --directory DIR Create plugin in specified directory (default: current)
|
||||
-n, --non-interactive Use defaults without prompting
|
||||
-h, --help Show this help message
|
||||
|
||||
Example:
|
||||
$0 # Interactive mode
|
||||
$0 -d ./plugins # Create in specific directory
|
||||
$0 -n # Non-interactive with defaults
|
||||
|
||||
EOF
|
||||
exit 1
|
||||
}
|
||||
|
||||
# Parse arguments
|
||||
PLUGIN_DIR="."
|
||||
INTERACTIVE=true
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case $1 in
|
||||
-d|--directory)
|
||||
PLUGIN_DIR="$2"
|
||||
shift 2
|
||||
;;
|
||||
-n|--non-interactive)
|
||||
INTERACTIVE=false
|
||||
shift
|
||||
;;
|
||||
-h|--help)
|
||||
usage
|
||||
;;
|
||||
-*)
|
||||
print_error "Unknown option: $1"
|
||||
usage
|
||||
;;
|
||||
*)
|
||||
print_error "Unexpected argument: $1"
|
||||
usage
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
# Prompt for input with default
|
||||
prompt_with_default() {
|
||||
local prompt="$1"
|
||||
local default="$2"
|
||||
local result
|
||||
|
||||
if [[ "$INTERACTIVE" == "false" ]]; then
|
||||
echo "$default"
|
||||
return
|
||||
fi
|
||||
|
||||
read -p "$(echo -e "${CYAN}[?]${NC} ${prompt} [${default}]: ")" result
|
||||
echo "${result:-$default}"
|
||||
}
|
||||
|
||||
# Prompt yes/no with default
|
||||
prompt_yes_no() {
|
||||
local prompt="$1"
|
||||
local default="$2"
|
||||
local result
|
||||
|
||||
if [[ "$INTERACTIVE" == "false" ]]; then
|
||||
echo "$default"
|
||||
return
|
||||
fi
|
||||
|
||||
while true; do
|
||||
read -p "$(echo -e "${CYAN}[?]${NC} ${prompt} (y/n) [${default}]: ")" result
|
||||
result="${result:-$default}"
|
||||
case "$result" in
|
||||
y|Y|yes|Yes|YES)
|
||||
echo "y"
|
||||
return
|
||||
;;
|
||||
n|N|no|No|NO)
|
||||
echo "n"
|
||||
return
|
||||
;;
|
||||
*)
|
||||
print_warn "Please answer y or n"
|
||||
;;
|
||||
esac
|
||||
done
|
||||
}
|
||||
|
||||
# Validate plugin name
|
||||
validate_plugin_name() {
|
||||
local name="$1"
|
||||
|
||||
if [[ -z "$name" ]]; then
|
||||
print_error "Plugin name cannot be empty"
|
||||
return 1
|
||||
fi
|
||||
|
||||
if [[ ! "$name" =~ ^[a-z][a-z0-9-]*$ ]]; then
|
||||
print_error "Plugin name must be kebab-case (lowercase letters, numbers, hyphens only)"
|
||||
print_error "Examples: my-plugin, dev-tools, claude-helper"
|
||||
return 1
|
||||
fi
|
||||
|
||||
return 0
|
||||
}
|
||||
|
||||
# Banner
|
||||
echo -e "${BLUE}╔════════════════════════════════════════════╗${NC}"
|
||||
echo -e "${BLUE}║ Claude Code Plugin Initialization ║${NC}"
|
||||
echo -e "${BLUE}╔════════════════════════════════════════════╗${NC}"
|
||||
echo
|
||||
|
||||
# Step 1: Plugin name
|
||||
print_step "Plugin Information"
|
||||
echo
|
||||
|
||||
while true; do
|
||||
PLUGIN_NAME=$(prompt_with_default "Plugin name (kebab-case)" "my-plugin")
|
||||
if validate_plugin_name "$PLUGIN_NAME"; then
|
||||
break
|
||||
fi
|
||||
done
|
||||
|
||||
PLUGIN_PATH="$PLUGIN_DIR/$PLUGIN_NAME"
|
||||
|
||||
# Check if directory exists
|
||||
if [[ -d "$PLUGIN_PATH" ]]; then
|
||||
print_error "Directory already exists: $PLUGIN_PATH"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Step 2: Plugin metadata
|
||||
DESCRIPTION=$(prompt_with_default "Plugin description" "A Claude Code plugin")
|
||||
VERSION=$(prompt_with_default "Initial version" "0.1.0")
|
||||
LICENSE=$(prompt_with_default "License" "MIT")
|
||||
|
||||
# Get author info from git config or prompt
|
||||
GIT_USER=$(git config user.name 2>/dev/null || echo "")
|
||||
GIT_EMAIL=$(git config user.email 2>/dev/null || echo "")
|
||||
|
||||
AUTHOR_NAME=$(prompt_with_default "Author name" "${GIT_USER:-Author Name}")
|
||||
AUTHOR_EMAIL=$(prompt_with_default "Author email" "${GIT_EMAIL:-author@example.com}")
|
||||
|
||||
# Step 3: Plugin components
|
||||
echo
|
||||
print_step "Plugin Components"
|
||||
echo
|
||||
print_info "Select which components to include:"
|
||||
echo
|
||||
|
||||
WITH_SKILLS=$(prompt_yes_no "Include skills?" "n")
|
||||
WITH_COMMANDS=$(prompt_yes_no "Include slash commands?" "n")
|
||||
WITH_AGENTS=$(prompt_yes_no "Include custom agents?" "n")
|
||||
WITH_HOOKS=$(prompt_yes_no "Include event hooks?" "n")
|
||||
WITH_MCP=$(prompt_yes_no "Include MCP server?" "n")
|
||||
|
||||
# Step 4: Repository setup
|
||||
echo
|
||||
print_step "Repository Configuration"
|
||||
echo
|
||||
|
||||
INIT_GIT=$(prompt_yes_no "Initialize git repository?" "y")
|
||||
CREATE_GITHUB_ACTIONS=$(prompt_yes_no "Add GitHub Actions workflow?" "n")
|
||||
|
||||
# Step 5: Confirmation
|
||||
echo
|
||||
print_step "Summary"
|
||||
echo
|
||||
echo "Plugin Name: $PLUGIN_NAME"
|
||||
echo "Location: $PLUGIN_PATH"
|
||||
echo "Description: $DESCRIPTION"
|
||||
echo "Version: $VERSION"
|
||||
echo "License: $LICENSE"
|
||||
echo "Author: $AUTHOR_NAME <$AUTHOR_EMAIL>"
|
||||
echo
|
||||
echo "Components:"
|
||||
[[ "$WITH_SKILLS" == "y" ]] && echo " ✓ Skills"
|
||||
[[ "$WITH_COMMANDS" == "y" ]] && echo " ✓ Slash Commands"
|
||||
[[ "$WITH_AGENTS" == "y" ]] && echo " ✓ Custom Agents"
|
||||
[[ "$WITH_HOOKS" == "y" ]] && echo " ✓ Event Hooks"
|
||||
[[ "$WITH_MCP" == "y" ]] && echo " ✓ MCP Server"
|
||||
echo
|
||||
|
||||
if [[ "$INTERACTIVE" == "true" ]]; then
|
||||
CONFIRM=$(prompt_yes_no "Create plugin?" "y")
|
||||
if [[ "$CONFIRM" != "y" ]]; then
|
||||
print_warn "Cancelled"
|
||||
exit 0
|
||||
fi
|
||||
fi
|
||||
|
||||
# Create plugin structure
|
||||
echo
|
||||
print_info "Creating plugin structure..."
|
||||
|
||||
mkdir -p "$PLUGIN_PATH/.claude-plugin"
|
||||
|
||||
# Create plugin.json
|
||||
print_info "Creating plugin.json"
|
||||
cat > "$PLUGIN_PATH/.claude-plugin/plugin.json" << EOF
|
||||
{
|
||||
"name": "$PLUGIN_NAME",
|
||||
"version": "$VERSION",
|
||||
"description": "$DESCRIPTION",
|
||||
"author": {
|
||||
"name": "$AUTHOR_NAME",
|
||||
"email": "$AUTHOR_EMAIL"
|
||||
},
|
||||
"license": "$LICENSE",
|
||||
"keywords": []
|
||||
}
|
||||
EOF
|
||||
|
||||
# Create README.md
|
||||
print_info "Creating README.md"
|
||||
cat > "$PLUGIN_PATH/README.md" << EOF
|
||||
# $PLUGIN_NAME
|
||||
|
||||
$DESCRIPTION
|
||||
|
||||
## Installation
|
||||
|
||||
\`\`\`bash
|
||||
# Add marketplace
|
||||
/plugin marketplace add <path-or-repo>
|
||||
|
||||
# Install plugin
|
||||
/plugin install $PLUGIN_NAME@$PLUGIN_NAME
|
||||
\`\`\`
|
||||
|
||||
## Features
|
||||
|
||||
TODO: List your plugin features
|
||||
|
||||
## Usage
|
||||
|
||||
TODO: Describe how to use your plugin
|
||||
|
||||
## Development
|
||||
|
||||
TODO: Add development instructions
|
||||
|
||||
## License
|
||||
|
||||
$LICENSE License - see [LICENSE](LICENSE) for details.
|
||||
EOF
|
||||
|
||||
# Create CHANGELOG.md
|
||||
print_info "Creating CHANGELOG.md"
|
||||
cat > "$PLUGIN_PATH/CHANGELOG.md" << EOF
|
||||
# Changelog
|
||||
|
||||
All notable changes to this project will be documented in this file.
|
||||
|
||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
## [$VERSION] - $(date +%Y-%m-%d)
|
||||
|
||||
### Added
|
||||
- Initial release
|
||||
EOF
|
||||
|
||||
# Create LICENSE
|
||||
print_info "Creating LICENSE"
|
||||
if [[ "$LICENSE" == "MIT" ]]; then
|
||||
cat > "$PLUGIN_PATH/LICENSE" << EOF
|
||||
MIT License
|
||||
|
||||
Copyright (c) $(date +%Y) $AUTHOR_NAME
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
EOF
|
||||
else
|
||||
touch "$PLUGIN_PATH/LICENSE"
|
||||
print_warn "Please add $LICENSE license text to LICENSE file"
|
||||
fi
|
||||
|
||||
# Create .gitignore
|
||||
cat > "$PLUGIN_PATH/.gitignore" << 'EOF'
|
||||
# Logs
|
||||
*.log
|
||||
logs/
|
||||
|
||||
# OS files
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
|
||||
# Editor directories
|
||||
.vscode/
|
||||
.idea/
|
||||
*.swp
|
||||
*.swo
|
||||
*~
|
||||
|
||||
# Environment
|
||||
.env
|
||||
.env.local
|
||||
|
||||
# Dependencies
|
||||
node_modules/
|
||||
__pycache__/
|
||||
*.pyc
|
||||
.venv/
|
||||
venv/
|
||||
dist/
|
||||
build/
|
||||
|
||||
# Test coverage
|
||||
coverage/
|
||||
.coverage
|
||||
*.cover
|
||||
EOF
|
||||
|
||||
# Create components based on selections
|
||||
if [[ "$WITH_SKILLS" == "y" ]]; then
|
||||
print_info "Creating skills structure"
|
||||
mkdir -p "$PLUGIN_PATH/skills/example-skill"
|
||||
|
||||
cat > "$PLUGIN_PATH/skills/example-skill/SKILL.md" << 'EOF'
|
||||
---
|
||||
name: example-skill
|
||||
description: An example skill that demonstrates skill authoring
|
||||
version: 0.1.0
|
||||
---
|
||||
|
||||
# Example Skill
|
||||
|
||||
This is an example skill. Skills are automatically activated based on:
|
||||
- Keywords in the description
|
||||
- User mentioning the skill name
|
||||
- Context matching skill capabilities
|
||||
|
||||
## What This Skill Does
|
||||
|
||||
Describe what this skill helps with.
|
||||
|
||||
## When to Use
|
||||
|
||||
This skill activates when:
|
||||
- Condition 1
|
||||
- Condition 2
|
||||
- Condition 3
|
||||
|
||||
## Quick Start
|
||||
|
||||
Provide a quick example of using this skill.
|
||||
|
||||
## Detailed Guide
|
||||
|
||||
Add comprehensive documentation here.
|
||||
EOF
|
||||
|
||||
print_info "Add skills to plugin.json manually or use the skill authoring tools"
|
||||
fi
|
||||
|
||||
if [[ "$WITH_COMMANDS" == "y" ]]; then
|
||||
print_info "Creating commands structure"
|
||||
mkdir -p "$PLUGIN_PATH/commands"
|
||||
|
||||
cat > "$PLUGIN_PATH/commands/hello.md" << 'EOF'
|
||||
---
|
||||
description: "Say hello with a friendly greeting"
|
||||
---
|
||||
|
||||
Generate a friendly greeting for {{0:name}}.
|
||||
|
||||
Make the greeting:
|
||||
- Warm and welcoming
|
||||
- Include time of day
|
||||
- Professional yet friendly
|
||||
EOF
|
||||
fi
|
||||
|
||||
if [[ "$WITH_AGENTS" == "y" ]]; then
|
||||
print_info "Creating agents structure"
|
||||
mkdir -p "$PLUGIN_PATH/agents"
|
||||
|
||||
cat > "$PLUGIN_PATH/agents/helper.md" << 'EOF'
|
||||
---
|
||||
name: helper
|
||||
description: "A helpful assistant for common tasks"
|
||||
---
|
||||
|
||||
You are a helpful assistant specialized in [domain].
|
||||
|
||||
Your responsibilities:
|
||||
1. Task 1
|
||||
2. Task 2
|
||||
3. Task 3
|
||||
|
||||
Guidelines:
|
||||
- Be clear and concise
|
||||
- Provide examples
|
||||
- Explain your reasoning
|
||||
EOF
|
||||
|
||||
# Update plugin.json
|
||||
tmp=$(mktemp)
|
||||
jq '.agents = ["./agents/helper.md"]' "$PLUGIN_PATH/.claude-plugin/plugin.json" > "$tmp"
|
||||
mv "$tmp" "$PLUGIN_PATH/.claude-plugin/plugin.json"
|
||||
fi
|
||||
|
||||
if [[ "$WITH_HOOKS" == "y" ]]; then
|
||||
print_info "Creating hooks structure"
|
||||
mkdir -p "$PLUGIN_PATH/hooks"
|
||||
|
||||
cat > "$PLUGIN_PATH/hooks/example-hook.sh" << 'EOF'
|
||||
#!/usr/bin/env bash
|
||||
|
||||
# Example hook - receives JSON on stdin, outputs JSON to stdout
|
||||
input=$(cat)
|
||||
|
||||
# Parse input
|
||||
file_path=$(echo "$input" | jq -r '.parameters.file_path // empty')
|
||||
|
||||
# Add your logic here
|
||||
# For PreToolUse hooks, you can approve/block:
|
||||
# echo '{"allowed": true}'
|
||||
# echo '{"allowed": false, "reason": "validation failed"}'
|
||||
|
||||
# For PostToolUse hooks, you can modify the result:
|
||||
# echo "$input" | jq '.result.modified = true'
|
||||
|
||||
# Default: allow the operation
|
||||
echo '{"allowed": true}'
|
||||
EOF
|
||||
chmod +x "$PLUGIN_PATH/hooks/example-hook.sh"
|
||||
|
||||
print_info "Add hooks to plugin.json manually or use the hook authoring tools"
|
||||
fi
|
||||
|
||||
if [[ "$WITH_MCP" == "y" ]]; then
|
||||
print_info "Creating MCP server structure"
|
||||
mkdir -p "$PLUGIN_PATH/servers/$PLUGIN_NAME-server"
|
||||
|
||||
cat > "$PLUGIN_PATH/servers/$PLUGIN_NAME-server/server.py" << EOF
|
||||
"""MCP server for $PLUGIN_NAME"""
|
||||
from mcp.server.fastmcp import FastMCP
|
||||
|
||||
mcp = FastMCP("$PLUGIN_NAME")
|
||||
|
||||
@mcp.tool()
|
||||
async def example_tool(param: str) -> str:
|
||||
"""
|
||||
Example tool implementation.
|
||||
|
||||
Args:
|
||||
param: Parameter description
|
||||
|
||||
Returns:
|
||||
Result description
|
||||
"""
|
||||
return f"Processed: {param}"
|
||||
|
||||
if __name__ == "__main__":
|
||||
mcp.run(transport='stdio')
|
||||
EOF
|
||||
|
||||
cat > "$PLUGIN_PATH/servers/$PLUGIN_NAME-server/pyproject.toml" << EOF
|
||||
[project]
|
||||
name = "$PLUGIN_NAME-server"
|
||||
version = "$VERSION"
|
||||
description = "MCP server for $PLUGIN_NAME"
|
||||
requires-python = ">=3.10"
|
||||
dependencies = [
|
||||
"mcp>=1.2.0",
|
||||
]
|
||||
EOF
|
||||
|
||||
# Update plugin.json
|
||||
tmp=$(mktemp)
|
||||
jq --arg name "$PLUGIN_NAME" '.mcpServers = {($name): {"command": "uv", "args": ["--directory", "${CLAUDE_PLUGIN_ROOT}/servers/\($name)-server", "run", "server.py"]}}' "$PLUGIN_PATH/.claude-plugin/plugin.json" > "$tmp"
|
||||
mv "$tmp" "$PLUGIN_PATH/.claude-plugin/plugin.json"
|
||||
fi
|
||||
|
||||
# Create GitHub Actions workflow if requested
|
||||
if [[ "$CREATE_GITHUB_ACTIONS" == "y" ]]; then
|
||||
print_info "Creating GitHub Actions workflow"
|
||||
mkdir -p "$PLUGIN_PATH/.github/workflows"
|
||||
|
||||
cat > "$PLUGIN_PATH/.github/workflows/validate.yml" << 'EOF'
|
||||
name: Validate Plugin
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [ main ]
|
||||
pull_request:
|
||||
branches: [ main ]
|
||||
|
||||
jobs:
|
||||
validate:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Validate plugin.json
|
||||
run: |
|
||||
# Add validation logic here
|
||||
if [ ! -f ".claude-plugin/plugin.json" ]; then
|
||||
echo "Error: plugin.json not found"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Validate JSON syntax
|
||||
jq empty .claude-plugin/plugin.json
|
||||
EOF
|
||||
fi
|
||||
|
||||
# Initialize git repository
|
||||
if [[ "$INIT_GIT" == "y" ]] && command -v git &> /dev/null; then
|
||||
print_info "Initializing git repository"
|
||||
cd "$PLUGIN_PATH"
|
||||
git init -q
|
||||
git add .
|
||||
git commit -q -m "feat: initial plugin structure
|
||||
|
||||
- Generated with outfitter init-plugin.sh
|
||||
- Initialized $PLUGIN_NAME v$VERSION"
|
||||
cd - > /dev/null
|
||||
fi
|
||||
|
||||
# Success message
|
||||
echo
|
||||
print_info "✓ Plugin created successfully!"
|
||||
echo
|
||||
echo -e "${BLUE}Plugin Location:${NC} $PLUGIN_PATH"
|
||||
echo
|
||||
echo -e "${YELLOW}Next Steps:${NC}"
|
||||
echo " 1. cd $PLUGIN_PATH"
|
||||
echo " 2. Edit .claude-plugin/plugin.json to update metadata"
|
||||
echo " 3. Update README.md with plugin details"
|
||||
[[ "$WITH_SKILLS" == "y" ]] && echo " 4. Customize skills in skills/"
|
||||
[[ "$WITH_COMMANDS" == "y" ]] && echo " 4. Add commands to commands/"
|
||||
[[ "$WITH_AGENTS" == "y" ]] && echo " 4. Customize agents in agents/"
|
||||
[[ "$WITH_HOOKS" == "y" ]] && echo " 4. Implement hooks in hooks/"
|
||||
[[ "$WITH_MCP" == "y" ]] && echo " 4. Implement MCP server in servers/"
|
||||
echo
|
||||
echo -e "${YELLOW}Test Locally:${NC}"
|
||||
echo " /plugin marketplace add $PLUGIN_PATH"
|
||||
echo " /plugin install $PLUGIN_NAME@$PLUGIN_NAME"
|
||||
echo
|
||||
print_info "Happy coding!"
|
||||
Reference in New Issue
Block a user