Alpiq BESS Topics

For Agents

Living index of themes for the Alpiq BESS / Mando project. Each H2 is a topic; bullets are wikilinks to related notes. Updated by obsidian-documenter when documenting work. Read by historian at bootstrap. Topics kept alphabetical.

Bugs / Investigations

• calculated-virtual-dp-range-cutoff-bug-2026-05-18 — Calculated & Virtual DPs leak rows past to (all 4 retrieve methods); root cause in service_base.rs:94-159, mechanisms in convert_resolution.rs upsampling + evaluation.rs Full-join/concat. Diagnosed, fix pending.
• flow-step-log-message-dropped-2026-05-26 — ErrorWithStepStatus::log(status, message) drops message at parent log site; StepResult::log() (mod.rs:155-159) destructures with .., Display is "status: {status}" only (mod.rs:443), status_or_error collapses Log to Ok (mod.rs:231-239), top-level catch in mando-bess/.../flow.rs:289 sees "status: Error" only. Error(anyhow) arm OK; only ::Log broken. Tests at mod.rs:548-605 only assert log level + wrapper string. Affects all envs. Cross-check follow-up commits on feature/BE-2272.
• mando-cli-v0.4.0-compose-bugs-triage-2026-05-26 — Two confirmed compose-runtime bugs in v0.4.0: context: . resolves to runconfig/ not project root (build.yml:11, build_dev.yml:18); bare service slug passed for mocked runconfig activates malformed override stub via render_override (templates.rs:298-325) — profiles: ["{run_tag}"] line at templates.rs:317 is a load-bearing invariant keeping mocked stubs dormant. Fixes identified, not yet committed.

CI/CD

• mando-cli-github-build-mirror — GitHub-Actions build pipeline, GitLab Package Registry publishing, parallel-release flow (init → matrix-publish → finalize).
• mando-cli-wsl-linux-build — local macOS (Apple Silicon) cross-compile of a Linux x86_64 / WSL mando binary; --platform linux/amd64 + poc/-parent-mount gotchas. The manual counterpart to the CI mirror.

Data Point Retrieval

• calculated-virtual-dp-range-cutoff-bug-2026-05-18 — [from, to) range not enforced for Virtual/Calculated DPs in handle_data_point_types; EvaluationMetaData.range plumbed but unused by final output.

Error Handling

• BE-2272 — DD log JSON flattening to root (flow.*, step.*, error.* siblings).
• flow-step-log-message-dropped-2026-05-26 — ErrorWithStepStatus::Log { message } payload silently dropped by StepResult::log() destructure + Display impl + status_or_error collapse. Only ::Log arm broken; ::Error(anyhow) correctly logs.

mando-cli

• mando-cli-v2 — current architecture (AppContext, CommandDelegate, 13 commands).
• mando-cli-docker-lifecycle — DockerClient + ContainerSpec, bollard 0.19 wiring.
• mando-cli-mock-command-2026-04-28 — mando mock subcommands and WireMock infra.
• mando-cli-mock-down-idempotent-2026-05-06 — mando mock down + WireMock healthcheck endpoint fix; canonical 7-step lifecycle pattern; idempotent-teardown rule (404 = success).
• mando-cli-status-readonly-2026-05-06 — mando status made read-only and bounded (connect_readonly, table_exists, statement_timeout = '2s'); status-must-be-pure-reads rule.
• mando-cli-build-context-filter-2026-05-06 — yaml-driven context_includes and build_filtered_tar to stop COPY-everything build-context hangs.
• mando-cli-build-variants-shelved-2026-05-06 — SHELVED design for profile-driven build variants (dev vs release Dockerfile, pre_command, 3-field profile syntax).
• mando-cli-wsl-linux-build — how to build a Linux x86_64 / WSL release binary locally from an Apple Silicon Mac (musl static target, Docker --platform linux/amd64, optional-query path-dep gotcha).
• mando-cli-v0.4.0-compose-bugs-triage-2026-05-26 — v0.4.0 compose-runtime triage: two confirmed bugs in the post-bollard rewrite; context: . relative-path resolution + bare-slug positional arg activating a malformed render_override stub. Documents the load-bearing profiles: ["{run_tag}"] invariant.

Workflow / Flow Engine

• flow-step-log-message-dropped-2026-05-26 — Step-failure logging contract: ErrorWithStepStatus::log(status, message) is the “I haven’t logged yet, parent please log me” path (logged_at_failure_site: false), but the parent’s StepResult::log() drops message. Documents the constructor/Display/status_or_error/top-level-catch chain and the c945514e/4c543cb1 cross-check.