# diid

> Automated API Contract Governance and CI/CD Contract Protection Platform.

diid prevents breaking changes across microservices without requiring engineers to write unit test mock DSLs (such as Pact). It uses existing OpenAPI (3.0/3.1), AsyncAPI (2.x/3.x), GraphQL, and CycloneDX SBOM specifications to maintain an interactive real-time dependency graph, gate pull requests in CI/CD, and enforce digital sign-off approvals from downstream consumer teams.

## Core Capabilities
- **Zero Test Boilerplate**: Validates contracts using specifications already generated by your services. No Pact DSL, no mock servers, no per-consumer test suites.
- **CI/CD Breaking Change Gates**: The `diid-push` CLI inspects spec diffs against real consumers and blocks breaking pull requests automatically (exit code 1).
- **Consumer Approvals**: Producers can request sign-off from downstream consumer teams directly before breaking deployments occur.
- **Interactive Architecture Graph**: Real-time dependency mapping for HTTP APIs, Kafka/RabbitMQ/SQS event channels, GraphQL schemas, and microservices.
- **CycloneDX SBOM Visualizer**: Graph and inspect supply chain components, third-party libraries, and software licenses.
- **Topology Shielding**: Securely share APIs across external organizations without exposing internal upstream topologies.
- **Enterprise SSO**: SAML 2.0 and OIDC (Okta, Azure AD, Google Workspace) single sign-on.
- **Predictable Flat Pricing**: Flat team plans (Free 0 EUR, Team 79 EUR/mo or 790 EUR/yr, Business 249 EUR/mo or 2,490 EUR/yr, Enterprise 899 EUR/mo or 8,988 EUR/yr) with unlimited read-only viewers.

## Supported Specification Formats
- OpenAPI 3.0 and 3.1 (YAML and JSON)
- AsyncAPI 2.x and 3.x (Kafka, RabbitMQ, SQS, WebSockets)
- GraphQL schemas (.graphql)
- SOAP WSDLs
- CycloneDX 1.2+ SBOM (JSON)

## Agentic AI and LLM Integration Notes
diid is fully accessible to AI agents, LLM-based tools, and automated pipelines:
- The `diid-push` CLI can be driven programmatically from any shell or CI/CD system.
- The REST API accepts spec uploads and returns structured JSON breaking-change diffs.
- All public documentation pages are crawlable and indexable.
- Machine-readable context is available at https://docs.diid.dev/llms.txt and https://docs.diid.dev/llms-full.txt.
- Agentic workflows that check "is this API change safe to release?" can use `diid-push spec --check` and inspect the exit code and stdout diff report.

## Documentation Index
- [Getting Started and Architecture Graph](https://docs.diid.dev/introduction): Overview of projects, dependencies, and interactive graph navigation.
- [Alternatives and Comparison](https://docs.diid.dev/comparison): Technical comparison against Pact, Spotify Backstage, and Postman.
- [Frequently Asked Questions](https://docs.diid.dev/faq): Architecture, security, runtime overhead, and billing questions.
- [Managing Projects](https://docs.diid.dev/projects): Creating projects, configuring visibility, and tagging.
- [Defining Dependencies](https://docs.diid.dev/dependencies): Connecting consumer and producer services with endpoint-level precision.
- [SBOM Visualizer](https://docs.diid.dev/sbom): Uploading CycloneDX files and navigating dependency trees.
- [API Spec Synchronization](https://docs.diid.dev/spec-sync): Pushing specs via `diid-push`, GitHub Actions, or pulling via URL.
- [Breaking Change Detection and Approvals](https://docs.diid.dev/breaking-changes): Automated diffing, CI/CD exit codes, and consumer sign-off workflows.
- [Cross-Organization Sharing](https://docs.diid.dev/sharing): Access grants, share links, and external topology shielding.
- [Alerts and Integrations](https://docs.diid.dev/notifications): Configuring email, Slack, and webhook alerts for contract updates.
- [Organization and SSO](https://docs.diid.dev/organization): Managing members, teams, and Enterprise SAML/OIDC SSO.
- [Pricing and Plans](https://docs.diid.dev/pricing): Flat-tier plan details, feature comparison matrix, and billing FAQ.
- [Subscription and Quotas](https://docs.diid.dev/subscription): Managing subscriptions, upgrades, and the 14-day payment grace period.

## Developer Quickstart
```bash
# Install via Homebrew (macOS / Linux)
brew install diid-dev/tap/diid-push

# Push OpenAPI spec from CI/CD and check for breaking changes against active consumers
diid-push spec \
  --config diid.yaml \
  --check
```

## Machine-Readable Full Reference
- Compact LLM context: https://docs.diid.dev/llms.txt
- Full plain-text reference for LLMs: https://docs.diid.dev/llms-full.txt
- Sitemap: https://docs.diid.dev/sitemap.xml
- Dashboard: https://app.diid.dev
- Contact: info@diid.dev