@dotcontext/cli 0.8.0

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

@@ -0,0 +1,68 @@
+/**
+ * Agent Orchestrator
+ *
+ * Maps PREVC workflow roles and phases to specialized agents,
+ * providing intelligent agent selection and sequencing.
+ */
+import { PrevcPhase, PrevcRole } from '../types';
+/**
+ * Available agent types from the existing system
+ */
+export declare const AGENT_TYPES: readonly ["code-reviewer", "bug-fixer", "feature-developer", "refactoring-specialist", "test-writer", "documentation-writer", "performance-optimizer", "security-auditor", "backend-specialist", "frontend-specialist", "architect-specialist", "devops-specialist", "database-specialist", "mobile-specialist"];
+export type AgentType = (typeof AGENT_TYPES)[number];
+/**
+ * Mapping from PREVC phases to relevant agent types
+ */
+export declare const PHASE_TO_AGENTS: Record<PrevcPhase, AgentType[]>;
+/**
+ * Mapping from PREVC roles to agent types
+ */
+export declare const ROLE_TO_AGENTS: Record<PrevcRole, AgentType[]>;
+/**
+ * Agent Orchestrator class
+ */
+export declare class AgentOrchestrator {
+    /**
+     * Get recommended agents for a PREVC phase
+     */
+    getAgentsForPhase(phase: PrevcPhase): AgentType[];
+    /**
+     * Get recommended agents for a PREVC role
+     */
+    getAgentsForRole(role: PrevcRole): AgentType[];
+    /**
+     * Get primary agent for a role (first in the list)
+     */
+    getPrimaryAgentForRole(role: PrevcRole): AgentType | null;
+    /**
+     * Select agents based on task description
+     */
+    selectAgentsByTask(taskDescription: string): AgentType[];
+    /**
+     * Get agent handoff sequence for a workflow
+     * Returns ordered list of agents based on phase progression
+     */
+    getAgentHandoffSequence(phases: PrevcPhase[]): AgentType[];
+    /**
+     * Get recommended agent sequence for a specific task
+     */
+    getTaskAgentSequence(taskDescription: string, includeReview?: boolean): AgentType[];
+    /**
+     * Map a specialist name to agent type
+     */
+    specialistToAgent(specialist: string): AgentType | null;
+    /**
+     * Get all available agent types
+     */
+    getAllAgentTypes(): AgentType[];
+    /**
+     * Check if agent type is valid
+     */
+    isValidAgentType(type: string): type is AgentType;
+    /**
+     * Get agent description
+     */
+    getAgentDescription(agent: AgentType): string;
+}
+export declare const agentOrchestrator: AgentOrchestrator;
+//# sourceMappingURL=agentOrchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentOrchestrator.d.ts","sourceRoot":"","sources":["../../../src/workflow/orchestration/agentOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGjD;;GAEG;AACH,eAAO,MAAM,WAAW,kTAed,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,CAkB3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,CAsBzD,CAAC;AAoFF;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE;IAIjD;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE;IAI9C;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI;IAKzD;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,EAAE;IAkBxD;;;OAGG;IACH,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,EAAE;IAiB1D;;OAEG;IACH,oBAAoB,CAClB,eAAe,EAAE,MAAM,EACvB,aAAa,GAAE,OAAc,GAC5B,SAAS,EAAE;IAsBd;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAiBvD;;OAEG;IACH,gBAAgB,IAAI,SAAS,EAAE;IAI/B;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS;IAIjD;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;CAoB9C;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/workflow/orchestration/agentOrchestrator.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * Agent Orchestrator
+ *
+ * Maps PREVC workflow roles and phases to specialized agents,
+ * providing intelligent agent selection and sequencing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentOrchestrator = exports.AgentOrchestrator = exports.ROLE_TO_AGENTS = exports.PHASE_TO_AGENTS = exports.AGENT_TYPES = void 0;
+const roles_1 = require("../roles");
+/**
+ * Available agent types from the existing system
+ */
+exports.AGENT_TYPES = [
+    'code-reviewer',
+    'bug-fixer',
+    'feature-developer',
+    'refactoring-specialist',
+    'test-writer',
+    'documentation-writer',
+    'performance-optimizer',
+    'security-auditor',
+    'backend-specialist',
+    'frontend-specialist',
+    'architect-specialist',
+    'devops-specialist',
+    'database-specialist',
+    'mobile-specialist',
+];
+/**
+ * Mapping from PREVC phases to relevant agent types
+ */
+exports.PHASE_TO_AGENTS = {
+    P: ['architect-specialist', 'documentation-writer', 'frontend-specialist'],
+    R: ['architect-specialist', 'code-reviewer', 'security-auditor'],
+    E: [
+        'feature-developer',
+        'backend-specialist',
+        'frontend-specialist',
+        'database-specialist',
+        'mobile-specialist',
+        'bug-fixer',
+    ],
+    V: [
+        'test-writer',
+        'code-reviewer',
+        'security-auditor',
+        'performance-optimizer',
+    ],
+    C: ['documentation-writer', 'devops-specialist'],
+};
+/**
+ * Mapping from PREVC roles to agent types
+ */
+exports.ROLE_TO_AGENTS = {
+    planner: ['architect-specialist', 'documentation-writer'],
+    designer: ['frontend-specialist'],
+    architect: ['architect-specialist', 'backend-specialist', 'database-specialist'],
+    developer: [
+        'feature-developer',
+        'bug-fixer',
+        'backend-specialist',
+        'frontend-specialist',
+        'mobile-specialist',
+        'database-specialist',
+    ],
+    qa: ['test-writer', 'security-auditor', 'performance-optimizer'],
+    reviewer: ['code-reviewer', 'security-auditor'],
+    documenter: ['documentation-writer'],
+    'solo-dev': [
+        'refactoring-specialist',
+        'bug-fixer',
+        'feature-developer',
+        'test-writer',
+        'documentation-writer',
+    ],
+};
+/**
+ * Task keywords to agent mapping for intelligent selection
+ */
+const TASK_KEYWORDS = {
+    // Architecture keywords
+    architecture: ['architect-specialist'],
+    design: ['architect-specialist', 'frontend-specialist'],
+    system: ['architect-specialist', 'backend-specialist'],
+    scalability: ['architect-specialist', 'performance-optimizer'],
+    // Development keywords
+    feature: ['feature-developer'],
+    implement: ['feature-developer', 'backend-specialist'],
+    build: ['feature-developer'],
+    create: ['feature-developer'],
+    // Bug/Fix keywords
+    bug: ['bug-fixer'],
+    fix: ['bug-fixer'],
+    error: ['bug-fixer'],
+    issue: ['bug-fixer'],
+    // Testing keywords
+    test: ['test-writer'],
+    coverage: ['test-writer'],
+    unit: ['test-writer'],
+    integration: ['test-writer'],
+    // Code quality keywords
+    review: ['code-reviewer'],
+    refactor: ['refactoring-specialist', 'code-reviewer'],
+    clean: ['refactoring-specialist'],
+    optimize: ['performance-optimizer', 'refactoring-specialist'],
+    // Security keywords
+    security: ['security-auditor'],
+    vulnerability: ['security-auditor'],
+    auth: ['security-auditor', 'backend-specialist'],
+    permission: ['security-auditor'],
+    // Performance keywords
+    performance: ['performance-optimizer'],
+    speed: ['performance-optimizer'],
+    memory: ['performance-optimizer'],
+    cache: ['performance-optimizer', 'backend-specialist'],
+    // Documentation keywords
+    document: ['documentation-writer'],
+    readme: ['documentation-writer'],
+    docs: ['documentation-writer'],
+    // Backend keywords
+    api: ['backend-specialist', 'documentation-writer'],
+    server: ['backend-specialist'],
+    endpoint: ['backend-specialist'],
+    microservice: ['backend-specialist'],
+    // Frontend keywords
+    ui: ['frontend-specialist'],
+    component: ['frontend-specialist'],
+    style: ['frontend-specialist'],
+    responsive: ['frontend-specialist'],
+    // Database keywords
+    database: ['database-specialist'],
+    query: ['database-specialist'],
+    migration: ['database-specialist'],
+    schema: ['database-specialist'],
+    // DevOps keywords
+    deploy: ['devops-specialist'],
+    ci: ['devops-specialist'],
+    pipeline: ['devops-specialist'],
+    docker: ['devops-specialist'],
+    // Mobile keywords
+    mobile: ['mobile-specialist'],
+    ios: ['mobile-specialist'],
+    android: ['mobile-specialist'],
+    app: ['mobile-specialist', 'frontend-specialist'],
+};
+/**
+ * Agent Orchestrator class
+ */
+class AgentOrchestrator {
+    /**
+     * Get recommended agents for a PREVC phase
+     */
+    getAgentsForPhase(phase) {
+        return exports.PHASE_TO_AGENTS[phase] || [];
+    }
+    /**
+     * Get recommended agents for a PREVC role
+     */
+    getAgentsForRole(role) {
+        return exports.ROLE_TO_AGENTS[role] || [];
+    }
+    /**
+     * Get primary agent for a role (first in the list)
+     */
+    getPrimaryAgentForRole(role) {
+        const agents = this.getAgentsForRole(role);
+        return agents.length > 0 ? agents[0] : null;
+    }
+    /**
+     * Select agents based on task description
+     */
+    selectAgentsByTask(taskDescription) {
+        const lowerTask = taskDescription.toLowerCase();
+        const matchedAgents = new Set();
+        for (const [keyword, agents] of Object.entries(TASK_KEYWORDS)) {
+            if (lowerTask.includes(keyword)) {
+                agents.forEach((agent) => matchedAgents.add(agent));
+            }
+        }
+        // If no matches, return a default set
+        if (matchedAgents.size === 0) {
+            return ['feature-developer', 'code-reviewer'];
+        }
+        return Array.from(matchedAgents);
+    }
+    /**
+     * Get agent handoff sequence for a workflow
+     * Returns ordered list of agents based on phase progression
+     */
+    getAgentHandoffSequence(phases) {
+        const sequence = [];
+        const seen = new Set();
+        for (const phase of phases) {
+            const agents = this.getAgentsForPhase(phase);
+            for (const agent of agents) {
+                if (!seen.has(agent)) {
+                    sequence.push(agent);
+                    seen.add(agent);
+                }
+            }
+        }
+        return sequence;
+    }
+    /**
+     * Get recommended agent sequence for a specific task
+     */
+    getTaskAgentSequence(taskDescription, includeReview = true) {
+        const primaryAgents = this.selectAgentsByTask(taskDescription);
+        const sequence = [...primaryAgents];
+        // Add test-writer if not already included
+        if (!sequence.includes('test-writer')) {
+            sequence.push('test-writer');
+        }
+        // Add code-reviewer for review if requested
+        if (includeReview && !sequence.includes('code-reviewer')) {
+            sequence.push('code-reviewer');
+        }
+        // Add documentation-writer at the end
+        if (!sequence.includes('documentation-writer')) {
+            sequence.push('documentation-writer');
+        }
+        return sequence;
+    }
+    /**
+     * Map a specialist name to agent type
+     */
+    specialistToAgent(specialist) {
+        // Direct mapping if it's already an agent type
+        if (exports.AGENT_TYPES.includes(specialist)) {
+            return specialist;
+        }
+        // Check role mappings
+        for (const [role, specialists] of Object.entries(roles_1.ROLE_TO_SPECIALISTS)) {
+            if (specialists.includes(specialist)) {
+                const agents = exports.ROLE_TO_AGENTS[role];
+                return agents.length > 0 ? agents[0] : null;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get all available agent types
+     */
+    getAllAgentTypes() {
+        return [...exports.AGENT_TYPES];
+    }
+    /**
+     * Check if agent type is valid
+     */
+    isValidAgentType(type) {
+        return exports.AGENT_TYPES.includes(type);
+    }
+    /**
+     * Get agent description
+     */
+    getAgentDescription(agent) {
+        const descriptions = {
+            'code-reviewer': 'Reviews code for quality, style, and best practices',
+            'bug-fixer': 'Identifies and fixes bugs with targeted solutions',
+            'feature-developer': 'Implements new features following architecture',
+            'refactoring-specialist': 'Improves code structure and eliminates code smells',
+            'test-writer': 'Creates comprehensive test suites',
+            'documentation-writer': 'Writes and maintains documentation',
+            'performance-optimizer': 'Identifies and resolves performance bottlenecks',
+            'security-auditor': 'Audits code for security vulnerabilities',
+            'backend-specialist': 'Develops server-side logic and APIs',
+            'frontend-specialist': 'Builds user interfaces and interactions',
+            'architect-specialist': 'Designs system architecture and patterns',
+            'devops-specialist': 'Manages deployment and CI/CD pipelines',
+            'database-specialist': 'Designs and optimizes database solutions',
+            'mobile-specialist': 'Develops mobile applications',
+        };
+        return descriptions[agent] || 'Specialized development agent';
+    }
+}
+exports.AgentOrchestrator = AgentOrchestrator;
+// Export singleton instance
+exports.agentOrchestrator = new AgentOrchestrator();
+//# sourceMappingURL=agentOrchestrator.js.map

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

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

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

@@ -0,0 +1,100 @@
+/**
+ * Document Linker
+ *
+ * Links agents and workflow phases to relevant documentation sections,
+ * enabling context-aware navigation and knowledge sharing.
+ */
+import { PrevcPhase, PrevcRole } from '../types';
+import { AgentType } from './agentOrchestrator';
+/**
+ * Documentation types available in .context/docs/
+ */
+export type DocType = 'architecture' | 'data-flow' | 'glossary' | 'api' | 'getting-started' | 'deployment' | 'security' | 'testing' | 'contributing' | 'readme';
+/**
+ * Document guide information
+ */
+export interface DocGuide {
+    type: DocType;
+    path: string;
+    title: string;
+    description: string;
+}
+/**
+ * Standard documentation guides
+ */
+export declare const DOCUMENT_GUIDES: DocGuide[];
+/**
+ * Mapping from agent types to relevant documentation
+ */
+export declare const AGENT_TO_DOCS: Record<AgentType, DocType[]>;
+/**
+ * Mapping from PREVC phases to relevant documentation
+ */
+export declare const PHASE_TO_DOCS: Record<PrevcPhase, DocType[]>;
+/**
+ * Mapping from PREVC roles to relevant documentation
+ */
+export declare const ROLE_TO_DOCS: Record<PrevcRole, DocType[]>;
+/**
+ * Document Linker class
+ */
+export declare class DocumentLinker {
+    /**
+     * Get documentation guides for an agent type
+     */
+    getDocsForAgent(agent: AgentType): DocGuide[];
+    /**
+     * Get documentation guides for a PREVC phase
+     */
+    getDocsForPhase(phase: PrevcPhase): DocGuide[];
+    /**
+     * Get documentation guides for a PREVC role
+     */
+    getDocsForRole(role: PrevcRole): DocGuide[];
+    /**
+     * Get primary documentation for an agent (first in list)
+     */
+    getPrimaryDocForAgent(agent: AgentType): DocGuide | null;
+    /**
+     * Get all documentation guides
+     */
+    getAllDocs(): DocGuide[];
+    /**
+     * Get a specific document guide by type
+     */
+    getDocByType(type: DocType): DocGuide | null;
+    /**
+     * Get documentation paths for an agent
+     */
+    getDocPathsForAgent(agent: AgentType): string[];
+    /**
+     * Get documentation paths for a phase
+     */
+    getDocPathsForPhase(phase: PrevcPhase): string[];
+    /**
+     * Get documentation paths for a role
+     */
+    getDocPathsForRole(role: PrevcRole): string[];
+    /**
+     * Get combined documentation for multiple agents
+     */
+    getDocsForAgents(agents: AgentType[]): DocGuide[];
+    /**
+     * Get documentation relevant to a task description
+     */
+    getDocsForTask(taskDescription: string): DocGuide[];
+    /**
+     * Generate markdown links for agent documentation
+     */
+    generateAgentDocLinks(agent: AgentType): string;
+    /**
+     * Generate markdown links for phase documentation
+     */
+    generatePhaseDocLinks(phase: PrevcPhase): string;
+    /**
+     * Helper to get guides by doc types
+     */
+    private getGuidesByTypes;
+}
+export declare const documentLinker: DocumentLinker;
+//# sourceMappingURL=documentLinker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentLinker.d.ts","sourceRoot":"","sources":["../../../src/workflow/orchestration/documentLinker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,OAAO,GACf,cAAc,GACd,WAAW,GACX,UAAU,GACV,KAAK,GACL,iBAAiB,GACjB,YAAY,GACZ,UAAU,GACV,SAAS,GACT,cAAc,GACd,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,EA6DrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,CAetD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,CAMvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,CASrD,CAAC;AAEF;;GAEG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE;IAK7C;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,EAAE;IAK9C;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,EAAE;IAK3C;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI;IAKxD;;OAEG;IACH,UAAU,IAAI,QAAQ,EAAE;IAIxB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI;IAI5C;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IAI/C;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE;IAIhD;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE;IAI7C;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE;IAWjD;;OAEG;IACH,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,EAAE;IAuCnD;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAW/C;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAWhD;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAKzB;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}