# Changelog

## Score

- CAI 57 → 59 (+2.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

## Lenses

- Code Health 60 → 60 (+0.1)
- Architecture 81 → 80 (-1.1)
- Maturity 57 → 87 (+30.7)
- Readiness 56 → 63 (+6.6)
- Security 55 → 56 (+1.1)
- Accessibility 58 → 56 (-2.5)
- Performance 100 → 100 (+0.0)

## Resolved (21)

- ADR has no Consequences section (openspec/changes/archive/2026-02-17-openclaw-multi-output-envelope/design.md)
- Ambiguous intent of 'execute'. In `RunHandle`, `execute` likely triggers the actual agent run. In `Pipeline`, `execute` likely triggers the entire chain. While technically distinct scopes, the method name is identical. If `RunHandle` is a component of a `Pipeline`, the naming is consistent. However, `RunHandle` also has `then`, suggesting a builder pattern, while `Pipeline` also has `then`. The duplication of `then` and `execute` on both types suggests they might be interchangeable or one is a wrapper for the other, creating confusion about whether to use the Handle or the Pipeline for execution.
- Critical CVE: [GHSA redacted] (uv.lock)
- Critical vulnerability: [GHSA redacted] (uv.lock)
- Duplicate lifecycle hook interfaces. `ComponentLifecycle` and `AgentComponent` expose nearly identical lifecycle methods (`run_*` vs `on_*`) with the same signatures and intent (pre/post consume, evaluate, publish, error, terminate). This creates two parallel ways to hook into the agent lifecycle, confusing users about which interface to implement.
- Duplicated block (30 lines × 2) (src/flock/logging/trace_and_logged.py)
- High CVE: [GHSA redacted] (uv.lock)
- High CVE: [GHSA redacted] (uv.lock)
- High CVE: [GHSA redacted] (uv.lock)
- High secret: WD-SECRET-0005 (examples/08-context-provider/05_password_redactor.py)
- High vulnerability: [GHSA redacted] (uv.lock)
- Leaked secret: hardcoded-credential (examples/12-dapr/postgresql_unencrypted/docker-compose.yml)
- Leaked secret: signing-key (examples/12-dapr/demos/_common.py)
- Medium CVE: [GHSA redacted] (uv.lock)
- Medium CVE: [GHSA redacted] (src/flock/frontend/package-lock.json)
- Medium CVE: [GHSA redacted] (uv.lock)
- Redundant naming for synchronous/asynchronous execution. The distinction between `run` and `run_async` is implicit in the name but explicit in the signature only by convention (or lack of return type). It is more consistent to use `start`/`start_async` or `serve`/`serve_async` to clearly indicate lifecycle management rather than execution style, or to have a single `start` method that handles both via a parameter.
- Rotate the exposed credentials — git history can't be un-committed
- Secret: generic-api-key (examples/11-openclaw/01_pizza_with_openclaw.py)
- VersionBumper.bump_versions (cognitive 19) (scripts/bump_version.py)
- …and 1 more

## New (34)

- Duplicated block (31 lines × 2) (src/flock/logging/trace_and_logged.py)
- High CVE: [GHSA redacted] (uv.lock)
- Medium CVE: [GHSA redacted] (uv.lock)
- Orphaned file (src/flock/storage/dapr/__init__.py)
- Repeated repair: src/flock/logging/auto_trace.py (src/flock/logging/auto_trace.py)
- `CorrelationIDFilter` spells `ID` where 40 names in the project spell it `Id` (src/flock/frontend/src/components/filters/CorrelationIDFilter.tsx)
- genai_spans.output_messages (cognitive 16) (src/flock/logging/genai_spans.py)
- redundant comment (docs/javascripts/extra.js)
- redundant comment (docs/javascripts/extra.js)
- redundant comment (src/flock/frontend/src/__tests__/integration/graph-snapshot.test.tsx)
- redundant comment (src/flock/frontend/src/__tests__/integration/graph-snapshot.test.tsx)
- redundant comment (src/flock/frontend/src/__tests__/integration/graph-snapshot.test.tsx)
- redundant comment (src/flock/frontend/src/__tests__/integration/graph-snapshot.test.tsx)
- redundant comment (src/flock/frontend/src/__tests__/integration/indexeddb-persistence.test.tsx)
- redundant comment (src/flock/frontend/src/components/controls/PublishControl.tsx)
- redundant comment (src/flock/frontend/src/components/details/LiveOutputTab.tsx)
- redundant comment (src/flock/frontend/src/components/details/MessageDetailWindow.tsx)
- redundant comment (src/flock/frontend/src/components/details/tabs.test.tsx)
- redundant comment (src/flock/frontend/src/components/details/tabs.test.tsx)
- redundant comment (src/flock/frontend/src/components/graph/AgentNode.tsx)
- …and 14 more

## Changes since last survey

- 31 commits — 21 feature/other, 10 fixes

## By area

- docs/assets — 10 commits
- (repo) — 7 commits
- src/flock — 6 commits
- (root) — 4 commits
- docs/guides — 3 commits
- docs/about — 1 commit

## Notable commits

- fix: Merge pull request #677 from whiteducksoftware/fix/676-security-deps
- fix: Merge pull request #684 from whiteducksoftware/fix/679-otlp-http
- fix: Merge pull request #690 from whiteducksoftware/fix/689-security-deps
- fix: fix: Responses API usage and the conventions' message schema (#680, review round 1)
- fix: fix: close the 113 Dependabot alerts on main (#676)
- fix: fix: close the litellm and dnspython Dependabot alerts on main (#689)
- fix: fix: export OTLP over HTTP when the OTel variables ask for it (#679)
- fix: fix: one span per call for nested agents, Responses API tool calls (#680, review round 2)
- fix: fix: only a context names the run, a payload field does not (#681, review round 1)
- fix: fix: the run comes from the bound ctx or a Context, never a payload (#681, review round 2)
- change: Merge pull request #686 from whiteducksoftware/feat/680-genai-spans
- change: Merge pull request #687 from whiteducksoftware/feat/681-session-id
- change: Merge pull request #688 from whiteducksoftware/docs/682-tracing-backends
- change: Merge pull request #691 from whiteducksoftware/chore/bump-0.5.800
- change: chore: bump version to 0.5.800
- change: docs: README screenshot for the PR of #682 (removed in the next commit)
- change: docs: a guide for tracing backends, comparisons without claims about other tools (#682)
- change: docs: exported spans carry tokens, backends estimate the cost (#682, review round 1)
- change: docs: one more screenshot for the PR of #680 (removed in the next commit)
- change: docs: portable base64 for the Langfuse header (#682, review round 2)
- …and 11 more

## Architecture

- Unchanged — 0 containers · 1 contexts · 0 edges
