crewly 1.4.40 → 1.4.41

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

@@ -0,0 +1,202 @@
+import { LoggerService } from '../../core/logger.service.js';
+import { estimateTokens } from './prompt-module.interface.js';
+/**
+ * Default total token budget for all context modules combined.
+ */
+const DEFAULT_CONTEXT_BUDGET = 15000;
+/**
+ * Service that manages runtime context assembly for agents.
+ *
+ * Unlike prompt modules (static, assembled once at startup), context modules
+ * contain dynamic data that can be refreshed mid-session. Context is compactable
+ * by F13 ContextWindowMonitor.
+ *
+ * Responsibilities:
+ * - Registers context loaders for different data sources
+ * - Loads and assembles context on demand
+ * - Supports mid-session refresh without full rebuild
+ * - Enforces context token budgets
+ * - Tracks loaded context for cache/refresh management
+ *
+ * @example
+ * ```typescript
+ * const contextService = new ContextAssemblyService();
+ *
+ * contextService.registerLoader('memory', async (config) => {
+ *   const memoryService = MemoryService.getInstance();
+ *   return memoryService.getFullContext(config.agentId, config.projectPath);
+ * });
+ *
+ * const context = await contextService.loadAll({
+ *   agentId: 'crewly-dev-001',
+ *   role: 'developer',
+ *   projectPath: '/path/to/project',
+ * });
+ * ```
+ */
+export class ContextAssemblyService {
+    logger;
+    loaders = new Map();
+    cache = new Map();
+    totalTokenBudget;
+    constructor(tokenBudget = DEFAULT_CONTEXT_BUDGET) {
+        this.logger = LoggerService.getInstance().createComponentLogger('ContextAssemblyService');
+        this.totalTokenBudget = tokenBudget;
+    }
+    /**
+     * Register a context loader for a named context module.
+     *
+     * @param name - Context module name (e.g., 'memory', 'team_context')
+     * @param loader - Async function that loads context data
+     */
+    registerLoader(name, loader) {
+        this.loaders.set(name, loader);
+    }
+    /**
+     * Remove a registered context loader.
+     *
+     * @param name - Context module name to remove
+     */
+    removeLoader(name) {
+        this.loaders.delete(name);
+        this.cache.delete(name);
+    }
+    /**
+     * Get names of all registered loaders.
+     *
+     * @returns Array of registered loader names
+     */
+    getLoaderNames() {
+        return Array.from(this.loaders.keys());
+    }
+    /**
+     * Load a single context module by name.
+     *
+     * @param name - Context module name
+     * @param config - Loader configuration
+     * @param useCache - Whether to return cached result if available (default: false)
+     * @returns Context load result or null if loader not found
+     */
+    async load(name, config, useCache = false) {
+        if (useCache && this.cache.has(name)) {
+            return this.cache.get(name) || null;
+        }
+        const loader = this.loaders.get(name);
+        if (!loader) {
+            this.logger.warn(`No context loader registered for '${name}'`);
+            return null;
+        }
+        try {
+            const content = await loader(config);
+            const result = {
+                name,
+                content: content || '',
+                estimatedTokens: estimateTokens(content || ''),
+                loadedAt: new Date(),
+            };
+            this.cache.set(name, result);
+            this.logger.debug(`Context '${name}' loaded`, {
+                agentId: config.agentId,
+                tokens: result.estimatedTokens,
+            });
+            return result;
+        }
+        catch (error) {
+            this.logger.error(`Context loader '${name}' failed`, {
+                agentId: config.agentId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    }
+    /**
+     * Load all registered context modules and assemble into a single string.
+     *
+     * @param config - Loader configuration
+     * @returns Assembled context string
+     */
+    async loadAll(config) {
+        const results = [];
+        let totalTokens = 0;
+        for (const [name, loader] of this.loaders.entries()) {
+            try {
+                const content = await loader(config);
+                if (content && content.trim()) {
+                    const tokens = estimateTokens(content);
+                    // Skip if adding this context would exceed budget
+                    if (totalTokens + tokens > this.totalTokenBudget) {
+                        this.logger.info(`Context '${name}' skipped (budget exceeded)`, {
+                            agentId: config.agentId,
+                            currentTokens: totalTokens,
+                            contextTokens: tokens,
+                            budget: this.totalTokenBudget,
+                        });
+                        continue;
+                    }
+                    const result = {
+                        name,
+                        content: content.trim(),
+                        estimatedTokens: tokens,
+                        loadedAt: new Date(),
+                    };
+                    results.push(result);
+                    this.cache.set(name, result);
+                    totalTokens += tokens;
+                }
+            }
+            catch (error) {
+                this.logger.error(`Context loader '${name}' failed`, {
+                    agentId: config.agentId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        this.logger.info('Context assembly complete', {
+            agentId: config.agentId,
+            loaderCount: results.length,
+            totalTokens,
+            budget: this.totalTokenBudget,
+            modules: results.map((r) => r.name),
+        });
+        return results.map((r) => r.content).join('\n\n---\n\n');
+    }
+    /**
+     * Refresh a specific context module (reload from source).
+     *
+     * @param name - Context module name to refresh
+     * @param config - Loader configuration
+     * @returns Refreshed context or null
+     */
+    async refresh(name, config) {
+        this.cache.delete(name);
+        return this.load(name, config, false);
+    }
+    /**
+     * Clear all cached context data.
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Get cached context by name (without reloading).
+     *
+     * @param name - Context module name
+     * @returns Cached result or null
+     */
+    getCached(name) {
+        return this.cache.get(name) || null;
+    }
+    /**
+     * 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;
+    }
+}
+//# sourceMappingURL=context-assembly.service.js.map

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

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

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

@@ -0,0 +1,28 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Identity module — provides the agent's core identification.
+ *
+ * Assembles session name, member ID, role, team, and project path
+ * into a structured identity section. This is the highest-priority
+ * module and is never truncated.
+ *
+ * Sources: Path A Step 2+10, Path B Section 6, Path C header.
+ */
+export declare class IdentityModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — every agent needs an identity.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the identity section with all available fields.
+     *
+     * @param config - Module configuration with agent details
+     * @returns Formatted markdown identity section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=identity.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/identity.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;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;CAqBlD"}

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

@@ -0,0 +1,47 @@
+/**
+ * Identity module — provides the agent's core identification.
+ *
+ * Assembles session name, member ID, role, team, and project path
+ * into a structured identity section. This is the highest-priority
+ * module and is never truncated.
+ *
+ * Sources: Path A Step 2+10, Path B Section 6, Path C header.
+ */
+export class IdentityModule {
+    name = 'identity';
+    priority = 1;
+    maxTokens = 150;
+    compactable = false;
+    /**
+     * Always included — every agent needs an identity.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the identity section with all available fields.
+     *
+     * @param config - Module configuration with agent details
+     * @returns Formatted markdown identity section
+     */
+    async build(config) {
+        const lines = ['## Your Identity'];
+        if (config.sessionName) {
+            lines.push(`- **Session Name:** ${config.sessionName}`);
+        }
+        if (config.memberId) {
+            lines.push(`- **Member ID:** ${config.memberId}`);
+        }
+        if (config.role) {
+            lines.push(`- **Role:** ${config.role}`);
+        }
+        if (config.teamId) {
+            lines.push(`- **Team:** ${config.teamId}`);
+        }
+        if (config.projectPath) {
+            lines.push(`- **Project Path:** ${config.projectPath}`);
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=identity.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/identity.module.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;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,KAAK,GAAa,CAAC,kBAAkB,CAAC,CAAC;QAE7C,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;CACD"}

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

@@ -0,0 +1,22 @@
+/**
+ * Prompt Modules — Modular prompt assembly system.
+ *
+ * Re-exports all prompt module interfaces, implementations,
+ * and assembly services from a single entry point.
+ */
+export { PromptModule, ModuleConfig, SubordinateInfoCompat, ModuleBuildResult, estimateTokens, } from './prompt-module.interface.js';
+export { IdentityModule } from './identity.module.js';
+export { SoulModule } from './soul.module.js';
+export { SkillsReferenceModule } from './skills-reference.module.js';
+export { MemoryReferenceModule } from './memory-reference.module.js';
+export { TeamReferenceModule } from './team-reference.module.js';
+export { ProjectReferenceModule } from './project-reference.module.js';
+export { UserProfileReferenceModule } from './user-profile-reference.module.js';
+export { LearningReferenceModule } from './learning-reference.module.js';
+export { CommunicationModule } from './communication.module.js';
+export { RecoveryModule } from './recovery.module.js';
+export { LifecycleModule } from './lifecycle.module.js';
+export { createScheduledMessagesLoader, ScheduledCheckInfo, ScheduledChecksProvider, } from './scheduled-messages.loader.js';
+export { PromptAssemblyService } from './prompt-assembly.service.js';
+export { ContextAssemblyService } from './context-assembly.service.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACN,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACd,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EACN,6BAA6B,EAC7B,kBAAkB,EAClB,uBAAuB,GACvB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Prompt Modules — Modular prompt assembly system.
+ *
+ * Re-exports all prompt module interfaces, implementations,
+ * and assembly services from a single entry point.
+ */
+// Interface and utilities
+export { estimateTokens, } from './prompt-module.interface.js';
+// Prompt modules
+export { IdentityModule } from './identity.module.js';
+export { SoulModule } from './soul.module.js';
+export { SkillsReferenceModule } from './skills-reference.module.js';
+export { MemoryReferenceModule } from './memory-reference.module.js';
+export { TeamReferenceModule } from './team-reference.module.js';
+export { ProjectReferenceModule } from './project-reference.module.js';
+export { UserProfileReferenceModule } from './user-profile-reference.module.js';
+export { LearningReferenceModule } from './learning-reference.module.js';
+export { CommunicationModule } from './communication.module.js';
+export { RecoveryModule } from './recovery.module.js';
+export { LifecycleModule } from './lifecycle.module.js';
+// Context loaders
+export { createScheduledMessagesLoader, } from './scheduled-messages.loader.js';
+// Assembly services
+export { PromptAssemblyService } from './prompt-assembly.service.js';
+export { ContextAssemblyService } from './context-assembly.service.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0BAA0B;AAC1B,OAAO,EAKN,cAAc,GACd,MAAM,8BAA8B,CAAC;AAEtC,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,kBAAkB;AAClB,OAAO,EACN,6BAA6B,GAG7B,MAAM,gCAAgC,CAAC;AAExC,oBAAoB;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

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

@@ -0,0 +1,28 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Learning reference module — tells the agent how to access and leverage past learnings.
+ *
+ * Provides instructions for using record-learning, recalling past experiences,
+ * and applying lessons learned from previous sessions.
+ *
+ * Sources: LearningAccumulationService, record-learning skill.
+ */
+export declare class LearningReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — agents should know how to learn from experience.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the learning reference section with instructions
+     * on how to record and recall past learnings.
+     *
+     * @param config - Module configuration with agent skill paths
+     * @returns Formatted markdown learning reference section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=learning-reference.module.d.ts.map

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

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

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

@@ -0,0 +1,55 @@
+/**
+ * Learning reference module — tells the agent how to access and leverage past learnings.
+ *
+ * Provides instructions for using record-learning, recalling past experiences,
+ * and applying lessons learned from previous sessions.
+ *
+ * Sources: LearningAccumulationService, record-learning skill.
+ */
+export class LearningReferenceModule {
+    name = 'learning_references';
+    priority = 10;
+    maxTokens = 250;
+    compactable = true;
+    /**
+     * Always included — agents should know how to learn from experience.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the learning reference section with instructions
+     * on how to record and recall past learnings.
+     *
+     * @param config - Module configuration with agent skill paths
+     * @returns Formatted markdown learning reference section
+     */
+    async build(config) {
+        return `## Learning from Experience
+
+### Recording Learnings
+When you discover something worth remembering for future sessions, record it immediately:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/record-learning/execute.sh '{"agentId":"${config.sessionName}","agentRole":"${config.role}","projectPath":"${config.projectPath || ''}","learning":"<what you learned>"}'
+\`\`\`
+
+**When to record:**
+- After resolving a bug — capture the root cause and fix
+- After discovering a code pattern or convention
+- After a failed approach — capture what didn't work and why
+- After completing a task — capture key findings and gotchas
+- When you find something that contradicts your assumptions
+
+### Recalling Learnings
+Before starting a task, check what you or other agents have learned:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/recall/execute.sh '{"agentId":"${config.sessionName}","context":"learnings about <topic>","projectPath":"${config.projectPath || ''}"}'
+\`\`\`
+
+### Applying Learnings
+- Check for relevant learnings before repeating an approach that may have failed before
+- Cross-reference learnings from other agents working on the same project
+- Update or correct stale learnings when you discover they no longer apply`;
+    }
+}
+//# sourceMappingURL=learning-reference.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"learning-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/learning-reference.module.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IACnC,IAAI,GAAG,qBAAqB,CAAC;IAC7B,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,OAAO;;;;;OAKF,MAAM,CAAC,eAAe,iDAAiD,MAAM,CAAC,WAAW,kBAAkB,MAAM,CAAC,IAAI,oBAAoB,MAAM,CAAC,WAAW,IAAI,EAAE;;;;;;;;;;;;;OAalK,MAAM,CAAC,eAAe,wCAAwC,MAAM,CAAC,WAAW,wDAAwD,MAAM,CAAC,WAAW,IAAI,EAAE;;;;;;2EAM5F,CAAC;IAC3E,CAAC;CACD"}

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,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;;;;;;;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;IAUlD;;;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,112 @@
+/**
+ * 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;
+        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":"AAEA;;;;;;;;;;;;;;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,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"}