CDI-SPEC-001: Callable Data Infrastructure
Travis L. Guckert
LeMay Publishing
STANDARDS
CDI-SPEC-001: Callable Data Infrastructure
API Standard14,024 words129 chapters
Published by LeMay Publishing. 14,024 words across 129 chapters.
About This Publication
Formal specification for Callable Data Infrastructure, making certified knowledge accessible to all reasoning engines.
Published by LeMay Publishing, a division of LeMay. Massachusetts.
ISBN: 979-8-0000-5001-9
Chapters
1CDI-SPEC-001
2Callable Data Infrastructure
3Formal Specification for Making Certified Knowledge Accessible to All Reasoning Engines
4NOTICE TO IMPLEMENTERS
5TABLE OF CONTENTS
6LIST OF FIGURES AND TABLES
7FOREWORD
8ACKNOWLEDGMENTS
9PART I — FOUNDATION
10CHAPTER 1: INTRODUCTION AND SCOPE
111.1 Purpose
121.2 Problem Statement
131.3 Scope
141.4 Intended Audience
151.5 Relationship to Other Standards
16CHAPTER 2: TERMINOLOGY, DEFINITIONS, AND CONVENTIONS
172.1 Normative Keywords
182.2 Definitions
192.3 Notational Conventions
202.4 Canonical URIs
21CHAPTER 3: ARCHITECTURAL OVERVIEW
223.1 Architectural Principles
233.2 Architectural Components
243.3 Request-Response Lifecycle
253.4 Deployment Topologies
26CHAPTER 4: DESIGN PRINCIPLES AND CONSTRAINTS
274.1 Minimality
284.2 Determinism
294.3 Immutability of Certified Knowledge Units
304.4 Opacity of Reasoning
314.5 Idempotency
324.6 Statelessness
334.7 Graceful Degradation
34PART II — CORE SPECIFICATION
35CHAPTER 5: THE CDI DATA MODEL
365.1 The Knowledge Unit
375.2 Identity Envelope
385.3 Content Payload
395.4 Structural Metadata
405.5 Certification Metadata
415.6 Provenance Metadata
425.7 Temporal Metadata
435.8 Relational Metadata
445.9 Extension Metadata
45CHAPTER 6: THE CALL INTERFACE
466.1 Overview
476.2 Standard Methods
486.3 `cdi.retrieve`
496.4 `cdi.search`
506.5 `cdi.enumerate`
516.6 `cdi.describe`
526.7 `cdi.validate`
536.8 `cdi.resolve`
54CHAPTER 7: KNOWLEDGE CERTIFICATION AND PROVENANCE
557.1 Purpose of Certification
567.2 Certification Levels
577.3 Certification Authority Requirements
587.4 Certification Signatures
597.5 Certification Lifecycle
607.6 Provenance Requirements
61CHAPTER 8: TRANSPORT BINDINGS
628.1 Binding Architecture
638.2 HTTP/JSON Binding (Normative)
648.3 gRPC/Protobuf Binding (Informative)
658.4 Message Queue Binding (Informative)
66CHAPTER 9: SECURITY MODEL
679.1 Security Objectives
689.2 Security Levels
699.3 Transport Security
709.4 Authentication
719.5 Authorization
729.6 Content Integrity
739.7 Audit Logging
74CHAPTER 10: ERROR HANDLING AND DIAGNOSTICS
7510.1 Error Model
7610.2 Standard Error Codes
7710.3 Diagnostics
7810.4 Retry Semantics
79PART III — CONFORMANCE AND GOVERNANCE
80CHAPTER 11: CONFORMANCE REQUIREMENTS
8111.1 Conformance Levels
8211.2 Conformance Assertion
8311.3 Conformance Testing
8411.4 Partial Conformance
8511.5 Conformance and Extensions
86CHAPTER 12: EXTENSION MECHANISMS
8712.1 Design Philosophy
8812.2 Extension Namespaces
8912.3 Extension Fields
9012.4 Extension Methods
9112.5 Extension Discovery
9212.6 Community Extensions
93CHAPTER 13: VERSIONING AND LIFECYCLE
9413.1 Specification Versioning
9513.2 Version Negotiation
9613.3 Deprecation Policy
9713.4 Lifecycle Stages
98CHAPTER 14: GOVERNANCE AND MAINTENANCE
9914.1 Governance Board
10014.2 Change Process
10114.3 Errata
10214.4 Intellectual Property
10314.5 Contact
104PART IV — APPENDICES
105APPENDIX A: FORMAL GRAMMAR (ABNF)
106A.1 Knowledge Unit Identifier
107A.2 Version Identifier
108A.3 Query Language
109A.4 Error Code
110A.5 Certification Signature Input
111APPENDIX B: JSON SCHEMA DEFINITIONS
112B.1 Knowledge Unit Schema
113B.2 CDI Response Envelope Schema
114APPENDIX C: REFERENCE IMPLEMENTATION NOTES
115C.1 CDI Client Implementation
116C.2 CDI Endpoint Implementation
117C.3 Performance Considerations
118C.4 Migration from Existing APIs
119APPENDIX D: MAPPING TO EXISTING STANDARDS
120D.1 W3C PROV Mapping
121D.2 Dublin Core Mapping
122D.3 DOI Integration
123D.4 OpenAPI Specification Mapping
124APPENDIX E: GLOSSARY
125BACK MATTER
126BIBLIOGRAPHY AND NORMATIVE REFERENCES
127Normative References
128Informative References
129INDEX OF NORMATIVE REQUIREMENTS