crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/services/ai/prompt-modules/prompt-assembly.service.js

@@ -0,0 +1,383 @@
+import { LoggerService } from '../../core/logger.service.js';
+import { estimateTokens, } from './prompt-module.interface.js';
+import { IdentityModule } from './identity.module.js';
+import { SoulModule } from './soul.module.js';
+import { ExpertProfileModule } from './expert-profile.module.js';
+import { SkillsReferenceModule } from './skills-reference.module.js';
+import { MemoryReferenceModule } from './memory-reference.module.js';
+import { TeamReferenceModule } from './team-reference.module.js';
+import { ProjectReferenceModule } from './project-reference.module.js';
+import { UserProfileReferenceModule } from './user-profile-reference.module.js';
+import { LearningReferenceModule } from './learning-reference.module.js';
+import { MissionContextModule } from './mission-context.module.js';
+import { SOPNormDistinctionModule } from './sop-norm-distinction.module.js';
+import { CommunicationModule } from './communication.module.js';
+import { RecoveryModule } from './recovery.module.js';
+import { LifecycleModule } from './lifecycle.module.js';
+import { RoleBoundaryModule } from './role-boundary.module.js';
+import { DecisionRightsModule } from './decision-rights.module.js';
+import { RequestContractModule } from './request-contract.module.js';
+import { DefaultExecutionLoopModule } from './default-execution-loop.module.js';
+import { LazyAntiPatternsModule } from './lazy-anti-patterns.module.js';
+import { CapabilityOverlayModule } from './capability-overlay.module.js';
+import { DomainSOPModule } from './domain-sop.module.js';
+import { RiskPolicyModule } from './risk-policy.module.js';
+import { TeamNormsModule } from './team-norms.module.js';
+import { WorkingMemoryModule } from './working-memory.module.js';
+/**
+ * Default total token budget for all prompt modules combined.
+ * Increased from 25000 to 28000 for Architecture Upgrade modules.
+ * Role Boundary (~800 tokens, non-compactable) is the only guaranteed addition.
+ * SOP/Risk/Capability are conditional and compactable.
+ */
+const DEFAULT_TOKEN_BUDGET = 28000;
+/**
+ * Separator between prompt modules in assembled output.
+ */
+const MODULE_SEPARATOR = '\n\n---\n\n';
+/**
+ * When trimming a module to fit budget, reduce to this fraction of maxTokens first.
+ */
+const TRIM_FRACTION = 0.5;
+/**
+ * Module names that are included in eval mode.
+ * All other modules are skipped to reduce prompt size and cost during eval runs.
+ */
+const EVAL_MODE_CORE_MODULES = new Set([
+    'identity',
+    'soul',
+    'role-boundary',
+    'recovery',
+    'decision-rights',
+    'lazy-anti-patterns',
+]);
+/**
+ * Service that orchestrates the assembly of prompt modules into a complete agent prompt.
+ *
+ * Responsibilities:
+ * - Registers and manages prompt modules
+ * - Assembles modules in priority order
+ * - Enforces per-module and total token budgets with 2-stage truncation:
+ *   1. First pass: build all Trusted Zone (non-compactable) + Flexible Zone modules
+ *   2. If over budget: trim lowest-priority compactable modules to 50% of maxTokens
+ *   3. If still over budget: remove lowest-priority compactable modules entirely
+ * - Returns AssemblyReport with token breakdown and truncation details
+ *
+ * @example
+ * ```typescript
+ * const assembler = new PromptAssemblyService();
+ * const { prompt, report } = await assembler.assemble({
+ *   sessionName: 'crewly-dev-001',
+ *   memberId: 'uuid-123',
+ *   role: 'developer',
+ *   projectPath: '/path/to/project',
+ *   agentSkillsPath: '/path/to/skills/agent',
+ *   tlSkillsPath: '/path/to/skills/team-leader',
+ *   projectRoot: '/path/to/project',
+ * });
+ * ```
+ */
+export class PromptAssemblyService {
+    logger;
+    modules = [];
+    totalTokenBudget;
+    constructor(tokenBudget = DEFAULT_TOKEN_BUDGET) {
+        this.logger = LoggerService.getInstance().createComponentLogger('PromptAssemblyService');
+        this.totalTokenBudget = tokenBudget;
+        this.registerDefaultModules();
+    }
+    /**
+     * Register the default set of prompt modules.
+     * Called automatically in constructor. Additional modules
+     * can be added via addModule().
+     */
+    registerDefaultModules() {
+        this.modules = [
+            new IdentityModule(),
+            new SoulModule(),
+            new ExpertProfileModule(),
+            new RecoveryModule(),
+            new RoleBoundaryModule(),
+            // Decision Rights + Escalation Chain (P0-4) sits at priority 3.5,
+            // inside the authority cluster: identity → soul → recovery →
+            // role-boundary → decision-rights. Authority text is non-compactable.
+            new DecisionRightsModule(),
+            // Request Contract (P0-3) sits at priority 3.6, immediately after
+            // DecisionRights and before MemoryReference. Authority cluster
+            // continues: identity → soul → recovery → role-boundary →
+            // decision-rights → request-contract → memory-reference.
+            // Role-shaped: orchestrator gets the seven-field table, TLs get
+            // Brief Reception Protocol, workers get the G+O+E reminder.
+            new RequestContractModule(),
+            // Lazy Behavior Anti-Patterns (P1 Fix 8) sits at priority 3.7 —
+            // the trailing edge of the authority cluster. Seven verbatim
+            // failure-mode bullets the agent must self-check against. Static
+            // universal text, byte-identical across roles, non-compactable.
+            new LazyAntiPatternsModule(),
+            // Default Execution Loop (P1 Fix 6) sits at priority 3.8, the
+            // final authority-cluster entry before data context begins.
+            // Authority cluster reads: identity → soul → recovery → role-
+            // boundary → decision-rights → request-contract → lazy-anti-
+            // patterns → default-execution-loop → memory-reference. Order is
+            // intentional: contract (what we owe) → anti-patterns (what to
+            // avoid) → execution loop (how to actively operate). The 8-step
+            // loop replaces the passive "Ready for tasks — wait for me to
+            // send you work" closer that was duplicated across 17 role
+            // prompts. Behavioral mandate is non-compactable.
+            new DefaultExecutionLoopModule(),
+            new MemoryReferenceModule(),
+            new SkillsReferenceModule(),
+            new TeamReferenceModule(),
+            // Mission/OKR card — sits right after team references so the
+            // agent first sees who they work with, then the mission they
+            // are serving. Live wire-in for fix #415; replaces the dead
+            // PromptGeneratorService hook.
+            new MissionContextModule(),
+            new CapabilityOverlayModule(),
+            // Mission Card (priority 7) is registered by Leo's M1 dead-code-path
+            // rewire — it lands here once that PR merges. Wake card (priority 8)
+            // must follow the mission card so the agent reads short-term
+            // "why-now" runtime context after the long-term mission frame.
+            new WorkingMemoryModule(),
+            new ProjectReferenceModule(),
+            new CommunicationModule(),
+            new DomainSOPModule(),
+            new TeamNormsModule(),
+            new UserProfileReferenceModule(),
+            new RiskPolicyModule(),
+            new LearningReferenceModule(),
+            new SOPNormDistinctionModule(),
+            new LifecycleModule(),
+        ];
+    }
+    /**
+     * Add a custom prompt module to the assembly pipeline.
+     *
+     * @param module - Module to add
+     */
+    addModule(module) {
+        this.modules.push(module);
+    }
+    /**
+     * Remove a module by name.
+     *
+     * @param name - Name of the module to remove
+     */
+    removeModule(name) {
+        this.modules = this.modules.filter((m) => m.name !== name);
+    }
+    /**
+     * Get all registered modules (for inspection/testing).
+     *
+     * @returns Array of registered prompt modules
+     */
+    getModules() {
+        return [...this.modules];
+    }
+    /**
+     * Get or set the total token budget.
+     *
+     * @param budget - Optional new budget to set
+     * @returns Current token budget
+     */
+    tokenBudget(budget) {
+        if (budget !== undefined) {
+            this.totalTokenBudget = budget;
+        }
+        return this.totalTokenBudget;
+    }
+    /**
+     * Assemble all applicable prompt modules into a single prompt string.
+     *
+     * Uses 2-stage truncation for compactable modules when over budget:
+     * 1. Trim lowest-priority compactable modules to 50% of their content
+     * 2. Remove lowest-priority compactable modules entirely
+     *
+     * Trusted Zone (non-compactable) modules are never truncated or removed.
+     *
+     * @param config - Configuration with all context needed by modules
+     * @returns Object with assembled prompt string and budget report
+     */
+    async assemble(config) {
+        const built = [];
+        const truncated = [];
+        // Sort modules by priority (ascending — lower number = higher priority)
+        const sorted = [...this.modules].sort((a, b) => a.priority - b.priority);
+        // Phase 1: Build all applicable modules
+        for (const module of sorted) {
+            // In eval mode, skip non-core modules to reduce prompt size and cost
+            if (config.evalMode && !EVAL_MODE_CORE_MODULES.has(module.name)) {
+                this.logger.debug(`Module '${module.name}' skipped (evalMode)`, {
+                    sessionName: config.sessionName,
+                });
+                continue;
+            }
+            if (!module.shouldInclude(config)) {
+                this.logger.debug(`Module '${module.name}' skipped (shouldInclude=false)`, {
+                    sessionName: config.sessionName,
+                });
+                continue;
+            }
+            try {
+                const content = await module.build(config);
+                if (content && content.trim()) {
+                    const tokens = estimateTokens(content);
+                    built.push({
+                        name: module.name,
+                        content: content.trim(),
+                        estimatedTokens: tokens,
+                        compactable: module.compactable,
+                        priority: module.priority,
+                    });
+                }
+            }
+            catch (error) {
+                this.logger.error(`Module '${module.name}' failed to build`, {
+                    sessionName: config.sessionName,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                if (!module.compactable) {
+                    throw error;
+                }
+            }
+        }
+        // Phase 2: Enforce token budget via 2-stage truncation
+        let totalTokens = built.reduce((sum, r) => sum + r.estimatedTokens, 0);
+        if (totalTokens > this.totalTokenBudget) {
+            // Get compactable modules sorted by priority descending (lowest priority first to trim)
+            const compactableIndices = built
+                .map((r, i) => ({ ...r, index: i }))
+                .filter((r) => r.compactable)
+                .sort((a, b) => b.priority - a.priority);
+            // Stage 1: Trim to 50% of content (lowest priority first)
+            for (const item of compactableIndices) {
+                if (totalTokens <= this.totalTokenBudget)
+                    break;
+                const original = built[item.index];
+                const trimmedContent = this.trimContent(original.content, TRIM_FRACTION);
+                const trimmedTokens = estimateTokens(trimmedContent);
+                const savings = original.estimatedTokens - trimmedTokens;
+                if (savings > 0) {
+                    totalTokens -= savings;
+                    built[item.index] = {
+                        ...original,
+                        content: trimmedContent,
+                        estimatedTokens: trimmedTokens,
+                    };
+                    truncated.push({
+                        name: original.name,
+                        originalTokens: original.estimatedTokens,
+                        finalTokens: trimmedTokens,
+                        action: 'trimmed',
+                    });
+                    this.logger.info(`Module '${original.name}' trimmed to 50%`, {
+                        sessionName: config.sessionName,
+                        originalTokens: original.estimatedTokens,
+                        trimmedTokens,
+                        totalTokens,
+                    });
+                }
+            }
+            // Stage 2: Remove entirely (lowest priority first)
+            if (totalTokens > this.totalTokenBudget) {
+                // Re-get compactable indices (some may have been trimmed)
+                const removable = built
+                    .map((r, i) => ({ ...r, index: i }))
+                    .filter((r) => r.compactable)
+                    .sort((a, b) => b.priority - a.priority);
+                for (const item of removable) {
+                    if (totalTokens <= this.totalTokenBudget)
+                        break;
+                    const original = built[item.index];
+                    totalTokens -= original.estimatedTokens;
+                    // Check if already in truncated list (was trimmed in stage 1)
+                    const existingTruncIdx = truncated.findIndex((t) => t.name === original.name);
+                    if (existingTruncIdx >= 0) {
+                        truncated[existingTruncIdx].finalTokens = 0;
+                        truncated[existingTruncIdx].action = 'removed';
+                    }
+                    else {
+                        truncated.push({
+                            name: original.name,
+                            originalTokens: original.estimatedTokens,
+                            finalTokens: 0,
+                            action: 'removed',
+                        });
+                    }
+                    // Mark for removal by zeroing content
+                    built[item.index] = { ...original, content: '', estimatedTokens: 0 };
+                    this.logger.info(`Module '${original.name}' removed (budget)`, {
+                        sessionName: config.sessionName,
+                        freedTokens: original.estimatedTokens,
+                        totalTokens,
+                    });
+                }
+            }
+        }
+        // Filter out removed modules and build final output
+        const finalResults = built.filter((r) => r.content.length > 0);
+        const finalTotalTokens = finalResults.reduce((sum, r) => sum + r.estimatedTokens, 0);
+        const report = {
+            totalTokens: finalTotalTokens,
+            moduleBreakdown: finalResults.map((r) => ({
+                name: r.name,
+                content: r.content,
+                estimatedTokens: r.estimatedTokens,
+            })),
+            truncated,
+        };
+        this.logger.info('Prompt assembly complete', {
+            sessionName: config.sessionName,
+            moduleCount: finalResults.length,
+            totalTokens: finalTotalTokens,
+            budget: this.totalTokenBudget,
+            truncatedCount: truncated.length,
+            modules: finalResults.map((r) => r.name),
+        });
+        return {
+            prompt: finalResults.map((r) => r.content).join(MODULE_SEPARATOR),
+            report,
+        };
+    }
+    /**
+     * Assemble modules and return detailed results with per-module metadata.
+     * Convenience wrapper that returns just the report (same as assemble().report).
+     *
+     * @param config - Configuration with all context needed by modules
+     * @returns Assembly details with prompt, modules, and total tokens
+     */
+    async assembleWithDetails(config) {
+        const { prompt, report } = await this.assemble(config);
+        return {
+            prompt,
+            modules: report.moduleBreakdown,
+            totalTokens: report.totalTokens,
+            truncated: report.truncated,
+        };
+    }
+    /**
+     * Trim content to a target fraction of its original length.
+     * Trims at line boundaries to avoid cutting mid-sentence.
+     *
+     * @param content - Original content string
+     * @param fraction - Target fraction (e.g., 0.5 for 50%)
+     * @returns Trimmed content
+     */
+    trimContent(content, fraction) {
+        const targetLength = Math.floor(content.length * fraction);
+        if (targetLength >= content.length)
+            return content;
+        const lines = content.split('\n');
+        let accumulated = 0;
+        const kept = [];
+        for (const line of lines) {
+            if (accumulated + line.length + 1 > targetLength && kept.length > 0) {
+                break;
+            }
+            kept.push(line);
+            accumulated += line.length + 1; // +1 for newline
+        }
+        return kept.join('\n');
+    }
+}
+//# sourceMappingURL=prompt-assembly.service.js.map

package/dist/cli/backend/src/services/ai/prompt-modules/prompt-assembly.service.js.map

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

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

@@ -0,0 +1,34 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * 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 declare class RecoveryModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — every agent needs session recovery.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the session recovery protocol with executable bash commands.
+     *
+     * @param config - Module configuration with agent identity
+     * @returns Formatted markdown recovery section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=recovery.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/recovery.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,YAAY;IAClD,IAAI,SAAc;IAClB,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;CA+DlD"}

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

@@ -0,0 +1,96 @@
+import { loadRoleFragment } from './prompt-module.interface.js';
+/**
+ * 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) {
+        // Try loading role-specific fragment (orchestrator has a different startup flow)
+        if (config.role === 'orchestrator') {
+            const fragment = loadRoleFragment(config.projectRoot, config.role, 'recovery');
+            if (fragment) {
+                return fragment;
+            }
+        }
+        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 1.5: Read your active work (authoritative state)
+The system has already injected your current Requests + WorkItems above
+under \`## Your Active Work\` — that section is the source of truth.
+**State always wins over memory.** If a row carries a \`(memory: ...)\` annotation,
+the state value is what you should act on; the memory note flags a divergence
+to investigate, not to override the state.
+
+Call this skill mid-session if the briefing was truncated (\`... and X more\` marker)
+or stale (>5 minutes since registration, especially after long-running tasks):
+\`\`\`bash
+bash ${skillsPath}/core/get-my-active-work/execute.sh --session ${agentId} --role ${role}
+\`\`\`
+
+### Step 2: Load your full context
+\`\`\`bash
+bash ${skillsPath}/core/get-my-context/execute.sh '{"agentId":"${agentId}","agentRole":"${role}","projectPath":"${projectPath}"}'
+\`\`\`
+
+### Step 3: Check for pending tasks
+\`\`\`bash
+bash ${skillsPath}/core/get-my-tasks/execute.sh '{"sessionName":"${agentId}"}'
+\`\`\`
+If you have assigned tasks from a previous session, review and accept them using the accept-task endpoint.
+If any task has workingNotes, read them carefully — they contain your previous working state
+(current hypothesis, what you've tried, where you left off). Resume from there, don't restart from scratch.
+
+### Step 4: Register yourself as active
+**CRITICAL:** You MUST call register-self to transition your status from "started" to "active". The system will NOT deliver any messages (Slack, tasks, etc.) to you until you register. Run this BEFORE reporting status:
+\`\`\`bash
+bash ${skillsPath}/core/register-self/execute.sh '{"sessionName":"${agentId}","role":"${role}"}'
+\`\`\`
+
+### Step 5: Assess and report
+After reviewing the results from Steps 1-3:
+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/cli/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":"AAAA,OAAO,EAA8B,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;;;;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,iFAAiF;QACjF,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC/E,IAAI,QAAQ,EAAE,CAAC;gBACd,OAAO,QAAQ,CAAC;YACjB,CAAC;QACF,CAAC;QAED,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;;;;;;;;;;;;;OAapL,UAAU,iDAAiD,OAAO,WAAW,IAAI;;;;;OAKjF,UAAU,gDAAgD,OAAO,kBAAkB,IAAI,oBAAoB,WAAW;;;;;OAKtH,UAAU,kDAAkD,OAAO;;;;;;;;;OASnE,UAAU,mDAAmD,OAAO,aAAa,IAAI;;;;;;;;;8GASkB,CAAC;IAC9G,CAAC;CACD"}

package/dist/cli/backend/src/services/ai/prompt-modules/request-contract.module.d.ts

@@ -0,0 +1,106 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Request Contract block (P0-3).
+ *
+ * Per spec
+ * `.crewly/specs/2026-05-03-agent-improvement-p0-execution.md` §"Fix P0-3",
+ * this module emits a role-shaped Request Contract section. The contract
+ * defines the seven canonical fields a Request carries — Goal, Expected
+ * Outcome, Eval Criteria, Constraints, Decision Rights, Escalation
+ * Conditions, Done Definition — and pins **Goal + Expected Outcome + Eval
+ * Criteria** as the mandatory floor that every delegated subtask MUST carry.
+ *
+ * The module emits one of three role-shaped sections:
+ *
+ * 1. **Orchestrator** (orgRole === 'orchestrator' OR role === 'orchestrator'):
+ *    Full Request Contract field table + the rule that every delegated
+ *    subtask MUST carry G+O+E + the rejection rule TLs apply downstream.
+ *
+ * 2. **Team Lead** (orgRole === 'team-lead' OR canDelegate === true):
+ *    Brief Reception Protocol — receive task, verify G+O+E present, push
+ *    back to delegator if any are missing, propagate G+O+E verbatim when
+ *    sub-delegating to workers.
+ *
+ * 3. **Worker / executor** (everyone else):
+ *    Short G+O+E assertion — every task you accept should carry Goal,
+ *    Expected Outcome, and Eval Criteria; if any is missing, ask the
+ *    delegator (your TL or the orchestrator) before starting.
+ *
+ * Why a module (not just per-role markdown)?
+ * - Authority text must be identical across every agent of the same role.
+ *   A module guarantees byte-identical output instead of relying on N role
+ *   prompts staying in sync over time.
+ * - The text is small and authority-defining, so it cannot be truncated
+ *   under budget pressure → `compactable = false` (Trusted Zone).
+ * - Sits at priority 3.6 — immediately after DecisionRights (priority 3.5),
+ *   immediately before MemoryReference (priority 4). The contract belongs
+ *   in the authority cluster (Identity → Soul/Recovery → RoleBoundary →
+ *   DecisionRights → **RequestContract** → MemoryReference) so an agent
+ *   reads "what is a well-formed task" right after "who am I, what can I
+ *   decide".
+ *
+ * Static role prompts under `config/roles/orchestrator/prompt.md` and
+ * `config/roles/team-leader/{prompt.md,tl-addon.md}` ALSO contain the
+ * orchestrator + TL sections verbatim — this is intentional belt-and-
+ * suspenders coverage for the legacy `prompt-builder.service.ts` load path
+ * which does not run through `PromptAssemblyService`. The two paths
+ * produce different prompts for different runtimes; both must carry the
+ * contract.
+ *
+ * Net-zero offset: legacy "ask clarifying questions" / "if anything's
+ * unclear, ask" soft hints have been deleted from worker role prompts
+ * because this module + the structured G+O+E assertion supersede them.
+ */
+export declare class RequestContractModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always include — every agent participates in the Request lifecycle:
+     * orchestrators issue contracts, TLs verify-and-propagate, workers
+     * consume. The block is small and the role-shape switch is internal.
+     *
+     * @param _config - Unused; the inclusion rule is universal
+     * @returns Always true
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the role-shaped Request Contract section.
+     *
+     * Resolves the agent's role-shape via three stacked checks (in order):
+     *   1. `orgRole === 'orchestrator'` OR `role === 'orchestrator'` → orchestrator block
+     *   2. `orgRole === 'team-lead'` OR `canDelegate === true` → TL Brief Reception Protocol
+     *   3. anything else → Worker G+O+E assertion
+     *
+     * The role-shape inputs match the resolution order used by other
+     * authority modules (e.g. RoleBoundaryModule). Tests pin the matrix.
+     *
+     * @param config - Module configuration
+     * @returns Formatted markdown block with the role-shaped section
+     */
+    build(config: ModuleConfig): Promise<string>;
+    /**
+     * Build the orchestrator-side Request Contract.
+     *
+     * @returns Markdown block: `## Request Contract` with the seven-field
+     *   table, G+O+E mandatory rule, and downstream rejection clause.
+     */
+    private buildOrchestratorBlock;
+    /**
+     * Build the team-lead-side Brief Reception Protocol.
+     *
+     * @returns Markdown block: `## Brief Reception Protocol` with the
+     *   three-step verify / push-back / propagate-verbatim contract.
+     */
+    private buildTeamLeadBlock;
+    /**
+     * Build the worker-side G+O+E assertion.
+     *
+     * @returns Markdown block: `## Request Contract — What You Should See`
+     *   reminding workers to expect G+O+E in every task and to ask if any
+     *   is missing.
+     */
+    private buildWorkerBlock;
+}
+//# sourceMappingURL=request-contract.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-contract.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/request-contract.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,IAAI,SAAsB;IAC1B,QAAQ,SAAO;IACf,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;;;;;;OAOG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;;;;;;;;OAaG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBlD;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;CAaxB"}