Skip to content

docs: describe Utah's current architecture, parity, and installer status #23

Closed

Description

@hanthor

This was generated by AI during triage.

What to build

Type: AFK

Bring user and contributor documentation in line with the implemented Hummingbird-only package model, current factory closure, Utah identity, installer/offline payload, four deferred packages, and the distinction between local implementation and publicly shipped artifacts.

Acceptance criteria

  • README no longer claims the installer/offline payload is unimplemented.
  • Package counts and all deferred packages match machine-readable manifests.
  • Documentation does not describe Fedora or Rawhide as a Utah runtime package source.
  • Public image/ISO availability is stated separately from local implementation status.
  • Build, test, rollback, and artifact verification instructions reflect the adopted Dakota-style gates.

Blocked by

None - can start immediately

Activity

  1. added
    hive/likely-doneHive verified that a merged PR references or claims this issue; pending confirmation
    and removed
    hive/likely-doneHive verified that a merged PR references or claims this issue; pending confirmation
    on Sep 25, 2026
  2. buggtb commented on Sep 25, 2026

    @buggtb
    Contributor

    Verified against current main (upstream/main @ 369e3f2): all five acceptance criteria in this issue are already satisfied.

    • Merged PR docs: close README/skill package-count drift against the manifests #225 ("docs: close README/skill package-count drift against the manifests") explicitly closed "the documentation-accuracy slice of docs: describe Utah's current architecture, parity, and installer status #23": it fixed the stale installer-unimplemented claim, corrected package counts, and added scripts/check-doc-counts.py as a permanent drift gate wired into just check.
    • Running python3 scripts/check-doc-counts.py today confirms the documented counts are current: 57 Bluefin contract / 49 Utah additions / 10 genuinely unavailable, matching packages/bluefin.toml and packages/utah.toml.
    • README.md's opening banner and "Known gaps" section state the installer and offline payload are implemented (not a future milestone), while separately noting nothing is published to a registry or released as an ISO — satisfying the local-vs-public distinction.
    • No documentation describes Fedora or Rawhide as a Utah runtime package source; the only Fedora/Rawhide mentions are contextual (builder-only toolchain, or explaining why a package is unavailable).
    • docs/building.md's "Validate the release-readiness gates" section (added by docs: close README/skill package-count drift against the manifests #225) documents the adopted Dakota-style gates: just iso, boot-iso, luks-test, try-installed, check-desktop-contract, check-repos, plus rollback/uupd policy pointers.

    Two later attempts to re-do this same work (PR #142, PR #63) were both closed by a maintainer as superseded/stale once #225 and related PRs (#143 Secure Boot docs, #253 grub2 tracking) landed on main.

    I'm not opening a new PR since there is nothing left to change against the stated acceptance criteria.

    — hive: backend=pi model=pi-claude-code-provider/sonnet

    🐝 Hive Agent: contributor | SHA: b01bacf

  3. castrojo commented on Sep 26, 2026

    @castrojo
    Contributor

    This was generated by AI during triage.

    Closing as completed: resolved by PR #225 ("docs: close README/skill package-count drift against the manifests"), aligning manifest package counts and adding scripts/check-doc-counts.py as an automated drift gate.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    hive/already-doneHive contributor found this issue already resolved; remove if work remains

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions