@indigoai-us/hq-cloud 5.46.0 → 5.47.1

package/src/s3.test.ts

@@ -682,6 +682,30 @@ describe("downloadFile", () => {
     expect(fs.readFileSync(localPath, "utf-8")).toBe("hi");
   });
 
+  it("recovers a symlink from the body prefix when the metadata marker is lost (header-loss fallback)", async () => {
+    // Regression: a transport/replication/console-copy that drops user
+    // metadata — or a poisoned regular-file re-upload of a sentinel —
+    // leaves an object with NO hq-symlink-target marker but a body of
+    // `hq-symlink:<target>`. The read path must honor the body prefix as
+    // a fallback discriminator and rematerialize a real link, NOT write
+    // out the `hq-symlink:` text as a regular file (which poisons the key
+    // on the next push). See s3.ts downloadFile + SYMLINK_BODY_PREFIX doc.
+    const target = "../../../some/real/target.md";
+    nextGetObjectResponse = {
+      Body: (async function* () {
+        yield new TextEncoder().encode(SYMLINK_BODY_PREFIX + target);
+      })(),
+      Metadata: {}, // marker stripped / never set
+    };
+
+    const localPath = path.join(tmpRoot, "marker-lost-link.md");
+    await downloadFile(makeCtx(), "marker-lost-link.md", localPath);
+
+    const lstat = fs.lstatSync(localPath);
+    expect(lstat.isSymbolicLink()).toBe(true);
+    expect(fs.readlinkSync(localPath)).toBe(target);
+  });
+
   it("replaces a stale local symlink with a regular file when remote transitions symlink → regular", async () => {
     // Codex P2 follow-up: pre-fix, the regular-file branch went
     // straight to writeFileSync. If localPath was a stale symlink from