crewly 1.4.39 → 1.4.41

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.js

@@ -0,0 +1,65 @@
+/**
+ * Skills reference module — tells the agent how to discover and use skills.
+ *
+ * Consolidates skill authorization, communication skill references,
+ * and catalog location into a single module.
+ *
+ * Sources: Path A Step 1+6, Path B Section 8, Path C skill instructions.
+ */
+export class SkillsReferenceModule {
+    name = 'skills_references';
+    priority = 5;
+    maxTokens = 500;
+    compactable = true;
+    /**
+     * Always included — agents need to know how to use skills.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the skills reference section with catalog location,
+     * commonly-used skills, and memory tool instructions.
+     *
+     * @param config - Module configuration with skill paths
+     * @returns Formatted markdown skills reference section
+     */
+    async build(config) {
+        return `## Available Skills
+
+Bash skills at \`${config.agentSkillsPath}/\`:
+- \`core/recall\` — retrieve relevant knowledge from memory
+- \`core/remember\` — store knowledge for future reference
+- \`core/record-learning\` — record learnings while working
+- \`core/report-status\` — report status to orchestrator
+- \`core/send-message\` — communicate with other agents
+- \`core/get-sops\` — request relevant SOPs for current situation
+
+Skills catalog: \`~/.crewly/skills/AGENT_SKILLS_CATALOG.md\`
+
+## Authorized Operations
+
+The following operations are pre-approved for this session:
+- Execute bash scripts in \`${config.agentSkillsPath}/\` and \`${config.tlSkillsPath}/\`
+- Read and write files within the project directory
+- Use browser automation skills when available (e.g., remote-browser)
+
+## Communication
+
+Use bash skills at \`${config.agentSkillsPath}/\` for all team communication. Read \`~/.crewly/skills/AGENT_SKILLS_CATALOG.md\` for a full reference.
+- \`send-message\` to communicate with other agents
+- \`report-progress\` to update on task status
+- \`remember\` to store important learnings (always pass your \`agentId\` and \`projectPath\`)
+- \`recall\` to retrieve relevant knowledge (always pass your \`agentId\` and \`projectPath\`)
+- \`record-learning\` to record learnings (always pass your \`agentId\` and \`projectPath\`)
+- \`get-sops\` to request relevant SOPs for your current situation
+
+**IMPORTANT for memory tools:** When calling \`remember\`, \`recall\`, or \`record-learning\`, you MUST pass:
+- \`agentId\`: Your **Session Name** from the Identity section above
+- \`projectPath\`: Your **Project Path** from the Identity section above
+This ensures your knowledge is stored under your identity and in the correct project.
+
+**IMPORTANT for recall:** Before answering questions about the project, deployment, architecture, or past decisions, ALWAYS call \`recall\` first to check your stored knowledge.`;
+    }
+}
+//# sourceMappingURL=skills-reference.module.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IACjC,IAAI,GAAG,mBAAmB,CAAC;IAC3B,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,OAAO;;mBAEU,MAAM,CAAC,eAAe;;;;;;;;;;;;;8BAaX,MAAM,CAAC,eAAe,aAAa,MAAM,CAAC,YAAY;;;;;;uBAM7D,MAAM,CAAC,eAAe;;;;;;;;;;;;;kLAaqI,CAAC;IAClL,CAAC;CACD"}

package/dist/backend/backend/src/services/ai/prompt-modules/soul.module.d.ts

@@ -0,0 +1,60 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Soul module — provides the agent's personality, tone, and working style.
+ *
+ * Loads the agent's "soul" from the resolution chain:
+ * 1. Per-member soul (~/.crewly/teams/{teamId}/members/{memberId}/soul.md)
+ * 2. Role default soul (config/roles/{role}/soul.md)
+ * 3. Reusable archetype (config/souls/{archetype}.md)
+ * 4. Hardcoded minimal fallback
+ *
+ * Sources: Path A Step 5, Path B Section 9, Soul System Design (Section 6).
+ */
+export declare class SoulModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — every agent benefits from personality definition.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the soul section by resolving the soul file from the resolution chain.
+     *
+     * @param config - Module configuration with role and project details
+     * @returns Formatted markdown soul section
+     */
+    build(config: ModuleConfig): Promise<string>;
+    /**
+     * Resolve the soul content by checking each level of the resolution chain.
+     *
+     * @param config - Module configuration
+     * @returns Soul content string
+     */
+    private resolveSoul;
+    /**
+     * Get the path to a member's personal soul file.
+     *
+     * @param teamId - Team ID
+     * @param memberId - Member ID
+     * @returns Absolute path to the member soul file
+     */
+    private getMemberSoulPath;
+    /**
+     * Read a file if it exists, returning its content or null.
+     *
+     * @param filePath - Path to the file
+     * @returns File content string or null if not found
+     */
+    private readFileIfExists;
+    /**
+     * Format the soul content with a source annotation.
+     *
+     * @param content - Raw soul file content
+     * @param source - Where the soul was resolved from
+     * @returns Formatted soul section
+     */
+    private formatSoul;
+}
+//# sourceMappingURL=soul.module.d.ts.map

package/dist/backend/backend/src/services/ai/prompt-modules/soul.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soul.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/soul.module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAS1E;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,YAAW,YAAY;IAC9C,IAAI,SAAU;IACd,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;OAKG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlD;;;;;OAKG;YACW,WAAW;IAgCzB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;CAIlB"}

package/dist/backend/backend/src/services/ai/prompt-modules/soul.module.js

@@ -0,0 +1,112 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Default minimal soul fallback when no soul file is found.
+ */
+const DEFAULT_SOUL = `## Your Soul
+
+You are a professional, reliable team member. Communicate clearly, ask when uncertain, and report blockers promptly.`;
+/**
+ * Soul module — provides the agent's personality, tone, and working style.
+ *
+ * Loads the agent's "soul" from the resolution chain:
+ * 1. Per-member soul (~/.crewly/teams/{teamId}/members/{memberId}/soul.md)
+ * 2. Role default soul (config/roles/{role}/soul.md)
+ * 3. Reusable archetype (config/souls/{archetype}.md)
+ * 4. Hardcoded minimal fallback
+ *
+ * Sources: Path A Step 5, Path B Section 9, Soul System Design (Section 6).
+ */
+export class SoulModule {
+    name = 'soul';
+    priority = 2;
+    maxTokens = 830;
+    compactable = false;
+    /**
+     * Always included — every agent benefits from personality definition.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the soul section by resolving the soul file from the resolution chain.
+     *
+     * @param config - Module configuration with role and project details
+     * @returns Formatted markdown soul section
+     */
+    async build(config) {
+        const soul = await this.resolveSoul(config);
+        return soul;
+    }
+    /**
+     * Resolve the soul content by checking each level of the resolution chain.
+     *
+     * @param config - Module configuration
+     * @returns Soul content string
+     */
+    async resolveSoul(config) {
+        // 1. Per-member soul
+        if (config.teamId && config.memberId) {
+            const memberSoulPath = this.getMemberSoulPath(config.teamId, config.memberId);
+            const content = this.readFileIfExists(memberSoulPath);
+            if (content) {
+                return this.formatSoul(content, 'member');
+            }
+        }
+        // 2. Role default soul (config/roles/{role}/soul.md)
+        if (config.role) {
+            const roleSoulPath = path.join(config.projectRoot, 'config', 'roles', config.role, 'soul.md');
+            const content = this.readFileIfExists(roleSoulPath);
+            if (content) {
+                return this.formatSoul(content, 'role');
+            }
+        }
+        // 3. Reusable archetype (config/souls/{role}.md as fallback archetype)
+        if (config.role) {
+            const archetypePath = path.join(config.projectRoot, 'config', 'souls', `${config.role}.md`);
+            const content = this.readFileIfExists(archetypePath);
+            if (content) {
+                return this.formatSoul(content, 'archetype');
+            }
+        }
+        // 4. Hardcoded minimal fallback
+        return DEFAULT_SOUL;
+    }
+    /**
+     * Get the path to a member's personal soul file.
+     *
+     * @param teamId - Team ID
+     * @param memberId - Member ID
+     * @returns Absolute path to the member soul file
+     */
+    getMemberSoulPath(teamId, memberId) {
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '/tmp';
+        return path.join(homeDir, '.crewly', 'teams', teamId, 'members', memberId, 'soul.md');
+    }
+    /**
+     * Read a file if it exists, returning its content or null.
+     *
+     * @param filePath - Path to the file
+     * @returns File content string or null if not found
+     */
+    readFileIfExists(filePath) {
+        try {
+            return fs.readFileSync(filePath, 'utf-8').trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Format the soul content with a source annotation.
+     *
+     * @param content - Raw soul file content
+     * @param source - Where the soul was resolved from
+     * @returns Formatted soul section
+     */
+    formatSoul(content, source) {
+        const sourceLabel = source === 'member' ? 'personal' : source === 'role' ? 'role default' : 'archetype';
+        return `## Your Soul\n_Source: ${sourceLabel}_\n\n${content}`;
+    }
+}
+//# sourceMappingURL=soul.module.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/soul.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"soul.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/soul.module.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/ai/prompt-modules/team-reference.module.d.ts

@@ -0,0 +1,54 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Team reference module — provides team hierarchy, TL duties, and norms references.
+ *
+ * Wraps the existing `buildTeamLeadSection` and `buildTeamNormsSection` logic
+ * from PromptBuilderService. The TL addon is conditionally loaded only when
+ * the agent has `canDelegate=true` and subordinates.
+ *
+ * Sources: Path A Step 7, Path B Sections 4+5.
+ */
+export declare class TeamReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Include when agent has a team (teamId set) or has subordinates.
+     */
+    shouldInclude(config: ModuleConfig): boolean;
+    /**
+     * Build team reference section. Includes TL addon if agent can delegate,
+     * and team norms if available.
+     *
+     * @param config - Module configuration with team and subordinate details
+     * @returns Formatted markdown team reference section
+     */
+    build(config: ModuleConfig): Promise<string>;
+    /**
+     * Build Team Lead section by loading tl-addon.md and resolving variables.
+     * Falls back to inline section if addon file not found.
+     *
+     * @param config - Module configuration with subordinate details
+     * @returns Formatted TL section or empty string
+     */
+    private buildTeamLeadSection;
+    /**
+     * Build minimal inline TL section as fallback when tl-addon.md is not found.
+     *
+     * @param workerList - Pre-formatted worker list
+     * @param subordinateCount - Number of subordinates
+     * @returns Formatted inline TL section
+     */
+    private buildInlineTeamLeadSection;
+    /**
+     * Build team norms section by loading norms files from team directory.
+     * Only includes norms whose role list matches the agent's role or '*'.
+     *
+     * @param teamId - Team ID to load norms for
+     * @param role - Agent's role for filtering
+     * @returns Formatted norms markdown or empty string
+     */
+    private buildTeamNormsSection;
+}
+//# sourceMappingURL=team-reference.module.d.ts.map

package/dist/backend/backend/src/services/ai/prompt-modules/team-reference.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/team-reference.module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACvD,IAAI,SAAqB;IACzB,QAAQ,SAAK;IACb,SAAS,SAAQ;IACjB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAI5C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBlD;;;;;;OAMG;YACW,oBAAoB;IAoClC;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IAgBlC;;;;;;;OAOG;YACW,qBAAqB;CAmCnC"}

package/dist/backend/backend/src/services/ai/prompt-modules/team-reference.module.js

@@ -0,0 +1,149 @@
+import { readFile, access } from 'fs/promises';
+import * as path from 'path';
+/**
+ * Team reference module — provides team hierarchy, TL duties, and norms references.
+ *
+ * Wraps the existing `buildTeamLeadSection` and `buildTeamNormsSection` logic
+ * from PromptBuilderService. The TL addon is conditionally loaded only when
+ * the agent has `canDelegate=true` and subordinates.
+ *
+ * Sources: Path A Step 7, Path B Sections 4+5.
+ */
+export class TeamReferenceModule {
+    name = 'team_references';
+    priority = 6;
+    maxTokens = 8000;
+    compactable = false; // TL core is not compactable
+    /**
+     * Include when agent has a team (teamId set) or has subordinates.
+     */
+    shouldInclude(config) {
+        return !!(config.teamId || (config.canDelegate && config.subordinates && config.subordinates.length > 0));
+    }
+    /**
+     * Build team reference section. Includes TL addon if agent can delegate,
+     * and team norms if available.
+     *
+     * @param config - Module configuration with team and subordinate details
+     * @returns Formatted markdown team reference section
+     */
+    async build(config) {
+        const sections = [];
+        // Build TL section if agent can delegate
+        if (config.canDelegate && config.subordinates && config.subordinates.length > 0) {
+            const tlSection = await this.buildTeamLeadSection(config);
+            if (tlSection) {
+                sections.push(tlSection);
+            }
+        }
+        // Build team norms section if team exists
+        if (config.teamId) {
+            const normsSection = await this.buildTeamNormsSection(config.teamId, config.role);
+            if (normsSection) {
+                sections.push(normsSection);
+            }
+        }
+        return sections.join('\n\n---\n\n');
+    }
+    /**
+     * Build Team Lead section by loading tl-addon.md and resolving variables.
+     * Falls back to inline section if addon file not found.
+     *
+     * @param config - Module configuration with subordinate details
+     * @returns Formatted TL section or empty string
+     */
+    async buildTeamLeadSection(config) {
+        if (!config.subordinates || config.subordinates.length === 0) {
+            return '';
+        }
+        const workerList = config.subordinates
+            .map((sub) => `- **${sub.name}** (session: \`${sub.sessionName}\`, memberId: \`${sub.memberId}\`) — ${sub.role}`)
+            .join('\n');
+        // Try loading the comprehensive TL addon from file
+        const addonPath = path.join(config.projectRoot, 'config', 'roles', 'team-leader', 'tl-addon.md');
+        try {
+            await access(addonPath);
+            let addonContent = await readFile(addonPath, 'utf8');
+            // Resolve template variables
+            const variables = {
+                WORKER_LIST: workerList,
+                TL_SKILLS_PATH: config.tlSkillsPath,
+                TEAM_ID: config.teamId || '',
+                MEMBER_ID: config.memberId || '',
+                PROJECT_PATH: config.projectPath || '',
+                AGENT_SKILLS_PATH: config.agentSkillsPath,
+            };
+            for (const [key, value] of Object.entries(variables)) {
+                addonContent = addonContent.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value);
+            }
+            return addonContent.trim();
+        }
+        catch {
+            // Fallback to minimal inline section
+            return this.buildInlineTeamLeadSection(workerList, config.subordinates.length);
+        }
+    }
+    /**
+     * Build minimal inline TL section as fallback when tl-addon.md is not found.
+     *
+     * @param workerList - Pre-formatted worker list
+     * @param subordinateCount - Number of subordinates
+     * @returns Formatted inline TL section
+     */
+    buildInlineTeamLeadSection(workerList, subordinateCount) {
+        return `## Team Lead Responsibilities
+
+You manage ${subordinateCount} subordinate(s):
+
+${workerList}
+
+### Your TL Duties
+
+1. **Task Decomposition** — Break down large tasks into actionable sub-tasks
+2. **Delegation** — Assign sub-tasks to subordinates using \`send-message\`
+3. **Quality Review** — Review subordinates' work before reporting completion
+4. **Progress Reporting** — Report progress to the orchestrator via \`report-status\`
+5. **Unblocking** — Help subordinates when they are stuck`;
+    }
+    /**
+     * Build team norms section by loading norms files from team directory.
+     * Only includes norms whose role list matches the agent's role or '*'.
+     *
+     * @param teamId - Team ID to load norms for
+     * @param role - Agent's role for filtering
+     * @returns Formatted norms markdown or empty string
+     */
+    async buildTeamNormsSection(teamId, role) {
+        if (!teamId)
+            return '';
+        try {
+            const { existsSync, readdirSync, readFileSync } = await import('fs');
+            const crewlyHome = path.join(process.env['HOME'] || '/tmp', '.crewly');
+            const normsDir = path.join(crewlyHome, 'teams', teamId, 'norms');
+            if (!existsSync(normsDir))
+                return '';
+            const normFiles = readdirSync(normsDir).filter((f) => f.endsWith('.md'));
+            if (normFiles.length === 0)
+                return '';
+            const normalizedRole = role.toLowerCase().replace(/\s+/g, '-');
+            const sections = ['## Team Norms'];
+            for (const file of normFiles) {
+                const content = readFileSync(path.join(normsDir, file), 'utf8');
+                // Check if norm applies to this role (roles: line at top)
+                const rolesMatch = content.match(/^roles:\s*(.+)$/m);
+                if (rolesMatch) {
+                    const roles = rolesMatch[1].split(',').map((r) => r.trim().toLowerCase());
+                    if (!roles.includes('*') && !roles.includes(normalizedRole)) {
+                        continue;
+                    }
+                }
+                sections.push(content.trim());
+            }
+            return sections.length > 1 ? sections.join('\n\n') : '';
+        }
+        catch {
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=team-reference.module.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/team-reference.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/team-reference.module.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/ai/prompt-modules/user-profile-reference.module.d.ts

@@ -0,0 +1,28 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * User profile reference module — tells the agent how to access user preferences.
+ *
+ * Provides instructions for language matching, communication style adaptation,
+ * and accessing stored user preferences via recall/remember skills.
+ *
+ * Sources: Path B Section 10 (language matching), new user prefs system.
+ */
+export declare class UserProfileReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — agents should know how to adapt to user preferences.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the user profile reference section with instructions
+     * on how to discover and adapt to user preferences.
+     *
+     * @param config - Module configuration with agent skill paths
+     * @returns Formatted markdown user profile reference section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=user-profile-reference.module.d.ts.map

package/dist/backend/backend/src/services/ai/prompt-modules/user-profile-reference.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/user-profile-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,0BAA2B,YAAW,YAAY;IAC9D,IAAI,SAA4B;IAChC,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAQ;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAyBlD"}

package/dist/backend/backend/src/services/ai/prompt-modules/user-profile-reference.module.js

@@ -0,0 +1,53 @@
+/**
+ * User profile reference module — tells the agent how to access user preferences.
+ *
+ * Provides instructions for language matching, communication style adaptation,
+ * and accessing stored user preferences via recall/remember skills.
+ *
+ * Sources: Path B Section 10 (language matching), new user prefs system.
+ */
+export class UserProfileReferenceModule {
+    name = 'user_profile_reference';
+    priority = 9;
+    maxTokens = 200;
+    compactable = true;
+    /**
+     * Always included — agents should know how to adapt to user preferences.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the user profile reference section with instructions
+     * on how to discover and adapt to user preferences.
+     *
+     * @param config - Module configuration with agent skill paths
+     * @returns Formatted markdown user profile reference section
+     */
+    async build(config) {
+        return `## User Preferences
+
+### Language Matching
+Match the user's language automatically:
+- If the user writes in Chinese, respond in Chinese
+- If the user writes in English, respond in English
+- For mixed-language messages, follow the dominant language
+
+### Accessing Preferences
+Use your memory tools to recall user-specific preferences:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/recall/execute.sh '{"agentId":"${config.sessionName}","context":"user preferences, communication style","projectPath":"${config.projectPath || ''}"}'
+\`\`\`
+
+When you discover a user preference (e.g., preferred detail level, communication style), store it:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/remember/execute.sh '{"agentId":"${config.sessionName}","content":"<preference>","category":"preference","scope":"agent","projectPath":"${config.projectPath || ''}"}'
+\`\`\`
+
+### Adaptation Rules
+- Adapt verbosity to user preference (concise vs detailed)
+- Mirror the user's formality level
+- Respect timezone and working hours when mentioned`;
+    }
+}
+//# sourceMappingURL=user-profile-reference.module.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/user-profile-reference.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/user-profile-reference.module.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,0BAA0B;IACtC,IAAI,GAAG,wBAAwB,CAAC;IAChC,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,OAAO;;;;;;;;;;;OAWF,MAAM,CAAC,eAAe,wCAAwC,MAAM,CAAC,WAAW,sEAAsE,MAAM,CAAC,WAAW,IAAI,EAAE;;;;;OAK9K,MAAM,CAAC,eAAe,0CAA0C,MAAM,CAAC,WAAW,qFAAqF,MAAM,CAAC,WAAW,IAAI,EAAE;;;;;;oDAMlJ,CAAC;IACpD,CAAC;CACD"}

package/dist/backend/backend/src/services/cloud/cloud-auth.middleware.d.ts

@@ -7,6 +7,16 @@
  * @module services/cloud/cloud-auth.middleware
  */
 import type { Request, Response, NextFunction } from 'express';
+/**
+ * Throttle interval for repeated warning logs (5 minutes).
+ * Prevents log flooding from high-frequency polling endpoints like /devices.
+ */
+export declare const WARN_THROTTLE_MS: number;
+/**
+ * Map tracking last warn timestamps by key (reason:path).
+ * Exported for testing purposes.
+ */
+export declare const _warnTimestamps: Map<string, number>;
 /**
  * Check whether the local Crewly instance is connected to CrewlyAI Cloud.
  *
@@ -33,6 +43,8 @@ export declare function requireCloudConnection(req: Request, res: Response, next
  *
  * The middleware first checks cloud connectivity, then verifies that the
  * current subscription tier meets or exceeds the required level.
+ * Warning logs are throttled to once per 5 minutes per path to prevent
+ * log flooding from high-frequency polling endpoints (#212).
  *
  * @param tier - Minimum required tier ('pro' or 'enterprise')
  * @returns Express middleware function

package/dist/backend/backend/src/services/cloud/cloud-auth.middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-auth.middleware.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-auth.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAe/D;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAU5F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAgCjH"}
+{"version":3,"file":"cloud-auth.middleware.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-auth.middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAQ/D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAgB,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAa,CAAC;AA2B9D;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAU5F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAsCjH"}