ultraclaude-agent 0.0.3

package/dist/sync.js

@@ -0,0 +1,344 @@
+// HTTP sync client: push sections/files to server, fetch manifest, manage offline queue
+import { readFile, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { parseMarkdownSections, computeContentHash, ok, err, } from '@ultra-claude/shared';
+import { loadCredentials, getServerUrl } from './config.js';
+import { logger } from './logger.js';
+const QUEUE_CAP = 1000;
+const RETRY_INTERVAL_MS = 5_000;
+const MAX_FILE_SIZE = 1_000_000; // 1MB
+// --- Module state ---
+const queue = [];
+const projectStates = new Map();
+let retryTimer = null;
+function getOrCreateState(projectId) {
+    let state = projectStates.get(projectId);
+    if (!state) {
+        state = { sectionHashes: new Map(), fileHashes: new Map(), needsManifestResync: false };
+        projectStates.set(projectId, state);
+    }
+    return state;
+}
+export async function apiRequest(method, path, body, extraHeaders) {
+    const creds = await loadCredentials();
+    if (!creds)
+        return err('NOT_LOGGED_IN', 'Not logged in — run `ultraclaude-dashboard-agent login` first');
+    const url = `${getServerUrl(creds)}${path}`;
+    const headers = {
+        Authorization: `Bearer ${creds.apiKey}`,
+        'Content-Type': 'application/json',
+        ...extraHeaders,
+    };
+    const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    }).catch(() => null);
+    if (!response)
+        return err('NETWORK_ERROR', `Failed to reach ${url}`);
+    return ok(response);
+}
+export async function fetchManifest(projectId) {
+    const log = logger.child({ projectId, op: 'fetchManifest' });
+    const result = await apiRequest('GET', `/api/sync/manifest?projectId=${projectId}`);
+    if (!result.success)
+        return result;
+    if (!result.data.ok) {
+        log.error({ status: result.data.status }, 'Failed to fetch manifest');
+        return err('MANIFEST_FETCH_FAILED', `Manifest fetch failed: ${result.data.status}`);
+    }
+    const body = (await result.data.json());
+    // Flatten the nested manifest into ManifestEntry[]
+    const entries = [];
+    for (const [filePath, file] of Object.entries(body.data.files)) {
+        for (const [headingSlug, contentHash] of Object.entries(file.sections)) {
+            if (contentHash) {
+                entries.push({ filePath, headingSlug, contentHash });
+            }
+        }
+    }
+    return ok(entries);
+}
+/**
+ * Load manifest from server and populate local section hash cache.
+ */
+export async function loadManifestIntoCache(projectId) {
+    const state = getOrCreateState(projectId);
+    const result = await fetchManifest(projectId);
+    if (!result.success) {
+        logger.warn({ projectId, error: result.error, message: result.message }, 'Could not load manifest — will push all sections');
+        state.needsManifestResync = true;
+        return;
+    }
+    state.sectionHashes.clear();
+    for (const entry of result.data) {
+        state.sectionHashes.set(`${entry.filePath}#${entry.headingSlug}`, entry.contentHash);
+    }
+    state.needsManifestResync = false;
+    logger.info({ projectId, entries: result.data.length }, 'Manifest loaded');
+}
+// --- Push sections ---
+/**
+ * Parse a markdown file and push only changed sections to the server.
+ * Returns the number of sections pushed.
+ */
+export async function syncMarkdownFile(projectId, projectPath, absoluteFilePath) {
+    const log = logger.child({ projectId, file: absoluteFilePath });
+    const fileStat = await stat(absoluteFilePath);
+    if (fileStat.size > MAX_FILE_SIZE) {
+        log.debug('Skipping file >1MB');
+        return 0;
+    }
+    const content = await readFile(absoluteFilePath, 'utf8');
+    const docDir = join(projectPath, 'documentation');
+    const relativePath = relative(docDir, absoluteFilePath);
+    const fileHash = computeContentHash(content);
+    const sections = parseMarkdownSections(content);
+    const state = getOrCreateState(projectId);
+    // Diff against cached hashes
+    const changedSections = [];
+    const currentSlugs = new Set();
+    for (const section of sections) {
+        const key = `${relativePath}#${section.slug}`;
+        currentSlugs.add(key);
+        const cached = state.sectionHashes.get(key);
+        if (cached !== section.contentHash) {
+            changedSections.push(section);
+        }
+    }
+    // Find removed slugs (sections that existed before but are gone now)
+    const removedSlugs = [];
+    for (const key of state.sectionHashes.keys()) {
+        if (key.startsWith(`${relativePath}#`) && !currentSlugs.has(key)) {
+            removedSlugs.push(key.split('#')[1]);
+        }
+    }
+    if (changedSections.length === 0 && removedSlugs.length === 0) {
+        log.debug('No section changes detected');
+        return 0;
+    }
+    // When we only have removals but no changed sections, we must include at least
+    // one current section to satisfy the server schema (sections.min(1)).
+    // Include the first existing section as a no-op upsert alongside the removals.
+    let sectionsToSend = changedSections;
+    if (sectionsToSend.length === 0 && removedSlugs.length > 0 && sections.length > 0) {
+        sectionsToSend = [sections[0]];
+    }
+    const payload = {
+        projectId,
+        file: relativePath,
+        file_hash: fileHash,
+        sections: sectionsToSend.map((s) => ({
+            slug: s.slug,
+            heading: s.heading || null,
+            level: s.level || null,
+            position: s.position,
+            content: s.content,
+            content_hash: s.contentHash,
+        })),
+        removedSlugs: removedSlugs.length > 0 ? removedSlugs : undefined,
+    };
+    const idempotencyKey = crypto.randomUUID();
+    const result = await apiRequest('POST', '/api/sync/sections', payload, {
+        'Idempotency-Key': idempotencyKey,
+    });
+    if (!result.success || !result.data.ok) {
+        const reason = !result.success ? result.message : `HTTP ${result.data.status}`;
+        log.warn({ error: reason }, 'Push failed — queueing for retry');
+        enqueue({ type: 'sections', projectId, filePath: relativePath, payload: JSON.stringify(payload), idempotencyKey });
+        return 0;
+    }
+    // Update cache
+    for (const section of changedSections) {
+        state.sectionHashes.set(`${relativePath}#${section.slug}`, section.contentHash);
+    }
+    for (const slug of removedSlugs) {
+        state.sectionHashes.delete(`${relativePath}#${slug}`);
+    }
+    log.info({ changed: changedSections.length, removed: removedSlugs.length }, 'Sections pushed');
+    return changedSections.length;
+}
+// --- Push JSON files ---
+export async function syncJsonFile(projectId, projectPath, absoluteFilePath) {
+    const log = logger.child({ projectId, file: absoluteFilePath });
+    const fileStat = await stat(absoluteFilePath);
+    if (fileStat.size > MAX_FILE_SIZE) {
+        log.debug('Skipping file >1MB');
+        return false;
+    }
+    const content = await readFile(absoluteFilePath, 'utf8');
+    const docDir = join(projectPath, 'documentation');
+    const relativePath = relative(docDir, absoluteFilePath);
+    const hash = computeContentHash(content);
+    const state = getOrCreateState(projectId);
+    if (state.fileHashes.get(relativePath) === hash) {
+        log.debug('No file changes detected');
+        return false;
+    }
+    const payload = {
+        projectId,
+        files: [
+            {
+                path: relativePath,
+                content,
+                hash,
+                size: fileStat.size,
+            },
+        ],
+    };
+    const idempotencyKey = crypto.randomUUID();
+    const result = await apiRequest('POST', '/api/sync/files', payload, {
+        'Idempotency-Key': idempotencyKey,
+    });
+    if (!result.success || !result.data.ok) {
+        const reason = !result.success ? result.message : `HTTP ${result.data.status}`;
+        log.warn({ error: reason }, 'File push failed — queueing for retry');
+        enqueue({ type: 'file', projectId, filePath: relativePath, payload: JSON.stringify(payload), idempotencyKey });
+        return false;
+    }
+    state.fileHashes.set(relativePath, hash);
+    log.info('File pushed');
+    return true;
+}
+// --- Sync a single file (auto-detect type) ---
+export async function syncFile(projectId, projectPath, absoluteFilePath) {
+    if (absoluteFilePath.endsWith('.md')) {
+        await syncMarkdownFile(projectId, projectPath, absoluteFilePath);
+    }
+    else if (absoluteFilePath.endsWith('.json')) {
+        await syncJsonFile(projectId, projectPath, absoluteFilePath);
+    }
+}
+// --- Project creation ---
+export async function createProjectOnServer(name, slug) {
+    const log = logger.child({ op: 'createProject', name });
+    const idempotencyKey = crypto.randomUUID();
+    const result = await apiRequest('POST', '/api/projects', { name, slug }, {
+        'Idempotency-Key': idempotencyKey,
+    });
+    if (!result.success) {
+        log.error({ error: result.error, message: result.message }, 'Failed to create project');
+        return null;
+    }
+    if (!result.data.ok) {
+        log.error({ status: result.data.status }, 'Failed to create project');
+        return null;
+    }
+    const data = (await result.data.json());
+    log.info({ projectId: data.data.id }, 'Project created on server');
+    return data.data;
+}
+// --- Snapshots ---
+export async function createSnapshot(projectId, name, commitHash, trigger = 'manual') {
+    const log = logger.child({ projectId, op: 'snapshot' });
+    const result = await apiRequest('POST', '/api/sync/snapshot', {
+        projectId,
+        name,
+        commitHash,
+        trigger,
+    });
+    if (!result.success) {
+        log.error({ error: result.error, message: result.message }, 'Failed to create snapshot');
+        return false;
+    }
+    if (!result.data.ok) {
+        log.error({ status: result.data.status }, 'Failed to create snapshot');
+        return false;
+    }
+    log.info({ name }, 'Snapshot created');
+    return true;
+}
+// --- Initial sync for a project ---
+export async function initialSync(projectId, projectPath) {
+    const log = logger.child({ projectId, op: 'initialSync' });
+    log.info('Starting initial sync');
+    await loadManifestIntoCache(projectId);
+    // Walk documentation/ and sync all files
+    const { glob } = await import('node:fs/promises');
+    const docDir = join(projectPath, 'documentation');
+    try {
+        for await (const entry of glob(join(docDir, '**/*'), {})) {
+            const fileStat = await stat(entry).catch(() => null);
+            if (!fileStat?.isFile())
+                continue;
+            if (fileStat.size > MAX_FILE_SIZE)
+                continue;
+            await syncFile(projectId, projectPath, entry);
+        }
+        log.info('Initial sync complete');
+    }
+    catch (err) {
+        log.warn({ err }, 'Initial sync incomplete — will catch up via watcher');
+    }
+}
+// --- Memory queue ---
+function enqueue(item) {
+    if (queue.length >= QUEUE_CAP) {
+        const dropped = queue.shift(); // Drop oldest
+        // Flag the DROPPED item's project for resync — that's the project that lost data
+        const droppedState = projectStates.get(dropped.projectId);
+        if (droppedState)
+            droppedState.needsManifestResync = true;
+        logger.warn({ droppedProject: dropped.projectId }, 'Queue overflow — dropped oldest item, manifest resync needed');
+    }
+    queue.push(item);
+    ensureRetryTimer();
+}
+async function flushQueue() {
+    if (queue.length === 0)
+        return;
+    const log = logger.child({ op: 'flushQueue', queueSize: queue.length });
+    log.info('Flushing offline queue');
+    // Check if any projects need manifest resync
+    for (const [projectId, state] of projectStates) {
+        if (state.needsManifestResync) {
+            await loadManifestIntoCache(projectId);
+        }
+    }
+    // Try to send queued items
+    const remaining = [];
+    for (const item of queue) {
+        const endpoint = item.type === 'sections' ? '/api/sync/sections' : '/api/sync/files';
+        const result = await apiRequest('POST', endpoint, JSON.parse(item.payload), {
+            'Idempotency-Key': item.idempotencyKey,
+        });
+        if (!result.success) {
+            if (result.error === 'NOT_LOGGED_IN')
+                break;
+            remaining.push(item);
+            break; // Network error — server still down, stop trying
+        }
+        if (!result.data.ok && result.data.status >= 500) {
+            remaining.push(item);
+        }
+        // 4xx errors are dropped (permanent failures)
+    }
+    queue.length = 0;
+    queue.push(...remaining);
+    if (queue.length === 0) {
+        stopRetryTimer();
+        log.info('Queue drained');
+    }
+}
+function ensureRetryTimer() {
+    if (retryTimer)
+        return;
+    retryTimer = setInterval(() => {
+        flushQueue().catch((err) => logger.error({ err }, 'Queue flush error'));
+    }, RETRY_INTERVAL_MS);
+}
+function stopRetryTimer() {
+    if (retryTimer) {
+        clearInterval(retryTimer);
+        retryTimer = null;
+    }
+}
+export function getQueueSize() {
+    return queue.length;
+}
+export function stopSync() {
+    stopRetryTimer();
+    queue.length = 0;
+    projectStates.clear();
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

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

package/dist/usage-sync.d.ts

@@ -0,0 +1,7 @@
+export declare function syncUsageData(): Promise<void>;
+export interface UsageWatcher {
+    close(): Promise<void>;
+}
+export declare function startUsageWatcher(): UsageWatcher;
+export declare function stopUsageWatcher(): void;
+//# sourceMappingURL=usage-sync.d.ts.map

package/dist/usage-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-sync.d.ts","sourceRoot":"","sources":["../src/usage-sync.ts"],"names":[],"mappings":"AAkMA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAanD;AAID,MAAM,WAAW,YAAY;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAgB,iBAAiB,IAAI,YAAY,CA4ChD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAavC"}

package/dist/usage-sync.js

@@ -0,0 +1,208 @@
+// Usage file watcher: watch usage-status.json and accounts/ registry, push merged data to server
+import chokidar from 'chokidar';
+import { readFile, readdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { apiRequest } from './sync.js';
+import { logger } from './logger.js';
+// --- Paths ---
+const ULTRA_DIR = join(homedir(), '.claude', 'ultra');
+const USAGE_STATUS_PATH = join(ULTRA_DIR, 'usage-status.json');
+const ACCOUNTS_DIR = join(ULTRA_DIR, 'accounts');
+// --- Module state ---
+const DEBOUNCE_MS = 1_000;
+const RETRY_INTERVAL_MS = 5_000;
+let watcher = null;
+let debounceTimer = null;
+let retryTimer = null;
+let pendingRetryPayload = null;
+// --- JSON reading helpers ---
+async function readJsonFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf8');
+        if (!content.trim())
+            return null;
+        return JSON.parse(content);
+    }
+    catch (e) {
+        if (e.code === 'ENOENT')
+            return null;
+        logger.warn({ err: e, filePath }, 'Failed to read/parse JSON file');
+        return null;
+    }
+}
+async function readAccountsRegistry() {
+    const accounts = new Map();
+    let files;
+    try {
+        files = await readdir(ACCOUNTS_DIR);
+    }
+    catch (e) {
+        if (e.code === 'ENOENT')
+            return accounts;
+        logger.warn({ err: e, dir: ACCOUNTS_DIR }, 'Failed to read accounts directory');
+        return accounts;
+    }
+    const jsonFiles = files.filter((f) => f.endsWith('.json'));
+    await Promise.all(jsonFiles.map(async (file) => {
+        const data = await readJsonFile(join(ACCOUNTS_DIR, file));
+        if (data?.account_id) {
+            accounts.set(data.account_id, data);
+        }
+    }));
+    return accounts;
+}
+// --- Build payload ---
+async function buildUsagePayload() {
+    const log = logger.child({ op: 'buildUsagePayload' });
+    const usageStatus = await readJsonFile(USAGE_STATUS_PATH);
+    if (!usageStatus?.accounts || Object.keys(usageStatus.accounts).length === 0) {
+        log.debug('No usage data to push');
+        return null;
+    }
+    const registry = await readAccountsRegistry();
+    const accounts = {};
+    for (const [accountId, usage] of Object.entries(usageStatus.accounts)) {
+        const accountInfo = registry.get(accountId);
+        accounts[accountId] = {
+            account_id: accountId,
+            email: accountInfo?.email,
+            org_name: accountInfo?.orgName,
+            subscription_type: accountInfo?.subscriptionType,
+            rate_limits: {
+                five_hour: {
+                    used_percentage: usage.rate_limits.five_hour.used_percentage,
+                    resets_at: usage.rate_limits.five_hour.resets_at,
+                },
+                seven_day: {
+                    used_percentage: usage.rate_limits.seven_day.used_percentage,
+                    resets_at: usage.rate_limits.seven_day.resets_at,
+                },
+            },
+            updated_at: usage.updated_at,
+        };
+    }
+    return { accounts };
+}
+// --- Push to server ---
+async function pushUsageData(payload) {
+    const log = logger.child({ op: 'pushUsageData', accountCount: Object.keys(payload.accounts).length });
+    const result = await apiRequest('POST', '/api/sync/usage', payload);
+    if (!result.success) {
+        if (result.error === 'NOT_LOGGED_IN') {
+            log.error({ error: result.error }, 'Cannot push usage — not logged in');
+            return true; // Permanent failure — don't retry (per error-handling.md)
+        }
+        log.warn({ error: result.message }, 'Usage push failed — will retry');
+        return false;
+    }
+    if (!result.data.ok) {
+        const status = result.data.status;
+        if (status >= 400 && status < 500) {
+            log.error({ status }, 'Usage push rejected by server — not retrying');
+            return true; // Don't retry 4xx (permanent failure)
+        }
+        log.warn({ status }, 'Usage push failed — will retry');
+        return false;
+    }
+    log.info('Usage data pushed');
+    return true;
+}
+// --- Retry mechanism ---
+function startRetryTimer() {
+    if (retryTimer)
+        return;
+    retryTimer = setInterval(() => {
+        if (!pendingRetryPayload) {
+            stopRetryTimer();
+            return;
+        }
+        pushUsageData(pendingRetryPayload)
+            .then((success) => {
+            if (success) {
+                pendingRetryPayload = null;
+                stopRetryTimer();
+                logger.info('Usage retry succeeded');
+            }
+        })
+            .catch((err) => {
+            logger.error({ err }, 'Usage retry error');
+        });
+    }, RETRY_INTERVAL_MS);
+}
+function stopRetryTimer() {
+    if (retryTimer) {
+        clearInterval(retryTimer);
+        retryTimer = null;
+    }
+}
+// --- Core sync function ---
+export async function syncUsageData() {
+    const payload = await buildUsagePayload();
+    if (!payload)
+        return;
+    // Fresh data supersedes any pending retry
+    pendingRetryPayload = null;
+    stopRetryTimer();
+    const success = await pushUsageData(payload);
+    if (!success) {
+        pendingRetryPayload = payload;
+        startRetryTimer();
+    }
+}
+export function startUsageWatcher() {
+    const log = logger.child({ op: 'usageWatcher' });
+    function scheduleSyncUsage() {
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(() => {
+            debounceTimer = null;
+            syncUsageData().catch((err) => {
+                log.error({ err }, 'Usage sync failed');
+            });
+        }, DEBOUNCE_MS);
+    }
+    watcher = chokidar.watch([USAGE_STATUS_PATH, ACCOUNTS_DIR], {
+        persistent: true,
+        ignoreInitial: true,
+        awaitWriteFinish: {
+            stabilityThreshold: 200,
+            pollInterval: 100,
+        },
+    });
+    watcher
+        .on('add', scheduleSyncUsage)
+        .on('change', scheduleSyncUsage)
+        .on('error', (err) => log.error({ err }, 'Usage watcher error'));
+    log.info({ paths: [USAGE_STATUS_PATH, ACCOUNTS_DIR] }, 'Usage watcher started');
+    return {
+        async close() {
+            if (debounceTimer) {
+                clearTimeout(debounceTimer);
+                debounceTimer = null;
+            }
+            stopRetryTimer();
+            pendingRetryPayload = null;
+            if (watcher) {
+                await watcher.close();
+                watcher = null;
+            }
+            log.info('Usage watcher stopped');
+        },
+    };
+}
+export function stopUsageWatcher() {
+    if (debounceTimer) {
+        clearTimeout(debounceTimer);
+        debounceTimer = null;
+    }
+    stopRetryTimer();
+    pendingRetryPayload = null;
+    if (watcher) {
+        watcher.close().catch((err) => {
+            logger.error({ err }, 'Error closing usage watcher');
+        });
+        watcher = null;
+    }
+}
+//# sourceMappingURL=usage-sync.js.map

package/dist/usage-sync.js.map

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

package/dist/watcher.d.ts

@@ -0,0 +1,16 @@
+interface ProjectWatcherOptions {
+    projectId: string;
+    projectPath: string;
+}
+export interface ProjectWatcher {
+    projectId: string;
+    projectPath: string;
+    close(): Promise<void>;
+}
+/**
+ * Start watching a project's documentation/ directory for changes.
+ * Also watches .git/HEAD for branch switches (triggers full resync).
+ */
+export declare function startProjectWatcher(options: ProjectWatcherOptions): ProjectWatcher;
+export {};
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAQA,UAAU,qBAAqB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAkFlF"}