crucible-mcp 0.1.0__tar.gz → 0.3.0__tar.gz

crucible_mcp-0.3.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: crucible-mcp
+Version: 0.3.0
+Summary: Code review MCP server for Claude. Not affiliated with Atlassian.
+Author: be.nvy
+License-Expression: MIT
+Keywords: mcp,code-review,static-analysis,claude
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: ruff>=0.3; extra == "dev"
+
+# Crucible
+
+Load your coding patterns into Claude Code.
+
+```
+├── Personas:      Domain-specific thinking (how to approach problems)
+├── Knowledge:     Coding patterns and principles (what to apply)
+├── Cascade:       Project → User → Bundled (customizable at every level)
+└── Context-aware: Loads relevant skills based on what you're working on
+```
+
+**Personas for domains. Knowledge for patterns. All customizable.**
+
+> Not affiliated with Atlassian's Crucible.
+
+## Install
+
+```bash
+pip install crucible-mcp
+```
+
+Add to Claude Code (`.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "crucible": {
+      "command": "crucible-mcp"
+    }
+  }
+}
+```
+
+With hot reload (recommended for customization):
+
+```json
+{
+  "mcpServers": {
+    "crucible": {
+      "command": "mcpmon",
+      "args": ["--watch", "~/.crucible/", "--", "crucible-mcp"]
+    }
+  }
+}
+```
+
+## How It Works
+
+```
+Code → Detect Domain → Load Personas + Knowledge → Claude with YOUR patterns
+
+.sol file → web3 domain → security-engineer + SMART_CONTRACT.md → Knows your security rules
+```
+
+## MCP Tools
+
+| Tool | Purpose |
+|------|---------|
+| `review(path)` | Full review: analysis + skills + knowledge |
+| `review(mode='staged')` | Review git changes with skills + knowledge |
+| `load_knowledge(files)` | Load specific knowledge files |
+| `get_principles(topic)` | Load engineering knowledge by topic |
+| `delegate_*` | Direct tool access (semgrep, ruff, slither, bandit) |
+| `check_tools()` | Show installed analysis tools |
+
+The unified `review` tool supports:
+- **Path-based**: `review(path="src/")` - analyze files/directories
+- **Git-aware**: `review(mode="staged")` - analyze changes (staged, unstaged, branch, commits)
+- **Quick mode**: `review(path, include_skills=false)` - analysis only, no skills/knowledge
+
+## CLI
+
+```bash
+crucible init                     # Initialize .crucible/ for your project
+crucible review                   # Review staged changes
+crucible review --mode branch     # Review current branch vs main
+crucible ci generate              # Generate GitHub Actions workflow
+
+crucible skills list              # List all skills
+crucible skills init <skill>      # Copy to .crucible/ for customization
+
+crucible knowledge list           # List all knowledge files
+crucible knowledge init <file>    # Copy for customization
+
+crucible hooks install            # Install pre-commit hook
+```
+
+See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for the full flow.
+
+## Customization
+
+Override skills and knowledge for your project or personal preferences:
+
+```bash
+# Customize a skill for your project
+crucible skills init security-engineer
+# Creates .crucible/skills/security-engineer/SKILL.md
+
+# Add project-specific concerns, team conventions, etc.
+```
+
+Resolution order (first found wins):
+1. `.crucible/` — Project overrides
+2. `~/.claude/crucible/` — User preferences
+3. Bundled — Package defaults
+
+See [CUSTOMIZATION.md](docs/CUSTOMIZATION.md) for the full guide.
+
+## What's Included
+
+**18 Personas** — Domain-specific thinking: security, performance, accessibility, web3, backend, and more.
+
+See [SKILLS.md](docs/SKILLS.md) for the full list.
+
+**12 Knowledge Files** — Coding patterns and principles for security, testing, APIs, databases, smart contracts, etc.
+
+See [KNOWLEDGE.md](docs/KNOWLEDGE.md) for topics covered.
+
+## Documentation
+
+| Doc | What's In It |
+|-----|--------------|
+| [FEATURES.md](docs/FEATURES.md) | Complete feature reference |
+| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | How MCP, tools, skills, and knowledge fit together |
+| [CUSTOMIZATION.md](docs/CUSTOMIZATION.md) | Override skills and knowledge for your project |
+| [SKILLS.md](docs/SKILLS.md) | All 18 personas with triggers and focus areas |
+| [KNOWLEDGE.md](docs/KNOWLEDGE.md) | All 12 knowledge files with topics covered |
+| [CONTRIBUTING.md](docs/CONTRIBUTING.md) | Adding tools, skills, and knowledge |
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                    # Run tests (509 tests)
+ruff check src/ --fix     # Lint
+```

crucible_mcp-0.3.0/README.md

@@ -0,0 +1,136 @@
+# Crucible
+
+Load your coding patterns into Claude Code.
+
+```
+├── Personas:      Domain-specific thinking (how to approach problems)
+├── Knowledge:     Coding patterns and principles (what to apply)
+├── Cascade:       Project → User → Bundled (customizable at every level)
+└── Context-aware: Loads relevant skills based on what you're working on
+```
+
+**Personas for domains. Knowledge for patterns. All customizable.**
+
+> Not affiliated with Atlassian's Crucible.
+
+## Install
+
+```bash
+pip install crucible-mcp
+```
+
+Add to Claude Code (`.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "crucible": {
+      "command": "crucible-mcp"
+    }
+  }
+}
+```
+
+With hot reload (recommended for customization):
+
+```json
+{
+  "mcpServers": {
+    "crucible": {
+      "command": "mcpmon",
+      "args": ["--watch", "~/.crucible/", "--", "crucible-mcp"]
+    }
+  }
+}
+```
+
+## How It Works
+
+```
+Code → Detect Domain → Load Personas + Knowledge → Claude with YOUR patterns
+
+.sol file → web3 domain → security-engineer + SMART_CONTRACT.md → Knows your security rules
+```
+
+## MCP Tools
+
+| Tool | Purpose |
+|------|---------|
+| `review(path)` | Full review: analysis + skills + knowledge |
+| `review(mode='staged')` | Review git changes with skills + knowledge |
+| `load_knowledge(files)` | Load specific knowledge files |
+| `get_principles(topic)` | Load engineering knowledge by topic |
+| `delegate_*` | Direct tool access (semgrep, ruff, slither, bandit) |
+| `check_tools()` | Show installed analysis tools |
+
+The unified `review` tool supports:
+- **Path-based**: `review(path="src/")` - analyze files/directories
+- **Git-aware**: `review(mode="staged")` - analyze changes (staged, unstaged, branch, commits)
+- **Quick mode**: `review(path, include_skills=false)` - analysis only, no skills/knowledge
+
+## CLI
+
+```bash
+crucible init                     # Initialize .crucible/ for your project
+crucible review                   # Review staged changes
+crucible review --mode branch     # Review current branch vs main
+crucible ci generate              # Generate GitHub Actions workflow
+
+crucible skills list              # List all skills
+crucible skills init <skill>      # Copy to .crucible/ for customization
+
+crucible knowledge list           # List all knowledge files
+crucible knowledge init <file>    # Copy for customization
+
+crucible hooks install            # Install pre-commit hook
+```
+
+See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for the full flow.
+
+## Customization
+
+Override skills and knowledge for your project or personal preferences:
+
+```bash
+# Customize a skill for your project
+crucible skills init security-engineer
+# Creates .crucible/skills/security-engineer/SKILL.md
+
+# Add project-specific concerns, team conventions, etc.
+```
+
+Resolution order (first found wins):
+1. `.crucible/` — Project overrides
+2. `~/.claude/crucible/` — User preferences
+3. Bundled — Package defaults
+
+See [CUSTOMIZATION.md](docs/CUSTOMIZATION.md) for the full guide.
+
+## What's Included
+
+**18 Personas** — Domain-specific thinking: security, performance, accessibility, web3, backend, and more.
+
+See [SKILLS.md](docs/SKILLS.md) for the full list.
+
+**12 Knowledge Files** — Coding patterns and principles for security, testing, APIs, databases, smart contracts, etc.
+
+See [KNOWLEDGE.md](docs/KNOWLEDGE.md) for topics covered.
+
+## Documentation
+
+| Doc | What's In It |
+|-----|--------------|
+| [FEATURES.md](docs/FEATURES.md) | Complete feature reference |
+| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | How MCP, tools, skills, and knowledge fit together |
+| [CUSTOMIZATION.md](docs/CUSTOMIZATION.md) | Override skills and knowledge for your project |
+| [SKILLS.md](docs/SKILLS.md) | All 18 personas with triggers and focus areas |
+| [KNOWLEDGE.md](docs/KNOWLEDGE.md) | All 12 knowledge files with topics covered |
+| [CONTRIBUTING.md](docs/CONTRIBUTING.md) | Adding tools, skills, and knowledge |
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                    # Run tests (509 tests)
+ruff check src/ --fix     # Lint
+```

{crucible_mcp-0.1.0 → crucible_mcp-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "crucible-mcp"
-version = "0.1.0"
+version = "0.3.0"
 description = "Code review MCP server for Claude. Not affiliated with Atlassian."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -49,3 +49,4 @@ warn_unused_ignores = true
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 testpaths = ["tests"]
+markers = ["integration: marks tests as integration tests (deselect with '-m \"not integration\"')"]