@mrpatronz/nexusflow 0.2.19 → 1.3.1

package/dist/core/scheduler.js

@@ -0,0 +1,361 @@
+/**
+ * @module core/scheduler
+ * Recurring workspace jobs — periodic `sync` and `refresh` runs per workspace.
+ *
+ * Job definitions are persisted at `~/.nexusflow/schedules.json` and executed
+ * by any long-running NexusFlow process (the dashboard server started with
+ * `nexusflow ui` runs the scheduler automatically). Jobs use the headless
+ * cores (`syncWorkspace`, `refreshWorkspace`), which are cache-aware: a
+ * scheduled run only re-analyzes repos whose content changed, so unattended
+ * schedules stay token-efficient and never churn unchanged context files.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { getConfigDir, ensureConfigDir } from './config.js';
+import { syncWorkspace } from './sync.js';
+import { refreshWorkspace } from './refresh.js';
+/** Name of the schedules file inside ~/.nexusflow. */
+const SCHEDULES_FILE = 'schedules.json';
+const SCHEDULES_LOCK_FILE = `${SCHEDULES_FILE}.lock`;
+const RUN_LOCK_DIR = 'schedule-runs';
+const STORE_LOCK_TIMEOUT_MS = 10_000;
+const STORE_LOCK_STALE_MS = 2 * 60_000;
+const RUN_LOCK_STALE_MS = 24 * 60 * 60_000;
+const LOCK_RETRY_MS = 50;
+let scheduleStoreMutationQueue = Promise.resolve();
+/**
+ * Returns the path to the schedules file (~/.nexusflow/schedules.json).
+ */
+export function getSchedulesPath() {
+    return path.join(getConfigDir(), SCHEDULES_FILE);
+}
+function getSchedulesLockPath() {
+    return path.join(getConfigDir(), SCHEDULES_LOCK_FILE);
+}
+function getRunLockPath(jobId) {
+    const safeId = jobId.replace(/[^a-zA-Z0-9._-]/g, '_');
+    return path.join(getConfigDir(), RUN_LOCK_DIR, `${safeId}.lock`);
+}
+function getErrorCode(error) {
+    return typeof error === 'object' && error !== null && 'code' in error
+        ? String(error.code)
+        : undefined;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function clearStaleLock(lockPath, staleMs) {
+    try {
+        const stat = await fs.stat(lockPath);
+        if (Date.now() - stat.mtimeMs <= staleMs)
+            return false;
+        await fs.unlink(lockPath);
+        return true;
+    }
+    catch (error) {
+        return getErrorCode(error) === 'ENOENT';
+    }
+}
+async function acquireLock(lockPath, options) {
+    await fs.mkdir(path.dirname(lockPath), { recursive: true });
+    const startedAt = Date.now();
+    for (;;) {
+        try {
+            const handle = await fs.open(lockPath, 'wx');
+            try {
+                await handle.writeFile(JSON.stringify({
+                    pid: process.pid,
+                    createdAt: new Date().toISOString(),
+                }) + '\n', 'utf-8');
+            }
+            catch (error) {
+                await handle.close().catch(() => { });
+                await fs.unlink(lockPath).catch(() => { });
+                throw error;
+            }
+            let released = false;
+            return async () => {
+                if (released)
+                    return;
+                released = true;
+                await handle.close().catch(() => { });
+                await fs.unlink(lockPath).catch(() => { });
+            };
+        }
+        catch (error) {
+            if (getErrorCode(error) !== 'EEXIST')
+                throw error;
+            if (await clearStaleLock(lockPath, options.staleMs))
+                continue;
+            if (Date.now() - startedAt >= options.timeoutMs) {
+                throw new Error(options.timeoutMessage);
+            }
+            await delay(LOCK_RETRY_MS);
+        }
+    }
+}
+function enqueueScheduleStoreMutation(operation) {
+    const run = scheduleStoreMutationQueue.then(operation, operation);
+    scheduleStoreMutationQueue = run.then(() => undefined, () => undefined);
+    return run;
+}
+async function mutateSchedules(mutator) {
+    return enqueueScheduleStoreMutation(async () => {
+        const release = await acquireLock(getSchedulesLockPath(), {
+            staleMs: STORE_LOCK_STALE_MS,
+            timeoutMs: STORE_LOCK_TIMEOUT_MS,
+            timeoutMessage: 'Timed out waiting for schedules.json to become writable.',
+        });
+        try {
+            const store = await loadSchedules();
+            const result = await mutator(store);
+            if (result.save) {
+                await saveSchedules(store);
+            }
+            return result.value;
+        }
+        finally {
+            await release();
+        }
+    });
+}
+/**
+ * Loads all schedules, returning an empty store when the file does not exist
+ * or cannot be parsed.
+ */
+export async function loadSchedules() {
+    try {
+        const raw = await fs.readFile(getSchedulesPath(), 'utf-8');
+        const store = JSON.parse(raw);
+        if (!Array.isArray(store.jobs)) {
+            store.jobs = [];
+        }
+        return store;
+    }
+    catch {
+        return { version: 1, jobs: [] };
+    }
+}
+/**
+ * Persists the schedule store to ~/.nexusflow/schedules.json.
+ */
+export async function saveSchedules(store) {
+    await ensureConfigDir();
+    const data = JSON.stringify(store, null, 2) + '\n';
+    await fs.writeFile(getSchedulesPath(), data, 'utf-8');
+}
+/**
+ * Parses a human interval like '30m', '2h', '1d', or a bare minute count
+ * ('45') into minutes. Returns null for unparseable or non-positive input.
+ */
+export function parseInterval(text) {
+    const match = String(text).trim().match(/^(\d+)\s*([mhd]?)$/i);
+    if (!match)
+        return null;
+    const value = parseInt(match[1], 10);
+    if (value <= 0)
+        return null;
+    switch ((match[2] || 'm').toLowerCase()) {
+        case 'h':
+            return value * 60;
+        case 'd':
+            return value * 60 * 24;
+        default:
+            return value;
+    }
+}
+/**
+ * Formats an interval in minutes back to a compact human string.
+ */
+export function formatInterval(minutes) {
+    if (minutes % (60 * 24) === 0)
+        return `${minutes / (60 * 24)}d`;
+    if (minutes % 60 === 0)
+        return `${minutes / 60}h`;
+    return `${minutes}m`;
+}
+/**
+ * Whether a job is due to run: it is enabled and either never ran or its
+ * interval has elapsed since the last run. A job whose interval elapsed while
+ * no scheduler was running simply runs on the next tick.
+ */
+export function isDue(job, now = new Date()) {
+    if (!job.enabled)
+        return false;
+    if (!job.lastRunAt)
+        return true;
+    const last = Date.parse(job.lastRunAt);
+    if (Number.isNaN(last))
+        return true;
+    return now.getTime() - last >= job.intervalMinutes * 60_000;
+}
+/**
+ * Computes when a job will next be due, for display purposes.
+ */
+export function nextDueAt(job) {
+    if (!job.enabled)
+        return null;
+    if (!job.lastRunAt)
+        return new Date();
+    const last = Date.parse(job.lastRunAt);
+    if (Number.isNaN(last))
+        return new Date();
+    return new Date(last + job.intervalMinutes * 60_000);
+}
+/**
+ * Adds a new schedule and persists it.
+ *
+ * @param input - Workspace, task, and interval for the new job.
+ * @returns The created job.
+ */
+export async function addSchedule(input) {
+    return mutateSchedules((store) => {
+        const workspaceName = path.basename(input.workspacePath);
+        const job = {
+            id: `${input.task}-${workspaceName}-${Date.now().toString(36)}`,
+            workspacePath: input.workspacePath,
+            task: input.task,
+            intervalMinutes: input.intervalMinutes,
+            enabled: true,
+            createdAt: new Date().toISOString(),
+        };
+        store.jobs.push(job);
+        return { value: job, save: true };
+    });
+}
+/**
+ * Removes a schedule by id. Returns false when no job matched.
+ */
+export async function removeSchedule(id) {
+    return mutateSchedules((store) => {
+        const before = store.jobs.length;
+        store.jobs = store.jobs.filter((j) => j.id !== id);
+        const removed = store.jobs.length !== before;
+        return { value: removed, save: removed };
+    });
+}
+/**
+ * Enables or disables a schedule by id. Returns the updated job, or null
+ * when no job matched.
+ */
+export async function setScheduleEnabled(id, enabled) {
+    return mutateSchedules((store) => {
+        const job = store.jobs.find((j) => j.id === id);
+        if (!job)
+            return { value: null, save: false };
+        job.enabled = enabled;
+        return { value: job, save: true };
+    });
+}
+/**
+ * Runs a single job immediately and records the outcome in the store.
+ * Never throws — failures are captured in the returned result.
+ *
+ * @param job - The job to run.
+ * @returns The classified outcome with a summary message.
+ */
+export async function runJob(job) {
+    let releaseRunLock = null;
+    try {
+        releaseRunLock = await acquireLock(getRunLockPath(job.id), {
+            staleMs: RUN_LOCK_STALE_MS,
+            timeoutMs: 0,
+            timeoutMessage: `Schedule ${job.id} is already running.`,
+        });
+    }
+    catch (error) {
+        return {
+            status: 'error',
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+    let result;
+    try {
+        if (job.task === 'sync') {
+            const report = await syncWorkspace(job.workspacePath);
+            const parts = [`${report.syncedCount} synced`];
+            if (report.conflictCount > 0)
+                parts.push(`${report.conflictCount} conflict(s)`);
+            if (report.errorCount > 0)
+                parts.push(`${report.errorCount} error(s)`);
+            parts.push(report.contextRefreshed ? 'context refreshed' : 'context unchanged');
+            result = {
+                status: report.conflictCount > 0 || report.errorCount > 0 ? 'error' : 'success',
+                message: parts.join(', '),
+            };
+        }
+        else {
+            const report = await refreshWorkspace(job.workspacePath);
+            result = {
+                status: 'success',
+                message: `${report.analyzedRepos.length} repo(s) re-analyzed, ${report.reusedRepos.length} reused from cache`,
+            };
+        }
+    }
+    catch (error) {
+        result = {
+            status: 'error',
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+    // Record the run. Re-load the store so concurrent CLI edits are not lost.
+    try {
+        await mutateSchedules((store) => {
+            const stored = store.jobs.find((j) => j.id === job.id);
+            if (!stored)
+                return { value: undefined, save: false };
+            stored.lastRunAt = new Date().toISOString();
+            stored.lastStatus = result.status;
+            stored.lastMessage = result.message;
+            return { value: undefined, save: true };
+        });
+    }
+    catch {
+        // Best-effort bookkeeping; the job itself already ran.
+    }
+    finally {
+        await releaseRunLock();
+    }
+    return result;
+}
+/**
+ * Starts the scheduler loop inside the current process. Every tick it
+ * re-loads the schedules file (so jobs added/removed via CLI are picked up
+ * without a restart) and runs all due jobs sequentially. Ticks never overlap.
+ *
+ * @param options - Tick interval (default 60s) and an optional log sink.
+ * @returns A stop function that clears the interval.
+ */
+export function startScheduler(options = {}) {
+    const tickMs = options.tickMs ?? 60_000;
+    const log = options.log ?? (() => { });
+    let running = false;
+    const tick = async () => {
+        if (running)
+            return;
+        running = true;
+        try {
+            const store = await loadSchedules();
+            for (const job of store.jobs) {
+                if (!isDue(job))
+                    continue;
+                log(`Running scheduled ${job.task} for ${path.basename(job.workspacePath)} (${job.id})...`);
+                const result = await runJob(job);
+                log(`Scheduled ${job.task} ${result.status === 'success' ? 'completed' : 'failed'}: ${result.message}`);
+            }
+        }
+        catch {
+            // A broken schedules file must not kill the host process's timer.
+        }
+        finally {
+            running = false;
+        }
+    };
+    const timer = setInterval(tick, tickMs);
+    // Don't let the scheduler keep a short-lived CLI process alive.
+    timer.unref?.();
+    // First tick runs immediately so overdue jobs don't wait a full interval.
+    void tick();
+    return () => clearInterval(timer);
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/core/scheduler.js.map

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

package/dist/core/scheduler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scheduler.test.d.ts.map

package/dist/core/scheduler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.test.d.ts","sourceRoot":"","sources":["../../src/core/scheduler.test.ts"],"names":[],"mappings":""}

package/dist/core/scheduler.test.js

@@ -0,0 +1,163 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import { addSchedule, formatInterval, isDue, loadSchedules, nextDueAt, parseInterval, removeSchedule, runJob, setScheduleEnabled, } from './scheduler.js';
+import { refreshWorkspace } from './refresh.js';
+import { syncWorkspace } from './sync.js';
+vi.mock('node:fs/promises');
+vi.mock('./refresh.js');
+vi.mock('./sync.js');
+/** Parses the JSON written by the most recent writeFile call. */
+function lastWritten() {
+    const calls = vi.mocked(fs.writeFile).mock.calls;
+    const data = calls[calls.length - 1][1];
+    return JSON.parse(data);
+}
+function mockScheduleStore(initial) {
+    let current = JSON.parse(JSON.stringify(initial));
+    vi.mocked(fs.readFile).mockImplementation(async () => JSON.stringify(current));
+    vi.mocked(fs.writeFile).mockImplementation(async (_path, data) => {
+        current = JSON.parse(String(data));
+    });
+    return { current: () => current };
+}
+function makeJob(overrides = {}) {
+    return {
+        id: 'sync-ws-abc',
+        workspacePath: '/ws',
+        task: 'sync',
+        intervalMinutes: 60,
+        enabled: true,
+        createdAt: '2026-01-01T00:00:00.000Z',
+        ...overrides,
+    };
+}
+describe('scheduler', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+        vi.mocked(fs.mkdir).mockResolvedValue(undefined);
+        vi.mocked(fs.unlink).mockResolvedValue(undefined);
+        vi.mocked(fs.stat).mockResolvedValue({ mtimeMs: Date.now() });
+        vi.mocked(fs.open).mockResolvedValue({
+            writeFile: vi.fn().mockResolvedValue(undefined),
+            close: vi.fn().mockResolvedValue(undefined),
+        });
+        vi.mocked(syncWorkspace).mockResolvedValue({
+            syncedCount: 1,
+            conflictCount: 0,
+            errorCount: 0,
+            contextRefreshed: false,
+        });
+        vi.mocked(refreshWorkspace).mockResolvedValue({
+            analyzedRepos: ['/repo'],
+            reusedRepos: [],
+        });
+    });
+    describe('parseInterval', () => {
+        it('parses minutes, hours, days, and bare numbers', () => {
+            expect(parseInterval('30m')).toBe(30);
+            expect(parseInterval('2h')).toBe(120);
+            expect(parseInterval('1d')).toBe(1440);
+            expect(parseInterval('45')).toBe(45);
+        });
+        it('rejects invalid or non-positive input', () => {
+            expect(parseInterval('')).toBeNull();
+            expect(parseInterval('abc')).toBeNull();
+            expect(parseInterval('0m')).toBeNull();
+            expect(parseInterval('-5m')).toBeNull();
+            expect(parseInterval('2w')).toBeNull();
+        });
+    });
+    describe('formatInterval', () => {
+        it('formats back to compact strings', () => {
+            expect(formatInterval(30)).toBe('30m');
+            expect(formatInterval(120)).toBe('2h');
+            expect(formatInterval(1440)).toBe('1d');
+            expect(formatInterval(90)).toBe('90m');
+        });
+    });
+    describe('isDue', () => {
+        it('is due when it has never run', () => {
+            expect(isDue(makeJob())).toBe(true);
+        });
+        it('is not due when disabled, even if never run', () => {
+            expect(isDue(makeJob({ enabled: false }))).toBe(false);
+        });
+        it('respects the interval since the last run', () => {
+            const now = new Date('2026-01-02T12:00:00.000Z');
+            const recent = makeJob({ lastRunAt: '2026-01-02T11:30:00.000Z' }); // 30m ago, every 60m
+            const stale = makeJob({ lastRunAt: '2026-01-02T10:00:00.000Z' }); // 2h ago, every 60m
+            expect(isDue(recent, now)).toBe(false);
+            expect(isDue(stale, now)).toBe(true);
+        });
+        it('treats an unparseable lastRunAt as due', () => {
+            expect(isDue(makeJob({ lastRunAt: 'garbage' }))).toBe(true);
+        });
+    });
+    describe('nextDueAt', () => {
+        it('is null for disabled jobs', () => {
+            expect(nextDueAt(makeJob({ enabled: false }))).toBeNull();
+        });
+        it('is lastRunAt + interval for jobs that ran', () => {
+            const job = makeJob({ lastRunAt: '2026-01-02T10:00:00.000Z' });
+            expect(nextDueAt(job).toISOString()).toBe('2026-01-02T11:00:00.000Z');
+        });
+    });
+    describe('store operations', () => {
+        it('loadSchedules returns an empty store when the file is absent', async () => {
+            vi.mocked(fs.readFile).mockRejectedValue(new Error('ENOENT'));
+            const store = await loadSchedules();
+            expect(store.jobs).toEqual([]);
+        });
+        it('addSchedule persists a new enabled job', async () => {
+            vi.mocked(fs.readFile).mockRejectedValue(new Error('ENOENT'));
+            const job = await addSchedule({ workspacePath: '/ws/feature-x', task: 'refresh', intervalMinutes: 120 });
+            expect(job.enabled).toBe(true);
+            expect(job.task).toBe('refresh');
+            expect(job.id).toContain('refresh-feature-x');
+            const written = lastWritten();
+            expect(written.jobs).toHaveLength(1);
+            expect(written.jobs[0].intervalMinutes).toBe(120);
+        });
+        it('removeSchedule deletes by id and reports misses', async () => {
+            mockScheduleStore({ version: 1, jobs: [makeJob()] });
+            expect(await removeSchedule('sync-ws-abc')).toBe(true);
+            expect(lastWritten().jobs).toHaveLength(0);
+            expect(await removeSchedule('nope')).toBe(false);
+        });
+        it('setScheduleEnabled toggles and persists', async () => {
+            mockScheduleStore({ version: 1, jobs: [makeJob()] });
+            const job = await setScheduleEnabled('sync-ws-abc', false);
+            expect(job.enabled).toBe(false);
+            expect(lastWritten().jobs[0].enabled).toBe(false);
+            expect(await setScheduleEnabled('nope', true)).toBeNull();
+        });
+        it('serializes concurrent schedule mutations so updates are not lost', async () => {
+            const store = mockScheduleStore({ version: 1, jobs: [] });
+            const [first, second] = await Promise.all([
+                addSchedule({ workspacePath: '/ws/feature-a', task: 'sync', intervalMinutes: 30 }),
+                addSchedule({ workspacePath: '/ws/feature-b', task: 'refresh', intervalMinutes: 60 }),
+            ]);
+            expect(store.current().jobs.map((job) => job.id)).toEqual([first.id, second.id]);
+        });
+    });
+    describe('runJob', () => {
+        it('does not run a job that already has an active run lock', async () => {
+            vi.mocked(fs.open).mockRejectedValueOnce(Object.assign(new Error('exists'), { code: 'EEXIST' }));
+            const result = await runJob(makeJob());
+            expect(result.status).toBe('error');
+            expect(result.message).toContain('already running');
+            expect(syncWorkspace).not.toHaveBeenCalled();
+            expect(refreshWorkspace).not.toHaveBeenCalled();
+        });
+        it('records the run result through the serialized schedule mutation path', async () => {
+            const store = mockScheduleStore({ version: 1, jobs: [makeJob()] });
+            const result = await runJob(makeJob());
+            expect(result.status).toBe('success');
+            expect(syncWorkspace).toHaveBeenCalledWith('/ws');
+            expect(store.current().jobs[0].lastStatus).toBe('success');
+            expect(store.current().jobs[0].lastMessage).toBe('1 synced, context unchanged');
+        });
+    });
+});
+//# sourceMappingURL=scheduler.test.js.map

package/dist/core/scheduler.test.js.map

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

package/dist/core/sync.d.ts

@@ -10,12 +10,16 @@ import type { SyncStatus } from '../types.js';
 export interface RepoSyncReport {
     /** Directory name of the repo. */
     name: string;
+    /** Base branch the repo rebases onto (e.g. 'main'). */
+    baseBranch: string;
     /** Classified outcome. */
     status: SyncStatus;
     /** Human-readable message. */
     message: string;
     /** Conflict stderr — populated only for `status === 'conflict'`. */
     conflict?: string;
+    /** Paths that had merge conflicts — populated only for `status === 'conflict'`. */
+    conflictFiles?: string[];
 }
 /** Aggregated result of syncing an entire workspace. */
 export interface SyncReport {
@@ -31,6 +35,8 @@ export interface SyncReport {
     conflictCount: number;
     /** Count of repos that failed for infrastructure reasons (fetch/auth, etc.). */
     errorCount: number;
+    /** Whether context files/maps were regenerated (only when content changed). */
+    contextRefreshed: boolean;
 }
 /**
  * Syncs all repos in a workspace. Throws if the workspace configuration cannot

package/dist/core/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/core/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAEhE,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA8D9E"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/core/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAEhE,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAOD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsE9E"}

package/dist/core/sync.js

@@ -5,11 +5,10 @@
  * context files. Produces no console output, so it can back the CLI, the HTTP
  * API, and the MCP tool alike.
  */
-import * as path from 'node:path';
-import { loadFeatureConfig } from './workspace.js';
+import { loadFeatureConfig, resolveRepoInfos } from './workspace.js';
 import { recordRepoSync } from './workspace-state.js';
 import { getWorkspaceRepos, rebaseRepo } from '../utils/multi-git.js';
-import { analyzeAllRepos } from '../analyzers/index.js';
+import { analyzeAllReposCached } from '../analyzers/index.js';
 import { generateContextFiles } from '../generators/index.js';
 /** A sync status counts as "synced" when the rebase itself landed. */
 function isSynced(status) {
@@ -42,9 +41,11 @@ export async function syncWorkspace(workspacePath) {
         });
         repoReports.push({
             name: repo.name,
+            baseBranch: defaultBranch,
             status: result.status,
             message: result.message,
             conflict: result.conflict,
+            conflictFiles: result.conflictFiles,
         });
         if (isSynced(result.status))
             syncedCount++;
@@ -53,18 +54,21 @@ export async function syncWorkspace(workspacePath) {
         else
             errorCount++;
     }
-    // Regenerate maps/context when anything synced. A regen failure must never
+    // Regenerate maps/context only when a rebase actually changed repo content
+    // ('rebased' or 'stash-conflict'). When every repo was already up to date,
+    // skipping regeneration keeps context files byte-identical — no wasted
+    // analysis and no invalidated AI prompt caches. The cached analyzer then
+    // limits the work to the repos that changed. A regen failure must never
     // fail the sync itself — the rebases already happened.
-    if (syncedCount > 0) {
+    const contentChanged = repoReports.some((r) => r.status === 'rebased' || r.status === 'stash-conflict');
+    let contextRefreshed = false;
+    if (contentChanged) {
         try {
-            const allRepos = feature.repos.map((r) => ({
-                name: path.basename(r),
-                path: r,
-                defaultBranch: 'main',
-            }));
-            const analysis = await analyzeAllRepos(allRepos);
+            const allRepos = await resolveRepoInfos(feature.repos);
+            const { analysis, analyzed } = await analyzeAllReposCached(allRepos, workspacePath);
             const ctx = { feature, repos: allRepos, analysis };
-            await generateContextFiles(ctx, feature.assistants, workspacePath);
+            await generateContextFiles(ctx, feature.assistants, workspacePath, undefined, undefined, analyzed);
+            contextRefreshed = true;
         }
         catch {
             // Best-effort regeneration; ignore failures.
@@ -77,6 +81,7 @@ export async function syncWorkspace(workspacePath) {
         syncedCount,
         conflictCount,
         errorCount,
+        contextRefreshed,
     };
 }
 //# sourceMappingURL=sync.js.map