@dotcontext/mcp 0.9.0

package/dist/workflow/orchestration/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Orchestration Module Exports
+ *
+ * Provides agent orchestration and document linking capabilities
+ * for the PREVC workflow system.
+ */
+export { AgentOrchestrator, agentOrchestrator, AgentType, AGENT_TYPES, PHASE_TO_AGENTS, ROLE_TO_AGENTS, } from './agentOrchestrator';
+export { DocumentLinker, documentLinker, DocType, DocGuide, DOCUMENT_GUIDES, AGENT_TO_DOCS, PHASE_TO_DOCS, ROLE_TO_DOCS, } from './documentLinker';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/orchestration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/orchestration/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,cAAc,EACd,cAAc,EACd,OAAO,EACP,QAAQ,EACR,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,kBAAkB,CAAC"}

package/dist/workflow/orchestration/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Orchestration Module Exports
+ *
+ * Provides agent orchestration and document linking capabilities
+ * for the PREVC workflow system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_TO_DOCS = exports.PHASE_TO_DOCS = exports.AGENT_TO_DOCS = exports.DOCUMENT_GUIDES = exports.documentLinker = exports.DocumentLinker = exports.ROLE_TO_AGENTS = exports.PHASE_TO_AGENTS = exports.AGENT_TYPES = exports.agentOrchestrator = exports.AgentOrchestrator = void 0;
+// Agent Orchestrator
+var agentOrchestrator_1 = require("./agentOrchestrator");
+Object.defineProperty(exports, "AgentOrchestrator", { enumerable: true, get: function () { return agentOrchestrator_1.AgentOrchestrator; } });
+Object.defineProperty(exports, "agentOrchestrator", { enumerable: true, get: function () { return agentOrchestrator_1.agentOrchestrator; } });
+Object.defineProperty(exports, "AGENT_TYPES", { enumerable: true, get: function () { return agentOrchestrator_1.AGENT_TYPES; } });
+Object.defineProperty(exports, "PHASE_TO_AGENTS", { enumerable: true, get: function () { return agentOrchestrator_1.PHASE_TO_AGENTS; } });
+Object.defineProperty(exports, "ROLE_TO_AGENTS", { enumerable: true, get: function () { return agentOrchestrator_1.ROLE_TO_AGENTS; } });
+// Document Linker
+var documentLinker_1 = require("./documentLinker");
+Object.defineProperty(exports, "DocumentLinker", { enumerable: true, get: function () { return documentLinker_1.DocumentLinker; } });
+Object.defineProperty(exports, "documentLinker", { enumerable: true, get: function () { return documentLinker_1.documentLinker; } });
+Object.defineProperty(exports, "DOCUMENT_GUIDES", { enumerable: true, get: function () { return documentLinker_1.DOCUMENT_GUIDES; } });
+Object.defineProperty(exports, "AGENT_TO_DOCS", { enumerable: true, get: function () { return documentLinker_1.AGENT_TO_DOCS; } });
+Object.defineProperty(exports, "PHASE_TO_DOCS", { enumerable: true, get: function () { return documentLinker_1.PHASE_TO_DOCS; } });
+Object.defineProperty(exports, "ROLE_TO_DOCS", { enumerable: true, get: function () { return documentLinker_1.ROLE_TO_DOCS; } });
+//# sourceMappingURL=index.js.map

package/dist/workflow/orchestration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/orchestration/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qBAAqB;AACrB,yDAO6B;AAN3B,sHAAA,iBAAiB,OAAA;AACjB,sHAAA,iBAAiB,OAAA;AAEjB,gHAAA,WAAW,OAAA;AACX,oHAAA,eAAe,OAAA;AACf,mHAAA,cAAc,OAAA;AAGhB,kBAAkB;AAClB,mDAS0B;AARxB,gHAAA,cAAc,OAAA;AACd,gHAAA,cAAc,OAAA;AAGd,iHAAA,eAAe,OAAA;AACf,+GAAA,aAAa,OAAA;AACb,+GAAA,aAAa,OAAA;AACb,8GAAA,YAAY,OAAA"}

package/dist/workflow/orchestrator.d.ts

@@ -0,0 +1,188 @@
+/**
+ * PREVC Workflow Orchestrator
+ *
+ * Manages workflow progression, phase transitions, and role handoffs.
+ */
+import { PrevcStatus, PrevcPhase, PrevcRole, ProjectContext, ProjectScale, WorkflowSettings, PlanApproval, PhaseOrchestration } from './types';
+import { GateCheckResult } from './gates';
+/**
+ * Options for completing a phase
+ */
+export interface CompletePhaseOptions {
+    /** Force advancement even if gates would block */
+    force?: boolean;
+}
+/**
+ * Options for initializing a workflow with settings
+ */
+export interface InitWorkflowOptions {
+    name: string;
+    scale: ProjectScale;
+    /** Override default settings */
+    settings?: Partial<WorkflowSettings>;
+}
+/**
+ * PREVC Workflow Orchestrator
+ *
+ * Coordinates the execution of the PREVC workflow.
+ */
+export declare class PrevcOrchestrator {
+    private repoPath;
+    private contextPath;
+    private statusManager;
+    private gateChecker;
+    private planLinker;
+    constructor(contextPath: string);
+    /**
+     * Check if a workflow exists
+     */
+    hasWorkflow(): Promise<boolean>;
+    /**
+     * Initialize a new workflow
+     */
+    initWorkflow(context: ProjectContext): Promise<PrevcStatus>;
+    /**
+     * Initialize a workflow with explicit scale
+     * @param archivePrevious - If undefined and workflow exists, throws error. If true, archives. If false, deletes.
+     */
+    initWorkflowWithScale(name: string, scale: ProjectScale, settings?: Partial<WorkflowSettings>, archivePrevious?: boolean): Promise<PrevcStatus>;
+    /**
+     * Reset the current workflow
+     * @param archive - If true, archives the current workflow. If false, deletes it.
+     */
+    resetWorkflow(archive: boolean): Promise<void>;
+    /**
+     * Archive the current workflow to .context/workflow/archive/
+     */
+    private archiveCurrentWorkflow;
+    /**
+     * Initialize a workflow with full options
+     */
+    initWorkflowWithOptions(options: InitWorkflowOptions): Promise<PrevcStatus>;
+    /**
+     * Get the current workflow status
+     */
+    getStatus(): Promise<PrevcStatus>;
+    /**
+     * Get the current phase
+     */
+    getCurrentPhase(): Promise<PrevcPhase>;
+    /**
+     * Get the current active role
+     */
+    getCurrentRole(): Promise<PrevcRole | null>;
+    /**
+     * Get the phase definition for the current phase
+     */
+    getCurrentPhaseDefinition(): Promise<import("./types").PhaseDefinition>;
+    /**
+     * 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
+     */
+    handoff(from: string, to: string, artifacts: string[]): Promise<void>;
+    /**
+     * Get the next agent suggestion after a handoff
+     */
+    getNextAgentSuggestion(currentAgent: string): {
+        agent: string;
+        reason: string;
+    } | null;
+    /**
+     * Get orchestration guidance for a phase
+     */
+    getPhaseOrchestration(phase: PrevcPhase): Promise<PhaseOrchestration>;
+    /**
+     * Get default task description for an agent
+     */
+    private getAgentDefaultTask;
+    /**
+     * Build tool guidance with concrete MCP tool call examples
+     */
+    private buildToolGuidance;
+    /**
+     * Build step-by-step orchestration instructions with tool calls
+     */
+    private buildOrchestrationSteps;
+    /**
+     * Build orchestration instruction for a phase
+     */
+    private buildOrchestrationInstruction;
+    /**
+     * Complete the current phase and advance to the next
+     */
+    completePhase(outputs?: string[], options?: CompletePhaseOptions): Promise<PrevcPhase | null>;
+    /**
+     * Check gates for the current phase transition
+     */
+    checkGates(): Promise<GateCheckResult>;
+    /**
+     * Set workflow settings
+     */
+    setSettings(settings: Partial<WorkflowSettings>): Promise<WorkflowSettings>;
+    /**
+     * Get workflow settings
+     */
+    getSettings(): Promise<WorkflowSettings>;
+    /**
+     * Mark that a plan has been created/linked
+     */
+    markPlanCreated(planSlug: string): Promise<void>;
+    /**
+     * Approve the plan
+     */
+    approvePlan(approver: PrevcRole | string, notes?: string): Promise<PlanApproval>;
+    /**
+     * Get approval status
+     */
+    getApproval(): Promise<PlanApproval | undefined>;
+    /**
+     * Advance to the next phase
+     */
+    advanceToNextPhase(): Promise<PrevcPhase | null>;
+    /**
+     * Get the next phase that should be executed
+     */
+    getNextPhase(): Promise<PrevcPhase | null>;
+    /**
+     * Check if the workflow is complete
+     */
+    isComplete(): Promise<boolean>;
+    /**
+     * Get recommended next actions for the current state
+     */
+    getRecommendedActions(): Promise<string[]>;
+    /**
+     * Get a summary of the current workflow state
+     */
+    getSummary(): Promise<WorkflowSummary>;
+    /**
+     * Update the current task description
+     */
+    updateCurrentTask(task: string): Promise<void>;
+    /**
+     * Start a specific role in the current phase
+     */
+    startRole(role: PrevcRole): Promise<void>;
+    /**
+     * Complete a role's work in the current phase
+     */
+    completeRole(role: PrevcRole, outputs: string[]): Promise<void>;
+}
+/**
+ * Workflow summary for display
+ */
+export interface WorkflowSummary {
+    name: string;
+    scale: ProjectScale | keyof typeof ProjectScale;
+    currentPhase: PrevcPhase;
+    progress: {
+        completed: number;
+        total: number;
+        percentage: number;
+    };
+    isComplete: boolean;
+    startedAt: string;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

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

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