@dotcontext/cli 0.8.0

package/dist/workflow/orchestration/documentLinker.js

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * Document Linker
+ *
+ * Links agents and workflow phases to relevant documentation sections,
+ * enabling context-aware navigation and knowledge sharing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.documentLinker = exports.DocumentLinker = exports.ROLE_TO_DOCS = exports.PHASE_TO_DOCS = exports.AGENT_TO_DOCS = exports.DOCUMENT_GUIDES = void 0;
+/**
+ * Standard documentation guides
+ */
+exports.DOCUMENT_GUIDES = [
+    {
+        type: 'architecture',
+        path: '.context/docs/architecture.md',
+        title: 'Architecture',
+        description: 'System architecture, patterns, and design decisions',
+    },
+    {
+        type: 'data-flow',
+        path: '.context/docs/data-flow.md',
+        title: 'Data Flow',
+        description: 'How data moves through the system',
+    },
+    {
+        type: 'glossary',
+        path: '.context/docs/glossary.md',
+        title: 'Glossary',
+        description: 'Domain terms and definitions',
+    },
+    {
+        type: 'api',
+        path: '.context/docs/api.md',
+        title: 'API Reference',
+        description: 'API endpoints and usage',
+    },
+    {
+        type: 'getting-started',
+        path: '.context/docs/getting-started.md',
+        title: 'Getting Started',
+        description: 'Setup and onboarding guide',
+    },
+    {
+        type: 'deployment',
+        path: '.context/docs/deployment.md',
+        title: 'Deployment',
+        description: 'Deployment procedures and environments',
+    },
+    {
+        type: 'security',
+        path: '.context/docs/security.md',
+        title: 'Security',
+        description: 'Security guidelines and practices',
+    },
+    {
+        type: 'testing',
+        path: '.context/docs/testing.md',
+        title: 'Testing',
+        description: 'Testing strategies and coverage',
+    },
+    {
+        type: 'contributing',
+        path: '.context/docs/contributing.md',
+        title: 'Contributing',
+        description: 'Contribution guidelines',
+    },
+    {
+        type: 'readme',
+        path: '.context/docs/README.md',
+        title: 'Documentation Index',
+        description: 'Overview of all documentation',
+    },
+];
+/**
+ * Mapping from agent types to relevant documentation
+ */
+exports.AGENT_TO_DOCS = {
+    'code-reviewer': ['architecture', 'contributing', 'glossary'],
+    'bug-fixer': ['architecture', 'data-flow', 'testing'],
+    'feature-developer': ['architecture', 'data-flow', 'api', 'getting-started'],
+    'refactoring-specialist': ['architecture', 'glossary', 'contributing'],
+    'test-writer': ['testing', 'architecture', 'api'],
+    'documentation-writer': ['readme', 'glossary', 'architecture', 'api'],
+    'performance-optimizer': ['architecture', 'data-flow', 'deployment'],
+    'security-auditor': ['security', 'architecture', 'api'],
+    'backend-specialist': ['architecture', 'api', 'data-flow', 'deployment'],
+    'frontend-specialist': ['architecture', 'data-flow', 'getting-started'],
+    'architect-specialist': ['architecture', 'data-flow', 'security', 'deployment'],
+    'devops-specialist': ['deployment', 'security', 'testing'],
+    'database-specialist': ['architecture', 'data-flow', 'glossary'],
+    'mobile-specialist': ['architecture', 'api', 'getting-started'],
+};
+/**
+ * Mapping from PREVC phases to relevant documentation
+ */
+exports.PHASE_TO_DOCS = {
+    P: ['architecture', 'glossary', 'readme'], // Planning
+    R: ['architecture', 'security', 'data-flow'], // Review
+    E: ['architecture', 'api', 'data-flow', 'getting-started'], // Execution
+    V: ['testing', 'security', 'api'], // Validation
+    C: ['deployment', 'readme', 'contributing'], // Confirmation
+};
+/**
+ * Mapping from PREVC roles to relevant documentation
+ */
+exports.ROLE_TO_DOCS = {
+    planner: ['architecture', 'glossary', 'readme'],
+    designer: ['architecture', 'getting-started'],
+    architect: ['architecture', 'data-flow', 'security', 'deployment'],
+    developer: ['architecture', 'api', 'data-flow', 'getting-started'],
+    qa: ['testing', 'security', 'api'],
+    reviewer: ['architecture', 'contributing', 'glossary'],
+    documenter: ['readme', 'glossary', 'architecture', 'api', 'contributing'],
+    'solo-dev': ['architecture', 'api', 'testing', 'readme'],
+};
+/**
+ * Document Linker class
+ */
+class DocumentLinker {
+    /**
+     * Get documentation guides for an agent type
+     */
+    getDocsForAgent(agent) {
+        const docTypes = exports.AGENT_TO_DOCS[agent] || [];
+        return this.getGuidesByTypes(docTypes);
+    }
+    /**
+     * Get documentation guides for a PREVC phase
+     */
+    getDocsForPhase(phase) {
+        const docTypes = exports.PHASE_TO_DOCS[phase] || [];
+        return this.getGuidesByTypes(docTypes);
+    }
+    /**
+     * Get documentation guides for a PREVC role
+     */
+    getDocsForRole(role) {
+        const docTypes = exports.ROLE_TO_DOCS[role] || [];
+        return this.getGuidesByTypes(docTypes);
+    }
+    /**
+     * Get primary documentation for an agent (first in list)
+     */
+    getPrimaryDocForAgent(agent) {
+        const docs = this.getDocsForAgent(agent);
+        return docs.length > 0 ? docs[0] : null;
+    }
+    /**
+     * Get all documentation guides
+     */
+    getAllDocs() {
+        return [...exports.DOCUMENT_GUIDES];
+    }
+    /**
+     * Get a specific document guide by type
+     */
+    getDocByType(type) {
+        return exports.DOCUMENT_GUIDES.find((doc) => doc.type === type) || null;
+    }
+    /**
+     * Get documentation paths for an agent
+     */
+    getDocPathsForAgent(agent) {
+        return this.getDocsForAgent(agent).map((doc) => doc.path);
+    }
+    /**
+     * Get documentation paths for a phase
+     */
+    getDocPathsForPhase(phase) {
+        return this.getDocsForPhase(phase).map((doc) => doc.path);
+    }
+    /**
+     * Get documentation paths for a role
+     */
+    getDocPathsForRole(role) {
+        return this.getDocsForRole(role).map((doc) => doc.path);
+    }
+    /**
+     * Get combined documentation for multiple agents
+     */
+    getDocsForAgents(agents) {
+        const docTypes = new Set();
+        for (const agent of agents) {
+            const types = exports.AGENT_TO_DOCS[agent] || [];
+            types.forEach((type) => docTypes.add(type));
+        }
+        return this.getGuidesByTypes(Array.from(docTypes));
+    }
+    /**
+     * Get documentation relevant to a task description
+     */
+    getDocsForTask(taskDescription) {
+        const lowerTask = taskDescription.toLowerCase();
+        const relevantDocs = new Set();
+        // Keyword matching
+        if (lowerTask.includes('architect') || lowerTask.includes('design') || lowerTask.includes('structure')) {
+            relevantDocs.add('architecture');
+        }
+        if (lowerTask.includes('api') || lowerTask.includes('endpoint')) {
+            relevantDocs.add('api');
+        }
+        if (lowerTask.includes('test') || lowerTask.includes('coverage')) {
+            relevantDocs.add('testing');
+        }
+        if (lowerTask.includes('security') || lowerTask.includes('auth')) {
+            relevantDocs.add('security');
+        }
+        if (lowerTask.includes('deploy') || lowerTask.includes('release')) {
+            relevantDocs.add('deployment');
+        }
+        if (lowerTask.includes('data') || lowerTask.includes('flow')) {
+            relevantDocs.add('data-flow');
+        }
+        if (lowerTask.includes('document') || lowerTask.includes('readme')) {
+            relevantDocs.add('readme');
+        }
+        if (lowerTask.includes('setup') || lowerTask.includes('start')) {
+            relevantDocs.add('getting-started');
+        }
+        // Default to architecture if no matches
+        if (relevantDocs.size === 0) {
+            relevantDocs.add('architecture');
+            relevantDocs.add('readme');
+        }
+        return this.getGuidesByTypes(Array.from(relevantDocs));
+    }
+    /**
+     * Generate markdown links for agent documentation
+     */
+    generateAgentDocLinks(agent) {
+        const docs = this.getDocsForAgent(agent);
+        if (docs.length === 0)
+            return '';
+        const lines = ['## Relevant Documentation', ''];
+        for (const doc of docs) {
+            lines.push(`- [${doc.title}](${doc.path}) - ${doc.description}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Generate markdown links for phase documentation
+     */
+    generatePhaseDocLinks(phase) {
+        const docs = this.getDocsForPhase(phase);
+        if (docs.length === 0)
+            return '';
+        const lines = ['## Phase Documentation', ''];
+        for (const doc of docs) {
+            lines.push(`- [${doc.title}](${doc.path}) - ${doc.description}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Helper to get guides by doc types
+     */
+    getGuidesByTypes(types) {
+        return types
+            .map((type) => exports.DOCUMENT_GUIDES.find((doc) => doc.type === type))
+            .filter((doc) => doc !== undefined);
+    }
+}
+exports.DocumentLinker = DocumentLinker;
+// Export singleton instance
+exports.documentLinker = new DocumentLinker();
+//# sourceMappingURL=documentLinker.js.map

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

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

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