Run final Ubuntu bootstrap acceptance pass for v1.6.0

[codeforester]

Summary

Run and record the final Ubuntu acceptance pass for Base v1.6.0.

This issue is the release gate for the Ubuntu bootstrap milestone. It should verify that the apt-backed setup path, GitHub CLI guidance, and contributor docs work together in a clean Ubuntu/Debian environment.

Scope

• Validate the v1.6.0 Ubuntu setup path on Ubuntu 24.04 under Parallels or an equivalent Ubuntu/Debian environment.
• Confirm basectl setup --dry-run prints the expected apt-backed plan.
• Confirm the real setup path installs prerequisites or reports actionable failures.
• Confirm basectl check base --format text and basectl doctor base --format text pass after setup.
• Confirm gh install guidance and auth/keyring recovery docs cover the VM workflow.
• Run the full source-checkout test gate.

Acceptance criteria

• basectl setup --dry-run output is captured and matches the intended Ubuntu/Debian setup plan.
• basectl setup --yes succeeds or any host-specific blocker is captured with a follow-up issue.
• basectl check base --format text passes.
• basectl doctor base --format text reports no blocking issues.
• env -u BASE_HOME ./bin/base-test passes.
• Results are recorded on this issue before the v1.6.0 release.

[codeforester]

Ready for the final Ubuntu VM acceptance pass after:

• Implement apt-backed Ubuntu setup #1354 apt-backed Ubuntu setup
• Add Ubuntu GitHub CLI install guidance #1355 Ubuntu GitHub CLI install guidance
• Document Ubuntu GitHub CLI auth recovery #1356 Ubuntu GitHub CLI auth/keyring recovery docs

Run this from the Ubuntu VM, preferably from a native Linux checkout under ~/work/base:

cd ~/work/base
git pull --ff-only

./bin/basectl setup --dry-run
./bin/basectl setup --yes

./bin/basectl check base --format text
./bin/basectl doctor base --format text

gh auth status -h github.com || true

env -u BASE_HOME ./bin/base-test

Capture and paste the output or summary for:

• setup --dry-run apt plan
• setup --yes result, including any apt or gh repository blocker
• check result
• doctor result
• gh auth status result, especially any keyring prompt/recovery path
• base-test final summary

If gh is missing or stale, follow the Linux support doc section for the official GitHub CLI Debian/Ubuntu signed apt repository, then rerun ./bin/basectl setup --yes. If gh auth login hits the GNOME keyring mismatch dialog in the VM, use the documented normal browser flow first and the --insecure-storage fallback only if the VM security tradeoff is acceptable.

[codeforester]

Final Ubuntu 24.04 ARM64 Parallels acceptance pass completed from ~/work/base on July 2, 2026.

Evidence summary from the captured run:

• basectl setup --dry-run printed the apt-backed plan:
  • sudo apt-get update
  • sudo apt-get install -y bash git gh python3 python3-venv python3-pip bats shellcheck jq golang-go
  • official GitHub CLI Debian/Ubuntu install guidance URL
• basectl setup --yes succeeded:
  • sudo apt-get update completed
  • apt reported all required packages already installed/current, including gh 2.95.0
  • Base virtualenv and Python bootstrap packages were healthy
  • project setup completed
  • Base user config was created at /home/parallels/.base.d/config.yaml
• basectl check base --format text passed:
  • Bash, Python, venv support, Git, GitHub CLI, BATS, ShellCheck, jq, and Go all available
  • GitHub CLI authentication ready for github.com
  • project manifest checks passed
• basectl doctor base --format text reported no blocking issues for project base.
• env -u BASE_HOME ./bin/base-test passed:
  • Python: 735 passed in 3.32s
  • Bats/source checkout: 586 tests, 0 failures, 9 skipped

Result: Ubuntu bootstrap acceptance criteria for v1.6.0 are satisfied.

[codeforester]

07:53:19 ubuntu-gnu-linux-24-04-3 [base] [.venv] (main) ~/work/base: gh auth status -h github.com || true
github.com
  ✓ Logged in to github.com account codeforester (/home/parallels/.config/gh/hosts.yml)
  - Active account: true
  - Git operations protocol: https
  - Token: gho_************************************
  - Token scopes: 'gist', 'read:org', 'repo', 'workflow'

[codeforester]

Follow-up from the final Ubuntu acceptance pass is complete. The plain rerun behavior discovered during validation was tracked in #1357 and fixed by #1358, which is now merged with all refreshed CI checks passing, including both Ubuntu source-checkout jobs. Closing this acceptance issue.

[codeforester]

Closed after Ubuntu acceptance evidence and the follow-up idempotent setup rerun fix were both completed.