@syntero/orca-cli 1.0.0 → 1.1.1

package/dist/sync/hash.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Hash utilities for library sync.
+ * Provides functions for SHA-256 hashing of files and content.
+ */
+/**
+ * Compute SHA-256 hash of file content.
+ * Uses streaming for memory efficiency with large files.
+ *
+ * @param filePath Path to file on host filesystem
+ * @returns SHA-256 hash prefixed with 'sha256:'
+ */
+export declare function hashFile(filePath: string): Promise<string>;
+/**
+ * Compute SHA-256 hash of Buffer content.
+ *
+ * @param content Buffer to hash
+ * @returns SHA-256 hash prefixed with 'sha256:'
+ */
+export declare function hashBuffer(content: Buffer): string;
+/**
+ * Compute SHA-256 hash of string content.
+ *
+ * @param content String to hash
+ * @returns SHA-256 hash prefixed with 'sha256:'
+ */
+export declare function hashString(content: string): string;
+/**
+ * Compute combined solution hash from file hashes.
+ * Deterministic: sorted by path, concatenated, then hashed.
+ *
+ * @param files Array of objects with path and hash properties
+ * @returns Combined SHA-256 hash prefixed with 'sha256:'
+ */
+export declare function computeSolutionHash(files: {
+    path: string;
+    hash: string;
+}[]): string;
+/**
+ * Verify that content matches expected hash.
+ *
+ * @param content Buffer to verify
+ * @param expectedHash Expected hash (prefixed with 'sha256:')
+ * @returns True if hash matches
+ */
+export declare function verifyHash(content: Buffer, expectedHash: string): boolean;
+/**
+ * Strip the hash prefix (sha256:) from a hash string.
+ *
+ * @param hash Hash string with or without prefix
+ * @returns Hash string without prefix
+ */
+export declare function stripHashPrefix(hash: string): string;
+/**
+ * Add the hash prefix (sha256:) to a hash string if not present.
+ *
+ * @param hash Hash string with or without prefix
+ * @returns Hash string with prefix
+ */
+export declare function ensureHashPrefix(hash: string): string;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/sync/hash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAShE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAInF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAGzE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD"}

package/dist/sync/hash.js

@@ -0,0 +1,92 @@
+/**
+ * Hash utilities for library sync.
+ * Provides functions for SHA-256 hashing of files and content.
+ */
+import * as crypto from 'crypto';
+import * as fs from 'fs';
+/**
+ * Compute SHA-256 hash of file content.
+ * Uses streaming for memory efficiency with large files.
+ *
+ * @param filePath Path to file on host filesystem
+ * @returns SHA-256 hash prefixed with 'sha256:'
+ */
+export async function hashFile(filePath) {
+    return new Promise((resolve, reject) => {
+        const hash = crypto.createHash('sha256');
+        const stream = fs.createReadStream(filePath);
+        stream.on('data', (chunk) => hash.update(chunk));
+        stream.on('end', () => resolve(`sha256:${hash.digest('hex')}`));
+        stream.on('error', reject);
+    });
+}
+/**
+ * Compute SHA-256 hash of Buffer content.
+ *
+ * @param content Buffer to hash
+ * @returns SHA-256 hash prefixed with 'sha256:'
+ */
+export function hashBuffer(content) {
+    const hash = crypto.createHash('sha256');
+    hash.update(content);
+    return `sha256:${hash.digest('hex')}`;
+}
+/**
+ * Compute SHA-256 hash of string content.
+ *
+ * @param content String to hash
+ * @returns SHA-256 hash prefixed with 'sha256:'
+ */
+export function hashString(content) {
+    const hash = crypto.createHash('sha256');
+    hash.update(content, 'utf8');
+    return `sha256:${hash.digest('hex')}`;
+}
+/**
+ * Compute combined solution hash from file hashes.
+ * Deterministic: sorted by path, concatenated, then hashed.
+ *
+ * @param files Array of objects with path and hash properties
+ * @returns Combined SHA-256 hash prefixed with 'sha256:'
+ */
+export function computeSolutionHash(files) {
+    const sorted = [...files].sort((a, b) => a.path.localeCompare(b.path));
+    const combined = sorted.map(f => `${f.path}:${f.hash}`).join('\n');
+    return hashString(combined);
+}
+/**
+ * Verify that content matches expected hash.
+ *
+ * @param content Buffer to verify
+ * @param expectedHash Expected hash (prefixed with 'sha256:')
+ * @returns True if hash matches
+ */
+export function verifyHash(content, expectedHash) {
+    const actualHash = hashBuffer(content);
+    return actualHash === expectedHash;
+}
+/**
+ * Strip the hash prefix (sha256:) from a hash string.
+ *
+ * @param hash Hash string with or without prefix
+ * @returns Hash string without prefix
+ */
+export function stripHashPrefix(hash) {
+    if (hash.startsWith('sha256:')) {
+        return hash.slice(7);
+    }
+    return hash;
+}
+/**
+ * Add the hash prefix (sha256:) to a hash string if not present.
+ *
+ * @param hash Hash string with or without prefix
+ * @returns Hash string with prefix
+ */
+export function ensureHashPrefix(hash) {
+    if (hash.startsWith('sha256:')) {
+        return hash;
+    }
+    return `sha256:${hash}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/sync/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/sync/hash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE7C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAuC;IACzE,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,YAAoB;IAC9D,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,UAAU,KAAK,YAAY,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,UAAU,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/sync/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Sync module - Library sync from cloud to local CLI
+ *
+ * This module provides functionality to sync the organization's solution
+ * library from the cloud backend to the local Docker container.
+ */
+export type { FileEntry, SolutionEntry, ServiceEntry, ServicesRegistry, RemoteLibraryManifest, LocalSyncManifest, LocalSolutionEntry, SyncState, SyncStatus, SyncOptions, SyncResult, SyncPlan, PreflightResult, LocalModification } from '../types/sync.js';
+export { SyncEngine, runSync, resumeSync, showSyncStatus } from './sync-engine.js';
+export { isDockerAvailable, findSandboxContainer, isSandboxRunning, runPreflightChecks, writeFileToSandbox, readFileFromSandbox, deleteFromSandbox, extractArchiveToSandbox, getLibraryPath, getServicesRegistryPath } from './docker.js';
+export { hashFile, hashBuffer, hashString, computeSolutionHash, verifyHash } from './hash.js';
+export { mergeServicesRegistry, getServicesToRemove, getServicesToAdd, getServicesToUpdate, getServicesMergeSummary } from './services.js';
+export { loadLocalManifest, saveLocalManifest, loadSyncState, saveSyncState, updateSyncState, isFirstSync, hasResumableSync, getSyncStatusSummary } from './manifest.js';
+export { downloadWithRetry, splitIntoBatches } from './download.js';
+export { displayProgress, displayPhase, displayHeader, displaySuccess, displayWarning, displayError, displaySyncPlan, displaySyncComplete, displaySyncStatus, formatBytes, formatDuration } from './progress.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,eAAe,EACf,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGnF,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACd,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,UAAU,EACX,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,cAAc,EACf,MAAM,eAAe,CAAC"}

package/dist/sync/index.js

@@ -0,0 +1,21 @@
+/**
+ * Sync module - Library sync from cloud to local CLI
+ *
+ * This module provides functionality to sync the organization's solution
+ * library from the cloud backend to the local Docker container.
+ */
+// Sync engine
+export { SyncEngine, runSync, resumeSync, showSyncStatus } from './sync-engine.js';
+// Docker utilities
+export { isDockerAvailable, findSandboxContainer, isSandboxRunning, runPreflightChecks, writeFileToSandbox, readFileFromSandbox, deleteFromSandbox, extractArchiveToSandbox, getLibraryPath, getServicesRegistryPath } from './docker.js';
+// Hash utilities
+export { hashFile, hashBuffer, hashString, computeSolutionHash, verifyHash } from './hash.js';
+// Services registry
+export { mergeServicesRegistry, getServicesToRemove, getServicesToAdd, getServicesToUpdate, getServicesMergeSummary } from './services.js';
+// Manifest management
+export { loadLocalManifest, saveLocalManifest, loadSyncState, saveSyncState, updateSyncState, isFirstSync, hasResumableSync, getSyncStatusSummary } from './manifest.js';
+// Download utilities
+export { downloadWithRetry, splitIntoBatches } from './download.js';
+// Progress display
+export { displayProgress, displayPhase, displayHeader, displaySuccess, displayWarning, displayError, displaySyncPlan, displaySyncComplete, displaySyncStatus, formatBytes, formatDuration } from './progress.js';
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnF,mBAAmB;AACnB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACd,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,UAAU,EACX,MAAM,WAAW,CAAC;AAEnB,oBAAoB;AACpB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AAEvB,sBAAsB;AACtB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB,qBAAqB;AACrB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAEvB,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,cAAc,EACf,MAAM,eAAe,CAAC"}

package/dist/sync/manifest.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Manifest management for library sync.
+ *
+ * Handles loading and saving local sync manifest and state.
+ */
+import { LocalSyncManifest, SyncState, SyncStatus, LocalSolutionEntry, PendingQueue, LastError, SyncStats } from '../types/sync.js';
+/**
+ * Ensure the sync directory exists.
+ */
+export declare function ensureSyncDir(): void;
+/**
+ * Get the path to the sync directory.
+ */
+export declare function getSyncDir(): string;
+/**
+ * Get the path to the local manifest file.
+ */
+export declare function getManifestPath(): string;
+/**
+ * Get the path to the sync state file.
+ */
+export declare function getStatePath(): string;
+/**
+ * Check if this is the first sync (no local manifest exists).
+ */
+export declare function isFirstSync(): boolean;
+/**
+ * Load the local sync manifest.
+ *
+ * @returns Local manifest or null if not found
+ */
+export declare function loadLocalManifest(): LocalSyncManifest | null;
+/**
+ * Save the local sync manifest.
+ *
+ * @param manifest Manifest to save
+ */
+export declare function saveLocalManifest(manifest: LocalSyncManifest): void;
+/**
+ * Load the sync state.
+ *
+ * @returns Sync state or default idle state if not found
+ */
+export declare function loadSyncState(): SyncState;
+/**
+ * Save the sync state.
+ *
+ * @param state State to save
+ */
+export declare function saveSyncState(state: SyncState): void;
+/**
+ * Update specific fields in the sync state.
+ *
+ * @param updates Partial state updates to apply
+ */
+export declare function updateSyncState(updates: Partial<SyncState>): void;
+/**
+ * Set sync state to in-progress with start time.
+ */
+export declare function startSync(): void;
+/**
+ * Set sync state to completed with statistics.
+ *
+ * @param stats Sync statistics
+ */
+export declare function completeSync(stats: SyncStats): void;
+/**
+ * Set sync state to interrupted with pending queue.
+ *
+ * @param pendingQueue Remaining work to be done
+ */
+export declare function interruptSync(pendingQueue: PendingQueue): void;
+/**
+ * Set sync state to error with error details.
+ *
+ * @param error Error information
+ */
+export declare function failSync(error: LastError): void;
+/**
+ * Update current operation being performed.
+ *
+ * @param operation Current operation details
+ */
+export declare function updateCurrentOperation(operation: {
+    type: 'manifest' | 'solution' | 'file';
+    solution_id?: string;
+    file_path?: string;
+    progress: number;
+}): void;
+/**
+ * Check if there's an interrupted sync that can be resumed.
+ */
+export declare function hasResumableSync(): boolean;
+/**
+ * Get the pending queue for resuming an interrupted sync.
+ */
+export declare function getPendingQueue(): PendingQueue | undefined;
+/**
+ * Clear the sync state (reset to idle).
+ */
+export declare function clearSyncState(): void;
+/**
+ * Build local solution entries from a completed sync.
+ *
+ * @param solutions Remote solution entries that were synced
+ * @returns Local solution entries with sync metadata
+ */
+export declare function buildLocalSolutionEntries(solutions: Array<{
+    library_id: string;
+    solution_hash: string;
+    files: Array<{
+        path: string;
+        hash: string;
+        size: number;
+    }>;
+}>): LocalSolutionEntry[];
+/**
+ * Get sync status summary for display.
+ */
+export declare function getSyncStatusSummary(): {
+    status: SyncStatus;
+    lastSyncTime?: string;
+    lastSyncRelative?: string;
+    solutionCount: number;
+    fileCount: number;
+    totalSize: number;
+    orgId?: string;
+    endpoint?: string;
+    lastError?: LastError;
+    pendingFiles?: number;
+};
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/sync/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,kBAAkB,EAElB,YAAY,EACZ,SAAS,EACT,SAAS,EACV,MAAM,kBAAkB,CAAC;AAQ1B;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAIpC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,GAAG,IAAI,CAW5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,SAAS,CAWzC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAIjE;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAQhC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAQnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAK9D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE;IAChD,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAIP;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,SAAS,CAM1D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,KAAK,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D,CAAC,GACD,kBAAkB,EAAE,CActB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAkDA"}

package/dist/sync/manifest.js

@@ -0,0 +1,260 @@
+/**
+ * Manifest management for library sync.
+ *
+ * Handles loading and saving local sync manifest and state.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+// Sync data directory
+const ORCA_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '', '.orca');
+const SYNC_DIR = path.join(ORCA_DIR, 'sync');
+const MANIFEST_PATH = path.join(SYNC_DIR, 'manifest.json');
+const STATE_PATH = path.join(SYNC_DIR, 'state.json');
+/**
+ * Ensure the sync directory exists.
+ */
+export function ensureSyncDir() {
+    if (!fs.existsSync(SYNC_DIR)) {
+        fs.mkdirSync(SYNC_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * Get the path to the sync directory.
+ */
+export function getSyncDir() {
+    return SYNC_DIR;
+}
+/**
+ * Get the path to the local manifest file.
+ */
+export function getManifestPath() {
+    return MANIFEST_PATH;
+}
+/**
+ * Get the path to the sync state file.
+ */
+export function getStatePath() {
+    return STATE_PATH;
+}
+/**
+ * Check if this is the first sync (no local manifest exists).
+ */
+export function isFirstSync() {
+    return !fs.existsSync(MANIFEST_PATH);
+}
+/**
+ * Load the local sync manifest.
+ *
+ * @returns Local manifest or null if not found
+ */
+export function loadLocalManifest() {
+    if (!fs.existsSync(MANIFEST_PATH)) {
+        return null;
+    }
+    try {
+        const data = fs.readFileSync(MANIFEST_PATH, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save the local sync manifest.
+ *
+ * @param manifest Manifest to save
+ */
+export function saveLocalManifest(manifest) {
+    ensureSyncDir();
+    fs.writeFileSync(MANIFEST_PATH, JSON.stringify(manifest, null, 2), { mode: 0o600 });
+}
+/**
+ * Load the sync state.
+ *
+ * @returns Sync state or default idle state if not found
+ */
+export function loadSyncState() {
+    if (!fs.existsSync(STATE_PATH)) {
+        return { status: 'idle' };
+    }
+    try {
+        const data = fs.readFileSync(STATE_PATH, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return { status: 'idle' };
+    }
+}
+/**
+ * Save the sync state.
+ *
+ * @param state State to save
+ */
+export function saveSyncState(state) {
+    ensureSyncDir();
+    fs.writeFileSync(STATE_PATH, JSON.stringify(state, null, 2), { mode: 0o600 });
+}
+/**
+ * Update specific fields in the sync state.
+ *
+ * @param updates Partial state updates to apply
+ */
+export function updateSyncState(updates) {
+    const current = loadSyncState();
+    const updated = { ...current, ...updates };
+    saveSyncState(updated);
+}
+/**
+ * Set sync state to in-progress with start time.
+ */
+export function startSync() {
+    updateSyncState({
+        status: 'in_progress',
+        started_at: new Date().toISOString(),
+        completed_at: undefined,
+        last_error: undefined,
+        pending_queue: undefined
+    });
+}
+/**
+ * Set sync state to completed with statistics.
+ *
+ * @param stats Sync statistics
+ */
+export function completeSync(stats) {
+    updateSyncState({
+        status: 'idle',
+        completed_at: new Date().toISOString(),
+        stats,
+        current_operation: undefined,
+        pending_queue: undefined
+    });
+}
+/**
+ * Set sync state to interrupted with pending queue.
+ *
+ * @param pendingQueue Remaining work to be done
+ */
+export function interruptSync(pendingQueue) {
+    updateSyncState({
+        status: 'interrupted',
+        pending_queue: pendingQueue
+    });
+}
+/**
+ * Set sync state to error with error details.
+ *
+ * @param error Error information
+ */
+export function failSync(error) {
+    updateSyncState({
+        status: 'error',
+        last_error: error
+    });
+}
+/**
+ * Update current operation being performed.
+ *
+ * @param operation Current operation details
+ */
+export function updateCurrentOperation(operation) {
+    const current = loadSyncState();
+    current.current_operation = operation;
+    saveSyncState(current);
+}
+/**
+ * Check if there's an interrupted sync that can be resumed.
+ */
+export function hasResumableSync() {
+    const state = loadSyncState();
+    return state.status === 'interrupted' && !!state.pending_queue;
+}
+/**
+ * Get the pending queue for resuming an interrupted sync.
+ */
+export function getPendingQueue() {
+    const state = loadSyncState();
+    if (state.status === 'interrupted') {
+        return state.pending_queue;
+    }
+    return undefined;
+}
+/**
+ * Clear the sync state (reset to idle).
+ */
+export function clearSyncState() {
+    saveSyncState({ status: 'idle' });
+}
+/**
+ * Build local solution entries from a completed sync.
+ *
+ * @param solutions Remote solution entries that were synced
+ * @returns Local solution entries with sync metadata
+ */
+export function buildLocalSolutionEntries(solutions) {
+    const now = new Date().toISOString();
+    return solutions.map(s => ({
+        library_id: s.library_id,
+        solution_hash: s.solution_hash,
+        synced_at: now,
+        files: s.files.map(f => ({
+            path: f.path,
+            hash: f.hash,
+            size: f.size
+        })),
+        status: 'complete'
+    }));
+}
+/**
+ * Get sync status summary for display.
+ */
+export function getSyncStatusSummary() {
+    const state = loadSyncState();
+    const manifest = loadLocalManifest();
+    let solutionCount = 0;
+    let fileCount = 0;
+    let totalSize = 0;
+    if (manifest) {
+        solutionCount = manifest.solutions.length;
+        for (const solution of manifest.solutions) {
+            fileCount += solution.files.length;
+            for (const file of solution.files) {
+                totalSize += file.size;
+            }
+        }
+    }
+    // Calculate relative time for last sync
+    let lastSyncRelative;
+    const lastSyncTime = state.completed_at || manifest?.updated_at;
+    if (lastSyncTime) {
+        const diff = Date.now() - new Date(lastSyncTime).getTime();
+        const minutes = Math.floor(diff / 60000);
+        const hours = Math.floor(minutes / 60);
+        const days = Math.floor(hours / 24);
+        if (days > 0) {
+            lastSyncRelative = `${days} day${days > 1 ? 's' : ''} ago`;
+        }
+        else if (hours > 0) {
+            lastSyncRelative = `${hours} hour${hours > 1 ? 's' : ''} ago`;
+        }
+        else if (minutes > 0) {
+            lastSyncRelative = `${minutes} minute${minutes > 1 ? 's' : ''} ago`;
+        }
+        else {
+            lastSyncRelative = 'just now';
+        }
+    }
+    return {
+        status: state.status,
+        lastSyncTime,
+        lastSyncRelative,
+        solutionCount,
+        fileCount,
+        totalSize,
+        orgId: manifest?.org_id,
+        endpoint: manifest?.endpoint,
+        lastError: state.last_error,
+        pendingFiles: state.pending_queue?.files_to_download?.length
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/sync/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/sync/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAY7B,sBAAsB;AACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;AACvF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAA2B;IAC3D,aAAa,EAAE,CAAC;IAChB,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACtF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,aAAa,EAAE,CAAC;IAChB,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAA2B;IACzD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,OAAO,GAAc,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IACtD,aAAa,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,eAAe,CAAC;QACd,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,YAAY,EAAE,SAAS;QACvB,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,SAAS;KACzB,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,eAAe,CAAC;QACd,MAAM,EAAE,MAAM;QACd,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,KAAK;QACL,iBAAiB,EAAE,SAAS;QAC5B,aAAa,EAAE,SAAS;KACzB,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,YAA0B;IACtD,eAAe,CAAC;QACd,MAAM,EAAE,aAAa;QACrB,aAAa,EAAE,YAAY;KAC5B,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAgB;IACvC,eAAe,CAAC;QACd,MAAM,EAAE,OAAO;QACf,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAKtC;IACC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IACtC,aAAa,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,OAAO,KAAK,CAAC,MAAM,KAAK,aAAa,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,aAAa,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAIE;IAEF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,SAAS,EAAE,GAAG;QACd,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC;QACH,MAAM,EAAE,UAAmB;KAC5B,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAYlC,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IAErC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,IAAI,QAAQ,EAAE,CAAC;QACb,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC;QAC1C,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC1C,SAAS,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;YACnC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAClC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,gBAAoC,CAAC;IACzC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,QAAQ,EAAE,UAAU,CAAC;IAChE,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAEpC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,gBAAgB,GAAG,GAAG,IAAI,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAC7D,CAAC;aAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACrB,gBAAgB,GAAG,GAAG,KAAK,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAChE,CAAC;aAAM,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACvB,gBAAgB,GAAG,GAAG,OAAO,UAAU,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,gBAAgB,GAAG,UAAU,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY;QACZ,gBAAgB;QAChB,aAAa;QACb,SAAS;QACT,SAAS;QACT,KAAK,EAAE,QAAQ,EAAE,MAAM;QACvB,QAAQ,EAAE,QAAQ,EAAE,QAAQ;QAC5B,SAAS,EAAE,KAAK,CAAC,UAAU;QAC3B,YAAY,EAAE,KAAK,CAAC,aAAa,EAAE,iBAAiB,EAAE,MAAM;KAC7D,CAAC;AACJ,CAAC"}