crewly 1.4.40 → 1.4.41

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

@@ -0,0 +1,61 @@
+/**
+ * Recovery module — unified session recovery protocol.
+ *
+ * Consolidates the restart/recovery flow that was previously scattered
+ * across prompt-builder.service.ts buildSessionRecoverySection(),
+ * agent-registration.service.ts hardcoded commands, role prompts
+ * (Session Recovery Protocol), and session-handoff.service.ts.
+ *
+ * Produces the mandatory startup sequence: recall → get-my-context → assess.
+ * This module is non-compactable because skipping recovery causes
+ * duplicate work and lost context.
+ *
+ * Sources: Path A Step 9, prompt-builder buildSessionRecoverySection(),
+ *          developer/prompt.md §Session Recovery Protocol.
+ */
+export class RecoveryModule {
+    name = 'recovery';
+    priority = 2;
+    maxTokens = 600;
+    compactable = false;
+    /**
+     * Always included — every agent needs session recovery.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the session recovery protocol with executable bash commands.
+     *
+     * @param config - Module configuration with agent identity
+     * @returns Formatted markdown recovery section
+     */
+    async build(config) {
+        const agentId = config.sessionName;
+        const role = config.role;
+        const projectPath = config.projectPath || config.projectRoot;
+        const skillsPath = config.agentSkillsPath;
+        return `## Session Recovery Protocol (MANDATORY)
+
+**IMMEDIATELY after registering**, you MUST execute the following context recovery steps before saying "Ready" or accepting any tasks. This ensures you recover context from previous sessions and avoid repeating work or missing ongoing tasks.
+
+### Step 1: Recall previous knowledge
+\`\`\`bash
+bash ${skillsPath}/core/recall/execute.sh '{"agentId":"${agentId}","context":"${role} session startup, recent tasks, unfinished work, blockers, key decisions","projectPath":"${projectPath}"}'
+\`\`\`
+
+### Step 2: Load your full context
+\`\`\`bash
+bash ${skillsPath}/core/get-my-context/execute.sh '{"agentId":"${agentId}","agentRole":"${role}","projectPath":"${projectPath}"}'
+\`\`\`
+
+### Step 3: Assess and report
+After reviewing the results from Steps 1 and 2:
+1. **Check for unfinished work** — If you find tasks that were in progress but not completed, note them
+2. **Check for pending blockers** — If previous sessions recorded blockers, note them
+3. **Report status** — Include a brief summary of recovered context in your first status message
+
+**Do NOT skip these steps.** Context recovery prevents duplicate work and ensures continuity across sessions.`;
+    }
+}
+//# sourceMappingURL=recovery.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/recovery.module.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,cAAc;IAC1B,IAAI,GAAG,UAAU,CAAC;IAClB,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,KAAK,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC;QAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;QAE1C,OAAO;;;;;;OAMF,UAAU,wCAAwC,OAAO,gBAAgB,IAAI,4FAA4F,WAAW;;;;;OAKpL,UAAU,gDAAgD,OAAO,kBAAkB,IAAI,oBAAoB,WAAW;;;;;;;;;8GASf,CAAC;IAC9G,CAAC;CACD"}

package/dist/backend/backend/src/services/ai/prompt-modules/scheduled-messages.loader.d.ts

@@ -0,0 +1,55 @@
+import { ContextLoaderConfig } from './context-assembly.service.js';
+/**
+ * Scheduled messages context loader — loads agent's scheduled checks/messages state.
+ *
+ * This is a context module (dynamic data), registered with ContextAssemblyService
+ * rather than PromptAssemblyService. It loads the current scheduled checks and
+ * messages for the agent so they have awareness of pending/recurring tasks.
+ *
+ * Token budget: 0-500
+ *
+ * Sources: SchedulerService recurring/one-time checks.
+ */
+/**
+ * Scheduled check data shape for the loader (minimal subset of ScheduledCheck).
+ */
+export interface ScheduledCheckInfo {
+    /** Unique check ID */
+    id: string;
+    /** Target session name */
+    targetSession: string;
+    /** Message content */
+    message: string;
+    /** Next scheduled execution time (ISO string) */
+    scheduledFor: string;
+    /** Interval in minutes for recurring checks */
+    intervalMinutes?: number;
+    /** Whether this check repeats */
+    isRecurring: boolean;
+    /** Human-readable label */
+    label?: string;
+}
+/**
+ * Provider function type that retrieves scheduled checks for an agent.
+ * This allows the loader to be decoupled from the SchedulerService directly.
+ */
+export type ScheduledChecksProvider = (agentId: string) => ScheduledCheckInfo[];
+/**
+ * Create a scheduled messages context loader function.
+ *
+ * The loader is created with a provider function that retrieves the current
+ * scheduled checks. This allows dependency injection and easy testing.
+ *
+ * @param getChecks - Provider function that returns scheduled checks for an agent
+ * @returns Context loader function compatible with ContextAssemblyService
+ *
+ * @example
+ * ```typescript
+ * const loader = createScheduledMessagesLoader((agentId) => {
+ *   return schedulerService.getChecksForAgent(agentId);
+ * });
+ * contextAssembly.registerLoader('scheduled_messages', loader);
+ * ```
+ */
+export declare function createScheduledMessagesLoader(getChecks: ScheduledChecksProvider): (config: ContextLoaderConfig) => Promise<string>;
+//# sourceMappingURL=scheduled-messages.loader.d.ts.map

package/dist/backend/backend/src/services/ai/prompt-modules/scheduled-messages.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-messages.loader.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/scheduled-messages.loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,kBAAkB,EAAE,CAAC;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAC5C,SAAS,EAAE,uBAAuB,GAChC,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CA6ClD"}

package/dist/backend/backend/src/services/ai/prompt-modules/scheduled-messages.loader.js

@@ -0,0 +1,96 @@
+/**
+ * Create a scheduled messages context loader function.
+ *
+ * The loader is created with a provider function that retrieves the current
+ * scheduled checks. This allows dependency injection and easy testing.
+ *
+ * @param getChecks - Provider function that returns scheduled checks for an agent
+ * @returns Context loader function compatible with ContextAssemblyService
+ *
+ * @example
+ * ```typescript
+ * const loader = createScheduledMessagesLoader((agentId) => {
+ *   return schedulerService.getChecksForAgent(agentId);
+ * });
+ * contextAssembly.registerLoader('scheduled_messages', loader);
+ * ```
+ */
+export function createScheduledMessagesLoader(getChecks) {
+    return async (config) => {
+        const checks = getChecks(config.agentId);
+        if (!checks || checks.length === 0) {
+            return '';
+        }
+        const recurring = checks.filter((c) => c.isRecurring);
+        const oneTime = checks.filter((c) => !c.isRecurring);
+        const lines = ['## Scheduled Messages'];
+        if (recurring.length > 0) {
+            lines.push('');
+            lines.push('### Recurring Checks');
+            lines.push('| Label | Interval | Next Run | Message |');
+            lines.push('|-------|----------|----------|---------|');
+            for (const check of recurring) {
+                const label = check.label || check.id;
+                const interval = check.intervalMinutes ? `${check.intervalMinutes}m` : 'N/A';
+                const nextRun = formatTime(check.scheduledFor);
+                const message = truncateMessage(check.message);
+                lines.push(`| ${label} | ${interval} | ${nextRun} | ${message} |`);
+            }
+        }
+        if (oneTime.length > 0) {
+            lines.push('');
+            lines.push('### One-Time Checks');
+            lines.push('| Label | Scheduled For | Message |');
+            lines.push('|-------|---------------|---------|');
+            for (const check of oneTime) {
+                const label = check.label || check.id;
+                const scheduledFor = formatTime(check.scheduledFor);
+                const message = truncateMessage(check.message);
+                lines.push(`| ${label} | ${scheduledFor} | ${message} |`);
+            }
+        }
+        lines.push('');
+        lines.push(`_Total: ${checks.length} scheduled (${recurring.length} recurring, ${oneTime.length} one-time)_`);
+        return lines.join('\n');
+    };
+}
+/**
+ * Format an ISO timestamp to a short human-readable time.
+ *
+ * @param isoString - ISO 8601 timestamp
+ * @returns Formatted time string (e.g., "14:30" or "Mar 19 14:30")
+ */
+function formatTime(isoString) {
+    try {
+        const date = new Date(isoString);
+        const now = new Date();
+        const isToday = date.getFullYear() === now.getFullYear() &&
+            date.getMonth() === now.getMonth() &&
+            date.getDate() === now.getDate();
+        if (isToday) {
+            return date.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: false });
+        }
+        return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' }) +
+            ' ' +
+            date.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: false });
+    }
+    catch {
+        return isoString;
+    }
+}
+/**
+ * Truncate a message for table display.
+ *
+ * @param message - Full message string
+ * @param maxLength - Maximum length before truncation
+ * @returns Truncated message
+ */
+function truncateMessage(message, maxLength = 60) {
+    if (!message)
+        return '';
+    const singleLine = message.replace(/\n/g, ' ').trim();
+    if (singleLine.length <= maxLength)
+        return singleLine;
+    return singleLine.substring(0, maxLength - 3) + '...';
+}
+//# sourceMappingURL=scheduled-messages.loader.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/scheduled-messages.loader.js.map

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

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

@@ -0,0 +1,28 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * 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 declare class SkillsReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — agents need to know how to use skills.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * 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
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=skills-reference.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,IAAI,SAAuB;IAC3B,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;CAqClD"}

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