@indigoai-us/hq-cloud 6.15.7 → 6.15.8

package/dist/cli/share.d.ts

@@ -209,6 +209,11 @@ export interface ShareOptions {
      * This is the seam `hq-sync-runner` uses to stream ndjson for push events.
      */
     onEvent?: (event: SyncProgressEvent) => void;
+    /**
+     * Watch-runner liveness callback for long synchronous file walks and hash
+     * planning. The caller owns throttling; one-shot CLI callers omit it.
+     */
+    onHeartbeat?: () => void;
     /**
      * When true, files whose local hash matches the journal entry from the
      * last sync are skipped (no remote HEAD, no upload). This is the gate
@@ -519,7 +524,7 @@ export interface ShareResult {
     pathResults?: SharePathResult[];
     aborted: boolean;
 }
-export type ShareDeleteRefusalReason = "stale-etag" | "legacy-no-etag" | "bulk-asymmetry" | "divergent-local" | "missing-delete-intent" | "intent-changed" | "recreated-locally" | "transfer-error";
+export type ShareDeleteRefusalReason = "stale-etag" | "legacy-no-etag" | "bulk-asymmetry" | "divergent-local" | "missing-delete-intent" | "intent-changed" | "recreated-locally" | "marker-mismatch" | "transfer-error";
 export interface SharePathResult {
     path: string;
     status: "accepted" | "refused";
@@ -592,6 +597,7 @@ type CollectedEntry = {
 interface CollectHooks {
     onUnreachablePath?: (namedPath: string, reason: UnreachablePathReason) => void;
     onLinkedSubtree?: (rel: string) => void;
+    onHeartbeat?: () => void;
 }
 /**
  * Resolve a caller-supplied push path to an absolute path.

package/dist/cli/share.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../../src/cli/share.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../../src/cli/share.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAe,MAAM,aAAa,CAAC;AAkBlF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA8B7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAwE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,sBAAsB,QACmD,CAAC;AAEvF;;;;;;;;;GASG;AACH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,QAAqB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAEtF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;;;;;;CAQpB,CAAC;AAgNF,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,qBAAqB,CAAC,EAAE,gBAAgB,GAAG,YAAY,GAAG,KAAK,CAAC;IAChE;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC/C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,qBAAqB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1C;AAED,8DAA8D;AAC9D,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEtF;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;gBAE5C,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAAE,QAAQ,EAAE,MAAM;CAuBtF;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;;;;;OASG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC;;;;;;;OAOG;IACH,0BAA0B,EAAE,MAAM,CAAC;IACnC;;;;;;;OAOG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;;;;;OAQG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;;;OAOG;IACH,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC;;;;OAIG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,wBAAwB,GAChC,YAAY,GACZ,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,uBAAuB,GACvB,gBAAgB,GAChB,mBAAmB,GACnB,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAmDD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,EACzD,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC3C,aAAa,CAAC,EAAE,MAAM,IAAI,GACzB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAW/C;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6CvE;AAssCD;;;GAGG;AACH,iBAAS,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAgI5D;AAED;;;;;;;;;GASG;AACH,KAAK,cAAc,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,UAAU,YAAY;IACpB,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC/E,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,gBAAgB,CACvB,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAsB,GAC1B,MAAM,CAuBR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,iBAAS,qBAAqB,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACvC,OAAO,CAwBT;AA8HD;;;;;;;;;;;GAWG;AACH,iBAAS,YAAY,CACnB,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,EAC/C,KAAK,GAAE,YAAiB,GACvB,cAAc,EAAE,CAkGlB"}

package/dist/cli/share.js

@@ -10,7 +10,7 @@ import * as path from "path";
 import { resolveEntityContext, isExpiringSoon, refreshEntityContext } from "../context.js";
 import { createSyncProgressRecorder } from "../sync-progress.js";
 import { localPathForVaultKey, vaultKeyForLocalPath } from "../local-path-codec.js";
-import { uploadFile, uploadSymlink, toPosixKey, headRemoteFile, deleteRemoteFile, downloadFile, primeObjectTransport, primeUploads, WindowsSymlinkPrivilegeError, WINDOWS_SYMLINK_PRIVILEGE_REMEDY, } from "../s3.js";
+import { uploadFile, uploadSymlink, toPosixKey, headRemoteFile, readVerifiedRemoteSymlinkTarget, deleteRemoteFile, downloadFile, primeObjectTransport, primeUploads, WindowsSymlinkPrivilegeError, WINDOWS_SYMLINK_PRIVILEGE_REMEDY, } from "../s3.js";
 import * as crypto from "crypto";
 import { readJournal, writeJournal, hashFile, hashSymlinkTarget, updateEntry, removeEntry, isTombstone, normalizeEtag, PERSONAL_VAULT_JOURNAL_SLUG, migratePersonalVaultJournal, } from "../journal.js";
 import { createIgnoreFilter, hasControlCharacters, isExpectedIgnore, isWithinSizeLimit, } from "../ignore.js";
@@ -247,9 +247,10 @@ export const _testing = {
  * detecting a push conflict requires a remote HEAD that we defer to Stage 2.
  * Consumers that want a conflict count get it from the `complete` event.
  */
-function computePushPlan(filesToShare, journal, skipUnchanged) {
+function computePushPlan(filesToShare, journal, skipUnchanged, onHeartbeat) {
     const items = [];
     for (const entry of filesToShare) {
+        onHeartbeat?.();
         const { absolutePath, relativePath } = entry;
         // Symlinks bypass the size-limit gate (the wire body is small,
         // bounded by target length) and hash the target through the
@@ -482,7 +483,7 @@ export async function share(options) {
     if (uploadResult.aborted) {
         return buildShareResult(run, counters, filesRefusedStalePaths, uploadResult.abortFlightConflictPaths, pathResults, true);
     }
-    await executeDeletes(run, plans.deletePlan, plans.decommissionPlan, counters, filesRefusedStalePaths, pathResults);
+    await executeDeletes(run, plans.deletePlan, plans.decommissionPlan, counters, filesRefusedStalePaths, pathResults, !uploadResult.hadUploadFailure && uploadResult.workerErrors.length === 0);
     finalizeShareJournal(run);
     throwUploadWorkerErrors(uploadResult.workerErrors);
     return buildShareResult(run, counters, filesRefusedStalePaths, conflictPaths, pathResults, false);
@@ -648,6 +649,7 @@ async function buildSharePlans(run) {
             }
         },
         onLinkedSubtree: (rel) => run.linkedSubtreeSet.add(rel),
+        onHeartbeat: run.options.onHeartbeat,
     });
     // Ask #2 of feedback_a51cb63d: "error, not warn-skip, when the named file
     // exists locally but is unreachable by the resolver". This is the throw that
@@ -732,7 +734,7 @@ async function buildSharePlans(run) {
             });
             return false;
         });
-    const pushPlan = computePushPlan(filesToShare, run.journal, run.skipUnchanged === true);
+    const pushPlan = computePushPlan(filesToShare, run.journal, run.skipUnchanged === true, run.options.onHeartbeat);
     const deleteScopeRoots = run.propagateDeletes === true
         ? resolveDeleteScopeRoots(run.paths, run.hqRoot, run.syncRoot, run.options.deleteScopeRoots)
         : [];
@@ -839,6 +841,7 @@ async function executeUploads(run, pushPlan, counters, conflictPaths) {
     await primeObjectTransport(run.ctx, "get", uploadItems.map((it) => it.relativePath));
     let aborted = false;
     let abortFlightConflictPaths = [];
+    let hadUploadFailure = false;
     const processUploadItem = async (item) => {
         if (aborted)
             return;
@@ -1015,6 +1018,7 @@ async function executeUploads(run, pushPlan, counters, conflictPaths) {
                     catch (retryErr) {
                         if (retryErr instanceof VaultAuthError)
                             throw retryErr;
+                        hadUploadFailure = true;
                         run.emit({
                             type: "error",
                             path: relativePath,
@@ -1028,9 +1032,11 @@ async function executeUploads(run, pushPlan, counters, conflictPaths) {
                 return;
             }
             if (isAccessDenied(err)) {
+                hadUploadFailure = true;
                 run.scopeExcludedSet.add(relativePath);
                 return;
             }
+            hadUploadFailure = true;
             run.emit({
                 type: "error",
                 path: relativePath,
@@ -1047,6 +1053,7 @@ async function executeUploads(run, pushPlan, counters, conflictPaths) {
                 const item = queue.shift();
                 const p = processUploadItem(item)
                     .catch((err) => {
+                    hadUploadFailure = true;
                     workerErrors.push(err instanceof Error ? err : new Error(String(err)));
                 })
                     .finally(() => {
@@ -1062,7 +1069,7 @@ async function executeUploads(run, pushPlan, counters, conflictPaths) {
             }
         }
     }
-    return { aborted, abortFlightConflictPaths, workerErrors };
+    return { aborted, abortFlightConflictPaths, workerErrors, hadUploadFailure };
 }
 async function writePushConflictMirror(run, item, remoteHash) {
     try {
@@ -1116,10 +1123,21 @@ async function writePushConflictMirror(run, item, remoteHash) {
         }
     }
 }
-async function executeDeletes(run, deletePlan, decommissionPlan, counters, filesRefusedStalePaths, pathResults) {
+async function executeDeletes(run, deletePlan, decommissionPlan, counters, filesRefusedStalePaths, pathResults, allowMaterializedKnowledgeDeletes) {
     const deleteItems = [
-        ...deletePlan.toDelete.map((item) => ({ ...item, decommission: false })),
-        ...decommissionPlan.map((key) => ({ key, intentVersion: null, decommission: true })),
+        ...deletePlan.toDelete
+            // A stale exact-key marker is removed only after every upload worker in
+            // this pass settled successfully. If a directory child failed to PUT,
+            // retain the marker + journal proof so the next sync retries the whole
+            // representation transition instead of creating a remote visibility gap.
+            .filter((item) => !item.materializedKnowledgeDir || allowMaterializedKnowledgeDeletes)
+            .map((item) => ({ ...item, decommission: false })),
+        ...decommissionPlan.map((key) => ({
+            key,
+            intentVersion: null,
+            decommission: true,
+            materializedKnowledgeDir: false,
+        })),
     ];
     const deleteKeys = deleteItems.map((item) => item.key);
     await primeObjectTransport(run.ctx, "delete", deleteKeys);
@@ -1143,8 +1161,11 @@ async function executeDeletes(run, deletePlan, decommissionPlan, counters, files
             // ENCODED local path or a win32 colon key always looks absent (a raw `:`
             // name can never exist on disk) and the remote delete proceeds while the
             // encoded local file is still present.
-            const recreatedLocally = !item.decommission &&
-                !isLocallyAbsent(localPathForVaultKey(run.syncRoot, relativePath));
+            const localPath = localPathForVaultKey(run.syncRoot, relativePath);
+            const localStateStillSafe = item.materializedKnowledgeDir
+                ? isMaterializedKnowledgeDirectory(localPath, relativePath, entry, run.options.personalMode !== true)
+                : isLocallyAbsent(localPath);
+            const recreatedLocally = !item.decommission && !localStateStillSafe;
             const intentChanged = !item.decommission &&
                 item.intentVersion !== null &&
                 (!hasCurrentLocalDeleteIntent(entry) ||
@@ -1519,6 +1540,10 @@ function defaultConsoleLogger(event) {
             console.error(`  ⚠ recreated-locally, kept on remote: ${event.path} ` +
                 `(the file exists locally again, so the delete was abandoned)`);
         }
+        else if (event.reason === "marker-mismatch") {
+            console.error(`  ⚠ marker-mismatch, kept on remote: ${event.path} ` +
+                `(the remote object is not the symlink revision reindex replaced)`);
+        }
         else if (event.reason === "divergent-local") {
             // Same trap as above — `remoteEtag` is `<not-checked>`. The entry's
             // recorded etag was stamped only to silence a re-fired conflict; the
@@ -1835,6 +1860,7 @@ function collectFiles(paths, hqRoot, syncRoot, filter, hooks = {}) {
     // boundary, so it deliberately does not.
     const tenantRoots = new Map();
     for (const p of paths) {
+        hooks.onHeartbeat?.();
         const absolutePath = resolveNamedPath(p, hqRoot, syncRoot);
         // Ephemeral artifacts (conflict mirrors) — see EPHEMERAL_PATH_PATTERN doc.
         // Caller may pass one explicitly; we still refuse to upload it. Basename
@@ -1939,6 +1965,7 @@ function walkDir(dir, syncRoot, filter, results, hooks = {}) {
     };
     enterDirectory(dir);
     while (stack.length > 0) {
+        hooks.onHeartbeat?.();
         const frame = stack[stack.length - 1];
         if (frame.index >= frame.entries.length) {
             stack.pop();
@@ -2230,6 +2257,42 @@ function isLocallyAbsent(localPath) {
         return code === "ENOENT";
     }
 }
+/** Exact canonical Knowledge keys scanned by reindex-knowledge.ts. */
+function isCanonicalKnowledgeMarkerKey(key, companyScoped) {
+    const parts = key.split("/");
+    if (companyScoped) {
+        return parts[0] === "knowledge" && (parts.length === 1 || parts.length === 2);
+    }
+    if (parts[0] === "companies" &&
+        parts[2] === "knowledge" &&
+        (parts.length === 3 || parts.length === 4)) {
+        return true;
+    }
+    if (parts[0] === "personal" &&
+        parts[1] === "knowledge" &&
+        (parts.length === 2 || parts.length === 3)) {
+        return true;
+    }
+    return (parts[0] === "core" &&
+        parts[1] === "knowledge" &&
+        ((parts.length === 3 && parts[2] !== "public" && parts[2] !== "private") ||
+            (parts.length === 4 && (parts[2] === "public" || parts[2] === "private"))));
+}
+function isMaterializedKnowledgeDirectory(localPath, key, entry, companyScoped) {
+    // `kind` is optional for journals written before representation tracking.
+    // A known regular file is never eligible; an unknown legacy entry still is,
+    // but only after the remote HEAD/GET proves the exact object is a symlink.
+    if (!entry || entry.kind === "file" || !isCanonicalKnowledgeMarkerKey(key, companyScoped)) {
+        return false;
+    }
+    try {
+        const local = fs.lstatSync(localPath);
+        return local.isDirectory() && !local.isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Concurrency cap for the per-file HEAD-O-meter (currency-gated). Sequential
  * HEADs would add ~N×(50-200ms) to a sync — for the 261-mirror real-world
@@ -2424,8 +2487,49 @@ companyScoped = true) {
                 throw err;
             }
         }
-        if (presentLocally)
+        const materializedKnowledgeDir = presentLocally &&
+            isMaterializedKnowledgeDirectory(localPath, relativeKey, entry, companyScoped);
+        if (presentLocally && !materializedKnowledgeDir)
             continue;
+        // Reindex's legacy Knowledge migration is a representation transition,
+        // not a user-content deletion: the exact key changed from a symlink object
+        // to a real directory whose children are uploaded separately. The normal
+        // delete planner only accepts ENOENT, so without this explicit branch the
+        // old exact-key marker survives forever. Require a current ETag here and
+        // verify the remote marker body against the journal in the HEAD/GET pass
+        // below before allowing the exact object to be removed. This branch runs
+        // before personal-vault delete exclusions because canonical core Knowledge
+        // markers are excluded from ordinary delete propagation; it does not add
+        // to the bulk-asymmetry numerator because the verified marker carries no
+        // file content.
+        if (materializedKnowledgeDir) {
+            if (entry.localDiverges) {
+                plan.refusedStale.push({
+                    key: relativeKey,
+                    journalEtag: entry.remoteEtag ?? "<divergent-local>",
+                    remoteEtag: "<not-checked>",
+                    reason: "divergent-local",
+                });
+                continue;
+            }
+            if (!entry.remoteEtag) {
+                plan.refusedStale.push({
+                    key: relativeKey,
+                    journalEtag: "<legacy-no-etag>",
+                    remoteEtag: "<unknown>",
+                    reason: "legacy-no-etag",
+                });
+                continue;
+            }
+            headCandidates.push({
+                key: relativeKey,
+                journalEtag: entry.remoteEtag,
+                intentVersion: null,
+                materializedKnowledgeDir: true,
+                ...(entry.kind === "symlink" ? { expectedSymlinkHash: entry.hash } : {}),
+            });
+            continue;
+        }
         if (!companyScoped && isPersonalVaultDeletionExcluded(relativeKey)) {
             continue;
         }
@@ -2685,9 +2789,26 @@ companyScoped = true) {
             }
             const currentEtag = normalizeEtag(remote.etag);
             if (currentEtag === candidate.journalEtag) {
+                if (candidate.materializedKnowledgeDir) {
+                    const target = await readVerifiedRemoteSymlinkTarget(ctx, candidate.key);
+                    if (target === null ||
+                        (candidate.expectedSymlinkHash !== undefined &&
+                            hashSymlinkTarget(target) !== candidate.expectedSymlinkHash)) {
+                        plan.refusedStale.push({
+                            key: candidate.key,
+                            journalEtag: candidate.journalEtag,
+                            remoteEtag: currentEtag,
+                            reason: "marker-mismatch",
+                        });
+                        continue;
+                    }
+                }
                 plan.toDelete.push({
                     key: candidate.key,
                     intentVersion: candidate.intentVersion,
+                    ...(candidate.materializedKnowledgeDir
+                        ? { materializedKnowledgeDir: true }
+                        : {}),
                 });
             }
             else {