synapsexcoder 6.0.0

package/.opencode/opencode.jsonc

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  
+  // === SynapseXcoder Plugin for OpenCode ===
+  // All 13 SynapseXcoder V6 agents. Only synapse-* agents are used — no built-in OpenCode agents.
+  
+  // === AGENTS ===
+  "agent": {
+    // ── Primary Orchestrator ──
+    "synapse-master": {
+      "prompt": "opencode-agents/synapse-master.md"
+    },
+    
+    // ── Core Pipeline Agents ──
+    "synapse-planner": {
+      "prompt": "opencode-agents/synapse-planner.md"
+    },
+    "synapse-analyzer": {
+      "prompt": "opencode-agents/synapse-analyzer.md"
+    },
+    "synapse-reviewer": {
+      "prompt": "opencode-agents/synapse-reviewer.md"
+    },
+    "synapse-rewriter": {
+      "prompt": "opencode-agents/synapse-rewriter.md"
+    },
+    "synapse-ui-designer": {
+      "prompt": "opencode-agents/synapse-ui-designer.md"
+    },
+    "synapse-researcher": {
+      "prompt": "opencode-agents/synapse-researcher.md"
+    },
+    
+    // ── Quality & Strategy Agents ──
+    "synapse-strategist": {
+      "prompt": "opencode-agents/synapse-strategist.md"
+    },
+    "synapse-gatekeeper": {
+      "prompt": "opencode-agents/synapse-gatekeeper.md"
+    },
+    "synapse-verifier": {
+      "prompt": "opencode-agents/synapse-verifier.md"
+    },
+    
+    // ── Error Handling & Validation Agents ──
+    "synapse-debugger": {
+      "prompt": "opencode-agents/synapse-debugger.md"
+    },
+    "synapse-diff-validator": {
+      "prompt": "opencode-agents/synapse-diff-validator.md"
+    },
+    "synapse-test-runner": {
+      "prompt": "opencode-agents/synapse-test-runner.md"
+    },
+    
+    // ── Background Worker (project infrastructure, not a synapse agent) ──
+    "background-worker": {
+      "permission": {
+        "bash": { "*": "deny" },
+        "edit": "deny",
+        "write": "deny"
+      }
+    }
+  },
+  
+  // === PERMISSIONS ===
+  "permission": {
+    "edit": "ask",
+    "bash": "allow",
+    "task": "deny",
+    "context7_*": "deny",
+    "exa_*": "deny",
+    "gh_grep_*": "deny",
+    "kagi_*": "deny",
+    "webfetch": "deny",
+    "worktree_*": "deny"
+  },
+  
+  // === MCP SERVERS ===
+  "mcp": {
+    "context7": {
+      "type": "remote",
+      "url": "https://mcp.context7.com/mcp",
+      "enabled": true
+    },
+    "exa": {
+      "type": "remote",
+      "url": "https://mcp.exa.ai/mcp",
+      "enabled": true
+    },
+    "gh_grep": {
+      "type": "remote",
+      "url": "https://mcp.grep.app",
+      "enabled": true
+    }
+  },
+  
+  // === INSTRUCTIONS ===
+  "instructions": [
+    "./tools/philosophy.md"
+  ]
+}

package/README.md

@@ -0,0 +1,353 @@
+# SynapseXcoder V6 - Multi-Agent OpenCode Integration
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                    🦆 SynapseXcoder AI System — Synapse V5                  ║
+║                  Multi-Agent OpenCode Integration Edition                  ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+```
+
+## Overview
+
+SynapseXcoder V5 transforms the monolithic single-agent architecture into a **distributed multi-agent system** powered by OpenCode CLI. A master orchestration agent leads specialized sub-agents, each responsible for a specific phase of the processing pipeline.
+
+## Key Features
+
+- **Multi-Agent Architecture**: Master agent orchestrates specialized sub-agents
+- **OpenCode CLI Integration**: Native tool calling for file operations, bash, web, and MCP
+- **Phase-Based Processing**: Dedicated agents for Planning, Analysis, Review, Rewrite, UI Design
+- **CLI Command Suite**: Unified command interface for all operations
+- **Inter-Agent Communication**: Message bus for agent coordination
+- **Flexible Configuration**: YAML-based config with per-agent settings
+- **Team Collaboration**: Multi-user sessions, shared repositories, and activity tracking
+- **Plugin System**: Extensible architecture for custom agents, commands, and tools
+- **Token Optimization**: Intelligent context compression and MVI pattern learning
+- **CLI Distribution**: Package and distribute agents/commands as standalone CLI tools
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                           SYNAPSEXCODER V6 SYSTEM                             │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  ┌─────────────────────────────────────────────────────────────────────┐   │
+│  │                      🦆 MASTER AGENT (Orchestrator)                  │   │
+│  │   • Receives user input                                              │   │
+│  │   • Creates execution plan                                           │   │
+│  │   • Spawns/manages sub-agents                                        │   │
+│  │   • Synthesizes final output                                         │   │
+│  └──────────────────────────┬──────────────────────────────────────────┘   │
+│                              │                                              │
+│              ┌───────────────┼───────────────┐                             │
+│              ▼               ▼               ▼                             │
+│  ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐         │
+│  │  🗺️ PLANNER      │ │ 🔍 ANALYZER      │ │ 🔵 REVIEWER       │         │
+│  │  - Task outline   │ │ - Syntax check   │ │ - Explain fixes   │         │
+│  │  - Dependencies   │ │ - Logic scan     │ │ - Justify changes │         │
+│  └──────────────────┘ └──────────────────┘ └──────────────────┘         │
+│              │               │               │                             │
+│              ▼               ▼               ▼                             │
+│  ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐         │
+│  │ 🟣 REWRITER      │ │ 🎨 UI DESIGNER   │ │ 🌐 RESEARCHER    │         │
+│  │  - Apply fixes   │ │  - Mockup gen    │ │  - Web search    │         │
+│  │  - Optimize code │ │  - Design insp   │ │  - Fact verify   │         │
+│  └──────────────────┘ └──────────────────┘ └──────────────────┘         │
+│                                                                             │
+│  ┌─────────────────────────────────────────────────────────────────────┐   │
+│  │                    OPENCODE CLI INTEGRATION LAYER                   │   │
+│  └─────────────────────────────────────────────────────────────────────┘   │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+## Installation
+
+### Automated Installation (Recommended)
+
+Run the automated installer which handles everything:
+
+```bash
+# Clone the repository
+git clone <repository-url>
+cd SynapseXcoder/Synapse/v5
+
+# Run the installer (handles Node.js, npm, OpenCode, build, and global CLI setup)
+./install.sh
+```
+
+The installer will:
+
+- Check for Node.js 20+ and npm
+- Install OpenCode CLI if missing
+- Install npm dependencies and build TypeScript
+- Register `synapse` as a global CLI command
+- Copy OpenCode agent configurations
+- Create default configuration files
+
+### Manual Installation
+
+If you prefer manual setup:
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Register CLI globally
+npm link
+
+# Copy OpenCode agents (run from project root)
+mkdir -p ~/.config/opencode/agents
+cp opencode-agents/*.md ~/.config/opencode/agents/
+cp opencode/opencode.json ~/.config/opencode/
+
+# Create config directory
+mkdir -p ~/.synapsexcoder
+# (config.yaml will be created on first run)
+```
+
+### CLI Registration
+
+The `package.json` includes a `bin` field that registers the `synapse` command:
+
+```json
+{
+  "bin": {
+    "synapse": "dist/cli/index.js"
+  }
+}
+```
+
+After installation, `synapse` will be available globally in your terminal.
+
+## Quick Start
+
+```bash
+# Process a file with full pipeline
+synapse process ./src/main.py
+
+# Analyze without modifications
+synapse analyze ./src/main.py
+
+# List available agents
+synapse agent list
+
+# Check OpenCode tools
+synapse opencode tools
+
+# Merge files
+synapse merge file1.py file2.py
+```
+
+## CLI Commands
+
+### Core Commands
+
+| Command                 | Description                         |
+| ----------------------- | ----------------------------------- |
+| `synapse process <input>` | Process input with full pipeline    |
+| `synapse analyze <input>` | Analyze input without modifications |
+| `synapse merge <inputs>`  | Merge multiple inputs               |
+| `synapse rewrite <input>` | Rewrite with fixes                  |
+
+### Agent Commands
+
+| Command                    | Description           |
+| -------------------------- | --------------------- |
+| `synapse agent list`         | List available agents |
+| `synapse agent spawn <type>` | Spawn a new agent     |
+| `synapse agent status`       | Show agent status     |
+| `synapse agent kill <id>`    | Terminate an agent    |
+
+### OpenCode Commands
+
+| Command                | Description          |
+| ---------------------- | -------------------- |
+| `synapse opencode run`   | Run OpenCode command |
+| `synapse opencode serve` | Start server mode    |
+| `synapse opencode tools` | List available tools |
+
+### Context Commands
+
+| Command                     | Description          |
+| --------------------------- | -------------------- |
+| `synapse context save <name>` | Save current context |
+| `synapse context load <name>` | Load saved context   |
+| `synapse context show`        | Show current context |
+
+### Team Commands
+
+| Command                     | Description                  |
+| --------------------------- | ---------------------------- |
+| `synapse team session <name>` | Create collaboration session |
+| `synapse team join <id>`      | Join existing session        |
+| `synapse team list`           | List active sessions         |
+
+### Plugin Commands
+
+| Command                     | Description            |
+| --------------------------- | ---------------------- |
+| `synapse plugin list`         | List installed plugins |
+| `synapse plugin enable <id>`  | Enable a plugin        |
+| `synapse plugin disable <id>` | Disable a plugin       |
+
+### Distribution Commands
+
+| Command                      | Description                 |
+| ---------------------------- | --------------------------- |
+| `synapse package create`       | Create distribution package |
+| `synapse package publish`      | Publish package to registry |
+| `synapse package install <id>` | Install a package           |
+
+## Processing Modes
+
+| Mode              | Description                                 |
+| ----------------- | ------------------------------------------- |
+| `full_pipeline`   | Complete merge → analyze → review → rewrite |
+| `merge_only`      | Combine inputs without analysis             |
+| `analyze_only`    | Analysis without modifications              |
+| `security_scan`   | Focused security analysis                   |
+| `debug_assistant` | Debugging assistance                        |
+| `ui_design`       | Mockup and design generation                |
+| `team_collab`     | Multi-user collaboration session            |
+| `plugin_dev`      | Plugin development and testing              |
+
+## Project Structure
+
+```
+v6/
+├── agents/              # Agent implementations
+│   └── base-agents.ts  # Master and sub-agent classes
+├── cli/                 # CLI implementation
+│   └── index.ts        # Command definitions
+├── messages/            # Inter-agent communication
+│   └── message-bus.ts  # Message bus implementation
+├── opencode/           # OpenCode integration
+│   └── tool-bridge.ts  # Tool calling bridge
+├── opencode-agents/    # OpenCode agent configs
+│   ├── synapse-master.md
+│   ├── synapse-planner.md
+│   ├── synapse-analyzer.md
+│   ├── synapse-reviewer.md
+│   ├── synapse-rewriter.md
+│   ├── synapse-ui-designer.md
+│   └── synapse-researcher.md
+├── src/
+│   ├── types/          # TypeScript types
+│   │   └── index.ts    # All shared types
+│   ├── commands/       # Workflow commands
+│   │   └── command-processor.ts
+│   ├── context/        # Context system
+│   │   └── context-system.ts
+│   ├── distribution/  # CLI distribution
+│   │   └── cli-distribution.ts
+│   ├── optimization/  # Token optimization
+│   │   └── token-optimizer.ts
+│   ├── plugins/        # Plugin system
+│   │   └── plugin-system.ts
+│   ├── team/           # Team collaboration
+│   │   └── team-collaboration.ts
+│   ├── thoughts/      # Knowledge management
+│   │   └── thoughts-manager.ts
+│   └── cli/            # CLI source
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## Configuration
+
+Configuration is stored in `~/.synapsexcoder/config.yaml`:
+
+```yaml
+version: "6.0.0"
+
+opencode:
+  mode: embedded
+  serverUrl: "http://localhost:4096"
+
+agents:
+  master:
+    model: anthropic/claude-opus-4-6
+    temperature: 0.2
+
+  planner:
+    model: anthropic/claude-haiku-4-20250514
+
+  analyzer:
+    model: anthropic/claude-sonnet-4-20250514
+
+plugins:
+  enabled: true
+  directory: "./plugins"
+
+team:
+  enabled: true
+  defaultSession: "main"
+
+tokenOptimization:
+  enabled: true
+  maxContextSize: 8000
+  compressionThreshold: 1000
+```
+
+## OpenCode Agent Configuration
+
+Agents are defined as Markdown files in `~/.config/opencode/agents/`:
+
+```yaml
+---
+description: Agent description
+mode: subagent
+temperature: 0.1
+permission:
+  edit: deny
+  bash: deny
+  webfetch: allow
+color: "#FFA500"
+---
+Agent prompt goes here...
+```
+
+> Note: Synapse agent files intentionally omit a hardcoded `model` field so each
+> agent inherits the user-selected model from the active prompt/session.
+
+## Development
+
+```bash
+# Run tests
+npm test
+
+# Lint code
+npm run lint
+
+# Lint agent permissions/frontmatter
+npm run lint:agents
+
+# Format code
+npm run format
+
+# Type check
+npx tsc --noEmit
+```
+
+## Roadmap
+
+- [x] Phase 1: Core Foundation ✓
+- [x] Phase 2: Agent Framework ✓
+- [x] Phase 3: CLI & Commands ✓
+- [x] Phase 4: OpenCode Agent Configs ✓
+- [ ] Phase 5: Testing & Polish
+- [x] Phase 6: Team Collaboration & Plugins ✓
+- [x] Phase 7: Token Optimization & CLI Distribution ✓
+
+## License
+
+MIT
+
+---
+
+Built with 🦆 by DuckyOnQuack-999

package/dist/agents/agent-config-manager.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Agent Configuration Manager - Markdown-based Agent Definitions
+ *
+ * Inspired by OpenAgentsControl's editable agents via markdown files.
+ * Allows defining and configuring agents through structured markdown.
+ */
+import type { AgentConfig, AgentType } from "../types/index.js";
+export interface MarkdownAgentDefinition {
+    id: string;
+    name: string;
+    type: AgentType;
+    description: string;
+    config: Partial<AgentConfig>;
+    prompts: {
+        system?: string;
+        task?: string;
+        examples?: Array<{
+            input: string;
+            output: string;
+            explanation?: string;
+        }>;
+    };
+    tools: string[];
+    behaviors: {
+        approvalRequired?: boolean;
+        contextAware?: boolean;
+        learningEnabled?: boolean;
+        maxIterations?: number;
+        temperature?: number;
+    };
+    metadata: {
+        author?: string;
+        version?: string;
+        tags?: string[];
+        created?: string;
+        updated?: string;
+    };
+}
+export declare class AgentConfigManager {
+    private agentsDir;
+    private agentDefinitions;
+    constructor(projectRoot: string);
+    private loadAgentDefinitions;
+    private parseAgentDefinition;
+    private parseSections;
+    private parseExamples;
+    getAgentDefinition(id: string): MarkdownAgentDefinition | undefined;
+    getAllAgentDefinitions(): MarkdownAgentDefinition[];
+    getAgentDefinitionsByType(type: AgentType): MarkdownAgentDefinition[];
+    createAgentDefinition(definition: Omit<MarkdownAgentDefinition, "id">): string;
+    updateAgentDefinition(id: string, updates: Partial<MarkdownAgentDefinition>): boolean;
+    deleteAgentDefinition(id: string): boolean;
+    private saveAgentDefinition;
+    private serializeAgentDefinition;
+    createAgentFromDefinition(definitionId: string, messageBus: any, toolBridge: any): any;
+}
+export declare function createAgentConfigManager(projectRoot: string): AgentConfigManager;
+//# sourceMappingURL=agent-config-manager.d.ts.map

package/dist/agents/agent-config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config-manager.d.ts","sourceRoot":"","sources":["../../src/agents/agent-config-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,KAAK,CAAC;YACf,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;YACf,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC,CAAC;KACJ,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE;QACT,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAmD;gBAE/D,WAAW,EAAE,MAAM;IAe/B,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,oBAAoB;IAmF5B,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,aAAa;IAsDrB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;IAInE,sBAAsB,IAAI,uBAAuB,EAAE;IAInD,yBAAyB,CAAC,IAAI,EAAE,SAAS,GAAG,uBAAuB,EAAE;IAIrE,qBAAqB,CACnB,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,IAAI,CAAC,GAC9C,MAAM;IAUT,qBAAqB,CACnB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACxC,OAAO;IAWV,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAuB1C,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,wBAAwB;IAgDhC,yBAAyB,CACvB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,GAAG,EACf,UAAU,EAAE,GAAG,GACd,GAAG;CAgBP;AAMD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAEpB"}