Skip to content
ContractSpec
Start here

reference

Read an exact Company Brain edition

field.key.label
company-intelligence-brain-edition-read
field.version.label
field.type.label
field.title.label
Read an exact Company Brain edition
field.tags.label
field.owners.label
field.stability.label
public

The additive companyIntelligence.brain.edition.get@1.0.0 query reads one exact edition from an independently authorized workspace. Its GET adapter is /api/companyos/company-intelligence/v1/brain/edition. All four edition identity fields and the workspace are required; unknown fields, partial pins and malformed versions or fingerprints refuse.

The result carries the verified edition reference and only the existing public Brain entry projection. Before disclosure the host verifies current tenant/workspace authority, exact persisted edition and entry versions, fingerprints, permitted fields and current withdrawal. The host checks the canonical source record, evidence, fragment and policy dependencies of each selected entry version and its current version independently under current scoped source authority. A withdrawn dependency denies the edition, including a dependency reached through a canonical source record. A selected edition, prior receipt or generated schema grants no access.

The original native read proves physical colocation with the actual data transaction using its backend PID and a private advisory-lock challenge observed in the same database lock manager. It runs the pinned reader on the native transaction connection and binds the server/database identity for final release. The runtime connection must use a direct constrained login, with identical session/effective user and no SET ROLE context. The already serialized HTTP response result must match that exact reader evidence; the final fence requires the identical Response object.

The native edition response is released only after one successful READ COMMITTED organization-authority transaction holds the genuine credential/identity, CompanyOS product-admission, canonical organization and locked context/team/workspace authority together with sorted, versionless logical-entry shared locks. That same transaction reruns the exact pinned reader against current entry eligibility and redaction. The host repeats the genuine locked native context and current credential/admission checks after the repository's canonical organization reproof, and awaits the common COMMIT before returning the already prepared response. A store, placement, role, lock, abort or COMMIT failure releases no body. The canonical Brain table must be colocated on that actual transaction connection, FORCE RLS, and protected by the enabled canonical raw-INSERT entry fence; matching database configuration strings do not establish this condition. Missing qualified placement is unavailable, never a sequential fallback.

The release is authorized by the successful common transaction with all mutation locks held through COMMIT. The final native check uses database clock time for credential and entitlement expiry; it is not a promise of physical byte-delivery-time freshness or an instantaneous wall-clock test inside the driver's COMMIT. Revocations committed after that transaction are later in the serial order. This is a corrective strengthening of the existing disclosure policy with unchanged query/result schemas and operation version. This read authorizes no action or external effect.

The existing unpinned /brain compatibility read is unchanged and does not establish an exact edition read. Generated contracts, registered runtime bindings, scoped reads and authenticated host mounts require separate evidence.