crewly 1.13.0 → 1.14.0

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

@@ -0,0 +1,149 @@
+import { readFile, access } from 'fs/promises';
+import * as path from 'path';
+/**
+ * Team reference module — provides team hierarchy, TL duties, and norms references.
+ *
+ * Wraps the existing `buildTeamLeadSection` and `buildTeamNormsSection` logic
+ * from PromptBuilderService. The TL addon is conditionally loaded only when
+ * the agent has `canDelegate=true` and subordinates.
+ *
+ * Sources: Path A Step 7, Path B Sections 4+5.
+ */
+export class TeamReferenceModule {
+    name = 'team_references';
+    priority = 6;
+    maxTokens = 8000;
+    compactable = false; // TL core is not compactable
+    /**
+     * Include when agent has a team (teamId set) or has subordinates.
+     */
+    shouldInclude(config) {
+        return !!(config.teamId || (config.canDelegate && config.subordinates && config.subordinates.length > 0));
+    }
+    /**
+     * Build team reference section. Includes TL addon if agent can delegate,
+     * and team norms if available.
+     *
+     * @param config - Module configuration with team and subordinate details
+     * @returns Formatted markdown team reference section
+     */
+    async build(config) {
+        const sections = [];
+        // Build TL section if agent can delegate
+        if (config.canDelegate && config.subordinates && config.subordinates.length > 0) {
+            const tlSection = await this.buildTeamLeadSection(config);
+            if (tlSection) {
+                sections.push(tlSection);
+            }
+        }
+        // Build team norms section if team exists
+        if (config.teamId) {
+            const normsSection = await this.buildTeamNormsSection(config.teamId, config.role);
+            if (normsSection) {
+                sections.push(normsSection);
+            }
+        }
+        return sections.join('\n\n---\n\n');
+    }
+    /**
+     * Build Team Lead section by loading tl-addon.md and resolving variables.
+     * Falls back to inline section if addon file not found.
+     *
+     * @param config - Module configuration with subordinate details
+     * @returns Formatted TL section or empty string
+     */
+    async buildTeamLeadSection(config) {
+        if (!config.subordinates || config.subordinates.length === 0) {
+            return '';
+        }
+        const workerList = config.subordinates
+            .map((sub) => `- **${sub.name}** (session: \`${sub.sessionName}\`, memberId: \`${sub.memberId}\`) — ${sub.role}`)
+            .join('\n');
+        // Try loading the comprehensive TL addon from file
+        const addonPath = path.join(config.projectRoot, 'config', 'roles', 'team-leader', 'tl-addon.md');
+        try {
+            await access(addonPath);
+            let addonContent = await readFile(addonPath, 'utf8');
+            // Resolve template variables
+            const variables = {
+                WORKER_LIST: workerList,
+                TL_SKILLS_PATH: config.tlSkillsPath,
+                TEAM_ID: config.teamId || '',
+                MEMBER_ID: config.memberId || '',
+                PROJECT_PATH: config.projectPath || '',
+                AGENT_SKILLS_PATH: config.agentSkillsPath,
+            };
+            for (const [key, value] of Object.entries(variables)) {
+                addonContent = addonContent.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value);
+            }
+            return addonContent.trim();
+        }
+        catch {
+            // Fallback to minimal inline section
+            return this.buildInlineTeamLeadSection(workerList, config.subordinates.length);
+        }
+    }
+    /**
+     * Build minimal inline TL section as fallback when tl-addon.md is not found.
+     *
+     * @param workerList - Pre-formatted worker list
+     * @param subordinateCount - Number of subordinates
+     * @returns Formatted inline TL section
+     */
+    buildInlineTeamLeadSection(workerList, subordinateCount) {
+        return `## Team Lead Responsibilities
+
+You manage ${subordinateCount} subordinate(s):
+
+${workerList}
+
+### Your TL Duties
+
+1. **Task Decomposition** — Break down large tasks into actionable sub-tasks
+2. **Delegation** — Assign sub-tasks to subordinates using \`send-message\`
+3. **Quality Review** — Review subordinates' work before reporting completion
+4. **Progress Reporting** — Report progress to the orchestrator via \`report-status\`
+5. **Unblocking** — Help subordinates when they are stuck`;
+    }
+    /**
+     * Build team norms section by loading norms files from team directory.
+     * Only includes norms whose role list matches the agent's role or '*'.
+     *
+     * @param teamId - Team ID to load norms for
+     * @param role - Agent's role for filtering
+     * @returns Formatted norms markdown or empty string
+     */
+    async buildTeamNormsSection(teamId, role) {
+        if (!teamId)
+            return '';
+        try {
+            const { existsSync, readdirSync, readFileSync } = await import('fs');
+            const crewlyHome = path.join(process.env['HOME'] || '/tmp', '.crewly');
+            const normsDir = path.join(crewlyHome, 'teams', teamId, 'norms');
+            if (!existsSync(normsDir))
+                return '';
+            const normFiles = readdirSync(normsDir).filter((f) => f.endsWith('.md'));
+            if (normFiles.length === 0)
+                return '';
+            const normalizedRole = role.toLowerCase().replace(/\s+/g, '-');
+            const sections = ['## Team Norms'];
+            for (const file of normFiles) {
+                const content = readFileSync(path.join(normsDir, file), 'utf8');
+                // Check if norm applies to this role (roles: line at top)
+                const rolesMatch = content.match(/^roles:\s*(.+)$/m);
+                if (rolesMatch) {
+                    const roles = rolesMatch[1].split(',').map((r) => r.trim().toLowerCase());
+                    if (!roles.includes('*') && !roles.includes(normalizedRole)) {
+                        continue;
+                    }
+                }
+                sections.push(content.trim());
+            }
+            return sections.length > 1 ? sections.join('\n\n') : '';
+        }
+        catch {
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=team-reference.module.js.map

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

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

package/dist/cli/backend/src/services/ai/prompt-modules/user-profile-reference.module.d.ts

@@ -0,0 +1,32 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * User profile reference module — tells the agent how to access user preferences
+ * and injects the actual shared profile data when available.
+ *
+ * Provides instructions for language matching, communication style adaptation,
+ * and accessing stored user preferences via recall/remember skills.
+ * When a SharedUserProfile exists at ~/.crewly/user-profile.json, its contents
+ * are appended as concrete context for the agent.
+ *
+ * Sources: Path B Section 10 (language matching), new user prefs system.
+ */
+export declare class UserProfileReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — agents should know how to adapt to user preferences.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the user profile reference section with instructions
+     * on how to discover and adapt to user preferences.
+     * When a shared user profile exists, its formatted content is appended.
+     *
+     * @param config - Module configuration with agent skill paths
+     * @returns Formatted markdown user profile reference section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=user-profile-reference.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/user-profile-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,qBAAa,0BAA2B,YAAW,YAAY;IAC9D,IAAI,SAA4B;IAChC,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAQ;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;;OAOG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAsClD"}

package/dist/cli/backend/src/services/ai/prompt-modules/user-profile-reference.module.js

@@ -0,0 +1,69 @@
+/**
+ * User profile reference module — tells the agent how to access user preferences
+ * and injects the actual shared profile data when available.
+ *
+ * Provides instructions for language matching, communication style adaptation,
+ * and accessing stored user preferences via recall/remember skills.
+ * When a SharedUserProfile exists at ~/.crewly/user-profile.json, its contents
+ * are appended as concrete context for the agent.
+ *
+ * Sources: Path B Section 10 (language matching), new user prefs system.
+ */
+export class UserProfileReferenceModule {
+    name = 'user_profile_reference';
+    priority = 9;
+    maxTokens = 200;
+    compactable = true;
+    /**
+     * Always included — agents should know how to adapt to user preferences.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the user profile reference section with instructions
+     * on how to discover and adapt to user preferences.
+     * When a shared user profile exists, its formatted content is appended.
+     *
+     * @param config - Module configuration with agent skill paths
+     * @returns Formatted markdown user profile reference section
+     */
+    async build(config) {
+        const instructions = `## User Preferences
+
+### Language Matching
+Match the user's language automatically:
+- If the user writes in Chinese, respond in Chinese
+- If the user writes in English, respond in English
+- For mixed-language messages, follow the dominant language
+
+### Accessing Preferences
+Use your memory tools to recall user-specific preferences:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/recall/execute.sh '{"agentId":"${config.sessionName}","context":"user preferences, communication style","projectPath":"${config.projectPath || ''}"}'
+\`\`\`
+
+When you discover a user preference (e.g., preferred detail level, communication style), store it:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/remember/execute.sh '{"agentId":"${config.sessionName}","content":"<preference>","category":"preference","scope":"agent","projectPath":"${config.projectPath || ''}"}'
+\`\`\`
+
+### Adaptation Rules
+- Adapt verbosity to user preference (concise vs detailed)
+- Mirror the user's formality level
+- Respect timezone and working hours when mentioned`;
+        // v2: Inject actual shared profile if available
+        try {
+            const { UserProfileService } = await import('../../memory/user-profile.service.js');
+            const profileContext = await UserProfileService.getInstance().generateProfileContext();
+            if (profileContext) {
+                return `${instructions}\n\n${profileContext}`;
+            }
+        }
+        catch {
+            // UserProfileService not available, skip
+        }
+        return instructions;
+    }
+}
+//# sourceMappingURL=user-profile-reference.module.js.map

package/dist/cli/backend/src/services/ai/prompt-modules/user-profile-reference.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/user-profile-reference.module.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,0BAA0B;IACtC,IAAI,GAAG,wBAAwB,CAAC;IAChC,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,MAAM,YAAY,GAAG;;;;;;;;;;;OAWhB,MAAM,CAAC,eAAe,wCAAwC,MAAM,CAAC,WAAW,sEAAsE,MAAM,CAAC,WAAW,IAAI,EAAE;;;;;OAK9K,MAAM,CAAC,eAAe,0CAA0C,MAAM,CAAC,WAAW,qFAAqF,MAAM,CAAC,WAAW,IAAI,EAAE;;;;;;oDAMlJ,CAAC;QAEnD,gDAAgD;QAChD,IAAI,CAAC;YACJ,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,sCAAsC,CAAC,CAAC;YACpF,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,CAAC,sBAAsB,EAAE,CAAC;YACvF,IAAI,cAAc,EAAE,CAAC;gBACpB,OAAO,GAAG,YAAY,OAAO,cAAc,EAAE,CAAC;YAC/C,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,yCAAyC;QAC1C,CAAC;QAED,OAAO,YAAY,CAAC;IACrB,CAAC;CACD"}

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

@@ -0,0 +1,91 @@
+/**
+ * Working-Memory Wake Card module — injects the "why am I awake right now"
+ * card into the agent prompt.
+ *
+ * Priority 8 — lands after every identity/role/team/skill/memory/team-reference
+ * module and after the Mission Card module (priority 7, owned by Leo's
+ * dead-code-path fix). This places the wake card as the *freshest* runtime
+ * context block the agent reads before it begins acting.
+ *
+ * The card itself is rendered by {@link WorkingMemoryService}; this module
+ * is a thin adapter that:
+ *
+ * 1. Decides whether to even attempt rendering (`shouldInclude`).
+ * 2. Maps {@link ModuleConfig} → {@link WakeCardRequest}.
+ * 3. Wraps the service call in a try/catch so any read failure fails soft —
+ *    the agent's prompt assembly never breaks because a wake-card lookup
+ *    threw. An empty card (no active WorkItem) also collapses to `''`,
+ *    causing {@link PromptAssemblyService} to drop the section entirely.
+ *
+ * Compactable: **false**. The wake card is already hard-capped at
+ * `WAKE_CARD_HARD_CAP_BYTES` (≈1.5KB) inside the service. The assembler's
+ * 50% trim heuristic would cut the structured "Required next action" /
+ * "Known constraints" sections mid-line — the very fields the agent must
+ * act on. Better to either keep the full card or drop it via the empty
+ * return path.
+ *
+ * **Architecture note (M2 dead-code-path fix, 2026-05-04):** A previous
+ * draft injected the wake card into `PromptGeneratorService.generateMemberPrompt`.
+ * That generator is **not** the live runtime prompt builder — every
+ * production agent is built through {@link PromptBuilderService} →
+ * {@link PromptAssemblyService}. Wiring here is the equivalent location
+ * Sam used for the team-leader soul / role-boundaries (P0-1 Phase 2) and
+ * the spot Leo's M1 mission-card module (priority 7) re-targets.
+ *
+ * @module services/ai/prompt-modules/working-memory
+ */
+import type { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Adapter module that injects the working-memory wake card produced by
+ * {@link WorkingMemoryService} into the agent prompt at priority 8.
+ *
+ * @example
+ * ```typescript
+ * const mod = new WorkingMemoryModule();
+ * if (mod.shouldInclude(config)) {
+ *   const card = await mod.build(config);
+ *   if (card) prompt += MODULE_SEPARATOR + card;
+ * }
+ * ```
+ */
+export declare class WorkingMemoryModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    private readonly logger;
+    constructor();
+    /**
+     * Decide whether to call the service at all.
+     *
+     * Returns false only when the inputs the service strictly needs are
+     * missing — `sessionName` (used to filter active WorkItems by target)
+     * and at least one of `projectPath` / `projectRoot` (used to load the
+     * parent Request JSON from `.crewly/requests/`). For SessionConfig-only
+     * legacy callers that drop projectPath, falling back to projectRoot
+     * keeps the module operational. When neither is available we skip
+     * cleanly rather than send a malformed request to the service.
+     *
+     * @param config - Module configuration
+     * @returns True when the module should attempt to build a wake card
+     */
+    shouldInclude(config: ModuleConfig): boolean;
+    /**
+     * Build the wake-card section by delegating to {@link WorkingMemoryService}.
+     *
+     * The service returns the empty string when no signals are available
+     * (no active WorkItem assigned to this agent). When that happens this
+     * method returns '' too — the assembler then drops the module entry
+     * instead of emitting an empty heading.
+     *
+     * Fail-soft: any thrown error is caught, logged, and converted to ''.
+     * `compactable=false` would normally cause the assembler to re-throw
+     * unhandled module errors, so swallowing here is required to prevent
+     * a wake-card lookup from breaking prompt assembly for the entire agent.
+     *
+     * @param config - Module configuration
+     * @returns The rendered wake card markdown, or '' when nothing to inject
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=working-memory.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"working-memory.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/working-memory.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAc/E;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,IAAI,SAAoB;IACxB,QAAQ,SAAK;IACb,SAAS,SAAwB;IACjC,WAAW,UAAS;IAEpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;;IAQzC;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAM5C;;;;;;;;;;;;;;;OAeG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CA+BnD"}

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

@@ -0,0 +1,136 @@
+/**
+ * Working-Memory Wake Card module — injects the "why am I awake right now"
+ * card into the agent prompt.
+ *
+ * Priority 8 — lands after every identity/role/team/skill/memory/team-reference
+ * module and after the Mission Card module (priority 7, owned by Leo's
+ * dead-code-path fix). This places the wake card as the *freshest* runtime
+ * context block the agent reads before it begins acting.
+ *
+ * The card itself is rendered by {@link WorkingMemoryService}; this module
+ * is a thin adapter that:
+ *
+ * 1. Decides whether to even attempt rendering (`shouldInclude`).
+ * 2. Maps {@link ModuleConfig} → {@link WakeCardRequest}.
+ * 3. Wraps the service call in a try/catch so any read failure fails soft —
+ *    the agent's prompt assembly never breaks because a wake-card lookup
+ *    threw. An empty card (no active WorkItem) also collapses to `''`,
+ *    causing {@link PromptAssemblyService} to drop the section entirely.
+ *
+ * Compactable: **false**. The wake card is already hard-capped at
+ * `WAKE_CARD_HARD_CAP_BYTES` (≈1.5KB) inside the service. The assembler's
+ * 50% trim heuristic would cut the structured "Required next action" /
+ * "Known constraints" sections mid-line — the very fields the agent must
+ * act on. Better to either keep the full card or drop it via the empty
+ * return path.
+ *
+ * **Architecture note (M2 dead-code-path fix, 2026-05-04):** A previous
+ * draft injected the wake card into `PromptGeneratorService.generateMemberPrompt`.
+ * That generator is **not** the live runtime prompt builder — every
+ * production agent is built through {@link PromptBuilderService} →
+ * {@link PromptAssemblyService}. Wiring here is the equivalent location
+ * Sam used for the team-leader soul / role-boundaries (P0-1 Phase 2) and
+ * the spot Leo's M1 mission-card module (priority 7) re-targets.
+ *
+ * @module services/ai/prompt-modules/working-memory
+ */
+import { WorkingMemoryService } from '../../memory/working-memory.service.js';
+import { LoggerService } from '../../core/logger.service.js';
+/**
+ * Token budget for the wake card.
+ *
+ * The service hard-caps card bytes at `WAKE_CARD_HARD_CAP_BYTES = 1536`.
+ * Using ~4 chars/token as the assembler's heuristic: 1536 / 4 ≈ 384.
+ * Round up to 400 to leave a small margin for the markdown heading and
+ * separators added during assembly.
+ */
+const WAKE_CARD_MAX_TOKENS = 400;
+/**
+ * Adapter module that injects the working-memory wake card produced by
+ * {@link WorkingMemoryService} into the agent prompt at priority 8.
+ *
+ * @example
+ * ```typescript
+ * const mod = new WorkingMemoryModule();
+ * if (mod.shouldInclude(config)) {
+ *   const card = await mod.build(config);
+ *   if (card) prompt += MODULE_SEPARATOR + card;
+ * }
+ * ```
+ */
+export class WorkingMemoryModule {
+    name = 'working-memory';
+    priority = 8;
+    maxTokens = WAKE_CARD_MAX_TOKENS;
+    compactable = false;
+    logger;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('WorkingMemoryModule');
+    }
+    /**
+     * Decide whether to call the service at all.
+     *
+     * Returns false only when the inputs the service strictly needs are
+     * missing — `sessionName` (used to filter active WorkItems by target)
+     * and at least one of `projectPath` / `projectRoot` (used to load the
+     * parent Request JSON from `.crewly/requests/`). For SessionConfig-only
+     * legacy callers that drop projectPath, falling back to projectRoot
+     * keeps the module operational. When neither is available we skip
+     * cleanly rather than send a malformed request to the service.
+     *
+     * @param config - Module configuration
+     * @returns True when the module should attempt to build a wake card
+     */
+    shouldInclude(config) {
+        if (!config.sessionName)
+            return false;
+        if (!config.projectPath && !config.projectRoot)
+            return false;
+        return true;
+    }
+    /**
+     * Build the wake-card section by delegating to {@link WorkingMemoryService}.
+     *
+     * The service returns the empty string when no signals are available
+     * (no active WorkItem assigned to this agent). When that happens this
+     * method returns '' too — the assembler then drops the module entry
+     * instead of emitting an empty heading.
+     *
+     * Fail-soft: any thrown error is caught, logged, and converted to ''.
+     * `compactable=false` would normally cause the assembler to re-throw
+     * unhandled module errors, so swallowing here is required to prevent
+     * a wake-card lookup from breaking prompt assembly for the entire agent.
+     *
+     * @param config - Module configuration
+     * @returns The rendered wake card markdown, or '' when nothing to inject
+     */
+    async build(config) {
+        const projectPath = config.projectPath ?? config.projectRoot;
+        if (!projectPath) {
+            // shouldInclude should have caught this, but defend anyway.
+            return '';
+        }
+        try {
+            const svc = WorkingMemoryService.getInstance();
+            const card = await svc.getWakeCardForAgent({
+                // memberId is more stable than sessionName for log correlation;
+                // fall back to sessionName when the legacy SessionConfig path
+                // omits memberId.
+                agentId: config.memberId || config.sessionName,
+                sessionName: config.sessionName,
+                projectPath,
+                teamId: config.teamId,
+            });
+            return card ?? '';
+        }
+        catch (err) {
+            this.logger.warn('WorkingMemoryModule build failed — skipping wake card injection', {
+                sessionName: config.sessionName,
+                memberId: config.memberId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=working-memory.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"working-memory.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/working-memory.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAmB,MAAM,8BAA8B,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,mBAAmB;IAC9B,IAAI,GAAG,gBAAgB,CAAC;IACxB,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,oBAAoB,CAAC;IACjC,WAAW,GAAG,KAAK,CAAC;IAEH,MAAM,CAAkB;IAEzC;QACE,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAC7D,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,MAAoB;QAChC,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC9B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC;QAC7D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,4DAA4D;YAC5D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAAC;gBACzC,gEAAgE;gBAChE,8DAA8D;gBAC9D,kBAAkB;gBAClB,OAAO,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,WAAW;gBAC9C,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,WAAW;gBACX,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;YACH,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,iEAAiE,EACjE;gBACE,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CACF,CAAC;YACF,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/cli/backend/src/services/ai/self-improvement/growth-areas.service.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A single growth area tracked for an agent.
+ */
+export interface GrowthArea {
+    /** Description of the growth area */
+    area: string;
+    /** Date the area was identified (ISO date string) */
+    identifiedAt: string;
+    /** Current progress status */
+    progress: 'identified' | 'improving' | 'proficient';
+    /** Evidence of progress or regression */
+    evidence: string[];
+}
+/**
+ * Persisted growth areas data structure.
+ */
+export interface GrowthAreasData {
+    /** List of tracked growth areas */
+    areas: GrowthArea[];
+    /** Last time the areas were reviewed (ISO date string) */
+    lastReviewedAt: string;
+}
+/**
+ * Service for tracking agent growth areas over time.
+ *
+ * Each agent maintains a growth-areas.json file that records areas
+ * where the agent is actively improving. Growth areas can be manually
+ * added or auto-extracted from learnings and failures.
+ *
+ * Storage: ~/.crewly/agents/{sessionName}/growth-areas.json
+ */
+export declare class GrowthAreasService {
+    /**
+     * Get the file path for an agent's growth areas.
+     *
+     * @param sessionName - Agent session name
+     * @returns Absolute path to growth-areas.json
+     */
+    private getFilePath;
+    /**
+     * Read growth areas data from disk.
+     *
+     * @param sessionName - Agent session name
+     * @returns Growth areas data, or empty default if file doesn't exist
+     */
+    getGrowthAreas(sessionName: string): Promise<GrowthAreasData>;
+    /**
+     * Add a new growth area for an agent.
+     *
+     * @param sessionName - Agent session name
+     * @param area - Description of the growth area
+     * @returns The created growth area
+     */
+    addGrowthArea(sessionName: string, area: string): Promise<GrowthArea>;
+    /**
+     * Update the progress of an existing growth area.
+     *
+     * @param sessionName - Agent session name
+     * @param area - Growth area description to update
+     * @param progress - New progress status
+     * @param evidence - Evidence supporting the progress update
+     * @returns Updated growth area or null if not found
+     */
+    updateProgress(sessionName: string, area: string, progress: 'identified' | 'improving' | 'proficient', evidence: string): Promise<GrowthArea | null>;
+    /**
+     * Auto-extract potential growth areas from a learning or failure text.
+     *
+     * @param sessionName - Agent session name
+     * @param text - Learning or failure text to analyze
+     * @returns Array of newly added growth areas (empty if no new areas found)
+     */
+    extractFromText(sessionName: string, text: string): Promise<GrowthArea[]>;
+    /**
+     * Persist growth areas data to disk.
+     *
+     * @param sessionName - Agent session name
+     * @param data - Growth areas data to save
+     */
+    private save;
+}
+//# sourceMappingURL=growth-areas.service.d.ts.map

package/dist/cli/backend/src/services/ai/self-improvement/growth-areas.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-areas.service.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/self-improvement/growth-areas.service.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;IACpD,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,mCAAmC;IACnC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;CACvB;AAkBD;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAKnB;;;;;OAKG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAUnE;;;;;;OAMG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAyB3E;;;;;;;;OAQG;IACG,cAAc,CACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,EACnD,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAkB7B;;;;;;OAMG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAoB/E;;;;;OAKG;YACW,IAAI;CAMlB"}