@sudocode-ai/local-server 0.1.0

package/dist/execution/workflow/types.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Workflow Layer Types
+ *
+ * Layer 4: Task Execution Layer - Workflow Orchestration & State Management
+ *
+ * @module execution/workflow/types
+ */
+import type { RetryPolicy, ResilientExecutionResult } from '../resilience/types.js';
+import type { ExecutionResult } from '../engine/types.js';
+/**
+ * WorkflowDefinition - Configuration for a multi-step workflow
+ */
+export interface WorkflowDefinition {
+    /** Unique identifier for this workflow type */
+    id: string;
+    /** Steps to execute in sequence */
+    steps: WorkflowStep[];
+    /** Initial context variables */
+    initialContext?: Record<string, any>;
+    /** Workflow configuration */
+    config?: {
+        /** Number of steps between checkpoints (0 = no checkpoints) */
+        checkpointInterval?: number;
+        /** If true, continue executing remaining steps after a step fails */
+        continueOnStepFailure?: boolean;
+        /** Overall workflow timeout in milliseconds */
+        timeout?: number;
+    };
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * WorkflowStep - Individual step within a workflow
+ */
+export interface WorkflowStep {
+    /** Unique step identifier */
+    id: string;
+    /** Task type to execute */
+    taskType: 'issue' | 'spec' | 'custom';
+    /** Prompt template with {{variable}} placeholders */
+    prompt: string;
+    /** Step IDs that must complete before this step */
+    dependencies?: string[];
+    /** Retry policy for this step (overrides default) */
+    retryPolicy?: RetryPolicy;
+    /** Step-specific timeout in milliseconds */
+    timeout?: number;
+    /** Condition to evaluate before executing step */
+    condition?: string;
+    /** Map step outputs to context variables */
+    outputMapping?: Record<string, string>;
+    /** Task configuration passed to engine */
+    taskConfig?: Record<string, any>;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * WorkflowExecution - Runtime state of a workflow execution
+ */
+export interface WorkflowExecution {
+    /** Unique execution identifier (UUID from database or externally provided) */
+    executionId: string;
+    /** Workflow definition ID */
+    workflowId: string;
+    /** Workflow definition */
+    definition: WorkflowDefinition;
+    /** Current execution status */
+    status: WorkflowStatus;
+    /** Index of current step being executed */
+    currentStepIndex: number;
+    /** Shared context across steps */
+    context: Record<string, any>;
+    /** Results from completed steps */
+    stepResults: ResilientExecutionResult[];
+    /** When execution started */
+    startedAt: Date;
+    /** When execution completed */
+    completedAt?: Date;
+    /** When execution was paused */
+    pausedAt?: Date;
+    /** When execution was resumed */
+    resumedAt?: Date;
+    /** Error message if failed */
+    error?: string;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * WorkflowStatus - Possible workflow execution states
+ */
+export type WorkflowStatus = 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+/**
+ * WorkflowCheckpoint - Saved workflow state for resumption
+ */
+export interface WorkflowCheckpoint {
+    /** Workflow definition ID */
+    workflowId: string;
+    /** Execution ID */
+    executionId: string;
+    /** Workflow definition at checkpoint time */
+    definition: WorkflowDefinition;
+    /** Execution state at checkpoint */
+    state: {
+        status: WorkflowStatus;
+        currentStepIndex: number;
+        context: Record<string, any>;
+        stepResults: ResilientExecutionResult[];
+        error?: string;
+        startedAt: Date;
+        completedAt?: Date;
+    };
+    /** When checkpoint was created */
+    createdAt: Date;
+}
+/**
+ * WorkflowResult - Final result of workflow execution
+ */
+export interface WorkflowResult {
+    /** Execution ID */
+    executionId: string;
+    /** Whether workflow completed successfully */
+    success: boolean;
+    /** Number of steps completed */
+    completedSteps: number;
+    /** Number of steps failed */
+    failedSteps: number;
+    /** Number of steps skipped */
+    skippedSteps: number;
+    /** Final context outputs */
+    outputs: Record<string, any>;
+    /** Total execution duration in milliseconds */
+    duration: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * StepStatus - Status information for a specific step
+ */
+export interface StepStatus {
+    /** Step ID */
+    stepId: string;
+    /** Current status */
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+    /** Execution result if completed/failed */
+    result?: ExecutionResult;
+    /** Number of attempts */
+    attempts: number;
+}
+/**
+ * Event Handlers
+ */
+/** Called when workflow execution starts */
+export type WorkflowStartHandler = (executionId: string, workflowId: string) => void;
+/** Called when workflow execution completes */
+export type WorkflowCompleteHandler = (executionId: string, result: WorkflowResult) => void;
+/** Called when workflow execution fails */
+export type WorkflowFailedHandler = (executionId: string, error: Error) => void;
+/** Called when a step starts executing */
+export type StepStartHandler = (executionId: string, stepId: string, stepIndex: number) => void;
+/** Called when a step completes */
+export type StepCompleteHandler = (executionId: string, stepId: string, result: ExecutionResult) => void;
+/** Called when a step fails */
+export type StepFailedHandler = (executionId: string, stepId: string, error: Error) => void;
+/** Called when a checkpoint is created */
+export type WorkflowCheckpointHandler = (checkpoint: WorkflowCheckpoint) => void;
+/** Called when a workflow is resumed from checkpoint */
+export type WorkflowResumeHandler = (executionId: string, checkpoint: WorkflowCheckpoint) => void;
+/** Called when a workflow is paused */
+export type WorkflowPauseHandler = (executionId: string) => void;
+/** Called when a workflow is cancelled */
+export type WorkflowCancelHandler = (executionId: string) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/execution/workflow/types.d.ts.map

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

package/dist/execution/workflow/utils.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Workflow Utility Functions
+ *
+ * Helper functions for template rendering, path extraction, and ID generation.
+ *
+ * @module execution/workflow/utils
+ */
+/**
+ * Generate a unique ID with a given prefix
+ *
+ * @param prefix - Prefix for the ID (e.g., 'execution', 'checkpoint')
+ * @returns Unique ID string
+ *
+ * @example
+ * ```typescript
+ * const id = generateId('execution');
+ * // Returns: 'execution-1234567890-abc123'
+ * ```
+ */
+export declare function generateId(prefix?: string): string;
+/**
+ * Render a template string by replacing {{variable}} placeholders with context values
+ *
+ * @param template - Template string with {{variable}} placeholders
+ * @param context - Context object containing variable values
+ * @returns Rendered string with variables replaced
+ *
+ * @example
+ * ```typescript
+ * const context = { name: 'World', greeting: 'Hello' };
+ * const result = renderTemplate('{{greeting}} {{name}}!', context);
+ * // Returns: 'Hello World!'
+ * ```
+ */
+export declare function renderTemplate(template: string, context: Record<string, any>): string;
+/**
+ * Extract a value from an object using a dot-notation path
+ *
+ * @param obj - Object to extract value from
+ * @param path - Dot-notation path (e.g., 'user.profile.name')
+ * @returns Extracted value or undefined if path doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const obj = { user: { profile: { name: 'Alice' } } };
+ * const name = extractValue(obj, 'user.profile.name');
+ * // Returns: 'Alice'
+ * ```
+ */
+export declare function extractValue(obj: any, path: string): any;
+/**
+ * Merge two context objects, with the second overriding the first
+ *
+ * @param base - Base context object
+ * @param updates - Updates to merge into base
+ * @returns New merged context object
+ *
+ * @example
+ * ```typescript
+ * const base = { a: 1, b: 2 };
+ * const updates = { b: 3, c: 4 };
+ * const merged = mergeContext(base, updates);
+ * // Returns: { a: 1, b: 3, c: 4 }
+ * ```
+ */
+export declare function mergeContext(base: Record<string, any>, updates: Record<string, any>): Record<string, any>;
+/**
+ * Evaluate a condition string in the context
+ *
+ * @param condition - Condition string to evaluate (e.g., '{{isEnabled}}')
+ * @param context - Context object
+ * @returns Boolean result of condition
+ *
+ * @example
+ * ```typescript
+ * const context = { isEnabled: true };
+ * const result = evaluateCondition('{{isEnabled}}', context);
+ * // Returns: true
+ * ```
+ */
+export declare function evaluateCondition(condition: string, context: Record<string, any>): boolean;
+/**
+ * Create initial workflow context
+ *
+ * @param initialValues - Initial context values
+ * @returns New context object
+ */
+export declare function createContext(initialValues?: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/execution/workflow/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/execution/workflow/utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAO,GAAG,MAAM,CAIhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,MAAM,CAmBR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAsBxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAKrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,OAAO,CAqBT;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GACtC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAIrB"}

package/dist/execution/worktree/config.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Worktree Configuration
+ *
+ * Loads and validates worktree configuration from .sudocode/config.json
+ *
+ * @module execution/worktree/config
+ */
+import type { WorktreeConfig } from './types.js';
+/**
+ * Validation result
+ */
+interface ValidationResult {
+    config: WorktreeConfig;
+    warnings: string[];
+}
+/**
+ * Default worktree configuration
+ */
+export declare const DEFAULT_WORKTREE_CONFIG: WorktreeConfig;
+/**
+ * Validate and normalize worktree configuration
+ *
+ * @param rawConfig - Raw configuration object from config.json
+ * @returns Validated configuration with warnings
+ */
+export declare function validateWorktreeConfig(rawConfig: Partial<WorktreeConfig>): ValidationResult;
+/**
+ * Load worktree configuration from .sudocode/config.json
+ *
+ * @param projectRoot - Path to project root (default: current working directory)
+ * @returns Validated configuration with warnings
+ */
+export declare function loadWorktreeConfig(projectRoot?: string): ValidationResult;
+/**
+ * Get worktree configuration (singleton pattern)
+ * Caches the configuration per project root
+ *
+ * @param projectRoot - Path to project root (default: current working directory)
+ * @param forceReload - Force reload from disk
+ * @returns Worktree configuration
+ */
+export declare function getWorktreeConfig(projectRoot?: string, forceReload?: boolean): WorktreeConfig;
+/**
+ * Clear the cached configuration (useful for testing)
+ */
+export declare function clearWorktreeConfigCache(): void;
+/**
+ * Update worktree configuration in .sudocode/config.json
+ * Preserves other configuration sections
+ *
+ * @param updates - Partial configuration to update
+ * @param projectRoot - Path to project root (default: current working directory)
+ * @returns Validation result with updated config
+ * @throws Error if unable to write config file
+ */
+export declare function updateWorktreeConfig(updates: Partial<WorktreeConfig>, projectRoot?: string): ValidationResult;
+/**
+ * Set a single worktree configuration property
+ *
+ * @param key - Configuration key to set
+ * @param value - Value to set
+ * @param projectRoot - Path to project root (default: current working directory)
+ * @returns Validation result with updated config
+ */
+export declare function setWorktreeConfigProperty<K extends keyof WorktreeConfig>(key: K, value: WorktreeConfig[K], projectRoot?: string): ValidationResult;
+/**
+ * Reset worktree configuration to defaults
+ *
+ * @param projectRoot - Path to project root (default: current working directory)
+ * @returns Validation result with default config
+ */
+export declare function resetWorktreeConfig(projectRoot?: string): ValidationResult;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/execution/worktree/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/execution/worktree/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAUjD;;GAEG;AACH,UAAU,gBAAgB;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAQrC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GACjC,gBAAgB,CA8FlB;AAkCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,GAAE,MAAsB,GAClC,gBAAgB,CAgClB;AAQD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,GAAE,MAAsB,EACnC,WAAW,UAAQ,GAClB,cAAc,CAoBhB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,EAChC,WAAW,GAAE,MAAsB,GAClC,gBAAgB,CAoDlB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,cAAc,EACtE,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EACxB,WAAW,GAAE,MAAsB,GAClC,gBAAgB,CAElB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,GAAE,MAAsB,GAClC,gBAAgB,CAElB"}

package/dist/execution/worktree/git-cli.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Git CLI Wrapper
+ *
+ * Provides a wrapper around git CLI commands for worktree operations.
+ * Uses git CLI directly for reliability (recommended over libgit2/nodegit).
+ *
+ * @module execution/worktree/git-cli
+ */
+import type { WorktreeInfo } from './types.js';
+/**
+ * IGitCli - Interface for git CLI operations
+ */
+export interface IGitCli {
+    /**
+     * Add a new worktree
+     * Equivalent to: git worktree add <path> <branch>
+     *
+     * @param repoPath - Path to the main git repository
+     * @param worktreePath - Path where worktree will be created
+     * @param branch - Branch name for the worktree
+     * @param force - Force creation even if path exists
+     */
+    worktreeAdd(repoPath: string, worktreePath: string, branch: string, force?: boolean): Promise<void>;
+    /**
+     * Remove a worktree
+     * Equivalent to: git worktree remove <path> --force
+     *
+     * @param repoPath - Path to the main git repository
+     * @param worktreePath - Path to worktree to remove
+     * @param force - Force removal even if worktree is dirty
+     */
+    worktreeRemove(repoPath: string, worktreePath: string, force?: boolean): Promise<void>;
+    /**
+     * Prune worktree metadata
+     * Equivalent to: git worktree prune
+     *
+     * @param repoPath - Path to the main git repository
+     */
+    worktreePrune(repoPath: string): Promise<void>;
+    /**
+     * List all worktrees
+     * Equivalent to: git worktree list --porcelain
+     *
+     * @param repoPath - Path to the main git repository
+     * @returns Array of worktree information
+     */
+    worktreeList(repoPath: string): Promise<WorktreeInfo[]>;
+    /**
+     * Create a branch
+     * Equivalent to: git branch <name> <base>
+     *
+     * @param repoPath - Path to the git repository
+     * @param branchName - Name of the new branch
+     * @param baseBranchOrCommit - Base branch or commit SHA to branch from
+     */
+    createBranch(repoPath: string, branchName: string, baseBranchOrCommit: string): Promise<void>;
+    /**
+     * Delete a branch
+     * Equivalent to: git branch -d <name>
+     *
+     * @param repoPath - Path to the git repository
+     * @param branchName - Name of the branch to delete
+     * @param force - Force deletion (use -D instead of -d)
+     */
+    deleteBranch(repoPath: string, branchName: string, force?: boolean): Promise<void>;
+    /**
+     * Configure sparse-checkout for a worktree
+     * Equivalent to: git sparse-checkout set <patterns>
+     *
+     * @param worktreePath - Path to the worktree
+     * @param patterns - Sparse checkout patterns
+     */
+    configureSparseCheckout(worktreePath: string, patterns: string[]): Promise<void>;
+    /**
+     * Check if a path is a valid git repository
+     * Equivalent to: git rev-parse --git-dir
+     *
+     * @param repoPath - Path to check
+     * @returns Promise resolving to true if valid repo, false otherwise
+     */
+    isValidRepo(repoPath: string): Promise<boolean>;
+    /**
+     * List all branches in a repository
+     * Equivalent to: git branch --list --all --format='%(refname:short)'
+     *
+     * @param repoPath - Path to the git repository
+     * @returns Promise resolving to array of branch names
+     */
+    listBranches(repoPath: string): Promise<string[]>;
+    /**
+     * Get current HEAD commit SHA
+     * Equivalent to: git rev-parse HEAD
+     *
+     * @param repoPath - Path to the git repository
+     * @returns Promise resolving to the current HEAD commit SHA
+     */
+    getCurrentCommit(repoPath: string): Promise<string>;
+}
+/**
+ * GitCli - Implementation of IGitCli using child_process
+ */
+export declare class GitCli implements IGitCli {
+    /**
+     * Execute a git command
+     *
+     * @param command - Git command to execute
+     * @param cwd - Working directory
+     * @returns Command output
+     * @throws WorktreeError on failure
+     */
+    protected execGit(command: string, cwd: string): string;
+    /**
+     * Escape shell argument
+     *
+     * @param arg - Argument to escape
+     * @returns Escaped argument
+     */
+    private escapeShellArg;
+    worktreeAdd(repoPath: string, worktreePath: string, branch: string, force?: boolean): Promise<void>;
+    worktreeRemove(repoPath: string, worktreePath: string, force?: boolean): Promise<void>;
+    worktreePrune(repoPath: string): Promise<void>;
+    worktreeList(repoPath: string): Promise<WorktreeInfo[]>;
+    /**
+     * Parse output from git worktree list --porcelain
+     *
+     * Format:
+     * worktree /path/to/worktree
+     * HEAD abc123...
+     * branch refs/heads/branch-name
+     * locked reason (optional)
+     * prunable reason (optional)
+     *
+     * @param output - Output from git worktree list --porcelain
+     * @returns Array of WorktreeInfo
+     */
+    private parseWorktreeList;
+    /**
+     * Finalize worktree info with defaults
+     *
+     * @param partial - Partial worktree info
+     * @returns Complete WorktreeInfo
+     */
+    private finalizeWorktreeInfo;
+    createBranch(repoPath: string, branchName: string, baseBranchOrCommit: string): Promise<void>;
+    deleteBranch(repoPath: string, branchName: string, force?: boolean): Promise<void>;
+    configureSparseCheckout(worktreePath: string, patterns: string[]): Promise<void>;
+    isValidRepo(repoPath: string): Promise<boolean>;
+    listBranches(repoPath: string): Promise<string[]>;
+    getCurrentCommit(repoPath: string): Promise<string>;
+}
+//# sourceMappingURL=git-cli.d.ts.map

package/dist/execution/worktree/git-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-cli.d.ts","sourceRoot":"","sources":["../../../src/execution/worktree/git-cli.ts"],"names":[],"mappings":"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"}

package/dist/execution/worktree/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Worktree Layer - Public API
+ *
+ * Barrel export for the Worktree Layer of the execution system.
+ * Exports all public types, interfaces, and implementations.
+ *
+ * @module execution/worktree
+ */
+export type { WorktreeCreateParams, WorktreeInfo, WorktreeConfig, } from './types.js';
+export { WorktreeError, WorktreeErrorCode } from './types.js';
+export type { IWorktreeManager } from './manager.js';
+export { WorktreeManager } from './manager.js';
+export type { IGitCli } from './git-cli.js';
+export { GitCli } from './git-cli.js';
+export { DEFAULT_WORKTREE_CONFIG, getWorktreeConfig, loadWorktreeConfig, validateWorktreeConfig, updateWorktreeConfig, setWorktreeConfigProperty, resetWorktreeConfig, clearWorktreeConfigCache, } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/worktree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execution/worktree/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,aAAa,CAAC"}