ng-eventually/.project/VOCABULARY.md

Project vocabulary — canonical terms: use VERBATIM in any language, marked like this

  «app-contract»
   `reference`       a NURI that names a document and grants nothing — what an application circulates                                  (never: link, lien, share-link · see: contract_polyfill-surface)
   `ReadCap`         upstream's word for what opens a document — a reference carrying its secret                                       (never: token, credential, permission)
   `shape read`      a read whose selector is a ShEx shape, i.e. which predicates an object carries, never a list of documents         (never: typed read, shape-based read, lecture par forme · see: knowledge_what-a-read-scope-is-upstream)
   `document read`   a read selected by naming documents - upstream anchors ONE, so naming several is this package's own composition   (never: bulk read, union read, lecture par document)
   `polyfill-era`    a published symbol with no counterpart in the target SDK, deleted at migration                                    (never: transitional, shim-only · see: knowledge_what-an-app-deletes-at-migration)

  «e2e-harness»
   `journey`         one named end-to-end story in the applicative suite, reported pass or fail as a whole                             (never: scenario, test case, spec)
   `batch`           one run of a suite, which mints its own physical user and discards the previous one                               (never: session, campaign)

  «sign-in»
   `settle`          decide which identity is acting, from the URL, storage, or the barrier — needs no session                         (never: resolve identity, determine user, login · see: knowledge_settling-is-not-connecting)
   `barrier`         the full-screen overlay this package mounts to hand out the wallet and take an identifier                         (never: modal, popup, login screen)