v1.1.1
pbr-cpp-memory-pool v1.1.1 — Maintenance (bug ledger, PR-metadata policy, governance)
A maintenance PATCH. v1.1.1 is purely documentation, process, and tooling — the shipped library is byte-identical to v1.1.0 (no API, ABI, or behaviour change), so every existing consumer is unaffected. It bundles the post-v1.1.0 governance and quality work accumulated on master.
What's in the box
In-repo bug ledger & triage protocol (ADR-0039)
Known defects and the triage of incoming reports now have a durable, reviewable home under docs/bugs/: one Markdown record per defect, BUG-NNNN-<slug>.md under a discovery-date tree docs/bugs/<YYYY>/<MM>/, with a stable monotonic id, structured frontmatter, an index + template, and a lifecycle (open → confirmed → fixed, plus wontfix/duplicate/cannot-reproduce). The ledger is the source of truth (a GitHub issue is referenced, not authoritative). The agent rule (AGENTS.md §7.7) creates a record only for verified, reproducible defects and verifies third-party reports before accepting them (unsubstantiated reports are still recorded as cannot-reproduce/rejected). A new bugs consistency-lint check guards record integrity.
Pull-request metadata policy (ADR-0040)
Every agent-opened PR now also sets a maintainer assignee, exactly one type label (Conventional-Commit type → label; docs reuses the built-in documentation label), and the current open release milestone. The eight type labels and the v1.1.1 milestone were created. Reviewers are deferred (the sole collaborator is the PR author — GitHub forbids self-review) and Projects are deferred (the gh token lacks the project scope); the rule names how each switches on. Codified in AGENTS.md §6.4.
Governance & documentation structure
- Session journal (ADR-0036) — dated end-of-session checkpoints extracted from
ROADMAP.mdintodocs/journal/(one file per session underYYYY/MM/), leavingROADMAP.mda forward plan. - New-feature roadmap-placement rule (ADR-0037) — when a feature warrants a new milestone vs. an appended item vs. neither.
- Per-release changelog split (ADR-0038) — released entries are now one immutable file per release under
docs/changelog/v<MAJOR>/, the rootCHANGELOG.mdkeeping only[Unreleased]+ the index. SECURITY.md— the public security policy (supported versions, private vulnerability reporting, coordinated disclosure), realizing the addition referenced by the maintenance protocol.
CI & tooling
packaging-smokeworkflow — end-to-end smoke tests for the vcpkg port and Conan recipe (which cannot be built on the maintainer's box), pinned to thev1.0.0source tag and run on recipe changes + weekly.- GitHub Actions bumped off the deprecated Node 20 runtime onto Node 24.
- API-reference badge in the README linking to the published Doxygen site.
Architecture Decision Records
Five ADRs accepted since v1.1.0, taking the running total from 35 to 40:
- ADR-0036 — extract the session journal from
ROADMAP.md. - ADR-0037 — new-feature roadmap placement (milestone vs. item).
- ADR-0038 — split the changelog into one file per release.
- ADR-0039 — in-repo bug ledger and agent triage protocol.
- ADR-0040 — pull-request metadata policy.
Spec Coverage Map
No change — v1.1.1 is additive documentation/process/tooling, not a spec requirement. All fifteen rows remain ✅ (accepted at v1.0.0, ADR-0029).
What this release does not contain
- No library code change — the static archive is unchanged from
v1.1.0; this is a docs/process/tooling PATCH. - The
zh-Hans/jaREADME translations are re-synced to thev1.1.1status in a follow-up PR (the manifest's two README rows are markedstalein this release).
Verifying the release
Each platform tarball is the same complete cmake --install tree as v1.1.0 (full headers + static archive + CMake package config + pkg-config .pc). SHA-256 checksums are in SHA256SUMS:
sha256sum --check SHA256SUMSLinks
- Changelog entry:
CHANGELOG.md—[1.1.1] - Maintenance protocol:
docs/workflow/maintenance.md - Bug ledger:
docs/bugs/ - Previous release:
docs/releases/v1.1.0.md