@barissozen/csns 0.6.0

package/.env.example

@@ -0,0 +1,8 @@
+# Project Consciousness — Environment Variables
+# Copy this file to .env and fill in your values
+
+# Required for orchestrator (pc run)
+ANTHROPIC_API_KEY=your_key_here
+
+# Optional: Claude model override
+# CLAUDE_MODEL=claude-sonnet-4-20250514

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Baris Sozen
+
+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

@@ -0,0 +1,364 @@
+# Project Consciousness
+
+> Just say what you want. It handles the rest.
+
+AI agents that don't ask you "which framework?" or "JWT or session?" — you describe what you need, the system makes the technical decisions itself.
+
+**Multi-model** · **Multi-language** · **Memory-first** · **Self-correcting**
+
+---
+
+## Demo
+
+```
+$ pc init
+
+📋 What do you want to build?
+> I want a URL shortener with user registration, redirect on click,
+  links never expire
+
+🔍 Analyzing...
+   ✅ JWT Auth (registration detected)
+   ✅ SQLite (lightweight, sufficient)
+   ✅ REST API
+   ✅ TypeScript + Node.js
+
+❓ A few product questions:
+
+   Are shortened links public or login-only?
+   1. Public
+   2. Login only
+   3. Both (configurable)
+   > 1
+
+   Can users see each other's links?
+   1. Yes, everyone sees all
+   2. No, only their own
+   3. Optional sharing
+   > 2
+
+╔══════════════════════════════════════════════╗
+║              Plan Summary                    ║
+╚══════════════════════════════════════════════╝
+
+ ✅ JWT Auth        ❌ No frontend (API only)
+ ✅ SQLite          ❌ No payment system
+ ✅ REST API
+
+$ pc run
+
+🚀 Orchestration starting...
+📦 Milestone M01: Foundation — DB schema, config
+📦 Milestone M02: Auth — register, login, JWT
+📦 Milestone M03: URL Shortener — CRUD, redirect
+🤖 Agent working: M01...
+✅ M01 completed (tsc ✅, test ✅)
+🤖 Agent working: M02...
+✅ M02 completed (tsc ✅, test ✅, endpoint ✅)
+🤖 Agent working: M03...
+✅ M03 completed (tsc ✅, test ✅, endpoint ✅)
+
+✅ Project complete — 3/3 milestones successful
+```
+
+---
+
+## Install
+
+```bash
+npx project-consciousness init     # try instantly
+# or
+npm install -g project-consciousness
+pc init
+pc run
+```
+
+**Requirements:** Node.js 20+, at least one LLM provider
+
+```bash
+# Pick one:
+export ANTHROPIC_API_KEY=sk-ant-...       # Claude
+export OPENAI_API_KEY=sk-...              # GPT-4o / o-series
+export OLLAMA_HOST=http://localhost:11434  # Local (Llama, Mistral, etc.)
+```
+
+---
+
+## Multi-Model Support
+
+Use any LLM provider — switch with a single env variable:
+
+| Provider | Env Variable | Models |
+|----------|-------------|--------|
+| **Anthropic** (default) | `ANTHROPIC_API_KEY` | Claude Sonnet, Opus, Haiku |
+| **OpenAI** | `OPENAI_API_KEY` | GPT-4o, o1, o3 |
+| **Ollama** | `OLLAMA_HOST` | Llama 3, Mistral, CodeLlama, any local model |
+| **OpenAI-compatible** | `OPENAI_API_KEY` + `LLM_BASE_URL` | Groq, Together, Azure, etc. |
+
+```bash
+# Auto-detect: whichever key exists is used
+export ANTHROPIC_API_KEY=sk-ant-...
+pc run "Build a todo API"
+
+# Explicit override
+LLM_PROVIDER=openai OPENAI_API_KEY=sk-... pc run "Build a todo API"
+
+# Local Ollama (no API key needed)
+LLM_PROVIDER=ollama pc run "Build a todo API"
+```
+
+### Programmatic
+
+```typescript
+import { createProvider } from 'project-consciousness/llm';
+
+// Auto-detect from env
+const provider = createProvider();
+
+// Or explicit
+const claude = createProvider({ provider: 'anthropic', apiKey: 'sk-ant-...' });
+const gpt = createProvider({ provider: 'openai', apiKey: 'sk-...', model: 'gpt-4o' });
+const local = createProvider({ provider: 'ollama', model: 'llama3' });
+```
+
+---
+
+## Multi-Language (i18n)
+
+All user-facing messages, prompts, and agent personas support multiple languages:
+
+```bash
+PC_LOCALE=en pc run "Build a todo API"     # English (default)
+PC_LOCALE=tr pc run "Todo API yap"         # Türkçe
+```
+
+Currently supported: **English** (`en`), **Turkish** (`tr`). Adding a new locale is one file — see `src/i18n/`.
+
+---
+
+## Agent CLI Abstraction
+
+The orchestrator spawns coding agents via CLI. Default is Claude Code, but any compatible CLI works:
+
+```bash
+AGENT_BINARY=claude pc run "..."     # Claude Code (default)
+AGENT_BINARY=codex pc run "..."      # OpenAI Codex CLI
+AGENT_BINARY=aider pc run "..."      # Aider
+```
+
+The agent receives a prompt via stdin and returns structured output. Any CLI that accepts `--print` mode or stdin prompts can be plugged in.
+
+---
+
+## How It Works
+
+### The 4-File Memory System
+
+Everything runs on 4 markdown files. Agents read them before every task and never forget why they exist.
+
+| File | What It Contains | Owned By |
+|------|-----------------|----------|
+| `MISSION.md` | What to build, what NOT to build, success criteria | You (immutable) |
+| `ARCHITECTURE.md` | Technical decisions — auth, DB, API style | System (auto) |
+| `DECISIONS.md` | Every decision, why it was made, when | Log (append-only) |
+| `STATE.md` | Current phase, what's done, what's left | Live status |
+
+### Architecture
+
+```
+You: "I want a URL shortener..."
+ │
+ ▼
+┌─────────────────────────────────┐
+│  SmartBrief                      │
+│  1 question → analysis →         │
+│  product questions only          │
+│  → MISSION.md + ARCHITECTURE.md  │
+└──────────┬──────────────────────┘
+           ▼
+┌─────────────────────────────────┐
+│  Orchestrator                    │
+│  Plan → Milestone → Agent → Test │
+│  Failed? → 3x retry → ask you   │
+└──────────┬──────────────────────┘
+           ▼
+┌─────────────────────────────────┐
+│  Memory Layer                    │
+│  Every decision → DECISIONS.md   │
+│  Every step → STATE.md           │
+│  Nothing is lost                 │
+└─────────────────────────────────┘
+```
+
+### What It Asks vs. What It Decides
+
+| Asks you ✅ | Decides itself ❌ |
+|---|---|
+| "Are links public or private?" | JWT or session? |
+| "Can users see each other's data?" | Which database? |
+| "Will there be payments?" | REST or GraphQL? |
+| "Do links expire?" | File structure? |
+
+Technical decisions are inferred from your brief. Only **product decisions** — things you need to know — are asked.
+
+### Quality Control Pipeline
+
+After code is written, it's verified:
+
+1. **Type checking** — `tsc --noEmit`
+2. **Test execution** — `vitest run` / `pytest` / `go test`
+3. **HTTP endpoint testing** — server started, real HTTP requests sent
+4. **Anti-scope enforcement** — protected files touched? forbidden deps added?
+
+Failed? 3x auto-retry with feedback → still failing? → escalation to you.
+
+### Tracer Agent — Data Flow Inspector
+
+A specialized agent that "walks" through the project, tracking data flow and finding wiring problems:
+
+```typescript
+import { TracerAgent } from 'project-consciousness/agent';
+
+const tracer = new TracerAgent({
+  projectRoot: process.cwd(),
+  llmProvider: provider,     // any LLMProvider
+  port: 3000,
+});
+
+const report = await tracer.run();
+// report.staticIssues     → dead exports, circular deps, phantom deps
+// report.semanticInsights → LLM-detected injection gaps, config mismatches
+// report.runtimeTraces    → HTTP probe results, handler chains, data flow
+```
+
+**3-layer analysis:**
+
+| Layer | What | How |
+|-------|------|-----|
+| **Static** | Import/export graph, dead code, circular deps, phantom deps | Regex scan of all `.ts` files |
+| **Semantic** | "This service should be injected but isn't" | LLM reasoning over graph + file summaries |
+| **Runtime** | Server started, HTTP probed, handler chain traced | Express middleware injection + HTTP probing |
+
+---
+
+## CLI Commands
+
+| Command | What It Does |
+|---------|-------------|
+| `pc init` | Collect brief → create 4 memory files |
+| `pc run` | Start the orchestrator |
+| `pc run "Build a todo API"` | Start with inline brief |
+| `pc status` | Show STATE.md |
+| `pc log` | Show DECISIONS.md |
+| `pc help` | Help |
+
+---
+
+## Traceability
+
+Everything is logged, nothing is deleted:
+
+```markdown
+## D024 — Codebase Context: Pre-Task File Reading
+- **Date**: 2026-03-24T02:30:00+03:00
+- **Decision**: CodebaseReader scans src/, selects relevant files per task
+- **Rationale**: Agent must know existing code, otherwise writes duplicates
+- **Status**: active
+```
+
+6 months later: "why did we do it this way?" → `DECISIONS.md`.
+
+---
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|------------|---------|
+| `ANTHROPIC_API_KEY` | Anthropic API key | — |
+| `OPENAI_API_KEY` | OpenAI API key | — |
+| `OLLAMA_HOST` | Ollama server URL | `http://localhost:11434` |
+| `LLM_PROVIDER` | Force provider: `anthropic`, `openai`, `ollama` | auto-detect |
+| `LLM_MODEL` | Model name | provider default |
+| `LLM_BASE_URL` | Custom API base URL (OpenAI-compatible) | — |
+| `AGENT_BINARY` | Coding agent CLI binary | `claude` |
+| `PC_LOCALE` | Language: `en`, `tr` | `en` |
+
+### Programmatic
+
+```typescript
+import { Orchestrator } from 'project-consciousness/orchestrator';
+
+const orchestrator = new Orchestrator({
+  projectRoot: process.cwd(),
+  llmProvider: 'openai',
+  llmApiKey: 'sk-...',
+  llmModel: 'gpt-4o',
+  agentBinary: 'claude',
+  locale: 'en',
+  maxRetries: 3,
+  escalationThreshold: 0.4,
+  maxParallelAgents: 3,
+  verbose: true,
+});
+
+const session = await orchestrator.run('Build a REST API for todos');
+```
+
+---
+
+## Developer Notes
+
+### Project Structure
+
+```
+src/
+├── brief/           SmartBrief + BriefCollector
+├── agent/           Agent Runner, Context Builder, Codebase Reader
+│   └── tracer/      Tracer Agent (static + semantic + runtime analysis)
+├── orchestrator/    Planner, Evaluator, Escalator, Integration Evaluator
+├── memory/          4-file read/write layer
+├── llm/             LLM provider abstraction (Anthropic, OpenAI, Ollama)
+├── i18n/            Internationalization (en, tr)
+├── types/           TypeScript interfaces
+└── bin/             CLI (pc init/run/status/log)
+```
+
+### Test
+
+```bash
+npm test                                    # 229 tests, 19 suites
+npx vitest run tests/tracer-agent.test.ts   # specific suite
+SKIP_E2E=1 npm test                         # skip real CLI tests
+```
+
+TypeScript strict mode, 0 errors. Vitest for testing.
+
+### Stack
+
+- **TypeScript + Node.js** — strict mode, ESM
+- **LLM Providers** — Anthropic SDK, OpenAI API, Ollama REST (pluggable)
+- **Agent Execution** — Claude Code CLI (configurable)
+- **Testing** — Vitest (229 tests)
+- **Storage** — File system (markdown, no DB)
+
+### Design Principles
+
+1. **Memory-First** — Every decision leaves a trace in files
+2. **Fail-Safe** — When in doubt, ask the human
+3. **Append-Only** — DECISIONS.md is never edited
+4. **Minimal** — File system is enough, no DB needed
+5. **Human-Readable** — All state is markdown
+6. **Provider-Agnostic** — Works with any LLM, any agent CLI
+
+### Contributing
+
+1. Fork → branch → test → PR
+2. `npm test` must pass
+3. `npx tsc --noEmit` must show 0 errors
+4. Conventional commits (`feat:`, `fix:`, `docs:`)
+
+## License
+
+MIT — [Baris Sozen](https://github.com/BarisSozen)

package/dist/agent/agent-runner.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Agent Runner — Claude Code Instance Yöneticisi
+ *
+ * Agent'ları spawn eder, memory context'i prompt'a enjekte eder,
+ * çıktıyı parse eder ve orchestrator'a döndürür.
+ *
+ * Karar D003: GSD-2 üstüne katman — subagent mekanizması kullanır
+ * Karar D004: Agent'lar Claude Code ile çalışır
+ */
+import type { AgentConfig, AgentResult, MemorySnapshot, TaskDefinition } from '../types/index.js';
+export interface AgentRunnerConfig {
+    /** Claude CLI binary path (default: 'claude') */
+    binaryPath?: string;
+    /** Working directory for agents */
+    workingDirectory: string;
+    /** Timeout per agent execution in ms (default: 120_000) */
+    timeout?: number;
+    /** Max recursion depth (prevents infinite agent spawning) */
+    maxDepth?: number;
+    /** Allowed tools for agents (default: ['Read', 'Write', 'Edit', 'Bash']) */
+    allowedTools?: string[];
+    /** Additional environment variables for agents */
+    env?: Record<string, string>;
+    /** Log function */
+    log?: (message: string) => void;
+}
+export declare class AgentRunner {
+    private agents;
+    private spawner;
+    private contextBuilder;
+    private outputParser;
+    private config;
+    private log;
+    constructor(config: AgentRunnerConfig);
+    registerAgent(config: AgentConfig): void;
+    getAgent(id: string): AgentConfig | undefined;
+    private registerDefaultAgents;
+    checkHealth(): Promise<{
+        ready: boolean;
+        details: string;
+    }>;
+    runTask(task: TaskDefinition, memory: MemorySnapshot): Promise<AgentResult>;
+    runParallel(tasks: TaskDefinition[], memory: MemorySnapshot, maxConcurrent: number): Promise<AgentResult[]>;
+    private buildCliFlags;
+    private selectAgent;
+    private failResult;
+}
+//# sourceMappingURL=agent-runner.d.ts.map

package/dist/agent/agent-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../src/agent/agent-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mBAAmB;IACnB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,GAAG,CAA4B;gBAE3B,MAAM,EAAE,iBAAiB;IAerC,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIxC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7C,OAAO,CAAC,qBAAqB;IA4BvB,WAAW,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA0B3D,OAAO,CACX,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC;IAgEjB,WAAW,CACf,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC;IA+BzB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,UAAU;CAenB"}

package/dist/agent/agent-runner.js

@@ -0,0 +1,180 @@
+/**
+ * Agent Runner — Claude Code Instance Yöneticisi
+ *
+ * Agent'ları spawn eder, memory context'i prompt'a enjekte eder,
+ * çıktıyı parse eder ve orchestrator'a döndürür.
+ *
+ * Karar D003: GSD-2 üstüne katman — subagent mekanizması kullanır
+ * Karar D004: Agent'lar Claude Code ile çalışır
+ */
+import { ProcessSpawner } from './process-spawner.js';
+import { ContextBuilder } from './context-builder.js';
+import { OutputParser } from './output-parser.js';
+import { t } from '../i18n/index.js';
+export class AgentRunner {
+    agents = new Map();
+    spawner;
+    contextBuilder;
+    outputParser;
+    config;
+    log;
+    constructor(config) {
+        this.config = config;
+        this.spawner = new ProcessSpawner(config.binaryPath ?? 'claude', config.timeout ?? 120_000);
+        this.contextBuilder = new ContextBuilder();
+        this.outputParser = new OutputParser();
+        this.log = config.log ?? console.log;
+        this.registerDefaultAgents();
+    }
+    // ── Agent Registration ──────────────────────────────────
+    registerAgent(config) {
+        this.agents.set(config.id, config);
+    }
+    getAgent(id) {
+        return this.agents.get(id);
+    }
+    registerDefaultAgents() {
+        this.registerAgent({
+            id: 'coder',
+            type: 'coder',
+            capabilities: ['write-code', 'refactor', 'implement-feature'],
+        });
+        this.registerAgent({
+            id: 'reviewer',
+            type: 'reviewer',
+            capabilities: ['code-review', 'consistency-check', 'quality-audit'],
+        });
+        this.registerAgent({
+            id: 'tester',
+            type: 'tester',
+            capabilities: ['write-tests', 'run-tests', 'coverage-analysis'],
+        });
+        this.registerAgent({
+            id: 'documenter',
+            type: 'documenter',
+            capabilities: ['write-docs', 'update-readme', 'api-docs'],
+        });
+    }
+    // ── Health Check ────────────────────────────────────────
+    async checkHealth() {
+        // Sonsuz döngü koruması
+        const depth = parseInt(process.env['PC_AGENT_DEPTH'] ?? '0', 10);
+        if (depth >= (this.config.maxDepth ?? 3)) {
+            return {
+                ready: false,
+                details: `Max agent depth reached (${depth}/${this.config.maxDepth ?? 3})`
+            };
+        }
+        const health = await this.spawner.healthCheck();
+        if (!health.available) {
+            return {
+                ready: false,
+                details: `Claude CLI not available: ${health.error}`,
+            };
+        }
+        return {
+            ready: true,
+            details: `Claude CLI ${health.version ?? 'unknown'} ready, depth: ${depth}`,
+        };
+    }
+    // ── Single Task Execution ───────────────────────────────
+    async runTask(task, memory) {
+        const agentId = this.selectAgent(task);
+        const agent = this.agents.get(agentId);
+        if (!agent) {
+            return this.failResult(task.id, agentId, `No agent found for type: ${task.type}`);
+        }
+        this.log(t().agentStarting(agent.id, task.id));
+        // 1. Memory-aware prompt oluştur
+        const prompt = this.contextBuilder.buildPrompt(task, memory, agent);
+        this.log(t().promptReady(prompt.length));
+        // 2. Claude CLI spawn et
+        const startTime = Date.now();
+        try {
+            // Build CLI flags for tool permissions
+            const flags = this.buildCliFlags();
+            const processResult = await this.spawner.spawn({
+                prompt,
+                cwd: this.config.workingDirectory,
+                timeout: this.config.timeout,
+                flags,
+                env: this.config.env,
+            });
+            // 3. Timeout kontrolü
+            if (processResult.timedOut) {
+                this.log(t().agentTimeout(processResult.duration));
+                return this.failResult(task.id, agent.id, `Agent timed out after ${processResult.duration}ms`, processResult.duration);
+            }
+            // 4. Çıktıyı parse et
+            const result = this.outputParser.parse(task.id, agent.id, processResult.stdout, processResult.stderr, processResult.exitCode, processResult.duration);
+            this.log(`  ${result.success ? '✅' : '❌'} ${t().agentComplete(agent.id, processResult.duration)}`);
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            this.log(t().agentError(agent.id, message));
+            return this.failResult(task.id, agent.id, message, duration);
+        }
+    }
+    // ── Parallel Execution ──────────────────────────────────
+    async runParallel(tasks, memory, maxConcurrent) {
+        const results = [];
+        this.log(t().parallelBatch(0, Math.ceil(tasks.length / maxConcurrent), tasks.map(t2 => t2.id).join(', ')));
+        // Batch'ler halinde çalıştır
+        for (let i = 0; i < tasks.length; i += maxConcurrent) {
+            const batch = tasks.slice(i, i + maxConcurrent);
+            const batchNum = Math.floor(i / maxConcurrent) + 1;
+            const totalBatches = Math.ceil(tasks.length / maxConcurrent);
+            this.log(t().parallelBatch(batchNum, totalBatches, batch.map(t2 => t2.id).join(', ')));
+            // Her batch'te memory'yi yeniden oku (önceki batch'in değişiklikleri yansısın)
+            // İlk batch hariç — ilk batch zaten güncel memory'yi kullanıyor
+            const batchResults = await Promise.all(batch.map(task => this.runTask(task, memory)));
+            results.push(...batchResults);
+            // Batch sonuçlarını logla
+            const succeeded = batchResults.filter(r => r.success).length;
+            this.log(t().batchResult(batchNum, succeeded, batchResults.length));
+        }
+        return results;
+    }
+    // ── CLI Flags ────────────────────────────────────────────
+    buildCliFlags() {
+        const flags = [];
+        // Permission bypass — agent'lar sandbox'ta çalışır, tool'ları kullanabilmeli
+        flags.push('--dangerously-skip-permissions');
+        // Allowed tools — sadece dosya operasyonları ve bash
+        const tools = this.config.allowedTools ?? ['Read', 'Write', 'Edit', 'Bash'];
+        if (tools.length > 0) {
+            flags.push('--allowedTools', tools.join(','));
+        }
+        return flags;
+    }
+    // ── Agent Selection ─────────────────────────────────────
+    selectAgent(task) {
+        // Task'a explicit agent atanmışsa onu kullan
+        if (task.agent) {
+            return task.agent;
+        }
+        // Task type'a göre agent seç
+        switch (task.type) {
+            case 'code': return 'coder';
+            case 'review': return 'reviewer';
+            case 'test': return 'tester';
+            case 'document': return 'documenter';
+            case 'decision': return 'coder';
+            default: return 'coder';
+        }
+    }
+    // ── Helpers ─────────────────────────────────────────────
+    failResult(taskId, agentId, error, duration = 0) {
+        return {
+            taskId,
+            agentId,
+            success: false,
+            output: `Error: ${error}`,
+            artifacts: [],
+            duration,
+        };
+    }
+}
+//# sourceMappingURL=agent-runner.js.map

package/dist/agent/agent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../src/agent/agent-runner.ts"],"names":[],"mappings":"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"}

package/dist/agent/architect.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Architect Agent — Kodlamaya Başlamadan Önce Mimari Kararlar
+ *
+ * Brief geldikten sonra kullanıcıya mimari sorular sorar.
+ * Cevapları ARCHITECTURE.md'ye yazar.
+ * Sonraki agent'lar bu kararları okur, tekrar sormaz.
+ *
+ * Tasarım ilkesi #1: Memory-First — her karar hafızada iz bırakır
+ */
+import type { ArchitectureDecisions } from '../types/index.js';
+export declare class ArchitectAgent {
+    private _askFn;
+    /** Test injection */
+    setAskFn(fn: (prompt: string) => Promise<string>): void;
+    /**
+     * İnteraktif CLI ile kullanıcıdan mimari kararları topla
+     */
+    runInteractive(): Promise<ArchitectureDecisions>;
+    /**
+     * Test/CI için direkt cevap ver
+     */
+    runWithDefaults(answers: ArchitectureDecisions): ArchitectureDecisions;
+    /**
+     * Kararları ARCHITECTURE.md'ye yaz
+     */
+    writeToArchitecture(decisions: ArchitectureDecisions, archPath: string): Promise<void>;
+    /**
+     * ARCHITECTURE.md'den kararları parse et
+     */
+    static parseDecisions(content: string): ArchitectureDecisions | null;
+    private collectAnswers;
+    private renderDecisions;
+}
+//# sourceMappingURL=architect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"architect.d.ts","sourceRoot":"","sources":["../../src/agent/architect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAwE,MAAM,mBAAmB,CAAC;AA0DrI,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAsD;IAEpE,qBAAqB;IACrB,QAAQ,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAgBtD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,qBAAqB;IAItE;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5F;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;YAoBtD,cAAc;IAuB5B,OAAO,CAAC,eAAe;CAWxB"}