@ai-coders/context 0.5.2 → 0.6.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,99 @@
+/**
+ * PREVC Workflow Orchestrator
+ *
+ * Manages workflow progression, phase transitions, and role handoffs.
+ */
+import { PrevcStatus, PrevcPhase, PrevcRole, ProjectContext, ProjectScale } from './types';
+/**
+ * PREVC Workflow Orchestrator
+ *
+ * Coordinates the execution of the PREVC workflow.
+ */
+export declare class PrevcOrchestrator {
+    private statusManager;
+    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
+     */
+    initWorkflowWithScale(name: string, scale: ProjectScale): 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 role to another
+     */
+    handoff(from: PrevcRole, to: PrevcRole, artifacts: string[]): Promise<void>;
+    /**
+     * Complete the current phase and advance to the next
+     */
+    completePhase(outputs?: string[]): Promise<PrevcPhase | null>;
+    /**
+     * 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":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACb,MAAM,SAAS,CAAC;AAMjB;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAqB;gBAE9B,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAYjE;;OAEG;IACG,qBAAqB,CACzB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,WAAW,CAAC;IAWvB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;IAIvC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC;IAI5C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIjD;;OAEG;IACG,yBAAyB;IAK/B;;OAEG;IACG,OAAO,CACX,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,SAAS,EACb,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC;IAahB;;OAEG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAenE;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQtD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIhD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpC;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA6BhD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IA+B5C;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAOtE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,GAAG,MAAM,OAAO,YAAY,CAAC;IAChD,YAAY,EAAE,UAAU,CAAC;IACzB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/workflow/orchestrator.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * PREVC Workflow Orchestrator
+ *
+ * Manages workflow progression, phase transitions, and role handoffs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrevcOrchestrator = void 0;
+const statusManager_1 = require("./status/statusManager");
+const scaling_1 = require("./scaling");
+const phases_1 = require("./phases");
+const prevcConfig_1 = require("./prevcConfig");
+/**
+ * PREVC Workflow Orchestrator
+ *
+ * Coordinates the execution of the PREVC workflow.
+ */
+class PrevcOrchestrator {
+    constructor(contextPath) {
+        this.statusManager = new statusManager_1.PrevcStatusManager(contextPath);
+    }
+    /**
+     * 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);
+        return this.statusManager.create({
+            name: context.name,
+            scale,
+            phases: route.phases,
+            roles: route.roles,
+        });
+    }
+    /**
+     * Initialize a workflow with explicit scale
+     */
+    async initWorkflowWithScale(name, scale) {
+        const route = (0, scaling_1.getScaleRoute)(scale);
+        return this.statusManager.create({
+            name,
+            scale,
+            phases: route.phases,
+            roles: route.roles,
+        });
+    }
+    /**
+     * 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 role to another
+     */
+    async handoff(from, to, artifacts) {
+        // Update the outgoing role
+        await this.statusManager.updateRole(from, {
+            status: 'completed',
+            outputs: artifacts,
+        });
+        // Update the incoming role
+        await this.statusManager.updateRole(to, {
+            status: 'in_progress',
+        });
+    }
+    /**
+     * Complete the current phase and advance to the next
+     */
+    async completePhase(outputs) {
+        const currentPhase = await this.getCurrentPhase();
+        // Mark current phase as complete
+        await this.statusManager.markPhaseComplete(currentPhase, outputs);
+        // Get and transition to next phase
+        const nextPhase = await this.getNextPhase();
+        if (nextPhase) {
+            await this.statusManager.transitionToPhase(nextPhase);
+        }
+        return nextPhase;
+    }
+    /**
+     * 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":";AAAA;;;;GAIG;;;AASH,0DAA4D;AAC5D,uCAA8D;AAC9D,qCAAiE;AACjE,+CAA8C;AAE9C;;;;GAIG;AACH,MAAa,iBAAiB;IAG5B,YAAY,WAAmB;QAC7B,IAAI,CAAC,aAAa,GAAG,IAAI,kCAAkB,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAAuB;QACxC,MAAM,KAAK,GAAG,IAAA,4BAAkB,EAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAA,uBAAa,EAAC,KAAK,CAAC,CAAC;QAEnC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;YAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CACzB,IAAY,EACZ,KAAmB;QAEnB,MAAM,KAAK,GAAG,IAAA,uBAAa,EAAC,KAAK,CAAC,CAAC;QAEnC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;YAC/B,IAAI;YACJ,KAAK;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,yBAAyB;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC3C,OAAO,IAAA,2BAAkB,EAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,IAAe,EACf,EAAa,EACb,SAAmB;QAEnB,2BAA2B;QAC3B,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,EAAE;YACxC,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;QAEH,2BAA2B;QAC3B,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,EAAE;YACtC,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAAkB;QACpC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAElD,iCAAiC;QACjC,MAAM,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAElE,mCAAmC;QACnC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5C,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB;QACtB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5C,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;QAClD,MAAM,eAAe,GAAG,IAAA,2BAAkB,EAAC,YAAY,CAAC,CAAC;QACzD,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,iCAAiC;QACjC,OAAO,CAAC,IAAI,CACV,YAAY,eAAe,CAAC,IAAI,cAAc,CAC/C,CAAC;QAEF,gCAAgC;QAChC,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,KAAK,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,IAAA,2BAAa,EAAC,IAAI,CAAC,CAAC;YACvC,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,eAAe,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CACV,mBAAmB,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxD,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAE3C,yBAAyB;QACzB,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,MAAM,KAAK,IAAI,0BAAiB,EAAE,CAAC;YACtC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9C,WAAW,EAAE,CAAC;gBACd,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAChD,eAAe,EAAE,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;YACzB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;YAC3B,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa;YAC1C,QAAQ,EAAE;gBACR,SAAS,EAAE,eAAe;gBAC1B,KAAK,EAAE,WAAW;gBAClB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC;aAC9D;YACD,UAAU;YACV,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;SAClC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,IAAY;QAClC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAClD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAE/C,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,YAAY,EAAE;YACjD,YAAY,EAAE,IAAI;YAClB,IAAI,EAAE,UAAU,IAAI,SAAS;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,IAAe;QAC7B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAElD,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,EAAE;YACxC,MAAM,EAAE,aAAa;YACrB,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,YAAY,EAAE;YACjD,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,IAAe,EAAE,OAAiB;QACnD,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,EAAE;YACxC,MAAM,EAAE,WAAW;YACnB,OAAO;YACP,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;CACF;AAnPD,8CAmPC"}

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"}

package/dist/workflow/phases.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * PREVC Workflow Phases
+ *
+ * Defines the five phases of the PREVC workflow:
+ * P - Planning
+ * R - Review
+ * E - Execution
+ * V - Validation
+ * C - Confirmation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PHASE_NAMES_PT = exports.PHASE_NAMES_EN = exports.PHASE_NAMES = exports.PREVC_PHASES = exports.PREVC_PHASE_ORDER = void 0;
+exports.getPhaseDefinition = getPhaseDefinition;
+exports.getNextPhase = getNextPhase;
+exports.getPreviousPhase = getPreviousPhase;
+exports.isPhaseOptional = isPhaseOptional;
+exports.getRolesForPhase = getRolesForPhase;
+exports.getOutputsForPhase = getOutputsForPhase;
+exports.isValidPhase = isValidPhase;
+exports.getPhaseOrder = getPhaseOrder;
+/**
+ * All PREVC phases in order
+ */
+exports.PREVC_PHASE_ORDER = ['P', 'R', 'E', 'V', 'C'];
+/**
+ * Complete definition of all PREVC phases
+ */
+exports.PREVC_PHASES = {
+    P: {
+        name: 'Planning',
+        description: 'Discovery, requirements and specifications',
+        roles: ['planner', 'designer'],
+        outputs: ['prd', 'tech-spec', 'requirements', 'wireframes'],
+        optional: false,
+        order: 1,
+    },
+    R: {
+        name: 'Review',
+        description: 'Architecture, technical decisions and design review',
+        roles: ['architect', 'designer'],
+        outputs: ['architecture', 'adr', 'design-spec'],
+        optional: true, // Depends on scale
+        order: 2,
+    },
+    E: {
+        name: 'Execution',
+        description: 'Implementation and development',
+        roles: ['developer'],
+        outputs: ['code', 'unit-tests'],
+        optional: false,
+        order: 3,
+    },
+    V: {
+        name: 'Validation',
+        description: 'Tests, QA and code review',
+        roles: ['qa', 'reviewer'],
+        outputs: ['test-report', 'review-comments', 'approval'],
+        optional: false,
+        order: 4,
+    },
+    C: {
+        name: 'Confirmation',
+        description: 'Documentation, deploy and handoff',
+        roles: ['documenter'],
+        outputs: ['documentation', 'changelog', 'deploy'],
+        optional: true, // Depends on scale
+        order: 5,
+    },
+};
+/**
+ * Phase display names (English - default)
+ */
+exports.PHASE_NAMES = {
+    P: 'Planning',
+    R: 'Review',
+    E: 'Execution',
+    V: 'Validation',
+    C: 'Confirmation',
+};
+/**
+ * Phase display names in English (alias for consistency)
+ */
+exports.PHASE_NAMES_EN = exports.PHASE_NAMES;
+/**
+ * Phase display names in Portuguese (for i18n)
+ */
+exports.PHASE_NAMES_PT = {
+    P: 'Planejamento',
+    R: 'Revisão',
+    E: 'Execução',
+    V: 'Validação',
+    C: 'Confirmação',
+};
+/**
+ * Get the definition for a specific phase
+ */
+function getPhaseDefinition(phase) {
+    return exports.PREVC_PHASES[phase];
+}
+/**
+ * Get the next phase in the workflow
+ */
+function getNextPhase(currentPhase) {
+    const currentIndex = exports.PREVC_PHASE_ORDER.indexOf(currentPhase);
+    if (currentIndex === -1 || currentIndex >= exports.PREVC_PHASE_ORDER.length - 1) {
+        return null;
+    }
+    return exports.PREVC_PHASE_ORDER[currentIndex + 1];
+}
+/**
+ * Get the previous phase in the workflow
+ */
+function getPreviousPhase(currentPhase) {
+    const currentIndex = exports.PREVC_PHASE_ORDER.indexOf(currentPhase);
+    if (currentIndex <= 0) {
+        return null;
+    }
+    return exports.PREVC_PHASE_ORDER[currentIndex - 1];
+}
+/**
+ * Check if a phase is optional
+ */
+function isPhaseOptional(phase) {
+    return exports.PREVC_PHASES[phase]?.optional ?? false;
+}
+/**
+ * Get all roles for a specific phase
+ */
+function getRolesForPhase(phase) {
+    return exports.PREVC_PHASES[phase]?.roles || [];
+}
+/**
+ * Get all outputs for a specific phase
+ */
+function getOutputsForPhase(phase) {
+    return exports.PREVC_PHASES[phase]?.outputs || [];
+}
+/**
+ * Check if a string is a valid PREVC phase
+ */
+function isValidPhase(phase) {
+    return exports.PREVC_PHASE_ORDER.includes(phase);
+}
+/**
+ * Get the phase order number (1-5)
+ */
+function getPhaseOrder(phase) {
+    return exports.PREVC_PHASES[phase]?.order ?? 0;
+}
+//# sourceMappingURL=phases.js.map

package/dist/workflow/phases.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Plan-Workflow Integration Module
+ *
+ * Exports for linking implementation plans to the PREVC workflow system.
+ */
+export * from './types';
+export { PlanLinker, createPlanLinker } from './planLinker';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/plans/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/workflow/plans/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Plan-Workflow Integration Module
+ *
+ * Exports for linking implementation plans to the PREVC workflow system.
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlanLinker = exports.PlanLinker = void 0;
+__exportStar(require("./types"), exports);
+var planLinker_1 = require("./planLinker");
+Object.defineProperty(exports, "PlanLinker", { enumerable: true, get: function () { return planLinker_1.PlanLinker; } });
+Object.defineProperty(exports, "createPlanLinker", { enumerable: true, get: function () { return planLinker_1.createPlanLinker; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/plans/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,2CAA4D;AAAnD,wGAAA,UAAU,OAAA;AAAE,8GAAA,gBAAgB,OAAA"}