@qaecy/cue-cli 0.0.37 → 0.0.39

package/main.js

@@ -7820,6 +7820,27 @@ var CueSyncApi = class {
   async initBrowserSync(spaceId) {
     await this._initPendingBatch(spaceId);
   }
+  /**
+   * Pushes filesystem-structure metadata for all provided files directly to the
+   * commands API, without checking what is already on the remote or accounting for
+   * credits.  Use this when you want to force-write metadata for every file in a
+   * local path (e.g. to repair missing graph data after a migration).
+   */
+  async pushAllMetadata(localFiles, options) {
+    this._legacy = options.legacy ?? false;
+    const items = localFiles.map((f) => ({
+      relativePath: f.relativePath,
+      md5: f.md5,
+      size: f.size,
+      providerId: options.providerId,
+      fileContentExists: false
+    }));
+    for (let i = 0; i < items.length; i += FSS_BATCH_CHUNK_SIZE) {
+      await this._postFssBatch(items.slice(i, i + FSS_BATCH_CHUNK_SIZE), options.spaceId);
+    }
+    if (options.verbose)
+      console.info(`Pushed metadata for ${items.length} file(s) \u2705`);
+  }
   /**
    * Flushes any pending file-location metadata from a previously interrupted sync.
    * Safe to call even when there are no new files to upload (e.g. when the process
@@ -8094,9 +8115,13 @@ WHERE {
       }
     }
     const timer = setInterval(() => {
-      this._drainPending(verbose).catch(
-        (err) => console.error("[CueSyncApi] Periodic flush failed:", err)
-      );
+      this._drainPending(verbose).catch((err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(
+          `\u26A0\uFE0F  Metadata flush failed (will retry on next tick): ${msg}
+   Pending items are saved locally and will be re-sent automatically.`
+        );
+      });
     }, 6e4);
     if (typeof timer === "object" && typeof timer.unref === "function") {
       timer.unref();
@@ -9150,7 +9175,7 @@ function askConfirm(question) {
   });
 }
 async function syncHandler(options) {
-  const { space, path, verbose, provider, emulators, zip, legacy } = options;
+  const { space, path, verbose, provider, emulators, zip, legacy, metadataOnly } = options;
   try {
     const cue = new CueNode({
       apiKey: FIREBASE_CONFIG().apiKey,
@@ -9215,6 +9240,17 @@ async function syncHandler(options) {
     }
     if (verbose)
       console.info("Authenticated \u2705\n");
+    if (metadataOnly) {
+      console.info(`Pushing metadata for ${localFiles.length} file(s) \u23F3`);
+      await cue.api.sync.pushAllMetadata(localFiles, {
+        spaceId: space,
+        providerId: provider,
+        verbose,
+        legacy
+      });
+      console.info(`Pushed metadata for ${localFiles.length} file(s) \u2705`);
+      process.exit(0);
+    }
     if (verbose)
       console.info("Checking sync preview \u23F3");
     const preview = await cue.api.sync.previewSync(localFiles, {
@@ -9493,7 +9529,7 @@ try {
 }
 var program = new import_commander.Command();
 program.name("cue-cli").description("Cue Command Line Interface").version(packageJson.version);
-program.command("sync").description("Sync files to Cue").requiredOption("-s, --space <id>", "Specify the space ID (required)").requiredOption("-p, --path <id>", "Specify the folder path (required)").option("-k, --key <api-key>", "Specify the API key (or set CUE_API_KEY env variable)").option("--provider <provider ID>", "Specify the provider ID (eg. sharepoint, drive, dropbox) or leave empty for default provider", "").option("-v, --verbose", "Enable verbose output", false).option("-e, --emulators", "Uses emulators for sync", false).option("-z, --zip", 'Include zipped content (will be unzipped to path "<zip_path>_unzipped". Max uncompressed size: 500 MB, max recursion depth: 3)', false).option("--legacy", "Write RDF as BLOBs to the processed bucket instead of patching the graph directly", false).action(syncHandler);
+program.command("sync").description("Sync files to Cue").requiredOption("-s, --space <id>", "Specify the space ID (required)").requiredOption("-p, --path <id>", "Specify the folder path (required)").option("-k, --key <api-key>", "Specify the API key (or set CUE_API_KEY env variable)").option("--provider <provider ID>", "Specify the provider ID (eg. sharepoint, drive, dropbox) or leave empty for default provider", "").option("-v, --verbose", "Enable verbose output", false).option("-e, --emulators", "Uses emulators for sync", false).option("-z, --zip", 'Include zipped content (will be unzipped to path "<zip_path>_unzipped". Max uncompressed size: 500 MB, max recursion depth: 3)', false).option("--legacy", "Write RDF as BLOBs to the processed bucket instead of patching the graph directly", false).option("--metadata-only", "Push filesystem-structure metadata for all local files without checking credits or remote state", false).action(syncHandler);
 program.command("dump").description("Dump Cue Knowledge Graph data to file\n				Examples:\n				$ cue-cli dump -s <space_id> -l -v\n				$ cue-cli dump -s <space_id> -j -v").requiredOption("-s, --space <id>", "Specify the space ID (required)").option("-k, --key <api-key>", "Specify the API key (or set CUE_API_KEY env variable)").option("-v, --verbose", "Enable verbose output", false).option("-e, --emulators", "Uses emulators for sync", false).option("-q, --query", "Uses a construct query to get the dump rather than using the /data endpoint", false).option("-j, --jelly", "Downloads a Jelly file rather than the standard Gzipped NQuads format", false).option("-l, --load", "Loads the dumped file into a local triplestore (requires emulators)", false).action(dumpHandler);
 program.command("compare").description("Compares folder content to files already updated to Cue").requiredOption("-s, --space <id>", "Specify the space ID (required)").requiredOption("-p, --path <id>", "Specify the folder path (required)").option("-k, --key <api-key>", "Specify the API key (or set CUE_API_KEY env variable)").option("--provider <provider ID>", "Specify the provider ID (eg. sharepoint, drive, dropbox) or leave empty for default provider", "").option("-v, --verbose", "Enable verbose output", false).option("-e, --emulators", "Uses emulators for sync", false).option("-z, --zip", "Include zipped content (will temporarily unzip files with same logic as when syncing and delete them again after the comparison)", false).action(compareHandler);
 program.command("dump-processed").description("Dump processed files to local folder").requiredOption("-s, --space <id>", "Specify the space ID (required)").requiredOption("-p, --processor <id>", "Id of the processor to dump processed files from (required) [eg. writers-blob, processors-cad-files]").option("-k, --key <api-key>", "Specify the API key (or set CUE_API_KEY env variable)").option("-v, --verbose", "Enable verbose output", false).option("-e, --emulators", "Uses emulators for sync", false).action(dumpProcessedHandler);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qaecy/cue-cli",
-  "version": "0.0.37",
+  "version": "0.0.39",
   "description": "Cue CLI for QAECY platform",
   "main": "main.js",
   "bin": {

package/readme.md

@@ -32,6 +32,8 @@ To sync the current dir to the space with id `<space-id>` under the provider id
 | `-v, --verbose`       | Enable verbose output                                                                                | `false`      |
 | `-e, --emulators`     | Use emulators for sync                                                                               | `false`      |
 | `-z, --zip`           | Include zipped content. Will be unzipped to `<zip_path>_unzipped`. Max uncompressed size: 500 MB, max recursion depth: 3. Cleans up unzipped files after sync. | `false`      |
+| `--legacy`            | Write RDF metadata as serialised Turtle BLOBs to the processed storage bucket instead of patching the knowledge graph directly. Use this when the ledger and graph services are not yet available for the target environment. | `false` |
+| `--metadata-only`     | Push filesystem-structure metadata for every local file directly to the commands API, without checking what is already on the remote, running a credit estimate, or uploading any file content. Useful for repairing missing graph metadata after a migration or interrupted sync. Can be combined with `--legacy` to write the metadata as BLOBs. | `false` |
 
 ### util-remove-rdf-star