crewly 1.0.0

package/dist/backend/backend/src/services/prompt/prompt-generator.service.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Prompt Generator Service
+ *
+ * Generates and manages system prompts for team members by composing:
+ * - Role base prompts (from role definitions)
+ * - Skill instructions (from assigned skills)
+ *
+ * Also adds context prefixes to help agents re-read their prompts
+ * when context window is compressed.
+ *
+ * @module services/prompt/prompt-generator.service
+ */
+import type { TeamMember, Team } from '../../types/index.js';
+/**
+ * Service for generating and managing team member prompts.
+ */
+export declare class PromptGeneratorService {
+    private static instance;
+    private storageService;
+    private logger;
+    private configDir;
+    private crewlyHome;
+    constructor();
+    /**
+     * Get singleton instance of PromptGeneratorService.
+     *
+     * @returns The singleton instance
+     */
+    static getInstance(): PromptGeneratorService;
+    /**
+     * Reset singleton instance (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Generate a full prompt for a team member by composing:
+     * 1. Role base prompt
+     * 2. Skill instructions for each assigned skill
+     *
+     * @param member - The team member
+     * @param teamId - The team ID
+     * @returns The composed prompt content
+     */
+    generateMemberPrompt(member: TeamMember, teamId: string): Promise<string>;
+    /**
+     * Generate and save a prompt for a team member.
+     *
+     * @param member - The team member
+     * @param teamId - The team ID
+     * @returns The generated prompt content
+     */
+    generateAndSaveMemberPrompt(member: TeamMember, teamId: string): Promise<string>;
+    /**
+     * Regenerate prompts for all members of a team.
+     *
+     * @param team - The team
+     */
+    regenerateTeamPrompts(team: Team): Promise<void>;
+    /**
+     * Get the effective skills for a team member.
+     * Combines role's assigned skills with member's skillOverrides,
+     * minus any excludedRoleSkills.
+     *
+     * @param member - The team member
+     * @returns Array of skill IDs
+     */
+    getMemberSkills(member: TeamMember): Promise<string[]>;
+    /**
+     * Get the assigned skills for a role from config/roles/{role}/role.json
+     *
+     * @param role - The role name
+     * @returns Array of skill IDs assigned to the role
+     */
+    getRoleAssignedSkills(role: string): Promise<string[]>;
+    /**
+     * Get the base prompt for a role from config/roles/{role}/prompt.md
+     *
+     * @param role - The role name
+     * @returns The role prompt content or null if not found
+     */
+    getRoleBasePrompt(role: string): Promise<string | null>;
+    /**
+     * Get the instructions for a skill from config/skills/{skill}/instructions.md
+     *
+     * @param skillId - The skill ID (can include category, e.g., "mcp/chrome-browser")
+     * @returns The skill instructions content or null if not found
+     */
+    getSkillInstructions(skillId: string): Promise<string | null>;
+    /**
+     * Build a context prefix to prepend to messages sent to agents.
+     * This helps agents remember their identity when context is compressed.
+     *
+     * @param member - The team member
+     * @param teamId - The team ID
+     * @param teamName - The team name
+     * @returns The context prefix string
+     */
+    buildContextPrefix(member: TeamMember, teamId: string, teamName: string): string;
+    /**
+     * Build a context prefix for the orchestrator.
+     *
+     * @returns The context prefix string
+     */
+    buildOrchestratorContextPrefix(): string;
+}
+export declare const getPromptGeneratorService: () => PromptGeneratorService;
+//# sourceMappingURL=prompt-generator.service.d.ts.map

package/dist/backend/backend/src/services/prompt/prompt-generator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-generator.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/prompt/prompt-generator.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAC9D,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;;IAS3B;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,sBAAsB;IAO5C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;;;OAQG;IACG,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyD/E;;;;;;OAMG;IACG,2BAA2B,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMtF;;;;OAIG;IACG,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD;;;;;;;OAOG;IACG,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAc5D;;;;;OAKG;IACG,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4B5D;;;;;OAKG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyB7D;;;;;OAKG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyBnE;;;;;;;;OAQG;IACH,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAahF;;;;OAIG;IACH,8BAA8B,IAAI,MAAM;CAWzC;AAGD,eAAO,MAAM,yBAAyB,QAAO,sBAE5C,CAAC"}

package/dist/backend/backend/src/services/prompt/prompt-generator.service.js

@@ -0,0 +1,287 @@
+/**
+ * Prompt Generator Service
+ *
+ * Generates and manages system prompts for team members by composing:
+ * - Role base prompts (from role definitions)
+ * - Skill instructions (from assigned skills)
+ *
+ * Also adds context prefixes to help agents re-read their prompts
+ * when context window is compressed.
+ *
+ * @module services/prompt/prompt-generator.service
+ */
+import * as path from 'path';
+import * as os from 'os';
+import { existsSync } from 'fs';
+import * as fs from 'fs/promises';
+import { StorageService } from '../core/storage.service.js';
+import { LoggerService } from '../core/logger.service.js';
+/**
+ * Service for generating and managing team member prompts.
+ */
+export class PromptGeneratorService {
+    static instance = null;
+    storageService;
+    logger;
+    configDir;
+    crewlyHome;
+    constructor() {
+        this.storageService = StorageService.getInstance();
+        this.logger = LoggerService.getInstance().createComponentLogger('PromptGeneratorService');
+        this.configDir = path.resolve(process.cwd(), 'config');
+        this.crewlyHome = path.join(os.homedir(), '.crewly');
+    }
+    /**
+     * Get singleton instance of PromptGeneratorService.
+     *
+     * @returns The singleton instance
+     */
+    static getInstance() {
+        if (!PromptGeneratorService.instance) {
+            PromptGeneratorService.instance = new PromptGeneratorService();
+        }
+        return PromptGeneratorService.instance;
+    }
+    /**
+     * Reset singleton instance (for testing).
+     */
+    static resetInstance() {
+        PromptGeneratorService.instance = null;
+    }
+    /**
+     * Generate a full prompt for a team member by composing:
+     * 1. Role base prompt
+     * 2. Skill instructions for each assigned skill
+     *
+     * @param member - The team member
+     * @param teamId - The team ID
+     * @returns The composed prompt content
+     */
+    async generateMemberPrompt(member, teamId) {
+        const sections = [];
+        // Header with member identity
+        sections.push(`# ${member.name}`);
+        sections.push(`Role: ${member.role}`);
+        sections.push('');
+        // Get role base prompt
+        const rolePrompt = await this.getRoleBasePrompt(member.role);
+        if (rolePrompt) {
+            sections.push('## Role Instructions');
+            sections.push('');
+            sections.push(rolePrompt);
+            sections.push('');
+        }
+        // Get skill instructions for member's skills
+        // Skills come from: role's assignedSkills + member's skillOverrides - member's excludedRoleSkills
+        const memberSkills = await this.getMemberSkills(member);
+        if (memberSkills.length > 0) {
+            sections.push('## Assigned Skills');
+            sections.push('');
+            for (const skillId of memberSkills) {
+                const skillInstructions = await this.getSkillInstructions(skillId);
+                if (skillInstructions) {
+                    sections.push(`### Skill: ${skillId}`);
+                    sections.push('');
+                    sections.push(skillInstructions);
+                    sections.push('');
+                }
+            }
+        }
+        // Add context reminder footer
+        const promptPath = this.storageService.getMemberPromptPath(teamId, member.id);
+        sections.push('---');
+        sections.push('');
+        sections.push('## Context Reminder');
+        sections.push('');
+        sections.push(`If you lose context about who you are, read this file: \`${promptPath}\``);
+        sections.push('');
+        const prompt = sections.join('\n');
+        this.logger.info('Generated member prompt', {
+            memberId: member.id,
+            memberName: member.name,
+            role: member.role,
+            skillCount: memberSkills.length,
+            promptLength: prompt.length,
+        });
+        return prompt;
+    }
+    /**
+     * Generate and save a prompt for a team member.
+     *
+     * @param member - The team member
+     * @param teamId - The team ID
+     * @returns The generated prompt content
+     */
+    async generateAndSaveMemberPrompt(member, teamId) {
+        const prompt = await this.generateMemberPrompt(member, teamId);
+        await this.storageService.saveMemberPrompt(teamId, member.id, prompt);
+        return prompt;
+    }
+    /**
+     * Regenerate prompts for all members of a team.
+     *
+     * @param team - The team
+     */
+    async regenerateTeamPrompts(team) {
+        this.logger.info('Regenerating prompts for team', {
+            teamId: team.id,
+            teamName: team.name,
+            memberCount: team.members?.length || 0,
+        });
+        for (const member of team.members || []) {
+            await this.generateAndSaveMemberPrompt(member, team.id);
+        }
+    }
+    /**
+     * Get the effective skills for a team member.
+     * Combines role's assigned skills with member's skillOverrides,
+     * minus any excludedRoleSkills.
+     *
+     * @param member - The team member
+     * @returns Array of skill IDs
+     */
+    async getMemberSkills(member) {
+        const roleSkills = await this.getRoleAssignedSkills(member.role);
+        const skillOverrides = member.skillOverrides || [];
+        const excludedSkills = member.excludedRoleSkills || [];
+        // Combine role skills and overrides, then remove excluded
+        const allSkills = new Set([...roleSkills, ...skillOverrides]);
+        for (const excluded of excludedSkills) {
+            allSkills.delete(excluded);
+        }
+        return Array.from(allSkills);
+    }
+    /**
+     * Get the assigned skills for a role from config/roles/{role}/role.json
+     *
+     * @param role - The role name
+     * @returns Array of skill IDs assigned to the role
+     */
+    async getRoleAssignedSkills(role) {
+        // Try config/roles/{role}/role.json
+        const rolePath = path.join(this.configDir, 'roles', role, 'role.json');
+        if (existsSync(rolePath)) {
+            try {
+                const content = await fs.readFile(rolePath, 'utf-8');
+                const roleConfig = JSON.parse(content);
+                return roleConfig.assignedSkills || [];
+            }
+            catch (error) {
+                this.logger.warn('Error reading role config', { role, error });
+            }
+        }
+        // Fallback: try user override in ~/.crewly/roles/{role}/role.json
+        const userRolePath = path.join(this.crewlyHome, 'roles', role, 'role.json');
+        if (existsSync(userRolePath)) {
+            try {
+                const content = await fs.readFile(userRolePath, 'utf-8');
+                const roleConfig = JSON.parse(content);
+                return roleConfig.assignedSkills || [];
+            }
+            catch (error) {
+                this.logger.warn('Error reading user role config', { role, error });
+            }
+        }
+        return [];
+    }
+    /**
+     * Get the base prompt for a role from config/roles/{role}/prompt.md
+     *
+     * @param role - The role name
+     * @returns The role prompt content or null if not found
+     */
+    async getRoleBasePrompt(role) {
+        // Try config/roles/{role}/prompt.md
+        const rolePath = path.join(this.configDir, 'roles', role, 'prompt.md');
+        if (existsSync(rolePath)) {
+            try {
+                return await fs.readFile(rolePath, 'utf-8');
+            }
+            catch (error) {
+                this.logger.warn('Error reading role prompt', { role, error });
+            }
+        }
+        // Fallback: try user override in ~/.crewly/roles/{role}/prompt.md
+        const userRolePath = path.join(this.crewlyHome, 'roles', role, 'prompt.md');
+        if (existsSync(userRolePath)) {
+            try {
+                return await fs.readFile(userRolePath, 'utf-8');
+            }
+            catch (error) {
+                this.logger.warn('Error reading user role prompt', { role, error });
+            }
+        }
+        this.logger.debug('No role prompt found', { role });
+        return null;
+    }
+    /**
+     * Get the instructions for a skill from config/skills/{skill}/instructions.md
+     *
+     * @param skillId - The skill ID (can include category, e.g., "mcp/chrome-browser")
+     * @returns The skill instructions content or null if not found
+     */
+    async getSkillInstructions(skillId) {
+        // Try config/skills/{skillId}/instructions.md
+        const skillPath = path.join(this.configDir, 'skills', skillId, 'instructions.md');
+        if (existsSync(skillPath)) {
+            try {
+                return await fs.readFile(skillPath, 'utf-8');
+            }
+            catch (error) {
+                this.logger.warn('Error reading skill instructions', { skillId, error });
+            }
+        }
+        // Fallback: try user override in ~/.crewly/skills/{skillId}/instructions.md
+        const userSkillPath = path.join(this.crewlyHome, 'skills', skillId, 'instructions.md');
+        if (existsSync(userSkillPath)) {
+            try {
+                return await fs.readFile(userSkillPath, 'utf-8');
+            }
+            catch (error) {
+                this.logger.warn('Error reading user skill instructions', { skillId, error });
+            }
+        }
+        this.logger.debug('No skill instructions found', { skillId });
+        return null;
+    }
+    /**
+     * Build a context prefix to prepend to messages sent to agents.
+     * This helps agents remember their identity when context is compressed.
+     *
+     * @param member - The team member
+     * @param teamId - The team ID
+     * @param teamName - The team name
+     * @returns The context prefix string
+     */
+    buildContextPrefix(member, teamId, teamName) {
+        const promptPath = this.storageService.getMemberPromptPath(teamId, member.id);
+        return `<CONTEXT>
+You are: ${member.name} (${member.role})
+Team: ${teamName}
+Prompt file: ${promptPath}
+Read this file if you need to remember your instructions.
+</CONTEXT>
+
+`;
+    }
+    /**
+     * Build a context prefix for the orchestrator.
+     *
+     * @returns The context prefix string
+     */
+    buildOrchestratorContextPrefix() {
+        const promptPath = this.storageService.getOrchestratorPromptPath();
+        return `<CONTEXT>
+You are: Crewly Orchestrator
+Prompt file: ${promptPath}
+Read this file if you need to remember your instructions.
+</CONTEXT>
+
+`;
+    }
+}
+// Export singleton getter
+export const getPromptGeneratorService = () => {
+    return PromptGeneratorService.getInstance();
+};
+//# sourceMappingURL=prompt-generator.service.js.map

package/dist/backend/backend/src/services/prompt/prompt-generator.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-generator.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/prompt/prompt-generator.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAmB,MAAM,2BAA2B,CAAC;AAG3E;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACzB,MAAM,CAAC,QAAQ,GAAkC,IAAI,CAAC;IACtD,cAAc,CAAiB;IAC/B,MAAM,CAAkB;IACxB,SAAS,CAAS;IAClB,UAAU,CAAS;IAE3B;QACE,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;QACnD,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,wBAAwB,CAAC,CAAC;QAC1F,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,CAAC;YACrC,sBAAsB,CAAC,QAAQ,GAAG,IAAI,sBAAsB,EAAE,CAAC;QACjE,CAAC;QACD,OAAO,sBAAsB,CAAC,QAAQ,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,sBAAsB,CAAC,QAAQ,GAAG,IAAI,CAAC;IACzC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,oBAAoB,CAAC,MAAkB,EAAE,MAAc;QAC3D,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,8BAA8B;QAC9B,QAAQ,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAElB,uBAAuB;QACvB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,UAAU,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;QAED,6CAA6C;QAC7C,kGAAkG;QAClG,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAElB,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;gBACnC,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;gBACnE,IAAI,iBAAiB,EAAE,CAAC;oBACtB,QAAQ,CAAC,IAAI,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;oBACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAClB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;oBACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9E,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,4DAA4D,UAAU,IAAI,CAAC,CAAC;QAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAElB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE;YAC1C,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,YAAY,CAAC,MAAM;YAC/B,YAAY,EAAE,MAAM,CAAC,MAAM;SAC5B,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,2BAA2B,CAAC,MAAkB,EAAE,MAAc;QAClE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/D,MAAM,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,qBAAqB,CAAC,IAAU;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE;YAChD,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;SACvC,CAAC,CAAC;QAEH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CAAC,MAAkB;QACtC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;QACnD,MAAM,cAAc,GAAG,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC;QAEvD,0DAA0D;QAC1D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;QAC9D,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;YACtC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,qBAAqB,CAAC,IAAY;QACtC,oCAAoC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACvE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACrD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvC,OAAO,UAAU,CAAC,cAAc,IAAI,EAAE,CAAC;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,kEAAkE;QAClE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAC5E,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACzD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvC,OAAO,UAAU,CAAC,cAAc,IAAI,EAAE,CAAC;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CAAC,IAAY;QAClC,oCAAoC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACvE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,kEAAkE;QAClE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAC5E,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,oBAAoB,CAAC,OAAe;QACxC,8CAA8C;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAClF,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;QACvF,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,kBAAkB,CAAC,MAAkB,EAAE,MAAc,EAAE,QAAgB;QACrE,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAE9E,OAAO;WACA,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAC9B,QAAQ;eACD,UAAU;;;;CAIxB,CAAC;IACA,CAAC;IAED;;;;OAIG;IACH,8BAA8B;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,yBAAyB,EAAE,CAAC;QAEnE,OAAO;;eAEI,UAAU;;;;CAIxB,CAAC;IACA,CAAC;;AAGH,0BAA0B;AAC1B,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAA2B,EAAE;IACpE,OAAO,sBAAsB,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC,CAAC"}

package/dist/backend/backend/src/services/quality/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Quality Gate Services
+ *
+ * Services for running quality gates to validate code quality
+ * before task completion.
+ *
+ * @module services/quality
+ */
+export { QualityGateService, type IQualityGateService, type RunOptions, } from './quality-gate.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/services/quality/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/quality/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,UAAU,GAChB,MAAM,2BAA2B,CAAC"}

package/dist/backend/backend/src/services/quality/index.js

@@ -0,0 +1,10 @@
+/**
+ * Quality Gate Services
+ *
+ * Services for running quality gates to validate code quality
+ * before task completion.
+ *
+ * @module services/quality
+ */
+export { QualityGateService, } from './quality-gate.service.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/services/quality/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../backend/src/services/quality/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,GAGnB,MAAM,2BAA2B,CAAC"}

package/dist/backend/backend/src/services/quality/quality-gate.service.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Quality Gate Service
+ *
+ * Executes quality gates (typecheck, tests, build, lint) to verify
+ * code quality before task completion.
+ *
+ * @module services/quality/quality-gate.service
+ */
+import { QualityGate, GateConfig, GateResult, GateRunResults } from '../../types/quality-gate.types.js';
+/**
+ * Options for running gates
+ */
+export interface RunOptions {
+    /** Run only specific gates by name */
+    gateNames?: string[];
+    /** Skip optional gates */
+    skipOptional?: boolean;
+    /** Override parallel execution setting */
+    parallel?: boolean;
+    /** Override overall timeout */
+    timeout?: number;
+}
+/**
+ * Interface for the QualityGateService
+ */
+export interface IQualityGateService {
+    /**
+     * Load gate configuration from project or use defaults
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate configuration
+     */
+    loadConfig(projectPath: string): Promise<GateConfig>;
+    /**
+     * Run all gates according to configuration
+     *
+     * @param projectPath - Path to project directory
+     * @param options - Run options
+     * @returns Complete run results
+     */
+    runAllGates(projectPath: string, options?: RunOptions): Promise<GateRunResults>;
+    /**
+     * Run a single gate
+     *
+     * @param gate - Gate definition
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    runGate(gate: QualityGate, projectPath: string): Promise<GateResult>;
+    /**
+     * Run typecheck gate
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    runTypecheck(projectPath: string): Promise<GateResult>;
+    /**
+     * Run tests gate
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    runTests(projectPath: string): Promise<GateResult>;
+    /**
+     * Run lint gate
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    runLint(projectPath: string): Promise<GateResult>;
+    /**
+     * Run build gate
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    runBuild(projectPath: string): Promise<GateResult>;
+    /**
+     * Get the default gate configuration
+     *
+     * @returns Default gate config
+     */
+    getDefaultConfig(): GateConfig;
+    /**
+     * Check if project has custom gate configuration
+     *
+     * @param projectPath - Path to project directory
+     * @returns True if custom config exists
+     */
+    hasProjectConfig(projectPath: string): Promise<boolean>;
+}
+/**
+ * Service for running quality gates on code changes
+ *
+ * @example
+ * ```typescript
+ * const service = QualityGateService.getInstance();
+ * const results = await service.runAllGates('/path/to/project');
+ * if (results.allRequiredPassed) {
+ *   console.log('All gates passed!');
+ * }
+ * ```
+ */
+export declare class QualityGateService implements IQualityGateService {
+    private static instance;
+    private readonly logger;
+    /**
+     * Private constructor for singleton pattern
+     */
+    private constructor();
+    /**
+     * Gets the singleton instance
+     *
+     * @returns The QualityGateService instance
+     */
+    static getInstance(): QualityGateService;
+    /**
+     * Clears the singleton instance (for testing)
+     */
+    static clearInstance(): void;
+    /**
+     * Load gate configuration from project or use defaults
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate configuration
+     */
+    loadConfig(projectPath: string): Promise<GateConfig>;
+    /**
+     * Run all gates according to configuration
+     *
+     * @param projectPath - Path to project directory
+     * @param options - Run options
+     * @returns Complete run results
+     */
+    runAllGates(projectPath: string, options?: RunOptions): Promise<GateRunResults>;
+    /**
+     * Run a single gate
+     *
+     * @param gate - Gate definition
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    runGate(gate: QualityGate, projectPath: string): Promise<GateResult>;
+    /**
+     * Run typecheck gate with default settings
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    runTypecheck(projectPath: string): Promise<GateResult>;
+    /**
+     * Run tests gate with default settings
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    runTests(projectPath: string): Promise<GateResult>;
+    /**
+     * Run lint gate with default settings
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    runLint(projectPath: string): Promise<GateResult>;
+    /**
+     * Run build gate with default settings
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    runBuild(projectPath: string): Promise<GateResult>;
+    /**
+     * Get the default gate configuration
+     *
+     * @returns Default gate config
+     */
+    getDefaultConfig(): GateConfig;
+    /**
+     * Check if project has custom gate configuration
+     *
+     * @param projectPath - Path to project directory
+     * @returns True if custom config exists
+     */
+    hasProjectConfig(projectPath: string): Promise<boolean>;
+    /**
+     * Check if a gate should run based on branch patterns
+     *
+     * @param gate - Gate definition
+     * @param currentBranch - Current git branch name
+     * @returns Whether the gate should run
+     */
+    shouldRunGate(gate: QualityGate, currentBranch: string): boolean;
+    /**
+     * Get the current git branch
+     *
+     * @param projectPath - Path to project directory
+     * @returns Current branch name or 'unknown'
+     */
+    private getCurrentBranch;
+    /**
+     * Truncate output to maximum length
+     *
+     * @param output - Output to truncate
+     * @param maxLength - Maximum length (default: MAX_GATE_OUTPUT_LENGTH)
+     * @returns Truncated output
+     */
+    private truncateOutput;
+    /**
+     * Validate and normalize gate configuration
+     *
+     * @param config - Raw configuration from YAML
+     * @returns Normalized gate configuration
+     */
+    private validateConfig;
+    /**
+     * Calculate summary statistics from results
+     *
+     * @param results - Array of gate results
+     * @returns Summary statistics
+     */
+    private calculateSummary;
+}
+//# sourceMappingURL=quality-gate.service.d.ts.map

package/dist/backend/backend/src/services/quality/quality-gate.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-gate.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/quality/quality-gate.service.ts"],"names":[],"mappings":"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"}