@dotcontext/cli 0.8.0

package/dist/workflow/status/statusManager.d.ts

@@ -0,0 +1,137 @@
+/**
+ * PREVC Status Manager
+ *
+ * Manages the workflow status YAML file that tracks progress through phases.
+ */
+import { PrevcStatus, PrevcPhase, PrevcRole, PhaseUpdate, RoleUpdate, AgentUpdate, ProjectScale, WorkflowSettings, PlanApproval, ExecutionHistory, ExecutionHistoryEntry } from '../types';
+/**
+ * PREVC Status Manager
+ *
+ * Handles reading and writing the workflow status file.
+ */
+export declare class PrevcStatusManager {
+    private contextPath;
+    private statusPath;
+    private cachedStatus;
+    constructor(contextPath: string);
+    /**
+     * Check if a workflow status file exists
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Load the workflow status from disk
+     */
+    load(): Promise<PrevcStatus>;
+    /**
+     * Load status synchronously (for use in orchestrator)
+     */
+    loadSync(): PrevcStatus;
+    /**
+     * Save the workflow status to disk
+     */
+    save(status: PrevcStatus): Promise<void>;
+    /**
+     * Create a new workflow status
+     */
+    create(options: {
+        name: string;
+        scale: ProjectScale;
+        phases?: PrevcPhase[];
+        roles?: PrevcRole[] | 'all';
+    }): Promise<PrevcStatus>;
+    /**
+     * Update a phase's status
+     */
+    updatePhase(phase: PrevcPhase, update: PhaseUpdate): Promise<void>;
+    /**
+     * Update a role's status
+     * @deprecated Use updateAgent instead
+     */
+    updateRole(role: PrevcRole, update: RoleUpdate): Promise<void>;
+    /**
+     * Update an agent's status (replaces updateRole)
+     */
+    updateAgent(agentName: string, update: AgentUpdate): Promise<void>;
+    /**
+     * Transition to a new phase
+     */
+    transitionToPhase(phase: PrevcPhase): Promise<void>;
+    /**
+     * Mark a phase as complete
+     */
+    markPhaseComplete(phase: PrevcPhase, outputs?: string[]): Promise<void>;
+    /**
+     * Get the current phase
+     */
+    getCurrentPhase(): Promise<PrevcPhase>;
+    /**
+     * Get the active role (if any)
+     */
+    getActiveRole(): Promise<PrevcRole | null>;
+    /**
+     * Get the next phase that should be executed
+     */
+    getNextPhase(): Promise<PrevcPhase | null>;
+    /**
+     * Check if the workflow is complete
+     */
+    isComplete(): Promise<boolean>;
+    /**
+     * Set workflow settings
+     */
+    setSettings(settings: Partial<WorkflowSettings>): Promise<WorkflowSettings>;
+    /**
+     * Get workflow settings (with defaults applied)
+     */
+    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>;
+    /**
+     * Add an entry to the execution history
+     */
+    addHistoryEntry(entry: Omit<ExecutionHistoryEntry, 'timestamp'>): Promise<void>;
+    /**
+     * Add a step-level entry to the execution history (breadcrumb trail)
+     */
+    addStepHistoryEntry(entry: {
+        action: 'step_started' | 'step_completed' | 'step_skipped';
+        plan: string;
+        planPhase: string;
+        stepIndex: number;
+        stepDescription?: string;
+        output?: string;
+        notes?: string;
+    }): Promise<void>;
+    /**
+     * Get execution history
+     */
+    getExecutionHistory(): Promise<ExecutionHistory | undefined>;
+    /**
+     * Apply migration logic for existing workflows
+     * - Add default settings based on scale
+     * - Initialize approval tracking based on current state
+     * - Initialize execution history for old workflows
+     * - Initialize agents object for old workflows
+     */
+    private migrateStatus;
+    /**
+     * Parse YAML content to PrevcStatus object
+     * Simple implementation for the specific format
+     */
+    private parseYaml;
+    /**
+     * Serialize PrevcStatus object to YAML string
+     */
+    private serializeYaml;
+}
+//# sourceMappingURL=statusManager.d.ts.map

package/dist/workflow/status/statusManager.d.ts.map

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