bullswarm 0.28.1 → 0.28.2

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # bullswarm changelog
 
+## 0.28.2 — terminal glyph fallback, issue watcher, health on a fresh home
+
+- `bullswarm workflow` repainted flashing `?` characters on macOS
+  Terminal.app. Cause is font coverage, not encoding: parsing the `cmap` of
+  every monospace face Terminal.app offers shows **zero** glyphs in the
+  Braille block `U+2800-U+28FF` — Andale Mono, Menlo, SF Mono, Monaco and
+  Courier New are all 0/256 — and none of the five has `⧖` (`U+29D6`) or `⟡`
+  (`U+27E1`). The dashboard's 10-frame Braille spinner advances every 400ms,
+  so every repaint drew a question mark that flashed; the static `✓ ✗ ⊘ ◇ ↳
+  ⚠ ● ○ ■ ♡ ◆ ↻ ↺ ▶ ⚙` icons beside it were the steady ones. Terminal.app
+  does not substitute another face for these ranges.
+- New `src/lib/glyphs.js` holds one table per mode and the detection order:
+  `BULLSWARM_ASCII` forces ASCII, `BULLSWARM_UNICODE` forces Unicode and
+  overrides detection, then a non-UTF-8 locale, `TERM=dumb`/`TERM=linux`, and
+  `TERM_PROGRAM=Apple_Terminal` select ASCII. Every replacement is one column
+  of printable ASCII, because panel width maths uses `String#length` and a
+  wide substitute would shear the borders. Box drawing, `· › × … ≈ ≥ █` are in
+  all five fonts and are left alone, so panels keep their borders.
+- Wired through the three live-refreshing renderers only:
+  `src/workflow/dashboard.js`, `src/workflow/watch-cli.js` and
+  `src/strategy-dashboard.js`. One-shot `✓`/`✗` message prefixes in
+  `src/workflow/cli.js`, `src/help.js`, `src/integrate.js`,
+  `src/workflow/runs-cli.js`, `src/strategy-cli.js` and
+  `src/lib/cli-flags.js` are untouched — they do not flash and are a separate
+  change.
+- `spinnerGlyph` now parks a non-finite frame counter on frame 0. The previous
+  expression `SPINNER_FRAMES[Math.abs(Number(f) || 0) % SPINNER_FRAMES.length]`
+  returned `undefined` for `Infinity`, so a repaint could have painted the
+  string "undefined" into the frame.
+- `tests/glyphs.test.js` covers the detection matrix (including that `''`,
+  `'0'` and `'false'` do not switch tables, and that `LC_ALL` outranks
+  `LANG`), asserts every Unicode entry has a one-column pure-ASCII twin that
+  is never `?`, and renders both dashboards, `renderWatchSnapshot`,
+  `renderWatchEvent` over 15 event shapes and `renderAnalysisProgress` at five
+  spinner frames, asserting no substituted glyph survives in ASCII mode while
+  the Braille spinner still appears in Unicode mode.
+- `tests/strategy-cli.test.js`, `tests/workflow-dashboard.test.js` and
+  `tests/workflow-watch.test.js` assert the Unicode presentation, so they now
+  pin `BULLSWARM_UNICODE=1` and `delete process.env.BULLSWARM_ASCII`; without
+  the pin the suite's own output depended on which terminal the developer ran
+  it in, and without the delete an ambient `BULLSWARM_ASCII=1` — the very
+  workaround the README hands an affected user — outranked the pin and broke
+  22 tests.
+- The four arrows `↑ ↓ ← →` are deliberately not substituted. They are only
+  missing from Monaco, and they live in the frozen `DASHBOARD_KEYS` constant,
+  which binds at import time — before any env pin could apply.
+- `scripts/issue-watcher/` — a durable GitHub issue watcher for this
+  repository, installed as a launchd agent
+  (`node scripts/issue-watcher/install.mjs`). Idle costs ZERO model tokens:
+  a pass is one `gh issue list` and nothing else. Only when an issue appears
+  that is new since install does it delegate — one
+  `bullswarm run --lane analyze` to triage (label + plain-words comment),
+  and for a bug it judged fixable at confidence >= 0.7 one
+  `bullswarm run --lane build` to fix, which the watcher then verifies
+  itself (test suite green in its own clone, diff non-empty) before pushing
+  `fix/issue-<n>` and opening a pull request. Both delegations run on the
+  owner's subscriptions through normal bullswarm routing, never API tokens.
+  Capped at 6 triages and 2 fix attempts per UTC day, one fix attempt per
+  issue; guarded by a pass lock, a `paused` file, and a 3-attempt triage
+  retry cap. Delegates get no GitHub credentials and issue text is quoted as
+  untrusted data. It never merges, closes, or releases — a maintainer does.
+
 ## 0.28.1 — summary bytes on the wire, monthly pacing
 
 - `workflow runs result <id> --summary` was budgeted by `fitResultSummary`

package/README.md

@@ -800,6 +800,25 @@ to toggle Timeline and Phases, then use Enter/Esc for agents and activity.
 bullswarm workflow tui
 ```
 
+#### Terminal glyphs
+
+The live views draw a Braille spinner and symbol status icons. macOS
+Terminal.app cannot render them: Andale Mono, Menlo, SF Mono, Monaco and
+Courier New all have zero glyphs in `U+2800-U+28FF`, and none has `⧖`, so the
+dashboard repaints a flashing `?` where each one should be. Apple Terminal is
+detected and given a one-column ASCII table instead (`|/-\` spinner, `+`
+succeeded, `x` failed, `:` waiting, `#` blocked). Panel borders are unchanged —
+box drawing is present in every one of those fonts.
+
+Override the detection either way:
+
+```bash
+BULLSWARM_ASCII=1 bullswarm workflow      # force ascii (any terminal showing ?)
+BULLSWARM_UNICODE=1 bullswarm workflow    # force unicode (font does have them)
+```
+
+A non-UTF-8 locale, `TERM=dumb` and `TERM=linux` also select ASCII.
+
 The same dashboard is agent-friendly and never requires a TTY when used with
 JSON/control flags:
 
@@ -888,6 +907,19 @@ runtime value and uses its matching connector rate metadata for the attempt's
 cost estimate. Unknown or provider-hidden model identity remains explicitly
 unknown.
 
+## Repository operations
+
+`scripts/issue-watcher/` is a launchd agent that watches this repository's
+GitHub issues. Idle it costs zero model tokens — a pass is one `gh issue
+list` and nothing else. When an issue arrives that is new since install, it
+delegates one analyze run to triage it (label plus a plain-words comment),
+and for a bug it judged fixable at confidence >= 0.7 one build run to fix
+it, verifying the result itself (suite green in its own clone, diff
+non-empty) before pushing `fix/issue-<n>` and opening a pull request. Both
+delegations route through `bullswarm run` on the owner's subscriptions. It
+never merges, closes, or releases. Install, guards, cost model and paths:
+[`scripts/issue-watcher/README.md`](scripts/issue-watcher/README.md).
+
 ## The verdict
 
 ```json