@ai-coders/context 0.6.0 → 0.7.0

package/dist/services/mcp/gateway/workflowAdvance.js.map

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

package/dist/services/mcp/gateway/workflowInit.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Workflow Init Handler
+ *
+ * Handles PREVC workflow initialization.
+ * Primary entry point for AI to start workflows.
+ */
+import type { MCPToolResponse } from './response';
+export interface WorkflowInitParams {
+    name: string;
+    description?: string;
+    scale?: 'QUICK' | 'SMALL' | 'MEDIUM' | 'LARGE';
+    autonomous?: boolean;
+    require_plan?: boolean;
+    require_approval?: boolean;
+    archive_previous?: boolean;
+    repoPath?: string;
+}
+export interface WorkflowInitOptions {
+    repoPath: string;
+}
+/**
+ * Initialize a PREVC workflow.
+ *
+ * This is the primary method for AI to start workflows.
+ * Use this after .context/ exists (use project-setup for first-time setup).
+ */
+export declare function handleWorkflowInit(params: WorkflowInitParams, options: WorkflowInitOptions): Promise<MCPToolResponse>;
+//# sourceMappingURL=workflowInit.d.ts.map

package/dist/services/mcp/gateway/workflowInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowInit.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/workflowInit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAqE1B"}

package/dist/services/mcp/gateway/workflowInit.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * Workflow Init Handler
+ *
+ * Handles PREVC workflow initialization.
+ * Primary entry point for AI to start workflows.
+ */
+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.handleWorkflowInit = handleWorkflowInit;
+const path = __importStar(require("path"));
+const workflow_1 = require("../../workflow");
+const workflow_2 = require("../../../workflow");
+const response_1 = require("./response");
+/**
+ * Initialize a PREVC workflow.
+ *
+ * This is the primary method for AI to start workflows.
+ * Use this after .context/ exists (use project-setup for first-time setup).
+ */
+async function handleWorkflowInit(params, options) {
+    try {
+        // Resolve repo path: use explicit param, then options
+        // options.repoPath is guaranteed to be valid by MCP server initialization
+        const repoPath = path.resolve(params.repoPath || options.repoPath);
+        const contextPath = path.join(repoPath, '.context');
+        // Create service
+        const service = await workflow_1.WorkflowService.create(repoPath);
+        const status = await service.init({
+            name: params.name,
+            description: params.description,
+            scale: params.scale,
+            autonomous: params.autonomous,
+            requirePlan: params.require_plan,
+            requireApproval: params.require_approval,
+            archivePrevious: params.archive_previous,
+        });
+        const statusFilePath = path.join(contextPath, 'workflow', 'status.yaml');
+        const settings = await service.getSettings();
+        const scale = (0, workflow_2.getScaleName)(status.project.scale);
+        const isAutonomous = settings.autonomous_mode;
+        const requiresPlan = settings.require_plan;
+        const orchestration = await service.getPhaseOrchestration(status.project.current_phase);
+        // Build actionable enhancement prompt based on workflow state
+        const enhancementPrompt = buildWorkflowEnhancementPrompt({
+            name: params.name,
+            scale,
+            currentPhase: status.project.current_phase,
+            isAutonomous,
+            requiresPlan,
+        });
+        // Build next steps based on workflow configuration
+        const nextSteps = buildWorkflowNextSteps({
+            currentPhase: status.project.current_phase,
+            isAutonomous,
+            requiresPlan,
+        });
+        return (0, response_1.createJsonResponse)({
+            success: true,
+            message: `Workflow initialized: ${params.name}`,
+            scale,
+            currentPhase: status.project.current_phase,
+            phases: Object.keys(status.phases).filter((p) => status.phases[p].status !== 'skipped'),
+            settings: {
+                autonomous_mode: settings.autonomous_mode,
+                require_plan: settings.require_plan,
+                require_approval: settings.require_approval,
+            },
+            statusFilePath,
+            contextPath,
+            orchestration,
+            // Action signals for AI agents
+            _actionRequired: true,
+            _status: 'workflow_active',
+            enhancementPrompt,
+            nextSteps,
+        });
+    }
+    catch (error) {
+        return (0, response_1.createErrorResponse)(error);
+    }
+}
+/**
+ * Build enhancement prompt for workflow initialization.
+ */
+function buildWorkflowEnhancementPrompt(options) {
+    const { name, scale, currentPhase, isAutonomous, requiresPlan } = options;
+    if (isAutonomous) {
+        return `✓ WORKFLOW ACTIVE - AUTONOMOUS MODE
+
+Workflow "${name}" initialized (${scale} scale).
+Current phase: ${currentPhase} (Plan)
+
+AUTONOMOUS MODE ENABLED - All gates bypassed.
+
+AGENT ORCHESTRATION:
+1. Use agent tool to discover agents: agent({ action: "orchestrate", phase: "P" })
+2. Use workflow-manage for handoffs: workflow-manage({ action: "handoff", from: "agent-1", to: "agent-2", artifacts: [...] })
+3. Collaborate when needed: workflow-manage({ action: "collaborate", topic: "architecture", participants: [...] })
+
+NEXT ACTIONS:
+1. Begin implementation work directly
+2. Use workflow-advance to move through phases as work progresses
+3. Use workflow-status to check current state at any time
+
+You may proceed without creating formal plans or waiting for approvals.`;
+    }
+    if (requiresPlan) {
+        return `WORKFLOW ACTIVE - PLAN REQUIRED
+
+Workflow "${name}" initialized (${scale} scale).
+Current phase: ${currentPhase} (Plan)
+
+GATE: Plan required before advancing to Review phase.
+
+AGENT ORCHESTRATION:
+The Plan phase involves multiple agents working together:
+1. Discover planning agents: agent({ action: "orchestrate", phase: "P" })
+2. Get recommended sequence: agent({ action: "getSequence", phases: ["P"] })
+3. Start with first agent and execute handoffs between agents
+4. Example handoff: workflow-manage({ action: "handoff", from: "architect-specialist", to: "documentation-writer", artifacts: ["design.md"] })
+
+REQUIRED ACTIONS:
+1. Create a plan using context with action "scaffoldPlan" and planName parameter
+2. Fill the plan content using context with action "fillSingle"
+3. Link the plan using plan with action "link" and planSlug parameter
+4. Advance to Review phase using workflow-advance
+
+Do NOT attempt to advance without linking a plan - the gate will block you.`;
+    }
+    return `✓ WORKFLOW ACTIVE
+
+Workflow "${name}" initialized (${scale} scale).
+Current phase: ${currentPhase} (Plan)
+
+AGENT ORCHESTRATION AVAILABLE:
+This workflow supports multi-agent orchestration. Use these tools:
+- agent({ action: "orchestrate", phase: "P" }) - Discover agents for current phase
+- agent({ action: "getSequence", task: "your task description" }) - Get recommended agent sequence
+- workflow-manage({ action: "handoff", from: "agent-1", to: "agent-2", artifacts: [...] }) - Execute handoffs
+- workflow-manage({ action: "collaborate", topic: "topic", participants: [...] }) - Start collaboration
+
+RECOMMENDED ACTIONS:
+1. Create a plan using context with action "scaffoldPlan" (recommended for ${scale} scale)
+2. Or advance directly using workflow-advance if planning is not needed
+
+Use workflow-status to check current state at any time.`;
+}
+/**
+ * Build next steps array for workflow initialization.
+ */
+function buildWorkflowNextSteps(options) {
+    const { isAutonomous, requiresPlan } = options;
+    if (isAutonomous) {
+        return [
+            'ENABLED: Begin implementation work directly (autonomous mode)',
+            'ACTION: Call agent({ action: "orchestrate", phase: "P" }) to discover agents',
+            'ACTION: Use workflow-manage({ action: "handoff", ... }) to execute agent transitions',
+            'OPTIONAL: Call workflow-advance to track phase progression',
+            'OPTIONAL: Call workflow-status to check current state',
+        ];
+    }
+    if (requiresPlan) {
+        return [
+            'REQUIRED: Call context with action "scaffoldPlan" to create a plan',
+            'RECOMMENDED: Call agent({ action: "orchestrate", phase: "P" }) to discover planning agents',
+            'RECOMMENDED: Use workflow-manage({ action: "handoff", ... }) for agent collaboration',
+            'REQUIRED: Call plan with action "link" to link plan to workflow',
+            'THEN: Call workflow-advance to move to Review phase',
+        ];
+    }
+    return [
+        'RECOMMENDED: Call agent({ action: "orchestrate", phase: "P" }) to discover agents',
+        'RECOMMENDED: Call context with action "scaffoldPlan" to create a plan',
+        'ALTERNATIVE: Call agent({ action: "getSequence", task: "your task" }) for task-based sequence',
+        'OPTIONAL: Use workflow-manage({ action: "handoff", ... }) for multi-agent work',
+        'ALTERNATIVE: Call workflow-advance to skip planning phase',
+        'OPTIONAL: Call workflow-status to check current state',
+    ];
+}
+//# sourceMappingURL=workflowInit.js.map

package/dist/services/mcp/gateway/workflowInit.js.map

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

package/dist/services/mcp/gateway/workflowManage.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Workflow Manage Handler
+ *
+ * Handles workflow management operations: handoffs, collaboration, documents, gates, approvals.
+ */
+import type { PrevcRole } from '../../../workflow';
+import type { MCPToolResponse } from './response';
+export interface WorkflowManageParams {
+    action: 'handoff' | 'collaborate' | 'createDoc' | 'getGates' | 'approvePlan' | 'setAutonomous';
+    from?: string;
+    to?: string;
+    artifacts?: string[];
+    topic?: string;
+    participants?: PrevcRole[];
+    type?: 'prd' | 'tech-spec' | 'architecture' | 'adr' | 'test-plan' | 'changelog';
+    docName?: string;
+    planSlug?: string;
+    approver?: PrevcRole;
+    notes?: string;
+    enabled?: boolean;
+    reason?: string;
+    repoPath?: string;
+}
+export interface WorkflowManageOptions {
+    repoPath: string;
+}
+/**
+ * Manage workflow operations: handoffs, collaboration, documents, gates, approvals.
+ */
+export declare function handleWorkflowManage(params: WorkflowManageParams, options: WorkflowManageOptions): Promise<MCPToolResponse>;
+//# sourceMappingURL=workflowManage.d.ts.map

package/dist/services/mcp/gateway/workflowManage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowManage.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/workflowManage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;IAC/F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,cAAc,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAyM1B"}

package/dist/services/mcp/gateway/workflowManage.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * Workflow Manage Handler
+ *
+ * Handles workflow management operations: handoffs, collaboration, documents, gates, approvals.
+ */
+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.handleWorkflowManage = handleWorkflowManage;
+const path = __importStar(require("path"));
+const workflow_1 = require("../../workflow");
+const workflow_2 = require("../../../workflow");
+const response_1 = require("./response");
+/**
+ * Manage workflow operations: handoffs, collaboration, documents, gates, approvals.
+ */
+async function handleWorkflowManage(params, options) {
+    try {
+        // Resolve repo path: use explicit param, then options
+        // options.repoPath is guaranteed to be valid by MCP server initialization
+        const repoPath = path.resolve(params.repoPath || options.repoPath);
+        // Create service
+        const service = await workflow_1.WorkflowService.create(repoPath);
+        switch (params.action) {
+            case 'handoff': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Initialize a workflow first.',
+                        suggestion: 'Use workflow-init({ name: "feature-name" }) to start.',
+                    });
+                }
+                // Validate required parameters for agent handoff
+                if (!params.from || !params.to) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'handoff requires from and to agent names',
+                    });
+                }
+                await service.handoff(params.from, params.to, params.artifacts || []);
+                // Get next agent suggestion
+                const nextSuggestion = service.getNextAgentSuggestion(params.to);
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: `Handoff complete: ${params.from} → ${params.to}`,
+                    handoff: {
+                        from: params.from,
+                        to: params.to,
+                        artifacts: params.artifacts || [],
+                    },
+                    nextSuggestion,
+                });
+            }
+            case 'collaborate': {
+                const session = await service.startCollaboration(params.topic, params.participants);
+                const sessionStatus = session.getStatus();
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: `Collaboration session started: ${params.topic}`,
+                    sessionId: sessionStatus.id,
+                    topic: sessionStatus.topic,
+                    participants: sessionStatus.participants.map((p) => ({
+                        role: p,
+                        displayName: workflow_2.ROLE_DISPLAY_NAMES[p],
+                    })),
+                });
+            }
+            case 'createDoc': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Initialize a workflow first.',
+                        suggestion: 'Use workflow-init({ name: "feature-name" }) to start.',
+                    });
+                }
+                const docPath = `.context/workflow/docs/${params.type}-${params.docName?.toLowerCase().replace(/\s+/g, '-')}.md`;
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: `Document template ready: ${params.type}`,
+                    documentType: params.type,
+                    suggestedPath: docPath,
+                    name: params.docName,
+                });
+            }
+            case 'getGates': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Initialize a workflow first.',
+                        suggestion: 'Use workflow-init({ name: "feature-name" }) to start.',
+                    });
+                }
+                const gateResult = await service.checkGates();
+                const settings = await service.getSettings();
+                const approval = await service.getApproval();
+                const summary = await service.getSummary();
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    currentPhase: {
+                        code: summary.currentPhase,
+                        name: workflow_2.PHASE_NAMES_EN[summary.currentPhase],
+                    },
+                    canAdvance: gateResult.canAdvance,
+                    gates: gateResult.gates,
+                    blockingReason: gateResult.blockingReason,
+                    hint: gateResult.hint,
+                    settings: {
+                        autonomous_mode: settings.autonomous_mode,
+                        require_plan: settings.require_plan,
+                        require_approval: settings.require_approval,
+                    },
+                    approval: approval ? {
+                        plan_created: approval.plan_created,
+                        plan_approved: approval.plan_approved,
+                        approved_by: approval.approved_by,
+                        approved_at: approval.approved_at,
+                    } : null,
+                });
+            }
+            case 'approvePlan': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Initialize a workflow first.',
+                        suggestion: 'Use workflow-init({ name: "feature-name" }) to start.',
+                    });
+                }
+                const currentApproval = await service.getApproval();
+                if (!currentApproval?.plan_created) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No plan is linked to approve. Link a plan first using plan({ action: "link" }).',
+                        hint: 'Use context({ action: "scaffoldPlan" }) to create a plan, then plan({ action: "link" }) to link it.'
+                    });
+                }
+                const approval = await service.approvePlan(params.approver || 'reviewer', params.notes);
+                if (params.planSlug) {
+                    const planLinker = (0, workflow_2.createPlanLinker)(repoPath);
+                    const plans = await planLinker.getLinkedPlans();
+                    const planRef = plans.active.find(p => p.slug === params.planSlug);
+                    if (planRef) {
+                        planRef.approval_status = 'approved';
+                        planRef.approved_at = approval.approved_at;
+                        planRef.approved_by = approval.approved_by;
+                    }
+                }
+                const gateResult = await service.checkGates();
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: 'Plan approved successfully',
+                    approval: {
+                        plan_approved: approval.plan_approved,
+                        approved_by: approval.approved_by,
+                        approved_at: approval.approved_at,
+                        approval_notes: approval.approval_notes,
+                    },
+                    canAdvanceToExecution: gateResult.gates.approval_required.passed,
+                });
+            }
+            case 'setAutonomous': {
+                if (!(await service.hasWorkflow())) {
+                    return (0, response_1.createJsonResponse)({
+                        success: false,
+                        error: 'No workflow found. Initialize a workflow first.',
+                        suggestion: 'Use workflow-init({ name: "feature-name" }) to start.',
+                    });
+                }
+                const settings = await service.setAutonomousMode(params.enabled);
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    message: `Autonomous mode ${params.enabled ? 'enabled' : 'disabled'}${params.reason ? `: ${params.reason}` : ''}`,
+                    settings: {
+                        autonomous_mode: settings.autonomous_mode,
+                        require_plan: settings.require_plan,
+                        require_approval: settings.require_approval,
+                    },
+                    effect: params.enabled
+                        ? 'All workflow gates are now bypassed. Use workflow-advance() freely.'
+                        : 'Workflow gates are now enforced based on settings.',
+                });
+            }
+            default:
+                return (0, response_1.createErrorResponse)(`Unknown workflow manage action: ${params.action}`);
+        }
+    }
+    catch (error) {
+        return (0, response_1.createErrorResponse)(error);
+    }
+}
+//# sourceMappingURL=workflowManage.js.map

package/dist/services/mcp/gateway/workflowManage.js.map

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

package/dist/services/mcp/gateway/workflowStatus.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Workflow Status Handler
+ *
+ * Handles PREVC workflow status queries.
+ */
+import type { MCPToolResponse } from './response';
+export interface WorkflowStatusParams {
+    repoPath?: string;
+}
+export interface WorkflowStatusOptions {
+    repoPath: string;
+}
+/**
+ * Get current PREVC workflow status including phase, gates, and linked plans.
+ */
+export declare function handleWorkflowStatus(params: WorkflowStatusParams, options: WorkflowStatusOptions): Promise<MCPToolResponse>;
+//# sourceMappingURL=workflowStatus.d.ts.map

package/dist/services/mcp/gateway/workflowStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowStatus.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/workflowStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA4C1B"}

package/dist/services/mcp/gateway/workflowStatus.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Workflow Status Handler
+ *
+ * Handles PREVC workflow status queries.
+ */
+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.handleWorkflowStatus = handleWorkflowStatus;
+const path = __importStar(require("path"));
+const workflow_1 = require("../../workflow");
+const workflow_2 = require("../../../workflow");
+const response_1 = require("./response");
+/**
+ * Get current PREVC workflow status including phase, gates, and linked plans.
+ */
+async function handleWorkflowStatus(params, options) {
+    try {
+        // Resolve repo path: use explicit param, then options
+        // options.repoPath is guaranteed to be valid by MCP server initialization
+        const repoPath = path.resolve(params.repoPath || options.repoPath);
+        const contextPath = path.join(repoPath, '.context');
+        // Create service
+        const service = await workflow_1.WorkflowService.create(repoPath);
+        if (!(await service.hasWorkflow())) {
+            return (0, response_1.createJsonResponse)({
+                success: false,
+                error: 'No workflow found. Initialize a workflow first.',
+                suggestion: 'Use workflow-init({ name: "feature-name" }) to start.',
+                note: 'Workflows enable structured PREVC phases. Skip for trivial changes.',
+                statusFilePath: path.join(contextPath, 'workflow', 'status.yaml')
+            });
+        }
+        const summary = await service.getSummary();
+        const status = await service.getStatus();
+        const statusFilePath = path.join(contextPath, 'workflow', 'status.yaml');
+        const orchestration = await service.getPhaseOrchestration(summary.currentPhase);
+        return (0, response_1.createJsonResponse)({
+            success: true,
+            name: summary.name,
+            scale: (0, workflow_2.getScaleName)(summary.scale),
+            currentPhase: {
+                code: summary.currentPhase,
+                name: workflow_2.PHASE_NAMES_EN[summary.currentPhase],
+            },
+            progress: summary.progress,
+            isComplete: summary.isComplete,
+            phases: status.phases,
+            agents: status.agents,
+            roles: status.roles,
+            orchestration,
+            statusFilePath,
+        });
+    }
+    catch (error) {
+        return (0, response_1.createErrorResponse)(error);
+    }
+}
+//# sourceMappingURL=workflowStatus.js.map

package/dist/services/mcp/gateway/workflowStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowStatus.js","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/workflowStatus.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBH,oDA+CC;AArED,2CAA6B;AAC7B,6CAAiD;AACjD,gDAI2B;AAG3B,yCAAqE;AAUrE;;GAEG;AACI,KAAK,UAAU,oBAAoB,CACxC,MAA4B,EAC5B,OAA8B;IAE9B,IAAI,CAAC;QACH,sDAAsD;QACtD,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAEpD,iBAAiB;QACjB,MAAM,OAAO,GAAG,MAAM,0BAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEvD,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACnC,OAAO,IAAA,6BAAkB,EAAC;gBACxB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,iDAAiD;gBACxD,UAAU,EAAE,uDAAuD;gBACnE,IAAI,EAAE,qEAAqE;gBAC3E,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,CAAC;aAClE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QACzE,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAEhF,OAAO,IAAA,6BAAkB,EAAC;YACxB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,IAAA,uBAAY,EAAC,OAAO,CAAC,KAAqB,CAAC;YAClD,YAAY,EAAE;gBACZ,IAAI,EAAE,OAAO,CAAC,YAAY;gBAC1B,IAAI,EAAE,yBAAc,CAAC,OAAO,CAAC,YAAY,CAAC;aAC3C;YACD,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,aAAa;YACb,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAA,8BAAmB,EAAC,KAAK,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}