Skip to content

[Devbook drift] .devbook/arc42/05-building-block-view.md#cloud-service #885

Closed

Description

@JSdotNet

Scheduled Devbook verify run, 2026-09-30 (devbook:verify-change, kind building-block).

Chapter Counterpart Resolved via Verdict
.devbook/arc42/05-building-block-view.md#cloud-service src/Modules/Sync/Backlog.Modules.Sync{,.Abstractions,.Api}, src/Infrastructure/Backlog.Infrastructure.Cosmos, src/Infrastructure/Backlog.Infrastructure.BlobStorage building-block view code-ahead

Evidence: The documented parts hold. The Sync.Api → Sync/Cosmos/BlobStorage edges exist. ITaskReplica and IAttachmentStore are in Modules.Sync/Ports with in-memory Adapters. Only Cosmos and BlobStorage reference their SDKs. SyncAttachmentOptions.SectionName = "Modules:Sync:Attachments". There is no webhook, FCM or WoL code, which matches "not built yet". The code also carries what the section omits: the ISessionReplica and IAnnotationReplica ports, the sessions and annotations Cosmos containers (AppHost lines 265-266, CosmosOptions), and the /sessions, /annotations, /inbox and /inbox/{id}/ack routes (SyncRoutes).

Detail

  • src/Modules/Sync/Backlog.Modules.Sync/Ports/ISessionReplica.cs and IAnnotationReplica.cs (with Adapters/InMemorySessionReplica.cs and InMemoryAnnotationReplica.cs) are replication ports the section does not name. It describes only ITaskReplica, IAttachmentStore, the device registry and pairing codes.
  • The AppHost declares five Cosmos containers: tasks, sessions, annotations, devices, pairingCodes. Infrastructure.Cosmos/CosmosOptions.cs has SessionsContainerName and AnnotationsContainerName. The section names only three.
  • The Sync API serves routes the section does not list: SessionSyncEndpoints (/api/sync/sessions), AnnotationSyncEndpoints (/api/sync/annotations) and InboxEndpoints (/api/sync/inbox, /inbox/{id}/ack), all under PairedDevice authorization.
  • The section says the cloud stores "never domain data", but session and annotation replicas are now held in the cloud. Local ADR 0011 records annotations as a third replica container.

Action: run devbook:capture-specs (kind building-block) over .devbook/arc42/05-building-block-view.md#cloud-service and carry the plan in through flow-spec.

Read-only: nothing was run or written. The chapter carries no draft or proposed status, and no open pull request or change names it.

Activity

  1. added
    devbook-driftA devbook chapter and its code have drifted apart
    automatedOpened by an unattended scheduled run
    documentationImprovements or additions to documentation
    triagedClassified by the issue sweep
    in-progressA worker session is actively working this issue
    on Sep 30, 2026
  2. self-assigned this
    on Oct 5, 2026
  3. JSdotNet commented on Oct 5, 2026

    @JSdotNet
    OwnerAuthor

    The issue sweep (2026-10-05) opened draft #1000. Read its What could not be proved section before marking it ready.

  4. removed
    in-progressA worker session is actively working this issue
    on Oct 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

automatedOpened by an unattended scheduled rundevbook-driftA devbook chapter and its code have drifted apartdocumentationImprovements or additions to documentationtriagedClassified by the issue sweep

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions