@taskforcehq/taskforce 0.3.324 → 0.3.327

package/dist/sync/v3/workspaceSyncV3OperationProtocol.d.ts

@@ -0,0 +1,229 @@
+import type { ChecklistItem, Comment, TaskItem, TaskRelationshipInputType, TaskRelationshipRecord } from '../../core/Taskforce.js';
+import type { DurableTaskStatusMutationPayload } from '../../core/TaskDurableStatusMutationService.js';
+import type { NormalizedWorkspaceTaxonomyState } from '../../shared/taxonomyState.js';
+import type { TaxonomyTaskRemapPatch } from './taxonomyCompositeMutationService.js';
+import type { WorkspaceSyncPlanningComment } from '../workspaceSyncModel.js';
+import type { CanonicalPlanningAttachmentLink } from '../planningCanonicalFields.js';
+import type { WorkspaceSyncV3TaskAttachmentLink } from './workspaceSyncV3NestedTaskCodecs.js';
+import type { WorkflowAssignmentSyncRecord } from '../../storage/workflowStore.js';
+import type { TaskRestoreDestination } from '../../shared/taskRestoreDestination.js';
+import type { WorkflowRuntimeMutationCommand } from './workflowRuntimeSync.js';
+import type { WorkspaceSyncV3OriginActor } from './workspaceSyncV3OriginActor.js';
+import type { WorkspaceSyncV3TaskCommentReconcileProvenance } from './taskCommentReconcileProvenance.js';
+import type { WorkspaceSyncEntityEventSnapshot } from '../workspaceSyncModel.js';
+export type { WorkspaceSyncV3OriginActor } from './workspaceSyncV3OriginActor.js';
+type WorkspaceSyncV3OperationEnvelopeBase<TOperation> = {
+    contractVersion: 3;
+    workspaceId: string;
+    clientId: string;
+    operationId: string;
+    operation: TOperation;
+};
+type TaskOperationBase<TMutationKind extends string, TPayload> = {
+    domain: 'task';
+    entityId: string;
+    mutationKind: TMutationKind;
+    baseEntityRevision: string;
+    baseLifecycleRevision: string;
+    payload: TPayload;
+};
+export type WorkspaceSyncV3TaskMetadataEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'metadata-update', {
+    patch: Partial<TaskItem>;
+    saveSource?: 'manual' | 'autosave';
+    originActor?: WorkspaceSyncV3OriginActor;
+}>>;
+export type WorkspaceSyncV3TaskCreateEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'create', {
+    task: Partial<TaskItem>;
+    comments?: Comment[];
+    checklist?: ChecklistItem[];
+    attachments?: WorkspaceSyncV3TaskAttachmentLink[];
+    originActor?: WorkspaceSyncV3OriginActor;
+}> & {
+    baseEntityRevision: '0';
+    baseLifecycleRevision: '0';
+}>;
+export type WorkspaceSyncV3TaskLegacyRootAdoptionEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'create', {
+    adoptedRoot: Partial<TaskItem>;
+}> & {
+    baseEntityRevision: '0';
+    baseLifecycleRevision: '0';
+}>;
+export type WorkspaceSyncV3TaskDeleteEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'delete', {
+    relationships: Array<{
+        entityId: string;
+        baseEntityRevision: string;
+        baseLifecycleRevision: string;
+    }>;
+}>>;
+export type WorkspaceSyncV3TaskRestoreEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'restore', {
+    restoreDestination?: TaskRestoreDestination;
+}>>;
+export type WorkspaceSyncV3TaskLifecycleEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'archive', {
+    cancellation: boolean;
+    reason: string | null;
+    originActor?: WorkspaceSyncV3OriginActor;
+}>> | WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'unarchive', {
+    originActor?: WorkspaceSyncV3OriginActor;
+}>>;
+export type WorkspaceSyncV3TaskWorkflowEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'complete', {
+    originActor?: WorkspaceSyncV3OriginActor;
+}>> | WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'reopen', {
+    assignee: string | null;
+    originActor?: WorkspaceSyncV3OriginActor;
+}>>;
+export type WorkspaceSyncV3TaskStatusEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'set-status', DurableTaskStatusMutationPayload & {
+    workflowAssignment?: WorkflowAssignmentSyncRecord;
+    originActor?: WorkspaceSyncV3OriginActor;
+}>>;
+export type WorkspaceSyncV3WorkflowRuntimeEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
+    domain: 'workflow-execution';
+    entityId: string;
+    mutationKind: 'transition' | 'complete-step';
+    baseEntityRevision: string;
+    baseLifecycleRevision: string;
+    payload: WorkflowRuntimeMutationCommand;
+}>;
+export type WorkspaceSyncV3TaskCommentEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
+    domain: 'task-comments';
+    entityId: string;
+    mutationKind: 'append';
+    baseEntityRevision: string;
+    baseLifecycleRevision: '0';
+    payload: {
+        comment: Comment;
+        originActor?: WorkspaceSyncV3OriginActor;
+    };
+}>;
+export type WorkspaceSyncV3TaskCommentReconcileEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
+    domain: 'task-comments';
+    entityId: string;
+    mutationKind: 'reconcile';
+    baseEntityRevision: string;
+    baseLifecycleRevision: '0';
+    payload: {
+        comments: Comment[];
+        provenance: WorkspaceSyncV3TaskCommentReconcileProvenance[];
+    };
+}>;
+export type WorkspaceSyncV3TaskChecklistEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
+    domain: 'task-checklist';
+    entityId: string;
+    mutationKind: 'replace';
+    baseEntityRevision: string;
+    baseLifecycleRevision: '0';
+    payload: {
+        items: ChecklistItem[];
+        originActor?: WorkspaceSyncV3OriginActor;
+    };
+}>;
+export type WorkspaceSyncV3WorkstreamTaskOrderEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
+    domain: 'workstream-task-order';
+    entityId: string;
+    mutationKind: 'replace';
+    baseEntityRevision: string;
+    baseLifecycleRevision: '0';
+    payload: {
+        taskIds: string[];
+    };
+}>;
+export type WorkspaceSyncV3TaskAttachmentLinksEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
+    domain: 'task-attachment-links';
+    entityId: string;
+    mutationKind: 'replace';
+    baseEntityRevision: string;
+    baseLifecycleRevision: '0';
+    payload: {
+        links: WorkspaceSyncV3TaskAttachmentLink[];
+        originActor?: WorkspaceSyncV3OriginActor;
+    };
+}>;
+export type WorkspaceSyncV3EntityEventLegacyAdoptionEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
+    domain: 'entity-event';
+    entityId: string;
+    mutationKind: 'adopt-legacy-batch';
+    baseEntityRevision: string;
+    baseLifecycleRevision: '0';
+    payload: {
+        events: WorkspaceSyncEntityEventSnapshot[];
+    };
+}>;
+export type WorkspaceSyncV3TaskRelationshipEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
+    domain: 'task-relationship';
+    entityId: string;
+    mutationKind: 'link' | 'unlink';
+    baseEntityRevision: string;
+    baseLifecycleRevision: string;
+    payload: {
+        sourceTaskId: string;
+        targetTaskId: string;
+        type: TaskRelationshipInputType;
+        adoptedRelationship?: TaskRelationshipRecord;
+    };
+}>;
+export type WorkspaceSyncV3TaxonomyEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
+    domain: 'taxonomy';
+    entityId: '__taxonomy_config__';
+    mutationKind: 'replace-state';
+    baseEntityRevision: string;
+    baseLifecycleRevision: '0';
+    payload: {
+        state: NormalizedWorkspaceTaxonomyState;
+    };
+}>;
+export type WorkspaceSyncV3TaxonomyCompositeEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
+    domain: 'taxonomy';
+    entityId: '__taxonomy_config__';
+    mutationKind: 'replace-state-with-task-remaps';
+    baseEntityRevision: string;
+    baseLifecycleRevision: '0';
+    payload: {
+        state: NormalizedWorkspaceTaxonomyState;
+        taskPatches: TaxonomyTaskRemapPatch[];
+    };
+}>;
+export type WorkspaceSyncV3InitiativeMetadataPatch = Partial<{
+    title: string;
+    description: string | null;
+    ownerId: string | null;
+    order: number | null;
+    attachments: CanonicalPlanningAttachmentLink[];
+}>;
+export type WorkspaceSyncV3WorkstreamMetadataPatch = WorkspaceSyncV3InitiativeMetadataPatch & Partial<{
+    initiativeId: string | null;
+}>;
+type PlanningOperationBase<TDomain extends 'initiative' | 'workstream', TMutationKind extends string, TPayload> = {
+    domain: TDomain;
+    entityId: string;
+    mutationKind: TMutationKind;
+    baseEntityRevision: string;
+    baseLifecycleRevision: string;
+    payload: TPayload;
+};
+type PlanningCreateOperation<TDomain extends 'initiative' | 'workstream', TPayload> = PlanningOperationBase<TDomain, 'create', TPayload> & {
+    baseEntityRevision: '0';
+    baseLifecycleRevision: '0';
+};
+type PlanningMutationEnvelope<TDomain extends 'initiative' | 'workstream', TMetadataPatch, TCreatePayload> = WorkspaceSyncV3OperationEnvelopeBase<PlanningCreateOperation<TDomain, TCreatePayload>> | WorkspaceSyncV3OperationEnvelopeBase<PlanningOperationBase<TDomain, 'metadata-update', {
+    patch: TMetadataPatch;
+}>> | WorkspaceSyncV3OperationEnvelopeBase<PlanningOperationBase<TDomain, 'append-comment', {
+    comment: WorkspaceSyncPlanningComment;
+    originActor?: WorkspaceSyncV3OriginActor;
+}>> | WorkspaceSyncV3OperationEnvelopeBase<PlanningOperationBase<TDomain, 'archive', Record<string, never>>> | WorkspaceSyncV3OperationEnvelopeBase<PlanningOperationBase<TDomain, 'unarchive', Record<string, never>>>;
+export type WorkspaceSyncV3InitiativeEnvelope = PlanningMutationEnvelope<'initiative', WorkspaceSyncV3InitiativeMetadataPatch, {
+    title: string;
+    description: string | null;
+    ownerId: string | null;
+    order: number | null;
+    attachments: CanonicalPlanningAttachmentLink[];
+    createdAt: string;
+}>;
+export type WorkspaceSyncV3WorkstreamEnvelope = PlanningMutationEnvelope<'workstream', WorkspaceSyncV3WorkstreamMetadataPatch, {
+    initiativeId: string | null;
+    title: string;
+    description: string | null;
+    ownerId: string | null;
+    order: number | null;
+    attachments: CanonicalPlanningAttachmentLink[];
+    createdAt: string;
+}>;
+export type WorkspaceSyncV3OperationEnvelope = WorkspaceSyncV3TaskMetadataEnvelope | WorkspaceSyncV3TaskCreateEnvelope | WorkspaceSyncV3TaskLegacyRootAdoptionEnvelope | WorkspaceSyncV3TaskDeleteEnvelope | WorkspaceSyncV3TaskRestoreEnvelope | WorkspaceSyncV3TaskLifecycleEnvelope | WorkspaceSyncV3TaskWorkflowEnvelope | WorkspaceSyncV3TaskStatusEnvelope | WorkspaceSyncV3WorkflowRuntimeEnvelope | WorkspaceSyncV3TaskCommentEnvelope | WorkspaceSyncV3TaskCommentReconcileEnvelope | WorkspaceSyncV3TaskChecklistEnvelope | WorkspaceSyncV3WorkstreamTaskOrderEnvelope | WorkspaceSyncV3TaskAttachmentLinksEnvelope | WorkspaceSyncV3EntityEventLegacyAdoptionEnvelope | WorkspaceSyncV3TaskRelationshipEnvelope | WorkspaceSyncV3TaxonomyEnvelope | WorkspaceSyncV3TaxonomyCompositeEnvelope | WorkspaceSyncV3InitiativeEnvelope | WorkspaceSyncV3WorkstreamEnvelope;

package/dist/sync/v3/workspaceSyncV3OperationProtocol.js

@@ -0,0 +1 @@
+export {};

package/dist/sync/v3/workspaceSyncV3OperatorDiagnostics.d.ts

@@ -0,0 +1,165 @@
+import type { DatabaseAdapter } from '../../storage/databaseAdapter.js';
+export interface WorkspaceSyncV3OperatorDiagnosticsInput {
+    db: DatabaseAdapter;
+    tenantId: string;
+    workspaceId: string;
+    runtimeMode: 'local' | 'cloud';
+    env?: NodeJS.ProcessEnv;
+    now?: Date;
+    windowMinutes?: number;
+    eventLimit?: number;
+}
+export interface WorkspaceSyncV3OperatorDiagnosticsSnapshot {
+    success: true;
+    diagnosticsContractVersion: 2;
+    generatedAt: string;
+    queryDurationMs: number;
+    runtimeMode: 'local' | 'cloud';
+    workspaceId: string;
+    evidenceWindow: {
+        since: string;
+        minutes: number;
+        eventLimit: number;
+        eventsExamined: number;
+        truncated: boolean;
+    };
+    coverage: {
+        registered: boolean;
+        owner: 'v2' | 'v3';
+        epoch: string;
+        profileId: string;
+        version: number;
+        digest: string;
+        domains: string[];
+        cursor: {
+            cycleHighWatermark: string | null;
+            lastScannedSequence: string | null;
+        };
+    };
+    repair: {
+        active: boolean;
+        coverageRepairRequired: boolean;
+        snapshotId: string | null;
+        snapshotSequence: string | null;
+        expiresAt: string | null;
+        stagedEntryCount: number;
+        materializationsInWindow: number;
+        materializedEntriesInWindow: number;
+        unexpiredMaterializations: number;
+    };
+    outbox: {
+        captureConfigured: boolean;
+        dispatchConfigured: boolean;
+        automaticSyncEnabled: boolean | null;
+        automaticSyncStateRows: number;
+        activeDepth: number;
+        byStatus: {
+            pending: number;
+            inFlight: number;
+            blocked: number;
+        };
+        oldestActiveCreatedAt: string | null;
+        oldestActiveAgeMs: number | null;
+        captureWithDispatchDisabledBacklog: number | null;
+    };
+    transfers: {
+        scope: 'workspace-client-events-during-v3-cohort';
+        pull: {
+            success: number;
+            error: number;
+        };
+        apply: {
+            success: number;
+            error: number;
+        };
+        server5xx: number;
+        nonTest409: number;
+        requestP95Ms: number | null;
+        maxObservedResponseBytes: number | null;
+    };
+    durability: {
+        coveredJournalHighWatermark: string;
+        operationResultsExamined: number;
+        committed: number;
+        processing: number;
+        committedWithReplayPayload: number;
+        observedReplayCount: null;
+        replayEvidence: 'committed-response-ledger';
+        duplicatePageEvidence: {
+            available: boolean;
+            appliedSnapshotId: string | null;
+            appliedPageDigest: string | null;
+        };
+    };
+    convergence: {
+        evaluation: 'locally-converged' | 'not-converged' | 'cloud-authority-not-comparable';
+        cursorAtCycleHighWatermark: boolean | null;
+        noActiveRepair: boolean;
+        noActiveCoveredOutbox: boolean;
+    };
+    coordinator: {
+        state: {
+            available: boolean;
+            activeWorkspaceId: string | null;
+            generation: number | null;
+            ownershipMode: string | null;
+            transitionState: string | null;
+            updatedAt: string | null;
+        };
+        commands: {
+            active: number;
+            byStatus: {
+                accepted: number;
+                running: number;
+            };
+            oldestActiveRequestedAt: string | null;
+            oldestActiveAgeMs: number | null;
+        };
+        permits: {
+            live: number;
+            byState: Record<string, number>;
+        };
+        recovery: {
+            openObligations: number;
+            oldestOpenCreatedAt: string | null;
+        };
+        contentPull: {
+            openObligations: number;
+            oldestOpenCreatedAt: string | null;
+            attempted: number;
+            lastError: string | null;
+        };
+        attachmentApply: {
+            openObligations: number;
+            dueObligations: number;
+            oldestOpenCreatedAt: string | null;
+            nextAttemptAt: string | null;
+            attempted: number;
+            lastError: string | null;
+        };
+        runner: {
+            available: boolean;
+            generation: number | null;
+            checkpointRevision: number | null;
+            updatedAt: string | null;
+        };
+        readiness: {
+            result: 'pass' | 'fail' | 'not-evaluated-on-cloud';
+            failures: string[];
+            thresholds: {
+                commandQueueOldestActiveAbortMs: number;
+            };
+        };
+    };
+    stage3: {
+        result: 'pass' | 'fail' | 'insufficient-evidence' | 'not-evaluated-on-cloud';
+        failures: string[];
+        unknowns: string[];
+        thresholds: {
+            outboxOldestActiveAbortMs: number;
+            server5xxAbortCount: number;
+            nonTest409AbortCount: number;
+        };
+    };
+}
+export declare function buildWorkspaceSyncV3OperatorDiagnostics(input: WorkspaceSyncV3OperatorDiagnosticsInput): WorkspaceSyncV3OperatorDiagnosticsSnapshot;