crewly 1.12.1 → 1.13.1

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

@@ -0,0 +1,104 @@
+/**
+ * Mission Context module — auto-injects the agent's current mission /
+ * OKR context into the assembled prompt.
+ *
+ * Wraps `MissionContextService.getContextForAgent` and registers
+ * cleanly inside the live `PromptAssemblyService` pipeline. This is the
+ * production wire-in for Memory Phase 1 / fix #415; the older hook in
+ * `PromptGeneratorService.generateMemberPrompt` was on a dead code path.
+ *
+ * Behavior:
+ *   - Skipped when `teamId` is missing or `evalMode` is true.
+ *   - `build()` is fail-soft: any service error logs a warn and returns
+ *     `''` so the assembler never breaks because of a missing missions
+ *     directory or a malformed mission file.
+ *   - Uses `config.projectPath` as the source of truth — no `process.cwd()`.
+ *   - Forwards `teamSlug` for sub-OKR slug lookup and `teamAncestorIds`
+ *     so missions owned by parent teams in the OKR hierarchy are also
+ *     surfaced.
+ *
+ * @module services/ai/prompt-modules/mission-context.module
+ */
+import { LoggerService } from '../../core/logger.service.js';
+import { MissionContextService } from '../../memory/mission-context.service.js';
+/**
+ * Priority slot for the mission card. Sits after team references
+ * (priority 6) and before learning references (priority 10) so the
+ * agent first sees who they work with, then what mission they are
+ * serving, then how to learn from past work.
+ */
+const MISSION_CONTEXT_PRIORITY = 7;
+/**
+ * Soft token budget. The service caps the rendered card at 2KB hard
+ * cap (~512 tokens at 4 chars/token); this gives the assembler some
+ * headroom for the markdown framing.
+ */
+const MISSION_CONTEXT_MAX_TOKENS = 600;
+/**
+ * Implements the PromptModule interface for the mission-context card.
+ */
+export class MissionContextModule {
+    name = 'mission_context';
+    priority = MISSION_CONTEXT_PRIORITY;
+    maxTokens = MISSION_CONTEXT_MAX_TOKENS;
+    compactable = true;
+    logger;
+    service;
+    /**
+     * Construct the module. The service is resolved lazily through its
+     * singleton — passing one in is supported for tests.
+     *
+     * @param service - Optional override for the mission-context service
+     */
+    constructor(service) {
+        this.logger = LoggerService.getInstance().createComponentLogger('MissionContextModule');
+        this.service = service ?? MissionContextService.getInstance();
+    }
+    /**
+     * Skip the card when the agent has no team (no scoping anchor) or
+     * the assembler is in eval mode (token-saving).
+     *
+     * @param config - Module configuration
+     * @returns true when the card should be built
+     */
+    shouldInclude(config) {
+        if (config.evalMode)
+            return false;
+        if (!config.teamId)
+            return false;
+        return true;
+    }
+    /**
+     * Build the mission card by delegating to MissionContextService.
+     * Returns the empty string on any error or when there is nothing to
+     * surface.
+     *
+     * @param config - Module configuration with resolved project path,
+     *   team id, optional team slug and optional ancestor team ids.
+     * @returns Rendered mission card markdown or `''` to skip the section
+     */
+    async build(config) {
+        // `shouldInclude` already guarded these; defensive for direct callers.
+        if (!config.teamId || !config.projectPath)
+            return '';
+        try {
+            const card = await this.service.getContextForAgent({
+                agentId: config.sessionName,
+                projectPath: config.projectPath,
+                teamId: config.teamId,
+                ancestorTeamIds: config.teamAncestorIds,
+                teamSlug: config.teamSlug,
+            });
+            return card ? card.trim() : '';
+        }
+        catch (err) {
+            this.logger.warn('MissionContextService threw — skipping mission card for this assembly', {
+                sessionName: config.sessionName,
+                teamId: config.teamId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=mission-context.module.js.map

package/dist/cli/backend/src/services/ai/prompt-modules/mission-context.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-context.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/mission-context.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,aAAa,EAAwB,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAGhF;;;;;GAKG;AACH,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC;;;;GAIG;AACH,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAEvC;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAChC,IAAI,GAAG,iBAAiB,CAAC;IACzB,QAAQ,GAAG,wBAAwB,CAAC;IACpC,SAAS,GAAG,0BAA0B,CAAC;IACvC,WAAW,GAAG,IAAI,CAAC;IAEF,MAAM,CAAkB;IACxB,OAAO,CAAwB;IAEhD;;;;;OAKG;IACH,YAAY,OAA+B;QAC1C,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,sBAAsB,CAAC,CAAC;QACxF,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,qBAAqB,CAAC,WAAW,EAAE,CAAC;IAC/D,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,MAAoB;QACjC,IAAI,MAAM,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACjC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,uEAAuE;QACvE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,EAAE,CAAC;QAErD,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC;gBAClD,OAAO,EAAE,MAAM,CAAC,WAAW;gBAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;aACzB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,IAAI,CACf,uEAAuE,EACvE;gBACC,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACvD,CACD,CAAC;YACF,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC;CACD"}

package/dist/cli/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/cli/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/cli/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/cli/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/cli/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/cli/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;AAiEtC;;;;;;;;;;;;;;;;;;;;;;;;;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;IA4D9B;;;;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;IA8JzF;;;;;;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"}