crewly 1.4.82 → 1.5.0

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

@@ -0,0 +1,353 @@
+/**
+ * Goal Tracking Service
+ *
+ * Manages project-level goal files, current team focus, and a decisions log
+ * with retrospective outcomes. All files are stored as Markdown under
+ * `{projectPath}/.crewly/goals/`.
+ *
+ * Files managed:
+ * - `goals.md` — Append-only log of user-stated goals
+ * - `current_focus.md` — Overwritten each time the team focus changes
+ * - `decisions_log.md` — Append-only decisions with mutable outcome sections
+ *
+ * @module services/memory/goal-tracking.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { ensureDir, atomicWriteFile } from '../../utils/file-io.utils.js';
+import { MEMORY_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+/**
+ * Service for tracking project goals, team focus, and architectural decisions.
+ *
+ * Follows the singleton pattern for consistent state management across
+ * the backend. Uses atomic writes for full-file overwrites and plain
+ * `fs.appendFile` for append-only logs (goals, decisions) where partial
+ * writes are acceptable.
+ *
+ * @example
+ * ```typescript
+ * const goalService = GoalTrackingService.getInstance();
+ *
+ * // Set a project goal
+ * await goalService.setGoal('/path/to/project', 'Ship v2.0 by March 15th', 'user');
+ *
+ * // Update team focus
+ * await goalService.updateFocus('/path/to/project', 'Completing auth module');
+ *
+ * // Log a decision
+ * const decId = await goalService.logDecision('/path/to/project', {
+ *   title: 'Use PostgreSQL over MongoDB',
+ *   decision: 'PostgreSQL for primary data store',
+ *   rationale: 'Relational data model fits our schema better',
+ *   decidedBy: 'orchestrator',
+ *   alternatives: ['MongoDB', 'DynamoDB'],
+ * });
+ *
+ * // Later, record the outcome
+ * await goalService.updateDecisionOutcome(
+ *   '/path/to/project',
+ *   decId,
+ *   'Successful - query performance is excellent',
+ *   'Invest time in schema design upfront to avoid migrations',
+ * );
+ * ```
+ */
+export class GoalTrackingService {
+    static instance = null;
+    /** Monotonic counter to ensure unique decision IDs even within the same millisecond */
+    decisionCounter = 0;
+    logger = LoggerService.getInstance().createComponentLogger('GoalTrackingService');
+    /**
+     * Creates a new GoalTrackingService instance.
+     * Use {@link getInstance} for the singleton.
+     */
+    constructor() {
+        // No initialization needed — all paths are derived from projectPath at call time
+    }
+    /**
+     * Gets the singleton instance of GoalTrackingService.
+     *
+     * @returns The singleton GoalTrackingService instance
+     */
+    static getInstance() {
+        if (!GoalTrackingService.instance) {
+            GoalTrackingService.instance = new GoalTrackingService();
+        }
+        return GoalTrackingService.instance;
+    }
+    /**
+     * Clears the singleton instance.
+     * Intended for test isolation only — never call in production.
+     */
+    static clearInstance() {
+        GoalTrackingService.instance = null;
+    }
+    // ========================= HELPERS =========================
+    /**
+     * Returns the absolute path to the goals directory for a project.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @returns Absolute path to `{projectPath}/.crewly/goals`
+     */
+    getGoalsDir(projectPath) {
+        return path.join(projectPath, '.crewly', MEMORY_CONSTANTS.PATHS.GOALS_DIR);
+    }
+    /**
+     * Safely reads a file and returns its content, or `null` if the file
+     * does not exist.
+     *
+     * Permission errors and other unexpected failures are re-thrown.
+     *
+     * @param filePath - Absolute path to the file
+     * @returns File content as a UTF-8 string, or `null` if not found
+     */
+    async safeReadFile(filePath) {
+        try {
+            return await fs.readFile(filePath, 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    // ========================= PUBLIC INTERFACE =========================
+    /**
+     * Appends a new goal entry to `goals.md`.
+     *
+     * If the file does not yet exist it is created with a Markdown header
+     * before the first entry is appended.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @param goal - The goal text to record
+     * @param setBy - Who set the goal (defaults to `'user'`)
+     *
+     * @example
+     * ```typescript
+     * await goalService.setGoal('/projects/phoenix', 'Achieve 80% test coverage', 'user');
+     * ```
+     */
+    async setGoal(projectPath, goal, setBy = 'user') {
+        const goalsDir = this.getGoalsDir(projectPath);
+        await ensureDir(goalsDir);
+        const goalsFile = path.join(goalsDir, MEMORY_CONSTANTS.PATHS.GOALS_FILE);
+        const existing = await this.safeReadFile(goalsFile);
+        const timestamp = new Date().toISOString();
+        const entry = `\n### [${timestamp}] Set by ${setBy}\n${goal}\n`;
+        if (existing === null) {
+            const header = `# Project Goals\n\n`;
+            await fs.writeFile(goalsFile, header + entry, 'utf-8');
+            this.logger.debug('Created goals file with first entry', { projectPath, setBy });
+        }
+        else {
+            await fs.appendFile(goalsFile, entry, 'utf-8');
+            this.logger.debug('Appended goal entry', { projectPath, setBy });
+        }
+    }
+    /**
+     * Reads and returns the full contents of `goals.md`.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @returns The goals file content, or `null` if the file does not exist
+     *
+     * @example
+     * ```typescript
+     * const goals = await goalService.getGoals('/projects/phoenix');
+     * if (goals) {
+     *   console.log(goals);
+     * }
+     * ```
+     */
+    async getGoals(projectPath) {
+        const goalsFile = path.join(this.getGoalsDir(projectPath), MEMORY_CONSTANTS.PATHS.GOALS_FILE);
+        return this.safeReadFile(goalsFile);
+    }
+    /**
+     * Overwrites `current_focus.md` with the new focus description.
+     *
+     * Uses {@link atomicWriteFile} to ensure the file is never left in a
+     * partial-write state.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @param focus - The new focus description
+     * @param updatedBy - Who updated the focus (defaults to `'orchestrator'`)
+     *
+     * @example
+     * ```typescript
+     * await goalService.updateFocus(
+     *   '/projects/phoenix',
+     *   'Completing the authentication module and writing integration tests',
+     *   'orchestrator',
+     * );
+     * ```
+     */
+    async updateFocus(projectPath, focus, updatedBy = 'orchestrator') {
+        const goalsDir = this.getGoalsDir(projectPath);
+        await ensureDir(goalsDir);
+        const focusFile = path.join(goalsDir, MEMORY_CONSTANTS.PATHS.FOCUS_FILE);
+        const timestamp = new Date().toISOString();
+        const content = `# Current Focus\n` +
+            `\n` +
+            `**Updated:** ${timestamp}\n` +
+            `**By:** ${updatedBy}\n` +
+            `\n` +
+            `${focus}\n`;
+        await atomicWriteFile(focusFile, content);
+        this.logger.debug('Updated current focus', { projectPath, updatedBy });
+    }
+    /**
+     * Reads and returns the full contents of `current_focus.md`.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @returns The current focus file content, or `null` if the file does not exist
+     *
+     * @example
+     * ```typescript
+     * const focus = await goalService.getCurrentFocus('/projects/phoenix');
+     * ```
+     */
+    async getCurrentFocus(projectPath) {
+        const focusFile = path.join(this.getGoalsDir(projectPath), MEMORY_CONSTANTS.PATHS.FOCUS_FILE);
+        return this.safeReadFile(focusFile);
+    }
+    /**
+     * Appends a new decision entry to `decisions_log.md` and returns a
+     * unique decision ID.
+     *
+     * If the file does not yet exist it is created with a Markdown header
+     * before the first entry is appended.
+     *
+     * The outcome field is initially set to `_pending_` and can be updated
+     * later via {@link updateDecisionOutcome}.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @param decision - Decision parameters (title, decision, rationale, etc.)
+     * @returns The generated decision ID (format: `dec-{timestamp}-{counter}`)
+     *
+     * @throws {Error} If the file system write fails
+     *
+     * @example
+     * ```typescript
+     * const decisionId = await goalService.logDecision('/projects/phoenix', {
+     *   title: 'Use Redis for caching',
+     *   decision: 'Redis over Memcached',
+     *   rationale: 'Better data structure support and persistence options',
+     *   decidedBy: 'orchestrator',
+     *   alternatives: ['Memcached', 'In-memory Map'],
+     * });
+     * // decisionId => 'dec-1707500000000-0'
+     * ```
+     */
+    async logDecision(projectPath, decision) {
+        const goalsDir = this.getGoalsDir(projectPath);
+        await ensureDir(goalsDir);
+        const decisionsFile = path.join(goalsDir, MEMORY_CONSTANTS.PATHS.DECISIONS_LOG);
+        const existing = await this.safeReadFile(decisionsFile);
+        const timestamp = new Date().toISOString();
+        const decisionId = `dec-${Date.now()}-${this.decisionCounter++}`;
+        const alternativesText = decision.alternatives?.join(', ') || 'None recorded';
+        const entry = `\n## [${decisionId}] ${decision.title}\n` +
+            `**Date:** ${timestamp}\n` +
+            `**By:** ${decision.decidedBy}\n` +
+            `**Decision:** ${decision.decision}\n` +
+            `**Rationale:** ${decision.rationale}\n` +
+            `**Alternatives:** ${alternativesText}\n` +
+            `**Outcome:** _pending_\n` +
+            `\n---\n`;
+        if (existing === null) {
+            const header = `# Decisions Log\n\n`;
+            await fs.writeFile(decisionsFile, header + entry, 'utf-8');
+            this.logger.debug('Created decisions log with first entry', { projectPath, decisionId });
+        }
+        else {
+            await fs.appendFile(decisionsFile, entry, 'utf-8');
+            this.logger.debug('Appended decision entry', { projectPath, decisionId });
+        }
+        return decisionId;
+    }
+    /**
+     * Updates the outcome of a previously logged decision.
+     *
+     * Reads `decisions_log.md`, locates the section matching the given
+     * `decisionId`, replaces the `**Outcome:** _pending_` line with the
+     * actual outcome (plus optional learnings and a timestamp), and writes
+     * the file back atomically.
+     *
+     * If the decision ID is not found or the file does not exist, a warning
+     * is logged and the method returns without throwing.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @param decisionId - The decision ID returned by {@link logDecision}
+     * @param outcome - Description of the actual outcome
+     * @param learnings - Optional lessons learned from this decision
+     *
+     * @example
+     * ```typescript
+     * await goalService.updateDecisionOutcome(
+     *   '/projects/phoenix',
+     *   'dec-1707500000000',
+     *   'Successful - Redis reduced API latency by 40%',
+     *   'Set explicit TTLs on all cache keys to prevent stale data',
+     * );
+     * ```
+     */
+    async updateDecisionOutcome(projectPath, decisionId, outcome, learnings) {
+        const decisionsFile = path.join(this.getGoalsDir(projectPath), MEMORY_CONSTANTS.PATHS.DECISIONS_LOG);
+        const content = await this.safeReadFile(decisionsFile);
+        if (content === null) {
+            this.logger.warn('Decisions log not found, cannot update outcome', { projectPath, decisionId });
+            return;
+        }
+        // Verify the decision ID exists in the file
+        if (!content.includes(`[${decisionId}]`)) {
+            this.logger.warn('Decision ID not found in decisions log', { projectPath, decisionId });
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        const learningsText = learnings || 'None recorded';
+        const replacement = `**Outcome:** ${outcome}\n` +
+            `**Learnings:** ${learningsText}\n` +
+            `**Recorded:** ${timestamp}`;
+        // Replace the first occurrence of _pending_ that belongs to this decision.
+        // We find the decision section header then replace the pending outcome within it.
+        const sectionMarker = `[${decisionId}]`;
+        const sectionStart = content.indexOf(sectionMarker);
+        if (sectionStart === -1) {
+            this.logger.warn('Decision section not found', { projectPath, decisionId });
+            return;
+        }
+        // Find the **Outcome:** _pending_ line within this decision's section
+        const pendingPattern = '**Outcome:** _pending_';
+        const pendingIndex = content.indexOf(pendingPattern, sectionStart);
+        if (pendingIndex === -1) {
+            this.logger.warn('Decision outcome already recorded or not in pending state', { projectPath, decisionId });
+            return;
+        }
+        const updatedContent = content.substring(0, pendingIndex) +
+            replacement +
+            content.substring(pendingIndex + pendingPattern.length);
+        await atomicWriteFile(decisionsFile, updatedContent);
+        this.logger.debug('Updated decision outcome', { projectPath, decisionId });
+    }
+    /**
+     * Reads and returns the full contents of `decisions_log.md`.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @returns The decisions log content, or `null` if the file does not exist
+     *
+     * @example
+     * ```typescript
+     * const log = await goalService.getDecisionsLog('/projects/phoenix');
+     * if (log) {
+     *   console.log(log);
+     * }
+     * ```
+     */
+    async getDecisionsLog(projectPath) {
+        const decisionsFile = path.join(this.getGoalsDir(projectPath), MEMORY_CONSTANTS.PATHS.DECISIONS_LOG);
+        return this.safeReadFile(decisionsFile);
+    }
+}
+//# sourceMappingURL=goal-tracking.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goal-tracking.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/goal-tracking.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAkB1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAC,QAAQ,GAA+B,IAAI,CAAC;IAE3D,uFAAuF;IAC/E,eAAe,GAAG,CAAC,CAAC;IAEX,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,CAAC;IAEnG;;;OAGG;IACH;QACE,iFAAiF;IACnF,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC;YAClC,mBAAmB,CAAC,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAC;QAC3D,CAAC;QACD,OAAO,mBAAmB,CAAC,QAAQ,CAAC;IACtC,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,aAAa;QACzB,mBAAmB,CAAC,QAAQ,GAAG,IAAI,CAAC;IACtC,CAAC;IAED,8DAA8D;IAE9D;;;;;OAKG;IACK,WAAW,CAAC,WAAmB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,YAAY,CAAC,QAAgB;QACzC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,uEAAuE;IAEvE;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,IAAY,EAAE,QAAgB,MAAM;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAEpD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,UAAU,SAAS,YAAY,KAAK,KAAK,IAAI,IAAI,CAAC;QAEhE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,qBAAqB,CAAC;YACrC,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QACnF,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,KAAK,CAAC,QAAQ,CAAC,WAAmB;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACI,KAAK,CAAC,WAAW,CAAC,WAAmB,EAAE,KAAa,EAAE,YAAoB,cAAc;QAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACzE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,MAAM,OAAO,GACX,mBAAmB;YACnB,IAAI;YACJ,gBAAgB,SAAS,IAAI;YAC7B,WAAW,SAAS,IAAI;YACxB,IAAI;YACJ,GAAG,KAAK,IAAI,CAAC;QAEf,MAAM,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,eAAe,CAAC,WAAmB;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACI,KAAK,CAAC,WAAW,CAAC,WAAmB,EAAE,QAAwB;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE1B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAChF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QAExD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACjE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC;QAE9E,MAAM,KAAK,GACT,SAAS,UAAU,KAAK,QAAQ,CAAC,KAAK,IAAI;YAC1C,aAAa,SAAS,IAAI;YAC1B,WAAW,QAAQ,CAAC,SAAS,IAAI;YACjC,iBAAiB,QAAQ,CAAC,QAAQ,IAAI;YACtC,kBAAkB,QAAQ,CAAC,SAAS,IAAI;YACxC,qBAAqB,gBAAgB,IAAI;YACzC,0BAA0B;YAC1B,SAAS,CAAC;QAEZ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,qBAAqB,CAAC;YACrC,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3F,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACI,KAAK,CAAC,qBAAqB,CAChC,WAAmB,EACnB,UAAkB,EAClB,OAAe,EACf,SAAkB;QAElB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACrG,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QAEvD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gDAAgD,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;YAChG,OAAO;QACT,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;YACxF,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,aAAa,GAAG,SAAS,IAAI,eAAe,CAAC;QACnD,MAAM,WAAW,GACf,gBAAgB,OAAO,IAAI;YAC3B,kBAAkB,aAAa,IAAI;YACnC,iBAAiB,SAAS,EAAE,CAAC;QAE/B,2EAA2E;QAC3E,kFAAkF;QAClF,MAAM,aAAa,GAAG,IAAI,UAAU,GAAG,CAAC;QACxC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAEpD,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,sEAAsE;QACtE,MAAM,cAAc,GAAG,wBAAwB,CAAC;QAChD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QAEnE,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2DAA2D,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;YAC3G,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAClB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,YAAY,CAAC;YAClC,WAAW;YACX,OAAO,CAAC,SAAS,CAAC,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAE1D,MAAM,eAAe,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,KAAK,CAAC,eAAe,CAAC,WAAmB;QAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACrG,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC"}

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

@@ -10,6 +10,7 @@ import { IAgentMemoryService } from './agent-memory.service.js';
 import { IProjectMemoryService } from './project-memory.service.js';
 import type { KnowledgeDocumentSummary } from '../../types/knowledge.types.js';
 import type { PatternCategory, GotchaSeverity } from '../../types/memory.types.js';
+import type { TaskTrackingService } from '../project/task-tracking.service.js';
 /**
  * Categories for the unified remember operation
  */
@@ -58,6 +59,16 @@ export interface RememberParams {
         relationshipType?: 'depends-on' | 'uses' | 'extends' | 'implements' | 'calls' | 'imported-by';
         /** Target component for relationships */
         targetComponent?: string;
+        /** Task ID where this knowledge was learned */
+        sourceTaskId?: string;
+        /** Objective/goal ID this knowledge relates to */
+        sourceObjectiveId?: string;
+        /** Outcome of the task where this was learned */
+        sourceOutcome?: string;
+        /** What contexts/domains this knowledge applies to */
+        appliesTo?: string[];
+        /** ID of entry being superseded by this one */
+        supersedes?: string;
     };
 }
 /**
@@ -87,6 +98,17 @@ export interface RecallResult {
     combined: string;
     /** Matching knowledge documents (optional, from knowledge base search) */
     knowledgeDocuments?: KnowledgeDocumentSummary[];
+    /** Current project goals (if projectPath provided) */
+    activeGoals?: string[];
+    /** Current team focus (if projectPath provided) */
+    currentFocus?: string;
+    /** Active tasks for this agent */
+    activeTasks?: Array<{
+        id: string;
+        name: string;
+        status: string;
+        hasWorkingNotes: boolean;
+    }>;
 }
 /**
  * Parameters for recording a learning
@@ -148,6 +170,8 @@ export declare class MemoryService implements IMemoryService {
     private static instance;
     private readonly agentMemory;
     private readonly projectMemory;
+    /** Shared or lazily-cached TaskTrackingService instance for operational context enrichment */
+    private taskTrackingServiceRef;
     private readonly logger;
     private embeddingProvider;
     private embeddingProviderInitialized;
@@ -155,6 +179,20 @@ export declare class MemoryService implements IMemoryService {
      * Creates a new MemoryService instance
      */
     private constructor();
+    /**
+     * Set the shared TaskTrackingService instance to avoid creating
+     * disposable instances on every recall. Call during app startup.
+     *
+     * @param service - The application's shared TaskTrackingService
+     */
+    setTaskTrackingService(service: TaskTrackingService): void;
+    /**
+     * Get or lazily create a TaskTrackingService.
+     * Prefers the shared instance set via setTaskTrackingService().
+     *
+     * @returns TaskTrackingService instance
+     */
+    private getTaskTrackingService;
     /**
      * Lazily initializes the embedding provider on first use.
      * Returns null if no embedding API key is configured.
@@ -298,6 +336,11 @@ export declare class MemoryService implements IMemoryService {
      * ```
      */
     recall(params: RecallParams): Promise<RecallResult>;
+    /**
+     * Enrich recall result with operational context: goals, focus, active tasks.
+     * All lookups are non-fatal — missing data is silently skipped.
+     */
+    private enrichWithOperationalContext;
     /**
      * Searches knowledge documents across global and project scopes.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"memory.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/memory.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/memory.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAsB,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAwB,qBAAqB,EAAiB,MAAM,6BAA6B,CAAC;AAOzG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,KAAK,EAGV,eAAe,EACf,cAAc,EAGf,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,SAAS,GACT,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,iBAAiB,GACjB,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,8BAA8B;IAC9B,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE;QACT,qCAAqC;QACrC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,2CAA2C;QAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,uBAAuB;QACvB,eAAe,CAAC,EAAE,eAAe,CAAC;QAClC,mBAAmB;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,oBAAoB;QACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,8BAA8B;QAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,4CAA4C;QAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,kCAAkC;QAClC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,2BAA2B;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,2BAA2B;QAC3B,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,wBAAwB;QACxB,gBAAgB,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,aAAa,CAAC;QAC9F,yCAAyC;QACzC,eAAe,CAAC,EAAE,MAAM,CAAC;QAIzB,+CAA+C;QAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,kDAAkD;QAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,iDAAiD;QACjD,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,sDAAsD;QACtD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,+CAA+C;QAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,EAAE,WAAW,CAAC;IACnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kCAAkC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAIhD,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC7F;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,qBAAqB,IAAI,mBAAmB,CAAC;IAC7C,uBAAuB,IAAI,qBAAqB,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IAErD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,8FAA8F;IAC9F,OAAO,CAAC,sBAAsB,CAAoC;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsE;IAC7F,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,4BAA4B,CAAS;IAE7C;;OAEG;IACH,OAAO;IAKP;;;;;OAKG;IACI,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAIjE;;;;;OAKG;YACW,sBAAsB;IAUpC;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAItB;;;;OAIG;WACW,WAAW,IAAI,aAAa;IAO1C;;OAEG;WACW,aAAa,IAAI,IAAI;IAMnC;;;;OAIG;IACI,qBAAqB,IAAI,mBAAmB;IAInD;;;;OAIG;IACI,uBAAuB,IAAI,qBAAqB;IAIvD;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAa9B;;OAEG;IACH,OAAO,CAAC,eAAe;IA2BvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAwCvB;;;;;;;;;OASG;YACW,WAAW;IAwBzB;;;;;;;;;;OAUG;YACW,cAAc;IAoC5B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACU,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAgC9D;;OAEG;YACW,gBAAgB;IA4B9B;;OAEG;YACW,kBAAkB;IAoEhC;;;;;;;;;;;;;;;;;OAiBG;IACU,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IA4FhE;;;OAGG;YACW,4BAA4B;IA0C1C;;;;;;OAMG;YACW,wBAAwB;IAkCtC;;;;;;OAMG;IACU,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBlF;;;;OAIG;IACU,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmClE;;;;;;OAMG;IACU,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpG;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,mBAAmB,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC;CAyCrB"}

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

@@ -46,6 +46,8 @@ export class MemoryService {
     static instance = null;
     agentMemory;
     projectMemory;
+    /** Shared or lazily-cached TaskTrackingService instance for operational context enrichment */
+    taskTrackingServiceRef = null;
     logger = LoggerService.getInstance().createComponentLogger('MemoryService');
     embeddingProvider = null;
     embeddingProviderInitialized = false;
@@ -56,6 +58,30 @@ export class MemoryService {
         this.agentMemory = AgentMemoryService.getInstance();
         this.projectMemory = ProjectMemoryService.getInstance();
     }
+    /**
+     * Set the shared TaskTrackingService instance to avoid creating
+     * disposable instances on every recall. Call during app startup.
+     *
+     * @param service - The application's shared TaskTrackingService
+     */
+    setTaskTrackingService(service) {
+        this.taskTrackingServiceRef = service;
+    }
+    /**
+     * Get or lazily create a TaskTrackingService.
+     * Prefers the shared instance set via setTaskTrackingService().
+     *
+     * @returns TaskTrackingService instance
+     */
+    async getTaskTrackingService() {
+        if (this.taskTrackingServiceRef) {
+            return this.taskTrackingServiceRef;
+        }
+        // Lazy fallback: create and cache one instance
+        const { TaskTrackingService: TTS } = await import('../project/task-tracking.service.js');
+        this.taskTrackingServiceRef = new TTS();
+        return this.taskTrackingServiceRef;
+    }
     /**
      * Lazily initializes the embedding provider on first use.
      * Returns null if no embedding API key is configured.
@@ -369,6 +395,11 @@ export class MemoryService {
                     content: params.content,
                     learnedFrom: params.metadata?.taskId,
                     confidence: 0.5,
+                    // v2: Task-linked provenance
+                    sourceTaskId: params.metadata?.sourceTaskId || params.metadata?.taskId,
+                    sourceObjectiveId: params.metadata?.sourceObjectiveId,
+                    sourceOutcome: params.metadata?.sourceOutcome,
+                    appliesTo: params.metadata?.appliesTo,
                 });
             case 'preference':
                 await this.agentMemory.updatePreferences(params.agentId, this.parsePreference(params.content));
@@ -393,6 +424,9 @@ export class MemoryService {
                     example: params.metadata?.example,
                     files: params.metadata?.files,
                     discoveredBy: params.agentId,
+                    // v2: provenance
+                    sourceTaskId: params.metadata?.sourceTaskId || params.metadata?.taskId,
+                    sourceOutcome: params.metadata?.sourceOutcome,
                 });
             case 'decision':
                 return this.projectMemory.addDecision(params.projectPath, {
@@ -410,6 +444,9 @@ export class MemoryService {
                     solution: params.metadata?.solution || '',
                     severity: params.metadata?.severity || 'medium',
                     discoveredBy: params.agentId,
+                    // v2: provenance
+                    sourceTaskId: params.metadata?.sourceTaskId || params.metadata?.taskId,
+                    sourceOutcome: params.metadata?.sourceOutcome,
                 });
             case 'relationship':
                 if (!params.metadata?.targetComponent) {
@@ -503,9 +540,68 @@ export class MemoryService {
             }));
         }
         await Promise.all(promises);
+        // v2: Enrich with operational context (goals, focus, active tasks)
+        await this.enrichWithOperationalContext(result, params);
         result.combined = this.combineMemories(result);
+        // v2: Append operational context to combined text
+        if (result.activeGoals?.length || result.currentFocus || result.activeTasks?.length) {
+            const opLines = ['\n### Operational Context'];
+            if (result.currentFocus)
+                opLines.push(`**Current Focus:** ${result.currentFocus}`);
+            if (result.activeGoals?.length)
+                opLines.push(`**Goals:** ${result.activeGoals.join('; ')}`);
+            if (result.activeTasks?.length) {
+                opLines.push('**Your Active Tasks:**');
+                for (const t of result.activeTasks) {
+                    opLines.push(`- [${t.status}] ${t.name}${t.hasWorkingNotes ? ' (has working notes)' : ''}`);
+                }
+            }
+            result.combined += opLines.join('\n');
+        }
         return result;
     }
+    /**
+     * Enrich recall result with operational context: goals, focus, active tasks.
+     * All lookups are non-fatal — missing data is silently skipped.
+     */
+    async enrichWithOperationalContext(result, params) {
+        const opPromises = [];
+        if (params.projectPath) {
+            opPromises.push((async () => {
+                try {
+                    const { GoalTrackingService } = await import('./goal-tracking.service.js');
+                    const gts = GoalTrackingService.getInstance();
+                    const goalsText = await gts.getGoals(params.projectPath);
+                    if (goalsText)
+                        result.activeGoals = [goalsText];
+                    const focus = await gts.getCurrentFocus(params.projectPath);
+                    if (focus)
+                        result.currentFocus = focus;
+                }
+                catch { /* non-fatal — goal tracking may not be initialized */ }
+            })());
+        }
+        if (params.agentId) {
+            opPromises.push((async () => {
+                try {
+                    const tts = await this.getTaskTrackingService();
+                    const tasks = await tts.getTasksBySessionName(params.agentId);
+                    const terminalStatuses = ['completed', 'verified', 'cancelled'];
+                    const active = tasks.filter((t) => !terminalStatuses.includes(t.status));
+                    if (active.length) {
+                        result.activeTasks = active.map((t) => ({
+                            id: t.id,
+                            name: t.taskName,
+                            status: t.status,
+                            hasWorkingNotes: !!t.workingNotes,
+                        }));
+                    }
+                }
+                catch { /* non-fatal */ }
+            })());
+        }
+        await Promise.all(opPromises);
+    }
     /**
      * Searches knowledge documents across global and project scopes.
      *