@codemcp/workflows 5.3.0 → 6.0.2

package/packages/core/dist/git-manager.js

@@ -0,0 +1,123 @@
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { createLogger } from './logger.js';
+const logger = createLogger('GitManager');
+export class GitManager {
+    /**
+     * Check if a directory is a git repository
+     */
+    static isGitRepository(projectPath) {
+        return existsSync(`${projectPath}/.git`);
+    }
+    /**
+     * Get the current git branch for a project
+     */
+    static getCurrentBranch(projectPath) {
+        try {
+            if (!this.isGitRepository(projectPath)) {
+                logger.debug('Not a git repository, using "default" as branch name', {
+                    projectPath,
+                });
+                return 'default';
+            }
+            const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).trim();
+            logger.debug('Detected git branch', { projectPath, branch });
+            return branch;
+        }
+        catch (_error) {
+            logger.debug('Failed to get git branch, using "default" as branch name', {
+                projectPath,
+            });
+            return 'default';
+        }
+    }
+    /**
+     * Get the current HEAD commit hash (for tracking start of development)
+     */
+    static getCurrentCommitHash(projectPath) {
+        try {
+            if (!this.isGitRepository(projectPath)) {
+                return null;
+            }
+            const hash = execSync('git rev-parse HEAD', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).trim();
+            return hash;
+        }
+        catch (error) {
+            logger.debug('Failed to get current commit hash', { projectPath, error });
+            return null;
+        }
+    }
+    /**
+     * Create a commit with the given message
+     */
+    static createCommit(message, projectPath) {
+        try {
+            if (!this.isGitRepository(projectPath)) {
+                logger.debug('Not a git repository, skipping commit', { projectPath });
+                return false;
+            }
+            // Stage all changes
+            execSync('git add .', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            });
+            // Create commit
+            execSync(`git commit -m "${message}"`, {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            });
+            logger.debug('Created commit successfully', { projectPath, message });
+            return true;
+        }
+        catch (error) {
+            logger.debug('Failed to create commit', {
+                projectPath,
+                message,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return false;
+        }
+    }
+    /**
+     * Check if there are uncommitted changes
+     */
+    static hasUncommittedChanges(projectPath) {
+        try {
+            if (!this.isGitRepository(projectPath)) {
+                logger.debug('Not a git repository, no uncommitted changes', {
+                    projectPath,
+                });
+                return false;
+            }
+            const status = execSync('git status --porcelain', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).trim();
+            const hasChanges = status.length > 0;
+            logger.debug('Checked for uncommitted changes', {
+                projectPath,
+                hasChanges,
+            });
+            return hasChanges;
+        }
+        catch (error) {
+            logger.debug('Failed to check for uncommitted changes', {
+                projectPath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=git-manager.js.map

package/packages/core/dist/git-manager.js.map

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

package/packages/core/dist/index.d.ts

@@ -0,0 +1,24 @@
+export * from './types.js';
+export * from './state-machine-types.js';
+export * from './interfaces/index.js';
+export * from './state-machine.js';
+export * from './state-machine-loader.js';
+export * from './workflow-manager.js';
+export * from './transition-engine.js';
+export * from './persistence-interface.js';
+export * from './file-storage.js';
+export * from './conversation-manager.js';
+export * from './plan-manager.js';
+export * from './template-manager.js';
+export * from './project-docs-manager.js';
+export * from './file-detection-manager.js';
+export * from './config-manager.js';
+export * from './git-manager.js';
+export * from './task-backend.js';
+export * from './beads-integration.js';
+export * from './beads-state-manager.js';
+export * from './logger.js';
+export * from './interaction-logger.js';
+export * from './instruction-generator.js';
+export * from './system-prompt-generator.js';
+export * from './path-validation-utils.js';

package/packages/core/dist/index.js

@@ -0,0 +1,31 @@
+// Core types and interfaces
+export * from './types.js';
+export * from './state-machine-types.js';
+// Strategy pattern interfaces
+export * from './interfaces/index.js';
+// State machine and workflow management
+export * from './state-machine.js';
+export * from './state-machine-loader.js';
+export * from './workflow-manager.js';
+export * from './transition-engine.js';
+// Data management
+export * from './persistence-interface.js';
+export * from './file-storage.js';
+export * from './conversation-manager.js';
+// Project and plan management
+export * from './plan-manager.js';
+export * from './template-manager.js';
+export * from './project-docs-manager.js';
+export * from './file-detection-manager.js';
+export * from './config-manager.js';
+export * from './git-manager.js';
+export * from './task-backend.js';
+export * from './beads-integration.js';
+export * from './beads-state-manager.js';
+// Utilities and generators
+export * from './logger.js';
+export * from './interaction-logger.js';
+export * from './instruction-generator.js';
+export * from './system-prompt-generator.js';
+export * from './path-validation-utils.js';
+//# sourceMappingURL=index.js.map

package/packages/core/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AAEzC,8BAA8B;AAC9B,cAAc,uBAAuB,CAAC;AAEtC,wCAAwC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AAEvC,kBAAkB;AAClB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAE1C,8BAA8B;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AAEzC,2BAA2B;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC"}

package/packages/core/dist/instruction-generator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Instruction Generator
+ *
+ * Creates phase-specific guidance for the LLM based on current conversation state.
+ * Customizes instructions based on project context and development phase.
+ * Supports custom state machine definitions for dynamic instruction generation.
+ * Handles variable substitution for project artifact references.
+ */
+import { PlanManager } from './plan-manager.js';
+import type { YamlStateMachine } from './state-machine-types.js';
+import type { IInstructionGenerator, InstructionContext, GeneratedInstructions } from './interfaces/instruction-generator.interface.js';
+export declare class InstructionGenerator implements IInstructionGenerator {
+    private projectDocsManager;
+    constructor(_planManager: PlanManager);
+    /**
+     * Set the state machine definition for dynamic instruction generation
+     */
+    setStateMachine(_stateMachine: YamlStateMachine): void;
+    /**
+     * Generate comprehensive instructions for the LLM
+     */
+    generateInstructions(baseInstructions: string, context: InstructionContext): Promise<GeneratedInstructions>;
+    /**
+     * Apply variable substitution to instructions
+     * Replaces project artifact variables with actual file paths
+     */
+    private applyVariableSubstitution;
+    /**
+     * Escape special regex characters in variable names
+     */
+    private escapeRegExp;
+    /**
+     * Enhance base instructions with context-specific information
+     */
+    private enhanceInstructions;
+    /**
+     * Capitalize phase name for display
+     */
+    private capitalizePhase;
+}

package/packages/core/dist/instruction-generator.js

@@ -0,0 +1,89 @@
+/**
+ * Instruction Generator
+ *
+ * Creates phase-specific guidance for the LLM based on current conversation state.
+ * Customizes instructions based on project context and development phase.
+ * Supports custom state machine definitions for dynamic instruction generation.
+ * Handles variable substitution for project artifact references.
+ */
+import { ProjectDocsManager } from './project-docs-manager.js';
+export class InstructionGenerator {
+    projectDocsManager;
+    constructor(_planManager) {
+        // planManager parameter kept for API compatibility but not stored since unused
+        this.projectDocsManager = new ProjectDocsManager();
+    }
+    /**
+     * Set the state machine definition for dynamic instruction generation
+     */
+    setStateMachine(_stateMachine) {
+        // stateMachine parameter kept for API compatibility but not stored since unused
+        return;
+    }
+    /**
+     * Generate comprehensive instructions for the LLM
+     */
+    async generateInstructions(baseInstructions, context) {
+        // Apply variable substitution to base instructions
+        const substitutedInstructions = this.applyVariableSubstitution(baseInstructions, context.conversationContext.projectPath, context.conversationContext.gitBranch);
+        // Enhance base instructions with context-specific guidance
+        const enhancedInstructions = await this.enhanceInstructions(substitutedInstructions, context);
+        return {
+            instructions: enhancedInstructions,
+            planFileGuidance: 'Task management guidance is now included in main instructions',
+            metadata: {
+                phase: context.phase,
+                planFilePath: context.conversationContext.planFilePath,
+                transitionReason: context.transitionReason,
+                isModeled: context.isModeled,
+            },
+        };
+    }
+    /**
+     * Apply variable substitution to instructions
+     * Replaces project artifact variables with actual file paths
+     */
+    applyVariableSubstitution(instructions, projectPath, gitBranch) {
+        const substitutions = this.projectDocsManager.getVariableSubstitutions(projectPath, gitBranch);
+        let result = instructions;
+        for (const [variable, value] of Object.entries(substitutions)) {
+            // Use global replace to handle multiple occurrences
+            result = result.replace(new RegExp(this.escapeRegExp(variable), 'g'), value);
+        }
+        return result;
+    }
+    /**
+     * Escape special regex characters in variable names
+     */
+    escapeRegExp(string) {
+        return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * Enhance base instructions with context-specific information
+     */
+    async enhanceInstructions(baseInstructions, context) {
+        const { phase, conversationContext, planFileExists } = context;
+        const phaseName = this.capitalizePhase(phase);
+        let workflowSection = `---
+**Workflow Continuity:**
+Maintain \`${conversationContext.planFilePath}\`:
+- Work through tasks in the "${phaseName}" section; Focus on those tasks!
+- Add newly discovered tasks; log decisions in "Key Decisions"
+- DO NOT maintain tasks in other tools or documents than explicitly stated in this plan file!`;
+        if (!planFileExists) {
+            workflowSection += '\n- Note: plan file will be created on first update';
+        }
+        workflowSection += '\n\nCall `whats_next()` after each user message.';
+        return `## ${phaseName} Phase\n\n${baseInstructions}\n\n${workflowSection}`;
+    }
+    /**
+     * Capitalize phase name for display
+     */
+    capitalizePhase(phase) {
+        return phase
+            .split('_')
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+}
+//# sourceMappingURL=instruction-generator.js.map

package/packages/core/dist/instruction-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-generator.js","sourceRoot":"","sources":["../src/instruction-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAS/D,MAAM,OAAO,oBAAoB;IACvB,kBAAkB,CAAqB;IAE/C,YAAY,YAAyB;QACnC,+EAA+E;QAC/E,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,aAA+B;QAC7C,gFAAgF;QAChF,OAAO;IACT,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CACxB,gBAAwB,EACxB,OAA2B;QAE3B,mDAAmD;QACnD,MAAM,uBAAuB,GAAG,IAAI,CAAC,yBAAyB,CAC5D,gBAAgB,EAChB,OAAO,CAAC,mBAAmB,CAAC,WAAW,EACvC,OAAO,CAAC,mBAAmB,CAAC,SAAS,CACtC,CAAC;QAEF,2DAA2D;QAC3D,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,mBAAmB,CACzD,uBAAuB,EACvB,OAAO,CACR,CAAC;QAEF,OAAO;YACL,YAAY,EAAE,oBAAoB;YAClC,gBAAgB,EACd,+DAA+D;YACjE,QAAQ,EAAE;gBACR,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,YAAY,EAAE,OAAO,CAAC,mBAAmB,CAAC,YAAY;gBACtD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,yBAAyB,CAC/B,YAAoB,EACpB,WAAmB,EACnB,SAAkB;QAElB,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,wBAAwB,CACpE,WAAW,EACX,SAAS,CACV,CAAC;QAEF,IAAI,MAAM,GAAG,YAAY,CAAC;QAC1B,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9D,oDAAoD;YACpD,MAAM,GAAG,MAAM,CAAC,OAAO,CACrB,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,EAC5C,KAAK,CACN,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,MAAc;QACjC,OAAO,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB,CAC/B,gBAAwB,EACxB,OAA2B;QAE3B,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;QAE/D,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAE9C,IAAI,eAAe,GAAG;;aAEb,mBAAmB,CAAC,YAAY;+BACd,SAAS;;8FAEsD,CAAC;QAE3F,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,eAAe,IAAI,qDAAqD,CAAC;QAC3E,CAAC;QAED,eAAe,IAAI,kDAAkD,CAAC;QAEtE,OAAO,MAAM,SAAS,aAAa,gBAAgB,OAAO,eAAe,EAAE,CAAC;IAC9E,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,KAAa;QACnC,OAAO,KAAK;aACT,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aACzD,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;CACF"}

package/packages/core/dist/interaction-logger.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Interaction Logger module
+ *
+ * Handles logging of tool interactions to the database for auditing and debugging.
+ */
+import type { IPersistence } from './persistence-interface.js';
+import type { InteractionLog } from './types.js';
+/**
+ * Handles logging of tool interactions to the database
+ */
+export declare class InteractionLogger {
+    private database;
+    /**
+     * Create a new InteractionLogger
+     *
+     * @param database - Persistence instance to use for logging
+     */
+    constructor(database: IPersistence);
+    /**
+     * Log an interaction with a tool
+     *
+     * @param conversationId - ID of the conversation
+     * @param toolName - Name of the tool that was called
+     * @param inputParams - Input parameters to the tool (will be stringified)
+     * @param responseData - Response data from the tool (will be stringified)
+     * @param currentPhase - Current development phase
+     * @returns Promise that resolves when the log is saved
+     */
+    logInteraction(conversationId: string, toolName: string, inputParams: unknown, responseData: unknown, currentPhase: string): Promise<void>;
+    /**
+     * Get all interactions for a specific conversation
+     *
+     * @param conversationId - ID of the conversation to get logs for
+     * @returns Promise that resolves to an array of interaction logs
+     */
+    getInteractionsByConversationId(conversationId: string): Promise<InteractionLog[]>;
+}

package/packages/core/dist/interaction-logger.js

@@ -0,0 +1,87 @@
+/**
+ * Interaction Logger module
+ *
+ * Handles logging of tool interactions to the database for auditing and debugging.
+ */
+import { createLogger } from './logger.js';
+const logger = createLogger('InteractionLogger');
+/**
+ * Handles logging of tool interactions to the database
+ */
+export class InteractionLogger {
+    database;
+    /**
+     * Create a new InteractionLogger
+     *
+     * @param database - Persistence instance to use for logging
+     */
+    constructor(database) {
+        this.database = database;
+        logger.debug('InteractionLogger initialized');
+    }
+    /**
+     * Log an interaction with a tool
+     *
+     * @param conversationId - ID of the conversation
+     * @param toolName - Name of the tool that was called
+     * @param inputParams - Input parameters to the tool (will be stringified)
+     * @param responseData - Response data from the tool (will be stringified)
+     * @param currentPhase - Current development phase
+     * @returns Promise that resolves when the log is saved
+     */
+    async logInteraction(conversationId, toolName, inputParams, responseData, currentPhase) {
+        logger.debug('Logging interaction', {
+            conversationId,
+            toolName,
+            currentPhase,
+        });
+        try {
+            const timestamp = new Date().toISOString();
+            const log = {
+                conversationId,
+                toolName,
+                inputParams: JSON.stringify(inputParams),
+                responseData: JSON.stringify(responseData),
+                currentPhase,
+                timestamp,
+            };
+            await this.database.logInteraction(log);
+            logger.info('Interaction logged successfully', {
+                conversationId,
+                toolName,
+                timestamp,
+            });
+        }
+        catch (error) {
+            logger.error('Failed to log interaction', error, {
+                conversationId,
+                toolName,
+            });
+            // Don't throw the error - logging should not break the main flow
+        }
+    }
+    /**
+     * Get all interactions for a specific conversation
+     *
+     * @param conversationId - ID of the conversation to get logs for
+     * @returns Promise that resolves to an array of interaction logs
+     */
+    async getInteractionsByConversationId(conversationId) {
+        logger.debug('Getting interactions by conversation ID', { conversationId });
+        try {
+            const logs = await this.database.getInteractionsByConversationId(conversationId);
+            logger.info('Retrieved interaction logs', {
+                conversationId,
+                count: logs.length,
+            });
+            return logs;
+        }
+        catch (error) {
+            logger.error('Failed to get interaction logs', error, {
+                conversationId,
+            });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=interaction-logger.js.map

package/packages/core/dist/interaction-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-logger.js","sourceRoot":"","sources":["../src/interaction-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,MAAM,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,QAAQ,CAAe;IAE/B;;;;OAIG;IACH,YAAY,QAAsB;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,cAAc,CAClB,cAAsB,EACtB,QAAgB,EAChB,WAAoB,EACpB,YAAqB,EACrB,YAAoB;QAEpB,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE;YAClC,cAAc;YACd,QAAQ;YACR,YAAY;SACb,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAE3C,MAAM,GAAG,GAAmB;gBAC1B,cAAc;gBACd,QAAQ;gBACR,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;gBACxC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;gBAC1C,YAAY;gBACZ,SAAS;aACV,CAAC;YAEF,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;gBAC7C,cAAc;gBACd,QAAQ;gBACR,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAc,EAAE;gBACxD,cAAc;gBACd,QAAQ;aACT,CAAC,CAAC;YACH,iEAAiE;QACnE,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,+BAA+B,CACnC,cAAsB;QAEtB,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,MAAM,IAAI,GACR,MAAM,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,cAAc,CAAC,CAAC;YAEtE,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;gBACxC,cAAc;gBACd,KAAK,EAAE,IAAI,CAAC,MAAM;aACnB,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAc,EAAE;gBAC7D,cAAc;aACf,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/packages/core/dist/interfaces/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Core Component Interfaces
+ *
+ * Defines contract interfaces for core components to enable strategy pattern.
+ * Enables clean substitution of components based on task backend configuration.
+ */
+export * from './plan-manager.interface.js';
+export * from './instruction-generator.interface.js';
+export * from './task-backend-client.interface.js';

package/packages/core/dist/interfaces/index.js

@@ -0,0 +1,10 @@
+/**
+ * Core Component Interfaces
+ *
+ * Defines contract interfaces for core components to enable strategy pattern.
+ * Enables clean substitution of components based on task backend configuration.
+ */
+export * from './plan-manager.interface.js';
+export * from './instruction-generator.interface.js';
+export * from './task-backend-client.interface.js';
+//# sourceMappingURL=index.js.map

package/packages/core/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC"}

package/packages/core/dist/interfaces/instruction-generator.interface.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Instruction Generator Interface
+ *
+ * Defines the contract for instruction generation functionality.
+ * Enables strategy pattern implementation for different task backends.
+ */
+import type { ConversationContext } from '../types.js';
+import type { YamlStateMachine } from '../state-machine-types.js';
+export interface InstructionContext {
+    phase: string;
+    conversationContext: ConversationContext;
+    transitionReason: string;
+    isModeled: boolean;
+    planFileExists: boolean;
+    /** Source of the instruction generation request - helps generators adapt output */
+    instructionSource: 'proceed_to_phase' | 'whats_next';
+}
+export interface GeneratedInstructions {
+    instructions: string;
+    planFileGuidance: string;
+    metadata: {
+        phase: string;
+        planFilePath: string;
+        transitionReason: string;
+        isModeled: boolean;
+    };
+}
+/**
+ * Interface for instruction generation operations
+ * All instruction generators must implement this interface
+ */
+export interface IInstructionGenerator {
+    /**
+     * Set the state machine definition for dynamic instruction generation
+     */
+    setStateMachine(stateMachine: YamlStateMachine): void;
+    /**
+     * Generate comprehensive instructions for the LLM
+     */
+    generateInstructions(baseInstructions: string, context: InstructionContext): Promise<GeneratedInstructions>;
+}

package/packages/core/dist/interfaces/instruction-generator.interface.js

@@ -0,0 +1,8 @@
+/**
+ * Instruction Generator Interface
+ *
+ * Defines the contract for instruction generation functionality.
+ * Enables strategy pattern implementation for different task backends.
+ */
+export {};
+//# sourceMappingURL=instruction-generator.interface.js.map

package/packages/core/dist/interfaces/instruction-generator.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-generator.interface.js","sourceRoot":"","sources":["../../src/interfaces/instruction-generator.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/packages/core/dist/interfaces/plan-manager.interface.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Plan Manager Interface
+ *
+ * Defines the contract for plan management functionality.
+ * Enables strategy pattern implementation for different task backends.
+ */
+import type { YamlStateMachine } from '../state-machine-types.js';
+import type { TaskBackendConfig } from '../task-backend.js';
+export interface PlanFileInfo {
+    path: string;
+    exists: boolean;
+    content?: string;
+}
+/**
+ * Interface for plan management operations
+ * All plan managers must implement this interface
+ */
+export interface IPlanManager {
+    /**
+     * Set the state machine definition for dynamic plan generation
+     */
+    setStateMachine(stateMachine: YamlStateMachine): void;
+    /**
+     * Set the task backend configuration
+     */
+    setTaskBackend(taskBackend: TaskBackendConfig): void;
+    /**
+     * Get plan file information
+     */
+    getPlanFileInfo(planFilePath: string): Promise<PlanFileInfo>;
+    /**
+     * Create initial plan file if it doesn't exist
+     */
+    ensurePlanFile(planFilePath: string, projectPath: string, gitBranch: string): Promise<void>;
+    /**
+     * Update plan file with new content
+     */
+    updatePlanFile(planFilePath: string, content: string): Promise<void>;
+    /**
+     * Get plan file content for LLM context
+     */
+    getPlanFileContent(planFilePath: string): Promise<string>;
+    /**
+     * Generate phase-specific plan file guidance based on state machine
+     */
+    generatePlanFileGuidance(phase: string): string;
+    /**
+     * Delete plan file
+     */
+    deletePlanFile(planFilePath: string): Promise<boolean>;
+    /**
+     * Ensure plan file is deleted (verify deletion)
+     */
+    ensurePlanFileDeleted(planFilePath: string): Promise<boolean>;
+}

package/packages/core/dist/interfaces/plan-manager.interface.js

@@ -0,0 +1,8 @@
+/**
+ * Plan Manager Interface
+ *
+ * Defines the contract for plan management functionality.
+ * Enables strategy pattern implementation for different task backends.
+ */
+export {};
+//# sourceMappingURL=plan-manager.interface.js.map

package/packages/core/dist/interfaces/plan-manager.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-manager.interface.js","sourceRoot":"","sources":["../../src/interfaces/plan-manager.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/packages/core/dist/interfaces/task-backend-client.interface.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Task Backend Client Interface
+ *
+ * Defines the contract for task backend operations (CLI commands, etc.).
+ * Enables clean abstraction of different task backends (beads, GitHub Issues, etc.).
+ */
+/**
+ * Represents a task from the backend
+ */
+export interface BackendTask {
+    id: string;
+    title: string;
+    status: 'open' | 'in_progress' | 'completed' | 'cancelled';
+    priority: number;
+    parent?: string;
+    children?: BackendTask[];
+}
+/**
+ * Result of task validation operations
+ */
+export interface TaskValidationResult {
+    valid: boolean;
+    openTasks: BackendTask[];
+    message?: string;
+}
+/**
+ * Interface for task backend client operations
+ * All task backend clients must implement this interface
+ */
+export interface ITaskBackendClient {
+    /**
+     * Check if the task backend is available and properly configured
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Get all open tasks for a given parent task
+     */
+    getOpenTasks(parentTaskId: string): Promise<BackendTask[]>;
+    /**
+     * Validate that all tasks under a parent are completed
+     * Returns validation result with details about any remaining open tasks
+     */
+    validateTasksCompleted(parentTaskId: string): Promise<TaskValidationResult>;
+    /**
+     * Create a new task under a parent
+     */
+    createTask(title: string, parentTaskId: string, priority?: number): Promise<string>;
+    /**
+     * Update task status
+     */
+    updateTaskStatus(taskId: string, status: 'open' | 'in_progress' | 'completed' | 'cancelled'): Promise<void>;
+}