@dotcontext/mcp 0.9.0

package/dist/workflow/orchestrator.js

@@ -0,0 +1,495 @@
+"use strict";
+/**
+ * PREVC Workflow Orchestrator
+ *
+ * Manages workflow progression, phase transitions, and role handoffs.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrevcOrchestrator = void 0;
+const path = __importStar(require("path"));
+const statusManager_1 = require("./status/statusManager");
+const scaling_1 = require("./scaling");
+const phases_1 = require("./phases");
+const prevcConfig_1 = require("./prevcConfig");
+const gates_1 = require("./gates");
+const planLinker_1 = require("./plans/planLinker");
+const agentOrchestrator_1 = require("./orchestration/agentOrchestrator");
+const skills_1 = require("./skills");
+/**
+ * PREVC Workflow Orchestrator
+ *
+ * Coordinates the execution of the PREVC workflow.
+ */
+class PrevcOrchestrator {
+    constructor(contextPath) {
+        this.repoPath = path.dirname(contextPath);
+        this.contextPath = contextPath;
+        this.statusManager = new statusManager_1.PrevcStatusManager(contextPath);
+        this.gateChecker = new gates_1.WorkflowGateChecker();
+        // Pass statusManager to PlanLinker for breadcrumb trail logging
+        this.planLinker = new planLinker_1.PlanLinker(path.dirname(contextPath), this.statusManager);
+    }
+    /**
+     * Check if a workflow exists
+     */
+    async hasWorkflow() {
+        return this.statusManager.exists();
+    }
+    /**
+     * Initialize a new workflow
+     */
+    async initWorkflow(context) {
+        const scale = (0, scaling_1.detectProjectScale)(context);
+        const route = (0, scaling_1.getScaleRoute)(scale);
+        const status = await this.statusManager.create({
+            name: context.name,
+            scale,
+            phases: route.phases,
+            roles: route.roles,
+        });
+        await this.planLinker.ensureWorkflowPlanIndex();
+        return status;
+    }
+    /**
+     * Initialize a workflow with explicit scale
+     * @param archivePrevious - If undefined and workflow exists, throws error. If true, archives. If false, deletes.
+     */
+    async initWorkflowWithScale(name, scale, settings, archivePrevious) {
+        // Check for existing workflow
+        if (await this.hasWorkflow()) {
+            if (archivePrevious === undefined) {
+                throw new Error('A workflow already exists. Use archivePrevious=true to archive or archivePrevious=false to delete the existing workflow.');
+            }
+            await this.resetWorkflow(archivePrevious);
+        }
+        const route = (0, scaling_1.getScaleRoute)(scale);
+        const status = await this.statusManager.create({
+            name,
+            scale,
+            phases: route.phases,
+            roles: route.roles,
+        });
+        await this.planLinker.ensureWorkflowPlanIndex();
+        // Apply custom settings if provided
+        if (settings) {
+            await this.statusManager.setSettings(settings);
+            return this.statusManager.load();
+        }
+        return status;
+    }
+    /**
+     * Reset the current workflow
+     * @param archive - If true, archives the current workflow. If false, deletes it.
+     */
+    async resetWorkflow(archive) {
+        if (archive) {
+            await this.archiveCurrentWorkflow();
+            await this.planLinker.archivePlans();
+        }
+        else {
+            await this.planLinker.clearAllPlans();
+            await this.statusManager.remove();
+        }
+    }
+    /**
+     * Archive the current workflow to .context/workflow/archive/
+     */
+    async archiveCurrentWorkflow() {
+        if (!(await this.statusManager.exists())) {
+            return;
+        }
+        // Get current workflow name for archive folder
+        let archiveName = 'workflow';
+        try {
+            const status = await this.statusManager.load();
+            archiveName = status.project.name.replace(/[^a-zA-Z0-9-_]/g, '-');
+        }
+        catch {
+            // Use default name if can't load status
+        }
+        await this.statusManager.archive(archiveName);
+    }
+    /**
+     * Initialize a workflow with full options
+     */
+    async initWorkflowWithOptions(options) {
+        return this.initWorkflowWithScale(options.name, options.scale, options.settings);
+    }
+    /**
+     * Get the current workflow status
+     */
+    async getStatus() {
+        return this.statusManager.load();
+    }
+    /**
+     * Get the current phase
+     */
+    async getCurrentPhase() {
+        return this.statusManager.getCurrentPhase();
+    }
+    /**
+     * Get the current active role
+     */
+    async getCurrentRole() {
+        return this.statusManager.getActiveRole();
+    }
+    /**
+     * Get the phase definition for the current phase
+     */
+    async getCurrentPhaseDefinition() {
+        const phase = await this.getCurrentPhase();
+        return (0, phases_1.getPhaseDefinition)(phase);
+    }
+    /**
+     * Perform a handoff from one agent to another
+     * @param from - Agent name handing off (e.g., 'feature-developer')
+     * @param to - Agent name receiving (e.g., 'test-writer')
+     * @param artifacts - Array of output file paths
+     */
+    async handoff(from, to, artifacts) {
+        // Update the outgoing agent
+        await this.statusManager.updateAgent(from, {
+            status: 'completed',
+            outputs: artifacts,
+        });
+        // Update the incoming agent
+        await this.statusManager.updateAgent(to, {
+            status: 'in_progress',
+        });
+    }
+    /**
+     * Get the next agent suggestion after a handoff
+     */
+    getNextAgentSuggestion(currentAgent) {
+        const orchestrator = new agentOrchestrator_1.AgentOrchestrator();
+        // Common handoff sequences
+        const handoffSequences = {
+            'feature-developer': { agent: 'test-writer', reason: 'Write tests for the new code' },
+            'bug-fixer': { agent: 'test-writer', reason: 'Write regression tests' },
+            'test-writer': { agent: 'code-reviewer', reason: 'Review implementation and tests' },
+            'code-reviewer': { agent: 'documentation-writer', reason: 'Document the changes' },
+            'backend-specialist': { agent: 'test-writer', reason: 'Write API tests' },
+            'frontend-specialist': { agent: 'test-writer', reason: 'Write UI tests' },
+            'refactoring-specialist': { agent: 'test-writer', reason: 'Verify refactored code' },
+        };
+        return handoffSequences[currentAgent] || null;
+    }
+    /**
+     * Get orchestration guidance for a phase
+     */
+    async getPhaseOrchestration(phase) {
+        const orchestrator = new agentOrchestrator_1.AgentOrchestrator();
+        const agents = agentOrchestrator_1.PHASE_TO_AGENTS[phase] || [];
+        const sequence = orchestrator.getAgentHandoffSequence([phase]);
+        const suggestedSequence = sequence.map((agent) => ({
+            agent,
+            task: this.getAgentDefaultTask(agent),
+        }));
+        const startWith = agents.length > 0 ? agents[0] : 'feature-developer';
+        const instruction = this.buildOrchestrationInstruction(phase, startWith);
+        const skillRegistry = (0, skills_1.createSkillRegistry)(this.repoPath);
+        const skills = await skillRegistry.getSkillsForPhase(phase);
+        const recommendedSkills = skills.map((skill) => ({
+            slug: skill.slug,
+            name: skill.metadata.name,
+            description: skill.metadata.description,
+            path: skill.path,
+            isBuiltIn: skill.isBuiltIn,
+        }));
+        // Build tool guidance for explicit orchestration
+        const toolGuidance = this.buildToolGuidance(phase, startWith);
+        // Build step-by-step orchestration instructions
+        const orchestrationSteps = this.buildOrchestrationSteps(phase, sequence);
+        return {
+            recommendedAgents: agents,
+            suggestedSequence,
+            startWith,
+            instruction,
+            recommendedSkills,
+            toolGuidance,
+            orchestrationSteps,
+        };
+    }
+    /**
+     * Get default task description for an agent
+     */
+    getAgentDefaultTask(agent) {
+        const taskMap = {
+            'feature-developer': 'Implement core functionality',
+            'bug-fixer': 'Fix identified issues',
+            'test-writer': 'Write tests for new code',
+            'code-reviewer': 'Review implementation',
+            'documentation-writer': 'Document the changes',
+            'backend-specialist': 'Implement server-side logic',
+            'frontend-specialist': 'Build user interface',
+            'database-specialist': 'Design and optimize database',
+            'architect-specialist': 'Design system architecture',
+            'security-auditor': 'Audit for security vulnerabilities',
+            'performance-optimizer': 'Optimize performance',
+            'refactoring-specialist': 'Improve code structure',
+            'devops-specialist': 'Configure deployment pipeline',
+            'mobile-specialist': 'Develop mobile features',
+        };
+        return taskMap[agent] || 'Execute assigned tasks';
+    }
+    /**
+     * Build tool guidance with concrete MCP tool call examples
+     */
+    buildToolGuidance(phase, startAgent) {
+        return {
+            discoverExample: `agent({ action: "orchestrate", phase: "${phase}" })`,
+            sequenceExample: `agent({ action: "getSequence", phases: ["${phase}"] })`,
+            handoffExample: `workflow-manage({ action: "handoff", from: "${startAgent}", to: "<next-agent>", artifacts: ["output.md"] })`,
+        };
+    }
+    /**
+     * Build step-by-step orchestration instructions with tool calls
+     */
+    buildOrchestrationSteps(phase, agents) {
+        const phaseName = phases_1.PHASE_NAMES_EN[phase];
+        const startAgent = agents[0] || 'feature-developer';
+        const nextAgent = agents[1] || '<next-agent>';
+        return [
+            `1. Discover agents for ${phaseName} phase: agent({ action: "orchestrate", phase: "${phase}" })`,
+            `2. Review recommended sequence: agent({ action: "getSequence", phases: ["${phase}"] })`,
+            `3. Begin with ${startAgent} agent - follow playbook at .context/agents/${startAgent}.md`,
+            `4. Execute handoffs: workflow-manage({ action: "handoff", from: "${startAgent}", to: "${nextAgent}", artifacts: ["output.md"] })`,
+            `5. Leverage skills: skill({ action: "getForPhase", phase: "${phase}" })`,
+        ];
+    }
+    /**
+     * Build orchestration instruction for a phase
+     */
+    buildOrchestrationInstruction(phase, startAgent) {
+        const phaseName = phases_1.PHASE_NAMES_EN[phase];
+        return `ORCHESTRATION GUIDE for ${phaseName} phase:\n\n` +
+            `1. START: Activate ${startAgent} agent\n` +
+            `   - Review agent playbook: .context/agents/${startAgent}.md\n` +
+            `   - Understand responsibilities and outputs\n\n` +
+            `2. DISCOVER: Find all agents for this phase\n` +
+            `   - Call: agent({ action: "orchestrate", phase: "${phase}" })\n` +
+            `   - Review: Recommended agents and their roles\n\n` +
+            `3. SEQUENCE: Plan agent handoff order\n` +
+            `   - Call: agent({ action: "getSequence", phases: ["${phase}"] })\n` +
+            `   - Follow: Suggested sequence for optimal workflow\n\n` +
+            `4. EXECUTE: Perform work and handoffs\n` +
+            `   - Work: Complete tasks as ${startAgent}\n` +
+            `   - Handoff: workflow-manage({ action: "handoff", from: "${startAgent}", to: "<next-agent>", artifacts: [...] })\n` +
+            `   - Repeat: Continue through sequence until phase complete\n\n` +
+            `5. ADVANCE: Move to next phase\n` +
+            `   - Call: workflow-advance({ outputs: [...] })\n` +
+            `   - Review: Next phase orchestration guidance`;
+    }
+    /**
+     * Complete the current phase and advance to the next
+     */
+    async completePhase(outputs, options = {}) {
+        const status = await this.getStatus();
+        const currentPhase = status.project.current_phase;
+        const nextPhase = await this.getNextPhase();
+        // Check gates before advancing (unless force is true)
+        if (nextPhase) {
+            this.gateChecker.enforceGates(status, {
+                force: options.force,
+                nextPhase,
+            });
+        }
+        // Mark current phase as complete
+        await this.statusManager.markPhaseComplete(currentPhase, outputs);
+        // Auto-sync linked plan markdown with execution progress
+        if (status.project.plan) {
+            try {
+                await this.planLinker.syncPlanMarkdown(status.project.plan);
+            }
+            catch {
+                // Silent fail - plan sync is non-critical
+            }
+        }
+        // Get and transition to next phase
+        if (nextPhase) {
+            await this.statusManager.transitionToPhase(nextPhase);
+        }
+        return nextPhase;
+    }
+    /**
+     * Check gates for the current phase transition
+     */
+    async checkGates() {
+        const status = await this.getStatus();
+        return this.gateChecker.checkGates(status);
+    }
+    /**
+     * Set workflow settings
+     */
+    async setSettings(settings) {
+        return this.statusManager.setSettings(settings);
+    }
+    /**
+     * Get workflow settings
+     */
+    async getSettings() {
+        return this.statusManager.getSettings();
+    }
+    /**
+     * Mark that a plan has been created/linked
+     */
+    async markPlanCreated(planSlug) {
+        return this.statusManager.markPlanCreated(planSlug);
+    }
+    /**
+     * Approve the plan
+     */
+    async approvePlan(approver, notes) {
+        return this.statusManager.approvePlan(approver, notes);
+    }
+    /**
+     * Get approval status
+     */
+    async getApproval() {
+        return this.statusManager.getApproval();
+    }
+    /**
+     * Advance to the next phase
+     */
+    async advanceToNextPhase() {
+        const nextPhase = await this.getNextPhase();
+        if (nextPhase) {
+            await this.statusManager.transitionToPhase(nextPhase);
+        }
+        return nextPhase;
+    }
+    /**
+     * Get the next phase that should be executed
+     */
+    async getNextPhase() {
+        return this.statusManager.getNextPhase();
+    }
+    /**
+     * Check if the workflow is complete
+     */
+    async isComplete() {
+        return this.statusManager.isComplete();
+    }
+    /**
+     * Get recommended next actions for the current state
+     */
+    async getRecommendedActions() {
+        const status = await this.getStatus();
+        const currentPhase = status.project.current_phase;
+        const phaseDefinition = (0, phases_1.getPhaseDefinition)(currentPhase);
+        const actions = [];
+        // Suggest phase-specific actions
+        actions.push(`Complete ${phaseDefinition.name} phase tasks`);
+        // Suggest role-specific actions
+        for (const role of phaseDefinition.roles) {
+            const roleConfig = (0, prevcConfig_1.getRoleConfig)(role);
+            if (roleConfig) {
+                actions.push(...roleConfig.responsibilities.slice(0, 2));
+            }
+        }
+        // Suggest output creation
+        if (phaseDefinition.outputs.length > 0) {
+            actions.push(`Create outputs: ${phaseDefinition.outputs.join(', ')}`);
+        }
+        return actions;
+    }
+    /**
+     * Get a summary of the current workflow state
+     */
+    async getSummary() {
+        const status = await this.getStatus();
+        const isComplete = await this.isComplete();
+        // Count completed phases
+        let completedPhases = 0;
+        let totalPhases = 0;
+        for (const phase of phases_1.PREVC_PHASE_ORDER) {
+            if (status.phases[phase].status !== 'skipped') {
+                totalPhases++;
+                if (status.phases[phase].status === 'completed') {
+                    completedPhases++;
+                }
+            }
+        }
+        return {
+            name: status.project.name,
+            scale: status.project.scale,
+            currentPhase: status.project.current_phase,
+            progress: {
+                completed: completedPhases,
+                total: totalPhases,
+                percentage: Math.round((completedPhases / totalPhases) * 100),
+            },
+            isComplete,
+            startedAt: status.project.started,
+        };
+    }
+    /**
+     * Update the current task description
+     */
+    async updateCurrentTask(task) {
+        const currentPhase = await this.getCurrentPhase();
+        const activeRole = await this.getCurrentRole();
+        await this.statusManager.updatePhase(currentPhase, {
+            current_task: task,
+            role: activeRole || undefined,
+        });
+    }
+    /**
+     * Start a specific role in the current phase
+     */
+    async startRole(role) {
+        const currentPhase = await this.getCurrentPhase();
+        await this.statusManager.updateRole(role, {
+            status: 'in_progress',
+            phase: currentPhase,
+        });
+        await this.statusManager.updatePhase(currentPhase, {
+            role,
+        });
+    }
+    /**
+     * Complete a role's work in the current phase
+     */
+    async completeRole(role, outputs) {
+        await this.statusManager.updateRole(role, {
+            status: 'completed',
+            outputs,
+            last_active: new Date().toISOString(),
+        });
+    }
+}
+exports.PrevcOrchestrator = PrevcOrchestrator;
+//# sourceMappingURL=orchestrator.js.map

package/dist/workflow/orchestrator.js.map

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

package/dist/workflow/phases.d.ts

@@ -0,0 +1,64 @@
+/**
+ * PREVC Workflow Phases
+ *
+ * Defines the five phases of the PREVC workflow:
+ * P - Planning
+ * R - Review
+ * E - Execution
+ * V - Validation
+ * C - Confirmation
+ */
+import { PrevcPhase, PhaseDefinition } from './types';
+/**
+ * All PREVC phases in order
+ */
+export declare const PREVC_PHASE_ORDER: PrevcPhase[];
+/**
+ * Complete definition of all PREVC phases
+ */
+export declare const PREVC_PHASES: Record<PrevcPhase, PhaseDefinition>;
+/**
+ * Phase display names (English - default)
+ */
+export declare const PHASE_NAMES: Record<PrevcPhase, string>;
+/**
+ * Phase display names in English (alias for consistency)
+ */
+export declare const PHASE_NAMES_EN: Record<PrevcPhase, string>;
+/**
+ * Phase display names in Portuguese (for i18n)
+ */
+export declare const PHASE_NAMES_PT: Record<PrevcPhase, string>;
+/**
+ * Get the definition for a specific phase
+ */
+export declare function getPhaseDefinition(phase: PrevcPhase): PhaseDefinition;
+/**
+ * Get the next phase in the workflow
+ */
+export declare function getNextPhase(currentPhase: PrevcPhase): PrevcPhase | null;
+/**
+ * Get the previous phase in the workflow
+ */
+export declare function getPreviousPhase(currentPhase: PrevcPhase): PrevcPhase | null;
+/**
+ * Check if a phase is optional
+ */
+export declare function isPhaseOptional(phase: PrevcPhase): boolean;
+/**
+ * Get all roles for a specific phase
+ */
+export declare function getRolesForPhase(phase: PrevcPhase): string[];
+/**
+ * Get all outputs for a specific phase
+ */
+export declare function getOutputsForPhase(phase: PrevcPhase): string[];
+/**
+ * Check if a string is a valid PREVC phase
+ */
+export declare function isValidPhase(phase: string): phase is PrevcPhase;
+/**
+ * Get the phase order number (1-5)
+ */
+export declare function getPhaseOrder(phase: PrevcPhase): number;
+//# sourceMappingURL=phases.d.ts.map

package/dist/workflow/phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.d.ts","sourceRoot":"","sources":["../../src/workflow/phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAA8B,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,eAAe,CAyC5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAMlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,4BAAc,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAMrD,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CAErE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAMxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAM5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAE9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEvD"}