@brokkai/brokk-town-linux-x64 0.4.8 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/BUILD.json CHANGED
@@ -1 +1 @@
1
- {"commit": "9d0accca8ee4ccadc8cec029f3c5fae8f1006c52", "tag": "v0.4.8", "target": "linux-amd64"}
1
+ {"commit": "e186fa3cf4a19489ee7b26f71554b3d0e4650429", "tag": "v0.5.0", "target": "linux-amd64"}
package/README.md CHANGED
@@ -153,14 +153,16 @@ for tag rules, pipeline steps, and recovery.
153
153
  Install and authenticate `git`, GitHub CLI (`gh`), Node.js/npm, and your chosen
154
154
  coding agent. Town does not require a separate bot installation: each dispatch
155
155
  uses `npx --yes` with an exact compatible release of bug-bot, feature-bot,
156
- issue-bot, review-bot, release-bot, or simplifier-bot, then communicates with it over a private
156
+ issue-bot, review-bot, release-bot, simplifier-bot, or mayor-bot, then communicates with it over a private
157
157
  Unix socket. Town never selects an ambient or floating bot version.
158
- Each bot's Settings panel shows its current pin. **Check for bot update** reads
158
+ For a bot npm has not published yet, `BROKK_TOWN_<ROLE>_BOT` names a local
159
+ executable for that role when the service starts, such as `BROKK_TOWN_HALL_BOT`
160
+ for a mayor-bot checkout. Each bot's Settings panel shows its current pin. **Check for bot update** reads
159
161
  npm's stable tag, and **Use VERSION** stages that exact version for the Mayor to
160
162
  save. The pin changes only for that town and takes effect on the bot's next run;
161
163
  capability and reported-version checks still run before any repository work.
162
164
 
163
- Town also checks npm's stable tags on its own, at start and every six hours.
165
+ Town also checks npm's stable tags on its own, at start and every fifteen minutes.
164
166
  When a bot has a newer stable release than a town's pin, the town receives a
165
167
  Mayoral decision at Town Hall: **Upgrade now** pins the new version for the
166
168
  bot's next run, **Delay a day** asks again after 24 hours, and **Decline** keeps
@@ -362,6 +364,7 @@ finish before restoring a town.
362
364
  | Bug greenhouse | Runs bug-bot's investigation and verification; observed filed issues travel to issue-bot. |
363
365
  | Feature study | Runs feature-bot to discover useful new capabilities, independently review their value and feasibility, and compare existing requests; confirmed feature issues travel to issue-bot. |
364
366
  | Simplifier clarifier | Reviews every incoming issue/PR for disproportionate complexity or low value, advises the Mayor, and discovers removal/replacement proposals. |
367
+ | Town Hall (Mayor Bot) | Runs mayor-bot to judge every arrival awaiting a Mayoral decision and to write the town bulletin: the feed of features gained and bugs fixed, written for users. Paused by default; decisions wait for you until it is started. |
365
368
  | Issue workshop | Runs issue-bot on eligible issues, opens implementation-ready PRs, and repairs Town-owned PR branches from review feedback. |
366
369
  | Review observatory | Runs review-bot, independently checks the full change and every retained finding, then returns fixes or waits for merge requirements. |
367
370
  | Release depot | Runs release-bot's batching and publishing policy. Confirmed merged/direct commits accumulate here; a published stable release ships only commits proven to be its ancestors. |
@@ -382,13 +385,19 @@ durable Mayoral decision: **Admit** sends the work to Issue Bot or Review Bot;
382
385
  admit routine work and decline low-value complex work itself; a declined issue is
383
386
  closed through Repo-bot, while a declined PR is ignored rather than closed.
384
387
  Simplifier Bot's own marked proposals do not recursively pass through intake.
385
- Between arrivals, the same worker scans the repository and may file marked
386
- proposals to remove or replace subsystems that add disproportionate complexity
387
- for little value.
388
- The browser provides the primary decision UX; scripts may use
389
- `bt admit --repo OWNER/REPO --task issue:123` or `bt decline ...`. Offered bot
390
- upgrades use the same commands with `--task upgrade:feature` (or another bot
391
- role), plus `bt delay ...` to be asked again in a day.
388
+
389
+ **Mayor Bot** lives in Town Hall. Start it like any other house and it judges
390
+ every arrival that waits for a Mayoral decision: one worker run per arrival,
391
+ in a detached worktree at the exact revision, from the town's description of
392
+ the item (with Simplifier Bot advice or the Town review attached) and the live
393
+ GitHub source. It answers admit, decline, or, for a bot update, delay, with a
394
+ reason kept on the task; decisions go through the same path as your own clicks
395
+ and are recorded under the Mayor Bot name. A judgment that fails is retried
396
+ twice, fifteen minutes apart, then left for you. The same house writes the
397
+ **town bulletin**, shown in Town Hall under "What changed": after work merges,
398
+ at most every `bulletin_seconds` (default 21600), it summarizes the merged pull
399
+ requests for the people who use the software as features, fixes and
400
+ improvements, each citing its pull requests.
392
401
 
393
402
  A review is bound to the exact base, head, PR description, and discussion snapshot. A suppressed
394
403
  duplicate comment is still a finding to check. Complete coverage, explicit
@@ -458,7 +467,8 @@ authenticating each harness. Verification and scheduling settings remain shared
458
467
  at town level.
459
468
 
460
469
  Repo-bot and issue/review scheduling use `poll_seconds` (default 60). Quiet reports
461
- use `report_seconds` (1800). Bug-bot, feature-bot, and simplifier-bot run at most every 30 minutes; release-bot
470
+ use `report_seconds` (1800). Bug-bot, feature-bot, and simplifier-bot run at most every 30 minutes; mayor-bot
471
+ writes a bulletin at most every `bulletin_seconds` (21600) and only after something merged; release-bot
462
472
  checks every five minutes and retains its own quiet window, minimum gap, and
463
473
  batching decisions. Each worker attempt has a two-hour deadline. A pull request
464
474
  gets one fix round and two attempts per revision at any step; `max_cycles` is
package/bin/bt CHANGED
Binary file
package/package.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "0.4.8",
2
+ "version": "0.5.0",
3
3
  "license": "Apache-2.0",
4
4
  "repository": {
5
5
  "type": "git",