hammoc 1.0.0

package/packages/server/dist/services/queueTemplateService.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Queue Template Service — CRUD operations for saved queue templates
+ * [Source: Story 15.5 - Task 3.1]
+ */
+import type { QueueTemplate } from '@hammoc/shared';
+export declare const queueTemplateService: {
+    getTemplates(projectRoot: string): Promise<QueueTemplate[]>;
+    saveTemplate(projectRoot: string, name: string, template: string): Promise<QueueTemplate>;
+    updateTemplate(projectRoot: string, id: string, name: string, template: string): Promise<QueueTemplate>;
+    deleteTemplate(projectRoot: string, id: string): Promise<void>;
+};
+//# sourceMappingURL=queueTemplateService.d.ts.map

package/packages/server/dist/services/queueTemplateService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueTemplateService.d.ts","sourceRoot":"","sources":["../../src/services/queueTemplateService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AA4BpD,eAAO,MAAM,oBAAoB;8BACC,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;8BAIjC,MAAM,QAAQ,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;gCAe7D,MAAM,MAAM,MAAM,QAAQ,MAAM,YAAY,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;gCAgB3E,MAAM,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CASrE,CAAC"}

package/packages/server/dist/services/queueTemplateService.js

@@ -0,0 +1,73 @@
+/**
+ * Queue Template Service — CRUD operations for saved queue templates
+ * [Source: Story 15.5 - Task 3.1]
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import crypto from 'node:crypto';
+const TEMPLATES_DIR = '.hammoc';
+const TEMPLATES_FILE = 'queue-templates.json';
+function normalizeLineEndings(text) {
+    return text.replace(/\r\n?/g, '\n');
+}
+function getTemplatesPath(projectRoot) {
+    return path.join(projectRoot, TEMPLATES_DIR, TEMPLATES_FILE);
+}
+async function readTemplatesFile(projectRoot) {
+    try {
+        const content = await fs.readFile(getTemplatesPath(projectRoot), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return [];
+    }
+}
+async function writeTemplatesFile(projectRoot, templates) {
+    const dir = path.join(projectRoot, TEMPLATES_DIR);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(getTemplatesPath(projectRoot), JSON.stringify(templates, null, 2), 'utf-8');
+}
+export const queueTemplateService = {
+    async getTemplates(projectRoot) {
+        return readTemplatesFile(projectRoot);
+    },
+    async saveTemplate(projectRoot, name, template) {
+        const templates = await readTemplatesFile(projectRoot);
+        const now = new Date().toISOString();
+        const newTemplate = {
+            id: crypto.randomUUID(),
+            name,
+            template: normalizeLineEndings(template),
+            createdAt: now,
+            updatedAt: now,
+        };
+        templates.push(newTemplate);
+        await writeTemplatesFile(projectRoot, templates);
+        return newTemplate;
+    },
+    async updateTemplate(projectRoot, id, name, template) {
+        const templates = await readTemplatesFile(projectRoot);
+        const index = templates.findIndex((t) => t.id === id);
+        if (index === -1) {
+            throw new Error(`Template not found: ${id}`);
+        }
+        templates[index] = {
+            ...templates[index],
+            name,
+            template: normalizeLineEndings(template),
+            updatedAt: new Date().toISOString(),
+        };
+        await writeTemplatesFile(projectRoot, templates);
+        return templates[index];
+    },
+    async deleteTemplate(projectRoot, id) {
+        const templates = await readTemplatesFile(projectRoot);
+        const index = templates.findIndex((t) => t.id === id);
+        if (index === -1) {
+            throw new Error(`Template not found: ${id}`);
+        }
+        templates.splice(index, 1);
+        await writeTemplatesFile(projectRoot, templates);
+    },
+};
+//# sourceMappingURL=queueTemplateService.js.map

package/packages/server/dist/services/queueTemplateService.js.map

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

package/packages/server/dist/services/rateLimitProbeService.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Rate Limit Probe Service
+ * Reads OAuth credentials from ~/.claude/.credentials.json and calls
+ * the Anthropic OAuth usage API to retrieve subscription rate limit data.
+ * Supports periodic polling with broadcast callback for real-time updates.
+ */
+import type { SubscriptionRateLimit, ApiHealthStatus } from '@hammoc/shared';
+declare class RateLimitProbeService {
+    private cachedToken;
+    private tokenCachedAt;
+    private lastProbeResult;
+    private pollTimer;
+    private broadcastFn;
+    private healthBroadcastFn;
+    private apiHealthy;
+    private healthLastCheckedAt;
+    private healthLastError;
+    private consecutiveThrottles;
+    /**
+     * Read OAuth access token from ~/.claude/.credentials.json
+     */
+    private readAccessToken;
+    /**
+     * Call Anthropic OAuth Usage API and return rate limit data.
+     * Returns null on failure (graceful degradation).
+     */
+    probe(): Promise<SubscriptionRateLimit | null>;
+    /**
+     * Start periodic polling. Calls broadcast function on each successful probe.
+     * Safe to call multiple times — only one timer runs at a time.
+     */
+    startPolling(broadcast: (data: SubscriptionRateLimit) => void, healthBroadcast?: (data: ApiHealthStatus) => void): void;
+    /**
+     * Stop periodic polling.
+     */
+    stopPolling(): void;
+    /**
+     * Return last cached probe result (no API call).
+     */
+    getCachedResult(): SubscriptionRateLimit | null;
+    /**
+     * Return cached API health status (no API call).
+     * Returns null if no probe has been performed yet.
+     */
+    getApiHealth(): ApiHealthStatus | null;
+    private updateApiHealth;
+    private pollOnce;
+    /**
+     * Parse usage API JSON response into SubscriptionRateLimit
+     */
+    private parseUsageResponse;
+    private getStatus;
+}
+export declare const rateLimitProbeService: RateLimitProbeService;
+export {};
+//# sourceMappingURL=rateLimitProbeService.d.ts.map

package/packages/server/dist/services/rateLimitProbeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimitProbeService.d.ts","sourceRoot":"","sources":["../../src/services/rateLimitProbeService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAW7E,cAAM,qBAAqB;IACzB,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,eAAe,CAAsC;IAC7D,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,WAAW,CAAwD;IAC3E,OAAO,CAAC,iBAAiB,CAAkD;IAC3E,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,oBAAoB,CAAK;IAEjC;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAuDpD;;;OAGG;IACH,YAAY,CACV,SAAS,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,EAChD,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,GAChD,IAAI;IAaP;;OAEG;IACH,WAAW,IAAI,IAAI;IAUnB;;OAEG;IACH,eAAe,IAAI,qBAAqB,GAAG,IAAI;IAI/C;;;OAGG;IACH,YAAY,IAAI,eAAe,GAAG,IAAI;IAStC,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,QAAQ;IAuBhB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,SAAS;CAKlB;AAED,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}

package/packages/server/dist/services/rateLimitProbeService.js

@@ -0,0 +1,227 @@
+/**
+ * Rate Limit Probe Service
+ * Reads OAuth credentials from ~/.claude/.credentials.json and calls
+ * the Anthropic OAuth usage API to retrieve subscription rate limit data.
+ * Supports periodic polling with broadcast callback for real-time updates.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('rateLimitProbe');
+const USAGE_API_URL = 'https://api.anthropic.com/api/oauth/usage';
+const CREDENTIALS_PATH = path.join(os.homedir(), '.claude', '.credentials.json');
+const POLL_INTERVAL_MS = 120_000; // 2min polling interval
+const MAX_BACKOFF_MS = 1_800_000; // 30min max backoff on 429
+const TOKEN_CACHE_TTL_MS = 300_000; // 5min token file cache
+class RateLimitProbeService {
+    cachedToken = null;
+    tokenCachedAt = 0;
+    lastProbeResult = null;
+    pollTimer = null;
+    broadcastFn = null;
+    healthBroadcastFn = null;
+    apiHealthy = true;
+    healthLastCheckedAt = 0;
+    healthLastError = null;
+    consecutiveThrottles = 0;
+    /**
+     * Read OAuth access token from ~/.claude/.credentials.json
+     */
+    readAccessToken() {
+        const now = Date.now();
+        if (this.cachedToken && (now - this.tokenCachedAt) < TOKEN_CACHE_TTL_MS) {
+            return this.cachedToken;
+        }
+        try {
+            if (!fs.existsSync(CREDENTIALS_PATH)) {
+                log.debug('Credentials file not found: %s', CREDENTIALS_PATH);
+                return null;
+            }
+            const raw = fs.readFileSync(CREDENTIALS_PATH, 'utf-8');
+            const data = JSON.parse(raw);
+            const token = data?.claudeAiOauth?.accessToken;
+            if (typeof token === 'string' && token.length > 0) {
+                this.cachedToken = token;
+                this.tokenCachedAt = now;
+                log.debug('OAuth token loaded (length: %d)', token.length);
+                return token;
+            }
+            log.debug('No claudeAiOauth.accessToken in credentials file');
+            return null;
+        }
+        catch (err) {
+            log.debug('Failed to read credentials: %s', err instanceof Error ? err.message : String(err));
+            return null;
+        }
+    }
+    /**
+     * Call Anthropic OAuth Usage API and return rate limit data.
+     * Returns null on failure (graceful degradation).
+     */
+    async probe() {
+        const token = this.readAccessToken();
+        if (!token)
+            return null;
+        try {
+            const response = await fetch(USAGE_API_URL, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${token}`,
+                    'anthropic-beta': 'oauth-2025-04-20',
+                    'User-Agent': 'hammoc/1.0',
+                },
+                signal: AbortSignal.timeout(5000),
+            });
+            if (!response.ok) {
+                if (response.status === 401 || response.status === 403) {
+                    this.cachedToken = null;
+                    this.tokenCachedAt = 0;
+                    this.consecutiveThrottles = 0;
+                    log.debug('Usage API auth failed (status: %d), token cache invalidated', response.status);
+                    // Auth errors mean the API is reachable, just credentials are invalid
+                    this.updateApiHealth(true);
+                }
+                else if (response.status === 429) {
+                    this.consecutiveThrottles++;
+                    log.debug('Usage API rate limited (429), consecutive: %d', this.consecutiveThrottles);
+                    // 429 means the API is reachable, just throttled
+                    this.updateApiHealth(true);
+                }
+                else {
+                    this.consecutiveThrottles = 0;
+                    log.debug('Usage API error (status: %d)', response.status);
+                    this.updateApiHealth(false, `API returned ${response.status}`);
+                }
+                return null;
+            }
+            const body = await response.json();
+            const result = this.parseUsageResponse(body);
+            this.lastProbeResult = result;
+            this.consecutiveThrottles = 0;
+            this.updateApiHealth(true);
+            log.debug('Rate limit probe success: 5h=%s, 7d=%s', result?.fiveHour?.utilization?.toFixed(2) ?? 'n/a', result?.sevenDay?.utilization?.toFixed(2) ?? 'n/a');
+            return result;
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            this.consecutiveThrottles = 0;
+            log.debug('Usage API fetch failed: %s', errMsg);
+            this.updateApiHealth(false, errMsg);
+            return null;
+        }
+    }
+    /**
+     * Start periodic polling. Calls broadcast function on each successful probe.
+     * Safe to call multiple times — only one timer runs at a time.
+     */
+    startPolling(broadcast, healthBroadcast) {
+        this.broadcastFn = broadcast;
+        if (healthBroadcast)
+            this.healthBroadcastFn = healthBroadcast;
+        if (this.pollTimer)
+            return; // already polling
+        log.debug('Starting rate limit polling (interval: %dms)', POLL_INTERVAL_MS);
+        // Immediate first probe
+        this.pollOnce();
+        this.pollTimer = setInterval(() => this.pollOnce(), POLL_INTERVAL_MS);
+    }
+    /**
+     * Stop periodic polling.
+     */
+    stopPolling() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+            log.debug('Rate limit polling stopped');
+        }
+        this.broadcastFn = null;
+        this.healthBroadcastFn = null;
+    }
+    /**
+     * Return last cached probe result (no API call).
+     */
+    getCachedResult() {
+        return this.lastProbeResult;
+    }
+    /**
+     * Return cached API health status (no API call).
+     * Returns null if no probe has been performed yet.
+     */
+    getApiHealth() {
+        if (this.healthLastCheckedAt === 0)
+            return null;
+        return {
+            healthy: this.apiHealthy,
+            lastCheckedAt: new Date(this.healthLastCheckedAt).toISOString(),
+            ...(this.healthLastError && { error: this.healthLastError }),
+        };
+    }
+    updateApiHealth(healthy, error) {
+        const changed = this.apiHealthy !== healthy;
+        this.apiHealthy = healthy;
+        this.healthLastCheckedAt = Date.now();
+        this.healthLastError = error ?? null;
+        if (changed) {
+            log.info('API health changed: %s%s', healthy ? 'healthy' : 'unhealthy', error ? ` (${error})` : '');
+        }
+        if (this.healthBroadcastFn) {
+            this.healthBroadcastFn(this.getApiHealth());
+        }
+    }
+    pollOnce() {
+        // Exponential backoff on consecutive 429s: skip polls until backoff expires.
+        // Backoff doubles each time: 4min, 8min, 16min, capped at 30min.
+        if (this.consecutiveThrottles > 0) {
+            const backoffMs = Math.min(POLL_INTERVAL_MS * Math.pow(2, this.consecutiveThrottles), MAX_BACKOFF_MS);
+            const elapsed = Date.now() - this.healthLastCheckedAt;
+            if (elapsed < backoffMs) {
+                log.debug('Skipping probe (backoff: %ds remaining)', Math.round((backoffMs - elapsed) / 1000));
+                return;
+            }
+        }
+        this.probe().then((result) => {
+            if (result && this.broadcastFn) {
+                this.broadcastFn(result);
+            }
+        }).catch(() => { });
+    }
+    /**
+     * Parse usage API JSON response into SubscriptionRateLimit
+     */
+    parseUsageResponse(body) {
+        const data = body;
+        if (!data.five_hour && !data.seven_day)
+            return null;
+        const result = {};
+        if (data.five_hour) {
+            // API returns utilization as 0-100 percentage; normalize to 0-1
+            const util = data.five_hour.utilization / 100;
+            result.fiveHour = {
+                utilization: util,
+                reset: data.five_hour.resets_at,
+                status: this.getStatus(util),
+            };
+        }
+        if (data.seven_day) {
+            const util = data.seven_day.utilization / 100;
+            result.sevenDay = {
+                utilization: util,
+                reset: data.seven_day.resets_at,
+                status: this.getStatus(util),
+            };
+        }
+        const maxUtil = Math.max(result.fiveHour?.utilization ?? 0, result.sevenDay?.utilization ?? 0);
+        result.overallStatus = this.getStatus(maxUtil);
+        return result;
+    }
+    getStatus(utilization) {
+        if (utilization >= 0.8)
+            return 'critical';
+        if (utilization >= 0.5)
+            return 'warning';
+        return 'normal';
+    }
+}
+export const rateLimitProbeService = new RateLimitProbeService();
+//# sourceMappingURL=rateLimitProbeService.js.map

package/packages/server/dist/services/rateLimitProbeService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimitProbeService.js","sourceRoot":"","sources":["../../src/services/rateLimitProbeService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAE3C,MAAM,aAAa,GAAG,2CAA2C,CAAC;AAClE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC;AACjF,MAAM,gBAAgB,GAAG,OAAO,CAAC,CAAC,wBAAwB;AAC1D,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,2BAA2B;AAC7D,MAAM,kBAAkB,GAAG,OAAO,CAAC,CAAC,wBAAwB;AAE5D,MAAM,qBAAqB;IACjB,WAAW,GAAkB,IAAI,CAAC;IAClC,aAAa,GAAG,CAAC,CAAC;IAClB,eAAe,GAAiC,IAAI,CAAC;IACrD,SAAS,GAA0C,IAAI,CAAC;IACxD,WAAW,GAAmD,IAAI,CAAC;IACnE,iBAAiB,GAA6C,IAAI,CAAC;IACnE,UAAU,GAAG,IAAI,CAAC;IAClB,mBAAmB,GAAG,CAAC,CAAC;IACxB,eAAe,GAAkB,IAAI,CAAC;IACtC,oBAAoB,GAAG,CAAC,CAAC;IAEjC;;OAEG;IACK,eAAe;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,kBAAkB,EAAE,CAAC;YACxE,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACrC,GAAG,CAAC,KAAK,CAAC,gCAAgC,EAAE,gBAAgB,CAAC,CAAC;gBAC9D,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,EAAE,aAAa,EAAE,WAAW,CAAC;YAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;gBACzB,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;gBACzB,GAAG,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC3D,OAAO,KAAK,CAAC;YACf,CAAC;YACD,GAAG,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9F,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE;gBAC1C,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,eAAe,EAAE,UAAU,KAAK,EAAE;oBAClC,gBAAgB,EAAE,kBAAkB;oBACpC,YAAY,EAAE,YAAY;iBAC3B;gBACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACvD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;oBACxB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;oBACvB,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;oBAC9B,GAAG,CAAC,KAAK,CAAC,6DAA6D,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAC1F,sEAAsE;oBACtE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;qBAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACnC,IAAI,CAAC,oBAAoB,EAAE,CAAC;oBAC5B,GAAG,CAAC,KAAK,CAAC,+CAA+C,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;oBACtF,iDAAiD;oBACjD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;oBAC9B,GAAG,CAAC,KAAK,CAAC,8BAA8B,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAC3D,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,gBAAgB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBACjE,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC;YAC9B,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,wCAAwC,EAChD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,EAClD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CACnD,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;YAC9B,GAAG,CAAC,KAAK,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;YAChD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,YAAY,CACV,SAAgD,EAChD,eAAiD;QAEjD,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,eAAe;YAAE,IAAI,CAAC,iBAAiB,GAAG,eAAe,CAAC;QAC9D,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,kBAAkB;QAE9C,GAAG,CAAC,KAAK,CAAC,8CAA8C,EAAE,gBAAgB,CAAC,CAAC;QAE5E,wBAAwB;QACxB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEhB,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,GAAG,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,mBAAmB,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChD,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,UAAU;YACxB,aAAa,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE;YAC/D,GAAG,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,OAAgB,EAAE,KAAc;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,KAAK,OAAO,CAAC;QAC5C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;QAC1B,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtC,IAAI,CAAC,eAAe,GAAG,KAAK,IAAI,IAAI,CAAC;QAErC,IAAI,OAAO,EAAE,CAAC;YACZ,GAAG,CAAC,IAAI,CAAC,0BAA0B,EACjC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EACjC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,EAAG,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,QAAQ;QACd,6EAA6E;QAC7E,iEAAiE;QACjE,IAAI,IAAI,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,oBAAoB,CAAC,EACzD,cAAc,CACf,CAAC;YACF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,mBAAmB,CAAC;YACtD,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC;gBACxB,GAAG,CAAC,KAAK,CAAC,yCAAyC,EACjD,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAC3B,IAAI,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC/B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAc,CAAC,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,IAAa;QACtC,MAAM,IAAI,GAAG,IAGZ,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAEpD,MAAM,MAAM,GAA0B,EAAE,CAAC;QAEzC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,gEAAgE;YAChE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,GAAG,GAAG,CAAC;YAC9C,MAAM,CAAC,QAAQ,GAAG;gBAChB,WAAW,EAAE,IAAI;gBACjB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS;gBAC/B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC7B,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,GAAG,GAAG,CAAC;YAC9C,MAAM,CAAC,QAAQ,GAAG;gBAChB,WAAW,EAAE,IAAI;gBACjB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS;gBAC/B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC7B,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,MAAM,CAAC,QAAQ,EAAE,WAAW,IAAI,CAAC,EACjC,MAAM,CAAC,QAAQ,EAAE,WAAW,IAAI,CAAC,CAClC,CAAC;QACF,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAE/C,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,SAAS,CAAC,WAAmB;QACnC,IAAI,WAAW,IAAI,GAAG;YAAE,OAAO,UAAU,CAAC;QAC1C,IAAI,WAAW,IAAI,GAAG;YAAE,OAAO,SAAS,CAAC;QACzC,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,EAAE,CAAC"}

package/packages/server/dist/services/rateLimiter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Rate Limiter Service
+ * In-memory rate limiting for login attempts
+ * [Source: Story 2.2 - AC 5]
+ */
+/**
+ * Rate limiter for login attempts
+ * Singleton class that tracks failed login attempts by IP
+ */
+declare class RateLimiterService {
+    private attempts;
+    /**
+     * Check if an IP is allowed to attempt login
+     * @returns Object with allowed status and optional retryAfter seconds
+     */
+    canAttempt(ip: string): {
+        allowed: boolean;
+        retryAfter?: number;
+    };
+    /**
+     * Record a failed login attempt
+     * If MAX_ATTEMPTS reached, set lockout
+     */
+    recordFailure(ip: string): void;
+    /**
+     * Reset attempt count for an IP (called on successful login)
+     */
+    reset(ip: string): void;
+}
+export declare const rateLimiter: RateLimiterService;
+export {};
+//# sourceMappingURL=rateLimiter.d.ts.map

package/packages/server/dist/services/rateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.d.ts","sourceRoot":"","sources":["../../src/services/rateLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;;GAGG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,QAAQ,CAAyC;IAEzD;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAsBjE;;;OAGG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAe/B;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGxB;AAGD,eAAO,MAAM,WAAW,oBAA2B,CAAC"}

package/packages/server/dist/services/rateLimiter.js

@@ -0,0 +1,60 @@
+/**
+ * Rate Limiter Service
+ * In-memory rate limiting for login attempts
+ * [Source: Story 2.2 - AC 5]
+ */
+const MAX_ATTEMPTS = 5;
+const LOCKOUT_DURATION_MS = 30 * 1000; // 30 seconds
+/**
+ * Rate limiter for login attempts
+ * Singleton class that tracks failed login attempts by IP
+ */
+class RateLimiterService {
+    attempts = new Map();
+    /**
+     * Check if an IP is allowed to attempt login
+     * @returns Object with allowed status and optional retryAfter seconds
+     */
+    canAttempt(ip) {
+        const record = this.attempts.get(ip);
+        if (!record) {
+            return { allowed: true };
+        }
+        // Check if lockout has expired
+        if (record.lockoutUntil !== null) {
+            const now = Date.now();
+            if (now < record.lockoutUntil) {
+                const retryAfter = Math.ceil((record.lockoutUntil - now) / 1000);
+                return { allowed: false, retryAfter };
+            }
+            // Lockout expired, reset the record
+            this.attempts.delete(ip);
+            return { allowed: true };
+        }
+        return { allowed: true };
+    }
+    /**
+     * Record a failed login attempt
+     * If MAX_ATTEMPTS reached, set lockout
+     */
+    recordFailure(ip) {
+        const record = this.attempts.get(ip);
+        if (!record) {
+            this.attempts.set(ip, { count: 1, lockoutUntil: null });
+            return;
+        }
+        record.count += 1;
+        if (record.count >= MAX_ATTEMPTS) {
+            record.lockoutUntil = Date.now() + LOCKOUT_DURATION_MS;
+        }
+    }
+    /**
+     * Reset attempt count for an IP (called on successful login)
+     */
+    reset(ip) {
+        this.attempts.delete(ip);
+    }
+}
+// Export singleton instance
+export const rateLimiter = new RateLimiterService();
+//# sourceMappingURL=rateLimiter.js.map

package/packages/server/dist/services/rateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.js","sourceRoot":"","sources":["../../src/services/rateLimiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,mBAAmB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAOpD;;;GAGG;AACH,MAAM,kBAAkB;IACd,QAAQ,GAA+B,IAAI,GAAG,EAAE,CAAC;IAEzD;;;OAGG;IACH,UAAU,CAAC,EAAU;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAErC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,+BAA+B;QAC/B,IAAI,MAAM,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,GAAG,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;gBAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;gBACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;YACxC,CAAC;YACD,oCAAoC;YACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,EAAU;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAErC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;QAElB,IAAI,MAAM,CAAC,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,mBAAmB,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,EAAU;QACd,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,kBAAkB,EAAE,CAAC"}

package/packages/server/dist/services/sessionService.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Session Service for Session Management
+ * Story 1.6: Session Management
+ *
+ * Handles session persistence, retrieval, and listing
+ * from Claude Code's ~/.claude/projects/ directory structure
+ */
+import type { SessionInfo, SessionListItem, SessionListParams, HistoryMessage, PaginationInfo, PaginationOptions } from '@hammoc/shared';
+/**
+ * SessionService - Manages Claude Code session data
+ */
+export declare class SessionService {
+    private readonly claudeProjectsDir;
+    constructor();
+    /**
+     * Encode a project path to Claude Code's directory format
+     * /Users/username/myproject -> -Users-username-myproject
+     * C:\Users\username\myproject -> C-Users-username-myproject
+     */
+    encodeProjectPath(projectPath: string): string;
+    /**
+     * Get the sessions directory for a project
+     */
+    getSessionsDir(projectPath: string): string;
+    /**
+     * Get the sessions-index.json path for a project
+     */
+    getSessionsIndexPath(projectPath: string): string;
+    /**
+     * Save the current session ID for a project
+     * Note: This creates a simple tracking file, not modifying Claude's actual index
+     */
+    saveSessionId(projectPath: string, sessionId: string): Promise<void>;
+    /**
+     * Get the last used session ID for a project
+     */
+    getSessionId(projectPath: string): Promise<string | null>;
+    /**
+     * List all sessions for a project from sessions-index.json
+     */
+    listSessions(projectPath: string): Promise<SessionInfo[]>;
+    /**
+     * Check if a session exists in the sessions-index.json
+     */
+    sessionExists(projectPath: string, sessionId: string): Promise<boolean>;
+    /**
+     * Get a specific session by ID
+     */
+    getSession(projectPath: string, sessionId: string): Promise<SessionInfo | null>;
+    /**
+     * Validate session ID format (basic validation)
+     * Session IDs from Claude Code are typically alphanumeric with hyphens
+     */
+    isValidSessionId(sessionId: string): boolean;
+    /**
+     * Get original project path from projectSlug
+     * @param projectSlug The folder name in ~/.claude/projects/
+     * @returns Original project path or null if not found
+     */
+    getProjectPathBySlug(projectSlug: string): Promise<string | null>;
+    /**
+     * Truncate text to specified length with ellipsis
+     */
+    truncateFirstPrompt(text: string, maxLength?: number): string;
+    /**
+     * Safely parse ISO date string for sorting
+     * Returns 0 for invalid dates to push them to the end
+     */
+    private parseDate;
+    /**
+     * Check if a session matches the search query by metadata
+     * Matches against session name, session ID, and firstPrompt (case-insensitive)
+     */
+    private matchesMetadata;
+    /**
+     * Search JSONL file content for a query string
+     * Returns true on first match (early termination)
+     */
+    private searchFileContent;
+    /**
+     * Execute async tasks with bounded concurrency
+     */
+    private pMapWithLimit;
+    /**
+     * List sessions for API response (by projectSlug)
+     * - Sorted by modified descending (AC 3)
+     * - firstPrompt truncated to 100 chars (AC 4)
+     * - Also scans for .jsonl files not yet in sessions-index.json
+     * - Supports search by query and content search (Story 23.1)
+     */
+    listSessionsBySlug(projectSlug: string, params?: SessionListParams & {
+        sessionNames?: Record<string, string>;
+    }): Promise<{
+        sessions: SessionListItem[];
+        total: number;
+    } | null>;
+    /**
+     * Remove a session entry from sessions-index.json
+     */
+    private removeFromSessionsIndex;
+    /**
+     * Remove multiple session entries from sessions-index.json in one write
+     */
+    private removeMultipleFromSessionsIndex;
+    /**
+     * Delete a single session (.jsonl file + index entry)
+     */
+    deleteSession(projectSlug: string, sessionId: string): Promise<void>;
+    /**
+     * Delete multiple sessions (batch)
+     * Returns count of successfully deleted and failed sessions
+     */
+    deleteSessions(projectSlug: string, sessionIds: string[]): Promise<{
+        deleted: number;
+        failed: number;
+    }>;
+    /**
+     * Get the JSONL file path for a session
+     * Claude Code stores session files directly in the project folder (not in a sessions subfolder)
+     * @param projectSlug The project slug
+     * @param sessionId The session ID
+     * @returns Full path to the JSONL session file
+     */
+    getSessionFilePath(projectSlug: string, sessionId: string): string;
+    /**
+     * Check if a session file exists
+     * @param projectSlug The project slug
+     * @param sessionId The session ID
+     * @returns true if the session file exists
+     */
+    sessionFileExists(projectSlug: string, sessionId: string): boolean;
+    /**
+     * Validate path parameter to prevent path traversal attacks
+     * @param param The path parameter to validate
+     * @returns true if the parameter is safe
+     */
+    isValidPathParam(param: string): boolean;
+    /**
+     * Get session messages with pagination
+     * @param projectSlug The project slug
+     * @param sessionId The session ID
+     * @param options Pagination options (limit, offset)
+     * @returns Messages with pagination info, or null if session not found
+     */
+    getSessionMessages(projectSlug: string, sessionId: string, options?: PaginationOptions): Promise<{
+        messages: HistoryMessage[];
+        pagination: PaginationInfo;
+        lastAgentCommand: string | null;
+    } | null>;
+}
+export declare const sessionService: SessionService;
+//# sourceMappingURL=sessionService.d.ts.map

package/packages/server/dist/services/sessionService.d.ts.map

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