@dmsdc-ai/aigentry-brain 0.0.1

package/dist/shared/Mutex.js

@@ -0,0 +1,34 @@
+export class Mutex {
+    _locked = false;
+    _queue = [];
+    async acquire() {
+        return new Promise((resolve) => {
+            const tryAcquire = () => {
+                if (!this._locked) {
+                    this._locked = true;
+                    resolve(() => this.release());
+                }
+                else {
+                    this._queue.push(tryAcquire);
+                }
+            };
+            tryAcquire();
+        });
+    }
+    release() {
+        this._locked = false;
+        const next = this._queue.shift();
+        if (next)
+            next();
+    }
+    async runExclusive(fn) {
+        const release = await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            release();
+        }
+    }
+}
+//# sourceMappingURL=Mutex.js.map

package/dist/shared/Mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mutex.js","sourceRoot":"","sources":["../../src/shared/Mutex.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,KAAK;IACR,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAsB,EAAE,CAAC;IAEvC,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE;YACzC,MAAM,UAAU,GAAG,GAAG,EAAE;gBACtB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;oBAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;oBACpB,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC,CAAC;YACF,UAAU,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,IAAI;YAAE,IAAI,EAAE,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,YAAY,CAAI,EAAoB;QACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/shared/SetupErrors.d.ts

@@ -0,0 +1,31 @@
+export declare enum SetupError {
+    GH_NOT_INSTALLED = "GH_NOT_INSTALLED",
+    GH_NOT_AUTHENTICATED = "GH_NOT_AUTHENTICATED",
+    AGE_KEY_MISSING = "AGE_KEY_MISSING",
+    AGE_KEY_ERROR = "AGE_KEY_ERROR",
+    AGE_DECRYPT_FAILED = "AGE_DECRYPT_FAILED",
+    REPO_CLONE_FAILED = "REPO_CLONE_FAILED",
+    REPO_PUSH_FAILED = "REPO_PUSH_FAILED",
+    NETWORK_UNREACHABLE = "NETWORK_UNREACHABLE",
+    BREW_NOT_AVAILABLE = "BREW_NOT_AVAILABLE",
+    PERMISSION_DENIED = "PERMISSION_DENIED"
+}
+export interface ErrorGuide {
+    error: SetupError;
+    userMessage: string;
+    autoFixCommand?: string;
+    manualFixSteps: string[];
+    docUrl?: string;
+}
+/**
+ * Get the guide for a specific setup error.
+ */
+export declare function getErrorGuide(error: SetupError): ErrorGuide;
+/**
+ * Format an error guide as a user-friendly string for CON/terminal output.
+ */
+export declare function formatErrorGuide(error: SetupError): string;
+/**
+ * Classify an error from a catch block into a SetupError.
+ */
+export declare function classifyError(err: unknown, context?: string): SetupError | null;

package/dist/shared/SetupErrors.js

@@ -0,0 +1,155 @@
+export var SetupError;
+(function (SetupError) {
+    SetupError["GH_NOT_INSTALLED"] = "GH_NOT_INSTALLED";
+    SetupError["GH_NOT_AUTHENTICATED"] = "GH_NOT_AUTHENTICATED";
+    SetupError["AGE_KEY_MISSING"] = "AGE_KEY_MISSING";
+    SetupError["AGE_KEY_ERROR"] = "AGE_KEY_ERROR";
+    SetupError["AGE_DECRYPT_FAILED"] = "AGE_DECRYPT_FAILED";
+    SetupError["REPO_CLONE_FAILED"] = "REPO_CLONE_FAILED";
+    SetupError["REPO_PUSH_FAILED"] = "REPO_PUSH_FAILED";
+    SetupError["NETWORK_UNREACHABLE"] = "NETWORK_UNREACHABLE";
+    SetupError["BREW_NOT_AVAILABLE"] = "BREW_NOT_AVAILABLE";
+    SetupError["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+})(SetupError || (SetupError = {}));
+const ERROR_GUIDES = {
+    [SetupError.GH_NOT_INSTALLED]: {
+        userMessage: 'GitHub CLI (gh) is not installed.',
+        autoFixCommand: 'brew install gh',
+        manualFixSteps: [
+            'macOS: brew install gh',
+            'Linux: sudo apt install gh  OR  sudo dnf install gh',
+            'Windows: winget install --id GitHub.cli',
+        ],
+        docUrl: 'https://cli.github.com/manual/installation',
+    },
+    [SetupError.GH_NOT_AUTHENTICATED]: {
+        userMessage: 'GitHub CLI is installed but not authenticated.',
+        autoFixCommand: 'gh auth login --web',
+        manualFixSteps: [
+            'Run: gh auth login --web',
+            'This opens a browser for GitHub OAuth.',
+            'For headless environments: gh auth login --with-token < token.txt',
+        ],
+        docUrl: 'https://cli.github.com/manual/gh_auth_login',
+    },
+    [SetupError.AGE_KEY_MISSING]: {
+        userMessage: 'No age encryption key found.',
+        autoFixCommand: 'aigentry-brain-setup',
+        manualFixSteps: [
+            'Run: aigentry-brain-setup (auto-generates key)',
+            'Or manually: mkdir -p ~/.config/sops/age && age-keygen -o ~/.config/sops/age/keys.txt',
+        ],
+    },
+    [SetupError.AGE_KEY_ERROR]: {
+        userMessage: 'Age encryption key is invalid or corrupted.',
+        manualFixSteps: [
+            'Check key file: cat ~/.config/sops/age/keys.txt',
+            'Key should contain AGE-SECRET-KEY-... and age1... lines.',
+            'Regenerate: rm ~/.config/sops/age/keys.txt && aigentry-brain-setup',
+        ],
+    },
+    [SetupError.AGE_DECRYPT_FAILED]: {
+        userMessage: 'Failed to decrypt profile data.',
+        manualFixSteps: [
+            'This usually means a new device needs re-encryption from an existing device.',
+            'Run aigentry-brain status to check encryption state.',
+            'If on a new device, wait for an existing device to sync and re-encrypt.',
+            'To bypass encryption: export AIGENTRY_ENCRYPTION=disabled',
+        ],
+    },
+    [SetupError.REPO_CLONE_FAILED]: {
+        userMessage: 'Failed to clone the profile repository.',
+        manualFixSteps: [
+            'Check your internet connection.',
+            'Verify GitHub authentication: gh auth status',
+            'Verify the repo exists: gh repo view {repo-name}',
+            'Try cloning manually: git clone {repo-url}',
+        ],
+    },
+    [SetupError.REPO_PUSH_FAILED]: {
+        userMessage: 'Failed to push changes to the profile repository.',
+        manualFixSteps: [
+            'Check your internet connection.',
+            'Verify GitHub authentication: gh auth status',
+            'Check for permission issues: gh repo view {repo-name}',
+            'Try pushing manually: cd ~/.aigentry/repo && git push',
+        ],
+    },
+    [SetupError.NETWORK_UNREACHABLE]: {
+        userMessage: 'Cannot reach GitHub. Check your internet connection.',
+        manualFixSteps: [
+            'Check internet connectivity: ping github.com',
+            'If behind a proxy, configure git proxy: git config --global http.proxy {proxy-url}',
+            'aigentry-brain works offline — sync will resume when connectivity is restored.',
+        ],
+    },
+    [SetupError.BREW_NOT_AVAILABLE]: {
+        userMessage: 'Homebrew is not available on this system.',
+        manualFixSteps: [
+            'Install Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"',
+            'Or install tools directly from GitHub Releases.',
+        ],
+        docUrl: 'https://brew.sh',
+    },
+    [SetupError.PERMISSION_DENIED]: {
+        userMessage: 'Permission denied. You may need elevated permissions.',
+        manualFixSteps: [
+            'Try running with sudo if on Linux.',
+            'Check file permissions on ~/.aigentry/ directory.',
+            'On macOS, check System Preferences > Security & Privacy.',
+        ],
+    },
+};
+/**
+ * Get the guide for a specific setup error.
+ */
+export function getErrorGuide(error) {
+    const guide = ERROR_GUIDES[error];
+    return { error, ...guide };
+}
+/**
+ * Format an error guide as a user-friendly string for CON/terminal output.
+ */
+export function formatErrorGuide(error) {
+    const guide = getErrorGuide(error);
+    const lines = [];
+    lines.push(`\u26A0\uFE0F ${guide.userMessage}`);
+    if (guide.autoFixCommand) {
+        lines.push(`  Auto-fix: ${guide.autoFixCommand}`);
+    }
+    lines.push('  Manual steps:');
+    for (const step of guide.manualFixSteps) {
+        lines.push(`    \u2022 ${step}`);
+    }
+    if (guide.docUrl) {
+        lines.push(`  Docs: ${guide.docUrl}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Classify an error from a catch block into a SetupError.
+ */
+export function classifyError(err, context) {
+    const msg = err instanceof Error ? err.message : String(err);
+    const lower = msg.toLowerCase();
+    if (lower.includes('enoent') && context?.includes('gh'))
+        return SetupError.GH_NOT_INSTALLED;
+    if (lower.includes('agekeyerror') || (lower.includes('age key') && lower.includes('not found')))
+        return SetupError.AGE_KEY_MISSING;
+    if (lower.includes('could not parse age key'))
+        return SetupError.AGE_KEY_ERROR;
+    if (lower.includes('agedecrypterror') || lower.includes('decryption failed'))
+        return SetupError.AGE_DECRYPT_FAILED;
+    if (lower.includes('not logged in') || lower.includes('authentication'))
+        return SetupError.GH_NOT_AUTHENTICATED;
+    if (lower.includes('permission denied') || lower.includes('eacces'))
+        return SetupError.PERMISSION_DENIED;
+    if (lower.includes('could not resolve') || lower.includes('network') || lower.includes('etimedout'))
+        return SetupError.NETWORK_UNREACHABLE;
+    if (lower.includes('clone') || lower.includes('repository not found'))
+        return SetupError.REPO_CLONE_FAILED;
+    if (lower.includes('push') || lower.includes('rejected'))
+        return SetupError.REPO_PUSH_FAILED;
+    return null;
+}
+//# sourceMappingURL=SetupErrors.js.map

package/dist/shared/SetupErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SetupErrors.js","sourceRoot":"","sources":["../../src/shared/SetupErrors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,UAWX;AAXD,WAAY,UAAU;IACpB,mDAAqC,CAAA;IACrC,2DAA6C,CAAA;IAC7C,iDAAmC,CAAA;IACnC,6CAA+B,CAAA;IAC/B,uDAAyC,CAAA;IACzC,qDAAuC,CAAA;IACvC,mDAAqC,CAAA;IACrC,yDAA2C,CAAA;IAC3C,uDAAyC,CAAA;IACzC,qDAAuC,CAAA;AACzC,CAAC,EAXW,UAAU,KAAV,UAAU,QAWrB;AAUD,MAAM,YAAY,GAAkD;IAClE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE;QAC7B,WAAW,EAAE,mCAAmC;QAChD,cAAc,EAAE,iBAAiB;QACjC,cAAc,EAAE;YACd,wBAAwB;YACxB,qDAAqD;YACrD,yCAAyC;SAC1C;QACD,MAAM,EAAE,4CAA4C;KACrD;IACD,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE;QACjC,WAAW,EAAE,gDAAgD;QAC7D,cAAc,EAAE,qBAAqB;QACrC,cAAc,EAAE;YACd,0BAA0B;YAC1B,wCAAwC;YACxC,mEAAmE;SACpE;QACD,MAAM,EAAE,6CAA6C;KACtD;IACD,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE;QAC5B,WAAW,EAAE,8BAA8B;QAC3C,cAAc,EAAE,sBAAsB;QACtC,cAAc,EAAE;YACd,gDAAgD;YAChD,uFAAuF;SACxF;KACF;IACD,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;QAC1B,WAAW,EAAE,6CAA6C;QAC1D,cAAc,EAAE;YACd,iDAAiD;YACjD,0DAA0D;YAC1D,oEAAoE;SACrE;KACF;IACD,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE;QAC/B,WAAW,EAAE,iCAAiC;QAC9C,cAAc,EAAE;YACd,8EAA8E;YAC9E,sDAAsD;YACtD,yEAAyE;YACzE,2DAA2D;SAC5D;KACF;IACD,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE;QAC9B,WAAW,EAAE,yCAAyC;QACtD,cAAc,EAAE;YACd,iCAAiC;YACjC,8CAA8C;YAC9C,kDAAkD;YAClD,4CAA4C;SAC7C;KACF;IACD,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE;QAC7B,WAAW,EAAE,mDAAmD;QAChE,cAAc,EAAE;YACd,iCAAiC;YACjC,8CAA8C;YAC9C,uDAAuD;YACvD,uDAAuD;SACxD;KACF;IACD,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE;QAChC,WAAW,EAAE,sDAAsD;QACnE,cAAc,EAAE;YACd,8CAA8C;YAC9C,oFAAoF;YACpF,gFAAgF;SACjF;KACF;IACD,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE;QAC/B,WAAW,EAAE,2CAA2C;QACxD,cAAc,EAAE;YACd,mHAAmH;YACnH,iDAAiD;SAClD;QACD,MAAM,EAAE,iBAAiB;KAC1B;IACD,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE;QAC9B,WAAW,EAAE,uDAAuD;QACpE,cAAc,EAAE;YACd,oCAAoC;YACpC,mDAAmD;YACnD,0DAA0D;SAC3D;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,OAAgB;IAC1D,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAEhC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC,gBAAgB,CAAC;IAC5F,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC,eAAe,CAAC;IACnI,IAAI,KAAK,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAAE,OAAO,UAAU,CAAC,aAAa,CAAC;IAC/E,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,UAAU,CAAC,kBAAkB,CAAC;IACnH,IAAI,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,UAAU,CAAC,oBAAoB,CAAC;IAChH,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,UAAU,CAAC,iBAAiB,CAAC;IACzG,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,UAAU,CAAC,mBAAmB,CAAC;IAC3I,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAAE,OAAO,UAAU,CAAC,iBAAiB,CAAC;IAC3G,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC,gBAAgB,CAAC;IAE7F,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/status/SyncStatusStore.d.ts

@@ -0,0 +1,17 @@
+import type { Clock } from '../shared/Clock.js';
+export type SyncStatus = 'synced' | 'pending' | 'degraded' | 'offline';
+export interface SyncStatusFile {
+    status: SyncStatus;
+    last_sync: string;
+    pending_count: number;
+    error?: string;
+}
+export declare class SyncStatusStore {
+    private filePath;
+    private clock;
+    private listeners;
+    constructor(filePath: string, clock?: Clock);
+    onChange(cb: (status: SyncStatus) => void): void;
+    get(): Promise<SyncStatusFile>;
+    set(status: SyncStatus, extra?: Partial<SyncStatusFile>): Promise<void>;
+}

package/dist/status/SyncStatusStore.js

@@ -0,0 +1,48 @@
+import { readFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { SystemClock } from '../shared/Clock.js';
+import { atomicWrite } from '../shared/AtomicWrite.js';
+export class SyncStatusStore {
+    filePath;
+    clock;
+    listeners = [];
+    constructor(filePath, clock) {
+        this.filePath = filePath;
+        this.clock = clock ?? SystemClock;
+    }
+    onChange(cb) {
+        this.listeners.push(cb);
+    }
+    async get() {
+        if (!existsSync(this.filePath)) {
+            return { status: 'offline', last_sync: '', pending_count: 0 };
+        }
+        try {
+            const content = await readFile(this.filePath, 'utf8');
+            return JSON.parse(content);
+        }
+        catch {
+            return { status: 'offline', last_sync: '', pending_count: 0 };
+        }
+    }
+    async set(status, extra) {
+        const current = await this.get();
+        const updated = {
+            ...current,
+            ...extra,
+            status,
+        };
+        if (status === 'synced') {
+            updated.last_sync = this.clock.now().toISOString();
+            updated.pending_count = 0;
+            delete updated.error;
+        }
+        await mkdir(dirname(this.filePath), { recursive: true });
+        await atomicWrite(this.filePath, JSON.stringify(updated, null, 2));
+        for (const cb of this.listeners) {
+            cb(status);
+        }
+    }
+}
+//# sourceMappingURL=SyncStatusStore.js.map

package/dist/status/SyncStatusStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncStatusStore.js","sourceRoot":"","sources":["../../src/status/SyncStatusStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAWvD,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAS;IACjB,KAAK,CAAQ;IACb,SAAS,GAAwC,EAAE,CAAC;IAE5D,YAAY,QAAgB,EAAE,KAAa;QACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,WAAW,CAAC;IACpC,CAAC;IAED,QAAQ,CAAC,EAAgC;QACvC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAkB,EAAE,KAA+B;QAC3D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,MAAM,OAAO,GAAmB;YAC9B,GAAG,OAAO;YACV,GAAG,KAAK;YACR,MAAM;SACP,CAAC;QACF,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;YACnD,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC;YAC1B,OAAO,OAAO,CAAC,KAAK,CAAC;QACvB,CAAC;QACD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnE,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,EAAE,CAAC,MAAM,CAAC,CAAC;QACb,CAAC;IACH,CAAC;CACF"}

package/dist/sync/AutoCommitter.d.ts

@@ -0,0 +1,17 @@
+import type { SyncBackend } from '../backend/SyncBackend.js';
+import type { PushPullManager } from './PushPullManager.js';
+import type { Clock } from '../shared/Clock.js';
+export declare class AutoCommitter {
+    private debounceTimer;
+    private inFlight;
+    private backend;
+    private pushPullManager;
+    private clock;
+    private debounceMs;
+    constructor(backend: SyncBackend, pushPullManager: PushPullManager, clock: Clock, debounceMs?: number);
+    scheduleCommit(): void;
+    private executeCommit;
+    flush(): Promise<void>;
+    stop(): void;
+    isInFlight(): boolean;
+}

package/dist/sync/AutoCommitter.js

@@ -0,0 +1,68 @@
+export class AutoCommitter {
+    debounceTimer = null;
+    inFlight = false;
+    backend;
+    pushPullManager;
+    clock;
+    debounceMs;
+    constructor(backend, pushPullManager, clock, debounceMs = 2000) {
+        this.backend = backend;
+        this.pushPullManager = pushPullManager;
+        this.clock = clock;
+        this.debounceMs = debounceMs;
+    }
+    scheduleCommit() {
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => this.executeCommit(), this.debounceMs);
+    }
+    async executeCommit() {
+        if (this.inFlight)
+            return;
+        this.inFlight = true;
+        try {
+            const hasChanges = await this.backend.hasChanges();
+            if (!hasChanges)
+                return;
+            const now = this.clock.now().toISOString();
+            await this.backend.commit(`chore: sync ${now}`);
+            await this.pushPullManager.enqueuePush();
+        }
+        catch {
+            // Commit failed — will retry on next schedule
+        }
+        finally {
+            this.inFlight = false;
+        }
+    }
+    async flush() {
+        this.stop(); // Cancel any pending debounce
+        if (this.inFlight)
+            return; // Already executing
+        this.inFlight = true;
+        try {
+            const hasChanges = await this.backend.hasChanges();
+            if (!hasChanges)
+                return;
+            const now = this.clock.now().toISOString();
+            await this.backend.commit(`chore: sync ${now}`);
+            await this.pushPullManager.enqueuePush();
+        }
+        catch {
+            // Best-effort flush
+        }
+        finally {
+            this.inFlight = false;
+        }
+    }
+    stop() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+    }
+    isInFlight() {
+        return this.inFlight;
+    }
+}
+//# sourceMappingURL=AutoCommitter.js.map

package/dist/sync/AutoCommitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoCommitter.js","sourceRoot":"","sources":["../../src/sync/AutoCommitter.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,aAAa;IAChB,aAAa,GAAyC,IAAI,CAAC;IAC3D,QAAQ,GAAG,KAAK,CAAC;IACjB,OAAO,CAAc;IACrB,eAAe,CAAkB;IACjC,KAAK,CAAQ;IACb,UAAU,CAAS;IAE3B,YACE,OAAoB,EACpB,eAAgC,EAChC,KAAY,EACZ,UAAU,GAAG,IAAI;QAEjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,cAAc;QACZ,IAAI,IAAI,CAAC,aAAa;YAAE,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/E,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACnD,IAAI,CAAC,UAAU;gBAAE,OAAO;YAExB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;YAChD,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,8BAA8B;QAC3C,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,oBAAoB;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACnD,IAAI,CAAC,UAAU;gBAAE,OAAO;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;YAChD,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/dist/sync/ConflictResolver.d.ts

@@ -0,0 +1,7 @@
+import type { Entry } from '../core/EntrySchema.js';
+import type { Clock } from '../shared/Clock.js';
+/** Maximum number of conflict_log entries to retain per entry. */
+export declare const CONFLICT_LOG_MAX = 200;
+export declare class ConflictResolver {
+    merge(local: Entry[], remote: Entry[], clock: Clock): Entry[];
+}

package/dist/sync/ConflictResolver.js

@@ -0,0 +1,56 @@
+/** Maximum number of conflict_log entries to retain per entry. */
+export const CONFLICT_LOG_MAX = 200;
+function pickWinner(a, b) {
+    // 1st: LWW by updated timestamp
+    if (a.updated > b.updated)
+        return { winner: a, loser: b, resolution: 'lww' };
+    if (b.updated > a.updated)
+        return { winner: b, loser: a, resolution: 'lww' };
+    // 2nd: deleted:false wins (preservation principle)
+    if (!a.deleted && b.deleted)
+        return { winner: a, loser: b, resolution: 'tie_deleted' };
+    if (!b.deleted && a.deleted)
+        return { winner: b, loser: a, resolution: 'tie_deleted' };
+    // 3rd: id lexicographic (fully deterministic fallback)
+    return a.id < b.id
+        ? { winner: a, loser: b, resolution: 'tie_id' }
+        : { winner: b, loser: a, resolution: 'tie_id' };
+}
+export class ConflictResolver {
+    merge(local, remote, clock) {
+        const map = new Map();
+        // Load local entries
+        for (const entry of local) {
+            map.set(entry.id, { ...entry });
+        }
+        // Merge with remote
+        for (const remoteEntry of remote) {
+            const localEntry = map.get(remoteEntry.id);
+            if (!localEntry) {
+                // Append: new entry from remote
+                map.set(remoteEntry.id, { ...remoteEntry });
+                continue;
+            }
+            // Same entry exists on both sides — pick winner
+            const { winner, loser, resolution } = pickWinner(localEntry, remoteEntry);
+            // Add conflict log entry to the winner
+            const logEntry = {
+                at: clock.now().toISOString(),
+                loser_device: loser.device_id ?? 'unknown',
+                loser_updated: loser.updated,
+                resolution,
+            };
+            const fullLog = [...(winner.conflict_log ?? []), logEntry];
+            const merged = {
+                ...winner,
+                conflict_log: fullLog.length > CONFLICT_LOG_MAX
+                    ? fullLog.slice(fullLog.length - CONFLICT_LOG_MAX)
+                    : fullLog,
+            };
+            map.set(remoteEntry.id, merged);
+        }
+        // Sort by id for deterministic output
+        return Array.from(map.values()).sort((a, b) => a.id.localeCompare(b.id));
+    }
+}
+//# sourceMappingURL=ConflictResolver.js.map

package/dist/sync/ConflictResolver.js.map

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

package/dist/sync/PushPullManager.d.ts

@@ -0,0 +1,23 @@
+import type { SyncBackend } from '../backend/SyncBackend.js';
+import type { ConflictResolver } from './ConflictResolver.js';
+import type { ProfileManager } from '../core/ProfileManager.js';
+import type { SyncStatusStore } from '../status/SyncStatusStore.js';
+import type { Clock } from '../shared/Clock.js';
+export declare class PushPullManager {
+    private retryCount;
+    private pushTimer;
+    private backend;
+    private resolver;
+    private profileManager;
+    private statusStore;
+    private clock;
+    constructor(backend: SyncBackend, resolver: ConflictResolver, profileManager: ProfileManager, statusStore: SyncStatusStore, clock: Clock);
+    startSync(): Promise<void>;
+    syncPull(): Promise<void>;
+    private retryPull;
+    private pullWithRecovery;
+    enqueuePush(): Promise<void>;
+    private executePush;
+    stop(): void;
+    getRetryCount(): number;
+}

package/dist/sync/PushPullManager.js

@@ -0,0 +1,155 @@
+import { ProfileFormat } from '../core/ProfileFormat.js';
+const MAX_RETRY = 3;
+function backoffMs(attempt) {
+    return Math.min(1000 * Math.pow(2, attempt), 30000);
+}
+export class PushPullManager {
+    retryCount = 0;
+    pushTimer = null;
+    backend;
+    resolver;
+    profileManager;
+    statusStore;
+    clock;
+    constructor(backend, resolver, profileManager, statusStore, clock) {
+        this.backend = backend;
+        this.resolver = resolver;
+        this.profileManager = profileManager;
+        this.statusStore = statusStore;
+        this.clock = clock;
+    }
+    async startSync() {
+        await this.pullWithRecovery();
+    }
+    async syncPull() {
+        await this.pullWithRecovery();
+    }
+    async retryPull() {
+        for (let attempt = 0; attempt < MAX_RETRY; attempt++) {
+            try {
+                await this.backend.pull();
+                return true;
+            }
+            catch {
+                if (attempt < MAX_RETRY - 1) {
+                    await new Promise(r => setTimeout(r, backoffMs(attempt)));
+                }
+            }
+        }
+        return false;
+    }
+    async pullWithRecovery() {
+        const pulled = await this.retryPull();
+        if (pulled) {
+            await this.statusStore.set('synced');
+            return;
+        }
+        // All retries failed — attempt conflict recovery
+        try {
+            await this.backend.rebaseAbort();
+            await this.backend.fetch();
+            const headProfile = await ProfileFormat.readFromFile(this.profileManager.getProfilePath());
+            const localEntries = headProfile.entries;
+            // Read remote profile via git show
+            let remoteEntries = [];
+            try {
+                const profilePath = this.profileManager.getProfilePath();
+                const repoPath = this.backend.getRepoPath();
+                const relativePath = profilePath.startsWith(repoPath)
+                    ? profilePath.slice(repoPath.length + 1)
+                    : profilePath;
+                const remoteBranchRef = `origin/${this.backend.getBranch()}`;
+                // Try .enc.json first (v2 format), then fall back to .yaml (legacy)
+                const encJsonRelPath = relativePath.replace(/\.yaml$/, '.enc.json');
+                let remoteContent = null;
+                let isEncJson = false;
+                try {
+                    remoteContent = await this.backend.readFileAtRef(remoteBranchRef, encJsonRelPath);
+                    isEncJson = true;
+                }
+                catch {
+                    try {
+                        remoteContent = await this.backend.readFileAtRef(remoteBranchRef, relativePath);
+                    }
+                    catch {
+                        // Neither exists — treat as empty
+                    }
+                }
+                if (remoteContent) {
+                    if (isEncJson) {
+                        // Parse enc.json: extract entries from plaintext-fallback or decrypt age-block
+                        const encProfile = JSON.parse(remoteContent);
+                        if (encProfile._aigentry?.format === 'plaintext-fallback') {
+                            for (const json of Object.values(encProfile.entries)) {
+                                try {
+                                    remoteEntries.push(JSON.parse(json));
+                                }
+                                catch { /* skip */ }
+                            }
+                        }
+                        else {
+                            // age-block entries — cannot decrypt in conflict recovery context
+                            // Fall back to deserializing as best-effort
+                            const remoteProfile = ProfileFormat.deserialize(remoteContent);
+                            remoteEntries = remoteProfile.entries;
+                        }
+                    }
+                    else {
+                        const remoteProfile = ProfileFormat.deserialize(remoteContent);
+                        remoteEntries = remoteProfile.entries;
+                    }
+                }
+            }
+            catch {
+                // Remote file doesn't exist yet — treat as empty
+            }
+            const merged = this.resolver.merge(localEntries, remoteEntries, this.clock);
+            // Reset local branch to remote tip so the merge commit is fast-forward
+            const remoteBranch = `origin/${this.backend.getBranch()}`;
+            await this.backend.resetToRef(remoteBranch);
+            await this.profileManager.save(merged);
+            await this.backend.commit('chore: merge conflict recovery');
+            await this.enqueuePush();
+        }
+        catch (recoveryErr) {
+            await this.statusStore.set('degraded', {
+                error: `Recovery failed: ${String(recoveryErr)}`,
+            });
+        }
+    }
+    async enqueuePush() {
+        await this.statusStore.set('pending', { pending_count: this.retryCount + 1 });
+        await this.executePush();
+    }
+    async executePush() {
+        try {
+            await this.backend.push();
+            this.retryCount = 0;
+            await this.statusStore.set('synced');
+        }
+        catch {
+            this.retryCount++;
+            if (this.retryCount >= MAX_RETRY) {
+                await this.statusStore.set('degraded', {
+                    error: `Push failed after ${MAX_RETRY} retries`,
+                    pending_count: this.retryCount,
+                });
+            }
+            else {
+                const delay = backoffMs(this.retryCount);
+                this.pushTimer = setTimeout(() => this.executePush(), delay);
+                await this.statusStore.set('pending', { pending_count: this.retryCount });
+            }
+        }
+    }
+    stop() {
+        if (this.pushTimer) {
+            clearTimeout(this.pushTimer);
+            this.pushTimer = null;
+        }
+    }
+    getRetryCount() {
+        return this.retryCount;
+    }
+}
+//# sourceMappingURL=PushPullManager.js.map