superclaude-kiro 1.2.8 → 1.3.3

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025
-
-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.
+MIT License
+
+Copyright (c) 2025
+
+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.

package/README.md

@@ -1,295 +1,266 @@
-# SuperClaude for Kiro
-
-Easy installation of [SuperClaude Framework](https://superclaude.netlify.app/) for Kiro (CLI and IDE). One command to install, update, or uninstall.
-
-> **Attribution**: This package is an installer for the SuperClaude Framework created by [SuperClaude-Org](https://github.com/SuperClaude-Org/SuperClaude_Framework). All command content and framework design belongs to the original authors. This package simply provides a convenient installation mechanism for Kiro users.
-
-## Installation
-
-```bash
-npx superclaude-kiro install
-```
-
-The installer will guide you through selecting which MCP servers to install. By default, 4 core servers are pre-selected and ready to use immediately.
-
-**Want MorphLLM Fast Apply?** Select it during installation or add it later:
-
-```bash
-npx superclaude-kiro install --with-morph
-```
-
-## Usage
-
-After installation, start Kiro:
-
-**Kiro CLI:**
-```bash
-kiro-cli chat
-```
-
-**Kiro IDE:**
-Open the Kiro IDE and start a chat session.
-
-### Command Syntax
-
-SuperClaude commands use different prefixes depending on your environment:
-
-| Environment | Syntax | Example |
-|-------------|--------|---------|
-| Kiro CLI | `#sc-*` | `#sc-implement Add user auth` |
-| Kiro IDE | `/sc-*` | `/sc-implement Add user auth` |
-
-**CLI Examples:**
-```
-#sc-implement Add user authentication
-#sc-analyze Review this code for security issues
-#sc-help Show all available commands
-```
-
-**IDE Examples:**
-```
-/sc-implement Add user authentication
-/sc-analyze Review this code for security issues
-/sc-help Show all available commands
-```
-
-## Available Commands
-
-| Command | CLI Syntax | IDE Syntax | Description |
-|---------|------------|------------|-------------|
-| analyze | `#sc-analyze` | `/sc-analyze` | Comprehensive code analysis |
-| brainstorm | `#sc-brainstorm` | `/sc-brainstorm` | Interactive requirements discovery |
-| build | `#sc-build` | `/sc-build` | Project building with error handling |
-| cleanup | `#sc-cleanup` | `/sc-cleanup` | Code cleanup and optimization |
-| design | `#sc-design` | `/sc-design` | System and component design |
-| document | `#sc-document` | `/sc-document` | Documentation generation |
-| estimate | `#sc-estimate` | `/sc-estimate` | Development estimates |
-| explain | `#sc-explain` | `/sc-explain` | Code explanations |
-| git | `#sc-git` | `/sc-git` | Git operations |
-| implement | `#sc-implement` | `/sc-implement` | Feature implementation |
-| improve | `#sc-improve` | `/sc-improve` | Code improvements |
-| index | `#sc-index` | `/sc-index` | Project documentation generation |
-| pm | `#sc-pm` | `/sc-pm` | Project management orchestration |
-| research | `#sc-research` | `/sc-research` | Deep web research |
-| task | `#sc-task` | `/sc-task` | Complex task execution |
-| test | `#sc-test` | `/sc-test` | Test execution |
-| troubleshoot | `#sc-troubleshoot` | `/sc-troubleshoot` | Issue diagnosis |
-| workflow | `#sc-workflow` | `/sc-workflow` | Workflow generation |
-| help | `#sc-help` | `/sc-help` | Show all commands and flags |
-
-## CLI Commands
-
-```bash
-# Install SuperClaude (interactive MCP server selection)
-npx superclaude-kiro install
-
-# Install with options
-npx superclaude-kiro install --force           # Overwrite existing
-npx superclaude-kiro install --minimal         # Core servers only, no prompts
-npx superclaude-kiro install --with-morph      # Include MorphLLM (prompts for API key)
-npx superclaude-kiro install --no-interactive  # Skip prompts, use defaults
-npx superclaude-kiro install --no-mcp          # Skip MCP server config entirely
-npx superclaude-kiro install --no-default      # Don't set as default agent
-
-# Install with MorphLLM API key (for CI/CD)
-npx superclaude-kiro install --morph-api-key "your-api-key"
-
-# Update to latest version (preserves your MCP server selections)
-npx superclaude-kiro update
-
-# Add MorphLLM during update
-npx superclaude-kiro update --with-morph
-
-# Check installation status
-npx superclaude-kiro status
-
-# Uninstall
-npx superclaude-kiro uninstall
-```
-
-## What Gets Installed
-
-- **30 steering files** - SuperClaude commands in `~/.kiro/steering/superclaude/`
-- **4 agents** - Specialized agents in `~/.kiro/agents/`
-  - `superclaude` - Main framework agent (default)
-  - `sc-pm` - Project Manager agent
-  - `sc-implement` - Implementation agent
-  - `sc-analyze` - Analysis agent
-- **MCP servers** - Your selected servers in `~/.kiro/settings/mcp.json`
-- **Default agent** - Set to `superclaude` in `~/.kiro/settings/cli.json`
-
-## MCP Server Selection
-
-During installation, you can choose which MCP servers to install:
-
-| Server | Description | Default |
-|--------|-------------|---------|
-| `sequential-thinking` | Structured reasoning and problem-solving | Yes |
-| `context7` | Library documentation lookup | Yes |
-| `playwright` | Browser automation and testing | Yes |
-| `serena` | Semantic code analysis and editing | Yes |
-| `morphllm-fast-apply` | Ultra-fast file editing (requires API key) | No |
-
-### MorphLLM Fast Apply
-
-MorphLLM provides ultra-fast file editing at 10,500+ tokens/sec.
-
-**To install with MorphLLM:**
-
-```bash
-npx superclaude-kiro install --with-morph
-```
-
-The installer will guide you through:
-1. Creating a free account at [morphllm.com](https://www.morphllm.com)
-2. Getting your API key from [dashboard/api-keys](https://morphllm.com/dashboard/api-keys)
-3. Entering your API key securely
-
-**For CI/CD (non-interactive):**
-
-```bash
-npx superclaude-kiro install --morph-api-key "your-api-key"
-```
-
-**Pricing**: Free tier includes 500 requests/month. Paid usage is ~$1/million tokens.
-
-## Configuration
-
-All agents are configured with:
-- `"tools": ["*"]` - Access to all tools
-- `"allowedTools": ["*", "use_subagent", "@context7", "@playwright", "@sequential-thinking", "@serena", "@morphllm-fast-apply/edit_file"]` - All built-in tools, subagents, and MCP tools pre-approved
-- `"toolsSettings"` - Shell and write operations auto-allowed
-- `"useLegacyMcpJson": true` - Uses global MCP servers
-- `"model": "claude-opus-4.6"` - Uses Claude Opus 4.6 by default (subagents inherit this when spawned with superclaude agent)
-
-**Note**: No default model is set - Kiro CLI remembers your model choice.
-
-MCP servers are configured with `autoApprove` arrays for all tools, so you won't be prompted for permission.
-
-## Behavioral Modes
-
-Use natural language to activate modes:
-
-| Mode | How to Activate |
-|------|-----------------|
-| Think deeply | "think through this step by step" |
-| Brainstorm | "let's brainstorm this" |
-| Delegate | "delegate this to sub-tasks" |
-| Safe mode | "validate carefully before executing" |
-| Token efficient | "be concise" |
-
-## Switching Agents
-
-```bash
-# In a Kiro session
-/agent swap
-# Select from: superclaude, sc-pm, sc-implement, sc-analyze
-
-# Or start with a specific agent
-kiro-cli chat --agent sc-pm
-```
-
-## For Package Maintainers
-
-### Update from Claude Code
-
-```bash
-# Clone this repo
-git clone https://github.com/your-org/superclaude-kiro.git
-cd superclaude-kiro
-
-# Install dependencies
-npm install
-
-# Sync from your local Claude Code installation
-npm run sync:claude
-
-# Build distribution files
-npm run build
-
-# Bump version and publish
-npm version patch
-npm publish
-```
-
-### Update from GitHub
-
-```bash
-# Set the repo (optional, defaults to SuperClaude-Org/SuperClaude_Framework)
-export SUPERCLAUDE_REPO=your-org/your-repo
-
-# Sync from GitHub
-npm run sync:github
-
-# Build and publish
-npm run build
-npm version patch
-npm publish
-```
-
-## Requirements
-
-- Node.js 18+
-- Kiro CLI installed (`~/.kiro` directory exists)
-
-## Troubleshooting
-
-### SuperClaude not loading as default
-
-```bash
-# Check setting
-kiro-cli settings chat.defaultAgent
-
-# Set manually if needed
-kiro-cli settings chat.defaultAgent superclaude
-```
-
-### MCP servers not working
-
-```bash
-# List MCP servers
-kiro-cli mcp list
-
-# Check config
-cat ~/.kiro/settings/mcp.json
-
-# Check status
-npx superclaude-kiro status
-```
-
-### MorphLLM not working
-
-Run the installer with `--with-morph` to set up MorphLLM:
-
-```bash
-npx superclaude-kiro install --force --with-morph
-```
-
-Or check your current status:
-
-```bash
-npx superclaude-kiro status
-```
-
-**Common issues:**
-- API key must be provided during installation (environment variable expansion doesn't work reliably in Kiro CLI)
-- Get your API key from [morphllm.com/dashboard/api-keys](https://www.morphllm.com/dashboard/api-keys)
-
-### Reinstall from scratch
-
-```bash
-npx superclaude-kiro uninstall
-npx superclaude-kiro install --force
-```
-
-## Credits & References
-
-- **SuperClaude Framework**: https://superclaude.netlify.app/
-- **SuperClaude GitHub**: https://github.com/SuperClaude-Org/SuperClaude_Framework
-- **Kiro CLI Documentation**: https://kiro.dev/docs/cli/
-
-This installer package was created to simplify SuperClaude deployment for Kiro users. All credit for the SuperClaude framework, commands, and methodology goes to the original creators.
-
-## License
-
-MIT (installer only - SuperClaude Framework has its own license, see [original repository](https://github.com/SuperClaude-Org/SuperClaude_Framework))
+# SuperClaude for Kiro
+
+Easy installation of [SuperClaude Framework](https://superclaude.netlify.app/) for Kiro (CLI and IDE). One command to install, update, or uninstall.
+
+> **Attribution**: This package is an installer for the SuperClaude Framework created by [SuperClaude-Org](https://github.com/SuperClaude-Org/SuperClaude_Framework). All command content and framework design belongs to the original authors. This package simply provides a convenient installation mechanism for Kiro users.
+
+## Installation
+
+```bash
+npx superclaude-kiro install
+```
+
+The installer will guide you through selecting which MCP servers to install. By default, 5 core servers are pre-selected and ready to use immediately.
+
+## Usage
+
+After installation, start Kiro:
+
+**Kiro CLI:**
+```bash
+kiro-cli chat
+```
+
+**Kiro IDE:**
+Open the Kiro IDE and start a chat session.
+
+### Command Syntax
+
+SuperClaude commands use different prefixes depending on your environment:
+
+| Environment | Syntax | Example |
+|-------------|--------|---------|
+| Kiro CLI | `#sc-*` | `#sc-implement Add user auth` |
+| Kiro IDE | `/sc-*` | `/sc-implement Add user auth` |
+
+**CLI Examples:**
+```
+#sc-implement Add user authentication
+#sc-analyze Review this code for security issues
+#sc-help Show all available commands
+```
+
+**IDE Examples:**
+```
+/sc-implement Add user authentication
+/sc-analyze Review this code for security issues
+/sc-help Show all available commands
+```
+
+## Available Commands
+
+| Command | CLI Syntax | IDE Syntax | Description |
+|---------|------------|------------|-------------|
+| analyze | `#sc-analyze` | `/sc-analyze` | Comprehensive code analysis |
+| brainstorm | `#sc-brainstorm` | `/sc-brainstorm` | Interactive requirements discovery |
+| build | `#sc-build` | `/sc-build` | Project building with error handling |
+| cleanup | `#sc-cleanup` | `/sc-cleanup` | Code cleanup and optimization |
+| design | `#sc-design` | `/sc-design` | System and component design |
+| document | `#sc-document` | `/sc-document` | Documentation generation |
+| estimate | `#sc-estimate` | `/sc-estimate` | Development estimates |
+| explain | `#sc-explain` | `/sc-explain` | Code explanations |
+| git | `#sc-git` | `/sc-git` | Git operations |
+| implement | `#sc-implement` | `/sc-implement` | Feature implementation |
+| improve | `#sc-improve` | `/sc-improve` | Code improvements |
+| index | `#sc-index` | `/sc-index` | Project documentation generation |
+| pm | `#sc-pm` | `/sc-pm` | Project management orchestration |
+| research | `#sc-research` | `/sc-research` | Deep web research |
+| task | `#sc-task` | `/sc-task` | Complex task execution |
+| test | `#sc-test` | `/sc-test` | Test execution |
+| troubleshoot | `#sc-troubleshoot` | `/sc-troubleshoot` | Issue diagnosis |
+| workflow | `#sc-workflow` | `/sc-workflow` | Workflow generation |
+| help | `#sc-help` | `/sc-help` | Show all commands and flags |
+
+## CLI Commands
+
+```bash
+# Install SuperClaude (interactive MCP server selection)
+npx superclaude-kiro install
+
+# Install with options
+npx superclaude-kiro install --force           # Overwrite existing
+npx superclaude-kiro install --minimal         # Core servers only, no prompts
+npx superclaude-kiro install --no-interactive  # Skip prompts, use defaults
+npx superclaude-kiro install --no-mcp          # Skip MCP server config entirely
+npx superclaude-kiro install --no-default      # Don't set as default agent
+npx superclaude-kiro install --no-serena-setup # Skip Serena binary install (use uvx fallback)
+
+# Update to latest version (preserves your MCP server selections)
+npx superclaude-kiro update
+
+# Check installation status
+npx superclaude-kiro status
+
+# Uninstall
+npx superclaude-kiro uninstall
+```
+
+## What Gets Installed
+
+- **30 steering files** - SuperClaude commands in `~/.kiro/steering/superclaude/`
+- **4 agents** - Specialized agents in `~/.kiro/agents/`
+  - `superclaude` - Main framework agent (default)
+  - `sc-pm` - Project Manager agent
+  - `sc-implement` - Implementation agent
+  - `sc-analyze` - Analysis agent
+- **MCP servers** - Your selected servers in `~/.kiro/settings/mcp.json`
+- **Default agent** - Set to `superclaude` in `~/.kiro/settings/cli.json`
+
+## MCP Server Selection
+
+During installation, you can choose which MCP servers to install:
+
+| Server | Description | Default |
+|--------|-------------|---------|
+| `sequential-thinking` | Structured reasoning and problem-solving | Yes |
+| `context7` | Library documentation lookup | Yes |
+| `playwright` | Browser automation and testing | Yes |
+| `serena` | Semantic code analysis and editing | Yes |
+| `aws-docs` | AWS documentation lookup | Yes |
+
+## Configuration
+
+All agents are configured with:
+- `"tools": ["*"]` - Access to all tools
+- `"allowedTools": ["*", "use_subagent", "@context7", "@playwright", "@sequential-thinking", "@serena"]` - All built-in tools, subagents, and MCP tools pre-approved
+- `"toolsSettings"` - Shell and write operations auto-allowed
+- `"includeMcpJson": true` - Includes MCP servers from global config
+- `"model": "claude-opus-4.6"` - Uses Claude Opus 4.6 by default (subagents inherit this when spawned with superclaude agent)
+
+**Note**: No default model is set - Kiro CLI remembers your model choice.
+
+MCP tools are auto-approved via the agent's `allowedTools` patterns (e.g., `@context7`, `@playwright`).
+
+## Behavioral Modes
+
+Use natural language to activate modes:
+
+| Mode | How to Activate |
+|------|-----------------|
+| Think deeply | "think through this step by step" |
+| Brainstorm | "let's brainstorm this" |
+| Delegate | "delegate this to sub-tasks" |
+| Safe mode | "validate carefully before executing" |
+| Token efficient | "be concise" |
+
+## Switching Agents
+
+```bash
+# In a Kiro session
+/agent swap
+# Select from: superclaude, sc-pm, sc-implement, sc-analyze
+
+# Or start with a specific agent
+kiro-cli chat --agent sc-pm
+```
+
+## For Package Maintainers
+
+### Update from Claude Code
+
+```bash
+# Clone this repo
+git clone https://tools.standardbank.co.za/bitbucket/scm/aien/super-claude-kiro.git
+cd super-claude-kiro
+
+# Install dependencies
+npm install
+
+# Sync from your local Claude Code installation
+npm run sync:claude
+
+# Build distribution files
+npm run build
+
+# Bump version and publish
+npm version patch
+npm publish
+```
+
+### Update from GitHub
+
+```bash
+# Set the repo (optional, defaults to SuperClaude-Org/SuperClaude_Framework)
+export SUPERCLAUDE_REPO=aien/super-claude-kiro
+
+# Sync from GitHub
+npm run sync:github
+
+# Build and publish
+npm run build
+npm version patch
+npm publish
+```
+
+## Requirements
+
+- Node.js 18+
+- Kiro CLI installed (`~/.kiro` directory exists)
+- **uv** (auto-installed if missing) - Required for the Serena MCP server. The installer will automatically download and install [uv](https://docs.astral.sh/uv/) and then use it to install Serena as a persistent binary. To skip this, use `--no-serena-setup`.
+
+## Troubleshooting
+
+### SuperClaude not loading as default
+
+```bash
+# Check setting
+kiro-cli settings chat.defaultAgent
+
+# Set manually if needed
+kiro-cli settings chat.defaultAgent superclaude
+```
+
+### MCP servers not working
+
+```bash
+# List MCP servers
+kiro-cli mcp list
+
+# Check config
+cat ~/.kiro/settings/mcp.json
+
+# Check status
+npx superclaude-kiro status
+```
+
+### Serena not connecting / slow startup
+
+The installer automatically installs Serena as a persistent binary for fast, reliable startup. If Serena isn't working:
+
+```bash
+# Check if the Serena binary is installed
+npx superclaude-kiro status
+
+# Reinstall with Serena setup
+npx superclaude-kiro install --force
+
+# Or skip auto-setup and use uvx fallback
+npx superclaude-kiro install --force --no-serena-setup
+```
+
+**Common issues:**
+- **Windows: "Git executable not found"**: The installer auto-detects Git's location and injects it into the MCP config's PATH. If Git isn't installed, get it from https://git-scm.com/download/win and re-run the installer.
+- **Windows timeouts**: The default `uvx` config re-clones Serena's git repo on every startup, causing timeouts. The auto-install fixes this by using a persistent binary.
+- **Corporate proxy / SSL errors**: The installer auto-detects `NODE_EXTRA_CA_CERTS` and sets `SSL_CERT_FILE`, `REQUESTS_CA_BUNDLE`, and `GIT_SSL_CAINFO` for Python/Git tools.
+- **uv not found**: The installer auto-installs [uv](https://docs.astral.sh/uv/). If it fails, install manually: `powershell -c "irm https://astral.sh/uv/install.ps1 | iex"` (Windows) or `curl -LsSf https://astral.sh/uv/install.sh | sh` (Unix).
+- **Serena binary not found after install**: Check `~/.local/bin/serena` (Unix) or `~/.local/bin/serena.exe` (Windows). You may need to restart your terminal for PATH changes.
+- **Context7 / Sequential Thinking slow on first run**: The installer pre-warms npx caches during install. If you still see timeouts, retry — packages are cached after the first download.
+
+### Reinstall from scratch
+
+```bash
+npx superclaude-kiro uninstall
+npx superclaude-kiro install --force
+```
+
+## Credits & References
+
+- **SuperClaude Framework**: https://superclaude.netlify.app/
+- **SuperClaude GitHub**: https://github.com/SuperClaude-Org/SuperClaude_Framework
+- **Kiro CLI Documentation**: https://kiro.dev/docs/cli/
+
+This installer package was created to simplify SuperClaude deployment for Kiro users. All credit for the SuperClaude framework, commands, and methodology goes to the original creators.
+
+## License
+
+MIT (installer only - SuperClaude Framework has its own license, see [original repository](https://github.com/SuperClaude-Org/SuperClaude_Framework))