Files
cairnobs/docs/compliance/license-audit-report.md
jcoffey-dev f756a9d4f6 Rename the project spec and update every reference to it
The charter file carried a tool-specific name while being the repository's own
document: mission, non-negotiable constraints, the pinned stack, repo
conventions and phase status, cited as authority by thirty files across the
agent, api, deploy, docs, search and terraform trees.

PROJECT-SPEC.md says what it is. All 42 references are updated in the same
commit, including the relative link in docs/status.md, so nothing points at a
filename that no longer exists.
2026-08-28 15:57:12 -07:00

24 KiB

License compliance audit report — Phase 6

This report is a strong first pass, not a legal opinion. It should be reviewed by actual legal counsel before the project is publicly released, pitched to customers, or used as the basis for any compliance claim. Nothing in this document should be represented to a third party as legal advice or a certified compliance determination.

Scope and goal

Every component in the monorepo — /agent, /transport, /ingest, /storage, /api, /web, /cli, /deploy, and enterprise/ — is licensed AGPLv3, with no separate commercial-license carve-out anywhere in the project. This audit inventories every third-party dependency across every language ecosystem, classifies each for AGPLv3 compatibility, resolves or explicitly flags anything that doesn't resolve cleanly, and stands up CI enforcement so this doesn't need to be manually re-audited from scratch every time a dependency changes.

This is a compatibility audit, not a "replace every permissively licensed library" exercise. MIT, Apache-2.0, BSD, and ISC dependencies are all fine to depend on from AGPLv3 code. The concern is dependencies with licenses that are genuinely incompatible, impose unaccounted-for obligations, or aren't open source at all (source-available licenses like BSL/SSPL, anything with a field-of-use or non-compete restriction).

Methodology

  1. Inventory every dependency, direct and transitive, in every language ecosystem present in the repo:
    • Rust (agent workspace: cairnobs-agent, cairnobs-parser; search): cargo-deny (cargo deny list --format tsv), installed fresh for this audit (cargo install cargo-deny --locked).
    • Go (api, ingest, alerting, enterprise, deploy/operator, terraform, proto, hack/benchmark-fixture, hack/windows-fixture — every module with real third-party dependencies; cli, hack/webhook-sink, and hack/alert-load-test are stdlib-only, confirmed by inspecting their go.mod files, not scanned): go-licenses (google/go-licenses, installed via go install ...@latest), go-licenses csv ./... per module.
    • npm (web): license-checker (npx license-checker --json).
    • Vendored/non-manifest content: a repo-wide grep for copy/attribution markers ("adapted from", "copied from", "stackoverflow", stray copyright headers, "vendored") — zero hits. A separate pass for binary/asset files (fonts, icons, images) outside node_modules/build output — two font files and one SVG found, see below. Docker base images referenced in docker-compose.yml were pulled out and reviewed manually, since they're not a language-ecosystem dependency any of the three scanners above would see.
  2. Classify every distinct license found into: (a) clearly compatible as a dependency, (b) requires a closer look, (c) actually incompatible or non-open-source. Every (b)/(c) result is cited with real reasoning below, not asserted.
  3. Named risk areas (Redpanda's licensing history, ClickHouse client libraries, Phase 5 font/asset files, Kubernetes Operator tooling) checked explicitly, against primary sources (actual license files at the actual pinned versions/tags), not general recollection.
  4. Remediation options recorded for every (c)/unresolved-(b) item — fix, isolate, or flag for a business decision. Nothing was silently swapped.
  5. Own license declarations audited: root LICENSE file, per-ecosystem manifest license fields, and a repo-wide check for any file still claiming a license other than AGPLv3.
  6. enterprise/ relicensed to AGPLv3, closing the former commercial-license carve-out project-wide.
  7. CI enforcement stood up so this audit's findings don't silently go stale.

Inventory summary

Full machine-readable inventory: /docs/compliance/license-inventory.csv and .json (columns: component, dependency, version, license, direct_or_transitive, ecosystem, flagged, flag_reason, classification).

Ecosystem Component-scoped rows Unique dependencies Flagged (unique)
Rust (cargo) 440 4
Go 255 9 (segmentio/asm + 8 HashiCorp MPL-2.0 packages)
npm 75 3
Docker base images 3 3 1 (Redpanda)
Font/vendored assets 3 3 1 (favicon)
Total 776 502 23 (~4.6%)

Rows double-count dependencies shared across multiple components by design (e.g. pgx appears once per Go module that imports it) — that's what makes the component column meaningful. All 502 unique dependencies resolved to classification (a) except one: Redpanda, classification (c), recorded below with remediation options rather than resolved unilaterally.

Classification results

774 of 776 rows (all but Redpanda and the favicon asset) classify as (a): clearly compatible. No dependency in this project's tree required a genuine (b)-category deep-dive that didn't resolve cleanly — every item that looked ambiguous at first pass (dual-licensed with a copyleft option, a non-standard license file, an unfamiliar SPDX identifier) turned out, on actual inspection, to resolve to (a) once read carefully. That's a real result of doing the reading, not an assumption going in — recorded below per item so the reasoning is checkable.

Dual/multi-licensed crates electing a permissive branch (Rust)

Four Rust crates carry an SPDX OR expression that includes a copyleft/less-common option alongside a permissive one. Standard practice for a disjunctive license grant is that the downstream user elects whichever listed option they prefer — we elect the permissive branch in every case, incurring zero copyleft obligation:

Crate License expression Elected Note
r-efi MIT OR Apache-2.0 OR LGPL-2.1-or-later MIT/Apache-2.0 Build-dependency only (via tonic-buildprost-buildtempfilegetrandom), for a UEFI target this project doesn't build for — doesn't even ship in a release artifact.
fastdivide MIT OR zlib-acknowledgement MIT
htmlescape Apache-2.0 / MIT / MPL-2.0 Apache-2.0/MIT MPL-2.0 would also have been fine on its own merits (see below).
ryu Apache-2.0 OR BSL-1.0 Apache-2.0 BSL-1.0 here is the Boost Software License — permissive, unrelated to Redpanda's Business Source License below despite the shared abbreviation.

MPL-2.0 (Go, npm, and one Rust option above)

MPL-2.0 is file-level (weak) copyleft: modifications to MPL-covered files must stay available under MPL if distributed, but combining MPL-covered code into a larger differently-licensed work — including an AGPLv3 work — does not require the larger work to relicense (MPL 2.0 §3.3, "Distribution of a Larger Work"). Pre-cleared as category (a) per this audit's own scope definition. Found in:

  • Go (/terraform only, HashiCorp's Terraform provider SDK and its own dependencies): go-plugin, go-uuid, terraform-plugin-framework, terraform-plugin-go, terraform-plugin-log, terraform-registry-address, terraform-svchost, yamux. Lower risk still than the general case: /terraform is its own standalone Go module producing a Terraform provider plugin binary, not linked into any core service.
  • npm: axe-core (dev-only, used for the Phase 5 accessibility sweep, never shipped), lightningcss + its platform-specific native binary (a transitive dependency of Vite's CSS pipeline — build-time only, never bundled into web's shipped static output).

segmentio/asm — tool detection gap, not a real license question (Go)

go-licenses reported Unknown for every sub-package of github.com/segmentio/asm (a transitive dependency via the ClickHouse Go driver). Its actual LICENSE file (read directly from the module cache) is headed "MIT No Attribution" — SPDX MIT-0, a permissive MIT variant that drops the attribution requirement. The auto-detector's regex didn't recognize that non-standard heading text. Confirmed by reading the file, not assumed; carried as an explicit CI ignore with this citation (see the policy doc) rather than silently added to the general allow-list.

Named risk areas (task 3)

  • ClickHouse client libraries (github.com/ClickHouse/clickhouse-go/v2, github.com/ClickHouse/ch-go): Apache-2.0, matching the server itself. No divergence.
  • Kubernetes Operator tooling (sigs.k8s.io/controller-runtime, k8s.io/client-go, k8s.io/apimachinery): Apache-2.0 (one forked sub-package, apimachinery/third_party/forked/golang, is BSD-3-Clause — also fine). The concern about "generated boilerplate's license headers" turned out not to apply: deploy/operator/api/v1alpha1/ zz_generated.deepcopy.go is, despite its name, hand-written, not actually produced by controller-gen (no kubebuilder/controller-gen binary was available when it was built — disclosed in the file's own doc comment and in /deploy/README.md). There's no real upstream-generated boilerplate to check for header drift against.
  • Phase 5 font/asset files: see below.

Redpanda — classification (c), recorded for a business decision

The pinned Redpanda image (docker.redpanda.com/redpandadata/redpanda:v24.2.7, docker-compose.yml and transport/) ships under BSL 1.1 (Business Source License), confirmed against the actual licenses/bsl.md file at that tag (github.com/redpanda-data/redpanda, tag v24.2.7) — not assumed from general familiarity with Redpanda's licensing history, which the audit brief specifically warned has shifted over time.

Key facts, verified against primary sources:

  • Not OSI-approved open source. BSL is explicitly source-available, matching this audit's own category-(c) definition.
  • Change Date: 4 years from each version's release date, after which that version's Licensed Work converts to Apache-2.0. v24.2.7 was released 2024-10-11 (confirmed via the GitHub Releases API) — its Change Date is ~2028-10-11. As of this audit, it has not yet converted.
  • The restriction is narrow: BSL's Additional Use Grant permits any use except offering the Licensed Work as a "Streaming or Queuing Service" to third parties (defined as a commercial offering letting third parties create topics in the Licensed Work, e.g. a hosted Kafka broker product). This project's docker-compose.yml uses only plaintext core Kafka-protocol functionality — no RCL-gated enterprise features, no tiered storage, no SASL/RBAC — squarely within the permitted grant as an internal transport layer.
  • No AGPL linking/compatibility issue. Cairn OBS never links against Redpanda's code; it's consumed purely over the Kafka wire protocol, the same relationship as ClickHouse and Postgres. AGPLv3's copyleft doesn't reach across a network-protocol boundary to unrelated, separately-licensed software you merely talk to.
  • The genuinely open question: Phase 6 relicenses enterprise/ to AGPLv3 specifically so that anyone, including competitors, can legally self-host or fork Cairn OBS — including offering it as a network service, per AGPLv3's own terms. If a third party does that using the bundled docker-compose.yml (which pulls this BSL-licensed Redpanda image), does their deployment trip BSL's Streaming-or-Queuing-Service restriction? Cairn OBS's ingest pipeline creates fixed internal topics, not per-end-user topics exposed for direct third-party production or consumption — so this is very likely not a Streaming-or-Queuing-Service under BSL's own definition. But this is a business/redistribution judgment call about a hypothetical third party's use, not a pure technical compatibility question this audit can close unilaterally.

Remediation options (recorded per task 4's requirement)

  1. Accept as-is. Document the reasoning above; Cairn OBS's own use is clearly within BSL's permitted grant, and the third-party-SaaS scenario is a reasonable-but-unverified reading, not a known violation. Lowest effort, zero functional change.
  2. Swap to Apache Kafka (Apache-2.0, genuinely OSI open source). apache/kafka (KRaft mode, no ZooKeeper needed as of Kafka 3.x) is wire-protocol-compatible with everything transport/ingest/search already speak. Real tradeoff: Redpanda was originally chosen partly for its lightweight single-binary footprint (docker-compose.yml runs it with --smp=1 --memory=1G --overprovisioned, tuned for a resource-constrained local/homelab deployment per PROJECT-SPEC.md's stated deployment targets); Kafka's JVM-based broker has a materially larger minimum memory/startup footprint. This is a real regression for the project's stated "docker-compose for local/homelab" use case, not a drop-in swap with no cost.
  3. Stop bundling a pinned broker image at all. transport/ already has no application code of its own — it's a thin docker-compose wrapper and topic-provisioning script. Document Kafka-API compatibility as the requirement and let the operator supply their own broker (self-installed Apache Kafka, their own separately-licensed Redpanda, or anything else wire-compatible). This moves the redistribution question out of this project's own docker-compose.yml entirely, at the cost of a rougher out-of-the-box local dev experience (an extra manual setup step instead of docker compose up).

Decision recorded 2026-08-16: option 1, accept as-is. No code or deployment change was made as a result — Redpanda stays pinned at v24.2.7 in docker-compose.yml/transport/, under BSL 1.1, as a disclosed and accepted risk rather than an unresolved one. This decision should be revisited if the project's redistribution posture changes materially (e.g. an official hosted/managed offering of Cairn OBS itself, which would make the third-party-SaaS reading in this section Cairn OBS's own situation rather than a hypothetical third party's).

Non-license finding: favicon.svg

web/src/lib/assets/favicon.svg was SvelteKit's own default project scaffold logo (<title>svelte-logo</title> — the sv create/create-svelte starter icon), never replaced with an original mark during Phase 5's redesign. Not a license-compatibility blocker — Svelte's own project assets are MIT-licensed — but it was unauthored, third-party-branded content shipping as this product's own favicon, caught by the same "grep for anything that looks copied" pass this audit's task 1 asked for. Recorded as an action item (replace with an original mark), not a compliance blocker at the time; resolved as part of the Sentry → Cairn OBS rebrand, which replaced it with the real Cairn OBS mark from the project's own logo package.

Own license declarations (task 5)

Before this audit: no root LICENSE file existed anywhere in the repo — not at the root, not in enterprise/. The only license declarations were prose statements in PROJECT-SPEC.md/docs/architecture.md and correct license = "AGPL-3.0-only" fields in the two Rust workspaces' Cargo.tomls. web/package.json had no license field at all (npm's tooling reported the package itself as UNLICENSED as a result). web/static/fonts/LICENSE.txt was a paraphrase describing the Overpass font's license, not the actual OFL-1.1 license text.

Fixed:

  • Added /LICENSE — the verbatim, unmodified AGPLv3 text from gnu.org/licenses/agpl-3.0.txt, byte-for-byte, not paraphrased.
  • Chosen convention, applied consistently: one root LICENSE file governs the whole monorepo, plus a license field in every ecosystem manifest that supports one (Cargo.toml's license/license.workspace, now confirmed correct; package.json's license, added: "AGPL-3.0-only"). Go has no manifest-level license field — the standard convention (and what go-licenses itself looks for) is the root LICENSE file, which now exists. Deliberately not adopting per-file SPDX header comments across the monorepo's several thousand source files: headers are an FSF best-practice recommendation, not a legal requirement once a correct root LICENSE plus copyright ownership is established, and retrofitting them here would be a huge mechanical change for very little incremental legal value over what's now in place. Recorded as a deliberate choice, not left half-done.
  • Corrected web/static/fonts/LICENSE.txt from a paraphrase to the actual, complete, unmodified OFL-1.1 text (fetched from github.com/googlefonts/overpass, the actual repository these font files were fetched from per the file's own prior note) plus the correct copyright statement, with the original context note (self-hosted vs. CDN) preserved as a clearly separated project note, not mixed into the license text itself.
  • No accidental license mismatch from copied code was found — the repo-wide attribution-marker grep in the methodology section came back empty, and no vendored directories exist.

enterprise/ relicensing to AGPLv3 (task 6)

This is a deliberate business-model choice, recorded plainly so it isn't rediscovered as a surprise later: the project is no longer pursuing commercial-license revenue from the former enterprise/ features (SSO, multi-tenancy/RBAC, audit logging). As of Phase 6, anyone, including competitors, can legally self-host or fork those features under AGPLv3's terms. AGPLv3's source-sharing obligation applies to network use (anyone interacting with a modified version over a network is entitled to its source) — it does not impose any payment obligation, and nothing in this project gates functionality behind a license key or entitlement check.

Confirmed no license-gating logic exists: a repo-wide grep for license-key/entitlement-check patterns (license.?key, entitlement, commercial.?key, paywall, IsLicensed, and similar) across enterprise/'s Go source returned zero hits. There was never a functional paywall to remove — Phase 4's enterprise/ split was always an architectural/import-boundary separation, not a runtime license check, so this task's "if any such gating exists, flag it explicitly, it needs to come out" condition doesn't apply here — confirmed, not assumed.

Changes applied:

  • Every prose reference to enterprise/ as "commercial license" or "commercial-licensed" across the repo was updated. Present-tense claims (code comments, README.md files describing current state, PROJECT-SPEC.md's non-negotiable constraints) were corrected outright. Historical, phase-specific documents (docs/phase-4-isolation-design.md, docs/phase-4-rbac-design.md, docs/phase-4-runbook.md, and the relevant parts of PROJECT-SPEC.md's and docs/architecture.md's Phase 4 sections) were given forward-pointing corrections — "commercial license at the time this was written; AGPLv3 as of Phase 6" — rather than rewritten as if the commercial-license period never happened, matching this project's existing convention for superseded claims (e.g. Phase 3's tenant_id gap, corrected inline by Phase 4's section rather than edited out of Phase 3's).
  • enterprise/README.md, enterprise/Dockerfile, enterprise/cmd/enterprise-auth/main.go: relicensing statement corrected.
  • hack/check-tenant-boundary.sh and every doc describing it (docs/architecture.md, docs/security/threat-model.md, the two phase-4-*-design.md docs): the import-boundary check itself is kept — it still enforces a real, valuable architectural property (core builds and deploys standalone with zero multi-tenant mechanism present, tenant identity resolution stays server-side) — but every description of why it exists was reframed from a licensing reason to an architectural one, since both sides now carry the same license.
  • Final repo-wide grep for commercial confirms every remaining occurrence is one of the above corrections (explicitly framed as historical/superseded), not a live claim. No file in the repo claims a license other than AGPLv3 for Cairn OBS's own code, as of this audit.

Ongoing enforcement (task 7)

.github/workflows/license-compliance.yml — this repo's first CI workflow file (several docs already said "enforced in CI" about hack/check-tenant-boundary.sh, but no CI system had actually been wired up yet; fixed as part of this task rather than left as a second gap next to the one this task asked about). Four jobs, one per ecosystem plus the architectural boundary check, all real commands verified locally against this repo before being written into the workflow (not guessed):

  • Rust: cargo-deny-action running cargo deny check licenses against agent/deny.toml and search/deny.toml — both verified passing locally with the policy's real allow-list.
  • Go: go-licenses check ./... --allowed_licenses=... per module with real dependencies — verified passing locally for every listed module, including the segmentio/asm and HashiCorp-MPL-2.0 cases.
  • npm: license-checker --onlyAllow "..." — verified passing locally.
  • Architectural boundary: hack/check-tenant-boundary.sh, now actually wired into CI instead of only documented as if it were.

Full policy, including exactly what's auto-allowed, what needs manual review, and what's rejected outright: /docs/compliance/license-policy.md.

Not verified: the workflow YAML itself has not been run through a real GitHub Actions execution in this environment (no way to trigger that here) — every individual command it invokes was verified locally with real exit codes, but the workflow file's syntax and job wiring should be confirmed on the first real PR that triggers it, the same "written but not run against the live thing" caveat this project applies to its other CI-adjacent and Docker-gated claims.

What's resolved vs. what's still open

Per the audit brief's explicit gate: this phase is not "done" while a (c) or unresolved-(b) item has no recorded resolution. As of the Redpanda decision below, every item has one.

Item Status
All 774 permissive/MPL-2.0/OR-resolved dependencies Resolved — classification (a), no action needed.
segmentio/asm (Go) Resolved — confirmed MIT-0, carried as a cited CI ignore.
favicon.svg Flagged, not a compliance blocker — action item recorded (replace with an original mark), not license-gating.
Redpanda (BSL 1.1) Resolved — decision recorded 2026-08-16: accept as-is (option 1). No code change; the BSL exposure is a disclosed, accepted risk, not an unresolved one.
enterprise/ relicensing Resolved — applied throughout the repo, confirmed via repo-wide grep.
Root LICENSE / manifest declarations Resolved — added and corrected.
CI enforcement Resolved — workflow written and every command verified locally; the workflow file itself untested end-to-end (disclosed above).

Every task-2 (c)/unresolved-(b) item now has an explicit resolution — fixed, isolated, or, for Redpanda, flagged and decided. Phase 6's exit criteria in PROJECT-SPEC.md are updated accordingly.

This audit and the policy derived from it are a strong first pass — real primary sources were checked for every named risk area and every flagged item, not guessed from memory. They are not a substitute for review by actual legal counsel, which is recommended before the project is publicly released, pitched to customers, or used as the basis for any compliance claim — particularly the open Redpanda question above, which is exactly the kind of judgment call outside counsel exists to make.