Skip to content

v0.1.0

Choose a tag to compare

View all tags
@michaelegner michaelegner released this 27 Aug 13:25
· 73 commits to main since this release
v0.1.0
d918407

Project status: Experimental / Alpha
License: Apache-2.0

First v0.1.0 release, superseding v0.1.0-alpha.1/v0.1.0-alpha.2. Two alpha releases were cut
first specifically to validate the release pipeline itself (fresh clone, fresh runtime demo, a
pulled GHCR image, a fully independent smoke test) before this tag — see docs/release-validation/
for the full evidence trail and the GO/NO-GO decision record.

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

Changed since v0.1.0-alpha.2

Nothing functional — this tag exists to promote the already-verified v0.1.0-alpha.2 state
(commit 65264a12, plus this session's release-readiness documentation) to the non-prerelease
v0.1.0 tag. See CHANGELOG.md for the full alpha.1/alpha.2 change history that led here.

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
cp .env.example .env
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.
docs/release-validation/ for exactly what's been verified about this release and how, including
the GO/NO-GO decision record.

Security

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

Assets 2
Loading