claude-mpm 4.1.13__py3-none-any.whl → 4.1.15__py3-none-any.whl

claude_mpm/VERSION

@@ -1 +1 @@
-4.1.13
+4.1.15

claude_mpm/agents/templates/ops.json

@@ -1,9 +1,14 @@
 {
   "schema_version": "1.2.0",
   "agent_id": "ops-agent",
-  "agent_version": "2.2.1",
-  "template_version": "2.1.0",
+  "agent_version": "2.2.2",
+  "template_version": "2.2.0",
   "template_changelog": [
+    {
+      "version": "2.2.0",
+      "date": "2025-08-29",
+      "description": "Added comprehensive git commit authority with mandatory security verification"
+    },
     {
       "version": "2.1.0",
       "date": "2025-08-25",
@@ -33,7 +38,7 @@
     ],
     "author": "Claude MPM Team",
     "created_at": "2025-07-27T03:45:51.476769Z",
-    "updated_at": "2025-08-22T12:00:00.000000Z",
+    "updated_at": "2025-08-29T12:00:00.000000Z",
     "color": "orange"
   },
   "capabilities": {
@@ -64,7 +69,7 @@
       ]
     }
   },
-  "instructions": "# Ops Agent\n\n**Inherits from**: BASE_AGENT_TEMPLATE.md\n**Focus**: Infrastructure automation and system operations\n\n## Core Expertise\n\nManage infrastructure, deployments, and system operations with a focus on reliability and automation. Handle CI/CD, monitoring, and operational excellence.\n\n## Ops-Specific Memory Management\n\n**Configuration Sampling**:\n- Extract patterns from config files, not full content\n- Use grep for environment variables and settings\n- Process deployment scripts sequentially\n- Sample 2-3 representative configs per service\n\n## Operations Protocol\n\n### Infrastructure Management\n```bash\n# Check system resources\ndf -h | head -10\nfree -h\nps aux | head -20\nnetstat -tlnp 2>/dev/null | head -10\n```\n\n### Deployment Operations\n```bash\n# Docker operations\ndocker ps --format \"table {{.Names}}\t{{.Status}}\t{{.Ports}}\"\ndocker images --format \"table {{.Repository}}\t{{.Tag}}\t{{.Size}}\"\n\n# Kubernetes operations (if applicable)\nkubectl get pods -o wide | head -20\nkubectl get services | head -10\n```\n\n### CI/CD Pipeline Management\n```bash\n# Check pipeline status\ngrep -r \"stage:\" .gitlab-ci.yml 2>/dev/null\ngrep -r \"jobs:\" .github/workflows/*.yml 2>/dev/null | head -10\n```\n\n## Operations Focus Areas\n\n- **Infrastructure**: Servers, containers, orchestration\n- **Deployment**: CI/CD pipelines, release management\n- **Monitoring**: Logs, metrics, alerts\n- **Security**: Access control, secrets management\n- **Performance**: Resource optimization, scaling\n- **Reliability**: Backup, recovery, high availability\n\n## Operations Categories\n\n### Infrastructure as Code\n- Terraform configurations\n- Ansible playbooks\n- CloudFormation templates\n- Kubernetes manifests\n\n### Monitoring & Observability\n- Log aggregation setup\n- Metrics collection\n- Alert configuration\n- Dashboard creation\n\n### Security Operations\n- Secret rotation\n- Access management\n- Security scanning\n- Compliance checks\n\n## Ops-Specific Todo Patterns\n\n**Infrastructure Tasks**:\n- `[Ops] Configure production deployment pipeline`\n- `[Ops] Set up monitoring for new service`\n- `[Ops] Implement auto-scaling rules`\n\n**Maintenance Tasks**:\n- `[Ops] Update SSL certificates`\n- `[Ops] Rotate database credentials`\n- `[Ops] Patch security vulnerabilities`\n\n**Optimization Tasks**:\n- `[Ops] Optimize container images`\n- `[Ops] Reduce infrastructure costs`\n- `[Ops] Improve deployment speed`\n\n## Operations Workflow\n\n### Phase 1: Assessment\n```bash\n# Check current state\ndocker-compose ps 2>/dev/null || docker ps\nsystemctl status nginx 2>/dev/null || service nginx status\ngrep -h \"ENV\" Dockerfile* 2>/dev/null | head -10\n```\n\n### Phase 2: Implementation\n```bash\n# Apply changes safely\n# Always backup before changes\n# Use --dry-run when available\n# Test in staging first\n```\n\n### Phase 3: Verification\n```bash\n# Verify deployments\ncurl -I http://localhost/health 2>/dev/null\ndocker logs app --tail=50 2>/dev/null\nkubectl rollout status deployment/app 2>/dev/null\n```\n\n## Ops Memory Categories\n\n**Pattern Memories**: Deployment patterns, config patterns\n**Architecture Memories**: Infrastructure topology, service mesh\n**Performance Memories**: Bottlenecks, optimization wins\n**Security Memories**: Vulnerabilities, security configs\n**Context Memories**: Environment specifics, tool versions\n\n## Operations Standards\n\n- **Automation**: Infrastructure as Code for everything\n- **Safety**: Always test in staging first\n- **Documentation**: Clear runbooks and procedures\n- **Monitoring**: Comprehensive observability\n- **Security**: Defense in depth approach",
+  "instructions": "# Ops Agent\n\n**Inherits from**: BASE_AGENT_TEMPLATE.md\n**Focus**: Infrastructure automation and system operations\n\n## Core Expertise\n\nManage infrastructure, deployments, and system operations with a focus on reliability and automation. Handle CI/CD, monitoring, and operational excellence.\n\n## Ops-Specific Memory Management\n\n**Configuration Sampling**:\n- Extract patterns from config files, not full content\n- Use grep for environment variables and settings\n- Process deployment scripts sequentially\n- Sample 2-3 representative configs per service\n\n## Operations Protocol\n\n### Infrastructure Management\n```bash\n# Check system resources\ndf -h | head -10\nfree -h\nps aux | head -20\nnetstat -tlnp 2>/dev/null | head -10\n```\n\n### Deployment Operations\n```bash\n# Docker operations\ndocker ps --format \"table {{.Names}}\t{{.Status}}\t{{.Ports}}\"\ndocker images --format \"table {{.Repository}}\t{{.Tag}}\t{{.Size}}\"\n\n# Kubernetes operations (if applicable)\nkubectl get pods -o wide | head -20\nkubectl get services | head -10\n```\n\n### CI/CD Pipeline Management\n```bash\n# Check pipeline status\ngrep -r \"stage:\" .gitlab-ci.yml 2>/dev/null\ngrep -r \"jobs:\" .github/workflows/*.yml 2>/dev/null | head -10\n```\n\n## Operations Focus Areas\n\n- **Infrastructure**: Servers, containers, orchestration\n- **Deployment**: CI/CD pipelines, release management\n- **Monitoring**: Logs, metrics, alerts\n- **Security**: Access control, secrets management\n- **Performance**: Resource optimization, scaling\n- **Reliability**: Backup, recovery, high availability\n\n## Operations Categories\n\n### Infrastructure as Code\n- Terraform configurations\n- Ansible playbooks\n- CloudFormation templates\n- Kubernetes manifests\n\n### Monitoring & Observability\n- Log aggregation setup\n- Metrics collection\n- Alert configuration\n- Dashboard creation\n\n### Security Operations\n- Secret rotation\n- Access management\n- Security scanning\n- Compliance checks\n\n## Ops-Specific Todo Patterns\n\n**Infrastructure Tasks**:\n- `[Ops] Configure production deployment pipeline`\n- `[Ops] Set up monitoring for new service`\n- `[Ops] Implement auto-scaling rules`\n\n**Maintenance Tasks**:\n- `[Ops] Update SSL certificates`\n- `[Ops] Rotate database credentials`\n- `[Ops] Patch security vulnerabilities`\n\n**Optimization Tasks**:\n- `[Ops] Optimize container images`\n- `[Ops] Reduce infrastructure costs`\n- `[Ops] Improve deployment speed`\n\n## Operations Workflow\n\n### Phase 1: Assessment\n```bash\n# Check current state\ndocker-compose ps 2>/dev/null || docker ps\nsystemctl status nginx 2>/dev/null || service nginx status\ngrep -h \"ENV\" Dockerfile* 2>/dev/null | head -10\n```\n\n### Phase 2: Implementation\n```bash\n# Apply changes safely\n# Always backup before changes\n# Use --dry-run when available\n# Test in staging first\n```\n\n### Phase 3: Verification\n```bash\n# Verify deployments\ncurl -I http://localhost/health 2>/dev/null\ndocker logs app --tail=50 2>/dev/null\nkubectl rollout status deployment/app 2>/dev/null\n```\n\n## Ops Memory Categories\n\n**Pattern Memories**: Deployment patterns, config patterns\n**Architecture Memories**: Infrastructure topology, service mesh\n**Performance Memories**: Bottlenecks, optimization wins\n**Security Memories**: Vulnerabilities, security configs\n**Context Memories**: Environment specifics, tool versions\n\n## Git Commit Authority\n\nThe Ops agent has full authority to make git commits for infrastructure, deployment, and operational changes with mandatory security verification.\n\n### Pre-Commit Security Protocol\n\n**MANDATORY**: Before ANY git commit, you MUST:\n1. Run security scans to detect secrets/keys\n2. Verify no sensitive data in staged files\n3. Check for hardcoded credentials\n4. Ensure environment variables are externalized\n\n### Security Verification Commands\n\nAlways run these checks before committing:\n```bash\n# 1. Use existing security infrastructure\nmake quality  # Runs bandit and other security checks\n\n# 2. Additional secret pattern detection\n# Check for API keys and tokens\nrg -i \"(api[_-]?key|token|secret|password)\\s*[=:]\\s*['\\\"][^'\\\"]{10,}\" --type-add 'config:*.{json,yaml,yml,toml,ini,env}' -tconfig -tpy\n\n# Check for AWS keys\nrg \"AKIA[0-9A-Z]{16}\" .\n\n# Check for private keys\nrg \"-----BEGIN (RSA |EC |OPENSSH |DSA |)?(PRIVATE|SECRET) KEY-----\" .\n\n# Check for high-entropy strings (potential secrets)\nrg \"['\\\"][A-Za-z0-9+/]{40,}[=]{0,2}['\\\"]\" --type-add 'config:*.{json,yaml,yml,toml,ini}' -tconfig\n\n# 3. Verify no large binary files\nfind . -type f -size +1000k -not -path \"./.git/*\" -not -path \"./node_modules/*\"\n```\n\n### Git Commit Workflow\n\n1. **Stage Changes**:\n   ```bash\n   git add <specific-files>  # Prefer specific files over git add .\n   ```\n\n2. **Security Verification**:\n   ```bash\n   # Run full security scan\n   make quality\n   \n   # If make quality not available, run manual checks\n   git diff --cached --name-only | xargs -I {} sh -c 'echo \"Checking {}\" && rg -i \"password|secret|token|api.key\" {} || true'\n   ```\n\n3. **Commit with Structured Message**:\n   ```bash\n   git commit -m \"type(scope): description\n   \n   - Detail 1\n   - Detail 2\n   \n   🤖 Generated with [Claude Code](https://claude.ai/code)\n   \n   Co-Authored-By: Claude <noreply@anthropic.com>\"\n   ```\n\n### Prohibited Patterns\n\n**NEVER commit files containing**:\n- Hardcoded passwords: `password = \"actual_password\"`\n- API keys: `api_key = \"sk-...\"`\n- Private keys: `-----BEGIN PRIVATE KEY-----`\n- Database URLs with credentials: `postgresql://user:pass@host`\n- AWS/Cloud credentials: `AKIA...` patterns\n- JWT tokens: `eyJ...` patterns\n- .env files with actual values (use .env.example instead)\n\n### Security Response Protocol\n\nIf secrets are detected:\n1. **STOP** - Do not proceed with commit\n2. **Remove** - Clean the sensitive data\n3. **Externalize** - Move to environment variables\n4. **Document** - Update .env.example with placeholders\n5. **Verify** - Re-run security checks\n6. **Commit** - Only after all checks pass\n\n### Commit Types (Conventional Commits)\n\nUse these prefixes for infrastructure commits:\n- `feat:` New infrastructure features\n- `fix:` Infrastructure bug fixes\n- `perf:` Performance improvements\n- `refactor:` Infrastructure refactoring\n- `docs:` Documentation updates\n- `chore:` Maintenance tasks\n- `ci:` CI/CD pipeline changes\n- `build:` Build system changes\n- `revert:` Revert previous commits\n\n## Operations Standards\n\n- **Automation**: Infrastructure as Code for everything\n- **Safety**: Always test in staging first\n- **Documentation**: Clear runbooks and procedures\n- **Monitoring**: Comprehensive observability\n- **Security**: Defense in depth approach",
   "knowledge": {
     "domain_expertise": [
       "Docker and container orchestration",
@@ -131,7 +136,9 @@
       "Deployment patterns and rollback procedures",
       "Infrastructure configurations",
       "Monitoring and alerting strategies",
-      "CI/CD pipeline requirements"
+      "CI/CD pipeline requirements",
+      "Git commit protocols and security verification",
+      "Security scanning patterns and secret detection"
     ],
     "keywords": [
       "deployment",
@@ -150,7 +157,9 @@
       "grafana",
       "aws",
       "azure",
-      "gcp"
+      "gcp",
+      "git commit protocols",
+      "security scanning patterns"
     ]
   },
   "dependencies": {

claude_mpm/commands/__init__.py

@@ -0,0 +1,14 @@
+"""
+Commands package for Claude MPM.
+
+This module contains command documentation files (Markdown) that are accessed
+via importlib.resources.path() for command help and reference material.
+
+This __init__.py file is required to make this directory recognizable as a
+Python package by setuptools, which is necessary for proper distribution
+and importlib resource access in installed packages.
+
+Without this file, importlib.resources.path("claude_mpm", "commands") would
+fail in the distributed package, even though it works in development when
+the package is installed in editable mode.
+"""

claude_mpm/commands/mpm-agents.md

@@ -0,0 +1,12 @@
+# Show available agents and their versions
+
+Show all available Claude MPM agents with their versions and deployment status.
+
+This command displays:
+- Agent names and descriptions
+- Version information
+- Tool availability
+- Model preferences
+- Deployment status
+
+Usage: /mpm-agents

claude_mpm/commands/mpm-config.md

@@ -0,0 +1,18 @@
+# View or modify claude-mpm configuration
+
+Manage Claude MPM configuration settings.
+
+Usage: /mpm-config [key] [value]
+
+Examples:
+- /mpm-config - Show all configuration
+- /mpm-config list - List all configuration keys
+- /mpm-config set logging debug - Set logging level to debug
+- /mpm-config get websocket-port - Get WebSocket port setting
+
+Configuration categories:
+- logging: Logging levels and output
+- websocket: WebSocket server settings
+- hooks: Hook service configuration
+- memory: Memory system settings
+- agents: Agent deployment options

claude_mpm/commands/mpm-doctor.md

@@ -0,0 +1,24 @@
+# Run diagnostic checks on claude-mpm installation
+
+Run comprehensive diagnostic checks on your Claude MPM installation to identify and fix common issues.
+
+This command checks:
+- Installation integrity
+- Configuration validity
+- WebSocket connectivity
+- Agent deployment status
+- Memory system health
+- Hook service status
+
+Usage: /mpm-doctor [options]
+
+Options:
+- --verbose: Show detailed output
+- --no-color: Disable colored output  
+- --checks [list]: Run specific checks only
+- --fix: Attempt to fix identified issues
+
+Examples:
+- /mpm-doctor
+- /mpm-doctor --verbose
+- /mpm-doctor --fix

claude_mpm/commands/mpm-help.md

@@ -0,0 +1,10 @@
+# Show help for available MPM commands
+
+Display help information for Claude MPM commands.
+
+Usage: /mpm-help [command]
+
+Examples:
+- /mpm-help - Show all MPM commands
+- /mpm-help doctor - Show detailed help for doctor command
+- /mpm-help agents - Show detailed help for agents command

claude_mpm/commands/mpm-status.md

@@ -0,0 +1,13 @@
+# Show claude-mpm status and environment
+
+Display the current status of Claude MPM including environment information, active services, and system health.
+
+This command shows:
+- Claude MPM version
+- Python environment
+- Active services (WebSocket, Hook Service, etc.)
+- Memory usage
+- Agent deployment status
+- Configuration summary
+
+Usage: /mpm-status

claude_mpm/commands/mpm-tickets.md

@@ -0,0 +1,102 @@
+# mpm-tickets
+
+Create and manage tickets using aitrackdown
+
+## Usage
+
+Use this command to create and manage tickets (epics, issues, tasks) through aitrackdown CLI integration.
+
+## Commands
+
+### Create tickets
+```bash
+# Create an epic
+aitrackdown create epic "Title" --description "Description"
+
+# Create an issue  
+aitrackdown create issue "Title" --description "Description"
+
+# Create a task
+aitrackdown create task "Title" --description "Description"
+
+# Create task under an issue
+aitrackdown create task "Title" --issue ISS-0001
+```
+
+### View tickets
+```bash
+# Show all tasks
+aitrackdown status tasks
+
+# Show specific ticket
+aitrackdown show ISS-0001
+```
+
+### Update tickets
+```bash
+# Change status
+aitrackdown transition ISS-0001 in-progress
+aitrackdown transition ISS-0001 done
+
+# Add comment
+aitrackdown comment ISS-0001 "Your comment"
+```
+
+### Search tickets
+```bash
+aitrackdown search tasks "keyword"
+```
+
+## Ticket Types
+
+- **EP-XXXX**: Epics (major initiatives)
+- **ISS-XXXX**: Issues (bugs, features, user requests)  
+- **TSK-XXXX**: Tasks (individual work items)
+
+## Workflow States
+
+Valid transitions:
+- `open` → `in-progress` → `ready` → `tested` → `done`
+- Any state → `waiting` (when blocked)
+- Any state → `closed` (to close)
+
+## Examples
+
+### Bug Report Flow
+```bash
+# Create issue for bug
+aitrackdown create issue "Login bug" --description "Users can't login" --severity high
+
+# Create investigation task
+aitrackdown create task "Investigate login bug" --issue ISS-0001
+
+# Update status
+aitrackdown transition TSK-0001 in-progress
+aitrackdown comment TSK-0001 "Found the issue"
+
+# Complete
+aitrackdown transition TSK-0001 done
+aitrackdown transition ISS-0001 done
+```
+
+### Feature Implementation
+```bash
+# Create epic
+aitrackdown create epic "OAuth2 Support"
+
+# Create issues
+aitrackdown create issue "Google OAuth2" --description "Add Google auth"
+aitrackdown create issue "GitHub OAuth2" --description "Add GitHub auth"
+
+# Create tasks
+aitrackdown create task "Design OAuth flow" --issue ISS-0001
+aitrackdown create task "Implement Google client" --issue ISS-0001
+```
+
+## Tips
+
+- Always use aitrackdown directly (not claude-mpm tickets)
+- Check ticket exists with `show` before updating
+- Add comments to document progress
+- Use `--severity` for bugs, `--priority` for features
+- Associate tasks with issues using `--issue`

claude_mpm/commands/mpm.md

@@ -0,0 +1,19 @@
+# Claude MPM - Multi-Agent Project Manager
+
+Access Claude MPM functionality and manage your multi-agent orchestration.
+
+Available MPM commands:
+- /mpm-agents - Show available agents and versions
+- /mpm-doctor - Run diagnostic checks
+- /mpm-help - Show command help
+- /mpm-status - Show MPM status
+- /mpm-config - Manage configuration
+
+Claude MPM extends Claude Code with:
+- Multi-agent orchestration
+- Project-specific PM instructions
+- Agent memory management
+- WebSocket monitoring
+- Hook system for automation
+
+For more information, use /mpm-help [command]

claude_mpm/dashboard/__init__.py

@@ -0,0 +1,12 @@
+"""
+Dashboard package for Claude MPM.
+
+This package contains the web-based dashboard components for Claude MPM,
+including the analysis runner, dashboard opener, and static web assets.
+
+The dashboard provides real-time monitoring, analysis visualization, and
+interactive debugging capabilities for Claude MPM operations.
+
+This __init__.py file is required to make this directory recognizable as a
+Python package by setuptools for proper distribution and imports.
+"""

claude_mpm/dashboard/static/css/activity.css

@@ -664,13 +664,13 @@ body .activity-tree-container .linear-tree .tree-node.tool.privileged-tool .tree
     color: #95A5A6;
 }
 
-/* Search Highlighting - Ensure this doesn't affect tools */
-.tree-node.search-match:not(.tool) {
+/* Search Highlighting - Specific to activity tree only */
+.activity-tree-container .tree-node.search-match:not(.tool) {
     background: #fff3cd !important;
     border-left-color: #ffc107 !important;
 }
 
-.tree-node.search-match:not(.tool) .tree-label {
+.activity-tree-container .tree-node.search-match:not(.tool) .tree-label {
     background: #ffecb5;
     padding: 2px 4px;
     border-radius: 3px;

claude_mpm/dashboard/static/css/code-tree.css

@@ -461,6 +461,13 @@
     position: relative;
     overflow: auto;
     box-shadow: 0 2px 4px rgba(0, 0, 0, 0.05);
+    border-left: 1px solid #e2e8f0;
+}
+
+/* Visual hierarchy improvements */
+.code-tree-container:focus-within {
+    box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
+    border-left-color: #3b82f6;
 }
 
 /* Loading indicator */
@@ -710,6 +717,78 @@
     filter: brightness(1.1);
 }
 
+/* Directory node styling - make expandable directories obvious */
+.code-node.directory circle {
+    fill: #f8fafc;
+    stroke: #3b82f6;
+    stroke-width: 2px;
+}
+
+.code-node.directory:hover circle {
+    fill: #eef2ff;
+    stroke: #2563eb;
+    stroke-width: 3px;
+    filter: drop-shadow(0 2px 4px rgba(59, 130, 246, 0.3));
+}
+
+/* Expanded directory styling */
+.code-node.directory.expanded circle {
+    fill: #dbeafe;
+    stroke: #1d4ed8;
+}
+
+/* File node styling */
+.code-node.file circle {
+    fill: #f9fafb;
+    stroke: #6b7280;
+    stroke-width: 1.5px;
+}
+
+.code-node.file:hover circle {
+    fill: #f3f4f6;
+    stroke: #4b5563;
+    stroke-width: 2px;
+}
+
+/* Empty directory styling */
+.code-node.directory.empty circle {
+    fill: #f9fafb;
+    stroke: #9ca3af;
+    stroke-dasharray: 3,3;
+    opacity: 0.7;
+}
+
+/* Directory expand/collapse icons */
+.expand-icon {
+    font-family: monospace;
+    font-size: 12px;
+    font-weight: bold;
+    text-anchor: middle;
+    dominant-baseline: central;
+    fill: #374151;
+    pointer-events: none;
+    transition: all 0.2s ease;
+}
+
+.code-node.directory .expand-icon {
+    fill: #3b82f6;
+}
+
+.code-node.directory.expanded .expand-icon {
+    fill: #1d4ed8;
+    transform: rotate(90deg);
+}
+
+.code-node.directory.loading .expand-icon {
+    fill: #f59e0b;
+    animation: spin 1s linear infinite;
+}
+
+@keyframes spin {
+    from { transform: rotate(0deg); }
+    to { transform: rotate(360deg); }
+}
+
 /* Visualization Controls */
 .viz-controls {
     position: absolute;
@@ -802,6 +881,31 @@
     fill: #ec4899;
 }
 
+/* Search match highlighting */
+.code-node.search-match circle {
+    stroke: #fbbf24 !important;
+    stroke-width: 3px;
+    fill: #fef3c7 !important;
+    filter: drop-shadow(0 0 8px rgba(251, 191, 36, 0.6));
+    animation: searchPulse 2s ease-in-out infinite;
+}
+
+.code-node.search-match text {
+    font-weight: bold;
+    fill: #92400e;
+}
+
+@keyframes searchPulse {
+    0%, 100% {
+        stroke-width: 3px;
+        opacity: 1;
+    }
+    50% {
+        stroke-width: 4px;
+        opacity: 0.8;
+    }
+}
+
 /* Collapsed node indicator */
 .code-node.collapsed circle {
     fill: #e2e8f0 !important;
@@ -851,6 +955,31 @@
     fill: #fef3c7 !important;
 }
 
+/* Enhanced loading states */
+.code-node.loading circle {
+    stroke: #f59e0b !important;
+    fill: #fef3c7 !important;
+    animation: nodePulse 1.5s ease-in-out infinite;
+}
+
+.code-node.loading text {
+    fill: #92400e;
+    font-weight: 600;
+}
+
+/* Directory item count badge */
+.item-count-badge {
+    font-size: 10px;
+    fill: #6b7280;
+    text-anchor: middle;
+    dominant-baseline: central;
+    font-weight: 500;
+}
+
+.code-node.directory:hover .item-count-badge {
+    fill: #374151;
+}
+
 /* Tooltips */
 .code-tooltip {
     position: absolute;
@@ -864,11 +993,115 @@
     z-index: 1000;
 }
 
+/* Tree control toolbar */
+.tree-controls-toolbar {
+    position: absolute;
+    top: 15px;
+    right: 15px;
+    display: flex;
+    gap: 8px;
+    z-index: 100;
+    background: rgba(255, 255, 255, 0.95);
+    backdrop-filter: blur(4px);
+    border: 1px solid #e5e7eb;
+    border-radius: 8px;
+    padding: 6px;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+}
+
+.tree-control-btn {
+    padding: 6px 10px;
+    font-size: 12px;
+    font-weight: 500;
+    border: 1px solid #d1d5db;
+    background: white;
+    color: #374151;
+    border-radius: 4px;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    display: flex;
+    align-items: center;
+    gap: 4px;
+    min-width: 32px;
+    justify-content: center;
+}
+
+.tree-control-btn:hover {
+    background: #f3f4f6;
+    border-color: #9ca3af;
+    transform: translateY(-1px);
+}
+
+.tree-control-btn:active {
+    transform: translateY(0);
+}
+
+.tree-control-btn.active {
+    background: linear-gradient(135deg, #3b82f6 0%, #2563eb 100%);
+    color: white;
+    border-color: #2563eb;
+    box-shadow: 0 2px 4px rgba(59, 130, 246, 0.3);
+}
+
+.tree-control-btn:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+    transform: none;
+}
+
+/* Breadcrumb navigation */
+.tree-breadcrumb {
+    position: absolute;
+    top: 15px;
+    left: 15px;
+    background: rgba(255, 255, 255, 0.95);
+    backdrop-filter: blur(4px);
+    border: 1px solid #e5e7eb;
+    border-radius: 8px;
+    padding: 6px 12px;
+    font-size: 12px;
+    color: #4b5563;
+    font-family: 'SF Mono', Monaco, 'Cascadia Code', monospace;
+    max-width: 400px;
+    z-index: 100;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+}
+
+.breadcrumb-path {
+    display: flex;
+    align-items: center;
+    gap: 4px;
+    font-weight: 500;
+}
+
+.breadcrumb-separator {
+    color: #9ca3af;
+    margin: 0 2px;
+}
+
+.breadcrumb-segment {
+    color: #374151;
+    cursor: pointer;
+    padding: 2px 4px;
+    border-radius: 3px;
+    transition: background 0.2s ease;
+}
+
+.breadcrumb-segment:hover {
+    background: rgba(59, 130, 246, 0.1);
+    color: #3b82f6;
+}
+
+.breadcrumb-segment.current {
+    color: #3b82f6;
+    font-weight: 600;
+}
+
 /* Code tree notifications */
 .code-tree-notification {
     position: absolute;
-    top: 10px;
-    right: 10px;
+    top: 70px;
+    right: 15px;
     padding: 12px 20px;
     border-radius: 6px;
     background: white;