Skip to content

docs: confirm screen reader and speech packages are available - #657

Merged
hivecommons-hive[bot] merged 2 commits into
projectbluefin:mainfrom
arteeh:hive/accessibility-speech-510
Oct 26, 2026
Merged

hivecommons-hive[bot] merged 2 commits into
projectbluefin:mainfrom
arteeh:hive/accessibility-speech-510

Conversation

@arteeh

@arteeh arteeh commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

The six accessibility outputs requested by #510 are already published. This change keeps their source-to-binary mapping and a repeatable six-name resolver procedure in the inspection skill, and moves dated publication evidence into this PR.

The guide now requires resolution against the exact digest being handed downstream, explicitly includes brltty, and distinguishes publication, dependency closure, installed presence and direct manifest membership.

Exact-digest resolver evidence

Successful solver run, full job logs, measured 2026-10-26 08:19 UTC.

  • GitHub-hosted ubuntu-26.04, inside repository-pinned quay.io/packit/packit:latest@sha256:1eb66a731ba6e5733db0a77feb76dabf83b145c0c676a8a8e30278ac2ba34a85.
  • Factory repodata extracted from exactly ghcr.io/projectbluefin/utah-packages@sha256:2ae7b475632f416b759c3160d27ceef62c087089ebf54bb3e2a6961f4d85f222; manifest digest verified, repomd SHA-256 a5a3703d531ce345c4f62b0d9cd80c3fb46b680dd9f0a58920118335a580c353.
  • Empty install root /tmp/solver, releasever 44. Only factory (extracted repository) and hbird (the permitted Hummingbird HTTPS repository) enabled. Fedora and negativo17 disabled.
  • Hummingbird repomd SHA-256 eb56a38f63ab02af3b019c9643e7adb41e5fd475f2ba920a7148460de4675d62, equal to the earlier snapshot below. Response Date: Mon, 26 Oct 2026 08:19:42 GMT; Last-Modified: Sun, 25 Oct 2026 05:09:06 GMT; ETag equals that quoted SHA-256.
  • Command:
dnf --installroot=/tmp/solver --releasever=44 --assumeno \
  --disablerepo='*' --enablerepo=factory,hbird install \
  brlapi brltty espeak-ng orca speech-dispatcher speech-dispatcher-utils

Result: Transaction Summary produced; all six requested packages selected from factory at the NEVRAs below. The probe accepts only DNF exit 0/1 plus a valid transaction summary and rejects dependency/repository errors. It installs nothing. This proves six-name dependency closure for the cited digest, not compatibility with Utah's installed rpmdb or runtime screen-reader behavior.

The isolated validation branch carries only the probe; the PR remains a documentation change.

Dated publication evidence

Preserved from the original guide text; this is a snapshot, not a claim about future publications.

Publication snapshot

Queried on 2026-10-26 at 06:13 UTC using tools/package_index.py's registry
reader and the Hummingbird HTTPS metadata endpoint above. Factory image:

ghcr.io/projectbluefin/utah-packages@sha256:2ae7b475632f416b759c3160d27ceef62c087089ebf54bb3e2a6961f4d85f222

The image identifies revision 8990424b4028b5535e4635c323dd7435d4e6afaf and
factory run 40265243289.
Its final publication job succeeded; the overall run failed on another
package, gstreamer1-plugins-good, the only source in the image's failed map.
None of the four accessibility sources is marked failed.

Each row is a binary found in factory primary metadata. Epoch is explicitly
zero in every NEVRA (name, epoch, version, release and architecture). None of
these six binary names is present in the Hummingbird primary snapshot.

Binary output Source recipe Published NEVRA Supplier
brlapi packages/brltty/brltty.spec brlapi-0:0.8.8-9.hum1.bfin.x86_64 Factory
brltty packages/brltty/brltty.spec brltty-0:6.9.1-9.hum1.bfin.x86_64 Factory
espeak-ng packages/espeak-ng/espeak-ng.spec espeak-ng-0:1.52.0-4.hum1.bfin.x86_64 Factory
orca packages/orca/orca.spec orca-0:51.1-1.hum1.bfin.noarch Factory
speech-dispatcher packages/speech-dispatcher/speech-dispatcher.spec speech-dispatcher-0:0.12.1-9.hum1.bfin.x86_64 Factory
speech-dispatcher-utils packages/speech-dispatcher/speech-dispatcher.spec speech-dispatcher-utils-0:0.12.1-9.hum1.bfin.x86_64 Factory

In particular, brlapi is a subpackage of brltty with its own version;
speech-dispatcher-utils is a subpackage of speech-dispatcher. Search
sourcerpm in primary metadata rather than assuming the binary name or
version identifies a separate source recipe.

Snapshot SHA-256 checksums (factory primary is decompressed XML; Hummingbird
primary, filelists and other are the compressed bytes named by repomd):

Metadata SHA-256
Factory repomd a5a3703d531ce345c4f62b0d9cd80c3fb46b680dd9f0a58920118335a580c353
Factory primary e3596acaaa0140ef66b9d34d040ac1ee58232afd2dfa5832ba43d642ada734c5
Hummingbird repomd eb56a38f63ab02af3b019c9643e7adb41e5fd475f2ba920a7148460de4675d62
Hummingbird primary e28983db652a7c317d51cb54efd75de45b63a4c29e01e0bd9bedb5b46bb6225a
Hummingbird filelists 3db83a1c47e325349936d272d5b4270b32518c40a86104aa5a2a9f31b9481faa
Hummingbird other 30ab12a6d641ae173a5d1f08ac84c5fc26722b4ec5f19ab7207db7289458063c

Hummingbird's repomd response was dated Mon, 26 Oct 2026 06:13:57 GMT,
with Last-Modified: Sun, 25 Oct 2026 05:09:06 GMT and an ETag equal to its
quoted repomd SHA-256 above.

Downstream handoff

For projectbluefin/utah#263: the digest and six NEVRAs above now have an explicit, successful joint resolver check. No additional factory recipe import or rebuild is needed for these outputs. Utah's choice to install brltty and declare dependency-installed names directly remains downstream policy. The historical maintainer check used an older pin; it is not the evidence for this new result.

Validation

  • just check: passed.
  • just test: 1,369 passed, 2 skipped.
  • git diff --check: passed.
  • Pre-commit on changed documentation: passed.
  • Repository-wide pre-commit: existing actionlint/ShellCheck SC2129 style failure in unchanged .github/workflows/rebuild-rpms.yml:367; other hooks passed.
  • Exact-digest six-name solver probe: passed, linked above.

Closes #510

Record source recipes, published binary versions, repository snapshots and closure evidence for the six requested accessibility outputs. Keep downstream installation policy separate from factory publication.

Assisted-by: GPT-6.1 via GitHub Copilot
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Hive-Run: #510
Hive-Plan: accessibility-speech-reconciliation
Hive-Spec: issue-510#implementation-and-acceptance
Signed-off-by: arteeh <arteeh@users.noreply.github.com>
@hivecommons-hive hivecommons-hive Bot added author/clanker A contributor's own hive authored this PR under their login dco All commits are DCO signed-off role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Oct 26, 2026

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Summary: This change writes down, in the repository's how-to guide for inspecting published packages, that the six screen reader and speech packages are already built and published. The record is accurate, but two things fall short: the issue asked for proof that the six packages actually install together from the newly cited build, and that proof is only given for an older build; and most of the added text is a dated, one-time snapshot (timestamps, checksums) placed in a guide meant for reusable instructions, so it will be stale after the next publish.

What I need from you: Add a resolver check for the cited digest and move the snapshot evidence to the issue.


intent-alignment (medium, in-scope) — #510 acceptance says "Verify outputs resolve against permitted Hummingbird/factory repositories" and "Attach published factory digest and evidence for downstream #263". The PR attaches digest 2ae7b475… (docs/skills/repo-inspection.md:80) but the only six-name solver evidence is the 2026-10-17 check against factory pin 951d030d (repo-inspection.md:127-133), which the text itself calls "not a solver test of the newer digest". The 316-name install-set check (repo-inspection.md:135-140) does not cover brltty, which the maintainer's comment on #510 says is absent from Utah's install set. So the digest being handed to #263 has no resolution evidence for these names, and projectbluefin/utah#263 has no accessibility comment yet (last comment is the 2026-10-24 parity-wave-1 status). Fix: run dnf install --assumeno --disablerepo=* --enablerepo=factory,hbird brlapi brltty espeak-ng orca speech-dispatcher speech-dispatcher-utils with the factory repo pointed at sha256:2ae7b475…, record the result in the PR body / #510, and post the digest + six NEVRAs to #263.

docs-currency (medium, in-scope) — repo-inspection.md:3 frontmatter promises "Live metadata, not hard-coded names", and docs/skills/skill-improvement.md:52-54 says not to write down "One-off task notes, ephemeral state, or a log of what you did this session." Lines 76-113 are exactly that: a 06:13 UTC query timestamp, six SHA-256 checksums, an ETag/Last-Modified pair and a run/job id, all of which change on the next factory publish and Hummingbird sync. Keep the reusable lessons (lines 65-73 reuse-not-rebuild, 95-98 brlapi subpackage/sourcerpm note, 146-147 "four separate claims") and move the snapshot tables to a comment on #510, which is where #510 asks for evidence to be attached. Proposed trim:

-### Publication snapshot
-
-Queried on 2026-10-26 at 06:13 UTC using `tools/package_index.py`'s registry
-reader and the Hummingbird HTTPS metadata endpoint above. Factory image:
-
-```text
-ghcr.io/projectbluefin/utah-packages@sha256:2ae7b475632f416b759c3160d27ceef62c087089ebf54bb3e2a6961f4d85f222
-```
-
-The image identifies revision `8990424b4028b5535e4635c323dd7435d4e6afaf` and
-[factory run 40265243289](https://github.com/projectbluefin/utah-packages/actions/runs/40265243289).
-Its final publication job succeeded; the overall run failed on another
-package, `gstreamer1-plugins-good`, the only source in the image's failed map.
-None of the four accessibility sources is marked failed.
-
-Each row is a binary found in factory primary metadata. Epoch is explicitly
-zero in every NEVRA (name, epoch, version, release and architecture). None of
-these six binary names is present in the Hummingbird primary snapshot.
+### Source-to-binary map
+
+Current NEVRAs, digest, and metadata checksums are recorded on #510, not here;
+re-query before quoting them. All six are factory-supplied; none is in
+Hummingbird.
 
-| Binary output | Source recipe | Published NEVRA | Supplier |
-| --- | --- | --- | --- |
-| `brlapi` | `packages/brltty/brltty.spec` | `brlapi-0:0.8.8-9.hum1.bfin.x86_64` | Factory |
...
+| Binary output | Source recipe |
+| --- | --- |
+| `brlapi` | `packages/brltty/brltty.spec` (own `Version: %{api_version}`) |
+| `brltty` | `packages/brltty/brltty.spec` |
+| `espeak-ng` | `packages/espeak-ng/espeak-ng.spec` |
+| `orca` | `packages/orca/orca.spec` |
+| `speech-dispatcher` | `packages/speech-dispatcher/speech-dispatcher.spec` |
+| `speech-dispatcher-utils` | `packages/speech-dispatcher/speech-dispatcher.spec` |
-
-Snapshot SHA-256 checksums (factory primary is decompressed XML; Hummingbird
-primary, filelists and other are the compressed bytes named by repomd):
-
-| Metadata | SHA-256 |
-...
-Hummingbird's repomd response was dated `Mon, 26 Oct 2026 06:13:57 GMT`,
-with `Last-Modified: Sun, 25 Oct 2026 05:09:06 GMT` and an ETag equal to its
-quoted repomd SHA-256 above.

Note: the review contract named #470 as the linked issue, but #470 is the merged ICU build-fix PR; this PR's closing keyword is #510, so intent was judged against #510.

No findings from: correctness, security, style.

Confidence: 3/5 (needs attention) — 2 medium findings

— hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot added stage/072-returned-to-contributor Contributor PR: CI red, changes requested or conflicting; diagnosis posted, author must act and removed stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Oct 26, 2026
@hivecommons-hive

Copy link
Copy Markdown
Contributor

@arteeh this PR is back in your court (stage/072-returned-to-contributor). The hive will not merge it until the head changes.

Review asks:

  • the review swarm requested changes

Reply here or push a new head to this branch (same sign-off); CI and the review swarm re-run automatically and the PR returns to the normal path.

Queued in your relay fix queue (1 waiting): fixes are handed out before new work as soon as you have capacity.

Require a six-name transaction against the cited digest and distinguish empty-root closure from installed-base compatibility. Preserve dated metadata and validation results in PR evidence.

Assisted-by: GPT-6 via GitHub Copilot
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: arteeh <arteeh@users.noreply.github.com>
@hivecommons-hive hivecommons-hive Bot added stage/050-review-pending Review swarm requested; awaiting a verdict for the current head and removed stage/072-returned-to-contributor Contributor PR: CI red, changes requested or conflicting; diagnosis posted, author must act labels Oct 26, 2026

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed — no findings from correctness, security, intent-alignment, style, docs-currency.

Confidence: 5/5 (safe)

— hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive
hivecommons-hive Bot merged commit 0be0434 into projectbluefin:main Oct 26, 2026
21 checks passed
@hivecommons-hive

Copy link
Copy Markdown
Contributor
Evidence bundle `#657877a43c` sha256:0b699d8db6146c69c720ce9cbbe76db4339f6469c5e3bf6b9f03adc6b7d9ad44 — download from the dashboard or `hivectl review evidence #657`.

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Merged by hive contributor-lane auto-merge: CI green for ≥30m, reviewer verdict approve, @arteeh holds the trusted tier in this hive's contributor registry.

@hivecommons-hive hivecommons-hive Bot removed role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Oct 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author/clanker A contributor's own hive authored this PR under their login dco All commits are DCO signed-off

Projects

None yet

Development

Successfully merging this pull request may close these issues.

parity(accessibility-speech): reconcile remaining Utah package outputs in the factory

1 participant