crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/services/memory/session-memory.service.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Session Memory Service
+ *
+ * Manages session lifecycle for agents: startup briefings, session summaries,
+ * and the project-level agents index. Coordinates with AgentMemoryService and
+ * ProjectMemoryService to assemble the context an agent needs when it starts
+ * a new work session and to persist what it learned when the session ends.
+ *
+ * Storage locations:
+ * - Session summaries: ~/.crewly/agents/{agentId}/sessions/
+ * - Agents index: {projectPath}/.crewly/agents-index.json
+ *
+ * @module services/memory/session-memory.service
+ */
+import type { StartupBriefing } from '../../types/memory.types.js';
+/**
+ * Service for managing agent session lifecycle
+ *
+ * Follows singleton pattern for consistent state management.
+ * Coordinates AgentMemoryService and ProjectMemoryService to build
+ * startup briefings and persist session summaries.
+ *
+ * @example
+ * ```typescript
+ * const sessionMemory = SessionMemoryService.getInstance();
+ * await sessionMemory.onSessionStart('dev-001', 'developer', '/projects/app');
+ *
+ * // ... agent works ...
+ *
+ * await sessionMemory.onSessionEnd('dev-001', 'developer', '/projects/app', 'Implemented auth');
+ * ```
+ */
+export declare class SessionMemoryService {
+    private static instance;
+    private readonly logger;
+    /**
+     * Creates a new SessionMemoryService instance
+     *
+     * Private constructor -- use {@link getInstance} to obtain the singleton.
+     */
+    private constructor();
+    /**
+     * Gets the singleton instance of SessionMemoryService
+     *
+     * @returns The singleton SessionMemoryService instance
+     */
+    static getInstance(): SessionMemoryService;
+    /**
+     * Clears the singleton instance (useful for testing)
+     */
+    static clearInstance(): void;
+    /**
+     * Returns the absolute path to the Crewly home directory (~/.crewly)
+     *
+     * @returns Absolute path to Crewly home
+     */
+    private getAgentmuxHome;
+    /**
+     * Returns the sessions archive directory for a given agent
+     *
+     * @param agentId - The agent's unique identifier
+     * @returns Absolute path to the agent's sessions directory
+     *
+     * @example
+     * ```typescript
+     * // Returns: ~/.crewly/agents/dev-001/sessions
+     * this.getSessionsDir('dev-001');
+     * ```
+     */
+    private getSessionsDir;
+    /**
+     * Safely reads a file and returns its contents as a string, or null if the
+     * file does not exist or cannot be read.
+     *
+     * @param filePath - Absolute path to the file
+     * @returns File contents or null on any error
+     */
+    private safeReadFile;
+    /**
+     * Truncates a string to a maximum number of characters, appending an
+     * ellipsis marker when truncation occurs.
+     *
+     * @param text - The input string
+     * @param maxChars - Maximum number of characters to retain
+     * @returns Truncated string (or original if within limit)
+     */
+    private truncate;
+    /**
+     * Called when an agent session starts
+     *
+     * Initializes both agent-level and project-level memory stores (if not
+     * already initialized) and updates the project agents index so that the
+     * orchestrator knows which agents have worked on a project.
+     *
+     * @param agentId - Unique identifier for the agent
+     * @param role - Agent's role (e.g., 'developer', 'qa', 'pm')
+     * @param projectPath - Absolute path to the project the agent is working on
+     *
+     * @example
+     * ```typescript
+     * await sessionMemory.onSessionStart('backend-dev-001', 'developer', '/home/user/project');
+     * ```
+     */
+    onSessionStart(agentId: string, role: string, projectPath: string): Promise<void>;
+    /**
+     * Called when an agent session ends
+     *
+     * Persists a timestamped session summary markdown file under the agent's
+     * sessions directory and also writes a `latest-summary.md` symlink-equivalent
+     * so that the next startup briefing can quickly locate the most recent summary.
+     *
+     * @param agentId - Unique identifier for the agent
+     * @param role - Agent's role
+     * @param projectPath - Absolute path to the project
+     * @param summary - Optional human-readable summary of what the agent accomplished
+     *
+     * @example
+     * ```typescript
+     * await sessionMemory.onSessionEnd(
+     *   'backend-dev-001',
+     *   'developer',
+     *   '/home/user/project',
+     *   'Implemented user authentication with JWT tokens and added integration tests.',
+     * );
+     * ```
+     */
+    onSessionEnd(agentId: string, role: string, projectPath: string, summary?: string): Promise<void>;
+    /**
+     * Generates a startup briefing for an agent that is about to begin a session
+     *
+     * Aggregates context from multiple sources:
+     * - The agent's most recent session summary
+     * - Agent-level knowledge, preferences, and performance data
+     * - Project-level patterns, decisions, and gotchas
+     * - Today's daily log, active goals, and learning files
+     *
+     * All reads are best-effort: a missing file simply produces a null or empty
+     * field rather than an error.
+     *
+     * @param agentId - Unique identifier for the agent
+     * @param role - Agent's role
+     * @param projectPath - Absolute path to the project
+     * @returns A {@link StartupBriefing} containing all available context
+     *
+     * @example
+     * ```typescript
+     * const briefing = await sessionMemory.generateStartupBriefing(
+     *   'backend-dev-001',
+     *   'developer',
+     *   '/home/user/project',
+     * );
+     * const markdown = sessionMemory.formatBriefingAsMarkdown(briefing);
+     * ```
+     */
+    generateStartupBriefing(agentId: string, role: string, projectPath: string): Promise<StartupBriefing>;
+    /**
+     * Formats a {@link StartupBriefing} into a markdown string suitable for
+     * prompt injection
+     *
+     * Only includes sections that have non-null, non-empty content. Long
+     * sections are truncated to keep the prompt within reasonable limits.
+     *
+     * @param briefing - The startup briefing to format
+     * @returns A markdown string ready for injection into the agent's system prompt
+     *
+     * @example
+     * ```typescript
+     * const briefing = await sessionMemory.generateStartupBriefing(id, role, path);
+     * const md = sessionMemory.formatBriefingAsMarkdown(briefing);
+     * // md is a string like "## Your Previous Knowledge\n\n### Last Session\n..."
+     * ```
+     */
+    formatBriefingAsMarkdown(briefing: StartupBriefing): string;
+    /**
+     * Updates the project-level agents index with an agent's latest activity
+     *
+     * The agents index lives at `{projectPath}/.crewly/agents-index.json` and
+     * tracks every agent that has worked on the project, along with the timestamp
+     * of their most recent activity.
+     *
+     * If the agent already exists in the index, only the `lastActive` and `role`
+     * fields are updated. Otherwise a new entry is appended.
+     *
+     * @param projectPath - Absolute path to the project
+     * @param agentId - The agent's unique identifier
+     * @param role - Agent's role
+     *
+     * @throws Rethrows file I/O errors other than ENOENT
+     *
+     * @example
+     * ```typescript
+     * await sessionMemory.updateAgentsIndex('/home/user/project', 'dev-001', 'developer');
+     * ```
+     */
+    updateAgentsIndex(projectPath: string, agentId: string, role: string): Promise<void>;
+}
+//# sourceMappingURL=session-memory.service.d.ts.map

package/dist/cli/backend/src/services/memory/session-memory.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/session-memory.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,OAAO,KAAK,EAAkB,eAAe,EAAuC,MAAM,6BAA6B,CAAC;AAQxH;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;IAE5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6E;IAEpG;;;;OAIG;IAEH,OAAO;IAEP;;;;OAIG;WACW,WAAW,IAAI,oBAAoB;IAOjD;;OAEG;WACW,aAAa,IAAI,IAAI;IAMnC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;;OAMG;YACW,YAAY;IAQ1B;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAShB;;;;;;;;;;;;;;;OAeG;IACU,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9F;;;;;;;;;;;;;;;;;;;;;OAqBG;IACU,YAAY,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAmChB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACU,uBAAuB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC;IA4D3B;;;;;;;;;;;;;;;;OAgBG;IACI,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM;IA2ClE;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BlG"}

package/dist/cli/backend/src/services/memory/session-memory.service.js

@@ -0,0 +1,369 @@
+/**
+ * Session Memory Service
+ *
+ * Manages session lifecycle for agents: startup briefings, session summaries,
+ * and the project-level agents index. Coordinates with AgentMemoryService and
+ * ProjectMemoryService to assemble the context an agent needs when it starts
+ * a new work session and to persist what it learned when the session ends.
+ *
+ * Storage locations:
+ * - Session summaries: ~/.crewly/agents/{agentId}/sessions/
+ * - Agents index: {projectPath}/.crewly/agents-index.json
+ *
+ * @module services/memory/session-memory.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { ensureDir, atomicWriteFile, safeReadJson, atomicWriteJson } from '../../utils/file-io.utils.js';
+import { MEMORY_CONSTANTS, CREWLY_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+import { AgentMemoryService } from './agent-memory.service.js';
+import { ProjectMemoryService } from './project-memory.service.js';
+/** Maximum number of characters to include from learning files */
+const LEARNING_TAIL_CHARS = 500;
+/** Maximum characters for a single briefing section before truncation */
+const MAX_SECTION_CHARS = 2000;
+/**
+ * Service for managing agent session lifecycle
+ *
+ * Follows singleton pattern for consistent state management.
+ * Coordinates AgentMemoryService and ProjectMemoryService to build
+ * startup briefings and persist session summaries.
+ *
+ * @example
+ * ```typescript
+ * const sessionMemory = SessionMemoryService.getInstance();
+ * await sessionMemory.onSessionStart('dev-001', 'developer', '/projects/app');
+ *
+ * // ... agent works ...
+ *
+ * await sessionMemory.onSessionEnd('dev-001', 'developer', '/projects/app', 'Implemented auth');
+ * ```
+ */
+export class SessionMemoryService {
+    static instance = null;
+    logger = LoggerService.getInstance().createComponentLogger('SessionMemoryService');
+    /**
+     * Creates a new SessionMemoryService instance
+     *
+     * Private constructor -- use {@link getInstance} to obtain the singleton.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    constructor() { }
+    /**
+     * Gets the singleton instance of SessionMemoryService
+     *
+     * @returns The singleton SessionMemoryService instance
+     */
+    static getInstance() {
+        if (!SessionMemoryService.instance) {
+            SessionMemoryService.instance = new SessionMemoryService();
+        }
+        return SessionMemoryService.instance;
+    }
+    /**
+     * Clears the singleton instance (useful for testing)
+     */
+    static clearInstance() {
+        SessionMemoryService.instance = null;
+    }
+    // ========================= HELPER METHODS =========================
+    /**
+     * Returns the absolute path to the Crewly home directory (~/.crewly)
+     *
+     * @returns Absolute path to Crewly home
+     */
+    getAgentmuxHome() {
+        return path.join(os.homedir(), CREWLY_CONSTANTS.PATHS.CREWLY_HOME);
+    }
+    /**
+     * Returns the sessions archive directory for a given agent
+     *
+     * @param agentId - The agent's unique identifier
+     * @returns Absolute path to the agent's sessions directory
+     *
+     * @example
+     * ```typescript
+     * // Returns: ~/.crewly/agents/dev-001/sessions
+     * this.getSessionsDir('dev-001');
+     * ```
+     */
+    getSessionsDir(agentId) {
+        return path.join(this.getAgentmuxHome(), MEMORY_CONSTANTS.PATHS.AGENTS_DIR, agentId, MEMORY_CONSTANTS.PATHS.SESSIONS_DIR);
+    }
+    /**
+     * Safely reads a file and returns its contents as a string, or null if the
+     * file does not exist or cannot be read.
+     *
+     * @param filePath - Absolute path to the file
+     * @returns File contents or null on any error
+     */
+    async safeReadFile(filePath) {
+        try {
+            return await fs.readFile(filePath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Truncates a string to a maximum number of characters, appending an
+     * ellipsis marker when truncation occurs.
+     *
+     * @param text - The input string
+     * @param maxChars - Maximum number of characters to retain
+     * @returns Truncated string (or original if within limit)
+     */
+    truncate(text, maxChars) {
+        if (text.length <= maxChars) {
+            return text;
+        }
+        return text.slice(0, maxChars) + '\n\n... (truncated)';
+    }
+    // ========================= PUBLIC INTERFACE =========================
+    /**
+     * Called when an agent session starts
+     *
+     * Initializes both agent-level and project-level memory stores (if not
+     * already initialized) and updates the project agents index so that the
+     * orchestrator knows which agents have worked on a project.
+     *
+     * @param agentId - Unique identifier for the agent
+     * @param role - Agent's role (e.g., 'developer', 'qa', 'pm')
+     * @param projectPath - Absolute path to the project the agent is working on
+     *
+     * @example
+     * ```typescript
+     * await sessionMemory.onSessionStart('backend-dev-001', 'developer', '/home/user/project');
+     * ```
+     */
+    async onSessionStart(agentId, role, projectPath) {
+        const agentMemory = AgentMemoryService.getInstance();
+        const projectMemory = ProjectMemoryService.getInstance();
+        // Initialize stores (both are idempotent if already created)
+        await agentMemory.initializeAgent(agentId, role);
+        await projectMemory.initializeProject(projectPath);
+        // Record this agent in the project agents index
+        await this.updateAgentsIndex(projectPath, agentId, role);
+        this.logger.info('Session started', { agentId, role, projectPath });
+    }
+    /**
+     * Called when an agent session ends
+     *
+     * Persists a timestamped session summary markdown file under the agent's
+     * sessions directory and also writes a `latest-summary.md` symlink-equivalent
+     * so that the next startup briefing can quickly locate the most recent summary.
+     *
+     * @param agentId - Unique identifier for the agent
+     * @param role - Agent's role
+     * @param projectPath - Absolute path to the project
+     * @param summary - Optional human-readable summary of what the agent accomplished
+     *
+     * @example
+     * ```typescript
+     * await sessionMemory.onSessionEnd(
+     *   'backend-dev-001',
+     *   'developer',
+     *   '/home/user/project',
+     *   'Implemented user authentication with JWT tokens and added integration tests.',
+     * );
+     * ```
+     */
+    async onSessionEnd(agentId, role, projectPath, summary) {
+        const sessionsDir = this.getSessionsDir(agentId);
+        await ensureDir(sessionsDir);
+        const now = new Date();
+        const isoTimestamp = now.toISOString();
+        // Build a YYYY-MM-DD-HH-MM filename from the current time
+        const pad = (n) => String(n).padStart(2, '0');
+        const fileName = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}-${pad(now.getHours())}-${pad(now.getMinutes())}.md`;
+        const content = [
+            '# Session Summary',
+            '',
+            `**Agent:** ${agentId}`,
+            `**Role:** ${role}`,
+            `**Project:** ${projectPath}`,
+            `**Ended:** ${isoTimestamp}`,
+            '',
+            '## Summary',
+            '',
+            summary || 'No summary provided',
+        ].join('\n');
+        // Write the timestamped archive file
+        const archivePath = path.join(sessionsDir, fileName);
+        await atomicWriteFile(archivePath, content);
+        // Write the latest-summary.md convenience file
+        const latestPath = path.join(sessionsDir, MEMORY_CONSTANTS.PATHS.LATEST_SUMMARY);
+        await atomicWriteFile(latestPath, content);
+        this.logger.info('Session ended', { agentId, role, projectPath, archiveFile: fileName });
+    }
+    /**
+     * Generates a startup briefing for an agent that is about to begin a session
+     *
+     * Aggregates context from multiple sources:
+     * - The agent's most recent session summary
+     * - Agent-level knowledge, preferences, and performance data
+     * - Project-level patterns, decisions, and gotchas
+     * - Today's daily log, active goals, and learning files
+     *
+     * All reads are best-effort: a missing file simply produces a null or empty
+     * field rather than an error.
+     *
+     * @param agentId - Unique identifier for the agent
+     * @param role - Agent's role
+     * @param projectPath - Absolute path to the project
+     * @returns A {@link StartupBriefing} containing all available context
+     *
+     * @example
+     * ```typescript
+     * const briefing = await sessionMemory.generateStartupBriefing(
+     *   'backend-dev-001',
+     *   'developer',
+     *   '/home/user/project',
+     * );
+     * const markdown = sessionMemory.formatBriefingAsMarkdown(briefing);
+     * ```
+     */
+    async generateStartupBriefing(agentId, role, projectPath) {
+        const crewlyDir = path.join(projectPath, CREWLY_CONSTANTS.PATHS.CREWLY_HOME);
+        // Read latest session summary
+        const latestSummaryPath = path.join(this.getSessionsDir(agentId), MEMORY_CONSTANTS.PATHS.LATEST_SUMMARY);
+        const lastSessionSummary = await this.safeReadFile(latestSummaryPath);
+        // Agent context (knowledge, preferences, performance)
+        let agentContext = '';
+        try {
+            agentContext = await AgentMemoryService.getInstance().generateAgentContext(agentId);
+        }
+        catch {
+            this.logger.debug('Failed to generate agent context', { agentId });
+        }
+        // Project context (patterns, decisions, gotchas)
+        let projectContext = '';
+        try {
+            projectContext = await ProjectMemoryService.getInstance().generateProjectContext(projectPath);
+        }
+        catch {
+            this.logger.debug('Failed to generate project context', { projectPath });
+        }
+        // Today's daily log
+        const today = new Date().toISOString().split('T')[0]; // YYYY-MM-DD
+        const dailyLogPath = path.join(crewlyDir, MEMORY_CONSTANTS.PATHS.DAILY_LOG_DIR, `${today}.md`);
+        const todaysDailyLog = await this.safeReadFile(dailyLogPath);
+        // Active goals
+        const goalsPath = path.join(crewlyDir, MEMORY_CONSTANTS.PATHS.GOALS_DIR, MEMORY_CONSTANTS.PATHS.GOALS_FILE);
+        const activeGoals = await this.safeReadFile(goalsPath);
+        // Recent failures (tail only)
+        const failedPath = path.join(crewlyDir, MEMORY_CONSTANTS.PATHS.LEARNING_DIR, MEMORY_CONSTANTS.PATHS.WHAT_FAILED_FILE);
+        const failedRaw = await this.safeReadFile(failedPath);
+        const recentFailures = failedRaw !== null
+            ? failedRaw.slice(-LEARNING_TAIL_CHARS)
+            : null;
+        // Recent successes (tail only)
+        const workedPath = path.join(crewlyDir, MEMORY_CONSTANTS.PATHS.LEARNING_DIR, MEMORY_CONSTANTS.PATHS.WHAT_WORKED_FILE);
+        const workedRaw = await this.safeReadFile(workedPath);
+        const recentSuccesses = workedRaw !== null
+            ? workedRaw.slice(-LEARNING_TAIL_CHARS)
+            : null;
+        return {
+            lastSessionSummary,
+            agentContext,
+            projectContext,
+            todaysDailyLog,
+            activeGoals,
+            recentFailures,
+            recentSuccesses,
+        };
+    }
+    /**
+     * Formats a {@link StartupBriefing} into a markdown string suitable for
+     * prompt injection
+     *
+     * Only includes sections that have non-null, non-empty content. Long
+     * sections are truncated to keep the prompt within reasonable limits.
+     *
+     * @param briefing - The startup briefing to format
+     * @returns A markdown string ready for injection into the agent's system prompt
+     *
+     * @example
+     * ```typescript
+     * const briefing = await sessionMemory.generateStartupBriefing(id, role, path);
+     * const md = sessionMemory.formatBriefingAsMarkdown(briefing);
+     * // md is a string like "## Your Previous Knowledge\n\n### Last Session\n..."
+     * ```
+     */
+    formatBriefingAsMarkdown(briefing) {
+        const sections = [];
+        sections.push('## Your Previous Knowledge');
+        if (briefing.lastSessionSummary) {
+            sections.push('### Last Session');
+            sections.push(this.truncate(briefing.lastSessionSummary, MAX_SECTION_CHARS));
+        }
+        if (briefing.agentContext) {
+            sections.push('### Your Agent Memory');
+            sections.push(this.truncate(briefing.agentContext, MAX_SECTION_CHARS));
+        }
+        if (briefing.projectContext) {
+            sections.push('### Project Knowledge');
+            sections.push(this.truncate(briefing.projectContext, MAX_SECTION_CHARS));
+        }
+        if (briefing.todaysDailyLog) {
+            sections.push("### Today's Activity");
+            sections.push(this.truncate(briefing.todaysDailyLog, MAX_SECTION_CHARS));
+        }
+        if (briefing.activeGoals) {
+            sections.push('### Active Goals');
+            sections.push(this.truncate(briefing.activeGoals, MAX_SECTION_CHARS));
+        }
+        if (briefing.recentFailures) {
+            sections.push('### Recent Failures (avoid repeating)');
+            sections.push(briefing.recentFailures);
+        }
+        if (briefing.recentSuccesses) {
+            sections.push('### Recent Successes (replicate)');
+            sections.push(briefing.recentSuccesses);
+        }
+        return sections.join('\n\n').trim();
+    }
+    /**
+     * Updates the project-level agents index with an agent's latest activity
+     *
+     * The agents index lives at `{projectPath}/.crewly/agents-index.json` and
+     * tracks every agent that has worked on the project, along with the timestamp
+     * of their most recent activity.
+     *
+     * If the agent already exists in the index, only the `lastActive` and `role`
+     * fields are updated. Otherwise a new entry is appended.
+     *
+     * @param projectPath - Absolute path to the project
+     * @param agentId - The agent's unique identifier
+     * @param role - Agent's role
+     *
+     * @throws Rethrows file I/O errors other than ENOENT
+     *
+     * @example
+     * ```typescript
+     * await sessionMemory.updateAgentsIndex('/home/user/project', 'dev-001', 'developer');
+     * ```
+     */
+    async updateAgentsIndex(projectPath, agentId, role) {
+        const indexPath = path.join(projectPath, CREWLY_CONSTANTS.PATHS.CREWLY_HOME, MEMORY_CONSTANTS.PATHS.AGENTS_INDEX);
+        // Ensure the parent directory exists
+        await ensureDir(path.dirname(indexPath));
+        const defaultIndex = { agents: [] };
+        const index = await safeReadJson(indexPath, defaultIndex, this.logger);
+        const now = new Date().toISOString();
+        const existingIdx = index.agents.findIndex((a) => a.agentId === agentId);
+        if (existingIdx >= 0) {
+            index.agents[existingIdx].lastActive = now;
+            index.agents[existingIdx].role = role;
+        }
+        else {
+            const entry = { agentId, role, lastActive: now };
+            index.agents.push(entry);
+        }
+        await atomicWriteJson(indexPath, index);
+        this.logger.debug('Updated agents index', { projectPath, agentId, role });
+    }
+}
+//# sourceMappingURL=session-memory.service.js.map

package/dist/cli/backend/src/services/memory/session-memory.service.js.map

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

package/dist/cli/backend/src/services/memory/user-profile.service.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Shared User Profile Service
+ *
+ * Manages a single user profile stored at ~/.crewly/user-profile.json that
+ * ALL agents can read. The orchestrator is the primary writer, but any agent
+ * may update it. This eliminates per-agent preference fragmentation by
+ * providing a single source of truth for user preferences.
+ *
+ * Features:
+ * - Read-through cache with configurable TTL (30s default)
+ * - Deep merge for preferences, append-only for notes and prohibitions
+ * - Prompt-injectable context generation for agent system prompts
+ *
+ * @module services/memory/user-profile.service
+ */
+import type { SharedUserProfile } from '../../types/memory.types.js';
+/**
+ * Service for managing the shared user profile.
+ * All agents read from this; orchestrator is the primary writer.
+ * Stored at ~/.crewly/user-profile.json
+ */
+export declare class UserProfileService {
+    private static instance;
+    private logger;
+    private profilePath;
+    private cache;
+    private cacheTime;
+    /** Cache time-to-live in milliseconds */
+    static CACHE_TTL_MS: number;
+    /**
+     * Create a new UserProfileService instance.
+     *
+     * @param crewlyHome - Override for the user home directory (defaults to $HOME)
+     */
+    constructor(crewlyHome?: string);
+    /**
+     * Get or create the singleton instance.
+     *
+     * @param crewlyHome - Override for the user home directory
+     * @returns The singleton UserProfileService instance
+     */
+    static getInstance(crewlyHome?: string): UserProfileService;
+    /**
+     * Clear the singleton instance. Used for testing.
+     */
+    static clearInstance(): void;
+    /**
+     * Get the current user profile. Returns empty profile if none exists.
+     * Results are cached for CACHE_TTL_MS milliseconds.
+     *
+     * @returns The current shared user profile, or an empty object if not yet created
+     */
+    getProfile(): Promise<SharedUserProfile>;
+    /**
+     * Update the user profile with partial updates (deep merge).
+     *
+     * Merge strategy:
+     * - Top-level scalar fields are overwritten
+     * - `preferences` object is shallow-merged (existing keys preserved, new keys added)
+     * - `notes` array is appended (duplicates filtered)
+     * - `prohibitions` array is appended (deduplicated via Set)
+     * - `updatedAt` and `updatedBy` are always set
+     *
+     * @param updates - Partial profile fields to merge
+     * @param updatedBy - Identifier of who is updating (agentId or 'user')
+     * @returns The merged profile after saving
+     */
+    updateProfile(updates: Partial<SharedUserProfile>, updatedBy: string): Promise<SharedUserProfile>;
+    /**
+     * Generate a formatted markdown string for prompt injection.
+     * Returns null if the profile is empty or contains only metadata fields.
+     *
+     * @returns Formatted markdown string with user profile context, or null if empty
+     */
+    generateProfileContext(): Promise<string | null>;
+}
+//# sourceMappingURL=user-profile.service.d.ts.map

package/dist/cli/backend/src/services/memory/user-profile.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/user-profile.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,SAAS,CAAK;IAEtB,yCAAyC;IACzC,MAAM,CAAC,YAAY,SAAS;IAE5B;;;;OAIG;gBACS,UAAU,CAAC,EAAE,MAAM;IAM/B;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,kBAAkB;IAO3D;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAmB9C;;;;;;;;;;;;;OAaG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqCvG;;;;;OAKG;IACG,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA6BvD"}