didev 1.0.0

package/README.md

@@ -0,0 +1,378 @@
+# didev — AI-Powered Development CLI
+
+> Персональная команда AI-разработчиков прямо в вашем терминале.  
+> A specialized AI agent family for your codebase, powered by DeepSeek API.
+
+**Автор:** Симонов Михаил Сергеевич
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
+[![DeepSeek API](https://img.shields.io/badge/DeepSeek-API-cyan)](https://platform.deepseek.com)
+[![MCP Protocol](https://img.shields.io/badge/MCP-Protocol-green)](https://modelcontextprotocol.io)
+[![Node.js](https://img.shields.io/badge/Node.js-18+-brightgreen)](https://nodejs.org)
+
+---
+
+## What is didev?
+
+didev is a CLI tool that brings an entire team of specialized AI agents to your terminal. Unlike generic AI assistants, each agent in didev knows its role — frontend, backend, architecture, security, testing — and works in a coordinated pipeline to complete real development tasks.
+
+**Key difference from ChatGPT / Copilot:** didev reads your actual project files, understands your codebase structure, and agents pass context to each other — each building on the previous agent's work.
+
+---
+
+## Models
+
+| Model | Use case |
+|-------|----------|
+| `deepseek-v4-flash` *(default)* | Fast, 1M context window, 384K max output. Daily tasks. |
+| `deepseek-v4-pro` | Thinking model — complex architecture decisions |
+
+> **Note:** `deepseek-chat` and `deepseek-reasoner` aliases are deprecated as of 2026-07-24.
+
+---
+
+## Installation
+
+```bash
+npm install -g didev-cli
+```
+
+---
+
+## Quick Start
+
+```bash
+cd my-project
+didev init
+didev config set DEEPSEEK_API_KEY=sk-xxx
+didev agent "Add JWT authentication to Express API"
+didev chat
+```
+
+---
+
+## Commands
+
+### `didev init`
+Initialize didev in the current project. Auto-detects language, framework, and project type.
+
+```bash
+didev init                 # interactive
+didev init --frontend      # force frontend type
+didev init --backend
+didev init --fullstack
+didev init -y              # non-interactive
+```
+
+Creates `.didev/` with config, context file, sessions dir, and BMad dirs.
+
+---
+
+### `didev config`
+
+```bash
+didev config set DEEPSEEK_API_KEY=sk-xxx
+didev config set api.model=deepseek-v4-pro
+didev config set api.temperature=0.5
+didev config show
+```
+
+API key stored in `~/.didev/config.yaml` — never committed to the project.
+
+---
+
+### `didev chat`
+Interactive REPL with full project context.
+
+```bash
+didev chat
+didev chat -m deepseek-v4-pro
+didev chat -f src/api/routes.ts
+```
+
+**Slash commands:** `/files` `/add <path>` `/apply` `/save` `/load <id>` `/sessions` `/clear` `/exit`
+
+---
+
+### `didev agent`
+Run the multi-agent pipeline on a development task.
+
+```bash
+didev agent "Add Stripe payment integration"
+didev agent --type frontend "Build a responsive dashboard"
+didev agent --mode light "Fix the login bug"
+didev agent --mode developer-only "Add input validation"
+didev agent --skip Tester "Quick feature"
+```
+
+**Orchestration modes:**
+| Mode | Pipeline |
+|------|----------|
+| `full` | Analyst → Architect → Developer → [Reviewer ∥ Tester] |
+| `light` | Analyst → Developer → Reviewer |
+| `developer-only` | Developer only |
+
+> В режиме `full` стадия Reviewer и Tester выполняется **параллельно** — это сокращает общее время пайплайна.
+
+---
+
+### `didev review`
+
+```bash
+didev review               # review git diff
+didev review --all         # all source files
+didev review --file src/api.ts
+didev review --pr          # vs main branch
+```
+
+---
+
+### `didev refactor`
+
+```bash
+didev refactor "Extract service layer from controllers"
+didev refactor --auto
+didev refactor --dry-run "Rename userId to user_id"
+```
+
+---
+
+### `didev mcp`
+Manage MCP (Model Context Protocol) servers. Connected tools become available to all agents and chat.
+
+```bash
+# From GitHub / GitLab / Bitbucket (clones, installs, builds)
+didev mcp add https://github.com/owner/repo.git
+didev mcp add https://gitlab.com/owner/repo.git
+didev mcp add https://bitbucket.org/owner/repo.git
+
+# From npm
+didev mcp add @modelcontextprotocol/server-filesystem
+
+# Interactive wizard
+didev mcp add
+
+didev mcp list
+didev mcp test
+didev mcp remove my-server
+```
+
+**`didev mcp add <git-url>` flow:**
+1. Clones repo to `~/.didev/mcp/<name>/`
+2. Detects Node.js / Python
+3. `npm install` + `npm run build` (or `pip install`)
+4. Detects entry point automatically
+5. Reads README → finds required env vars
+6. Private repo? → prompts for GitHub/GitLab token or Bitbucket credentials
+7. Credentials saved to `.didev/.env` (gitignored); config stores `${VAR}` references
+8. Tests MCP connection, lists available tools
+9. Saves to `.didev/config.yaml`
+
+---
+
+### `didev bmad`
+BMad Method — Behavior-Motivated Agile Development.
+
+```bash
+didev bmad init
+didev bmad epic
+didev bmad story
+didev bmad implement
+didev bmad review
+```
+
+---
+
+## Agent Families
+
+### Why specialized agents?
+Each agent has a focused system prompt optimized for its role. A frontend agent doesn't need to reason about database internals. A security auditor doesn't write React components. Specialization produces significantly better output than one generic "do everything" agent.
+
+Think of it like a craftsman's workshop: each wall holds tools for a specific trade. The carpenter's wall has chisels and planes; the electrician's wall has testers and crimpers. The master (Orchestrator) knows which specialist to engage and when.
+
+### Frontend Family
+| Agent | Specialty |
+|-------|-----------|
+| FrontendAnalyst | UX requirements, component design |
+| FrontendArchitect | State management, component architecture |
+| FrontendDeveloper | React, CSS, TypeScript implementation |
+| Reviewer | Code quality, accessibility |
+| Tester | RTL tests, Playwright |
+
+### Backend Family
+| Agent | Specialty |
+|-------|-----------|
+| BackendAnalyst | API design, data modeling |
+| BackendArchitect | Service architecture, DB schema |
+| BackendDeveloper | Node.js, Express, DB implementation |
+| SecurityAuditor | OWASP, auth review |
+| Reviewer | Error handling, code quality |
+| Tester | Unit + integration tests |
+
+### Fullstack Family
+Analyst → Architect → Developer → Reviewer → Tester (cross-cutting)
+
+---
+
+## MCP Integration
+
+MCP tools are namespaced as `serverName__toolName` to avoid conflicts:
+```
+github__create_issue
+postgres__query
+filesystem__read_file
+```
+
+### Popular servers
+
+| Server | Command |
+|--------|---------|
+| Filesystem | `didev mcp add @modelcontextprotocol/server-filesystem` |
+| GitHub | `didev mcp add @modelcontextprotocol/server-github` |
+| PostgreSQL | `didev mcp add https://github.com/Neovaryag/mcp-pgs-tool.git` |
+| Java CVE scanner | `didev mcp add https://github.com/Neovaryag/java-vuln-remediation.git` |
+| Brave Search | `didev mcp add @modelcontextprotocol/server-brave-search` |
+| Memory | `didev mcp add @modelcontextprotocol/server-memory` |
+
+---
+
+## Project Structure
+
+```
+.didev/
+  config.yaml      # project config (commit this, no secrets inside)
+  context.md       # project context for AI (commit this)
+  .env             # MCP credentials (gitignored)
+  sessions/        # chat history (gitignored)
+  bmad/            # epics, stories, architecture docs
+
+~/.didev/
+  config.yaml      # global config — API key lives here
+  .env             # global git credentials for private MCP repos
+  mcp/             # globally cloned MCP servers
+```
+
+---
+
+## Security Model
+
+| What | Where stored | Committed? |
+|------|-------------|------------|
+| DeepSeek API key | `~/.didev/config.yaml` or env var | Never |
+| MCP env vars (DB URL, tokens) | `.didev/.env` | No (gitignored) |
+| Git tokens for private MCP repos | `~/.didev/.env` | No |
+| Project config | `.didev/config.yaml` with `${VAR}` placeholders | Yes |
+
+---
+
+## Configuration Reference
+
+```yaml
+# .didev/config.yaml
+api:
+  provider: deepseek
+  apiKey: ${DEEPSEEK_API_KEY}
+  model: deepseek-v4-flash
+  maxTokens: 32768
+  temperature: 0.3
+  baseUrl: https://api.deepseek.com/v1
+
+context:
+  maxFiles: 100
+  maxTokens: 128000
+  autoDiscover: true
+  excludePatterns: [node_modules/**, dist/**, .git/**, "*.lock"]
+
+agents:
+  family: full        # full | light | developer-only
+  orchestrate: true
+  reviewRequired: true
+  autoApply: false    # prompt before writing files
+
+mcp:
+  servers:
+    - name: postgres
+      command: node
+      args: [/home/user/.didev/mcp/mcp-pgs-tool/dist/index.js]
+      env:
+        DATABASE_URL: ${DATABASE_URL}
+```
+
+---
+
+## Getting DeepSeek API Key & Billing
+
+1. Go to **[platform.deepseek.com](https://platform.deepseek.com)**
+2. Sign up / log in
+3. **API Keys** → Create new secret key → copy it
+4. **Billing** → Top up balance (minimum ~$5)
+5. Set the key:
+   ```bash
+   didev config set DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
+   ```
+
+**Pricing** (2026):
+- `deepseek-v4-flash`: ~$0.27 / 1M input tokens · ~$1.10 / 1M output tokens
+- Context window: **1,000,000 tokens**
+- Max output per response: **384,000 tokens**
+
+DeepSeek API is 10–20× cheaper than OpenAI GPT-4o for equivalent tasks.
+
+---
+
+## Architecture
+
+```
+src/
+  index.ts              CLI entry (Commander.js) + graceful shutdown (SIGTERM/SIGINT)
+  core/
+    api.ts              DeepSeek client (chat, stream, tool loop) — with retry + timeout
+    config.ts           Config load/save (global + local merge)
+    context.ts          Project detection + file loading
+    file-manager.ts     Read/write/diff — path validation, 10MB limit
+    mcp.ts              MCP manager (connect, call, tool namespacing) — with timeout
+    session.ts          Chat session persistence
+  agents/
+    base-agent.ts       BaseAgent abstract class + MCP integration
+    analyst.ts          Analyst variants
+    architect.ts        Architect variants
+    developer.ts        Developer variants
+    reviewer.ts         Reviewer + SecurityAuditor
+    tester.ts           Tester + PerformanceAuditor
+    orchestrator.ts     Pipeline builder + execution (parallel review phase)
+  cli/commands/
+    init.ts             didev init
+    config.ts           didev config
+    chat.ts             didev chat (REPL + MCP)
+    agent.ts            didev agent
+    review.ts           didev review
+    refactor.ts         didev refactor
+    mcp.ts              didev mcp (add/list/test/remove)
+  bmad/method.ts        BMad workflow
+  utils/
+    logger.ts           Styled output (chalk, ora, boxen)
+    git.ts              Git diff helpers — with timeout
+    resilience.ts       withTimeout + retryWithBackoff utilities
+```
+
+---
+
+## Отказоустойчивость
+
+didev реализует несколько уровней защиты от сбоев:
+
+| Механизм | Где применяется | Детали |
+| -------- | --------------- | ------- |
+| **Таймауты** | API запросы, MCP, git | 30s на HTTP, 60s на stream-чанк, 10s на MCP connect, 15s на git |
+| **Retry с backoff** | DeepSeek API | 3 попытки, экспоненциальный backoff + jitter, только транзитные ошибки |
+| **Graceful shutdown** | SIGTERM / SIGINT | Закрывает MCP серверы, 5s на очистку, затем force exit |
+| **Параллельный review** | Orchestrator full mode | Reviewer + Tester запускаются одновременно |
+| **Лимит файлов** | file-manager | Отказ записи если файл >10MB |
+| **Безопасные пути** | file-manager | path.normalize(), блок `../` traversal |
+| **Логирование ошибок** | config, context, session | Все `catch` логируют через `logger.warn/debug` |
+
+---
+
+## License
+
+MIT — Симонов Михаил Сергеевич, 2026

package/dist/agents/analyst.d.ts

@@ -0,0 +1,21 @@
+import { BaseAgent } from './base-agent.js';
+import type { ProjectContext } from '../core/context.js';
+export declare class AnalystAgent extends BaseAgent {
+    readonly name = "Analyst";
+    readonly role = "Requirements Analysis";
+    readonly emoji = "\uD83C\uDFAF";
+    protected buildSystemPrompt(ctx: ProjectContext, task: string): string;
+}
+export declare class FrontendAnalystAgent extends BaseAgent {
+    readonly name = "Frontend Analyst";
+    readonly role = "Frontend Requirements & User Stories";
+    readonly emoji = "\uD83C\uDFAF";
+    protected buildSystemPrompt(ctx: ProjectContext, task: string): string;
+}
+export declare class BackendAnalystAgent extends BaseAgent {
+    readonly name = "Backend Analyst";
+    readonly role = "Backend Requirements & API Contracts";
+    readonly emoji = "\uD83C\uDFAF";
+    protected buildSystemPrompt(ctx: ProjectContext, task: string): string;
+}
+//# sourceMappingURL=analyst.d.ts.map

package/dist/agents/analyst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst.d.ts","sourceRoot":"","sources":["../../src/agents/analyst.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,IAAI,2BAA2B;IACxC,QAAQ,CAAC,KAAK,kBAAQ;IAEtB,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;CAqBvE;AAED,qBAAa,oBAAqB,SAAQ,SAAS;IACjD,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,IAAI,0CAA0C;IACvD,QAAQ,CAAC,KAAK,kBAAQ;IAEtB,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;CAevE;AAED,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,IAAI,0CAA0C;IACvD,QAAQ,CAAC,KAAK,kBAAQ;IAEtB,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;CAevE"}

package/dist/agents/analyst.js

@@ -0,0 +1,69 @@
+import { BaseAgent } from './base-agent.js';
+import { contextToSystemPrompt } from '../core/context.js';
+export class AnalystAgent extends BaseAgent {
+    name = 'Analyst';
+    role = 'Requirements Analysis';
+    emoji = '🎯';
+    buildSystemPrompt(ctx, task) {
+        return `You are an expert Software Analyst specializing in requirements analysis and user story creation.
+
+${contextToSystemPrompt(ctx)}
+
+Your responsibilities:
+1. Analyze the given task thoroughly
+2. Break it down into clear user stories with acceptance criteria
+3. Identify edge cases and potential risks
+4. Define clear success metrics
+5. Consider the existing codebase architecture
+
+Output format:
+- Start with a brief task analysis
+- Create user stories in format: "As a <role>, I want <feature>, so that <benefit>"
+- List Acceptance Criteria (AC) for each story
+- Identify dependencies and risks
+- Suggest the implementation order
+
+Be practical and specific to the project context. Read existing code when needed.`;
+    }
+}
+export class FrontendAnalystAgent extends BaseAgent {
+    name = 'Frontend Analyst';
+    role = 'Frontend Requirements & User Stories';
+    emoji = '🎯';
+    buildSystemPrompt(ctx, task) {
+        return `You are an expert Frontend Analyst specializing in UI/UX requirements.
+
+${contextToSystemPrompt(ctx)}
+
+Your responsibilities:
+1. Analyze frontend requirements
+2. Define UI/UX acceptance criteria
+3. Identify required components and state changes
+4. Consider accessibility (a11y) requirements
+5. Define responsive design requirements
+
+Focus on: components needed, user interactions, state management, data flow.
+Read existing components to understand patterns used in the project.`;
+    }
+}
+export class BackendAnalystAgent extends BaseAgent {
+    name = 'Backend Analyst';
+    role = 'Backend Requirements & API Contracts';
+    emoji = '🎯';
+    buildSystemPrompt(ctx, task) {
+        return `You are an expert Backend Analyst specializing in API design and system requirements.
+
+${contextToSystemPrompt(ctx)}
+
+Your responsibilities:
+1. Analyze backend requirements
+2. Define API contracts (endpoints, request/response schemas)
+3. Identify data models and database changes
+4. Security considerations
+5. Performance requirements and SLAs
+
+Focus on: API design, data models, business logic, error handling, validation.
+Read existing code to understand current patterns and conventions.`;
+    }
+}
+//# sourceMappingURL=analyst.js.map

package/dist/agents/analyst.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyst.js","sourceRoot":"","sources":["../../src/agents/analyst.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,OAAO,YAAa,SAAQ,SAAS;IAChC,IAAI,GAAG,SAAS,CAAC;IACjB,IAAI,GAAG,uBAAuB,CAAC;IAC/B,KAAK,GAAG,IAAI,CAAC;IAEZ,iBAAiB,CAAC,GAAmB,EAAE,IAAY;QAC3D,OAAO;;EAET,qBAAqB,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;kFAgBsD,CAAC;IACjF,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACxC,IAAI,GAAG,kBAAkB,CAAC;IAC1B,IAAI,GAAG,sCAAsC,CAAC;IAC9C,KAAK,GAAG,IAAI,CAAC;IAEZ,iBAAiB,CAAC,GAAmB,EAAE,IAAY;QAC3D,OAAO;;EAET,qBAAqB,CAAC,GAAG,CAAC;;;;;;;;;;qEAUyC,CAAC;IACpE,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IACvC,IAAI,GAAG,iBAAiB,CAAC;IACzB,IAAI,GAAG,sCAAsC,CAAC;IAC9C,KAAK,GAAG,IAAI,CAAC;IAEZ,iBAAiB,CAAC,GAAmB,EAAE,IAAY;QAC3D,OAAO;;EAET,qBAAqB,CAAC,GAAG,CAAC;;;;;;;;;;mEAUuC,CAAC;IAClE,CAAC;CACF"}

package/dist/agents/architect.d.ts

@@ -0,0 +1,21 @@
+import { BaseAgent } from './base-agent.js';
+import type { ProjectContext } from '../core/context.js';
+export declare class ArchitectAgent extends BaseAgent {
+    readonly name = "Architect";
+    readonly role = "System Architecture Design";
+    readonly emoji = "\uD83C\uDFD7\uFE0F";
+    protected buildSystemPrompt(ctx: ProjectContext): string;
+}
+export declare class FrontendArchitectAgent extends BaseAgent {
+    readonly name = "Frontend Architect";
+    readonly role = "Frontend Architecture & State Management";
+    readonly emoji = "\uD83C\uDFD7\uFE0F";
+    protected buildSystemPrompt(ctx: ProjectContext): string;
+}
+export declare class BackendArchitectAgent extends BaseAgent {
+    readonly name = "Backend Architect";
+    readonly role = "Backend Architecture & Database Design";
+    readonly emoji = "\uD83C\uDFD7\uFE0F";
+    protected buildSystemPrompt(ctx: ProjectContext): string;
+}
+//# sourceMappingURL=architect.d.ts.map

package/dist/agents/architect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architect.d.ts","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,qBAAa,cAAe,SAAQ,SAAS;IAC3C,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,IAAI,gCAAgC;IAC7C,QAAQ,CAAC,KAAK,wBAAS;IAEvB,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;CAsBzD;AAED,qBAAa,sBAAuB,SAAQ,SAAS;IACnD,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,IAAI,8CAA8C;IAC3D,QAAQ,CAAC,KAAK,wBAAS;IAEvB,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;CAsBzD;AAED,qBAAa,qBAAsB,SAAQ,SAAS;IAClD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,IAAI,4CAA4C;IACzD,QAAQ,CAAC,KAAK,wBAAS;IAEvB,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;CAuBzD"}

package/dist/agents/architect.js

@@ -0,0 +1,85 @@
+import { BaseAgent } from './base-agent.js';
+import { contextToSystemPrompt } from '../core/context.js';
+export class ArchitectAgent extends BaseAgent {
+    name = 'Architect';
+    role = 'System Architecture Design';
+    emoji = '🏗️';
+    buildSystemPrompt(ctx) {
+        return `You are a senior Software Architect with deep expertise in ${ctx.language} and ${ctx.framework}.
+
+${contextToSystemPrompt(ctx)}
+
+Your responsibilities:
+1. Design the technical architecture for the given task
+2. Define the file structure and module organization
+3. Design interfaces, types, and data models
+4. Choose appropriate patterns (Repository, Service, Factory, etc.)
+5. Consider scalability, maintainability, and testability
+6. Define integration points with existing code
+
+Output:
+- Architecture overview
+- File structure to create (list every file with its purpose)
+- Key interfaces and types
+- Data flow diagram (text format)
+- Integration points with existing modules
+
+Read existing code structure before making decisions. Match existing patterns.`;
+    }
+}
+export class FrontendArchitectAgent extends BaseAgent {
+    name = 'Frontend Architect';
+    role = 'Frontend Architecture & State Management';
+    emoji = '🏗️';
+    buildSystemPrompt(ctx) {
+        return `You are a senior Frontend Architect specializing in ${ctx.framework} applications.
+
+${contextToSystemPrompt(ctx)}
+
+Your responsibilities:
+1. Design component hierarchy and architecture
+2. Plan state management strategy (Context, Redux, Zustand, etc.)
+3. Define routing and code splitting strategy
+4. Design data fetching patterns (SWR, React Query, etc.)
+5. Performance optimization strategy
+6. Identify reusable components and hooks
+
+Output:
+- Component tree diagram
+- State management architecture
+- List of files to create (components, hooks, contexts, utils)
+- Props interfaces for key components
+- Data fetching strategy
+
+Read existing components and hooks to match current patterns.`;
+    }
+}
+export class BackendArchitectAgent extends BaseAgent {
+    name = 'Backend Architect';
+    role = 'Backend Architecture & Database Design';
+    emoji = '🏗️';
+    buildSystemPrompt(ctx) {
+        return `You are a senior Backend Architect specializing in ${ctx.framework} services.
+
+${contextToSystemPrompt(ctx)}
+
+Your responsibilities:
+1. Design service/module architecture
+2. Database schema design and migrations
+3. API layer design (controllers, services, repositories)
+4. Middleware and middleware chain design
+5. Error handling strategy
+6. Authentication/authorization architecture (if needed)
+7. Caching strategy
+
+Output:
+- Architecture layers description
+- Database schema (if applicable)
+- List of files to create (controllers, services, repos, models)
+- Key interfaces and DTOs
+- Middleware chain
+
+Read existing code to understand current layered architecture.`;
+    }
+}
+//# sourceMappingURL=architect.js.map

package/dist/agents/architect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architect.js","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,OAAO,cAAe,SAAQ,SAAS;IAClC,IAAI,GAAG,WAAW,CAAC;IACnB,IAAI,GAAG,4BAA4B,CAAC;IACpC,KAAK,GAAG,KAAK,CAAC;IAEb,iBAAiB,CAAC,GAAmB;QAC7C,OAAO,8DAA8D,GAAG,CAAC,QAAQ,QAAQ,GAAG,CAAC,SAAS;;EAExG,qBAAqB,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;+EAiBmD,CAAC;IAC9E,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,SAAS;IAC1C,IAAI,GAAG,oBAAoB,CAAC;IAC5B,IAAI,GAAG,0CAA0C,CAAC;IAClD,KAAK,GAAG,KAAK,CAAC;IAEb,iBAAiB,CAAC,GAAmB;QAC7C,OAAO,uDAAuD,GAAG,CAAC,SAAS;;EAE7E,qBAAqB,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;8DAiBkC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IACzC,IAAI,GAAG,mBAAmB,CAAC;IAC3B,IAAI,GAAG,wCAAwC,CAAC;IAChD,KAAK,GAAG,KAAK,CAAC;IAEb,iBAAiB,CAAC,GAAmB;QAC7C,OAAO,sDAAsD,GAAG,CAAC,SAAS;;EAE5E,qBAAqB,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;+DAkBmC,CAAC;IAC9D,CAAC;CACF"}

package/dist/agents/base-agent.d.ts

@@ -0,0 +1,56 @@
+import { DeepSeekClient } from '../core/api.js';
+import type { Tool } from '../core/api.js';
+import type { ProjectContext } from '../core/context.js';
+export interface AgentResult {
+    agentName: string;
+    role: string;
+    emoji: string;
+    output: string;
+    artifacts: AgentArtifact[];
+    fileChanges: FileChange[];
+    pendingWrites: Map<string, {
+        content: string;
+        description?: string;
+    }>;
+    duration: number;
+}
+export interface AgentArtifact {
+    type: 'story' | 'spec' | 'architecture' | 'tests' | 'review' | 'analysis' | 'plan';
+    title: string;
+    content: string;
+}
+export interface FileChange {
+    path: string;
+    content: string;
+    description?: string;
+}
+export interface AgentOptions {
+    client: DeepSeekClient;
+    model: string;
+    projectContext: ProjectContext;
+    rootDir: string;
+    task: string;
+    previousResults?: AgentResult[];
+    maxRounds?: number;
+    /** When true, write_file calls are queued in pendingWrites instead of written immediately */
+    dryRun?: boolean;
+}
+export declare const AGENT_TOOLS: Tool[];
+export declare abstract class BaseAgent {
+    abstract readonly name: string;
+    abstract readonly role: string;
+    abstract readonly emoji: string;
+    protected abstract buildSystemPrompt(ctx: ProjectContext, task: string): string;
+    protected pendingWrites: Map<string, {
+        content: string;
+        description?: string;
+    }>;
+    run(options: AgentOptions): Promise<AgentResult>;
+    protected buildUserMessage(task: string, previousResults?: AgentResult[]): string;
+    protected executeToolCall(name: string, args: Record<string, unknown>, rootDir: string, fileChanges: FileChange[], pendingWrites?: Map<string, {
+        content: string;
+        description?: string;
+    }>): Promise<string>;
+    protected extractArtifacts(output: string): AgentArtifact[];
+}
+//# sourceMappingURL=base-agent.d.ts.map

package/dist/agents/base-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../../src/agents/base-agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAc,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAW,IAAI,EAAY,MAAM,gBAAgB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASzD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,WAAW,EAAE,IAAI,EA0E7B,CAAC;AAEF,8BAAsB,SAAS;IAC7B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAE/E,SAAS,CAAC,aAAa;iBAA8B,MAAM;sBAAgB,MAAM;OAAM;IAEjF,GAAG,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAkFtD,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM;cAgBjE,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,UAAU,EAAE,EACzB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GACrE,OAAO,CAAC,MAAM,CAAC;IAsFlB,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE;CAkB5D"}