@codemcp/workflows 4.10.1 → 4.10.3

package/dist/plugin-system/beads-plugin.js

@@ -0,0 +1,459 @@
+/**
+ * Beads Plugin Implementation
+ *
+ * Plugin that integrates beads task management system with responsible-vibe-mcp.
+ * Encapsulates ALL beads-specific functionality to maintain zero core application
+ * coupling as specified in plugin architecture design.
+ *
+ * Core Principle: This plugin must be completely self-contained and the core
+ * application must have ZERO knowledge of beads functionality.
+ */
+import { BeadsStateManager, BeadsIntegration, createLogger, PlanManager, } from '@codemcp/workflows-core';
+import { BeadsTaskBackendClient } from '../components/beads/beads-task-backend-client.js';
+const logger = createLogger('BeadsPlugin');
+/**
+ * BeadsPlugin class implementing the IPlugin interface
+ *
+ * Activation: Only when process.env.TASK_BACKEND === 'beads'
+ * Priority: Sequence 100 (middle priority)
+ * Encapsulation: All beads functionality contained within this plugin
+ */
+export class BeadsPlugin {
+    projectPath;
+    beadsStateManager;
+    beadsTaskBackendClient;
+    planManager;
+    constructor(options) {
+        this.projectPath = options.projectPath;
+        // Initialize internal beads components
+        this.beadsStateManager = new BeadsStateManager(this.projectPath);
+        this.beadsTaskBackendClient = new BeadsTaskBackendClient(this.projectPath);
+        this.planManager = new PlanManager();
+        logger.debug('BeadsPlugin initialized', { projectPath: this.projectPath });
+    }
+    getName() {
+        return 'BeadsPlugin';
+    }
+    getSequence() {
+        return 100; // Middle priority as specified
+    }
+    isEnabled() {
+        const enabled = process.env.TASK_BACKEND === 'beads';
+        logger.debug('BeadsPlugin enablement check', {
+            TASK_BACKEND: process.env.TASK_BACKEND,
+            enabled,
+        });
+        return enabled;
+    }
+    getHooks() {
+        return {
+            afterStartDevelopment: this.handleAfterStartDevelopment.bind(this),
+            beforePhaseTransition: this.handleBeforePhaseTransition.bind(this),
+            afterPlanFileCreated: this.handleAfterPlanFileCreated.bind(this),
+        };
+    }
+    /**
+     * Handle beforePhaseTransition hook
+     * Replaces validateBeadsTaskCompletion() method from proceed-to-phase.ts
+     */
+    async handleBeforePhaseTransition(context, currentPhase, targetPhase) {
+        logger.info('BeadsPlugin: Validating task completion before phase transition', {
+            conversationId: context.conversationId,
+            currentPhase,
+            targetPhase,
+        });
+        try {
+            await this.validateBeadsTaskCompletion(context.conversationId, currentPhase, targetPhase, context.projectPath);
+            logger.info('BeadsPlugin: Task validation passed, allowing phase transition', {
+                conversationId: context.conversationId,
+                currentPhase,
+                targetPhase,
+            });
+        }
+        catch (error) {
+            logger.info('BeadsPlugin: Task validation failed, blocking phase transition', {
+                conversationId: context.conversationId,
+                currentPhase,
+                targetPhase,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            // Re-throw validation errors to block transitions
+            throw error;
+        }
+    }
+    /**
+     * Handle afterStartDevelopment hook
+     * Replaces setupBeadsIntegration() method from start-development.ts
+     * Implements graceful degradation: continues app operation even if beads operations fail
+     */
+    async handleAfterStartDevelopment(context, args, _result) {
+        logger.info('BeadsPlugin: Setting up beads integration', {
+            conversationId: context.conversationId,
+            workflow: args.workflow,
+            projectPath: context.projectPath,
+        });
+        // Verify we have the required state machine information
+        if (!context.stateMachine) {
+            logger.error('BeadsPlugin: State machine not provided in plugin context');
+            logger.warn('BeadsPlugin: Beads integration disabled - continuing without beads');
+            return; // Graceful degradation: continue without beads
+        }
+        try {
+            const beadsIntegration = new BeadsIntegration(context.projectPath);
+            const projectName = context.projectPath.split('/').pop() || 'Unknown Project';
+            // Extract goal from plan file if it exists and has meaningful content
+            let goalDescription;
+            try {
+                const planFileContent = await this.planManager.getPlanFileContent(context.planFilePath);
+                goalDescription = this.extractGoalFromPlan(planFileContent);
+            }
+            catch (error) {
+                logger.warn('BeadsPlugin: Could not extract goal from plan file', {
+                    error: error instanceof Error ? error.message : String(error),
+                    planFilePath: context.planFilePath,
+                });
+                // Continue without goal - it's optional
+            }
+            // Extract plan filename for use in epic title
+            const planFilename = context.planFilePath.split('/').pop();
+            // Try to create project epic
+            let epicId;
+            try {
+                epicId = await beadsIntegration.createProjectEpic(projectName, args.workflow, goalDescription, planFilename);
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn('BeadsPlugin: Failed to create beads project epic - continuing without beads integration', {
+                    error: errorMsg,
+                    projectPath: context.projectPath,
+                });
+                // Graceful degradation: continue app operation without beads
+                return;
+            }
+            // Try to create phase tasks
+            let phaseTasks;
+            try {
+                phaseTasks = await beadsIntegration.createPhaseTasks(epicId, context.stateMachine.states, args.workflow);
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn('BeadsPlugin: Failed to create beads phase tasks - continuing without phase tracking', {
+                    error: errorMsg,
+                    epicId,
+                });
+                // Graceful degradation: continue without phase tracking
+                return;
+            }
+            // Try to create sequential dependencies between phases
+            try {
+                await beadsIntegration.createPhaseDependencies(phaseTasks);
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn('BeadsPlugin: Failed to create phase dependencies - continuing without dependencies', {
+                    error: errorMsg,
+                    phaseCount: phaseTasks.length,
+                });
+                // Graceful degradation: continue without dependencies
+            }
+            // Try to update plan file with phase task IDs
+            try {
+                await this.updatePlanFileWithPhaseTaskIds(context.planFilePath, phaseTasks);
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn('BeadsPlugin: Failed to update plan file with beads task IDs - continuing without plan file updates', {
+                    error: errorMsg,
+                    planFilePath: context.planFilePath,
+                });
+                // Graceful degradation: continue without plan file updates
+            }
+            // Try to create beads state for this conversation
+            try {
+                await this.beadsStateManager.createState(context.conversationId, epicId, phaseTasks);
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn('BeadsPlugin: Failed to create beads state - continuing without state persistence', {
+                    error: errorMsg,
+                    conversationId: context.conversationId,
+                });
+                // Graceful degradation: continue without state persistence
+            }
+            logger.info('BeadsPlugin: Beads integration setup complete', {
+                conversationId: context.conversationId,
+                epicId,
+                phaseCount: phaseTasks?.length || 0,
+                planFilePath: context.planFilePath,
+            });
+        }
+        catch (error) {
+            // Catch-all for unexpected errors: log and continue
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger.warn('BeadsPlugin: Unexpected error during beads integration setup - continuing application without beads', {
+                error: errorMsg,
+                conversationId: context.conversationId,
+            });
+            // Graceful degradation: never crash the app due to beads errors
+        }
+    }
+    /**
+     * Handle afterPlanFileCreated hook
+     * Enhances the plan file with beads-specific templates and placeholders
+     *
+     * This hook is called after a plan file is created. For beads integration,
+     * it ensures the plan file has TBD placeholders for phase task IDs that
+     * will be filled in later by afterStartDevelopment.
+     *
+     * Note: Task IDs themselves are created in afterStartDevelopment, not here.
+     * This hook ensures the plan has the proper structure to receive them.
+     */
+    async handleAfterPlanFileCreated(_context, planFilePath, content) {
+        logger.debug('BeadsPlugin: afterPlanFileCreated hook invoked', {
+            planFilePath,
+            contentLength: content.length,
+        });
+        // The plan file is already created with TBD placeholders by BeadsPlanManager
+        // No additional modifications needed at this stage.
+        // The beads task IDs will be added by afterStartDevelopment hook
+        // which calls updatePlanFileWithPhaseTaskIds.
+        //
+        // This hook currently returns content unchanged, but could be extended in the
+        // future for additional beads-specific plan enhancements such as:
+        // - Adding beads CLI usage instructions
+        // - Adding task templates
+        // - Adding workflow guidance
+        return content;
+    }
+    /**
+     * Validate beads task completion before phase transition
+     * Implements graceful error handling: logs errors but continues on non-validation failures
+     */
+    async validateBeadsTaskCompletion(conversationId, currentPhase, targetPhase, projectPath) {
+        try {
+            // Check if beads backend client is available
+            let isAvailable = false;
+            try {
+                isAvailable = await this.beadsTaskBackendClient.isAvailable();
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn('BeadsPlugin: Failed to check beads availability', {
+                    error: errorMsg,
+                    conversationId,
+                });
+                // Graceful degradation: assume beads is unavailable and continue
+                return;
+            }
+            if (!isAvailable) {
+                // Not in beads mode or beads not available, skip validation
+                logger.debug('BeadsPlugin: Skipping beads task validation - beads CLI not available', {
+                    conversationId,
+                    currentPhase,
+                    targetPhase,
+                });
+                return;
+            }
+            // Get beads state for this conversation
+            let currentPhaseTaskId = null;
+            try {
+                currentPhaseTaskId = await this.beadsStateManager.getPhaseTaskId(conversationId, currentPhase);
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn('BeadsPlugin: Failed to get beads phase task ID', {
+                    error: errorMsg,
+                    conversationId,
+                    currentPhase,
+                });
+                // Graceful degradation: continue without validation
+                return;
+            }
+            if (!currentPhaseTaskId) {
+                // No beads state found for this conversation - fallback to graceful handling
+                logger.debug('BeadsPlugin: No beads phase task ID found for current phase', {
+                    conversationId,
+                    currentPhase,
+                    targetPhase,
+                    projectPath,
+                });
+                return;
+            }
+            logger.debug('BeadsPlugin: Checking for incomplete beads tasks using task backend client', {
+                conversationId,
+                currentPhase,
+                currentPhaseTaskId,
+            });
+            // Use task backend client to validate task completion
+            let validationResult;
+            try {
+                validationResult =
+                    await this.beadsTaskBackendClient.validateTasksCompleted(currentPhaseTaskId);
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn('BeadsPlugin: Failed to validate tasks with beads backend', {
+                    error: errorMsg,
+                    conversationId,
+                    currentPhaseTaskId,
+                });
+                // Graceful degradation: allow transition if validation fails
+                return;
+            }
+            if (!validationResult.valid) {
+                // Get the incomplete tasks from the validation result
+                const incompleteTasks = validationResult.openTasks || [];
+                // Create detailed error message with incomplete tasks
+                const taskDetails = incompleteTasks
+                    .map(task => `  • ${task.id} - ${task.title || 'Untitled task'}`)
+                    .join('\n');
+                const errorMessage = `Cannot proceed to ${targetPhase} - ${incompleteTasks.length} incomplete task(s) in current phase "${currentPhase}":
+
+${taskDetails}
+
+To proceed, check the in-progress-tasks using:
+
+   bd list --parent ${currentPhaseTaskId} --status open
+
+You can also defer tasks if they're no longer needed:
+   bd defer <task-id> --until tomorrow`;
+                logger.info('BeadsPlugin: Blocking phase transition due to incomplete beads tasks', {
+                    conversationId,
+                    currentPhase,
+                    targetPhase,
+                    currentPhaseTaskId,
+                    incompleteTaskCount: incompleteTasks.length,
+                    incompleteTaskIds: incompleteTasks.map(t => t.id),
+                });
+                throw new Error(errorMessage);
+            }
+            logger.info('BeadsPlugin: All beads tasks completed in current phase, allowing transition', {
+                conversationId,
+                currentPhase,
+                targetPhase,
+                currentPhaseTaskId,
+            });
+        }
+        catch (error) {
+            // Re-throw validation errors (incomplete tasks)
+            if (error instanceof Error &&
+                error.message.includes('Cannot proceed to')) {
+                throw error;
+            }
+            // Log other errors but allow transition (graceful degradation)
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.warn('BeadsPlugin: Beads task validation failed, allowing transition to proceed', {
+                error: errorMessage,
+                conversationId,
+                currentPhase,
+                targetPhase,
+                projectPath,
+            });
+            // Graceful degradation: continue without beads state validation
+        }
+    }
+    /**
+     * Extract Goal section content from plan file
+     * Returns the goal content if it exists and is meaningful, otherwise undefined
+     */
+    extractGoalFromPlan(planContent) {
+        if (!planContent || typeof planContent !== 'string') {
+            return undefined;
+        }
+        // Split content into lines for more reliable parsing
+        const lines = planContent.split('\n');
+        const goalIndex = lines.findIndex(line => line.trim() === '## Goal');
+        if (goalIndex === -1) {
+            return undefined;
+        }
+        // Find the next section (## anything) after the Goal section
+        const nextSectionIndex = lines.findIndex((line, index) => index > goalIndex && line.trim().startsWith('## '));
+        // Extract content between Goal and next section (or end of content)
+        const contentLines = nextSectionIndex === -1
+            ? lines.slice(goalIndex + 1)
+            : lines.slice(goalIndex + 1, nextSectionIndex);
+        const goalContent = contentLines.join('\n').trim();
+        // Check if the goal content is meaningful (not just a placeholder or comment)
+        const meaninglessPatterns = [
+            /^\*.*\*$/, // Enclosed in asterisks like "*Define what you're building...*"
+            /^To be defined/i,
+            /^TBD$/i,
+            /^TODO/i,
+            /^Define what you're building/i,
+            /^This will be updated/i,
+        ];
+        const isMeaningless = meaninglessPatterns.some(pattern => pattern.test(goalContent));
+        if (isMeaningless || goalContent.length < 10) {
+            return undefined;
+        }
+        return goalContent;
+    }
+    /**
+     * Update plan file to include beads phase task IDs in comments
+     * Implements graceful degradation: logs errors but continues app operation if update fails
+     */
+    async updatePlanFileWithPhaseTaskIds(planFilePath, phaseTasks) {
+        try {
+            const { readFile, writeFile } = await import('node:fs/promises');
+            // Try to read the plan file
+            let content;
+            try {
+                content = await readFile(planFilePath, 'utf-8');
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn('BeadsPlugin: Failed to read plan file for update', {
+                    error: errorMsg,
+                    planFilePath,
+                });
+                // Graceful degradation: continue without updating plan file
+                return;
+            }
+            // Replace TBD placeholders with actual task IDs
+            for (const phaseTask of phaseTasks) {
+                const phaseHeader = `## ${phaseTask.phaseName}`;
+                const placeholderPattern = new RegExp(`(${phaseHeader.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*\n)<!-- beads-phase-id: TBD -->`, 'g');
+                content = content.replace(placeholderPattern, `$1<!-- beads-phase-id: ${phaseTask.taskId} -->`);
+            }
+            // Validate that all TBD placeholders were replaced
+            const remainingTBDs = content.match(/<!-- beads-phase-id: TBD -->/g);
+            if (remainingTBDs && remainingTBDs.length > 0) {
+                logger.warn('BeadsPlugin: Failed to replace all TBD placeholders in plan file', {
+                    planFilePath,
+                    unreplacedCount: remainingTBDs.length,
+                    reason: 'Phase names in plan file may not match workflow phases or beads task creation may have failed for some phases',
+                });
+                // Graceful degradation: continue without full update
+                // But still try to write what we have
+            }
+            // Try to write the updated plan file
+            try {
+                await writeFile(planFilePath, content, 'utf-8');
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                logger.warn('BeadsPlugin: Failed to write updated plan file', {
+                    error: errorMsg,
+                    planFilePath,
+                });
+                // Graceful degradation: continue without writing to plan file
+                return;
+            }
+            logger.info('BeadsPlugin: Successfully updated plan file with beads phase task IDs', {
+                planFilePath,
+                phaseTaskCount: phaseTasks.length,
+                replacedTasks: phaseTasks.map(task => `${task.phaseName}: ${task.taskId}`),
+            });
+        }
+        catch (error) {
+            // Catch-all for unexpected errors
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            logger.warn('BeadsPlugin: Unexpected error while updating plan file with phase task IDs', {
+                error: errorMsg,
+                planFilePath,
+            });
+            // Graceful degradation: never crash the app due to plan file updates
+        }
+    }
+}
+//# sourceMappingURL=beads-plugin.js.map

package/dist/plugin-system/beads-plugin.js.map

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

package/dist/plugin-system/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Plugin system exports
+ *
+ * This module provides the core plugin system for extending responsible-vibe-mcp
+ * functionality without if-statements in the core application.
+ */
+export type { IPlugin, IPluginRegistry, PluginHooks, PluginHookContext, StartDevelopmentArgs, StartDevelopmentResult, GeneratedInstructions, } from './plugin-interfaces.js';
+export { PluginRegistry } from './plugin-registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugin-system/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin-system/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,OAAO,EACP,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/plugin-system/index.js

@@ -0,0 +1,9 @@
+/**
+ * Plugin system exports
+ *
+ * This module provides the core plugin system for extending responsible-vibe-mcp
+ * functionality without if-statements in the core application.
+ */
+// Plugin registry implementation
+export { PluginRegistry } from './plugin-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/plugin-system/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin-system/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,iCAAiC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/plugin-system/plugin-interfaces.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Plugin system interfaces for extending the responsible-vibe-mcp server
+ *
+ * Core Principle: Plugins receive only read-only context data and cannot
+ * directly manipulate core server components. They extend behavior through
+ * semantic lifecycle hooks only.
+ */
+import type { YamlState } from '@codemcp/workflows-core';
+/**
+ * Plugin interface - all plugins must implement this
+ */
+export interface IPlugin {
+    /** Unique plugin name */
+    getName(): string;
+    /** Execution sequence (lower numbers execute first) */
+    getSequence(): number;
+    /** Whether plugin is enabled (typically based on environment) */
+    isEnabled(): boolean;
+    /** Lifecycle hooks this plugin provides */
+    getHooks(): PluginHooks;
+}
+/**
+ * Lifecycle hooks that plugins can implement
+ * All hooks receive standardized PluginHookContext as first parameter
+ */
+export interface PluginHooks {
+    /** Called before development workflow starts */
+    beforeStartDevelopment?: (context: PluginHookContext, args: StartDevelopmentArgs) => Promise<void>;
+    /** Called after development workflow has started */
+    afterStartDevelopment?: (context: PluginHookContext, args: StartDevelopmentArgs, result: StartDevelopmentResult) => Promise<void>;
+    /** Called after plan file is created - can modify content */
+    afterPlanFileCreated?: (context: PluginHookContext, planFilePath: string, content: string) => Promise<string>;
+    /** Called before phase transition (can block by throwing) */
+    beforePhaseTransition?: (context: PluginHookContext, currentPhase: string, targetPhase: string) => Promise<void>;
+    /** Called after instructions are generated - can modify them */
+    afterInstructionsGenerated?: (context: PluginHookContext, instructions: GeneratedInstructions) => Promise<GeneratedInstructions>;
+}
+/**
+ * Standardized context provided to all plugin hooks
+ * Contains ONLY read-only data - no server components
+ */
+export interface PluginHookContext {
+    /** Current conversation ID */
+    conversationId: string;
+    /** Path to the plan file */
+    planFilePath: string;
+    /** Current development phase */
+    currentPhase: string;
+    /** Active workflow name */
+    workflow: string;
+    /** Project directory path */
+    projectPath: string;
+    /** Git branch name */
+    gitBranch: string;
+    /** Target phase (only available in phase transitions) */
+    targetPhase?: string;
+    /** Workflow state machine definition (read-only) - available in afterStartDevelopment */
+    stateMachine?: {
+        readonly name: string;
+        readonly description: string;
+        readonly initial_state: string;
+        readonly states: Record<string, YamlState>;
+    };
+}
+/**
+ * Plugin registry interface for managing and executing plugins
+ */
+export interface IPluginRegistry {
+    /** Register a plugin */
+    registerPlugin(plugin: IPlugin): void;
+    /** Get all enabled plugins sorted by sequence */
+    getEnabledPlugins(): IPlugin[];
+    /** Execute a specific hook on all plugins that implement it */
+    executeHook<T extends keyof PluginHooks>(hookName: T, ...args: Parameters<NonNullable<PluginHooks[T]>>): Promise<unknown>;
+    /** Check if any plugin has a specific hook */
+    hasHook(hookName: keyof PluginHooks): boolean;
+    /** Get names of all registered plugins */
+    getPluginNames(): string[];
+    /** Clear all plugins (mainly for testing) */
+    clear(): void;
+}
+export interface StartDevelopmentArgs {
+    workflow: string;
+    commit_behaviour: string;
+    require_reviews?: boolean;
+    project_path?: string;
+}
+export interface StartDevelopmentResult {
+    conversationId: string;
+    planFilePath: string;
+    phase: string;
+    workflow: string;
+}
+export interface GeneratedInstructions {
+    instructions: string;
+    planFilePath: string;
+    phase: string;
+}
+//# sourceMappingURL=plugin-interfaces.d.ts.map

package/dist/plugin-system/plugin-interfaces.d.ts.map

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

package/dist/plugin-system/plugin-interfaces.js

@@ -0,0 +1,9 @@
+/**
+ * Plugin system interfaces for extending the responsible-vibe-mcp server
+ *
+ * Core Principle: Plugins receive only read-only context data and cannot
+ * directly manipulate core server components. They extend behavior through
+ * semantic lifecycle hooks only.
+ */
+export {};
+//# sourceMappingURL=plugin-interfaces.js.map

package/dist/plugin-system/plugin-interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-interfaces.js","sourceRoot":"","sources":["../../src/plugin-system/plugin-interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}