npm - @hienlh/ppm - Versions diffs - 0.9.81 → 0.9.83 - Mend

@hienlh/ppm 0.9.81 → 0.9.83

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1754) hide show

package/.opencode/skills/claude-code/references/ide-integration.md DELETED Viewed

@@ -1,316 +0,0 @@
-# IDE Integration
-Use Claude Code with Visual Studio Code and JetBrains IDEs.
-## Visual Studio Code
-### Installation
-1. Open VS Code
-2. Go to Extensions (Ctrl+Shift+X)
-3. Search for "Claude Code"
-4. Click Install
-5. Authenticate with API key
-### Features
-**Inline Chat**
-- Press Ctrl+I (Cmd+I on Mac)
-- Ask questions about code
-- Get suggestions in context
-- Apply changes directly
-**Code Actions**
-- Right-click on code
-- Select "Ask Claude"
-- Get refactoring suggestions
-- Fix bugs and issues
-**Diff View**
-- See proposed changes
-- Accept/reject modifications
-- Review before applying
-- Staged diff comparison
-**Terminal Integration**
-- Built-in Claude terminal
-- Run commands via Claude
-- Execute tools directly
-- View real-time output
-### Configuration
-**.vscode/settings.json:**
-```json
-{
-  "claude.apiKey": "${ANTHROPIC_API_KEY}",
-  "claude.model": "claude-sonnet-4-5-20250929",
-  "claude.maxTokens": 8192,
-  "claude.autoSave": true,
-  "claude.inlineChat.enabled": true,
-  "claude.terminalIntegration": true
-}
-```
-### Keyboard Shortcuts
-**Default shortcuts:**
-- `Ctrl+I`: Inline chat
-- `Ctrl+Shift+C`: Open Claude panel
-- `Ctrl+Shift+Enter`: Submit to Claude
-- `Escape`: Close Claude chat
-**Custom shortcuts (.vscode/keybindings.json):**
-```json
-[
-  {
-    "key": "ctrl+alt+c",
-    "command": "claude.openChat"
-  },
-  {
-    "key": "ctrl+alt+r",
-    "command": "claude.refactor"
-  }
-]
-```
-### Workspace Integration
-**Project-specific Claude settings:**
-.vscode/claude.json:
-```json
-{
-  "skills": [".opencode/skills/project-skill"],
-  "commands": [".opencode/commands"],
-  "mcpServers": ".opencode/mcp.json",
-  "outputStyle": "technical-writer"
-}
-```
-### Common Workflows
-**Explain Code:**
-1. Select code
-2. Right-click → "Ask Claude"
-3. Type: "Explain this code"
-**Refactor:**
-1. Select function
-2. Press Ctrl+I
-3. Type: "Refactor for better performance"
-**Fix Bug:**
-1. Click on error
-2. Press Ctrl+I
-3. Type: "Fix this error"
-**Generate Tests:**
-1. Select function
-2. Right-click → "Ask Claude"
-3. Type: "Write tests for this"
-## JetBrains IDEs
-Supported IDEs:
-- IntelliJ IDEA
-- PyCharm
-- WebStorm
-- PhpStorm
-- GoLand
-- RubyMine
-- CLion
-- Rider
-### Installation
-1. Open Settings (Ctrl+Alt+S)
-2. Go to Plugins
-3. Search "Claude Code"
-4. Click Install
-5. Restart IDE
-6. Authenticate with API key
-### Features
-**AI Assistant Panel**
-- Dedicated Claude panel
-- Context-aware suggestions
-- Multi-file awareness
-- Project understanding
-**Inline Suggestions**
-- As-you-type completions
-- Contextual code generation
-- Smart refactoring hints
-- Error fix suggestions
-**Code Reviews**
-- Automated code reviews
-- Security vulnerability detection
-- Best practice recommendations
-- Performance optimization tips
-**Refactoring Support**
-- Smart rename
-- Extract method
-- Inline variable
-- Move class
-### Configuration
-**Settings → Tools → Claude Code:**
-```
-API Key: [Your API Key]
-Model: claude-sonnet-4-5-20250929
-Max Tokens: 8192
-Auto-complete: Enabled
-Code Review: Enabled
-```
-**Project Settings (.idea/claude.xml):**
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ClaudeSettings">
-    <option name="model" value="claude-sonnet-4-5-20250929" />
-    <option name="skillsPath" value=".opencode/skills" />
-    <option name="autoReview" value="true" />
-  </component>
-</project>
-```
-### Keyboard Shortcuts
-**Default shortcuts:**
-- `Ctrl+Shift+A`: Ask Claude
-- `Alt+Enter`: Quick fixes with Claude
-- `Ctrl+Alt+L`: Format with Claude suggestions
-**Custom shortcuts (Settings → Keymap → Claude Code):**
-```
-Ask Claude: Ctrl+Shift+C
-Refactor with Claude: Ctrl+Alt+R
-Generate Tests: Ctrl+Alt+T
-Code Review: Ctrl+Alt+V
-```
-### Integration with IDE Features
-**Version Control:**
-- Review commit diffs with Claude
-- Generate commit messages
-- Suggest PR improvements
-- Analyze merge conflicts
-**Debugger:**
-- Explain stack traces
-- Suggest fixes for errors
-- Debug complex issues
-- Analyze variable states
-**Database Tools:**
-- Generate SQL queries
-- Optimize database schema
-- Write migration scripts
-- Explain query plans
-### Common Workflows
-**Generate Boilerplate:**
-1. Right-click in editor
-2. Select "Generate" → "Claude Code"
-3. Choose template type
-**Review Changes:**
-1. Open Version Control panel
-2. Right-click on changeset
-3. Select "Review with Claude"
-**Debug Error:**
-1. Hit breakpoint
-2. Right-click in debugger
-3. Select "Ask Claude about this"
-## CLI Integration
-Use Claude Code from IDE terminal:
-```bash
-# In VS Code terminal
-claude "explain this project structure"
-# In JetBrains terminal
-claude "add error handling to current file"
-```
-## Best Practices
-### VS Code
-**Workspace Organization:**
-- Use workspace settings for team consistency
-- Share .vscode/claude.json in version control
-- Document custom shortcuts
-- Configure output styles per project
-**Performance:**
-- Limit inline suggestions in large files
-- Disable auto-save for better control
-- Use specific prompts
-- Close unused editor tabs
-### JetBrains
-**Project Configuration:**
-- Enable Claude for specific file types only
-- Configure inspection severity
-- Set up custom code review templates
-- Use project-specific skills
-**Performance:**
-- Adjust auto-complete delay
-- Limit scope of code analysis
-- Disable for binary files
-- Configure memory settings
-## Troubleshooting
-### VS Code
-**Extension Not Loading:**
-```bash
-# Check extension status
-code --list-extensions | grep claude
-# Reinstall
-code --uninstall-extension anthropic.claude-code
-code --install-extension anthropic.claude-code
-```
-**Authentication Issues:**
-- Verify API key in settings
-- Check environment variable
-- Re-authenticate in extension
-- Review proxy settings
-### JetBrains
-**Plugin Not Responding:**
-```
-File → Invalidate Caches / Restart
-Settings → Plugins → Claude Code → Reinstall
-```
-**Performance Issues:**
-- Increase IDE memory (Help → Edit Custom VM Options)
-- Disable unused features
-- Clear caches
-- Update plugin version
-## See Also
-- VS Code extension: https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code
-- JetBrains plugin: https://plugins.jetbrains.com/plugin/claude-code
-- Configuration: `references/configuration.md`
-- Troubleshooting: `references/troubleshooting.md`

package/.opencode/skills/claude-code/references/mcp-integration.md DELETED Viewed

@@ -1,386 +0,0 @@
-# MCP Integration
-Model Context Protocol (MCP) integration for connecting Claude Code to external tools and services.
-## What is MCP?
-Model Context Protocol enables Claude Code to:
-- Connect to external tools and services
-- Access resources (files, databases, APIs)
-- Use custom tools
-- Provide prompts and completions
-## Configuration
-MCP servers are configured in `.opencode/mcp.json`:
-### Basic Configuration
-```json
-{
-  "mcpServers": {
-    "server-name": {
-      "command": "command-to-run",
-      "args": ["arg1", "arg2"],
-      "env": {
-        "VAR_NAME": "value"
-      }
-    }
-  }
-}
-```
-### Example Configuration
-```json
-{
-  "mcpServers": {
-    "filesystem": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"],
-      "env": {}
-    },
-    "github": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-github"],
-      "env": {
-        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
-      }
-    },
-    "postgres": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-postgres"],
-      "env": {
-        "DATABASE_URL": "postgresql://user:pass@localhost:5432/db"
-      }
-    }
-  }
-}
-```
-## Common MCP Servers
-### Filesystem Access
-```json
-{
-  "filesystem": {
-    "command": "npx",
-    "args": [
-      "-y",
-      "@modelcontextprotocol/server-filesystem",
-      "/path/to/allowed/files"
-    ]
-  }
-}
-```
-**Capabilities:**
-- Read/write files
-- List directories
-- File search
-- Path restrictions for security
-### GitHub Integration
-```json
-{
-  "github": {
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-github"],
-    "env": {
-      "GITHUB_TOKEN": "${GITHUB_TOKEN}"
-    }
-  }
-}
-```
-**Capabilities:**
-- Repository access
-- Issues and PRs
-- Code search
-- Workflow management
-### PostgreSQL Database
-```json
-{
-  "postgres": {
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-postgres"],
-    "env": {
-      "DATABASE_URL": "${DATABASE_URL}"
-    }
-  }
-}
-```
-**Capabilities:**
-- Query execution
-- Schema inspection
-- Transaction management
-- Connection pooling
-### Brave Search
-```json
-{
-  "brave-search": {
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-brave-search"],
-    "env": {
-      "BRAVE_API_KEY": "${BRAVE_API_KEY}"
-    }
-  }
-}
-```
-**Capabilities:**
-- Web search
-- News search
-- Local search
-- Result filtering
-### Puppeteer (Browser Automation)
-```json
-{
-  "puppeteer": {
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
-  }
-}
-```
-**Capabilities:**
-- Browser automation
-- Screenshots
-- PDF generation
-- Web scraping
-## Remote MCP Servers
-Connect to MCP servers over HTTP/SSE:
-### Basic Remote Server
-```json
-{
-  "mcpServers": {
-    "remote-service": {
-      "url": "https://api.example.com/mcp"
-    }
-  }
-}
-```
-### With Authentication
-```json
-{
-  "mcpServers": {
-    "remote-service": {
-      "url": "https://api.example.com/mcp",
-      "headers": {
-        "Authorization": "Bearer ${API_TOKEN}",
-        "X-Custom-Header": "value"
-      }
-    }
-  }
-}
-```
-### With Proxy
-```json
-{
-  "mcpServers": {
-    "remote-service": {
-      "url": "https://api.example.com/mcp",
-      "proxy": "http://proxy.company.com:8080"
-    }
-  }
-}
-```
-## Environment Variables
-Use environment variables for sensitive data:
-### .env File
-```bash
-# .opencode/.env
-GITHUB_TOKEN=ghp_xxxxx
-DATABASE_URL=postgresql://user:pass@localhost/db
-BRAVE_API_KEY=BSAxxxxx
-API_TOKEN=token_xxxxx
-```
-### Reference in mcp.json
-```json
-{
-  "mcpServers": {
-    "github": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-github"],
-      "env": {
-        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
-      }
-    }
-  }
-}
-```
-## Testing MCP Servers
-### Inspector Tool
-```bash
-npx @modelcontextprotocol/inspector
-```
-Opens web UI for testing MCP servers:
-- List available tools
-- Test tool invocations
-- View resources
-- Debug connections
-### Manual Testing
-```bash
-# Test server command
-npx -y @modelcontextprotocol/server-filesystem /tmp
-# Check server output
-echo '{"jsonrpc":"2.0","method":"initialize","params":{}}' | \
-  npx -y @modelcontextprotocol/server-filesystem /tmp
-```
-## Creating Custom MCP Servers
-### Python Server
-```python
-from mcp.server import Server
-from mcp.server.stdio import stdio_server
-server = Server("my-server")
-@server.tool()
-async def my_tool(arg: str) -> str:
-    """Tool description"""
-    return f"Result: {arg}"
-if __name__ == "__main__":
-    stdio_server(server)
-```
-### Configuration
-```json
-{
-  "mcpServers": {
-    "my-server": {
-      "command": "python",
-      "args": ["path/to/server.py"]
-    }
-  }
-}
-```
-### Node.js Server
-```javascript
-import { Server } from "@modelcontextprotocol/server-node";
-const server = new Server("my-server");
-server.tool({
-  name: "my-tool",
-  description: "Tool description",
-  parameters: { arg: "string" }
-}, async ({ arg }) => {
-  return `Result: ${arg}`;
-});
-server.listen();
-```
-## Security Considerations
-### Filesystem Access
-- Restrict to specific directories
-- Use read-only access when possible
-- Validate file paths
-- Monitor access logs
-### API Credentials
-- Use environment variables
-- Never commit credentials
-- Rotate keys regularly
-- Implement least-privilege access
-### Network Access
-- Whitelist allowed domains
-- Use HTTPS only
-- Implement timeouts
-- Rate limit requests
-### Remote Servers
-- Validate server certificates
-- Use authentication
-- Implement request signing
-- Monitor for anomalies
-## Troubleshooting
-### Server Not Starting
-```bash
-# Check server command
-npx -y @modelcontextprotocol/server-filesystem /tmp
-# Verify environment variables
-echo $GITHUB_TOKEN
-# Check logs
-cat ~/.opencode/logs/mcp-*.log
-```
-### Connection Errors
-```bash
-# Test network connectivity
-curl https://api.example.com/mcp
-# Verify proxy settings
-echo $HTTP_PROXY
-# Check firewall rules
-```
-### Permission Errors
-```bash
-# Verify file permissions
-ls -la /path/to/allowed/files
-# Check user permissions
-whoami
-groups
-```
-### Tool Not Found
-- Verify server is running
-- Check server configuration
-- Inspect server capabilities
-- Review tool registration
-## Best Practices
-### Configuration Management
-- Use environment variables for secrets
-- Document server purposes
-- Version control mcp.json (without secrets)
-- Test configurations thoroughly
-### Performance
-- Use local servers when possible
-- Implement caching
-- Set appropriate timeouts
-- Monitor resource usage
-### Maintenance
-- Update servers regularly
-- Monitor server health
-- Review access logs
-- Clean up unused servers
-## See Also
-- MCP specification: https://modelcontextprotocol.io
-- Creating MCP servers: `references/api-reference.md`
-- Security best practices: `references/best-practices.md`
-- Troubleshooting: `references/troubleshooting.md`