FR-001checkpassingAn observation MUST be {at, provider, account, assets, posture, gaps, entities?, records?}, with gaps typed (denied, unavailable, partial, entity-kind-not-declared) and posture values scalar.
0005-integrations-observe · owner if · domain commons
FR-001checkpassingAn observation MUST be {at, provider, account, assets, posture, gaps, entities?, records?}, with gaps typed (denied, unavailable, partial, entity-kind-not-declared) and posture values scalar.
FR-002checkpassingA record MUST be {label, ocsf_class_uid, native_id, display_name, props, unmapped?}, and entities MUST be people, accounts, devices and repositories as typed products.
FR-003checkpassingA Connector MUST have describe, probe and observe as methods and check for its policies; describe MUST be derived from the governance so that it cannot differ, and MUST hold no credential value.
FR-004checkpassingdefineConnector MUST refuse governance with a problem and a policy id twice, and MUST wrap observe so that governance is enforced on what any connector returns.
FR-005checkpassingEnforcement MUST remove from every record's properties and unmapped data each field the denylist denies, and MUST remove an entity kind the connector did not declare and name it as a gap, whatever the connector returned.
FR-006checkpassingA posture policy MUST be data in the vocabulary of GRC (@intellectual-frontiers/grc): an id, a title, the fact, an Expectation and a Severity of GRC, the status a miss has, the control urns it bears on and a fix; evaluatePolicy MUST be total and give a GRC Status: pending where the fact was not observed, else GRC's own evaluation (a pass, the status of a miss, or error).
FR-007checkpassingEvery connector MUST have the policy observation-fresh, failing where the observation is older than its cadence allows.
FR-008checkpassingA persisted observation MUST be a document with kind and schema; reading one of another kind or schema, or a field of the wrong type, MUST be an error with its path.
FR-009checkpassingA source MUST be pinned to https://...@<tag or 40-hex commit> and a branch MUST be refused; a registry entry MUST hold the id, title, pinned source, SHA-256, the contract version and when it was added.
FR-010checkpassingThe lock MUST be a persisted document (kind and schema) whose entries are in the order of their ids, and reading it MUST refuse an id twice, an id or digest that is not one, and a contract version that is not this one.
FR-011checkpassingverifyCopy MUST accept a copy whose digest is the pin and refuse any other, naming both digests, and an id the registry does not have.
salary property, When it is observed, Then the property is not in the observation, per FR-005.https://example.test/c@main, When it is pinned, Then it is refused as a branch, per FR-009.integrations-github is its own package.ReadPort; credentials are applied at the edge.SC-001success criterionWhatever a connector does, what it returns obeys its governance.