@wrongstack/core 0.8.2 → 0.8.5

package/dist/index.d.ts

@@ -30,11 +30,12 @@ import { c as ModeStore } from './mode-CV077NjV.js';
 export { D as DEFAULT_MODES, M as Mode, a as ModeConfig, b as ModeManifest } from './mode-CV077NjV.js';
 export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from './agent-bridge-DPxcUVkn.js';
 export { c as BudgetExceededError, d as BudgetKind, e as BudgetLimits, j as BudgetUsage, C as CoordinatorEvents, k as CoordinatorStatus, D as DoneCondition, M as MultiAgentConfig, l as MultiAgentCoordinator, S as SpawnResult, m as SubagentBudget, n as SubagentConfig, o as SubagentContext, p as SubagentError, q as SubagentErrorKind, r as SubagentRunContext, s as SubagentRunOutcome, t as SubagentRunner, T as TaskDelegation, u as TaskResult, v as TaskSpec } from './multi-agent-CRMznZmf.js';
-export { C as CriticalPathResult, D as DEFAULT_SPEC_TEMPLATE, S as SpecAnalysis, a as SpecApiEndpoint, b as SpecRequirement, c as SpecSection, d as SpecSectionType, e as SpecStatus, f as SpecTemplate, g as SpecValidationResult, h as Specification, T as TaskAssignment, i as TaskDependency, j as TaskEdge, k as TaskFilter, l as TaskGraph, m as TaskNode, n as TaskPriority, o as TaskProgress, p as TaskSort, q as TaskStatus, r as TaskType, s as computeTaskProgress, t as findCriticalPath, u as topologicalSort } from './task-graph-D1YQbpxF.js';
+import { l as TaskGraph, r as TaskType, n as TaskPriority, m as TaskNode } from './task-graph-D1YQbpxF.js';
+export { C as CriticalPathResult, D as DEFAULT_SPEC_TEMPLATE, S as SpecAnalysis, a as SpecApiEndpoint, b as SpecRequirement, c as SpecSection, d as SpecSectionType, e as SpecStatus, f as SpecTemplate, g as SpecValidationResult, h as Specification, T as TaskAssignment, i as TaskDependency, j as TaskEdge, k as TaskFilter, o as TaskProgress, p as TaskSort, q as TaskStatus, s as computeTaskProgress, t as findCriticalPath, u as topologicalSort } from './task-graph-D1YQbpxF.js';
 export { A as AggregateHealth, H as HealthCheck, a as HealthCheckResult, b as HealthRegistry, c as HealthStatus, M as MetricLabels, d as MetricSeries, e as MetricsSink, f as MetricsSnapshot, S as Span, T as Tracer } from './observability-BhnVLBLS.js';
 export { AtomicWriteOptions, BuildChildEnvOptions, CompileFail, CompileResult, MessageRepairReport, MessageRepairResult, NewlineStyle, RequestTokenBreakdown, SafeParseResult, ToolOutputSerializerOptions, UnifiedDiffOptions, ValidationError, ValidationResult, atomicWrite, buildChildEnv, color, compileGlob, compileUserRegex, createToolOutputSerializer, detectNewlineStyle, ensureDir, estimateRequestTokens, estimateTextTokens, estimateToolDefTokens, estimateToolInputTokens, estimateToolResultTokens, formatTodosList, matchAny, matchGlob, normalizeToLf, repairToolUseAdjacency, safeParse, safeStringify, sanitizeJsonString, stripAnsi, toStyle, unifiedDiff, validateAgainstSchema } from './utils/index.js';
-export { W as WstackPathOptions, a as WstackPaths, p as projectHash, r as resolveWstackPaths } from './wstack-paths-gCrJ631C.js';
-export { A as AbandonedSession, a as AttachmentStoreOptions, C as ConfigLoaderOptions, b as ConfigMigration, c as ConfigMigrationError, d as ConfigSource, D as DEFAULT_CONFIG_MIGRATIONS, e as DefaultAttachmentStore, f as DefaultConfigLoader, g as DefaultConfigStore, h as DefaultMemoryStore, i as DefaultSessionStore, M as MemoryStoreOptions, j as MigrationContext, k as MigrationResult, P as PersistedQueueItem, l as PlanFile, m as PlanItem, n as PlanTemplate, Q as QueueStore, R as RecoveryLock, o as RecoveryLockOptions, S as SessionAnalyzer, p as SessionStoreOptions, T as TodosCheckpointFile, q as addPlanItem, r as attachPlanCheckpoint, s as attachTodosCheckpoint, t as clearPlan, u as deriveTodosFromPlanItem, v as emptyPlan, w as formatPlan, x as formatPlanTemplates, y as getPlanTemplate, z as listPlanTemplates, B as loadPlan, E as loadTodosCheckpoint, F as removePlanItem, G as runConfigMigrations, H as savePlan, I as saveTodosCheckpoint, J as setPlanItemStatus } from './plan-templates-BnlpEkX8.js';
+export { W as WstackPathOptions, a as WstackPaths, p as projectHash, r as resolveWstackPaths } from './wstack-paths-Bxik3CsK.js';
+export { A as AbandonedSession, a as AttachmentStoreOptions, C as ConfigLoaderOptions, b as ConfigMigration, c as ConfigMigrationError, d as ConfigSource, D as DEFAULT_CONFIG_MIGRATIONS, e as DefaultAttachmentStore, f as DefaultConfigLoader, g as DefaultConfigStore, h as DefaultMemoryStore, i as DefaultSessionStore, M as MemoryStoreOptions, j as MigrationContext, k as MigrationResult, P as PersistedQueueItem, l as PlanFile, m as PlanItem, n as PlanTemplate, Q as QueueStore, R as RecoveryLock, o as RecoveryLockOptions, S as SessionAnalyzer, p as SessionStoreOptions, T as TodosCheckpointFile, q as addPlanItem, r as attachPlanCheckpoint, s as attachTodosCheckpoint, t as clearPlan, u as deriveTodosFromPlanItem, v as emptyPlan, w as formatPlan, x as formatPlanTemplates, y as getPlanTemplate, z as listPlanTemplates, B as loadPlan, E as loadTodosCheckpoint, F as removePlanItem, G as runConfigMigrations, H as savePlan, I as saveTodosCheckpoint, J as setPlanItemStatus } from './plan-templates-D8zQgZzc.js';
 export { D as DirectorStateCheckpoint, a as DirectorStateSnapshot, b as DirectorSubagentState, c as DirectorTaskState, l as loadDirectorState } from './director-state-BmYi3DGA.js';
 export { A as AutoApprovePermissionPolicy, D as DefaultPermissionPolicy, P as PermissionPolicyOptions } from './permission-policy-BBa1M1xc.js';
 export { AutoCompactionMiddleware, AutonomousRunner, AutonomousRunnerOptions, AutonomyPromptContributorOptions, DefaultSkillLoader, DoneCheckResult, DoneConditionChecker, EternalAutonomyEngine, EternalAutonomyOptions, EternalEngineState, IntelligentCompactor, IntelligentCompactorOptions, ParallelEngineState, ParallelEternalEngine, ParallelEternalOptions, SelectiveCompactor, SelectiveCompactorOptions, SkillLoaderOptions, buildGoalPreamble, makeAutonomyPromptContributor } from './execution/index.js';
@@ -43,7 +44,8 @@ export { a as AGENTS_BY_PHASE, b as AGENT_CATALOG, c as ALL_AGENT_DEFINITIONS, d
 export { A as AgentBudgetTier, a as AgentCapability, b as AgentDefinition, c as AgentPhase, D as DEFAULT_DISPATCH_ROLE, d as DefaultMultiAgentCoordinator, e as DispatchCandidate, f as DispatchClassifier, g as DispatchMethod, h as DispatchOptions, i as DispatchResult, j as MultiAgentCoordinatorOptions, k as dispatchAgent, m as makeLLMClassifier, s as scoreAgents } from './multi-agent-coordinator-IQKrMfXz.js';
 export { A as AgentFactory, a as AgentFactoryResult, b as AgentRunnerOptions, F as FleetBus, c as FleetEvent, d as FleetHandler, e as FleetUsage, f as FleetUsageAggregator, S as SubagentUsageSnapshot, m as makeAgentSubagentRunner } from './agent-subagent-runner-Cav3yEJM.js';
 export { DefaultModeStore, LLMSelector, LLMSelectorOptions, ModeLoaderOptions, loadProjectModes, loadUserModes } from './models/index.js';
-export { AISpecBuilder, AISpecBuilderOptions, AISpecPhase, AISpecSession, AutoExecutor, AutoExecutorOptions, BottleneckTask, CollectedAnswer, CriticalPathAnalysis, DefaultTaskStore, ExecutionSummary, GeneratedTask, SPEC_TEMPLATES, SddParallelRun, SddParallelRunOptions, SddProgress, SddTaskDecomposer, SddTaskDecomposerOptions, SpecDiff, SpecDrivenDev, SpecDrivenDevOptions, SpecIndexEntry, SpecParser, SpecStore, SpecStoreOptions, SpecVersion, SpecVersioning, TaskBatch, TaskExecutionContext, TaskExecutionResult, TaskFlow, TaskFlowEventMap, TaskFlowEventName, TaskFlowExecutionContext, TaskFlowOptions, TaskFlowPhase, TaskGenerator, TaskGeneratorOptions, TaskGraphIndexEntry, TaskGraphStore, TaskGraphStoreOptions, TaskStore, TaskTracker, TaskTrackerOptions, TaskTransition, WaveResult, analyzeCriticalPath, createAutoExecutor, getTemplate, listTemplates, renderProgress, renderSpecAnalysis, renderTaskGraph, renderTaskList, templateToMarkdown } from './sdd/index.js';
+import { TaskStore } from './sdd/index.js';
+export { AISpecBuilder, AISpecBuilderOptions, AISpecPhase, AISpecSession, AutoExecutor, AutoExecutorOptions, BottleneckTask, CollectedAnswer, CriticalPathAnalysis, DefaultTaskStore, ExecutionSummary, GeneratedTask, SPEC_TEMPLATES, SddParallelRun, SddParallelRunOptions, SddProgress, SddTaskDecomposer, SddTaskDecomposerOptions, SpecDiff, SpecDrivenDev, SpecDrivenDevOptions, SpecIndexEntry, SpecParser, SpecStore, SpecStoreOptions, SpecVersion, SpecVersioning, TaskBatch, TaskExecutionContext, TaskExecutionResult, TaskFlow, TaskFlowEventMap, TaskFlowEventName, TaskFlowExecutionContext, TaskFlowOptions, TaskFlowPhase, TaskGenerator, TaskGeneratorOptions, TaskGraphIndexEntry, TaskGraphStore, TaskGraphStoreOptions, TaskTracker, TaskTrackerOptions, TaskTransition, WaveResult, analyzeCriticalPath, createAutoExecutor, getTemplate, listTemplates, renderProgress, renderSpecAnalysis, renderTaskGraph, renderTaskList, templateToMarkdown } from './sdd/index.js';
 export { DefaultHealthRegistry, InMemoryMetricsSink, MetricsServerHandle, MetricsServerOptions, NoopMetricsSink, NoopTracer, OTelTracer, OtlpMetricsExporterHandle, OtlpMetricsExporterOptions, OtlpTraceExporterHandle, OtlpTraceExporterOptions, PROMETHEUS_CONTENT_TYPE, buildOtlpMetricsRequest, buildOtlpTracesRequest, renderPrometheus, startMetricsServer, startOtlpMetricsExporter, startOtlpTraceExporter, wireMetricsToEvents } from './observability/index.js';
 export { C as ContextManagerAction, a as ContextManagerInput, b as ContextManagerResult, c as ContextManagerToolOptions, d as allServers, e as awsServer, f as blockServer, g as braveSearchServer, h as context7Server, i as contextManagerTool, j as createContextManagerTool, k as everArtServer, l as filesystemServer, m as githubServer, n as googleMapsServer, o as miniMaxVisionServer, s as sentinelServer, p as slackServer, z as zaiVisionServer } from './mcp-servers-n2L9ohMX.js';
 export { DownloadResult, InstallResult, InstalledSkillEntry, ManifestData, ParsedRef, SkillInstaller, SkillInstallerOptions, SkillManifestStore, UpdateResult, downloadGitHubTarball, parseSkillRef } from './skills/index.js';
@@ -808,4 +810,494 @@ declare function loadPlugins(plugins: Plugin[], opts: LoadPluginsOptions): Promi
  */
 declare function unloadPlugins(loadedPlugins: Plugin[], opts: LoadPluginsOptions): Promise<void>;
 
-export { AddAttachmentInput, AttachmentRef, AttachmentStore, BuildContext, Config, Container, ContentBlock, Context, type ContinueDirective, DefaultPluginAPI, DefaultSystemPromptBuilder, type DefaultSystemPromptBuilderOptions, type DetectedDependency, type DetectionResult, EventBus, EventName, ExtensionRegistry, type Finding, type FullScanResult, type GeneratedSecuritySkill, type GeneratedSkill, type GeneratedSkillContent, GitignoreUpdater, InputBuilder, type InputBuilderEvent, type InputBuilderOptions, KERNEL_API_VERSION, LAYER_1_IDENTITY, Listener, type LoadPluginsOptions, Logger, type MCPRegistryHandle, MCPRegistryView, MCPServerConfig, MemoryStore, MetricsSinkView, ModeStore, ModelCapabilities, type PackageManager, Plugin, PluginAPI, type PluginAPIInit, PluginPipelines, Provider, ProviderRegistry, ProviderRegistryView, ReportGenerator, type ReportOptions, type ScanOptions, type ScanResult, type ScanScope, type SecurityPattern, SecurityScanner, type SecurityScannerContext, type SecurityScannerOptions, SecurityScannerOrchestrator, SessionWriterView, type SeverityLevel, type SkillGenerationContext, SkillGenerator, type SkillGeneratorOptions, SkillLoader, SlashCommand, SlashCommandRegistry, SlashCommandRegistryView, SystemPromptBuilder, SystemPromptContributor, type TechStack, TechStackDetector, type TechStackInfo, TextBlock, Tool, ToolRegistry, ToolRegistryView, buildBtwBlock, consumeBtwNotes, createMcpControlTool, createSecuritySlashCommand, defaultGitignoreUpdater, defaultOrchestrator, defaultReportGenerator, defaultSecurityScanner, defaultSkillGenerator, defaultTechStackDetector, loadPlugins, makeContinueToNextIterationTool, parseContinueDirective, pendingBtwCount, securitySlashCommand, setBtwNote, unloadPlugins };
+type PhaseStatus = 'pending' | 'ready' | 'running' | 'paused' | 'completed' | 'failed' | 'skipped';
+interface PhaseNode {
+    id: string;
+    /** Faz adı, örn: "Discovery", "Design", "Implementation", "Testing" */
+    name: string;
+    description: string;
+    status: PhaseStatus;
+    /** Bu fazın görev grafiği */
+    taskGraph: TaskGraph;
+    /** Önceki faz ID'leri — bunlar tamamlanmadan bu faz başlayamaz */
+    dependsOn: string[];
+    /** Sonraki faz ID'leri */
+    nextPhases: string[];
+    /** Bu faz parallel çalışabilir mi? (önceki faz bitmeden başlayabilir) */
+    parallelizable: boolean;
+    /** Faz önceliği */
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    /** Tahmini süre (saat) */
+    estimateHours: number;
+    /** Gerçekleşen süre (ms) */
+    actualDurationMs?: number;
+    /** Başlangıç zamanı */
+    startedAt?: number;
+    /** Bitiş zamanı */
+    completedAt?: number;
+    /** Bu fazda atanmış agent'lar */
+    assignedAgents: string[];
+    /** Faz metadata */
+    metadata?: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+}
+interface PhaseGraph {
+    id: string;
+    /** Proje başlığı */
+    title: string;
+    description: string;
+    phases: Map<string, PhaseNode>;
+    /** Başlangıç faz ID'leri */
+    rootPhaseIds: string[];
+    /** Aktif faz ID'leri (running durumunda olanlar) */
+    activePhaseIds: string[];
+    /** Tamamlanan faz ID'leri */
+    completedPhaseIds: string[];
+    /** Başarısız faz ID'leri */
+    failedPhaseIds: string[];
+    /** Otonom mod aktif mi? */
+    autonomous: boolean;
+    /** Tüm fazlar tamamlandığında dur */
+    stopOnComplete: boolean;
+    createdAt: number;
+    updatedAt: number;
+    startedAt?: number;
+    completedAt?: number;
+}
+interface PhaseProgress {
+    totalPhases: number;
+    pending: number;
+    ready: number;
+    running: number;
+    paused: number;
+    completed: number;
+    failed: number;
+    skipped: number;
+    percentComplete: number;
+    totalTasks: number;
+    completedTasks: number;
+    failedTasks: number;
+    estimatedHours: number;
+    actualHours: number;
+}
+interface PhaseEventMap {
+    'phase.statusChange': {
+        phaseId: string;
+        from: PhaseStatus;
+        to: PhaseStatus;
+    };
+    'phase.started': {
+        phaseId: string;
+        name: string;
+    };
+    'phase.completed': {
+        phaseId: string;
+        name: string;
+        durationMs: number;
+    };
+    'phase.failed': {
+        phaseId: string;
+        name: string;
+        error?: string;
+    };
+    'phase.taskCompleted': {
+        phaseId: string;
+        taskId: string;
+        taskTitle: string;
+    };
+    'phase.taskFailed': {
+        phaseId: string;
+        taskId: string;
+        taskTitle: string;
+        error: string;
+    };
+    'phase.taskRetrying': {
+        phaseId: string;
+        taskId: string;
+        taskTitle: string;
+        attempt: number;
+        maxRetries: number;
+    };
+    'phase.allTasksDone': {
+        phaseId: string;
+        completed: number;
+        failed: number;
+    };
+    'graph.completed': {
+        graphId: string;
+        durationMs: number;
+    };
+    'graph.failed': {
+        graphId: string;
+        failedPhaseId: string;
+        error: string;
+    };
+    'autonomous.tick': {
+        activePhases: string[];
+        queuedPhases: string[];
+    };
+    'agent.assigned': {
+        phaseId: string;
+        agentId: string;
+    };
+    'agent.released': {
+        phaseId: string;
+        agentId: string;
+    };
+}
+type PhaseEventName = keyof PhaseEventMap;
+interface PhaseExecutionContext {
+    /** Bir görevi çalıştır — AI agent tarafından yapılır */
+    executeTask: (task: TaskNode, phaseId: string) => Promise<unknown>;
+    /** Bir faz tamamlandığında çağrılır */
+    onPhaseComplete?: (phase: PhaseNode) => void;
+    /** Bir faz başarısız olduğunda çağrılır */
+    onPhaseFail?: (phase: PhaseNode, error: Error) => void;
+    /** Her tick'te çağrılır (otonom modda) */
+    onTick?: (ctx: {
+        activePhases: PhaseNode[];
+        readyPhases: PhaseNode[];
+    }) => void;
+}
+interface AutoPhaseOptions {
+    /** Maksimum parallel faz sayısı */
+    maxConcurrentPhases?: number;
+    /** Maksimum parallel görev sayısı (faz içinde) */
+    maxConcurrentTasks?: number;
+    /** Başarısız görev retry sayısı */
+    maxRetries?: number;
+    /** Otonom mod: faz tamamlandıkça otomatik sonrakine geç */
+    autonomous?: boolean;
+    /** Fazlar arası bekleme süresi (ms) */
+    phaseDelayMs?: number;
+    /** Bir faz failed olursa dur */
+    stopOnFailure?: boolean;
+    /** Event bus */
+    events?: EventBus;
+}
+interface PhaseFilter {
+    status?: PhaseStatus[];
+    priority?: PhaseNode['priority'][];
+}
+interface PhaseSort {
+    field: 'priority' | 'createdAt' | 'startedAt' | 'completedAt';
+    direction: 'asc' | 'desc';
+}
+interface PhaseTemplate {
+    name: string;
+    description: string;
+    priority: PhaseNode['priority'];
+    estimateHours: number;
+    parallelizable: boolean;
+    /** Otomatik oluşturulacak task şablonları */
+    taskTemplates?: Array<{
+        title: string;
+        description: string;
+        type: TaskType;
+        priority: TaskPriority;
+        estimateHours: number;
+        tags?: string[];
+    }>;
+}
+
+interface AutoPhaseRunnerOptions extends AutoPhaseOptions {
+    /** Proje başlığı */
+    title: string;
+    description?: string;
+    /** Faz şablonları */
+    phases: PhaseTemplate[];
+    /** Task çalıştırma fonksiyonu */
+    executeTask: (task: TaskNode, phaseId: string) => Promise<unknown>;
+    /** Faz tamamlandığında */
+    onPhaseComplete?: (phase: PhaseNode) => void;
+    /** Faz başarısız olduğunda */
+    onPhaseFail?: (phase: PhaseNode, error: Error) => void;
+    /** Her tick'te */
+    onTick?: (ctx: {
+        activePhases: PhaseNode[];
+        readyPhases: PhaseNode[];
+    }) => void;
+    /** Progress değiştiğinde */
+    onProgress?: (progress: PhaseProgress) => void;
+    /** Graph tamamlandığında */
+    onComplete?: (graph: PhaseGraph) => void;
+    /** Graph başarısız olduğunda */
+    onFail?: (graph: PhaseGraph, failedPhase: PhaseNode, error: Error) => void;
+}
+/**
+ * AutoPhaseRunner — Tek bir entry point'ten tüm otonom faz akışını yöneten üst seviye API.
+ *
+ * Kullanım:
+ *   const runner = new AutoPhaseRunner({
+ *     title: 'Auth Refactor',
+ *     phases: [...],
+ *     executeTask: async (task, phaseId) => { ... },
+ *     onProgress: (p) => console.log(`${p.percentComplete}% done`),
+ *   });
+ *   await runner.start();
+ */
+declare class AutoPhaseRunner {
+    private graph;
+    private orchestrator;
+    private opts;
+    private progressInterval;
+    private readonly graphCompletedHandler;
+    private readonly graphFailedHandler;
+    /** Stores the unsubscribe function returned by EventBus.on() */
+    private unsubscribeCompleted;
+    private unsubscribeFailed;
+    constructor(opts: AutoPhaseRunnerOptions);
+    start(): Promise<PhaseGraph>;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    getProgress(): PhaseProgress | null;
+    getGraph(): PhaseGraph | null;
+    isRunning(): boolean;
+    isPaused(): boolean;
+    assignAgent(phaseId: string, agentId: string): void;
+    releaseAgent(phaseId: string, agentId: string): void;
+    private cleanup;
+}
+/**
+ * Quick-start helper: Var olan bir TaskGraph'tan AutoPhaseRunner oluştur.
+ */
+declare function createAutoPhaseFromTaskGraph(taskGraph: TaskGraph, options: Omit<AutoPhaseRunnerOptions, 'phases' | 'title'> & {
+    title?: string;
+    tasksPerPhase?: number;
+}): Promise<AutoPhaseRunner>;
+
+interface PhaseOrchestratorOptions extends AutoPhaseOptions {
+    graph: PhaseGraph;
+    ctx: PhaseExecutionContext;
+}
+/**
+ * PhaseOrchestrator — Fazları dependency-aware, otonom olarak çalıştıran motor.
+ *
+ * Özellikler:
+ * - Bir faz tamamlandıkça sonrakini otomatik başlatır (autonomous mode)
+ * - Parallel faz desteği (parallelizable=true)
+ * - Agent atama / serbest bırakma
+ * - Event bus entegrasyonu
+ * - Pause / resume desteği
+ */
+declare class PhaseOrchestrator {
+    private graph;
+    private ctx;
+    private opts;
+    private events;
+    private stopped;
+    private paused;
+    private runningPhases;
+    private tickInterval;
+    private trackerCache;
+    private taskRetryCounts;
+    constructor(opts: PhaseOrchestratorOptions);
+    /**
+     * Tüm faz akışını başlat.
+     * Autonomous mode'da: kök faz(lar)ı başlatır, bitince sonrakini otomatik başlatır.
+     */
+    start(): Promise<void>;
+    /** Duraklat — aktif fazlar çalışmaya devam eder ama yeni faz başlamaz */
+    pause(): void;
+    /** Devam et — yeni fazlar başlayabilir */
+    resume(): void;
+    /** Tamamen durdur — aktif fazlar da durdurulur */
+    stop(): void;
+    private tick;
+    private startPhase;
+    private executePhaseTasks;
+    private executeSingleTask;
+    private markTaskCompleted;
+    private markTaskFailed;
+    private getReadyPhases;
+    private getActivePhases;
+    private getExecutableTasks;
+    private getTrackerForPhase;
+    private getFailedTaskCount;
+    private getCompletedTaskCount;
+    private updatePhaseStatus;
+    private isComplete;
+    private onGraphComplete;
+    private onGraphFailed;
+    getProgress(): PhaseProgress;
+    getGraph(): PhaseGraph;
+    isRunning(): boolean;
+    isPaused(): boolean;
+    assignAgent(phaseId: string, agentId: string): void;
+    releaseAgent(phaseId: string, agentId: string): void;
+    private emit;
+    private createNoopEventBus;
+    private delay;
+}
+
+interface PhaseGraphBuilderOptions {
+    title: string;
+    description?: string;
+    /** Faz şablonları (sıralı) */
+    phases: PhaseTemplate[];
+    /** Otonom mod */
+    autonomous?: boolean;
+    /** Başarısızlıkta dur */
+    stopOnFailure?: boolean;
+    /** Harici TaskStore (opsiyonel) */
+    externalTaskStore?: TaskStore;
+}
+/**
+ * PhaseGraphBuilder — Projeyi fazlara bölen ve her faz için task graph oluşturan builder.
+ *
+ * Kullanım:
+ *   const builder = new PhaseGraphBuilder({
+ *     title: 'Auth System Refactor',
+ *     phases: [
+ *       { name: 'Discovery', description: '...', priority: 'high', estimateHours: 2, parallelizable: false },
+ *       { name: 'Design', description: '...', priority: 'critical', estimateHours: 4, parallelizable: false },
+ *       { name: 'Implementation', description: '...', priority: 'critical', estimateHours: 12, parallelizable: false },
+ *       { name: 'Testing', description: '...', priority: 'high', estimateHours: 6, parallelizable: true },
+ *       { name: 'Deployment', description: '...', priority: 'medium', estimateHours: 2, parallelizable: false },
+ *     ]
+ *   });
+ *   const graph = await builder.build();
+ */
+declare class PhaseGraphBuilder {
+    private readonly opts;
+    constructor(opts: PhaseGraphBuilderOptions);
+    build(): Promise<PhaseGraph>;
+    /**
+     * Var olan bir TaskGraph'tan fazlar oluştur.
+     * Task'ları priority/type göre gruplayarak fazlara ayırır.
+     */
+    static fromTaskGraph(taskGraph: TaskGraph, options: Omit<PhaseGraphBuilderOptions, 'phases'> & {
+        /** Faz başına düşen task sayısı (default: 5) */
+        tasksPerPhase?: number;
+    }): Promise<PhaseGraph>;
+}
+
+/**
+ * AutoPhasePlanner — Bir hedefi (goal) gerçek bir LLM çağrısıyla faz faz,
+ * her fazın altında bir sürü todo içeren büyük bir task listesine dönüştürür.
+ *
+ * SDD'nin spec→task akışına benzer ama farklı: burada çıktı doğrudan
+ * `PhaseTemplate[]` — her faz `taskTemplates` taşır, böylece
+ * `PhaseGraphBuilder` dolu bir `PhaseGraph` üretir ve `PhaseOrchestrator`
+ * her görevi gerçek bir agent koşusuyla çalıştırır.
+ *
+ * Planner LLM'e bağımlı değildir: çağıran taraf bir `runOnce(prompt)` fonksiyonu
+ * verir (CLI'de bu bir subagent koşusudur, testte bir stub olabilir).
+ */
+
+interface AutoPhasePlannerOptions {
+    /**
+     * Tek seferlik LLM çağrısı: prompt verir, modelin metin çıktısını döndürür.
+     * CLI'de bir subagent.run sarmalayıcısıdır; testte deterministik stub.
+     */
+    runOnce: (prompt: string) => Promise<string>;
+    /** Hedef/proje başlığı. */
+    goal: string;
+    /** package.json/dizin yapısı gibi opsiyonel proje bağlamı. */
+    projectContext?: string;
+    /** İstenen minimum faz sayısı (default 3). */
+    minPhases?: number;
+    /** İstenen maksimum faz sayısı (default 8). */
+    maxPhases?: number;
+    /** Faz başına hedeflenen todo sayısı (default 6). */
+    todosPerPhase?: number;
+}
+interface AutoPhasePlanResult {
+    /** PhaseGraphBuilder'a verilecek faz şablonları. */
+    phases: PhaseTemplate[];
+    /** Modelin ham çıktısı (debug/log için). */
+    raw: string;
+    /** JSON ayrıştırılamadıysa true; bu durumda `phases` boş döner. */
+    parseFailed: boolean;
+}
+/**
+ * AutoPhasePlanner — `plan()` çağrısı modeli sürer ve `PhaseTemplate[]` üretir.
+ */
+declare class AutoPhasePlanner {
+    private readonly opts;
+    constructor(opts: AutoPhasePlannerOptions);
+    /** Hedefi faz+todo planına dönüştür. */
+    plan(): Promise<AutoPhasePlanResult>;
+    /** Modelin üreteceği plan için talimat prompt'u. */
+    buildPrompt(): string;
+    /** Ham çıktıdan JSON'u çıkar, doğrula ve PhaseTemplate[]'e dönüştür. */
+    parse(raw: string): PhaseTemplate[];
+    private coercePhase;
+    private coerceTask;
+}
+
+interface PhaseStoreOptions {
+    baseDir: string;
+}
+/**
+ * PhaseStore — PhaseGraph'ı diske kaydeden ve yükleyen persistence katmanı.
+ */
+declare class PhaseStore {
+    readonly baseDir: string;
+    constructor(opts: PhaseStoreOptions);
+    save(graph: PhaseGraph): Promise<void>;
+    load(graphId: string): Promise<PhaseGraph | null>;
+    delete(graphId: string): Promise<void>;
+    list(): Promise<Array<{
+        id: string;
+        title: string;
+        updatedAt: number;
+        status: string;
+    }>>;
+    private getFilePath;
+    private serializeGraph;
+    private serializePhase;
+    private serializeTaskGraph;
+    private serializeTaskNode;
+    private deserializeGraph;
+    private deserializePhase;
+    private deserializeTaskGraph;
+}
+
+interface Checkpoint {
+    id: string;
+    graphId: string;
+    phaseId: string;
+    phaseStatus: PhaseNode['status'];
+    taskStatuses: Array<{
+        taskId: string;
+        status: string;
+        title: string;
+    }>;
+    timestamp: number;
+    label?: string;
+}
+interface CheckpointManagerOptions {
+    store: PhaseStore;
+    maxCheckpoints?: number;
+    baseDir?: string;
+}
+/**
+ * CheckpointManager — Phase graph'ın anlık görüntülerini alır ve geri yükler.
+ *
+ * Kullanım:
+ *   const cm = new CheckpointManager({ store });
+ *   await cm.saveCheckpoint(graph, 'Before risky refactor');
+ *   // ... işler ters giderse ...
+ *   const restored = await cm.restoreCheckpoint(checkpointId);
+ */
+declare class CheckpointManager {
+    private store;
+    private maxCheckpoints;
+    private checkpoints;
+    private baseDir;
+    constructor(opts: CheckpointManagerOptions);
+    initialize(): Promise<void>;
+    saveCheckpoint(graph: PhaseGraph, label?: string): Promise<Checkpoint>;
+    restoreCheckpoint(checkpointId: string): Promise<PhaseGraph | null>;
+    listCheckpoints(graphId?: string): Checkpoint[];
+    deleteCheckpoint(checkpointId: string): Promise<boolean>;
+    private saveToDisk;
+    private deleteFromDisk;
+    private loadFromDisk;
+    private pruneCheckpoints;
+}
+
+export { AddAttachmentInput, AttachmentRef, AttachmentStore, type AutoPhaseOptions, type AutoPhasePlanResult, AutoPhasePlanner, type AutoPhasePlannerOptions, AutoPhaseRunner, type AutoPhaseRunnerOptions, BuildContext, type Checkpoint, CheckpointManager, type CheckpointManagerOptions, Config, Container, ContentBlock, Context, type ContinueDirective, DefaultPluginAPI, DefaultSystemPromptBuilder, type DefaultSystemPromptBuilderOptions, type DetectedDependency, type DetectionResult, EventBus, EventName, ExtensionRegistry, type Finding, type FullScanResult, type GeneratedSecuritySkill, type GeneratedSkill, type GeneratedSkillContent, GitignoreUpdater, InputBuilder, type InputBuilderEvent, type InputBuilderOptions, KERNEL_API_VERSION, LAYER_1_IDENTITY, Listener, type LoadPluginsOptions, Logger, type MCPRegistryHandle, MCPRegistryView, MCPServerConfig, MemoryStore, MetricsSinkView, ModeStore, ModelCapabilities, type PackageManager, type PhaseEventMap, type PhaseEventName, type PhaseExecutionContext, type PhaseFilter, type PhaseGraph, PhaseGraphBuilder, type PhaseGraphBuilderOptions, type PhaseNode, PhaseOrchestrator, type PhaseOrchestratorOptions, type PhaseProgress, type PhaseSort, type PhaseStatus, PhaseStore, type PhaseStoreOptions, type PhaseTemplate, Plugin, PluginAPI, type PluginAPIInit, PluginPipelines, Provider, ProviderRegistry, ProviderRegistryView, ReportGenerator, type ReportOptions, type ScanOptions, type ScanResult, type ScanScope, type SecurityPattern, SecurityScanner, type SecurityScannerContext, type SecurityScannerOptions, SecurityScannerOrchestrator, SessionWriterView, type SeverityLevel, type SkillGenerationContext, SkillGenerator, type SkillGeneratorOptions, SkillLoader, SlashCommand, SlashCommandRegistry, SlashCommandRegistryView, SystemPromptBuilder, SystemPromptContributor, TaskGraph, TaskNode, TaskPriority, TaskStore, TaskType, type TechStack, TechStackDetector, type TechStackInfo, TextBlock, Tool, ToolRegistry, ToolRegistryView, buildBtwBlock, consumeBtwNotes, createAutoPhaseFromTaskGraph, createMcpControlTool, createSecuritySlashCommand, defaultGitignoreUpdater, defaultOrchestrator, defaultReportGenerator, defaultSecurityScanner, defaultSkillGenerator, defaultTechStackDetector, loadPlugins, makeContinueToNextIterationTool, parseContinueDirective, pendingBtwCount, securitySlashCommand, setBtwNote, unloadPlugins };