feat: Updating latest improvements from Upstream Repo

Author: deepakdgupta1

.beads/README.md

@@ -14,32 +14,32 @@ Beads is issue tracking that lives in your repo, making it perfect for AI coding
 
 ```bash
 # Create new issues
-bd create "Add user authentication"
+br create "Add user authentication"
 
 # View all issues
-bd list
+br list
 
 # View issue details
-bd show <issue-id>
+br show <issue-id>
 
 # Update issue status
-bd update <issue-id> --status in_progress
-bd update <issue-id> --status done
+br update <issue-id> --status in_progress
+br update <issue-id> --status done
 
 # Sync with git remote
-bd sync
+br sync
 ```
 
 ## Daemon (Optional)
 
-Beads has an optional background daemon (`bd daemon`) that auto-syncs issues with git.
+Beads has an optional background daemon (`br daemon`) that auto-syncs issues with git.
 
 In this repo, the sync branch is configured as `main`. Running the daemon while you are on a different branch can cause `.beads/issues.jsonl` to be rewritten from `main`, leaving your working tree dirty and blocking `git pull --rebase`.
 
 Recommended workflow:
-- Prefer manual sync: `bd sync` (default).
-- If you use the daemon, run it only while you are on `main`, or run it in local-only mode: `bd daemon --start --local`.
-- If `.beads/issues.jsonl` is changing unexpectedly, check/stop the daemon: `bd daemon --status` / `bd daemon --stop`.
+- Prefer manual sync: `br sync` (default).
+- If you use the daemon, run it only while you are on `main`, or run it in local-only mode: `br daemon --start --local`.
+- If `.beads/issues.jsonl` is changing unexpectedly, check/stop the daemon: `br daemon --status` / `br daemon --stop`.
 
 ### Working with Issues
 
@@ -75,16 +75,16 @@ Try Beads in your own projects:
 curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
 
 # Initialize in your repo
-bd init
+br init
 
 # Create your first issue
-bd create "Try out Beads"
+br create "Try out Beads"
 ```
 
 ## Learn More
 
 - **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
-- **Quick Start Guide**: Run `bd quickstart`
+- **Quick Start Guide**: Run `br quickstart`
 - **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)
 
 ---

.beads/issues.jsonl

@@ -31,18 +31,21 @@ jobs:
         env:
           ACFS_CHECKSUMS_REF: main
         run: |
-          set -o pipefail
           chmod +x ./tests/vm/test_install_ubuntu.sh
 
+          UBUNTU="${{ inputs.ubuntu || 'all' }}"
+          MODE="${{ inputs.mode || 'vibe' }}"
+
+          rc=0
           if [[ "${{ github.event_name }}" == "schedule" ]]; then
-            ./tests/vm/test_install_ubuntu.sh --all --mode "vibe" --strict 2>&1 | tee canary.log
-          elif [[ "${{ github.event_name }}" == "workflow_dispatch" && "${{ inputs.ubuntu }}" == "all" ]]; then
-            ./tests/vm/test_install_ubuntu.sh --all --mode "${{ inputs.mode }}" --strict 2>&1 | tee canary.log
+            (set -o pipefail; ./tests/vm/test_install_ubuntu.sh --all --mode "vibe" --strict 2>&1 | tee canary.log) || rc=$?
+          elif [[ "${{ github.event_name }}" == "workflow_dispatch" && "$UBUNTU" == "all" ]]; then
+            (set -o pipefail; ./tests/vm/test_install_ubuntu.sh --all --mode "$MODE" --strict 2>&1 | tee canary.log) || rc=$?
           else
-            ./tests/vm/test_install_ubuntu.sh --ubuntu "${{ inputs.ubuntu }}" --mode "${{ inputs.mode }}" --strict 2>&1 | tee canary.log
+            (set -o pipefail; ./tests/vm/test_install_ubuntu.sh --ubuntu "$UBUNTU" --mode "$MODE" --strict 2>&1 | tee canary.log) || rc=$?
           fi
 
-          echo "exit_code=${PIPESTATUS[0]}" >> "$GITHUB_OUTPUT"
+          echo "exit_code=$rc" >> "$GITHUB_OUTPUT"
 
       - name: Detect checksum mismatch
         id: detect

.github/workflows/installer-canary-strict.yml

@@ -28,8 +28,11 @@ jobs:
         run: |
           chmod +x ./tests/vm/test_install_ubuntu.sh
 
-          if [[ "${{ github.event_name }}" == "workflow_dispatch" && "${{ inputs.ubuntu }}" == "all" ]]; then
-            ./tests/vm/test_install_ubuntu.sh --all --mode "${{ inputs.mode }}"
+          UBUNTU="${{ inputs.ubuntu || '24.04' }}"
+          MODE="${{ inputs.mode || 'vibe' }}"
+
+          if [[ "${{ github.event_name }}" == "workflow_dispatch" && "$UBUNTU" == "all" ]]; then
+            ./tests/vm/test_install_ubuntu.sh --all --mode "$MODE"
           else
-            ./tests/vm/test_install_ubuntu.sh --ubuntu "${{ inputs.ubuntu }}" --mode "${{ inputs.mode }}"
+            ./tests/vm/test_install_ubuntu.sh --ubuntu "$UBUNTU" --mode "$MODE"
           fi

.github/workflows/installer-canary.yml

@@ -491,21 +491,29 @@ jobs:
           TOOL_NAME="${{ needs.validate-dispatch.outputs.tool_name }}"
           SOURCE_REPO="${{ needs.validate-dispatch.outputs.source_repo }}"
 
-          gh pr create \
-            --base main \
-            --head "auto/remove-${TOOL_NAME}" \
-            --title "chore(checksums): Remove $TOOL_NAME" \
-            --body "## Tool Removal: $TOOL_NAME
+          cat > /tmp/removal-pr-body.md << 'PREOF'
+          ## Tool Removal: $TOOL_NAME
+
+          This PR removes **$TOOL_NAME** from checksums.yaml.
+
+          ### Reason
+          The upstream repository ($SOURCE_REPO) has indicated the installer should be removed.
 
-This PR removes **$TOOL_NAME** from checksums.yaml.
+          ### Checklist
+          - [ ] Confirmed tool is no longer needed
+          - [ ] Verified this is intentional, not an error
 
-### Reason
-The upstream repository ($SOURCE_REPO) has indicated the installer should be removed.
+          ---
+          *Generated by ACFS Installer Notification Receiver*
+          PREOF
 
-### Checklist
-- [ ] Confirmed tool is no longer needed
-- [ ] Verified this is intentional, not an error
+          # Substitute variables in the template
+          sed -i "s/\$TOOL_NAME/$TOOL_NAME/g" /tmp/removal-pr-body.md
+          sed -i "s|\$SOURCE_REPO|$SOURCE_REPO|g" /tmp/removal-pr-body.md
 
----
-*Generated by ACFS Installer Notification Receiver*" \
+          gh pr create \
+            --base main \
+            --head "auto/remove-${TOOL_NAME}" \
+            --title "chore(checksums): Remove $TOOL_NAME" \
+            --body-file /tmp/removal-pr-body.md \
             --label "automated,checksum-removal,needs-review"

.github/workflows/installer-notification-receiver.yml

@@ -309,6 +309,18 @@ jobs:
           su - ubuntu -c "zsh -ic 'dcg doctor'"
           su - ubuntu -c "zsh -ic 'ru --version'"
           su - ubuntu -c "zsh -ic 'onboard --help'"
+          # beads_rust (required) - issue tracking
+          su - ubuntu -c "zsh -ic 'br --version'"
+          # New stack tools (bd-1ega)
+          su - ubuntu -c "zsh -ic 'ms --version'"
+          su - ubuntu -c "zsh -ic 'apr --help || true'"
+          su - ubuntu -c "zsh -ic 'jfp --version || true'"
+          su - ubuntu -c "zsh -ic 'pt --help || true'"
+          su - ubuntu -c "zsh -ic 'brenner --version || brenner --help || true'"
+          su - ubuntu -c "zsh -ic 'rch --version || rch --help || true'"
+          su - ubuntu -c "zsh -ic 'wa --version || wa --help || true'"
+          su - ubuntu -c "zsh -ic 'sysmoni --version || sysmoni --help || true'"
+          # Agents
           su - ubuntu -c "zsh -ic 'claude --version'"
           su - ubuntu -c "zsh -ic 'codex --version'"
           su - ubuntu -c "zsh -ic 'gemini --version'"

.github/workflows/installer.yml

@@ -123,3 +123,6 @@ a.out
 .vercel
 .env*.local
 tests/artifacts/
+
+# Stray bv/CLI artifacts (malformed flag creates files like --graph-format.svg)
+--graph-format*

.gitignore

@@ -3,4 +3,39 @@
 
 # SC2015: Note that A && B || C is not if-then-else. C may run when A is true.
 # We use this pattern intentionally for error handling (e.g., cmd || true)
-disable=SC2015
+#
+# SC2317: Command appears to be unreachable. Check usage (or ignore if invoked indirectly).
+# We use dynamic function calls via function references (e.g., "$fix_function" "fix")
+#
+# SC2016: Expressions don't expand in single quotes, use double quotes for that.
+# Intentional - we use single quotes to pass literal strings to subshells
+#
+# SC1091: Not following: file was not specified as input
+# Dynamic sourcing of related scripts is intentional
+#
+# SC2059: Don't use variables in printf format string
+# Intentional - we use ANSI color variables in format strings
+#
+# SC2034: Variable appears unused
+# Many variables are used by sourcing scripts or for documentation
+#
+# SC2155: Declare and assign separately to avoid masking return values
+# Acceptable risk in simple cases where the command always succeeds
+#
+# SC2030/SC2031: Variable modified in subshell
+# Intentional pattern in pipeline processing
+# SC2086: Double quote to prevent globbing and word splitting
+# Intentional word splitting in some cases for argument expansion
+#
+# SC2002: Useless cat
+# Sometimes cat is clearer for readability in pipelines
+#
+# SC2076: Remove quotes from right-hand side of =~
+# SC2128: Expanding an array without an index
+# SC2178: Variable was used as an array but is now assigned a string
+# SC2120/SC2119: Function references arguments, but none are ever passed
+# These are pre-existing patterns in newproj TUI code
+#
+# SC2001/SC2028/SC2129/SC2153/SC2181/SC2295: Style and info-level suggestions
+# Accepted patterns in this codebase
+disable=SC2015,SC2317,SC2016,SC1091,SC2059,SC2034,SC2155,SC2030,SC2031,SC2086,SC2002,SC2076,SC2128,SC2178,SC2120,SC2119,SC2001,SC2028,SC2129,SC2153,SC2181,SC2295

.shellcheckrc

@@ -7,15 +7,58 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Added
+### Changed
+
+- **BREAKING**: `git_safety_guard` replaced by **DCG (Destructive Command Guard)**
+  - The legacy `git_safety_guard.py` hook has been fully removed
+  - DCG is now the only supported command safety mechanism
+  - Automatic cleanup of legacy files during `acfs update`
+
+### Migration: git_safety_guard → DCG
 
-- Repository content audit and documentation cleanup
-- Archived historical planning documents to `docs/archive/`
+If you installed ACFS before January 11, 2026, your installation may have legacy `git_safety_guard` files.
 
-## [0.5.0] - 2026-01-11
+**Symptoms of old installation:**
+- `acfs doctor` shows "Git safety guard" warning
+- Files exist at `~/.acfs/claude/hooks/git_safety_guard.py` or `~/.claude/hooks/`
+
+**Migration steps:**
+1. Run `acfs update` - this automatically removes legacy files
+2. Install DCG: `dcg install`
+3. Verify: `acfs doctor` should show only DCG check (no git_safety_guard warnings)
+
+**Why DCG?**
+- Built in Rust for sub-millisecond latency (vs Python startup overhead)
+- Modular pack system for extensibility
+- Dedicated repository and maintenance at [dcg](https://github.com/Dicklesworthstone/destructive_command_guard)
 
 ### Added
 
+- **New Flywheel Tools**:
+  - **beads_rust (br)** - Rust port of issue tracker, replaces golang beads
+    - `bd` alias maintained for backward compatibility
+    - Companion **bv** (beads_viewer) for graph-aware task triage
+  - **meta_skill (ms)** - Knowledge management and skill distribution
+  - **remote_compilation_helper (rch)** - Build acceleration for agent swarms
+  - **wezterm_automata (wa)** - Multi-agent orchestration via WezTerm
+  - **brenner_bot** - Research session CLI and orchestration
+
+- **Utility Tools** (9 new):
+  - **toon_rust (tru)** - Token-optimized notation format
+  - **rust_proxy** - Transparent proxy routing
+  - **rano** - Network observer for AI CLIs
+  - **xf** - X (Twitter) archive search
+  - **markdown_web_browser (mdwb)** - Website to Markdown converter
+  - **process_triage (pt)** - Zombie process detector
+  - **aadc** - ASCII diagram corrector
+  - **source_to_prompt_tui (s2p)** - Code to LLM prompt generator
+  - **coding_agent_usage_tracker (caut)** - LLM provider usage tracker
+
+- **E2E Testing**: New comprehensive test suite at `tests/e2e/test_new_tools_e2e.sh`
+  - Verifies all 16 new tools install correctly
+  - Integration tests for acfs doctor, bd alias, flywheel.ts
+  - JSON output for CI integration
+
 - **Automatic Ubuntu Upgrade**: The installer now automatically upgrades Ubuntu to 25.10 before running the main ACFS installation
   - Detects current Ubuntu version and calculates sequential upgrade path
   - Handles reboots automatically via systemd resume service