Skip to content

v0.1.0-alpha.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@michaelegner michaelegner released this 27 Aug 09:41
· 84 commits to main since this release
v0.1.0-alpha.1
4230f59

v0.1.0-alpha.1 release notes (12G Phase 1, step 12)

Project status: Experimental / Alpha
License: Apache-2.0

This is the first public pre-release, cut specifically to validate the complete release pipeline
(GitHub Actions, CodeQL, GHCR publishing) before promoting to v0.1.0. Expect the occasional rough
edge — that's exactly what this tag exists to surface.

Highlights

  • OpenAPI ingestion (REST provider extraction)
  • AsyncAPI queue topology (send/receive, DLQ mapping)
  • Architecture Manifest adapter (the one thing OpenAPI can't express: who calls a REST operation)
  • Evidence/provenance — every architecture fact is persisted with a traceable source
  • Five deterministic architecture analyses (no LLM): queue senders/consumers, orphan queues,
    mixed sync/async blast radius
  • Semantic query validation (Graph Schema + Cypher validator) for the optional natural-language
    query layer
  • OpenTelemetry runtime discovery — /v1/traces OTLP ingestion, resolved against declared
    architecture
  • Declared vs. observed architecture comparison: CONFIRMED / OBSERVED_ONLY /
    NOT_OBSERVED_IN_WINDOW
  • Architecture drift detection — undocumented dependencies surface as OBSERVED_ONLY findings
  • Runtime evidence reconciliation — removing a stale declaration degrades a relation to
    OBSERVED_ONLY, never silently deletes it
  • Cross-batch HTTP correlation — a CLIENT span and its matching SERVER span can arrive in separate
    OTLP requests and still resolve to one observed dependency

Known limitations

  • Pre-1.0 — the Canonical Model, REST API, Graph Schema, Adapter SPI, and configuration format are
    not yet guaranteed stable (see ROADMAP.md).
  • No Kubernetes/cloud discovery yet (planned for v0.2).
  • The natural-language query layer requires an LLM provider API key; everything else works without
    one.

Quick Start

git clone https://github.com/michaelegner/architecture-intelligence-platform.git
cd architecture-intelligence-platform
docker compose up

Then open http://localhost:8000. See README.md for the full Quick Start and the Collector-based
runtime demo.

Documentation

docs/ — architecture, canonical model, graph/evidence model, OpenTelemetry, security model,
adapter development, and more. docs/adr/ for the reasoning behind the core design decisions.

Security

See SECURITY.md — please report vulnerabilities via GitHub's private vulnerability reporting, not
as a public issue.

Assets 2
Loading