crewly 1.0.0

package/dist/backend/backend/src/services/memory/daily-log.service.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Daily Log Service
+ *
+ * Manages daily markdown log files for tracking agent activities within a project.
+ * Each day produces a single log file at `{projectPath}/.crewly/logs/daily/YYYY-MM-DD.md`
+ * containing timestamped entries grouped by agent role and ID.
+ *
+ * Log entries are append-only and provide a human-readable audit trail of what
+ * each agent worked on during the day. The orchestrator and agents can review
+ * recent logs to maintain continuity across sessions.
+ *
+ * @module services/memory/daily-log.service
+ */
+/**
+ * Service for managing daily agent activity logs
+ *
+ * Follows singleton pattern for consistent state management across the backend.
+ * Uses append-only file writes since log entries are never modified after creation.
+ *
+ * @example
+ * ```typescript
+ * const dailyLog = DailyLogService.getInstance();
+ * await dailyLog.appendEntry('/path/to/project', 'agent-dev-1', 'developer', 'Started login page implementation');
+ * const todayLog = await dailyLog.getTodaysLog('/path/to/project');
+ * ```
+ */
+export declare class DailyLogService {
+    private static instance;
+    private readonly logger;
+    /**
+     * Creates a new DailyLogService instance
+     *
+     * Use {@link getInstance} to obtain the singleton instance instead of
+     * calling this constructor directly.
+     */
+    private constructor();
+    /**
+     * Gets the singleton instance of DailyLogService
+     *
+     * @returns The singleton DailyLogService instance
+     */
+    static getInstance(): DailyLogService;
+    /**
+     * Clears the singleton instance
+     *
+     * Primarily used in tests to reset state between test cases.
+     */
+    static clearInstance(): void;
+    /**
+     * Formats a Date object as a YYYY-MM-DD string
+     *
+     * @param date - The date to format
+     * @returns Date string in YYYY-MM-DD format
+     *
+     * @example
+     * ```typescript
+     * formatDate(new Date('2026-02-09T14:30:00Z')); // '2026-02-09'
+     * ```
+     */
+    private formatDate;
+    /**
+     * Formats a Date object as an HH:MM time string (24-hour format)
+     *
+     * @param date - The date to format
+     * @returns Time string in HH:MM format
+     *
+     * @example
+     * ```typescript
+     * formatTime(new Date('2026-02-09T14:05:00')); // '14:05'
+     * ```
+     */
+    private formatTime;
+    /**
+     * Returns the absolute path to a daily log file
+     *
+     * Constructs the path using the project's `.crewly` directory and the
+     * configured daily log subdirectory from MEMORY_CONSTANTS.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @param date - Optional date string in YYYY-MM-DD format; defaults to today
+     * @returns Absolute path to the daily log file
+     *
+     * @example
+     * ```typescript
+     * const logPath = dailyLog.getLogPath('/home/user/my-project');
+     * // '/home/user/my-project/.crewly/logs/daily/2026-02-09.md'
+     *
+     * const pastLogPath = dailyLog.getLogPath('/home/user/my-project', '2026-02-07');
+     * // '/home/user/my-project/.crewly/logs/daily/2026-02-07.md'
+     * ```
+     */
+    getLogPath(projectPath: string, date?: string): string;
+    /**
+     * Appends a timestamped activity entry to today's daily log
+     *
+     * Creates the log file with a date header if it does not already exist.
+     * Each entry is formatted as a markdown section with the agent's role, ID,
+     * and current time, followed by the entry text as a bullet point.
+     *
+     * Uses `fs.appendFile` (not atomic write) since daily logs are append-only
+     * and a partial write is acceptable -- the next append will still succeed.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @param agentId - Unique identifier of the agent making the entry
+     * @param role - Agent's role (e.g., 'developer', 'orchestrator', 'qa')
+     * @param entry - Free-text description of the activity
+     * @throws Error if the directory cannot be created or the file cannot be written
+     *
+     * @example
+     * ```typescript
+     * await dailyLog.appendEntry(
+     *   '/home/user/my-project',
+     *   'agent-dev-1',
+     *   'developer',
+     *   'Started login page implementation'
+     * );
+     * // Appends to .crewly/logs/daily/2026-02-09.md:
+     * // ## [developer / agent-dev-1] 14:05
+     * // - Started login page implementation
+     * ```
+     */
+    appendEntry(projectPath: string, agentId: string, role: string, entry: string): Promise<void>;
+    /**
+     * Reads the contents of today's daily log file
+     *
+     * @param projectPath - Absolute path to the project root
+     * @returns The full markdown content of today's log, or null if no log exists yet
+     *
+     * @example
+     * ```typescript
+     * const log = await dailyLog.getTodaysLog('/home/user/my-project');
+     * if (log) {
+     *   console.log(log);
+     * } else {
+     *   console.log('No activity logged today');
+     * }
+     * ```
+     */
+    getTodaysLog(projectPath: string): Promise<string | null>;
+    /**
+     * Reads and concatenates the most recent daily logs
+     *
+     * Iterates backwards from today through the specified number of days,
+     * reading each log file that exists and joining them with markdown
+     * separators. Days without log files are silently skipped.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @param days - Number of days to look back (default: 3, including today)
+     * @returns Concatenated log content, or empty string if no logs found
+     *
+     * @example
+     * ```typescript
+     * // Get the last 7 days of logs
+     * const recentLogs = await dailyLog.getRecentLogs('/home/user/my-project', 7);
+     * ```
+     */
+    getRecentLogs(projectPath: string, days?: number): Promise<string>;
+}
+//# sourceMappingURL=daily-log.service.d.ts.map

package/dist/backend/backend/src/services/memory/daily-log.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily-log.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/daily-log.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IAEvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwE;IAE/F;;;;;OAKG;IACH,OAAO;IAIP;;;;OAIG;WACW,WAAW,IAAI,eAAe;IAO5C;;;;OAIG;WACW,aAAa,IAAI,IAAI;IAMnC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,UAAU;IAOlB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;;;;;;;;;;;;;;;OAkBG;IACI,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAU7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACU,WAAW,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAwChB;;;;;;;;;;;;;;;OAeG;IACU,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkBtE;;;;;;;;;;;;;;;;OAgBG;IACU,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAiCnF"}

package/dist/backend/backend/src/services/memory/daily-log.service.js

@@ -0,0 +1,272 @@
+/**
+ * Daily Log Service
+ *
+ * Manages daily markdown log files for tracking agent activities within a project.
+ * Each day produces a single log file at `{projectPath}/.crewly/logs/daily/YYYY-MM-DD.md`
+ * containing timestamped entries grouped by agent role and ID.
+ *
+ * Log entries are append-only and provide a human-readable audit trail of what
+ * each agent worked on during the day. The orchestrator and agents can review
+ * recent logs to maintain continuity across sessions.
+ *
+ * @module services/memory/daily-log.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { existsSync } from 'fs';
+import { ensureDir } from '../../utils/file-io.utils.js';
+import { MEMORY_CONSTANTS, CREWLY_CONSTANTS } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+/**
+ * Separator inserted between concatenated daily logs in multi-day views
+ */
+const LOG_SEPARATOR = '\n---\n\n';
+/**
+ * Service for managing daily agent activity logs
+ *
+ * Follows singleton pattern for consistent state management across the backend.
+ * Uses append-only file writes since log entries are never modified after creation.
+ *
+ * @example
+ * ```typescript
+ * const dailyLog = DailyLogService.getInstance();
+ * await dailyLog.appendEntry('/path/to/project', 'agent-dev-1', 'developer', 'Started login page implementation');
+ * const todayLog = await dailyLog.getTodaysLog('/path/to/project');
+ * ```
+ */
+export class DailyLogService {
+    static instance = null;
+    logger = LoggerService.getInstance().createComponentLogger('DailyLogService');
+    /**
+     * Creates a new DailyLogService instance
+     *
+     * Use {@link getInstance} to obtain the singleton instance instead of
+     * calling this constructor directly.
+     */
+    constructor() {
+        // No initialization needed; all operations are path-based
+    }
+    /**
+     * Gets the singleton instance of DailyLogService
+     *
+     * @returns The singleton DailyLogService instance
+     */
+    static getInstance() {
+        if (!DailyLogService.instance) {
+            DailyLogService.instance = new DailyLogService();
+        }
+        return DailyLogService.instance;
+    }
+    /**
+     * Clears the singleton instance
+     *
+     * Primarily used in tests to reset state between test cases.
+     */
+    static clearInstance() {
+        DailyLogService.instance = null;
+    }
+    // ========================= PRIVATE HELPERS =========================
+    /**
+     * Formats a Date object as a YYYY-MM-DD string
+     *
+     * @param date - The date to format
+     * @returns Date string in YYYY-MM-DD format
+     *
+     * @example
+     * ```typescript
+     * formatDate(new Date('2026-02-09T14:30:00Z')); // '2026-02-09'
+     * ```
+     */
+    formatDate(date) {
+        const year = date.getFullYear();
+        const month = String(date.getMonth() + 1).padStart(2, '0');
+        const day = String(date.getDate()).padStart(2, '0');
+        return `${year}-${month}-${day}`;
+    }
+    /**
+     * Formats a Date object as an HH:MM time string (24-hour format)
+     *
+     * @param date - The date to format
+     * @returns Time string in HH:MM format
+     *
+     * @example
+     * ```typescript
+     * formatTime(new Date('2026-02-09T14:05:00')); // '14:05'
+     * ```
+     */
+    formatTime(date) {
+        const hours = String(date.getHours()).padStart(2, '0');
+        const minutes = String(date.getMinutes()).padStart(2, '0');
+        return `${hours}:${minutes}`;
+    }
+    // ========================= PUBLIC INTERFACE =========================
+    /**
+     * Returns the absolute path to a daily log file
+     *
+     * Constructs the path using the project's `.crewly` directory and the
+     * configured daily log subdirectory from MEMORY_CONSTANTS.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @param date - Optional date string in YYYY-MM-DD format; defaults to today
+     * @returns Absolute path to the daily log file
+     *
+     * @example
+     * ```typescript
+     * const logPath = dailyLog.getLogPath('/home/user/my-project');
+     * // '/home/user/my-project/.crewly/logs/daily/2026-02-09.md'
+     *
+     * const pastLogPath = dailyLog.getLogPath('/home/user/my-project', '2026-02-07');
+     * // '/home/user/my-project/.crewly/logs/daily/2026-02-07.md'
+     * ```
+     */
+    getLogPath(projectPath, date) {
+        const dateStr = date ?? this.formatDate(new Date());
+        return path.join(projectPath, CREWLY_CONSTANTS.PATHS.CREWLY_HOME, MEMORY_CONSTANTS.PATHS.DAILY_LOG_DIR, `${dateStr}.md`);
+    }
+    /**
+     * Appends a timestamped activity entry to today's daily log
+     *
+     * Creates the log file with a date header if it does not already exist.
+     * Each entry is formatted as a markdown section with the agent's role, ID,
+     * and current time, followed by the entry text as a bullet point.
+     *
+     * Uses `fs.appendFile` (not atomic write) since daily logs are append-only
+     * and a partial write is acceptable -- the next append will still succeed.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @param agentId - Unique identifier of the agent making the entry
+     * @param role - Agent's role (e.g., 'developer', 'orchestrator', 'qa')
+     * @param entry - Free-text description of the activity
+     * @throws Error if the directory cannot be created or the file cannot be written
+     *
+     * @example
+     * ```typescript
+     * await dailyLog.appendEntry(
+     *   '/home/user/my-project',
+     *   'agent-dev-1',
+     *   'developer',
+     *   'Started login page implementation'
+     * );
+     * // Appends to .crewly/logs/daily/2026-02-09.md:
+     * // ## [developer / agent-dev-1] 14:05
+     * // - Started login page implementation
+     * ```
+     */
+    async appendEntry(projectPath, agentId, role, entry) {
+        const now = new Date();
+        const dateStr = this.formatDate(now);
+        const timeStr = this.formatTime(now);
+        const logFilePath = this.getLogPath(projectPath, dateStr);
+        const logDir = path.dirname(logFilePath);
+        try {
+            // Ensure the directory tree exists
+            await ensureDir(logDir);
+            // If the file does not exist, create it with the daily header
+            if (!existsSync(logFilePath)) {
+                const header = `# Daily Log: ${dateStr}\n\n`;
+                await fs.writeFile(logFilePath, header, 'utf-8');
+                this.logger.debug('Created new daily log file', { projectPath, date: dateStr });
+            }
+            // Build and append the entry block
+            const entryBlock = `## [${role} / ${agentId}] ${timeStr}\n- ${entry}\n\n`;
+            await fs.appendFile(logFilePath, entryBlock, 'utf-8');
+            this.logger.debug('Appended daily log entry', {
+                projectPath,
+                agentId,
+                role,
+                date: dateStr,
+                time: timeStr,
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to append daily log entry', {
+                projectPath,
+                agentId,
+                role,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    /**
+     * Reads the contents of today's daily log file
+     *
+     * @param projectPath - Absolute path to the project root
+     * @returns The full markdown content of today's log, or null if no log exists yet
+     *
+     * @example
+     * ```typescript
+     * const log = await dailyLog.getTodaysLog('/home/user/my-project');
+     * if (log) {
+     *   console.log(log);
+     * } else {
+     *   console.log('No activity logged today');
+     * }
+     * ```
+     */
+    async getTodaysLog(projectPath) {
+        const logFilePath = this.getLogPath(projectPath);
+        try {
+            const content = await fs.readFile(logFilePath, 'utf-8');
+            return content;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            this.logger.error('Failed to read today\'s daily log', {
+                projectPath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    /**
+     * Reads and concatenates the most recent daily logs
+     *
+     * Iterates backwards from today through the specified number of days,
+     * reading each log file that exists and joining them with markdown
+     * separators. Days without log files are silently skipped.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @param days - Number of days to look back (default: 3, including today)
+     * @returns Concatenated log content, or empty string if no logs found
+     *
+     * @example
+     * ```typescript
+     * // Get the last 7 days of logs
+     * const recentLogs = await dailyLog.getRecentLogs('/home/user/my-project', 7);
+     * ```
+     */
+    async getRecentLogs(projectPath, days = 3) {
+        const logs = [];
+        const today = new Date();
+        for (let i = 0; i < days; i++) {
+            const date = new Date(today);
+            date.setDate(today.getDate() - i);
+            const dateStr = this.formatDate(date);
+            const logFilePath = this.getLogPath(projectPath, dateStr);
+            try {
+                const content = await fs.readFile(logFilePath, 'utf-8');
+                logs.push(content.trim());
+            }
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    // No log for this day -- skip silently
+                    continue;
+                }
+                this.logger.warn('Failed to read daily log', {
+                    projectPath,
+                    date: dateStr,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                // Non-fatal: skip this day's log and continue
+            }
+        }
+        if (logs.length === 0) {
+            return '';
+        }
+        return logs.join(LOG_SEPARATOR);
+    }
+}
+//# sourceMappingURL=daily-log.service.js.map

package/dist/backend/backend/src/services/memory/daily-log.service.js.map

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

package/dist/backend/backend/src/services/memory/goal-tracking.service.d.ts

@@ -0,0 +1,239 @@
+/**
+ * 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
+ */
+/**
+ * Parameters for logging a decision via {@link GoalTrackingService.logDecision}.
+ */
+export interface DecisionParams {
+    /** Short descriptive title for the decision */
+    title: string;
+    /** The decision that was made */
+    decision: string;
+    /** Reasoning behind the decision */
+    rationale: string;
+    /** Agent or user who made the decision */
+    decidedBy: string;
+    /** Alternative options that were considered */
+    alternatives?: string[];
+}
+/**
+ * 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 declare class GoalTrackingService {
+    private static instance;
+    /** Monotonic counter to ensure unique decision IDs even within the same millisecond */
+    private decisionCounter;
+    private readonly logger;
+    /**
+     * Creates a new GoalTrackingService instance.
+     * Use {@link getInstance} for the singleton.
+     */
+    private constructor();
+    /**
+     * Gets the singleton instance of GoalTrackingService.
+     *
+     * @returns The singleton GoalTrackingService instance
+     */
+    static getInstance(): GoalTrackingService;
+    /**
+     * Clears the singleton instance.
+     * Intended for test isolation only — never call in production.
+     */
+    static clearInstance(): void;
+    /**
+     * 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`
+     */
+    private getGoalsDir;
+    /**
+     * 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
+     */
+    private safeReadFile;
+    /**
+     * 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');
+     * ```
+     */
+    setGoal(projectPath: string, goal: string, setBy?: string): Promise<void>;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    getGoals(projectPath: string): Promise<string | null>;
+    /**
+     * 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',
+     * );
+     * ```
+     */
+    updateFocus(projectPath: string, focus: string, updatedBy?: string): Promise<void>;
+    /**
+     * 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');
+     * ```
+     */
+    getCurrentFocus(projectPath: string): Promise<string | null>;
+    /**
+     * 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'
+     * ```
+     */
+    logDecision(projectPath: string, decision: DecisionParams): Promise<string>;
+    /**
+     * 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',
+     * );
+     * ```
+     */
+    updateDecisionOutcome(projectPath: string, decisionId: string, outcome: string, learnings?: string): Promise<void>;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    getDecisionsLog(projectPath: string): Promise<string | null>;
+}
+//# sourceMappingURL=goal-tracking.service.d.ts.map

package/dist/backend/backend/src/services/memory/goal-tracking.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-tracking.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/goal-tracking.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoC;IAE3D,uFAAuF;IACvF,OAAO,CAAC,eAAe,CAAK;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4E;IAEnG;;;OAGG;IACH,OAAO;IAIP;;;;OAIG;WACW,WAAW,IAAI,mBAAmB;IAOhD;;;OAGG;WACW,aAAa,IAAI,IAAI;IAMnC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAInB;;;;;;;;OAQG;YACW,YAAY;IAa1B;;;;;;;;;;;;;;OAcG;IACU,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9F;;;;;;;;;;;;;OAaG;IACU,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKlE;;;;;;;;;;;;;;;;;;OAkBG;IACU,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB/G;;;;;;;;;;OAUG;IACU,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKzE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCxF;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,qBAAqB,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAkDhB;;;;;;;;;;;;;OAaG;IACU,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAI1E"}