@syntero/orca-cli 1.0.0 → 1.1.1

package/dist/types/sync.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Sync Types - TypeScript interfaces for library sync
+ */
+/**
+ * Information about a single file in the library.
+ */
+export interface FileEntry {
+    /** Relative path from solution root (e.g., "server.py", "modules/utils.py") */
+    path: string;
+    /** SHA-256 hash of file content */
+    hash: string;
+    /** File size in bytes */
+    size: number;
+    /** Last modified timestamp (ISO 8601) */
+    modified: string;
+    /** File type: 'file' | 'symlink' */
+    type: 'file' | 'symlink';
+    /** For symlinks: target path */
+    target?: string;
+}
+/**
+ * Service registration info for a solution.
+ */
+export interface ServiceInfo {
+    name: string;
+    functions: string[];
+}
+/**
+ * Information about a single solution in the library.
+ */
+export interface SolutionEntry {
+    /** Library ID (directory name) */
+    library_id: string;
+    /** Solution name from manifest */
+    name: string;
+    /** Solution description */
+    description?: string;
+    /** Category for organization */
+    category?: string;
+    /** Tags for searchability */
+    tags?: string[];
+    /** Author user ID */
+    author_id: string;
+    /** Author display name */
+    author_name: string;
+    /** When published/updated (ISO 8601) */
+    published_at: string;
+    /** All files in this solution */
+    files: FileEntry[];
+    /** Total size of all files */
+    total_size: number;
+    /** Number of files */
+    file_count: number;
+    /** Combined hash of all file hashes (for quick change detection) */
+    solution_hash: string;
+    /** Service registration info if exposed */
+    service?: ServiceInfo;
+    /** Dependencies (library_id references) */
+    dependencies?: {
+        library_id: string;
+    }[];
+}
+/**
+ * Service entry in the services registry.
+ */
+export interface ServiceEntry {
+    library_id: string;
+    description: string;
+    functions: string[];
+    author_id: string;
+    registered_at: string;
+}
+/**
+ * Services registry type.
+ */
+export type ServicesRegistry = Record<string, ServiceEntry>;
+/**
+ * Library statistics.
+ */
+export interface LibraryStats {
+    total_solutions: number;
+    total_files: number;
+    total_size: number;
+}
+/**
+ * Complete library manifest from backend.
+ */
+export interface RemoteLibraryManifest {
+    /** Manifest format version (for future compatibility) */
+    version: 1;
+    /** Timestamp when manifest was generated (ISO 8601) */
+    generated_at: string;
+    /** Organization ID */
+    org_id: string;
+    /** Backend endpoint that generated this */
+    endpoint: string;
+    /** All solutions in the library */
+    solutions: SolutionEntry[];
+    /** Services registry content */
+    services_registry: ServicesRegistry;
+    /** Total library statistics */
+    stats: LibraryStats;
+    /** Internal: ETag for caching (added by CLI) */
+    _etag?: string;
+}
+/**
+ * Local solution entry with sync status.
+ */
+export interface LocalSolutionEntry {
+    /** Library ID */
+    library_id: string;
+    /** Solution hash at time of sync */
+    solution_hash: string;
+    /** When this solution was last synced */
+    synced_at: string;
+    /** Files with their synced hashes */
+    files: {
+        path: string;
+        hash: string;
+        size: number;
+    }[];
+    /** Sync status for this solution */
+    status: 'complete' | 'partial' | 'pending';
+    /** If partial, which files still need sync */
+    pending_files?: string[];
+}
+/**
+ * Local sync manifest tracking what's been synced.
+ */
+export interface LocalSyncManifest {
+    /** Manifest format version */
+    version: 1;
+    /** When this manifest was last updated */
+    updated_at: string;
+    /** Organization ID this is synced from */
+    org_id: string;
+    /** Backend endpoint this was synced from */
+    endpoint: string;
+    /** ETag from last manifest fetch (for caching) */
+    remote_etag?: string;
+    /** Solutions that have been synced */
+    solutions: LocalSolutionEntry[];
+    /** Services registry (copy of remote) */
+    services_registry: ServicesRegistry;
+}
+/**
+ * Sync state status.
+ */
+export type SyncStatus = 'idle' | 'in_progress' | 'interrupted' | 'error';
+/**
+ * Current operation being performed.
+ */
+export interface CurrentOperation {
+    type: 'manifest' | 'solution' | 'file';
+    solution_id?: string;
+    file_path?: string;
+    progress: number;
+}
+/**
+ * Pending queue for resumable syncs.
+ */
+export interface PendingQueue {
+    solutions_to_sync: string[];
+    files_to_download: {
+        solution: string;
+        path: string;
+        hash: string;
+    }[];
+    solutions_to_delete: string[];
+}
+/**
+ * Last error information.
+ */
+export interface LastError {
+    message: string;
+    timestamp: string;
+    solution_id?: string;
+    file_path?: string;
+}
+/**
+ * Sync statistics.
+ */
+export interface SyncStats {
+    files_downloaded: number;
+    files_skipped: number;
+    files_deleted: number;
+    bytes_downloaded: number;
+    duration_ms: number;
+}
+/**
+ * Tracks in-progress sync operations.
+ */
+export interface SyncState {
+    /** Current sync status */
+    status: SyncStatus;
+    /** When current/last sync started */
+    started_at?: string;
+    /** When last sync completed */
+    completed_at?: string;
+    /** If in_progress, what's being synced */
+    current_operation?: CurrentOperation;
+    /** For resumable syncs, queue of remaining work */
+    pending_queue?: PendingQueue;
+    /** Last error if any */
+    last_error?: LastError;
+    /** Statistics from last/current sync */
+    stats?: SyncStats;
+}
+/**
+ * Sync command options.
+ */
+export interface SyncOptions {
+    /** Show what would change without syncing */
+    dryRun?: boolean;
+    /** Overwrite local changes without warning */
+    force?: boolean;
+    /** Show detailed file-by-file progress */
+    verbose?: boolean;
+    /** Create .backup files before overwriting */
+    backup?: boolean;
+    /** Keep locally modified files */
+    skipModified?: boolean;
+    /** Sync only specific solutions */
+    solutionFilter?: string[];
+}
+/**
+ * Sync result returned by SyncEngine.
+ */
+export interface SyncResult {
+    success: boolean;
+    stats: {
+        newSolutions: number;
+        updatedSolutions: number;
+        deletedSolutions: number;
+        filesDownloaded: number;
+        filesDeleted: number;
+        bytesDownloaded: number;
+        durationMs: number;
+    };
+    errors: {
+        solution: string;
+        file?: string;
+        error: string;
+    }[];
+}
+/**
+ * Sync plan calculated by comparing manifests.
+ */
+export interface SyncPlan {
+    newSolutions: string[];
+    modifiedSolutions: string[];
+    deletedSolutions: string[];
+    filesToDownload: {
+        solution: string;
+        path: string;
+        hash: string;
+        size: number;
+    }[];
+    filesToDelete: {
+        solution: string;
+        path: string;
+    }[];
+}
+/**
+ * Pre-flight check result.
+ */
+export interface PreflightResult {
+    success: boolean;
+    errors: string[];
+    warnings: string[];
+    containerName?: string;
+    existingLibraryContent?: number;
+}
+/**
+ * Local modification detected during sync.
+ */
+export interface LocalModification {
+    solution: string;
+    path: string;
+    type: 'modified' | 'deleted';
+    localHash?: string;
+    syncedHash?: string;
+}
+//# sourceMappingURL=sync.d.ts.map

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

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

package/dist/types/sync.js

@@ -0,0 +1,5 @@
+/**
+ * Sync Types - TypeScript interfaces for library sync
+ */
+export {};
+//# sourceMappingURL=sync.js.map

package/dist/types/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/types/sync.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syntero/orca-cli",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "LLM-powered deployment troubleshooting assistant for Orca",
   "type": "module",
   "bin": {
@@ -13,7 +13,8 @@
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
-    "dev": "tsc && node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "watch": "tsc --watch",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -33,15 +34,22 @@
   "homepage": "https://github.com/syntero/orca#readme",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
+    "@types/tar": "^6.1.13",
     "better-sqlite3": "^12.6.2",
     "chalk": "^5.6.2",
+    "ink": "^5.2.1",
+    "ink-text-input": "^6.0.0",
     "openai": "^6.16.0",
+    "react": "^18.3.1",
+    "tar": "^7.5.6",
     "update-notifier": "^7.3.1"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^22.10.5",
+    "@types/react": "^18.3.27",
     "@types/update-notifier": "^6.0.8",
+    "tsx": "^4.21.0",
     "typescript": "^5.7.2"
   },
   "engines": {