crewly 1.13.0 → 1.14.0

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

@@ -0,0 +1,229 @@
+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.
+ *
+ * Resolution chain (P0-1 Phase 2):
+ *   0. **TL overlay** — when `canDelegate=true`, layer the team-leader
+ *      archetype (`config/souls/team-leader.md`) as the primary soul and
+ *      append the agent's original-role soul as a Capability Specialty.
+ *      A per-member soul still wins over the overlay (explicit > default).
+ *   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/{role}.md)
+ *   4. Hardcoded minimal fallback
+ *
+ * Sources: Path A Step 5, Path B Section 9, Soul System Design (Section 6),
+ * P0-1 Team-Leader Soul spec.
+ */
+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.
+     * If self-improvement data exists, appends a Self-Awareness section.
+     *
+     * @param config - Module configuration with role and project details
+     * @returns Formatted markdown soul section
+     */
+    async build(config) {
+        const soul = await this.resolveSoul(config);
+        const selfAwareness = this.buildSelfAwareness(config.sessionName);
+        return selfAwareness ? `${soul}\n\n${selfAwareness}` : 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 (highest precedence — explicit override always wins,
+        //    even over the TL overlay below — same precedence rule as CSS specificity)
+        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. TL overlay (P0-1 Phase 2): when canDelegate=true, the team-leader
+        //    archetype becomes the primary soul, with the original role's soul
+        //    appended as a Capability Specialty. Falls through silently to the
+        //    legacy cascade if `config/souls/team-leader.md` is missing — this
+        //    is intentional so deployments without the markdown asset don't
+        //    regress (the team-leader.md file ships in P0-1 Phase 1, PR #414).
+        if (config.canDelegate === true) {
+            const tlPath = path.join(config.projectRoot, 'config', 'souls', 'team-leader.md');
+            const tlContent = this.readFileIfExists(tlPath);
+            if (tlContent) {
+                const specialty = this.resolveSpecialtySoul(config);
+                return this.formatTLOverlay(tlContent, specialty, config.role);
+            }
+        }
+        // 3. 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');
+            }
+        }
+        // 4. 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');
+            }
+        }
+        // 5. Hardcoded minimal fallback
+        return DEFAULT_SOUL;
+    }
+    /**
+     * Resolve the agent's specialty soul for the TL overlay layer.
+     *
+     * Reuses steps 3 & 4 of the legacy cascade (role default → archetype) but
+     * deliberately skips the per-member soul (already checked in step 1 above)
+     * and the team-leader archetype (which would cause infinite recursion when
+     * `role === 'team-leader'`).
+     *
+     * @param config - Module configuration
+     * @returns Specialty soul content, or null when no role-specific soul exists
+     *          OR when the role IS team-leader (no specialty to layer).
+     */
+    resolveSpecialtySoul(config) {
+        if (!config.role || config.role === 'team-leader')
+            return null;
+        const roleSoul = this.readFileIfExists(path.join(config.projectRoot, 'config', 'roles', config.role, 'soul.md'));
+        if (roleSoul)
+            return roleSoul;
+        return this.readFileIfExists(path.join(config.projectRoot, 'config', 'souls', `${config.role}.md`));
+    }
+    /**
+     * Format the TL overlay layout: team-leader archetype as the primary soul,
+     * with the original-role specialty appended as Capability Specialty.
+     *
+     * The Capability Specialty section is what the agent draws on when applying
+     * the Self-Implementation Exception Rule from `team-leader.md` (TL leans on
+     * IC instincts when self-implementing under specific conditions).
+     *
+     * @param tlContent - Raw team-leader.md content
+     * @param specialty - Specialty soul content (null when no role specialty exists)
+     * @param role - The agent's original role (used in the specialty header)
+     * @returns Formatted TL overlay markdown
+     */
+    formatTLOverlay(tlContent, specialty, role) {
+        const primary = `## Your Soul\n_Source: team-leader overlay (canDelegate=true)_\n\n${tlContent}`;
+        if (!specialty)
+            return primary;
+        const roleLabel = role ?? 'IC';
+        return (`${primary}\n\n` +
+            `## Capability Specialty\n` +
+            `_IC background as ${roleLabel} — apply when self-implementing per the Self-Implementation Exception Rule._\n\n` +
+            specialty);
+    }
+    /**
+     * 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}`;
+    }
+    /**
+     * Build the Self-Awareness section from self-improvement data.
+     * Reads growth areas, self-model (blind spots), and prediction calibration.
+     * Kept under ~200 tokens.
+     *
+     * @param sessionName - Agent session name
+     * @returns Self-awareness markdown section, or null if no data exists
+     */
+    buildSelfAwareness(sessionName) {
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '/tmp';
+        const agentDir = path.join(homeDir, '.crewly', 'agents', sessionName);
+        const lines = [];
+        // Growth areas — top 3
+        try {
+            const raw = fs.readFileSync(path.join(agentDir, 'growth-areas.json'), 'utf-8');
+            const data = JSON.parse(raw);
+            if (data.areas && data.areas.length > 0) {
+                const top3 = data.areas.slice(0, 3);
+                lines.push('**Growth Areas:**');
+                for (const area of top3) {
+                    lines.push(`- ${area.area} (${area.progress})`);
+                }
+            }
+        }
+        catch { /* no growth areas data */ }
+        // Blind spots — top 2
+        try {
+            const raw = fs.readFileSync(path.join(agentDir, 'self-model.json'), 'utf-8');
+            const data = JSON.parse(raw);
+            if (data.blindSpots && data.blindSpots.length > 0) {
+                const top2 = data.blindSpots.slice(0, 2);
+                lines.push('**Blind Spots:**');
+                for (const spot of top2) {
+                    lines.push(`- ${spot.description}`);
+                }
+            }
+        }
+        catch { /* no self-model data */ }
+        // Prediction calibration score
+        try {
+            const raw = fs.readFileSync(path.join(agentDir, 'predictions.json'), 'utf-8');
+            const data = JSON.parse(raw);
+            if (data.calibrationScore > 0) {
+                lines.push(`**Prediction Calibration:** ${Math.round(data.calibrationScore * 100)}%`);
+            }
+        }
+        catch { /* no predictions data */ }
+        if (lines.length === 0) {
+            return null;
+        }
+        return `## Self-Awareness\n${lines.join('\n')}`;
+    }
+}
+//# sourceMappingURL=soul.module.js.map

package/dist/cli/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":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B;;GAEG;AACH,MAAM,YAAY,GAAG;;qHAEgG,CAAC;AAEtH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,UAAU;IACtB,IAAI,GAAG,MAAM,CAAC;IACd,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;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAClE,OAAO,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,WAAW,CAAC,MAAoB;QAC7C,0EAA0E;QAC1E,+EAA+E;QAC/E,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;YACtD,IAAI,OAAO,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC3C,CAAC;QACF,CAAC;QAED,uEAAuE;QACvE,uEAAuE;QACvE,uEAAuE;QACvE,uEAAuE;QACvE,oEAAoE;QACpE,uEAAuE;QACvE,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;YAClF,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAChD,IAAI,SAAS,EAAE,CAAC;gBACf,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;gBACpD,OAAO,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAChE,CAAC;QACF,CAAC;QAED,qDAAqD;QACrD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC9F,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;YACpD,IAAI,OAAO,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACzC,CAAC;QACF,CAAC;QAED,uEAAuE;QACvE,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;YAC5F,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;YACrD,IAAI,OAAO,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC9C,CAAC;QACF,CAAC;QAED,gCAAgC;QAChC,OAAO,YAAY,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;OAWG;IACK,oBAAoB,CAAC,MAAoB;QAChD,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa;YAAE,OAAO,IAAI,CAAC;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CACxE,CAAC;QACF,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC,gBAAgB,CAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,CAAC,CACrE,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,eAAe,CAAC,SAAiB,EAAE,SAAwB,EAAE,IAAwB;QAC5F,MAAM,OAAO,GAAG,qEAAqE,SAAS,EAAE,CAAC;QACjG,IAAI,CAAC,SAAS;YAAE,OAAO,OAAO,CAAC;QAC/B,MAAM,SAAS,GAAG,IAAI,IAAI,IAAI,CAAC;QAC/B,OAAO,CACN,GAAG,OAAO,MAAM;YAChB,2BAA2B;YAC3B,qBAAqB,SAAS,kFAAkF;YAChH,SAAS,CACT,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,iBAAiB,CAAC,MAAc,EAAE,QAAgB;QACzD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;QACtE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACvF,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,QAAgB;QACxC,IAAI,CAAC;YACJ,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IAED;;;;;;OAMG;IACK,UAAU,CAAC,OAAe,EAAE,MAAuC;QAC1E,MAAM,WAAW,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC;QACxG,OAAO,0BAA0B,WAAW,QAAQ,OAAO,EAAE,CAAC;IAC/D,CAAC;IAED;;;;;;;OAOG;IACK,kBAAkB,CAAC,WAAmB;QAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEtE,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,uBAAuB;QACvB,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC,CAAC;YAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;gBAChC,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;oBACzB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACjD,CAAC;YACF,CAAC;QACF,CAAC;QAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;QAEtC,sBAAsB;QACtB,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC;YAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;gBAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;oBACzB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBACrC,CAAC;YACF,CAAC;QACF,CAAC;QAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;QAEpC,+BAA+B;QAC/B,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,OAAO,CAAC,CAAC;YAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,+BAA+B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACvF,CAAC;QACF,CAAC;QAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;QAErC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACjD,CAAC;CACD"}

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

@@ -0,0 +1,61 @@
+/**
+ * Team Norms Module
+ *
+ * Loads team-level norms/SOPs from the team's norms directory.
+ * These norms originate from template application — when a template
+ * is applied, its norms/*.md files are copied into the team directory.
+ *
+ * Priority 9.5: after DomainSOP (9), before lower-priority modules.
+ * Compactable: yes — can be truncated under token pressure.
+ *
+ * @module services/ai/prompt-modules/team-norms
+ */
+import type { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * TeamNormsModule loads all markdown norm files from the team's norms directory
+ * and injects them as team-level SOPs into the agent prompt.
+ *
+ * The norms directory path comes from `config.teamNormsPath`, which is set
+ * during template application when a template has a `norms/` directory.
+ *
+ * @example
+ * ```typescript
+ * const mod = new TeamNormsModule();
+ * mod.shouldInclude({ teamNormsPath: '/home/user/.crewly/teams/abc/norms' });
+ * const content = await mod.build(config);
+ * ```
+ */
+export declare class TeamNormsModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Include this module only when a teamNormsPath is configured and the directory exists.
+     *
+     * @param config - Module configuration
+     * @returns True if team norms directory exists and contains files
+     */
+    shouldInclude(config: ModuleConfig): boolean;
+    /**
+     * Build the team norms prompt section by loading relevant .md files from
+     * the norms directory.
+     *
+     * Selection is a two-stage pipeline designed to keep the marketing team's
+     * 50+ SOP files from blowing the prompt budget:
+     *
+     * 1. **Filter**: parse each file's YAML frontmatter, skip `deprecated: true`
+     *    and skip files whose `appliesTo` does not include the agent's role.
+     * 2. **Rank + cap**: sort survivors by descending `priority` (default 0),
+     *    then alphabetically for stable ordering, then keep at most
+     *    `MAX_NORM_FILES`.
+     *
+     * Frontmatter is stripped from the emitted content — agents see the SOP
+     * body, not the routing metadata.
+     *
+     * @param config - Module configuration with teamNormsPath and role
+     * @returns Formatted markdown section with the applicable norms
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=team-norms.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team-norms.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/team-norms.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AA2F/E;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,IAAI,SAAgB;IACpB,QAAQ,SAAO;IACf,SAAS,SAAQ;IACjB,WAAW,UAAQ;IAEnB;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAU5C;;;;;;;;;;;;;;;;;;OAkBG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CA+DnD"}

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

@@ -0,0 +1,197 @@
+/**
+ * Team Norms Module
+ *
+ * Loads team-level norms/SOPs from the team's norms directory.
+ * These norms originate from template application — when a template
+ * is applied, its norms/*.md files are copied into the team directory.
+ *
+ * Priority 9.5: after DomainSOP (9), before lower-priority modules.
+ * Compactable: yes — can be truncated under token pressure.
+ *
+ * @module services/ai/prompt-modules/team-norms
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Maximum number of norm files to load per team to prevent prompt bloat.
+ * Applied AFTER frontmatter filtering, so deprecated/off-role norms do not
+ * consume a slot.
+ */
+const MAX_NORM_FILES = 5;
+/**
+ * Parse a `---`-delimited YAML frontmatter block at the start of the file.
+ * Returns the parsed fields plus the remaining content. Only supports the
+ * handful of simple scalar/sequence forms we care about — intentionally
+ * avoids adding a YAML dependency to this hot path.
+ */
+function parseFrontmatter(raw) {
+    if (!raw.startsWith('---')) {
+        return { meta: {}, content: raw };
+    }
+    const lines = raw.split('\n');
+    // Find the closing --- (first delimiter is line 0)
+    let end = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            end = i;
+            break;
+        }
+    }
+    if (end === -1) {
+        return { meta: {}, content: raw };
+    }
+    const meta = {};
+    for (const line of lines.slice(1, end)) {
+        const m = /^([A-Za-z_][\w-]*)\s*:\s*(.*)$/.exec(line);
+        if (!m)
+            continue;
+        const key = m[1];
+        let value = m[2].trim();
+        // Strip inline comment
+        const hashIdx = value.indexOf(' #');
+        if (hashIdx >= 0)
+            value = value.slice(0, hashIdx).trim();
+        if (key === 'deprecated') {
+            meta.deprecated = /^(true|yes|1)$/i.test(value);
+        }
+        else if (key === 'appliesTo') {
+            // Accept: `appliesTo: [a, b]` | `appliesTo: a` | `appliesTo: a, b`
+            const stripped = value.replace(/^\[|\]$/g, '');
+            meta.appliesTo = stripped
+                .split(',')
+                .map((s) => s.trim().replace(/^["']|["']$/g, ''))
+                .filter(Boolean);
+        }
+        else if (key === 'priority') {
+            const n = Number(value);
+            if (!Number.isNaN(n))
+                meta.priority = n;
+        }
+    }
+    return { meta, content: lines.slice(end + 1).join('\n') };
+}
+/**
+ * Decides whether a norm applies to the current agent given parsed frontmatter.
+ * Universal (no `appliesTo`) norms always apply. Role-scoped norms apply when
+ * the agent's role is listed.
+ */
+function normApplies(meta, role) {
+    if (meta.deprecated)
+        return false;
+    if (!meta.appliesTo || meta.appliesTo.length === 0)
+        return true;
+    if (!role)
+        return false;
+    return meta.appliesTo.includes(role);
+}
+/**
+ * TeamNormsModule loads all markdown norm files from the team's norms directory
+ * and injects them as team-level SOPs into the agent prompt.
+ *
+ * The norms directory path comes from `config.teamNormsPath`, which is set
+ * during template application when a template has a `norms/` directory.
+ *
+ * @example
+ * ```typescript
+ * const mod = new TeamNormsModule();
+ * mod.shouldInclude({ teamNormsPath: '/home/user/.crewly/teams/abc/norms' });
+ * const content = await mod.build(config);
+ * ```
+ */
+export class TeamNormsModule {
+    name = 'team-norms';
+    priority = 9.5;
+    maxTokens = 1500;
+    compactable = true;
+    /**
+     * Include this module only when a teamNormsPath is configured and the directory exists.
+     *
+     * @param config - Module configuration
+     * @returns True if team norms directory exists and contains files
+     */
+    shouldInclude(config) {
+        if (!config.teamNormsPath)
+            return false;
+        try {
+            return fs.existsSync(config.teamNormsPath) &&
+                fs.statSync(config.teamNormsPath).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Build the team norms prompt section by loading relevant .md files from
+     * the norms directory.
+     *
+     * Selection is a two-stage pipeline designed to keep the marketing team's
+     * 50+ SOP files from blowing the prompt budget:
+     *
+     * 1. **Filter**: parse each file's YAML frontmatter, skip `deprecated: true`
+     *    and skip files whose `appliesTo` does not include the agent's role.
+     * 2. **Rank + cap**: sort survivors by descending `priority` (default 0),
+     *    then alphabetically for stable ordering, then keep at most
+     *    `MAX_NORM_FILES`.
+     *
+     * Frontmatter is stripped from the emitted content — agents see the SOP
+     * body, not the routing metadata.
+     *
+     * @param config - Module configuration with teamNormsPath and role
+     * @returns Formatted markdown section with the applicable norms
+     */
+    async build(config) {
+        const normsPath = config.teamNormsPath;
+        const sections = ['## Team Norms & SOPs\n'];
+        try {
+            const dirExists = await fs.promises
+                .access(normsPath)
+                .then(() => true)
+                .catch(() => false);
+            if (!dirExists) {
+                return '';
+            }
+            const allEntries = await fs.promises.readdir(normsPath);
+            const mdFiles = allEntries.filter((f) => f.endsWith('.md')).sort();
+            const candidates = [];
+            for (const entry of mdFiles) {
+                const filePath = path.join(normsPath, entry);
+                try {
+                    const raw = await fs.promises.readFile(filePath, 'utf-8');
+                    const { meta, content } = parseFrontmatter(raw);
+                    if (!normApplies(meta, config.role))
+                        continue;
+                    const trimmed = content.trim();
+                    if (!trimmed)
+                        continue;
+                    candidates.push({
+                        fileName: entry,
+                        content: trimmed,
+                        priority: meta.priority ?? 0,
+                    });
+                }
+                catch {
+                    // Skip unreadable files silently — one bad file shouldn't kill the module.
+                }
+            }
+            if (candidates.length === 0) {
+                return '';
+            }
+            // Stage 2: rank by priority desc, then filename asc, then cap.
+            candidates.sort((a, b) => {
+                if (a.priority !== b.priority)
+                    return b.priority - a.priority;
+                return a.fileName.localeCompare(b.fileName);
+            });
+            const chosen = candidates.slice(0, MAX_NORM_FILES);
+            for (const item of chosen) {
+                sections.push(item.content);
+                sections.push(''); // blank line separator
+            }
+            return sections.join('\n');
+        }
+        catch {
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=team-norms.module.js.map

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

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

package/dist/cli/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/cli/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"}