@wrongstack/core 0.8.4 → 0.8.6

package/dist/extension/index.d.ts

@@ -1,9 +1,9 @@
-export { A as AfterIterationHook, a as AfterRunHook, b as AfterToolExecutionHook, d as AgentExtension, B as BeforeIterationHook, h as BeforeRunHook, i as BeforeToolExecutionHook, E as ExtensionRegistry, O as OnErrorHook, s as ProviderRunnerFn, t as ProviderRunnerWrapper } from '../index-oYZeWsuJ.js';
+export { A as AfterIterationHook, a as AfterRunHook, b as AfterToolExecutionHook, d as AgentExtension, B as BeforeIterationHook, h as BeforeRunHook, i as BeforeToolExecutionHook, E as ExtensionRegistry, O as OnErrorHook, s as ProviderRunnerFn, t as ProviderRunnerWrapper } from '../index-SxpnwRlJ.js';
 import '../context-z2x5gv_V.js';
 import '../logger-DDd5C--Z.js';
 import '../system-prompt-CWA6ml-d.js';
 import '../observability-BhnVLBLS.js';
-import '../events-DyhxkstG.js';
+import '../events-yCpJD4wa.js';
 import '../secret-scrubber-CyE1-EMG.js';
 import '../config-Bi4Q0fnz.js';
 import '../models-registry-BcYJDKLm.js';

package/dist/index-BvZld4Dr.d.ts

@@ -0,0 +1,200 @@
+import { T as Token, e as Renderer, S as SystemPromptBuilder } from './system-prompt-CWA6ml-d.js';
+import { E as EventBus } from './events-yCpJD4wa.js';
+import { a as Compactor } from './compactor-Mw7-rNyb.js';
+import { b as ConfigLoader, c as ConfigStore } from './config-Bi4Q0fnz.js';
+import { E as ErrorHandler, a as RetryPolicy } from './retry-policy-OwtKNxo8.js';
+import { I as InputReader } from './input-reader-E-ffP2ee.js';
+import { a as Logger } from './logger-DDd5C--Z.js';
+import { b as MemoryStore } from './memory-CEXuo7sz.js';
+import { c as ModeStore } from './mode-CV077NjV.js';
+import { b as ModelsRegistry } from './models-registry-BcYJDKLm.js';
+import { P as PathResolver } from './path-resolver-CPRj4bFY.js';
+import { a as PermissionPolicy, S as SecretScrubber } from './secret-scrubber-CyE1-EMG.js';
+import { P as ProviderRunner } from './provider-runner-C4ouU7--.js';
+import { O as TokenCounter, y as SessionStore } from './context-z2x5gv_V.js';
+import { a as SkillLoader } from './skill-CxuWrsKK.js';
+
+/**
+ * Lifecycle of a single worktree handle.
+ *
+ *   allocating → active → committing → merging → merged
+ *                                            └─→ needs-review (conflict, kept)
+ *   (any)      → failed
+ */
+type WorktreeStatus = 'allocating' | 'active' | 'committing' | 'merging' | 'merged' | 'needs-review' | 'failed';
+interface WorktreeHandle {
+    /** Stable id (== slug). Used as the event `handleId`. */
+    id: string;
+    /** Caller-supplied owner (a phase id in AutoPhase). */
+    ownerId: string;
+    /** Human label for the owner (phase name). */
+    ownerLabel: string;
+    slug: string;
+    /** Absolute path to the worktree checkout. */
+    dir: string;
+    /** Branch checked out in the worktree (`wstack/ap/<slug>`). */
+    branch: string;
+    /** Branch the worktree was forked from and merges back into. */
+    baseBranch: string;
+    status: WorktreeStatus;
+    createdAt: number;
+    updatedAt: number;
+    /** Diff stats from the last commit. */
+    insertions: number;
+    deletions: number;
+    files: number;
+    sha?: string;
+    lastError?: string;
+    conflictFiles?: string[];
+}
+interface AllocateOpts {
+    /** Friendly basis for the slug/branch (e.g. the phase name). */
+    slugHint?: string;
+    ownerLabel?: string;
+    /** Override the detected base branch. */
+    baseBranch?: string;
+}
+interface MergeOpts {
+    squash?: boolean;
+    message?: string;
+}
+interface MergeResult {
+    ok: boolean;
+    conflict?: boolean;
+    conflictFiles?: string[];
+    stderr?: string;
+}
+interface RunResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+interface WorktreeManagerOptions {
+    projectRoot: string;
+    events?: EventBus;
+    gitBin?: string;
+    /**
+     * Test seam. When provided, replaces the real `git` spawn so the manager's
+     * sequencing/arg vectors can be asserted without touching a repo.
+     */
+    run?: (args: string[], cwd: string) => Promise<RunResult>;
+}
+/**
+ * Owns the git-worktree lifecycle for isolated, parallel work units. Shells out
+ * to `git` directly (never via the `git` *tool*) so it can target arbitrary
+ * worktree directories without the tool's permission gate or `findGitDir`
+ * resolution, and so `@wrongstack/core` keeps no dependency on `@wrongstack/tools`.
+ */
+declare class WorktreeManager {
+    private readonly projectRoot;
+    private readonly events?;
+    private readonly gitBin;
+    private readonly runGit;
+    /** Keyed by ownerId. */
+    private readonly handles;
+    private readonly usedSlugs;
+    constructor(opts: WorktreeManagerOptions);
+    /** Create a fresh worktree + branch forked from the current base branch. */
+    allocate(ownerId: string, opts?: AllocateOpts): Promise<WorktreeHandle>;
+    /** Stage everything and commit inside the worktree. */
+    commitAll(handle: WorktreeHandle, message: string): Promise<{
+        committed: boolean;
+    }>;
+    /** Merge the worktree branch back into the base branch (squash by default). */
+    merge(handle: WorktreeHandle, opts?: MergeOpts): Promise<MergeResult>;
+    /**
+     * Remove the worktree + branch. Conflicted/failed handles (or `keep:true`)
+     * are left on disk for inspection.
+     */
+    release(handle: WorktreeHandle, opts?: {
+        keep?: boolean;
+    }): Promise<void>;
+    get(ownerId: string): WorktreeHandle | undefined;
+    list(): WorktreeHandle[];
+    private worktreesRoot;
+    private detectBaseBranch;
+    private makeSlug;
+    private collectStats;
+    private unmergedFiles;
+    private emitCommitted;
+    private fail;
+    private setStatus;
+    private emit;
+    private defaultRun;
+}
+/** Throw if `dir` resolves outside `projectRoot`. */
+declare function assertSafePath(dir: string, projectRoot: string): void;
+
+declare const TOKENS: {
+    readonly Logger: Token<Logger>;
+    readonly TokenCounter: Token<TokenCounter>;
+    readonly SessionStore: Token<SessionStore>;
+    readonly MemoryStore: Token<MemoryStore>;
+    readonly PermissionPolicy: Token<PermissionPolicy>;
+    readonly Compactor: Token<Compactor>;
+    readonly PathResolver: Token<PathResolver>;
+    readonly ConfigLoader: Token<ConfigLoader>;
+    readonly ConfigStore: Token<ConfigStore>;
+    readonly Renderer: Token<Renderer>;
+    readonly InputReader: Token<InputReader>;
+    readonly ErrorHandler: Token<ErrorHandler>;
+    readonly RetryPolicy: Token<RetryPolicy>;
+    readonly SkillLoader: Token<SkillLoader>;
+    readonly SystemPromptBuilder: Token<SystemPromptBuilder>;
+    readonly SecretScrubber: Token<SecretScrubber>;
+    readonly ModelsRegistry: Token<ModelsRegistry>;
+    readonly ModeStore: Token<ModeStore>;
+    /** Replaces the entire provider call layer — retry, streaming, tracing. */
+    readonly ProviderRunner: Token<ProviderRunner>;
+    /** Optional git-worktree lifecycle manager (per-phase isolation in AutoPhase). */
+    readonly WorktreeManager: Token<WorktreeManager>;
+};
+
+/**
+ * RunController centralises abort + cleanup for a single agent run. It
+ * wraps a single AbortController and exposes a registry of teardown
+ * hooks that fire (LIFO, exactly once) when the run aborts OR ends
+ * normally. Anyone holding the controller can:
+ *
+ *   - read `signal` to bail out cooperatively
+ *   - call `abort(reason?)` to abort the run
+ *   - call `onAbort(fn)` to register a cleanup hook
+ *   - call `dispose()` when the run ends normally — this fires the
+ *     hooks too, so cleanup runs regardless of outcome
+ *
+ * Hooks must be idempotent and synchronous-or-quick. Errors thrown
+ * inside hooks are caught and surfaced through `errorSink` (or the
+ * console as a last resort) so one bad hook can't block the others.
+ */
+interface RunControllerOptions {
+    /** Optional parent signal — abort propagates from parent → this. */
+    parentSignal?: AbortSignal;
+    /** Receives errors thrown by cleanup hooks. Defaults to console.warn. */
+    errorSink?: (err: unknown, where: string) => void;
+}
+declare class RunController {
+    private readonly ctrl;
+    private readonly hooks;
+    private disposed;
+    private hooksDrained;
+    private readonly errorSink;
+    constructor(opts?: RunControllerOptions);
+    get signal(): AbortSignal;
+    get aborted(): boolean;
+    abort(reason?: unknown): void;
+    /**
+     * Register a teardown hook. Returns an unsubscribe function so callers
+     * can opt out before the hook fires (e.g. when a tool finishes cleanly
+     * before abort happens).
+     */
+    onAbort(fn: () => void | Promise<void>): () => void;
+    /**
+     * Fire cleanup hooks and tear down listeners — called when the run
+     * ends *normally* so cleanup happens regardless of outcome. Subsequent
+     * aborts become no-ops.
+     */
+    dispose(): Promise<void>;
+    private runHooks;
+}
+
+export { type AllocateOpts as A, type MergeOpts as M, RunController as R, TOKENS as T, type WorktreeHandle as W, type MergeResult as a, type RunControllerOptions as b, type RunResult as c, WorktreeManager as d, type WorktreeManagerOptions as e, type WorktreeStatus as f, assertSafePath as g };

package/dist/{index-oYZeWsuJ.d.ts → index-SxpnwRlJ.d.ts}

@@ -2,7 +2,7 @@ import { Q as Tool, Y as ToolResultBlock, _ as ToolUseBlock, d as Context, T as
 import { a as Logger } from './logger-DDd5C--Z.js';
 import { e as Renderer, a as BuildContext, C as Container, P as Pipeline, R as ReadonlyPipeline } from './system-prompt-CWA6ml-d.js';
 import { T as Tracer } from './observability-BhnVLBLS.js';
-import { E as EventBus, c as EventName, L as Listener } from './events-DyhxkstG.js';
+import { E as EventBus, c as EventName, L as Listener } from './events-yCpJD4wa.js';
 import { a as PermissionPolicy, S as SecretScrubber } from './secret-scrubber-CyE1-EMG.js';
 import { l as ProviderConfig, a as Config } from './config-Bi4Q0fnz.js';
 import { W as WireFamily } from './models-registry-BcYJDKLm.js';

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import { S as SystemPromptBuilder, c as ModelCapabilities, a as BuildContext, C as Container } from './system-prompt-CWA6ml-d.js';
 export { B as BindOptions, D as Decorator, F as Factory, M as Middleware, b as MiddlewareHandler, N as NextFn, P as Pipeline, d as PipelineOptions, e as Renderer, T as Token } from './system-prompt-CWA6ml-d.js';
-import { E as EventBus, c as EventName, L as Listener } from './events-DyhxkstG.js';
-export { a as EventLogger, b as EventMap, S as ScopedEventBus } from './events-DyhxkstG.js';
-export { RunController, RunControllerOptions, TOKENS } from './kernel/index.js';
+import { E as EventBus, c as EventName, L as Listener } from './events-yCpJD4wa.js';
+export { a as EventLogger, b as EventMap, S as ScopedEventBus } from './events-yCpJD4wa.js';
+import { d as WorktreeManager } from './index-BvZld4Dr.js';
+export { A as AllocateOpts, M as MergeOpts, a as MergeResult, R as RunController, b as RunControllerOptions, T as TOKENS, W as WorktreeHandle, e as WorktreeManagerOptions, c as WorktreeRunResult, f as WorktreeStatus, g as assertSafePath } from './index-BvZld4Dr.js';
 import { d as Context, m as Provider, Q as Tool, c as ContentBlock, T as TextBlock } from './context-z2x5gv_V.js';
 export { A as AgentError, a as Capabilities, b as ConfigError, e as ContextInit, f as ConversationState, E as ERROR_CODES, g as ErrorCode, h as ErrorSeverity, i as ErrorSubsystem, F as FileSnapshot, j as FsError, I as ImageBlock, J as JSONSchema, M as Message, k as MessageRole, P as Permission, l as PluginError, n as ProviderError, o as ProviderErrorBody, R as ReadonlyConversationState, p as Request, q as Response, r as ResumedSession, s as RiskTier, t as RunEnv, u as RunOptions, S as SessionData, v as SessionError, w as SessionEvent, x as SessionMetadata, y as SessionStore, z as SessionSummary, B as SessionWriter, D as StateChange, G as StateChangeHandler, H as StopReason, K as StreamEvent, L as ThinkingBlock, N as TodoItem, O as TokenCounter, U as ToolCallContext, V as ToolError, W as ToolFinalEvent, X as ToolProgressEvent, Y as ToolResultBlock, Z as ToolStreamEvent, _ as ToolUseBlock, $ as Usage, a0 as WrongStackError, a1 as asBlocks, a2 as asText, a3 as extractRunEnv, a4 as isAgentError, a5 as isConfigError, a6 as isFsError, a7 as isImageBlock, a8 as isPluginError, a9 as isSessionError, aa as isTextBlock, ab as isThinkingBlock, ac as isToolError, ad as isToolResultBlock, ae as isToolUseBlock, af as isWrongStackError, ag as toWrongStackError, ah as wrapAsState } from './context-z2x5gv_V.js';
-export { P as ProviderRunner, R as RunProviderOptions } from './provider-runner-BrA0XR-l.js';
+export { P as ProviderRunner, R as RunProviderOptions } from './provider-runner-C4ouU7--.js';
 import { M as MCPServerConfig, a as Config } from './config-Bi4Q0fnz.js';
 export { C as CONTEXT_WINDOW_MODES, b as ConfigLoader, c as ConfigStore, d as ContextConfig, e as ContextWindowAggressiveOn, f as ContextWindowConfigLike, g as ContextWindowMode, h as ContextWindowModeId, i as ContextWindowPolicy, j as ContextWindowThresholds, D as DEFAULT_CONTEXT_WINDOW_MODE_ID, F as FeaturesConfig, L as LogConfig, P as PluginConfig, k as ProviderApiKey, l as ProviderConfig, T as ToolsConfig, m as formatContextWindowModeList, n as getContextWindowMode, o as isContextWindowModeId, p as listContextWindowModes, r as resolveContextWindowPolicy } from './config-Bi4Q0fnz.js';
 export { C as CompactReport, a as Compactor } from './compactor-Mw7-rNyb.js';
@@ -16,35 +17,36 @@ export { a as Attachment, b as AttachmentKind, c as AttachmentMeta, D as Default
 export { D as DEFAULT_CONTEXT_CONFIG, a as DEFAULT_TOOLS_CONFIG } from './default-config-DvRSTELf.js';
 export { D as DefaultSecretScrubber, a as DefaultSecretVault, S as SecretVaultOptions, d as decryptConfigSecrets, e as encryptConfigSecrets, m as migratePlaintextSecrets, r as rewriteConfigEncrypted } from './secret-scrubber-C0n1EqrC.js';
 export { D as DefaultLogger, a as DefaultLoggerOptions } from './logger-bOzkF5LL.js';
-export { D as DefaultPathResolver, a as DefaultTokenCounter } from './path-resolver-1CIYbH2Q.js';
+export { D as DefaultPathResolver, a as DefaultTokenCounter } from './path-resolver-DnC1nOjb.js';
 import { b as MemoryStore } from './memory-CEXuo7sz.js';
 export { M as MemoryEntry, a as MemoryScope } from './memory-CEXuo7sz.js';
-export { C as CompactorOptions, D as DEFAULT_RECOVERY_STRATEGIES, a as DefaultErrorHandler, b as DefaultRetryPolicy, H as HybridCompactor, R as RecoveryStrategy, T as ToolExecutor, c as buildRecoveryStrategies } from './tool-executor-QwfWnQZ8.js';
+export { C as CompactorOptions, D as DEFAULT_RECOVERY_STRATEGIES, a as DefaultErrorHandler, b as DefaultRetryPolicy, H as HybridCompactor, R as RecoveryStrategy, T as ToolExecutor, c as buildRecoveryStrategies } from './tool-executor-Ch25BDwa.js';
 import { a as SkillLoader } from './skill-CxuWrsKK.js';
 export { S as SkillEntry, b as SkillManifest } from './skill-CxuWrsKK.js';
 export { I as InputReader, P as PromptOption } from './input-reader-E-ffP2ee.js';
-import { u as SlashCommand, w as SystemPromptContributor, k as PluginAPI, n as PluginPipelines, C as ToolRegistryView, r as ProviderRegistryView, M as MCPRegistryView, v as SlashCommandRegistryView, E as ExtensionRegistry, S as SessionWriterView, j as MetricsSinkView, z as ToolRegistry, q as ProviderRegistry, P as Plugin } from './index-oYZeWsuJ.js';
-export { A as AfterIterationHook, a as AfterRunHook, b as AfterToolExecutionHook, c as Agent, d as AgentExtension, e as AgentInit, f as AgentInput, g as AgentPipelines, B as BeforeIterationHook, h as BeforeRunHook, i as BeforeToolExecutionHook, D as DEFAULT_MAX_ITERATIONS, O as OnErrorHook, l as PluginCapabilities, m as PluginDependency, p as ProviderFactory, t as ProviderRunnerWrapper, R as RunResult, F as ToolWrapper, U as UserInputPayload, G as createDefaultPipelines } from './index-oYZeWsuJ.js';
+import { u as SlashCommand, w as SystemPromptContributor, k as PluginAPI, n as PluginPipelines, C as ToolRegistryView, r as ProviderRegistryView, M as MCPRegistryView, v as SlashCommandRegistryView, E as ExtensionRegistry, S as SessionWriterView, j as MetricsSinkView, z as ToolRegistry, q as ProviderRegistry, P as Plugin } from './index-SxpnwRlJ.js';
+export { A as AfterIterationHook, a as AfterRunHook, b as AfterToolExecutionHook, c as Agent, d as AgentExtension, e as AgentInit, f as AgentInput, g as AgentPipelines, B as BeforeIterationHook, h as BeforeRunHook, i as BeforeToolExecutionHook, D as DEFAULT_MAX_ITERATIONS, O as OnErrorHook, l as PluginCapabilities, m as PluginDependency, p as ProviderFactory, t as ProviderRunnerWrapper, R as RunResult, F as ToolWrapper, U as UserInputPayload, G as createDefaultPipelines } from './index-SxpnwRlJ.js';
 export { D as DefaultModelsRegistry, a as DefaultModelsRegistryOptions, c as classifyFamily } from './models-registry-OG_30xqZ.js';
 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 { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from './agent-bridge-Bad3ZGQ7.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-C8uY45AY.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-CJYrjQU8.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-Cqdy6rtM.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';
 export { DefaultProviderRunner } from './defaults/index.js';
-export { a as AGENTS_BY_PHASE, b as AGENT_CATALOG, c as ALL_AGENT_DEFINITIONS, d as ALL_FLEET_AGENTS, e as AUDIT_LOG_AGENT, f as AutoExtendCeiling, g as AutoExtendPolicy, B as BUG_HUNTER_AGENT, C as CreateDelegateToolOptions, D as DEFAULT_DIRECTOR_PREAMBLE, h as DEFAULT_SUBAGENT_BASELINE, i as DelegateHost, j as Director, k as DirectorPromptParts, l as DirectorSessionFactory, m as DirectorSessionFactoryOptions, F as FLEET_ROSTER, n as FLEET_ROSTER_BUDGETS, q as FleetManager, r as FleetManagerOptions, s as FleetRosterBudget, t as FleetSpawnBudgetError, I as ICoordinator, u as IFleetManager, N as NULL_FLEET_BUS, R as REFACTOR_PLANNER_AGENT, S as SECURITY_SCANNER_AGENT, v as SubagentPromptParts, w as applyRosterBudget, x as attachAutoExtend, y as composeDirectorPrompt, z as composeSubagentPrompt, E as createDelegateTool, G as getAgentDefinition, H as makeDirectorSessionFactory, J as rosterSummaryFromConfigs } from './null-fleet-bus-sKnVwEd8.js';
-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 { a as AGENTS_BY_PHASE, b as AGENT_CATALOG, c as ALL_AGENT_DEFINITIONS, d as ALL_FLEET_AGENTS, e as AUDIT_LOG_AGENT, f as AutoExtendCeiling, g as AutoExtendPolicy, B as BUG_HUNTER_AGENT, C as CreateDelegateToolOptions, D as DEFAULT_DIRECTOR_PREAMBLE, h as DEFAULT_SUBAGENT_BASELINE, i as DelegateHost, j as Director, k as DirectorPromptParts, l as DirectorSessionFactory, m as DirectorSessionFactoryOptions, F as FLEET_ROSTER, n as FLEET_ROSTER_BUDGETS, q as FleetManager, r as FleetManagerOptions, s as FleetRosterBudget, t as FleetSpawnBudgetError, I as ICoordinator, u as IFleetManager, N as NULL_FLEET_BUS, R as REFACTOR_PLANNER_AGENT, S as SECURITY_SCANNER_AGENT, v as SubagentPromptParts, w as applyRosterBudget, x as attachAutoExtend, y as composeDirectorPrompt, z as composeSubagentPrompt, E as createDelegateTool, G as getAgentDefinition, H as makeDirectorSessionFactory, J as rosterSummaryFromConfigs } from './null-fleet-bus-Bb2jVLKr.js';
+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-C7YbZUY8.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-Cc8sRJOF.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';
@@ -911,6 +913,13 @@ interface PhaseEventMap {
         taskTitle: string;
         error: string;
     };
+    'phase.taskRetrying': {
+        phaseId: string;
+        taskId: string;
+        taskTitle: string;
+        attempt: number;
+        maxRetries: number;
+    };
     'phase.allTasksDone': {
         phaseId: string;
         completed: number;
@@ -940,8 +949,14 @@ interface PhaseEventMap {
 }
 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 görevi çalıştır — AI agent tarafından yapılır. `env`, fazın git
+     * worktree'sine (varsa) işaret eder; agent'ı izole çalışma dizininde koştur.
+     */
+    executeTask: (task: TaskNode, phaseId: string, env?: {
+        cwd?: string;
+        branch?: 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 */
@@ -967,6 +982,12 @@ interface AutoPhaseOptions {
     stopOnFailure?: boolean;
     /** Event bus */
     events?: EventBus;
+    /**
+     * Opsiyonel git-worktree yöneticisi. Verilirse her faz kendi
+     * worktree+branch'inde izole çalışır ve tamamlanınca ana branch'e sıralı
+     * squash-merge edilir. Yoksa davranış değişmez (paylaşılan working tree).
+     */
+    worktrees?: WorktreeManager;
 }
 interface PhaseFilter {
     status?: PhaseStatus[];
@@ -1034,6 +1055,11 @@ declare class AutoPhaseRunner {
     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;
@@ -1078,12 +1104,23 @@ declare class PhaseOrchestrator {
     private paused;
     private runningPhases;
     private tickInterval;
+    private trackerCache;
+    private taskRetryCounts;
+    private readonly worktrees?;
+    /** Per-phase worktree handles, keyed by phase id. */
+    private readonly phaseWorktrees;
+    /** Serializes all merges back to the base branch (one at a time). */
+    private mergeQueue;
+    /** Per-phase merge promise, so a phase merges only after its deps do. */
+    private readonly phaseMergePromise;
     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>;
+    /** Bekleyen tüm faz merge'lerini (dep-sıralı + global seri) bekle. */
+    private drainMerges;
     /** Duraklat — aktif fazlar çalışmaya devam eder ama yeni faz başlamaz */
     pause(): void;
     /** Devam et — yeni fazlar başlayabilir */
@@ -1092,6 +1129,17 @@ declare class PhaseOrchestrator {
     stop(): void;
     private tick;
     private startPhase;
+    /**
+     * Commit the phase's worktree changes, then enqueue the merge back into the
+     * base branch. Merges run dependency-ordered (a phase merges only after its
+     * `dependsOn` phases) and globally serialized (one at a time) to avoid
+     * concurrent writes to the base tree.
+     */
+    private commitAndEnqueueMerge;
+    /** Squash-merge one phase. Conflicts mark the worktree needs-review (run continues). */
+    private mergeOne;
+    /** A failed phase keeps its worktree on disk for inspection (no merge). */
+    private keepWorktreeForReview;
     private executePhaseTasks;
     private executeSingleTask;
     private markTaskCompleted;
@@ -1114,6 +1162,7 @@ declare class PhaseOrchestrator {
     releaseAgent(phaseId: string, agentId: string): void;
     private emit;
     private createNoopEventBus;
+    private delay;
 }
 
 interface PhaseGraphBuilderOptions {
@@ -1125,6 +1174,8 @@ interface PhaseGraphBuilderOptions {
     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.
@@ -1156,6 +1207,60 @@ declare class PhaseGraphBuilder {
     }): 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;
 }
@@ -1163,7 +1268,7 @@ interface PhaseStoreOptions {
  * PhaseStore — PhaseGraph'ı diske kaydeden ve yükleyen persistence katmanı.
  */
 declare class PhaseStore {
-    private baseDir;
+    readonly baseDir: string;
     constructor(opts: PhaseStoreOptions);
     save(graph: PhaseGraph): Promise<void>;
     load(graphId: string): Promise<PhaseGraph | null>;
@@ -1200,6 +1305,7 @@ interface Checkpoint {
 interface CheckpointManagerOptions {
     store: PhaseStore;
     maxCheckpoints?: number;
+    baseDir?: string;
 }
 /**
  * CheckpointManager — Phase graph'ın anlık görüntülerini alır ve geri yükler.
@@ -1214,12 +1320,17 @@ 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): boolean;
+    deleteCheckpoint(checkpointId: string): Promise<boolean>;
+    private saveToDisk;
+    private deleteFromDisk;
+    private loadFromDisk;
     private pruneCheckpoints;
 }
 
-export { AddAttachmentInput, AttachmentRef, AttachmentStore, type AutoPhaseOptions, 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, 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 };
+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, WorktreeManager, buildBtwBlock, consumeBtwNotes, createAutoPhaseFromTaskGraph, createMcpControlTool, createSecuritySlashCommand, defaultGitignoreUpdater, defaultOrchestrator, defaultReportGenerator, defaultSecurityScanner, defaultSkillGenerator, defaultTechStackDetector, loadPlugins, makeContinueToNextIterationTool, parseContinueDirective, pendingBtwCount, securitySlashCommand, setBtwNote, unloadPlugins };