@ai-coders/context 0.6.1 → 0.7.0

package/dist/workflow/gates/gateChecker.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * PREVC Workflow Gate Checker
+ *
+ * Enforces plan creation and approval gates during phase transitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowGateChecker = void 0;
+exports.getDefaultSettings = getDefaultSettings;
+exports.createGateChecker = createGateChecker;
+const types_1 = require("../types");
+const errors_1 = require("../errors");
+/**
+ * Get default workflow settings based on project scale
+ */
+function getDefaultSettings(scale) {
+    const scaleNum = typeof scale === 'number' ? scale : types_1.ProjectScale[scale];
+    switch (scaleNum) {
+        case types_1.ProjectScale.QUICK:
+            return {
+                autonomous_mode: true,
+                require_plan: false,
+                require_approval: false,
+            };
+        case types_1.ProjectScale.SMALL:
+            return {
+                autonomous_mode: false,
+                require_plan: true,
+                require_approval: false,
+            };
+        case types_1.ProjectScale.MEDIUM:
+        case types_1.ProjectScale.LARGE:
+        default:
+            return {
+                autonomous_mode: false,
+                require_plan: true,
+                require_approval: true,
+            };
+    }
+}
+/**
+ * PREVC Workflow Gate Checker
+ *
+ * Validates workflow gates before phase transitions.
+ */
+class WorkflowGateChecker {
+    /**
+     * Check all gates for the current phase transition
+     */
+    checkGates(status, nextPhase) {
+        const currentPhase = status.project.current_phase;
+        const targetPhase = nextPhase || this.getNextPhase(currentPhase);
+        // Get effective settings (use defaults if not set)
+        const settings = this.getEffectiveSettings(status);
+        // If autonomous mode is enabled, all gates pass
+        if (settings.autonomous_mode) {
+            return {
+                canAdvance: true,
+                gates: {
+                    plan_required: { passed: true, required: false },
+                    approval_required: { passed: true, required: false },
+                },
+            };
+        }
+        const result = {
+            canAdvance: true,
+            gates: {
+                plan_required: { passed: true, required: false },
+                approval_required: { passed: true, required: false },
+            },
+        };
+        // Check P → R transition: requires linked plan
+        if (currentPhase === 'P' && targetPhase === 'R') {
+            if (settings.require_plan) {
+                result.gates.plan_required.required = true;
+                const hasPlan = this.hasLinkedPlan(status);
+                result.gates.plan_required.passed = hasPlan;
+                if (!hasPlan) {
+                    result.canAdvance = false;
+                    result.blockingGate = 'plan_required';
+                    result.blockingReason = 'A plan must be linked before advancing from Planning to Review phase.';
+                    result.hint = 'Use scaffoldPlan and linkPlan to create and link a plan, or enable autonomous mode.';
+                }
+            }
+        }
+        // Check R → E transition: requires plan approval
+        if (currentPhase === 'R' && targetPhase === 'E') {
+            if (settings.require_approval) {
+                result.gates.approval_required.required = true;
+                const isApproved = this.isPlanApproved(status);
+                result.gates.approval_required.passed = isApproved;
+                if (!isApproved) {
+                    result.canAdvance = false;
+                    result.blockingGate = 'approval_required';
+                    result.blockingReason = 'The plan must be approved before advancing from Review to Execution phase.';
+                    result.hint = 'Use workflowApprovePlan to approve the plan, or enable autonomous mode.';
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Enforce gates for the current phase transition.
+     *
+     * Validates that all required gates pass before allowing phase advancement.
+     * If a gate check fails and `force` is not set, throws a `WorkflowGateError`.
+     *
+     * @param status - Current workflow status
+     * @param options - Enforcement options
+     * @param options.force - If true, skips gate enforcement entirely
+     * @param options.nextPhase - Override the target phase (defaults to next in sequence)
+     *
+     * @throws {WorkflowGateError} When a gate blocks the transition and force is false.
+     *   The error includes:
+     *   - `gate`: Which gate blocked ('plan_required' | 'approval_required')
+     *   - `transition`: The blocked phase transition { from, to }
+     *   - `hint`: Actionable suggestion for resolving the block
+     *
+     * @example
+     * ```ts
+     * // Normal enforcement - may throw
+     * gateChecker.enforceGates(status);
+     *
+     * // Force bypass - never throws
+     * gateChecker.enforceGates(status, { force: true });
+     * ```
+     */
+    enforceGates(status, options = {}) {
+        if (options.force) {
+            return;
+        }
+        const result = this.checkGates(status, options.nextPhase);
+        if (!result.canAdvance && result.blockingGate) {
+            const currentPhase = status.project.current_phase;
+            const targetPhase = options.nextPhase || this.getNextPhase(currentPhase);
+            throw new errors_1.WorkflowGateError({
+                message: result.blockingReason,
+                transition: { from: currentPhase, to: targetPhase },
+                gate: result.blockingGate,
+                hint: result.hint,
+            });
+        }
+    }
+    /**
+     * Get effective settings (merge with scale defaults)
+     */
+    getEffectiveSettings(status) {
+        const defaults = getDefaultSettings(status.project.scale);
+        const overrides = status.project.settings;
+        if (!overrides) {
+            return defaults;
+        }
+        return {
+            autonomous_mode: overrides.autonomous_mode ?? defaults.autonomous_mode,
+            require_plan: overrides.require_plan ?? defaults.require_plan,
+            require_approval: overrides.require_approval ?? defaults.require_approval,
+        };
+    }
+    /**
+     * Check if a plan is linked to the workflow
+     */
+    hasLinkedPlan(status) {
+        // Check approval tracking
+        if (status.approval?.plan_created) {
+            return true;
+        }
+        // Check project metadata
+        if (status.project.plan) {
+            return true;
+        }
+        // Check linked plans array
+        if (status.project.plans && status.project.plans.length > 0) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Check if the plan is approved
+     */
+    isPlanApproved(status) {
+        return status.approval?.plan_approved === true;
+    }
+    /**
+     * Get the next phase in the workflow sequence
+     */
+    getNextPhase(current) {
+        const order = ['P', 'R', 'E', 'V', 'C'];
+        const idx = order.indexOf(current);
+        return idx >= 0 && idx < order.length - 1 ? order[idx + 1] : null;
+    }
+}
+exports.WorkflowGateChecker = WorkflowGateChecker;
+// Export singleton factory
+function createGateChecker() {
+    return new WorkflowGateChecker();
+}
+//# sourceMappingURL=gateChecker.js.map

package/dist/workflow/gates/gateChecker.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * PREVC Workflow Gates
+ *
+ * Gate checking for workflow phase transitions.
+ */
+export { WorkflowGateChecker, createGateChecker, getDefaultSettings, GateCheckResult, GateStatus, } from './gateChecker';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/gates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,UAAU,GACX,MAAM,eAAe,CAAC"}

package/dist/workflow/gates/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * PREVC Workflow Gates
+ *
+ * Gate checking for workflow phase transitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultSettings = exports.createGateChecker = exports.WorkflowGateChecker = void 0;
+var gateChecker_1 = require("./gateChecker");
+Object.defineProperty(exports, "WorkflowGateChecker", { enumerable: true, get: function () { return gateChecker_1.WorkflowGateChecker; } });
+Object.defineProperty(exports, "createGateChecker", { enumerable: true, get: function () { return gateChecker_1.createGateChecker; } });
+Object.defineProperty(exports, "getDefaultSettings", { enumerable: true, get: function () { return gateChecker_1.getDefaultSettings; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/gates/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6CAMuB;AALrB,kHAAA,mBAAmB,OAAA;AACnB,gHAAA,iBAAiB,OAAA;AACjB,iHAAA,kBAAkB,OAAA"}

package/dist/workflow/index.d.ts

@@ -9,14 +9,16 @@
  * C - Confirmação (Confirmation)
  */
 export * from './types';
+export { WorkflowError, WorkflowGateError, NoPlanToApproveError, NoWorkflowError, } from './errors';
+export { WorkflowGateChecker, createGateChecker, getDefaultSettings, GateCheckResult, GateStatus, } from './gates';
 export { PREVC_ROLES, ROLE_TO_SPECIALISTS, SPECIALIST_TO_ROLE, ROLE_DISPLAY_NAMES, ROLE_DISPLAY_NAMES_EN, isValidRole, getRoleForSpecialist, getSpecialistsForRole, } from './roles';
 export { PREVC_PHASE_ORDER, PREVC_PHASES, PHASE_NAMES_EN, PHASE_NAMES_PT, getPhaseDefinition, getNextPhase, getPreviousPhase, isPhaseOptional, getRolesForPhase, getOutputsForPhase, isValidPhase, getPhaseOrder, } from './phases';
 export { ROLE_CONFIG, getRoleConfig, getRolesForPhase as getRolesForPhaseFromConfig, getOutputsForRole, getResponsibilitiesForRole, } from './prevcConfig';
 export { ProjectScale } from './types';
 export { SCALE_ROUTES, detectProjectScale, getScaleRoute, getPhasesForScale, getRolesForScale, isPhaseRequiredForScale, getScaleName, getScaleFromName, getEstimatedTime, } from './scaling';
 export { PrevcStatusManager } from './status/statusManager';
-export { createInitialStatus, createQuickFlowStatus, createSmallProjectStatus, createMediumProjectStatus, createLargeProjectStatus, createEnterpriseProjectStatus, } from './status/templates';
-export { PrevcOrchestrator, WorkflowSummary } from './orchestrator';
+export { createInitialStatus, createQuickFlowStatus, createSmallProjectStatus, createMediumProjectStatus, createLargeProjectStatus, generateResumeContext, } from './status/templates';
+export { PrevcOrchestrator, WorkflowSummary, CompletePhaseOptions, InitWorkflowOptions, } from './orchestrator';
 export { CollaborationSession, CollaborationManager, } from './collaboration';
 export { AgentOrchestrator, agentOrchestrator, AgentType, AGENT_TYPES, PHASE_TO_AGENTS, ROLE_TO_AGENTS, DocumentLinker, documentLinker, DocType, DocGuide, DOCUMENT_GUIDES, AGENT_TO_DOCS, PHASE_TO_DOCS, ROLE_TO_DOCS, } from './orchestration';
 export { PlanLinker, createPlanLinker, PlanReference, LinkedPlan, PlanPhase, PlanStep, PlanDecision, PlanRisk, WorkflowPlans, AgentLineupEntry, PLAN_PHASE_TO_PREVC, } from './plans';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,IAAI,0BAA0B,EAC9C,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,OAAO,EACP,QAAQ,EACR,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,KAAK,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,GAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,IAAI,0BAA0B,EAC9C,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,OAAO,EACP,QAAQ,EACR,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,KAAK,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,UAAU,CAAC"}

package/dist/workflow/index.js

@@ -24,10 +24,21 @@ 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.ROLE_TO_AGENTS = exports.PHASE_TO_AGENTS = exports.AGENT_TYPES = exports.agentOrchestrator = exports.AgentOrchestrator = exports.CollaborationManager = exports.CollaborationSession = exports.PrevcOrchestrator = exports.createEnterpriseProjectStatus = exports.createLargeProjectStatus = exports.createMediumProjectStatus = exports.createSmallProjectStatus = exports.createQuickFlowStatus = exports.createInitialStatus = exports.PrevcStatusManager = exports.getEstimatedTime = exports.getScaleFromName = exports.getScaleName = exports.isPhaseRequiredForScale = exports.getRolesForScale = exports.getPhasesForScale = exports.getScaleRoute = exports.detectProjectScale = exports.SCALE_ROUTES = exports.ProjectScale = exports.getResponsibilitiesForRole = exports.getOutputsForRole = exports.getRolesForPhaseFromConfig = exports.getRoleConfig = exports.ROLE_CONFIG = exports.getPhaseOrder = exports.isValidPhase = exports.getOutputsForPhase = exports.getRolesForPhase = exports.isPhaseOptional = exports.getPreviousPhase = exports.getNextPhase = exports.getPhaseDefinition = exports.PHASE_NAMES_PT = exports.PHASE_NAMES_EN = exports.PREVC_PHASES = exports.PREVC_PHASE_ORDER = exports.getSpecialistsForRole = exports.getRoleForSpecialist = exports.isValidRole = exports.ROLE_DISPLAY_NAMES_EN = exports.ROLE_DISPLAY_NAMES = exports.SPECIALIST_TO_ROLE = exports.ROLE_TO_SPECIALISTS = exports.PREVC_ROLES = void 0;
-exports.getBuiltInSkillTemplates = exports.createSkillRegistry = exports.SkillRegistry = exports.SKILL_TO_PHASES = exports.isBuiltInSkill = exports.BUILT_IN_SKILLS = exports.createAgentRegistry = exports.AgentRegistry = exports.isBuiltInAgent = exports.BUILT_IN_AGENTS = exports.PLAN_PHASE_TO_PREVC = exports.createPlanLinker = exports.PlanLinker = exports.ROLE_TO_DOCS = exports.PHASE_TO_DOCS = exports.AGENT_TO_DOCS = exports.DOCUMENT_GUIDES = exports.documentLinker = exports.DocumentLinker = void 0;
+exports.PrevcOrchestrator = exports.generateResumeContext = exports.createLargeProjectStatus = exports.createMediumProjectStatus = exports.createSmallProjectStatus = exports.createQuickFlowStatus = exports.createInitialStatus = exports.PrevcStatusManager = exports.getEstimatedTime = exports.getScaleFromName = exports.getScaleName = exports.isPhaseRequiredForScale = exports.getRolesForScale = exports.getPhasesForScale = exports.getScaleRoute = exports.detectProjectScale = exports.SCALE_ROUTES = exports.ProjectScale = exports.getResponsibilitiesForRole = exports.getOutputsForRole = exports.getRolesForPhaseFromConfig = exports.getRoleConfig = exports.ROLE_CONFIG = exports.getPhaseOrder = exports.isValidPhase = exports.getOutputsForPhase = exports.getRolesForPhase = exports.isPhaseOptional = exports.getPreviousPhase = exports.getNextPhase = exports.getPhaseDefinition = exports.PHASE_NAMES_PT = exports.PHASE_NAMES_EN = exports.PREVC_PHASES = exports.PREVC_PHASE_ORDER = exports.getSpecialistsForRole = exports.getRoleForSpecialist = exports.isValidRole = exports.ROLE_DISPLAY_NAMES_EN = exports.ROLE_DISPLAY_NAMES = exports.SPECIALIST_TO_ROLE = exports.ROLE_TO_SPECIALISTS = exports.PREVC_ROLES = exports.getDefaultSettings = exports.createGateChecker = exports.WorkflowGateChecker = exports.NoWorkflowError = exports.NoPlanToApproveError = exports.WorkflowGateError = exports.WorkflowError = void 0;
+exports.getBuiltInSkillTemplates = exports.createSkillRegistry = exports.SkillRegistry = exports.SKILL_TO_PHASES = exports.isBuiltInSkill = exports.BUILT_IN_SKILLS = exports.createAgentRegistry = exports.AgentRegistry = exports.isBuiltInAgent = exports.BUILT_IN_AGENTS = exports.PLAN_PHASE_TO_PREVC = exports.createPlanLinker = exports.PlanLinker = 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 = exports.CollaborationManager = exports.CollaborationSession = void 0;
 // Types
 __exportStar(require("./types"), exports);
+// Errors
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "WorkflowError", { enumerable: true, get: function () { return errors_1.WorkflowError; } });
+Object.defineProperty(exports, "WorkflowGateError", { enumerable: true, get: function () { return errors_1.WorkflowGateError; } });
+Object.defineProperty(exports, "NoPlanToApproveError", { enumerable: true, get: function () { return errors_1.NoPlanToApproveError; } });
+Object.defineProperty(exports, "NoWorkflowError", { enumerable: true, get: function () { return errors_1.NoWorkflowError; } });
+// Gates
+var gates_1 = require("./gates");
+Object.defineProperty(exports, "WorkflowGateChecker", { enumerable: true, get: function () { return gates_1.WorkflowGateChecker; } });
+Object.defineProperty(exports, "createGateChecker", { enumerable: true, get: function () { return gates_1.createGateChecker; } });
+Object.defineProperty(exports, "getDefaultSettings", { enumerable: true, get: function () { return gates_1.getDefaultSettings; } });
 // Roles
 var roles_1 = require("./roles");
 Object.defineProperty(exports, "PREVC_ROLES", { enumerable: true, get: function () { return roles_1.PREVC_ROLES; } });
@@ -81,7 +92,7 @@ Object.defineProperty(exports, "createQuickFlowStatus", { enumerable: true, get:
 Object.defineProperty(exports, "createSmallProjectStatus", { enumerable: true, get: function () { return templates_1.createSmallProjectStatus; } });
 Object.defineProperty(exports, "createMediumProjectStatus", { enumerable: true, get: function () { return templates_1.createMediumProjectStatus; } });
 Object.defineProperty(exports, "createLargeProjectStatus", { enumerable: true, get: function () { return templates_1.createLargeProjectStatus; } });
-Object.defineProperty(exports, "createEnterpriseProjectStatus", { enumerable: true, get: function () { return templates_1.createEnterpriseProjectStatus; } });
+Object.defineProperty(exports, "generateResumeContext", { enumerable: true, get: function () { return templates_1.generateResumeContext; } });
 // Orchestrator
 var orchestrator_1 = require("./orchestrator");
 Object.defineProperty(exports, "PrevcOrchestrator", { enumerable: true, get: function () { return orchestrator_1.PrevcOrchestrator; } });

package/dist/workflow/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;AAEH,QAAQ;AACR,0CAAwB;AAExB,QAAQ;AACR,iCASiB;AARf,oGAAA,WAAW,OAAA;AACX,4GAAA,mBAAmB,OAAA;AACnB,2GAAA,kBAAkB,OAAA;AAClB,2GAAA,kBAAkB,OAAA;AAClB,8GAAA,qBAAqB,OAAA;AACrB,oGAAA,WAAW,OAAA;AACX,6GAAA,oBAAoB,OAAA;AACpB,8GAAA,qBAAqB,OAAA;AAGvB,SAAS;AACT,mCAakB;AAZhB,2GAAA,iBAAiB,OAAA;AACjB,sGAAA,YAAY,OAAA;AACZ,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AACd,4GAAA,kBAAkB,OAAA;AAClB,sGAAA,YAAY,OAAA;AACZ,0GAAA,gBAAgB,OAAA;AAChB,yGAAA,eAAe,OAAA;AACf,0GAAA,gBAAgB,OAAA;AAChB,4GAAA,kBAAkB,OAAA;AAClB,sGAAA,YAAY,OAAA;AACZ,uGAAA,aAAa,OAAA;AAGf,gBAAgB;AAChB,6CAMuB;AALrB,0GAAA,WAAW,OAAA;AACX,4GAAA,aAAa,OAAA;AACb,yHAAA,gBAAgB,OAA8B;AAC9C,gHAAA,iBAAiB,OAAA;AACjB,yHAAA,0BAA0B,OAAA;AAG5B,UAAU;AACV,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AACrB,qCAUmB;AATjB,uGAAA,YAAY,OAAA;AACZ,6GAAA,kBAAkB,OAAA;AAClB,wGAAA,aAAa,OAAA;AACb,4GAAA,iBAAiB,OAAA;AACjB,2GAAA,gBAAgB,OAAA;AAChB,kHAAA,uBAAuB,OAAA;AACvB,uGAAA,YAAY,OAAA;AACZ,2GAAA,gBAAgB,OAAA;AAChB,2GAAA,gBAAgB,OAAA;AAGlB,oBAAoB;AACpB,wDAA4D;AAAnD,mHAAA,kBAAkB,OAAA;AAC3B,gDAO4B;AAN1B,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AACrB,qHAAA,wBAAwB,OAAA;AACxB,sHAAA,yBAAyB,OAAA;AACzB,qHAAA,wBAAwB,OAAA;AACxB,0HAAA,6BAA6B,OAAA;AAG/B,eAAe;AACf,+CAAoE;AAA3D,iHAAA,iBAAiB,OAAA;AAE1B,gBAAgB;AAChB,iDAGyB;AAFvB,qHAAA,oBAAoB,OAAA;AACpB,qHAAA,oBAAoB,OAAA;AAGtB,gBAAgB;AAChB,iDAeyB;AAdvB,kHAAA,iBAAiB,OAAA;AACjB,kHAAA,iBAAiB,OAAA;AAEjB,4GAAA,WAAW,OAAA;AACX,gHAAA,eAAe,OAAA;AACf,+GAAA,cAAc,OAAA;AACd,+GAAA,cAAc,OAAA;AACd,+GAAA,cAAc,OAAA;AAGd,gHAAA,eAAe,OAAA;AACf,8GAAA,aAAa,OAAA;AACb,8GAAA,aAAa,OAAA;AACb,6GAAA,YAAY,OAAA;AAGd,mBAAmB;AACnB,iCAYiB;AAXf,mGAAA,UAAU,OAAA;AACV,yGAAA,gBAAgB,OAAA;AAShB,4GAAA,mBAAmB,OAAA;AAGrB,iBAAiB;AACjB,mCAQkB;AAPhB,yGAAA,eAAe,OAAA;AAIf,wGAAA,cAAc,OAAA;AACd,uGAAA,aAAa,OAAA;AACb,6GAAA,mBAAmB,OAAA;AAGrB,SAAS;AACT,mCAYkB;AAPhB,yGAAA,eAAe,OAAA;AAEf,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,uGAAA,aAAa,OAAA;AACb,6GAAA,mBAAmB,OAAA;AACnB,kHAAA,wBAAwB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"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"}

package/dist/workflow/orchestrator.d.ts

@@ -3,14 +3,35 @@
  *
  * Manages workflow progression, phase transitions, and role handoffs.
  */
-import { PrevcStatus, PrevcPhase, PrevcRole, ProjectContext, ProjectScale } from './types';
+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
@@ -22,8 +43,22 @@ export declare class PrevcOrchestrator {
     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): Promise<PrevcStatus>;
+    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
      */
@@ -41,13 +76,67 @@ export declare class PrevcOrchestrator {
      */
     getCurrentPhaseDefinition(): Promise<import("./types").PhaseDefinition>;
     /**
-     * Perform a handoff from one role to another
+     * 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
      */
-    handoff(from: PrevcRole, to: PrevcRole, artifacts: string[]): Promise<void>;
+    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[]): Promise<PrevcPhase | null>;
+    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
      */

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

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