@taskforcehq/taskforce 0.3.327 → 0.3.329

package/dist/sync/workspacePullFeed.js

@@ -33,7 +33,8 @@ export async function buildWorkspacePullFeed(input) {
     const excludedProjections = new Set(input.excludedProjections || []);
     const commentsV3Owned = excludedProjections.has('task-comments/full-v1');
     const checklistV3Owned = excludedProjections.has('task-checklist/full-v1');
-    const attachmentsV3Owned = excludedProjections.has('task-attachment-links/full-v1');
+    const attachmentsV3Owned = excludedProjections.has('task-attachment-links/full-v1')
+        || excludedProjections.has('task-attachment-links/full-v2');
     const suppressTaskCarriers = excludedProjections.has('task/root-v1')
         && commentsV3Owned && checklistV3Owned && attachmentsV3Owned;
     const syncCursor = cursor ? { watermark: cursor.u, id: cursor.id } : null;
@@ -245,6 +246,14 @@ export async function buildWorkspacePullFeed(input) {
             workstream
         }))
             .filter((entry) => Number.isFinite(Date.parse(entry.watermark)) && entry.workstream.id.length > 0);
+    const planningIdentityEntries = readSnapshot('planning-identities', [], () => core.listPlanningEntityIdentities(workspaceId))
+        .map((identity) => ({
+        kind: 'planning-identity',
+        watermark: String(identity.updatedAt || '').trim(),
+        sortId: `planning-identity:${identity.entityType}:${identity.entityId}`,
+        identity,
+    }))
+        .filter((entry) => Number.isFinite(Date.parse(entry.watermark)) && entry.identity.entityId.length > 0);
     const aiProfileEntries = readSnapshot('ai-profiles', [], () => core.listAiProfiles(workspaceId, { includeArchived: true }))
         .map((profile) => ({
         kind: 'ai-profile',
@@ -469,6 +478,7 @@ export async function buildWorkspacePullFeed(input) {
         ...taxonomyEntries,
         ...initiativeEntries,
         ...workstreamEntries,
+        ...planningIdentityEntries,
         ...aiProfileEntries,
         ...documentEntries,
         ...documentDeleteEntries,
@@ -568,171 +578,173 @@ export async function buildWorkspacePullFeed(input) {
                     ? [{ op: 'initiative-upsert', initiative: entry.initiative, watermark: entry.watermark }]
                     : entry.kind === 'workstream'
                         ? [{ op: 'workstream-upsert', workstream: entry.workstream, watermark: entry.watermark }]
-                        : entry.kind === 'ai-profile'
-                            ? [{ op: 'ai-profile-upsert', profile: entry.profile, watermark: entry.watermark }]
-                            : entry.kind === 'document-review-session'
-                                ? [{ op: 'document-review-session-upsert', session: entry.session, watermark: entry.watermark }]
-                                : entry.kind === 'document-review-session-delete'
-                                    ? [{ op: 'document-review-session-delete', sessionId: entry.sessionId, deletedAt: entry.watermark, watermark: entry.watermark }]
-                                    : entry.kind === 'document-review-comment'
-                                        ? [{ op: 'document-review-comment-upsert', comment: entry.comment, watermark: entry.watermark }]
-                                        : entry.kind === 'document-review-comment-delete'
-                                            ? [{
-                                                    op: 'document-review-comment-delete',
-                                                    commentId: entry.commentId,
-                                                    deletedAt: entry.watermark,
-                                                    deletedByActorId: entry.deletedByActorId,
-                                                    watermark: entry.watermark,
-                                                }]
-                                            : entry.kind === 'annotated-attachment-session'
-                                                ? [{ op: 'annotated-attachment-session-upsert', session: entry.session, watermark: entry.watermark }]
-                                                : entry.kind === 'annotated-attachment-session-delete'
-                                                    ? [{ op: 'annotated-attachment-session-delete', sessionId: entry.sessionId, deletedAt: entry.watermark, watermark: entry.watermark }]
-                                                    : entry.kind === 'taskforce-agent'
-                                                        ? [{ op: 'taskforce-agent-upsert', agent: entry.agent, watermark: entry.watermark }]
-                                                        : entry.kind === 'agent-role'
-                                                            ? [{ op: 'agent-role-upsert', role: entry.role, watermark: entry.watermark }]
-                                                            : entry.kind === 'taskforce-agent-skill'
-                                                                ? [{ op: 'taskforce-agent-skill-upsert', skill: entry.skill, watermark: entry.watermark }]
-                                                                : entry.kind === 'agent-conversation'
-                                                                    ? [{ op: 'agent-conversation-upsert', conversation: entry.conversation, watermark: entry.watermark }]
-                                                                    : entry.kind === 'task-event'
-                                                                        ? [{ op: 'task-event-upsert', event: entry.event, watermark: entry.watermark }]
-                                                                        : entry.kind === 'entity-event'
-                                                                            ? [{ op: 'entity-event-upsert', event: entry.event, watermark: entry.watermark }]
-                                                                            : entry.kind === 'document'
-                                                                                ? (() => {
-                                                                                    if (contentMode === 'manifest'
-                                                                                        || isHydrationMissing(entry)
-                                                                                        || isContentUnavailable(entry)) {
-                                                                                        const metadata = {
-                                                                                            assetId: entry.assetId,
-                                                                                            documentId: entry.documentId,
-                                                                                            referenceNumber: entry.referenceNumber,
-                                                                                            version: entry.version,
-                                                                                            taskId: entry.taskId,
-                                                                                            linkTargetType: entry.linkTargetType,
-                                                                                            linkTargetId: entry.linkTargetId,
-                                                                                            logicalName: entry.logicalName,
-                                                                                            caption: entry.caption,
-                                                                                            originalFilename: entry.originalFilename,
-                                                                                            linkRole: entry.linkRole,
-                                                                                            links: entry.links,
-                                                                                        };
-                                                                                        return [{
-                                                                                                op: 'document-manifest',
-                                                                                                manifest: {
-                                                                                                    manifestVersion: WORKSPACE_CONTENT_MANIFEST_VERSION,
-                                                                                                    kind: 'document',
-                                                                                                    path: entry.path,
-                                                                                                    sha256: entry.contentSha256,
-                                                                                                    sizeBytes: entry.sizeBytes,
-                                                                                                    updatedAt: entry.watermark,
-                                                                                                    metadataFingerprint: createWorkspaceContentMetadataFingerprintV1({
+                        : entry.kind === 'planning-identity'
+                            ? [{ op: 'planning-identity-upsert', identity: entry.identity, watermark: entry.watermark }]
+                            : entry.kind === 'ai-profile'
+                                ? [{ op: 'ai-profile-upsert', profile: entry.profile, watermark: entry.watermark }]
+                                : entry.kind === 'document-review-session'
+                                    ? [{ op: 'document-review-session-upsert', session: entry.session, watermark: entry.watermark }]
+                                    : entry.kind === 'document-review-session-delete'
+                                        ? [{ op: 'document-review-session-delete', sessionId: entry.sessionId, deletedAt: entry.watermark, watermark: entry.watermark }]
+                                        : entry.kind === 'document-review-comment'
+                                            ? [{ op: 'document-review-comment-upsert', comment: entry.comment, watermark: entry.watermark }]
+                                            : entry.kind === 'document-review-comment-delete'
+                                                ? [{
+                                                        op: 'document-review-comment-delete',
+                                                        commentId: entry.commentId,
+                                                        deletedAt: entry.watermark,
+                                                        deletedByActorId: entry.deletedByActorId,
+                                                        watermark: entry.watermark,
+                                                    }]
+                                                : entry.kind === 'annotated-attachment-session'
+                                                    ? [{ op: 'annotated-attachment-session-upsert', session: entry.session, watermark: entry.watermark }]
+                                                    : entry.kind === 'annotated-attachment-session-delete'
+                                                        ? [{ op: 'annotated-attachment-session-delete', sessionId: entry.sessionId, deletedAt: entry.watermark, watermark: entry.watermark }]
+                                                        : entry.kind === 'taskforce-agent'
+                                                            ? [{ op: 'taskforce-agent-upsert', agent: entry.agent, watermark: entry.watermark }]
+                                                            : entry.kind === 'agent-role'
+                                                                ? [{ op: 'agent-role-upsert', role: entry.role, watermark: entry.watermark }]
+                                                                : entry.kind === 'taskforce-agent-skill'
+                                                                    ? [{ op: 'taskforce-agent-skill-upsert', skill: entry.skill, watermark: entry.watermark }]
+                                                                    : entry.kind === 'agent-conversation'
+                                                                        ? [{ op: 'agent-conversation-upsert', conversation: entry.conversation, watermark: entry.watermark }]
+                                                                        : entry.kind === 'task-event'
+                                                                            ? [{ op: 'task-event-upsert', event: entry.event, watermark: entry.watermark }]
+                                                                            : entry.kind === 'entity-event'
+                                                                                ? [{ op: 'entity-event-upsert', event: entry.event, watermark: entry.watermark }]
+                                                                                : entry.kind === 'document'
+                                                                                    ? (() => {
+                                                                                        if (contentMode === 'manifest'
+                                                                                            || isHydrationMissing(entry)
+                                                                                            || isContentUnavailable(entry)) {
+                                                                                            const metadata = {
+                                                                                                assetId: entry.assetId,
+                                                                                                documentId: entry.documentId,
+                                                                                                referenceNumber: entry.referenceNumber,
+                                                                                                version: entry.version,
+                                                                                                taskId: entry.taskId,
+                                                                                                linkTargetType: entry.linkTargetType,
+                                                                                                linkTargetId: entry.linkTargetId,
+                                                                                                logicalName: entry.logicalName,
+                                                                                                caption: entry.caption,
+                                                                                                originalFilename: entry.originalFilename,
+                                                                                                linkRole: entry.linkRole,
+                                                                                                links: entry.links,
+                                                                                            };
+                                                                                            return [{
+                                                                                                    op: 'document-manifest',
+                                                                                                    manifest: {
+                                                                                                        manifestVersion: WORKSPACE_CONTENT_MANIFEST_VERSION,
                                                                                                         kind: 'document',
-                                                                                                        metadata,
-                                                                                                    }),
-                                                                                                    existsLocally: entry.contentAvailable,
-                                                                                                },
-                                                                                                metadata,
-                                                                                                watermark: entry.watermark,
+                                                                                                        path: entry.path,
+                                                                                                        sha256: entry.contentSha256,
+                                                                                                        sizeBytes: entry.sizeBytes,
+                                                                                                        updatedAt: entry.watermark,
+                                                                                                        metadataFingerprint: createWorkspaceContentMetadataFingerprintV1({
+                                                                                                            kind: 'document',
+                                                                                                            metadata,
+                                                                                                        }),
+                                                                                                        existsLocally: entry.contentAvailable,
+                                                                                                    },
+                                                                                                    metadata,
+                                                                                                    watermark: entry.watermark,
+                                                                                                }];
+                                                                                        }
+                                                                                        const payload = hydratedDocuments.get(entry.path);
+                                                                                        if (!payload)
+                                                                                            return [];
+                                                                                        return [{
+                                                                                                op: 'document-upsert',
+                                                                                                path: entry.path,
+                                                                                                updatedAt: entry.watermark,
+                                                                                                content: payload.content,
+                                                                                                assetId: payload.assetId,
+                                                                                                documentId: payload.documentId,
+                                                                                                referenceNumber: payload.referenceNumber,
+                                                                                                version: payload.version,
+                                                                                                taskId: payload.taskId,
+                                                                                                linkTargetType: payload.linkTargetType,
+                                                                                                linkTargetId: payload.linkTargetId,
+                                                                                                logicalName: payload.logicalName,
+                                                                                                caption: payload.caption,
+                                                                                                originalFilename: payload.originalFilename,
+                                                                                                linkRole: payload.linkRole === 'reference' ? 'reference' : 'attachment',
+                                                                                                ...(payload.links ? { links: payload.links } : {}),
+                                                                                                watermark: entry.watermark
                                                                                             }];
-                                                                                    }
-                                                                                    const payload = hydratedDocuments.get(entry.path);
-                                                                                    if (!payload)
-                                                                                        return [];
-                                                                                    return [{
-                                                                                            op: 'document-upsert',
-                                                                                            path: entry.path,
-                                                                                            updatedAt: entry.watermark,
-                                                                                            content: payload.content,
-                                                                                            assetId: payload.assetId,
-                                                                                            documentId: payload.documentId,
-                                                                                            referenceNumber: payload.referenceNumber,
-                                                                                            version: payload.version,
-                                                                                            taskId: payload.taskId,
-                                                                                            linkTargetType: payload.linkTargetType,
-                                                                                            linkTargetId: payload.linkTargetId,
-                                                                                            logicalName: payload.logicalName,
-                                                                                            caption: payload.caption,
-                                                                                            originalFilename: payload.originalFilename,
-                                                                                            linkRole: payload.linkRole === 'reference' ? 'reference' : 'attachment',
-                                                                                            ...(payload.links ? { links: payload.links } : {}),
-                                                                                            watermark: entry.watermark
-                                                                                        }];
-                                                                                })()
-                                                                                : entry.kind === 'document-delete'
-                                                                                    ? [{ op: 'document-delete', path: entry.path, assetId: entry.assetId, deletedAt: entry.watermark, watermark: entry.watermark }]
-                                                                                    : entry.kind === 'asset'
-                                                                                        ? (() => {
-                                                                                            if (contentMode === 'manifest'
-                                                                                                || isHydrationMissing(entry)
-                                                                                                || isContentUnavailable(entry)) {
-                                                                                                const metadata = {
-                                                                                                    assetId: entry.assetId,
-                                                                                                    assetKind: entry.kindValue,
-                                                                                                    mimeType: entry.mimeType,
-                                                                                                    referenceNumber: entry.referenceNumber,
-                                                                                                    taskId: entry.taskId,
-                                                                                                    linkTargetType: entry.linkTargetType,
-                                                                                                    linkTargetId: entry.linkTargetId,
-                                                                                                    logicalName: entry.logicalName,
-                                                                                                    caption: entry.caption,
-                                                                                                    originalFilename: entry.originalFilename,
-                                                                                                    linkRole: entry.linkRole,
-                                                                                                    links: entry.links,
-                                                                                                };
-                                                                                                return [{
-                                                                                                        op: 'asset-manifest',
-                                                                                                        manifest: {
-                                                                                                            manifestVersion: WORKSPACE_CONTENT_MANIFEST_VERSION,
-                                                                                                            kind: 'asset',
-                                                                                                            path: entry.path,
-                                                                                                            sha256: entry.contentSha256,
-                                                                                                            sizeBytes: entry.sizeBytes,
-                                                                                                            updatedAt: entry.watermark,
-                                                                                                            metadataFingerprint: createWorkspaceContentMetadataFingerprintV1({
+                                                                                    })()
+                                                                                    : entry.kind === 'document-delete'
+                                                                                        ? [{ op: 'document-delete', path: entry.path, assetId: entry.assetId, deletedAt: entry.watermark, watermark: entry.watermark }]
+                                                                                        : entry.kind === 'asset'
+                                                                                            ? (() => {
+                                                                                                if (contentMode === 'manifest'
+                                                                                                    || isHydrationMissing(entry)
+                                                                                                    || isContentUnavailable(entry)) {
+                                                                                                    const metadata = {
+                                                                                                        assetId: entry.assetId,
+                                                                                                        assetKind: entry.kindValue,
+                                                                                                        mimeType: entry.mimeType,
+                                                                                                        referenceNumber: entry.referenceNumber,
+                                                                                                        taskId: entry.taskId,
+                                                                                                        linkTargetType: entry.linkTargetType,
+                                                                                                        linkTargetId: entry.linkTargetId,
+                                                                                                        logicalName: entry.logicalName,
+                                                                                                        caption: entry.caption,
+                                                                                                        originalFilename: entry.originalFilename,
+                                                                                                        linkRole: entry.linkRole,
+                                                                                                        links: entry.links,
+                                                                                                    };
+                                                                                                    return [{
+                                                                                                            op: 'asset-manifest',
+                                                                                                            manifest: {
+                                                                                                                manifestVersion: WORKSPACE_CONTENT_MANIFEST_VERSION,
                                                                                                                 kind: 'asset',
-                                                                                                                metadata,
-                                                                                                            }),
-                                                                                                            existsLocally: entry.contentAvailable,
-                                                                                                        },
-                                                                                                        metadata,
-                                                                                                        watermark: entry.watermark,
+                                                                                                                path: entry.path,
+                                                                                                                sha256: entry.contentSha256,
+                                                                                                                sizeBytes: entry.sizeBytes,
+                                                                                                                updatedAt: entry.watermark,
+                                                                                                                metadataFingerprint: createWorkspaceContentMetadataFingerprintV1({
+                                                                                                                    kind: 'asset',
+                                                                                                                    metadata,
+                                                                                                                }),
+                                                                                                                existsLocally: entry.contentAvailable,
+                                                                                                            },
+                                                                                                            metadata,
+                                                                                                            watermark: entry.watermark,
+                                                                                                        }];
+                                                                                                }
+                                                                                                const payload = hydratedAssets.get(entry.path);
+                                                                                                if (!payload)
+                                                                                                    return [];
+                                                                                                return [{
+                                                                                                        op: 'asset-upsert',
+                                                                                                        path: entry.path,
+                                                                                                        updatedAt: entry.watermark,
+                                                                                                        contentBase64: payload.contentBase64,
+                                                                                                        assetId: payload.assetId,
+                                                                                                        kind: payload.kind,
+                                                                                                        mimeType: payload.mimeType,
+                                                                                                        referenceNumber: payload.referenceNumber,
+                                                                                                        taskId: payload.taskId,
+                                                                                                        linkTargetType: payload.linkTargetType,
+                                                                                                        linkTargetId: payload.linkTargetId,
+                                                                                                        logicalName: payload.logicalName,
+                                                                                                        caption: payload.caption,
+                                                                                                        originalFilename: payload.originalFilename,
+                                                                                                        linkRole: payload.linkRole,
+                                                                                                        ...(payload.links ? { links: payload.links } : {}),
+                                                                                                        watermark: entry.watermark
                                                                                                     }];
-                                                                                            }
-                                                                                            const payload = hydratedAssets.get(entry.path);
-                                                                                            if (!payload)
-                                                                                                return [];
-                                                                                            return [{
-                                                                                                    op: 'asset-upsert',
-                                                                                                    path: entry.path,
-                                                                                                    updatedAt: entry.watermark,
-                                                                                                    contentBase64: payload.contentBase64,
-                                                                                                    assetId: payload.assetId,
-                                                                                                    kind: payload.kind,
-                                                                                                    mimeType: payload.mimeType,
-                                                                                                    referenceNumber: payload.referenceNumber,
-                                                                                                    taskId: payload.taskId,
-                                                                                                    linkTargetType: payload.linkTargetType,
-                                                                                                    linkTargetId: payload.linkTargetId,
-                                                                                                    logicalName: payload.logicalName,
-                                                                                                    caption: payload.caption,
-                                                                                                    originalFilename: payload.originalFilename,
-                                                                                                    linkRole: payload.linkRole,
-                                                                                                    ...(payload.links ? { links: payload.links } : {}),
-                                                                                                    watermark: entry.watermark
-                                                                                                }];
-                                                                                        })()
-                                                                                        : entry.kind === 'asset-delete'
-                                                                                            ? [{ op: 'asset-delete', path: entry.path, assetId: entry.assetId, deletedAt: entry.watermark, watermark: entry.watermark }]
-                                                                                            : [{
-                                                                                                    op: 'upsert',
-                                                                                                    task: entry.task,
-                                                                                                    archived: Boolean(entry.archived),
-                                                                                                    ...(entry.durableRevision ? { durableRevision: entry.durableRevision } : {}),
-                                                                                                    watermark: entry.watermark,
-                                                                                                }]));
+                                                                                            })()
+                                                                                            : entry.kind === 'asset-delete'
+                                                                                                ? [{ op: 'asset-delete', path: entry.path, assetId: entry.assetId, deletedAt: entry.watermark, watermark: entry.watermark }]
+                                                                                                : [{
+                                                                                                        op: 'upsert',
+                                                                                                        task: entry.task,
+                                                                                                        archived: Boolean(entry.archived),
+                                                                                                        ...(entry.durableRevision ? { durableRevision: entry.durableRevision } : {}),
+                                                                                                        watermark: entry.watermark,
+                                                                                                    }]));
     let pageBytes = Buffer.byteLength(JSON.stringify({ workspaceId, changes: [], workspaceMembers }), 'utf8');
     let includedEntryCount = 0;
     let includedChangeCount = 0;

package/dist/sync/workspaceRepair.d.ts

@@ -22,6 +22,7 @@ export interface WorkspaceRepairManifestDocumentEntry {
     sha256: string;
     sizeBytes: number;
     existsLocally: boolean;
+    contentCheckReliable: boolean;
     source: 'metadata' | 'filesystem';
     publicationState: 'legacy' | 'versioned' | 'deleted' | 'invalid';
     publicationError: string | null;
@@ -36,6 +37,7 @@ export interface WorkspaceRepairManifestAssetEntry {
     sha256: string;
     sizeBytes: number;
     existsLocally: boolean;
+    contentCheckReliable: boolean;
     source: 'metadata' | 'filesystem';
     publicationState: 'legacy' | 'versioned' | 'deleted' | 'invalid';
     publicationError: string | null;
@@ -103,4 +105,5 @@ export declare function scanWorkspaceRepair(input: WorkspaceRepairInput): Worksp
 export declare function applyWorkspaceRepair(input: WorkspaceRepairInput & {
     upsertDocumentWatermark: (workspaceId: string, path: string, contentHash: string, updatedAt: string) => void;
     repairMissingAssetLinks?: boolean;
+    repairMissingContentFiles?: boolean;
 }): WorkspaceRepairApplyResult;

package/dist/sync/workspaceRepair.js

@@ -44,6 +44,14 @@ function collectFiles(dirPath, predicate) {
     visit(root);
     return output;
 }
+function isStorageRootAccessible(basePath) {
+    try {
+        return fs.statSync(basePath).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
 function readFileFingerprint(absolutePath) {
     try {
         const stat = fs.statSync(absolutePath);
@@ -145,6 +153,7 @@ function buildManifestEntriesFromMetadata(tenantId, workspaceId, store, basePath
     const assetDeletes = [];
     const protectedDocumentPaths = new Set();
     const protectedAssetPaths = new Set();
+    const storageRootAccessible = isStorageRootAccessible(basePath);
     const metadataEntries = store.listAllByWorkspace(workspaceId, { includeDeleted: true });
     for (const entry of metadataEntries) {
         const contentKind = entry.kind === 'document' ? 'document' : 'asset';
@@ -192,6 +201,7 @@ function buildManifestEntriesFromMetadata(tenantId, workspaceId, store, basePath
             ? resolveStorageKeyPathInsideRoot(basePath, published.physicalKey)
             : null;
         let existsLocally = false;
+        let contentCheckReliable = true;
         if (!supportsPublishedContent) {
             existsLocally = true;
         }
@@ -200,13 +210,23 @@ function buildManifestEntriesFromMetadata(tenantId, workspaceId, store, basePath
                 existsLocally = true;
             }
             else if (physicalPath) {
-                try {
-                    const stat = fs.statSync(physicalPath);
-                    existsLocally = stat.isFile()
-                        && (published.source !== 'versioned' || stat.size === published.sizeBytes);
-                }
-                catch {
+                if (!storageRootAccessible) {
+                    // The storage root itself couldn't be verified (e.g. an unmounted volume or
+                    // transient I/O failure) — every local file would look "missing" in that state,
+                    // so don't let a whole-root outage masquerade as N individual deletions.
                     existsLocally = false;
+                    contentCheckReliable = false;
+                }
+                else {
+                    try {
+                        const stat = fs.statSync(physicalPath);
+                        existsLocally = stat.isFile()
+                            && (published.source !== 'versioned' || stat.size === published.sizeBytes);
+                    }
+                    catch (error) {
+                        existsLocally = false;
+                        contentCheckReliable = error?.code === 'ENOENT';
+                    }
                 }
             }
         }
@@ -231,6 +251,7 @@ function buildManifestEntriesFromMetadata(tenantId, workspaceId, store, basePath
                 sha256: contentSha256,
                 sizeBytes,
                 existsLocally,
+                contentCheckReliable,
                 source: 'metadata',
                 publicationState,
                 publicationError,
@@ -249,6 +270,7 @@ function buildManifestEntriesFromMetadata(tenantId, workspaceId, store, basePath
             sha256: contentSha256,
             sizeBytes,
             existsLocally,
+            contentCheckReliable,
             source: 'metadata',
             publicationState,
             publicationError,
@@ -307,6 +329,7 @@ export function buildWorkspaceRepairManifest(input) {
                 sha256: fingerprint.sha256,
                 sizeBytes: fingerprint.sizeBytes,
                 existsLocally: true,
+                contentCheckReliable: true,
                 source: 'filesystem',
                 publicationState: 'legacy',
                 publicationError: null,
@@ -337,6 +360,7 @@ export function buildWorkspaceRepairManifest(input) {
             sha256: fingerprint.sha256,
             sizeBytes: fingerprint.sizeBytes,
             existsLocally: true,
+            contentCheckReliable: true,
             source: 'filesystem',
             publicationState: 'legacy',
             publicationError: null,
@@ -466,6 +490,19 @@ export function scanWorkspaceRepair(input) {
             continue;
         }
         if (!document.existsLocally) {
+            if (!document.contentCheckReliable) {
+                issues.push({
+                    code: 'invalid_published_document_content',
+                    entityKind: 'document',
+                    path: document.path,
+                    assetId: document.assetId,
+                    taskId: document.taskId,
+                    repairable: false,
+                    recommendedAction: 'inspect-published-content',
+                    detail: 'Local document file could not be confirmed missing — the storage root was unreachable or the check was inconclusive. Skipped to avoid converting unavailable content into an authoritative deletion.'
+                });
+                continue;
+            }
             issues.push({
                 code: 'missing_document_file',
                 entityKind: 'document',
@@ -564,6 +601,19 @@ export function scanWorkspaceRepair(input) {
         if (!asset.existsLocally) {
             if (protectedAiAvatarAssetPaths.has(asset.path))
                 continue;
+            if (!asset.contentCheckReliable) {
+                issues.push({
+                    code: 'invalid_published_asset_content',
+                    entityKind: 'asset',
+                    path: asset.path,
+                    assetId: asset.assetId,
+                    taskId: asset.taskId,
+                    repairable: false,
+                    recommendedAction: 'inspect-published-content',
+                    detail: 'Local asset file could not be confirmed missing — the storage root was unreachable or the check was inconclusive. Skipped to avoid converting unavailable content into an authoritative deletion.'
+                });
+                continue;
+            }
             issues.push({
                 code: 'missing_asset_file',
                 entityKind: 'asset',
@@ -791,6 +841,17 @@ export function applyWorkspaceRepair(input) {
                 continue;
             }
             if ((issue.code === 'missing_document_file' || issue.code === 'missing_asset_file') && issue.assetId) {
+                if (input.repairMissingContentFiles !== true) {
+                    actionsApplied.push({
+                        code: issue.code,
+                        path: issue.path,
+                        assetId: issue.assetId,
+                        action: issue.recommendedAction,
+                        status: 'skipped',
+                        detail: 'Missing content file repair requires explicit admin confirmation, since a single failed existence check can also mean the content is temporarily unavailable rather than deleted.'
+                    });
+                    continue;
+                }
                 const updated = input.workspaceAssetStore.markDeleted(issue.assetId, workspaceId);
                 actionsApplied.push({
                     code: issue.code,

package/dist/sync/workspaceSyncModel.d.ts

@@ -11,6 +11,7 @@ import type { WorkspaceAssetSyncLinkPayload } from './contentSyncPayload.js';
 import type { WorkspaceAssetManifestMetadata, WorkspaceContentManifestEntry, WorkspaceDocumentManifestMetadata } from './workspaceContentManifest.js';
 import type { TaskRelationshipRecord } from '../core/Taskforce.js';
 import type { AgentConfigurationIssue, AgentConfigurationState } from '../shared/taskforceAgentDefinition.js';
+import type { PlanningIdentityColor, PlanningIdentityEntityType, PlanningIdentityIcon } from '../shared/planningIdentity.js';
 export type WorkspaceSyncTaskSnapshot = TaskSyncPayload;
 export interface WorkspaceSyncTaskDelete {
     taskId: string;
@@ -246,6 +247,13 @@ export interface WorkspaceSyncWorkstreamSnapshot {
     isArchived?: boolean;
     durableRevision?: WorkspaceSyncDurablePlanningRevision<'workstream'>;
 }
+export interface WorkspaceSyncPlanningIdentitySnapshot {
+    entityType: PlanningIdentityEntityType;
+    entityId: string;
+    icon: PlanningIdentityIcon | null;
+    color: PlanningIdentityColor | null;
+    updatedAt: string;
+}
 export type WorkspaceSyncPlanningComment = CanonicalPlanningComment;
 export type WorkspaceSyncPlanningDomain = 'initiative' | 'workstream';
 export type WorkspaceSyncPlanningMutationKind = 'create' | 'metadata-update' | 'append-comment' | 'archive' | 'unarchive';
@@ -300,6 +308,9 @@ export type WorkspaceSyncChange = {
 } | {
     op: 'workstream-upsert';
     workstream: WorkspaceSyncWorkstreamSnapshot;
+} | {
+    op: 'planning-identity-upsert';
+    identity: WorkspaceSyncPlanningIdentitySnapshot;
 } | {
     op: 'taxonomy-upsert';
     taxonomies?: unknown[];