apiVersion: v2
name: bp-langfuse

# WARNING — DO NOT introduce ASCII apostrophes into this `description`
# block. See issue #215. When Helm packages a chart, the multi-line
# `description` is collapsed into a single-line OCI manifest annotation
# named `org.opencontainers.image.description`. The GHCR manifest-PUT
# validator returns a deterministic `500 Internal Server Error` when
# that annotation is long AND contains an ASCII apostrophe (the manifest
# digest changes on each attempt because helm includes a fresh
# `org.opencontainers.image.created` timestamp, but the failure mode is
# stable — see runs 25131349972 + 25131742024). Rewording to drop the
# apostrophe (e.g. "Langfuse persistent state" instead of the possessive
# form) is the safe in-source fix and does not change runtime behaviour.
# If you need an apostrophe in the description, also shorten the body
# below ~600 chars or escape it via &apos;-style HTML entities — but
# rewording is simpler.
description: |
  Catalyst Blueprint umbrella chart for Langfuse — LLM observability
  platform (traces, evaluations, prompt management, cost attribution).
  Depends on the upstream `langfuse` chart (langfuse/langfuse-k8s) as a
  Helm subchart so `helm dependency build` pulls the upstream payload
  into this artifact. Catalyst-curated values flow into the upstream
  subchart under the `langfuse:` key in values.yaml.

  Per docs/CLAUDE.md `langfuse.md` Catalyst routes the Langfuse
  persistent state through Catalyst-managed dependencies — NOT the
  bundled Bitnami subcharts:
    - PostgreSQL via cnpg.io/Cluster (Catalyst standard, see bp-cnpg).
    - ClickHouse via bp-clickhouse (when authored).
    - Redis via bp-valkey (when authored).
    - Object storage via SeaweedFS (bp-seaweedfs) S3-compatible endpoint.

  All four bundled deploys are disabled by default; per-Sovereign overlays
  wire the external endpoints + Secret references.
type: application
version: 1.0.0
appVersion: "3.171.0"
keywords: [catalyst, blueprint, langfuse, observability, llm, ai]
maintainers:
  - name: OpenOva Catalyst
    email: catalyst@openova.io

# Pinned to langfuse/langfuse 1.5.28 (appVersion 3.171.0) — current stable
# on 2026-04-29. Per docs/INVIOLABLE-PRINCIPLES.md #4 (never hardcode) the
# version is operator-bumpable via PR + Blueprint release.
dependencies:
  - name: langfuse
    version: "1.5.28"
    repository: "https://langfuse.github.io/langfuse-k8s"
