crewly 1.4.40 → 1.4.41

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,86 @@
+import { PromptModule, ModuleConfig, ModuleBuildResult } 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
+ * - Supports Trusted Zone (non-compactable) vs Flexible Zone (compactable) modules
+ * - Works across all runtime types (claude-code, gemini-cli, crewly-agent)
+ *
+ * @example
+ * ```typescript
+ * const assembler = new PromptAssemblyService();
+ * const prompt = 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.
+     *
+     * Modules are processed in priority order (lowest number first).
+     * Non-compactable modules are always included (Trusted Zone).
+     * Compactable modules are skipped if the token budget is exceeded (Flexible Zone).
+     *
+     * @param config - Configuration with all context needed by modules
+     * @returns Assembled prompt string with all module sections
+     */
+    assemble(config: ModuleConfig): Promise<string>;
+    /**
+     * Assemble modules and return detailed results with per-module metadata.
+     * Useful for debugging and token budget analysis.
+     *
+     * @param config - Configuration with all context needed by modules
+     * @returns Array of module build results with token estimates
+     */
+    assembleWithDetails(config: ModuleConfig): Promise<{
+        prompt: string;
+        modules: ModuleBuildResult[];
+        totalTokens: number;
+    }>;
+}
+//# 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,EAEjB,MAAM,8BAA8B,CAAC;AAkBtC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;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;IAU9B;;;;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;;;;;;;;;OASG;IACG,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAoErD;;;;;;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;KACpB,CAAC;CAmCF"}

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

@@ -0,0 +1,212 @@
+import { LoggerService } from '../../core/logger.service.js';
+import { estimateTokens, } from './prompt-module.interface.js';
+import { IdentityModule } from './identity.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';
+/**
+ * Default total token budget for all prompt modules combined.
+ * Modules exceeding this budget are skipped (compactable ones only).
+ */
+const DEFAULT_TOKEN_BUDGET = 25000;
+/**
+ * Separator between prompt modules in assembled output.
+ */
+const MODULE_SEPARATOR = '\n\n---\n\n';
+/**
+ * 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
+ * - Supports Trusted Zone (non-compactable) vs Flexible Zone (compactable) modules
+ * - Works across all runtime types (claude-code, gemini-cli, crewly-agent)
+ *
+ * @example
+ * ```typescript
+ * const assembler = new PromptAssemblyService();
+ * const prompt = 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 MemoryReferenceModule(),
+            new SkillsReferenceModule(),
+            new TeamReferenceModule(),
+            new ProjectReferenceModule(),
+        ];
+    }
+    /**
+     * 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.
+     *
+     * Modules are processed in priority order (lowest number first).
+     * Non-compactable modules are always included (Trusted Zone).
+     * Compactable modules are skipped if the token budget is exceeded (Flexible Zone).
+     *
+     * @param config - Configuration with all context needed by modules
+     * @returns Assembled prompt string with all module sections
+     */
+    async assemble(config) {
+        const results = [];
+        let totalTokens = 0;
+        // Sort modules by priority (ascending — lower number = higher priority)
+        const sorted = [...this.modules].sort((a, b) => a.priority - b.priority);
+        for (const module of sorted) {
+            // Check if module should be included
+            if (!module.shouldInclude(config)) {
+                this.logger.debug(`Module '${module.name}' skipped (shouldInclude=false)`, {
+                    sessionName: config.sessionName,
+                });
+                continue;
+            }
+            // Check token budget for compactable modules
+            if (module.compactable && totalTokens + module.maxTokens > this.totalTokenBudget) {
+                this.logger.info(`Module '${module.name}' skipped (token budget exceeded)`, {
+                    sessionName: config.sessionName,
+                    currentTokens: totalTokens,
+                    moduleMaxTokens: module.maxTokens,
+                    budget: this.totalTokenBudget,
+                });
+                continue;
+            }
+            try {
+                const content = await module.build(config);
+                if (content && content.trim()) {
+                    const tokens = estimateTokens(content);
+                    results.push({
+                        name: module.name,
+                        content: content.trim(),
+                        estimatedTokens: tokens,
+                    });
+                    totalTokens += tokens;
+                    this.logger.debug(`Module '${module.name}' built`, {
+                        sessionName: config.sessionName,
+                        tokens,
+                        totalTokens,
+                    });
+                }
+            }
+            catch (error) {
+                this.logger.error(`Module '${module.name}' failed to build`, {
+                    sessionName: config.sessionName,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                // Non-compactable modules failing is critical
+                if (!module.compactable) {
+                    throw error;
+                }
+                // Compactable modules failing is logged but not fatal
+            }
+        }
+        this.logger.info('Prompt assembly complete', {
+            sessionName: config.sessionName,
+            moduleCount: results.length,
+            totalTokens,
+            budget: this.totalTokenBudget,
+            modules: results.map((r) => r.name),
+        });
+        return results.map((r) => r.content).join(MODULE_SEPARATOR);
+    }
+    /**
+     * Assemble modules and return detailed results with per-module metadata.
+     * Useful for debugging and token budget analysis.
+     *
+     * @param config - Configuration with all context needed by modules
+     * @returns Array of module build results with token estimates
+     */
+    async assembleWithDetails(config) {
+        const results = [];
+        let totalTokens = 0;
+        const sorted = [...this.modules].sort((a, b) => a.priority - b.priority);
+        for (const module of sorted) {
+            if (!module.shouldInclude(config))
+                continue;
+            if (module.compactable && totalTokens + module.maxTokens > this.totalTokenBudget) {
+                continue;
+            }
+            try {
+                const content = await module.build(config);
+                if (content && content.trim()) {
+                    const tokens = estimateTokens(content);
+                    results.push({
+                        name: module.name,
+                        content: content.trim(),
+                        estimatedTokens: tokens,
+                    });
+                    totalTokens += tokens;
+                }
+            }
+            catch (error) {
+                if (!module.compactable)
+                    throw error;
+            }
+        }
+        return {
+            prompt: results.map((r) => r.content).join(MODULE_SEPARATOR),
+            modules: results,
+            totalTokens,
+        };
+    }
+}
+//# sourceMappingURL=prompt-assembly.service.js.map

package/dist/backend/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/backend/backend/src/services/ai/prompt-modules/prompt-module.interface.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Interface for modular prompt components.
+ *
+ * Each module is responsible for one concern (identity, skills, team, etc.)
+ * and produces a markdown string that gets assembled into the final agent prompt.
+ *
+ * Modules are assembled in priority order (1 = highest, assembled first).
+ * Non-compactable modules are never truncated when token budget is tight.
+ */
+/**
+ * Configuration passed to each prompt module during assembly.
+ * Contains all the context needed to build module-specific content.
+ */
+export interface ModuleConfig {
+    /** Agent's session name (e.g. 'crewly-product-sam-217bfbbf') */
+    sessionName: string;
+    /** Agent's member ID (UUID) */
+    memberId: string;
+    /** Agent's role (e.g. 'developer', 'orchestrator') */
+    role: string;
+    /** Team ID this agent belongs to */
+    teamId?: string;
+    /** Absolute path to the project directory */
+    projectPath?: string;
+    /** Runtime type determines formatting and injection strategy */
+    runtimeType?: 'claude-code' | 'gemini-cli' | 'codex' | 'crewly-agent';
+    /** Whether this agent can delegate tasks to subordinates */
+    canDelegate?: boolean;
+    /** Resolved subordinate details for TL agents */
+    subordinates?: SubordinateInfoCompat[];
+    /** Absolute path to agent skill scripts */
+    agentSkillsPath: string;
+    /** Absolute path to team-leader skill scripts */
+    tlSkillsPath: string;
+    /** Absolute path to the project root (where config/ lives) */
+    projectRoot: string;
+}
+/**
+ * Subordinate info compatible with the existing SubordinateInfo type
+ */
+export interface SubordinateInfoCompat {
+    name: string;
+    sessionName: string;
+    role: string;
+    memberId: string;
+}
+/**
+ * Result of building a single prompt module.
+ * Includes the content and metadata for budget tracking.
+ */
+export interface ModuleBuildResult {
+    /** Module name */
+    name: string;
+    /** Generated markdown content */
+    content: string;
+    /** Estimated token count of the content */
+    estimatedTokens: number;
+}
+/**
+ * Interface that all prompt modules must implement.
+ *
+ * @example
+ * ```typescript
+ * class IdentityModule implements PromptModule {
+ *   name = 'identity';
+ *   priority = 1;
+ *   maxTokens = 150;
+ *   compactable = false;
+ *
+ *   shouldInclude(_config: ModuleConfig): boolean { return true; }
+ *
+ *   async build(config: ModuleConfig): Promise<string> {
+ *     return `## Your Identity\n- **Session Name:** ${config.sessionName}`;
+ *   }
+ * }
+ * ```
+ */
+export interface PromptModule {
+    /** Module name (used for logging and debugging) */
+    name: string;
+    /** Assembly priority (1 = highest, assembled first) */
+    priority: number;
+    /** Token soft cap for this module */
+    maxTokens: number;
+    /** Whether this module can be skipped when token budget is tight */
+    compactable: boolean;
+    /** Condition check — return false to skip this module */
+    shouldInclude(config: ModuleConfig): boolean;
+    /** Build module content as markdown string */
+    build(config: ModuleConfig): Promise<string>;
+}
+/**
+ * Estimate token count from a string.
+ * Uses the rough heuristic of ~4 characters per token (suitable for English/code mix).
+ *
+ * @param text - Text to estimate tokens for
+ * @returns Estimated token count
+ */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=prompt-module.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-module.interface.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/prompt-module.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,WAAW,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,OAAO,GAAG,cAAc,CAAC;IACtE,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iDAAiD;IACjD,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,YAAY;IAC5B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,WAAW,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IAC7C,8CAA8C;IAC9C,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD"}

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

@@ -0,0 +1,23 @@
+/**
+ * Interface for modular prompt components.
+ *
+ * Each module is responsible for one concern (identity, skills, team, etc.)
+ * and produces a markdown string that gets assembled into the final agent prompt.
+ *
+ * Modules are assembled in priority order (1 = highest, assembled first).
+ * Non-compactable modules are never truncated when token budget is tight.
+ */
+/**
+ * Estimate token count from a string.
+ * Uses the rough heuristic of ~4 characters per token (suitable for English/code mix).
+ *
+ * @param text - Text to estimate tokens for
+ * @returns Estimated token count
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    // ~4 chars per token is a reasonable estimate for English + code
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=prompt-module.interface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-module.interface.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/prompt-module.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwFH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,iEAAiE;IACjE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/backend/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/backend/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,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;;;;;;;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;CA4BlD"}