Record FIAM acceptance and clarify shared interface mappings
Assistant: codex Assistant-Model: gpt-6-astra Assistant-Session: 01a087be-d842-7252-81be-2105c4279c87
This commit is contained in:
parent
6c5920e79a
commit
95eb7c9081
10 changed files with 101 additions and 12 deletions
|
|
@ -3,7 +3,7 @@ title: InterfaceCanon Federation Interface Card
|
|||
consumer: interface-canon
|
||||
canon_surfaces: [interface-model]
|
||||
status: draft
|
||||
version: 0.1.1
|
||||
version: 0.1.2
|
||||
owner: interface-canon
|
||||
schema_source:
|
||||
repository: info-tech-canon
|
||||
|
|
@ -13,6 +13,8 @@ peers:
|
|||
relationship: shared-concept upstream; interface-domain extension
|
||||
- repository: facetted-interfaces
|
||||
relationship: FIAM terminology and conformance authority
|
||||
review_record: docs/interface-canon-boundary.md
|
||||
acceptance_manifest: infospace/reviews/acceptance/facetted-interfaces-sources.json
|
||||
- repository: commerce-canon
|
||||
relationship: structural precedent for a focused domain canon
|
||||
exports:
|
||||
|
|
@ -33,7 +35,8 @@ mapping_rules:
|
|||
- FIAM retains ownership of standard semantics, schemas, and conformance.
|
||||
- Local definitions remain FIAM-qualified where upstream names overlap.
|
||||
known_deviations:
|
||||
- Reciprocal cards and federation ownership-ledger acceptance are not yet established.
|
||||
- FIAM accepted draft 0.1.1 derivation and authority boundaries; other acceptance/adoption evidence remains tracked in INTERFACE-WP-0004.
|
||||
- The completed identity/commerce migration ledger is not a universal registration gate.
|
||||
- Evidence records require an explicit assertion/source mapping, not a direct alias.
|
||||
expectations:
|
||||
- Review source changes and retain commit and content-hash provenance.
|
||||
|
|
|
|||
|
|
@ -15,7 +15,7 @@ This is a draft local mapping; no upstream ownership transfer is asserted.
|
|||
| Assertion | ITC-GOV Assertion | FIAM specializes architectural property/relation assertions with evidence and polarity. |
|
||||
| FIAM evidenceRecord | Map to ITC-EVID Evidence plus Evidence Source | FIAM evidenceRecord is support metadata with source, mode and confidence. ITC Evidence is an assertion drawn for a question; source container is separately identified. This is not a one-to-one rename. |
|
||||
| Evidence score | ITC-EVID Evidence strength | A FIAM Lens computes a policy-specific heuristic; confidence and support scores are not universal truth probabilities. |
|
||||
| Artifact | FIAM describing/implementing artifact role | It may serve as ITC Evidence Source when addressable and versioned; the artifact is not the assertion drawn from it. |
|
||||
| Artifact | FIAM describing/implementing artifact role | It may serve as ITC Evidence Source when addressable and versioned/captured where mutable; the Evidence assertion must state its explicit interest. Implementing a contract does not automatically make an artifact a KnowledgeArtifact. |
|
||||
| Zone / security profile | Reference FIAM contextual classifications | No transfer of generic network, security, trust, tenant, or authorization ownership. |
|
||||
| Policy / decision | ITC-GOV Policy / Decision | A Lens finding is an interpretation, not automatically a governed decision or authorization. |
|
||||
|
||||
|
|
@ -33,3 +33,17 @@ mappings, not automatic equivalence or ownership transfers.
|
|||
|
||||
The initial review is complete. External federation acceptance and evidence of
|
||||
consumer adoption remain in INTERFACE-WP-0004; publication stays draft.
|
||||
|
||||
## Owner-review clarifications
|
||||
|
||||
Network Port covers physical/device ports as well as protocol-level transport
|
||||
ports; the TCP example is illustrative, not exhaustive. Resource/shape mappings
|
||||
establish neither universal subtyping nor exact equivalence. Describing artifacts
|
||||
may qualify as KnowledgeArtifact; implementation artifacts do not qualify merely
|
||||
because they implement a contract. Evidence Source is the addressable container,
|
||||
with version/capture where mutable; Evidence states the assertion and explicit
|
||||
interest. These clarifications preserve the imported source meanings.
|
||||
|
||||
Acceptance scope and source revisions are recorded in the
|
||||
[acceptance report](../reviews/acceptance/README.md). Earlier owner reviews target
|
||||
0.1.1; the local clarification revision is draft 0.1.2.
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ title: InterfaceCanon Interface Model
|
|||
namespace: interface-model
|
||||
type: domain-model
|
||||
status: draft
|
||||
version: 0.1.1
|
||||
version: 0.1.2
|
||||
imports: [itc-land, itc-ident, itc-evid, itc-gov, itc-data, itc-infospace, itc-net]
|
||||
import_manifest: imports.json
|
||||
source_manifest: ../../assimilation/fiam/sources.json
|
||||
|
|
@ -27,7 +27,8 @@ in the [pinned FIAM package](../../assimilation/fiam/README.md).
|
|||
An owned architectural participation point through which a participant or system node offers or requires a particular interface contract.
|
||||
|
||||
An offer/require mode is contract participation, not message direction. This Port
|
||||
is distinct from ITC-NET Port: TCP port 8000 is a transport selector.
|
||||
is distinct from ITC-NET Port. Network profiles distinguish physical/device
|
||||
ports from protocol-level transport ports; TCP port 8000 is one transport example.
|
||||
|
||||
Source: `#/$defs/port`. Local identifier: `interface-model:port`.
|
||||
|
||||
|
|
|
|||
37
infospace/reviews/acceptance/README.md
Normal file
37
infospace/reviews/acceptance/README.md
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
# Owner acceptance evidence
|
||||
|
||||
Workplan: INTERFACE-WP-0004. Checked 2026-09-09 against repository Git records
|
||||
as well as Statehub threads. Acceptance can be evidenced by an owner-repository
|
||||
record before a message reply arrives; uncommitted files are not a pinned receipt.
|
||||
|
||||
| Owner | Evidence | Status and scope |
|
||||
| --- | --- | --- |
|
||||
| facetted-interfaces | [Pinned acceptance source](facetted-interfaces-sources.json), commit cceb005c9cacbc1705c7a3f8e7367255de8a5731 | Codex acting for FIAM accepted draft 0.1.1 derivation fidelity and authority boundaries. No blocking semantic corrections; no stable promotion or runtime certification. |
|
||||
| info-tech-canon | `infospace/interfaces/interface-canon-boundary.md` observed in the peer checkout | Agent acceptance text and clarifications are present, but the file has no containing commit at this check. Await a committed review record before counting T01 complete. |
|
||||
| repo-manager | No `docs/interface-canon-statehub-consumer.md` or other InterfaceCanon adoption reference found in docs/workplans/README at this check | Consumer-owned adoption remains pending; T02 stays open. |
|
||||
|
||||
## Implemented clarifications
|
||||
|
||||
Draft 0.1.2 makes explicit that Network Port includes physical/device and
|
||||
transport ports; the existing TCP example did not enumerate the full scope.
|
||||
Mappings also clarify version/capture for mutable evidence containers, the explicit
|
||||
interest required for Evidence, and that implementing a contract does not
|
||||
necessarily make an artifact a KnowledgeArtifact. Resource/shape mappings remain
|
||||
context-dependent, with no universal subtyping or equivalence claim.
|
||||
|
||||
These clarifications agree with the already pinned ITC-NET, ITC-EVID, and
|
||||
ITC-INFOSPACE definitions. They were prompted by the visible InfoTechCanon review,
|
||||
but are supported independently by those committed imports. We do not represent
|
||||
the uncommitted peer file as a finalized revision.
|
||||
|
||||
The FIAM review targets InterfaceCanon commit
|
||||
`1fc82ec6655ed286cea3be284e33d08e7b27edc3` / model 0.1.1. It is not a claim
|
||||
that FIAM separately reread the local 0.1.2 clarification revision. The original
|
||||
FIAM standard pins and all shared-model import pins remain unchanged.
|
||||
|
||||
## Remaining work
|
||||
|
||||
T01 needs the committed InfoTechCanon boundary record; FIAM's part is recorded.
|
||||
T02 needs consumer-owned adoption evidence and a publication assessment. Keep
|
||||
both tasks open and the model/card draft. The migration ledger remains outside
|
||||
this extension's acceptance scope.
|
||||
|
|
@ -0,0 +1,14 @@
|
|||
{
|
||||
"schema_version": 1,
|
||||
"source_repository": "facetted-interfaces",
|
||||
"source_commit": "cceb005c9cacbc1705c7a3f8e7367255de8a5731",
|
||||
"sources": [
|
||||
{
|
||||
"path": "docs/interface-canon-boundary.md",
|
||||
"sha256": "00763784d23e049fdc7732a029cae62ebf1c3e739f2113fe06629efb3a4d4a52"
|
||||
}
|
||||
],
|
||||
"reviewed_interface_commit": "1fc82ec6655ed286cea3be284e33d08e7b27edc3",
|
||||
"reviewed_model_version": "0.1.1",
|
||||
"acceptance_scope": "draft derivation fidelity and authority boundary; no stable promotion or runtime conformance"
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue