crewly 1.4.40 → 1.4.42

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

@@ -0,0 +1,44 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Lifecycle module — agent lifecycle behaviors and cognitive loop.
+ *
+ * Consolidates proactive monitoring, auto progress heartbeat,
+ * work rhythm, session management, and the 4-stage cognitive
+ * lifecycle (Intent → Observation → Strategy → Adaptation).
+ *
+ * Orchestrator/TL agents get the full lifecycle spec including
+ * proactive monitoring and event subscription patterns.
+ * Workers get a compact work-rhythm-only version.
+ *
+ * Sources: orchestrator prompt.md §Proactive Monitoring,
+ *          §Auto Progress Heartbeat, §Session Management,
+ *          developer prompt.md §Work Rhythm.
+ */
+export declare class LifecycleModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — all agents need lifecycle guidance.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the lifecycle section.
+     * Orchestrators/TLs get the full spec; workers get a compact version.
+     *
+     * @param config - Module configuration with agent details
+     * @returns Formatted markdown lifecycle section
+     */
+    build(config: ModuleConfig): Promise<string>;
+    /**
+     * Full lifecycle for orchestrators and team leaders —
+     * includes proactive monitoring, cognitive loop, heartbeat, and session management.
+     */
+    private buildFullLifecycle;
+    /**
+     * Compact lifecycle for workers — work rhythm and context management only.
+     */
+    private buildWorkerLifecycle;
+}
+//# sourceMappingURL=lifecycle.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/lifecycle.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,YAAW,YAAY;IACnD,IAAI,SAAe;IACnB,QAAQ,SAAM;IACd,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;IAiBlD;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAwB5B"}

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

@@ -0,0 +1,120 @@
+import { loadRoleFragment } from './prompt-module.interface.js';
+/**
+ * Lifecycle module — agent lifecycle behaviors and cognitive loop.
+ *
+ * Consolidates proactive monitoring, auto progress heartbeat,
+ * work rhythm, session management, and the 4-stage cognitive
+ * lifecycle (Intent → Observation → Strategy → Adaptation).
+ *
+ * Orchestrator/TL agents get the full lifecycle spec including
+ * proactive monitoring and event subscription patterns.
+ * Workers get a compact work-rhythm-only version.
+ *
+ * Sources: orchestrator prompt.md §Proactive Monitoring,
+ *          §Auto Progress Heartbeat, §Session Management,
+ *          developer prompt.md §Work Rhythm.
+ */
+export class LifecycleModule {
+    name = 'lifecycle';
+    priority = 11;
+    maxTokens = 800;
+    compactable = true;
+    /**
+     * Always included — all agents need lifecycle guidance.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the lifecycle section.
+     * Orchestrators/TLs get the full spec; workers get a compact version.
+     *
+     * @param config - Module configuration with agent details
+     * @returns Formatted markdown lifecycle section
+     */
+    async build(config) {
+        const isOrchestrator = config.role === 'orchestrator';
+        const isTL = config.canDelegate === true;
+        // Try loading role-specific fragment
+        if (isOrchestrator) {
+            const fragment = loadRoleFragment(config.projectRoot, config.role, 'lifecycle');
+            if (fragment) {
+                return fragment;
+            }
+        }
+        if (isOrchestrator || isTL) {
+            return this.buildFullLifecycle(config);
+        }
+        return this.buildWorkerLifecycle(config);
+    }
+    /**
+     * Full lifecycle for orchestrators and team leaders —
+     * includes proactive monitoring, cognitive loop, heartbeat, and session management.
+     */
+    buildFullLifecycle(config) {
+        const skillsPath = config.agentSkillsPath;
+        const sessionName = config.sessionName;
+        const projectPath = config.projectPath || config.projectRoot;
+        return `## Lifecycle Management
+
+### Cognitive Lifecycle (4 Stages)
+Continuously cycle through these stages during operation:
+
+1. **Intent** — Determine what needs to happen next (read tasks, check goals)
+2. **Observation** — Gather current state (team status, blockers, progress)
+3. **Strategy** — Decide the best approach (delegate, implement, escalate)
+4. **Adaptation** — Learn from results, adjust approach for next cycle
+
+### Proactive Monitoring
+- Periodically check team member status for idle/error states
+- Use \`schedule-check\` to set follow-up reminders after delegations
+- Monitor for stale tasks — if no progress in 15 minutes, investigate
+- Track context window usage — save progress before running low
+
+### Auto Progress Heartbeat
+Report your status periodically to maintain visibility:
+\`\`\`bash
+bash ${skillsPath}/core/report-status/execute.sh '{"sessionName":"${sessionName}","status":"in_progress","summary":"<current activity>","projectPath":"${projectPath}"}'
+\`\`\`
+
+### Session Management
+- **On startup**: Execute recovery protocol, load context, check pending work
+- **During work**: Report progress, save learnings, delegate effectively
+- **Before context runs low**: Save current state via \`record-learning\`
+- **On shutdown**: Generate session summary for next session handoff
+
+### Daily Workflow
+1. Start → Recovery protocol → Check pending tasks
+2. Process incoming messages and events
+3. Execute cognitive lifecycle loop (Intent → Observation → Strategy → Adaptation)
+4. Report progress at natural milestones
+5. Save learnings and handoff summary before session ends`;
+    }
+    /**
+     * Compact lifecycle for workers — work rhythm and context management only.
+     */
+    buildWorkerLifecycle(config) {
+        const skillsPath = config.agentSkillsPath;
+        const sessionName = config.sessionName;
+        const projectPath = config.projectPath || config.projectRoot;
+        return `## Work Rhythm
+
+### On Session Start
+1. Execute recovery protocol (recall + get-my-context)
+2. Review recovered context for unfinished work or blockers
+3. Report readiness to team leader
+
+### During Work
+- Report progress periodically so your team leader stays informed
+- When you discover important patterns or gotchas, call \`record-learning\` immediately
+- If you feel your context window is getting large, save progress:
+\`\`\`bash
+bash ${skillsPath}/core/record-learning/execute.sh '{"agentId":"${sessionName}","agentRole":"${config.role}","projectPath":"${projectPath}","learning":"Current progress: [what was done]. Remaining: [what is left]. Key findings: [important notes]"}'
+\`\`\`
+
+### Before Context Runs Low
+- Proactively save your progress via \`record-learning\`
+- Report current status so the team leader can reassign if needed`;
+    }
+}
+//# sourceMappingURL=lifecycle.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/lifecycle.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,eAAe;IAC3B,IAAI,GAAG,WAAW,CAAC;IACnB,QAAQ,GAAG,EAAE,CAAC;IACd,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,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC;QAEzC,qCAAqC;QACrC,IAAI,cAAc,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAChF,IAAI,QAAQ,EAAE,CAAC;gBACd,OAAO,QAAQ,CAAC;YACjB,CAAC;QACF,CAAC;QACD,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACK,kBAAkB,CAAC,MAAoB;QAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;QAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACvC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC;QAE7D,OAAO;;;;;;;;;;;;;;;;;;;OAmBF,UAAU,mDAAmD,WAAW,0EAA0E,WAAW;;;;;;;;;;;;;;0DAc1G,CAAC;IAC1D,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,MAAoB;QAChD,MAAM,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;QAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACvC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC;QAE7D,OAAO;;;;;;;;;;;;OAYF,UAAU,iDAAiD,WAAW,kBAAkB,MAAM,CAAC,IAAI,oBAAoB,WAAW;;;;;kEAKvE,CAAC;IAClE,CAAC;CACD"}

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

@@ -0,0 +1,28 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Memory reference module — tells the agent how to access and store memories.
+ *
+ * Consolidates memory routing rules and session recovery protocol
+ * into a single module. Contains "how-to" instructions, not actual data.
+ *
+ * Sources: Path A Steps 8+9, Path B Section 7.
+ */
+export declare class MemoryReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — memory access is fundamental to agent continuity.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the memory reference section with routing rules
+     * that tell the agent where to store different types of knowledge.
+     *
+     * @param config - Module configuration
+     * @returns Formatted markdown memory reference section
+     */
+    build(_config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=memory-reference.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/memory-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,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAkBnD"}

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

@@ -0,0 +1,46 @@
+/**
+ * Memory reference module — tells the agent how to access and store memories.
+ *
+ * Consolidates memory routing rules and session recovery protocol
+ * into a single module. Contains "how-to" instructions, not actual data.
+ *
+ * Sources: Path A Steps 8+9, Path B Section 7.
+ */
+export class MemoryReferenceModule {
+    name = 'memory_references';
+    priority = 4;
+    maxTokens = 500;
+    compactable = false;
+    /**
+     * Always included — memory access is fundamental to agent continuity.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the memory reference section with routing rules
+     * that tell the agent where to store different types of knowledge.
+     *
+     * @param config - Module configuration
+     * @returns Formatted markdown memory reference section
+     */
+    async build(_config) {
+        return `## Memory Routing Rules
+
+When you learn something worth remembering, store it in the **right place**:
+
+| What you learned | Where to store it | How |
+|---|---|---|
+| Team conventions, coding standards, project patterns, shared decisions | Crewly knowledge (project-wide) | \`remember\` with \`scope: "project"\`, \`category: "pattern"\` or \`"decision"\` |
+| User preferences, working style, role-specific tips | Crewly knowledge (agent-specific) | \`remember\` with \`scope: "agent"\`, \`category: "preference"\` or \`"fact"\` |
+| Gotchas, bugs, workarounds discovered during work | Crewly knowledge (project-wide) | \`remember\` with \`scope: "project"\`, \`category: "gotcha"\` |
+| Temporary task notes, in-progress state, scratch data | Project files or Claude native memory | Write to a file in the project, or keep in your conversation context |
+
+**Rules of thumb:**
+- If another agent or a future session would benefit → use \`remember\` with \`scope: "project"\`
+- If only YOU would benefit in future sessions → use \`remember\` with \`scope: "agent"\`
+- If it's only useful right now → keep it in your conversation context or a scratch file
+- **Never store secrets, credentials, or tokens** in any memory system`;
+    }
+}
+//# sourceMappingURL=memory-reference.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/memory-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,KAAK,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,OAAqB;QAChC,OAAO;;;;;;;;;;;;;;;uEAe8D,CAAC;IACvE,CAAC;CACD"}

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

@@ -0,0 +1,29 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Project reference module — tells the agent how to access project knowledge.
+ *
+ * Provides references to SOPs, OKR, tasks/tickets, and project specs.
+ * Contains "how-to" instructions only — actual SOP content is loaded
+ * as context at runtime.
+ *
+ * Sources: Path B Section 3 (SOP context reference).
+ */
+export declare class ProjectReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Include when agent has a project path.
+     */
+    shouldInclude(config: ModuleConfig): boolean;
+    /**
+     * Build the project reference section with instructions on
+     * how to access SOPs, project goals, and specifications.
+     *
+     * @param config - Module configuration with project path
+     * @returns Formatted markdown project reference section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=project-reference.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/project-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,YAAW,YAAY;IAC1D,IAAI,SAAwB;IAC5B,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAQ;IAEnB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAI5C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAqBlD"}

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

@@ -0,0 +1,50 @@
+/**
+ * Project reference module — tells the agent how to access project knowledge.
+ *
+ * Provides references to SOPs, OKR, tasks/tickets, and project specs.
+ * Contains "how-to" instructions only — actual SOP content is loaded
+ * as context at runtime.
+ *
+ * Sources: Path B Section 3 (SOP context reference).
+ */
+export class ProjectReferenceModule {
+    name = 'project_references';
+    priority = 7;
+    maxTokens = 400;
+    compactable = true;
+    /**
+     * Include when agent has a project path.
+     */
+    shouldInclude(config) {
+        return !!config.projectPath;
+    }
+    /**
+     * Build the project reference section with instructions on
+     * how to access SOPs, project goals, and specifications.
+     *
+     * @param config - Module configuration with project path
+     * @returns Formatted markdown project reference section
+     */
+    async build(config) {
+        return `## Project References
+
+### Standards
+- Follow established code style and conventions
+- TypeScript strict mode, aim for 80%+ test coverage
+- Follow secure coding practices (parameterized queries, input sanitization, output encoding)
+- Descriptive commit messages, atomic commits
+
+### SOPs
+Load relevant Standard Operating Procedures for your current task:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/get-sops/execute.sh '{"context":"<describe your current task>","role":"${config.role}"}'
+\`\`\`
+
+### Project Knowledge
+- Project specs: \`${config.projectPath}/.crewly/specs/\`
+- Active goals: \`${config.projectPath}/.crewly/goals/goals.md\`
+- Task management: \`${config.projectPath}/.crewly/tasks/\`
+- Knowledge base: \`${config.projectPath}/.crewly/knowledge/\``;
+    }
+}
+//# sourceMappingURL=project-reference.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/project-reference.module.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IAClC,IAAI,GAAG,oBAAoB,CAAC;IAC5B,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,MAAoB;QACjC,OAAO,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,OAAO;;;;;;;;;;;OAWF,MAAM,CAAC,eAAe,gFAAgF,MAAM,CAAC,IAAI;;;;qBAInG,MAAM,CAAC,WAAW;oBACnB,MAAM,CAAC,WAAW;uBACf,MAAM,CAAC,WAAW;sBACnB,MAAM,CAAC,WAAW,uBAAuB,CAAC;IAC/D,CAAC;CACD"}

package/dist/backend/backend/src/services/ai/prompt-modules/prompt-assembly.service.d.ts

@@ -0,0 +1,103 @@
+import { PromptModule, ModuleConfig, ModuleBuildResult, AssemblyReport, TruncatedModuleInfo } from './prompt-module.interface.js';
+/**
+ * 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 declare class PromptAssemblyService {
+    private logger;
+    private modules;
+    private totalTokenBudget;
+    constructor(tokenBudget?: number);
+    /**
+     * Register the default set of prompt modules.
+     * Called automatically in constructor. Additional modules
+     * can be added via addModule().
+     */
+    private registerDefaultModules;
+    /**
+     * Add a custom prompt module to the assembly pipeline.
+     *
+     * @param module - Module to add
+     */
+    addModule(module: PromptModule): void;
+    /**
+     * Remove a module by name.
+     *
+     * @param name - Name of the module to remove
+     */
+    removeModule(name: string): void;
+    /**
+     * Get all registered modules (for inspection/testing).
+     *
+     * @returns Array of registered prompt modules
+     */
+    getModules(): PromptModule[];
+    /**
+     * Get or set the total token budget.
+     *
+     * @param budget - Optional new budget to set
+     * @returns Current token budget
+     */
+    tokenBudget(budget?: number): number;
+    /**
+     * 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
+     */
+    assemble(config: ModuleConfig): Promise<{
+        prompt: string;
+        report: AssemblyReport;
+    }>;
+    /**
+     * 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
+     */
+    assembleWithDetails(config: ModuleConfig): Promise<{
+        prompt: string;
+        modules: ModuleBuildResult[];
+        totalTokens: number;
+        truncated: TruncatedModuleInfo[];
+    }>;
+    /**
+     * 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
+     */
+    private trimContent;
+}
+//# sourceMappingURL=prompt-assembly.service.d.ts.map

package/dist/backend/backend/src/services/ai/prompt-modules/prompt-assembly.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-assembly.service.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/prompt-assembly.service.ts"],"names":[],"mappings":"AACA,OAAO,EACN,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EAEnB,MAAM,8BAA8B,CAAC;AAqCtC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,qBAAqB;IACjC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,WAAW,GAAE,MAA6B;IAMtD;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIrC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;;;OAIG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;;;;OAKG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAOpC;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAC;IAsJzF;;;;;;OAMG;IACG,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;QACxD,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,mBAAmB,EAAE,CAAC;KACjC,CAAC;IAUF;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAkBnB"}