@codemcp/workflows 6.3.1 → 6.5.0

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

@@ -7,17 +7,17 @@
  * Handles variable substitution for project artifact references.
  */
 import { ProjectDocsManager } from './project-docs-manager.js';
+import { createLogger } from './logger.js';
+import { capitalizePhase } from './string-utils.js';
 export class InstructionGenerator {
     projectDocsManager;
-    constructor(_planManager) {
-        // planManager parameter kept for API compatibility but not stored since unused
-        this.projectDocsManager = new ProjectDocsManager();
+    constructor(logger = createLogger('InstructionGenerator')) {
+        this.projectDocsManager = new ProjectDocsManager(logger);
     }
     /**
-     * Set the state machine definition for dynamic instruction generation
+     * No-op: all phase context is provided per-call via InstructionContext.
      */
     setStateMachine(_stateMachine) {
-        // stateMachine parameter kept for API compatibility but not stored since unused
         return;
     }
     /**
@@ -30,7 +30,6 @@ export class InstructionGenerator {
         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,
@@ -62,28 +61,21 @@ export class InstructionGenerator {
      * Enhance base instructions with context-specific information
      */
     async enhanceInstructions(baseInstructions, context) {
-        const { phase, conversationContext, planFileExists } = context;
-        const phaseName = this.capitalizePhase(phase);
+        const { phase, conversationContext, allowedFilePatterns } = context;
+        const phaseName = 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';
+**Read \`${conversationContext.planFilePath}\`** for context.
+- Focus on "${phaseName}" tasks, log decisions in "Key Decisions"
+- Do NOT use other task/todo tools - use only the plan file for task tracking`;
+        // Add file restriction guidance if patterns are restricted
+        if (allowedFilePatterns &&
+            allowedFilePatterns.length > 0 &&
+            !allowedFilePatterns.includes('**/*') &&
+            !allowedFilePatterns.includes('*')) {
+            workflowSection += `\n- Files allowed: \`${allowedFilePatterns.join('`, `')}\``;
         }
-        workflowSection += '\n\nCall `whats_next()` after each user message.';
+        workflowSection += '\n\nCall `whats_next()` after user messages.';
         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

@@ -1 +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"}
+{"version":3,"file":"instruction-generator.js","sourceRoot":"","sources":["../src/instruction-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,MAAM,OAAO,oBAAoB;IACvB,kBAAkB,CAAqB;IAE/C,YAAY,SAAkB,YAAY,CAAC,sBAAsB,CAAC;QAChE,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,aAA+B;QAC7C,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,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,mBAAmB,EAAE,GAAG,OAAO,CAAC;QAEpE,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAEzC,IAAI,eAAe,GAAG;WACf,mBAAmB,CAAC,YAAY;cAC7B,SAAS;8EACuD,CAAC;QAE3E,2DAA2D;QAC3D,IACE,mBAAmB;YACnB,mBAAmB,CAAC,MAAM,GAAG,CAAC;YAC9B,CAAC,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAClC,CAAC;YACD,eAAe,IAAI,wBAAwB,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAClF,CAAC;QAED,eAAe,IAAI,8CAA8C,CAAC;QAElE,OAAO,MAAM,SAAS,aAAa,gBAAgB,OAAO,eAAe,EAAE,CAAC;IAC9E,CAAC;CACF"}

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

@@ -11,13 +11,13 @@ export interface InstructionContext {
     conversationContext: ConversationContext;
     transitionReason: string;
     isModeled: boolean;
-    planFileExists: boolean;
     /** Source of the instruction generation request - helps generators adapt output */
-    instructionSource: 'proceed_to_phase' | 'whats_next';
+    instructionSource: 'proceed_to_phase' | 'whats_next' | 'start_development';
+    /** Glob patterns for files allowed to be edited in this phase (optional) */
+    allowedFilePatterns?: string[];
 }
 export interface GeneratedInstructions {
     instructions: string;
-    planFileGuidance: string;
     metadata: {
         phase: string;
         planFilePath: string;
@@ -25,13 +25,22 @@ export interface GeneratedInstructions {
         isModeled: boolean;
     };
 }
+/**
+ * Interface for enriching generated instructions with additional guidance.
+ * Implementations can append, prepend, or transform instruction content.
+ */
+export interface InstructionEnricher {
+    enrichInstructions(instructions: GeneratedInstructions, context: InstructionContext): Promise<GeneratedInstructions>;
+}
 /**
  * Interface for instruction generation operations
  * All instruction generators must implement this interface
  */
 export interface IInstructionGenerator {
     /**
-     * Set the state machine definition for dynamic instruction generation
+     * Set the state machine definition for dynamic instruction generation.
+     * Implementations that derive all phase context from InstructionContext per-call
+     * may treat this as a no-op.
      */
     setStateMachine(stateMachine: YamlStateMachine): void;
     /**

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

@@ -52,4 +52,13 @@ export interface IPlanManager {
      * Ensure plan file is deleted (verify deletion)
      */
     ensurePlanFileDeleted(planFilePath: string): Promise<boolean>;
+    /**
+     * Generate base instructions for the LLM after a workflow is started.
+     * Instructs the LLM to populate the Goal section and define phase entrance
+     * criteria in the freshly created plan file.
+     *
+     * @param planFilePath - Path to the plan file
+     * @param workflowDocUrl - Optional URL for workflow documentation
+     */
+    getInitialPlanGuidance(planFilePath: string, workflowDocUrl?: string): string;
 }

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

@@ -1,16 +1,15 @@
 /**
- * Logging utility for Vibe Feature MCP Server
+ * Logging utility for workflows-core
  *
- * Provides structured logging with proper MCP compliance:
- * - Uses stderr for all local logging (MCP requirement)
- * - Supports MCP log message notifications to client
+ * Provides structured logging with pluggable sinks:
+ * - Uses stderr for all local logging by default
+ * - Supports external log sinks (e.g., MCP notifications) via LogSink interface
  * - Provides structured logging with proper levels:
  *   - debug: Tracing and detailed execution flow
  *   - info: Success operations and important milestones
  *   - warn: Expected errors and recoverable issues
  *   - error: Caught but unexpected errors
  */
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare enum LogLevel {
     DEBUG = 0,
     INFO = 1,
@@ -26,35 +25,65 @@ export interface LogContext {
     [key: string]: unknown;
 }
 /**
- * Set the MCP server instance for log notifications
+ * Interface for external log sinks (e.g., MCP notifications, console, file)
+ * Implementations can be registered to receive log messages
  */
-export declare function setMcpServerForLogging(server: McpServer): void;
+export interface LogSink {
+    /**
+     * Called when a log message should be sent to the sink
+     * @param level - Log level (debug, info, warning, error)
+     * @param logger - Component name that generated the log
+     * @param message - Log message
+     * @param context - Optional structured context
+     */
+    log(level: 'debug' | 'info' | 'warning' | 'error', logger: string, message: string, context?: LogContext): Promise<void>;
+}
+/**
+ * Logger interface for dependency injection
+ * Allows handlers to receive a logger without importing the global createLogger
+ */
+export interface ILogger {
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error, context?: LogContext): void;
+}
+/**
+ * Factory function type for creating loggers
+ * Can be injected to provide different logging implementations
+ */
+export type LoggerFactory = (component: string) => ILogger;
+/**
+ * Register a log sink to receive log messages
+ * Used by mcp-server to register MCP notification sink
+ */
+export declare function registerLogSink(sink: LogSink): void;
 /**
- * Set the logging level from MCP client request
+ * Clear the registered log sink
  */
-export declare function setMcpLoggingLevel(level: string): void;
+export declare function clearLogSink(): void;
+/**
+ * Set the logging level programmatically
+ */
+export declare function setLoggingLevel(level: LogLevel): void;
+/**
+ * Set the logging level from a string (e.g., from MCP client request)
+ */
+export declare function setLoggingLevelFromString(level: string): void;
 declare class Logger {
     private component;
-    private explicitLogLevel?;
+    private explicitLogLevel;
     constructor(component: string, logLevel?: LogLevel);
     private getCurrentLogLevel;
     private getLogLevelFromEnv;
     private shouldLog;
     private formatMessage;
     /**
-     * Send log message to MCP client if server is available and level is appropriate
+     * Send log message to registered sink if available
      */
-    private sendMcpLogMessage;
+    private sendToSink;
     debug(message: string, context?: LogContext): void;
     info(message: string, context?: LogContext): void;
-    /**
-     * Send enhanced MCP notifications with better formatting for important events
-     */
-    private sendEnhancedMcpNotification;
-    /**
-     * Capitalize phase name for display
-     */
-    private capitalizePhase;
     warn(message: string, context?: LogContext): void;
     error(message: string, error?: Error, context?: LogContext): void;
     child(childComponent: string): Logger;

package/packages/core/dist/logger.js

@@ -1,9 +1,9 @@
 /**
- * Logging utility for Vibe Feature MCP Server
+ * Logging utility for workflows-core
  *
- * Provides structured logging with proper MCP compliance:
- * - Uses stderr for all local logging (MCP requirement)
- * - Supports MCP log message notifications to client
+ * Provides structured logging with pluggable sinks:
+ * - Uses stderr for all local logging by default
+ * - Supports external log sinks (e.g., MCP notifications) via LogSink interface
  * - Provides structured logging with proper levels:
  *   - debug: Tracing and detailed execution flow
  *   - info: Success operations and important milestones
@@ -18,38 +18,46 @@ export var LogLevel;
     LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
     LogLevel[LogLevel["SILENT"] = 4] = "SILENT";
 })(LogLevel || (LogLevel = {}));
-// Global MCP server reference for log notifications
-let mcpServerInstance = null;
-// Unified logging level - can be set by MCP client or environment
+// Global log sink reference (e.g., MCP server, custom sink)
+let logSinkInstance = null;
+// Unified logging level - can be set externally or via environment
 let currentLoggingLevel = null;
 // Test mode detection function to check at runtime
 function isTestMode() {
     // Check explicit environment variables
-    if (process.env.NODE_ENV === 'test' || process.env.VITEST === 'true') {
-        return true;
-    }
-    // Check if running in a temporary directory (common for tests)
-    const cwd = process.cwd();
-    if (cwd.includes('/tmp/') || cwd.includes('temp') || cwd.includes('test-')) {
+    if (process.env['NODE_ENV'] === 'test' || process.env['VITEST'] === 'true') {
         return true;
     }
     // Check if LOG_LEVEL is explicitly set to ERROR
-    if (process.env.LOG_LEVEL === 'ERROR') {
+    if (process.env['LOG_LEVEL'] === 'ERROR') {
         return true;
     }
     return false;
 }
 /**
- * Set the MCP server instance for log notifications
+ * Register a log sink to receive log messages
+ * Used by mcp-server to register MCP notification sink
+ */
+export function registerLogSink(sink) {
+    logSinkInstance = sink;
+}
+/**
+ * Clear the registered log sink
+ */
+export function clearLogSink() {
+    logSinkInstance = null;
+}
+/**
+ * Set the logging level programmatically
  */
-export function setMcpServerForLogging(server) {
-    mcpServerInstance = server;
+export function setLoggingLevel(level) {
+    currentLoggingLevel = level;
 }
 /**
- * Set the logging level from MCP client request
+ * Set the logging level from a string (e.g., from MCP client request)
  */
-export function setMcpLoggingLevel(level) {
-    // Map MCP levels to our internal levels
+export function setLoggingLevelFromString(level) {
+    // Map string levels to our internal levels
     const levelMap = {
         debug: LogLevel.DEBUG,
         info: LogLevel.INFO,
@@ -79,7 +87,7 @@ class Logger {
         if (isTestMode()) {
             return LogLevel.ERROR;
         }
-        // Use MCP-set level if available (takes precedence)
+        // Use externally-set level if available (takes precedence)
         if (currentLoggingLevel !== null) {
             return currentLoggingLevel;
         }
@@ -95,7 +103,7 @@ class Logger {
         return LogLevel.INFO;
     }
     getLogLevelFromEnv() {
-        const envLevel = process.env.LOG_LEVEL?.toUpperCase();
+        const envLevel = process.env['LOG_LEVEL']?.toUpperCase();
         switch (envLevel) {
             case 'DEBUG':
                 return LogLevel.DEBUG;
@@ -120,139 +128,54 @@ class Logger {
         return `[${timestamp}] ${level.toUpperCase()} [${this.component}] ${message}${contextStr}`;
     }
     /**
-     * Send log message to MCP client if server is available and level is appropriate
+     * Send log message to registered sink if available
      */
-    async sendMcpLogMessage(level, message, context) {
-        if (mcpServerInstance) {
+    async sendToSink(level, message, context) {
+        if (logSinkInstance) {
             try {
-                // Safely serialize context to avoid JSON issues
-                let logData = message;
-                if (context) {
-                    try {
-                        const contextStr = JSON.stringify(context, null, 0);
-                        logData = `${message} ${contextStr}`;
-                    }
-                    catch (_error) {
-                        // If JSON serialization fails, just use the message
-                        logData = `${message} [context serialization failed]`;
-                    }
-                }
-                await mcpServerInstance.server.notification({
-                    method: 'notifications/message',
-                    params: {
-                        level,
-                        logger: this.component,
-                        data: logData,
-                    },
-                });
+                await logSinkInstance.log(level, this.component, message, context);
             }
             catch (error) {
-                // Fallback to stderr if MCP notification fails
-                // Don't use this.error to avoid infinite recursion
+                // Fallback to stderr if sink fails
                 if (!isTestMode()) {
-                    process.stderr.write(`[MCP-LOG-ERROR] Failed to send log notification: ${error}\n`);
+                    process.stderr.write(`[LOG-SINK-ERROR] Failed to send log to sink: ${error}\n`);
                 }
             }
         }
     }
     debug(message, context) {
         if (this.shouldLog(LogLevel.DEBUG)) {
-            const formattedMessage = this.formatMessage('debug', message, context);
-            // Always log to stderr for MCP compliance
-            process.stderr.write(formattedMessage + '\n');
-            // Also send to MCP client if available (only for debug level)
-            this.sendMcpLogMessage('debug', message, context).catch(() => {
-                // Ignore MCP notification errors for debug messages
+            // Avoid duplicate output when a sink is active (sink owns its own output channel)
+            if (!logSinkInstance) {
+                const formattedMessage = this.formatMessage('debug', message, context);
+                process.stderr.write(formattedMessage + '\n');
+            }
+            this.sendToSink('debug', message, context).catch(() => {
+                // Sink errors are non-fatal for debug messages
             });
         }
     }
     info(message, context) {
         if (this.shouldLog(LogLevel.INFO)) {
-            const formattedMessage = this.formatMessage('info', message, context);
-            // Always log to stderr for MCP compliance
-            process.stderr.write(formattedMessage + '\n');
-            // Send enhanced notifications for important events
-            this.sendEnhancedMcpNotification('info', message, context).catch(() => {
-                // Ignore MCP notification errors for info messages
-            });
-        }
-    }
-    /**
-     * Send enhanced MCP notifications with better formatting for important events
-     */
-    async sendEnhancedMcpNotification(level, message, context) {
-        if (mcpServerInstance) {
-            try {
-                let enhancedMessage = message;
-                let notificationLevel = level;
-                // Enhance phase transition messages
-                if (context &&
-                    (context.from || context.to) &&
-                    message.includes('transition')) {
-                    const from = context.from
-                        ? this.capitalizePhase(context.from)
-                        : '';
-                    const to = context.to
-                        ? this.capitalizePhase(context.to)
-                        : '';
-                    if (from && to) {
-                        enhancedMessage = `Phase Transition: ${from} → ${to}`;
-                        notificationLevel = 'info';
-                    }
-                }
-                // Enhance initialization messages
-                if (message.includes('initialized successfully')) {
-                    enhancedMessage = '🚀 Vibe Feature MCP Server Ready';
-                    notificationLevel = 'info';
-                }
-                // Safely serialize context to avoid JSON issues
-                let logData = enhancedMessage;
-                if (context) {
-                    try {
-                        const contextStr = JSON.stringify(context, null, 0);
-                        logData = `${enhancedMessage} ${contextStr}`;
-                    }
-                    catch (_error) {
-                        // If JSON serialization fails, just use the message
-                        logData = `${enhancedMessage} [context serialization failed]`;
-                    }
-                }
-                // Use the underlying server's notification method
-                await mcpServerInstance.server.notification({
-                    method: 'notifications/message',
-                    params: {
-                        level: notificationLevel,
-                        logger: this.component,
-                        data: logData,
-                    },
-                });
-            }
-            catch (error) {
-                // Fallback to stderr if MCP notification fails
-                // Don't use this.error to avoid infinite recursion
-                if (!isTestMode()) {
-                    process.stderr.write(`[MCP-LOG-ERROR] Failed to send log notification: ${error}\n`);
-                }
+            // Avoid duplicate output when a sink is active (sink owns its own output channel)
+            if (!logSinkInstance) {
+                const formattedMessage = this.formatMessage('info', message, context);
+                process.stderr.write(formattedMessage + '\n');
             }
+            this.sendToSink('info', message, context).catch(() => {
+                // Sink errors are non-fatal for info messages
+            });
         }
     }
-    /**
-     * Capitalize phase name for display
-     */
-    capitalizePhase(phase) {
-        return phase
-            .split('_')
-            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-            .join(' ');
-    }
     warn(message, context) {
         if (this.shouldLog(LogLevel.WARN)) {
-            const formattedMessage = this.formatMessage('warn', message, context);
-            // Always log to stderr for MCP compliance
-            process.stderr.write(formattedMessage + '\n');
-            // Also send to MCP client if available
-            this.sendEnhancedMcpNotification('warning', message, context).catch(() => {
-                // Ignore MCP notification errors for warn messages
+            // Avoid duplicate output when a sink is active (sink owns its own output channel)
+            if (!logSinkInstance) {
+                const formattedMessage = this.formatMessage('warn', message, context);
+                process.stderr.write(formattedMessage + '\n');
+            }
+            this.sendToSink('warning', message, context).catch(() => {
+                // Sink errors are non-fatal for warn messages
             });
         }
     }
@@ -261,12 +184,13 @@ class Logger {
             const errorContext = error
                 ? { ...context, error: error.message, stack: error.stack }
                 : context;
-            const formattedMessage = this.formatMessage('error', message, errorContext);
-            // Always log to stderr for MCP compliance
-            process.stderr.write(formattedMessage + '\n');
-            // Also send to MCP client if available
-            this.sendEnhancedMcpNotification('error', message, errorContext).catch(() => {
-                // Ignore MCP notification errors for error messages
+            // Avoid duplicate output when a sink is active (sink owns its own output channel)
+            if (!logSinkInstance) {
+                const formattedMessage = this.formatMessage('error', message, errorContext);
+                process.stderr.write(formattedMessage + '\n');
+            }
+            this.sendToSink('error', message, errorContext).catch(() => {
+                // Sink errors are non-fatal — error already written to stderr above
             });
         }
     }
@@ -279,5 +203,5 @@ export function createLogger(component, logLevel) {
     return new Logger(component, logLevel);
 }
 // Default logger for the main application
-export const logger = createLogger('VibeFeatureMCP');
+export const logger = createLogger('workflows-core');
 //# sourceMappingURL=logger.js.map

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

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

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

@@ -54,13 +54,15 @@ export declare class PlanManager implements IPlanManager {
      * Ensure plan file is deleted (verify deletion)
      */
     ensurePlanFileDeleted(planFilePath: string): Promise<boolean>;
-    /**
-     * Capitalize phase name for display
-     */
-    private capitalizePhase;
     /**
      * Generate workflow documentation URL for predefined workflows
      * Returns undefined for custom workflows
      */
     private generateWorkflowDocumentationUrl;
+    /**
+     * Generate base instructions for the LLM after a workflow is started.
+     * Instructs the LLM to populate the Goal section and define phase entrance
+     * criteria in the freshly created plan file.
+     */
+    getInitialPlanGuidance(planFilePath: string, workflowDocUrl?: string): string;
 }