@brokkai/brokk-town-linux-x64 0.6.1 → 0.6.3

package/BUILD.json

@@ -1 +1 @@
-{"commit": "a73312969bddc85802cdd968d342cb4fcf54a614", "tag": "v0.6.1-town", "target": "linux-amd64"}
+{"commit": "8c221ceb2c10c36e4c6c02f8c6e485872a7fee67", "tag": "v0.6.3-town", "target": "linux-amd64"}

package/README.md

@@ -4,6 +4,13 @@ Brokk Town is a local service that coordinates independent repository bots throu
 private worker processes. Use the browser to watch and control work, or the CLI
 for scripts. Everything runs on your machine.
 
+The browser has two themes. The default is the town; Frontline draws every
+repository as a base flying one of three armies — humans, humanoid aliens or a
+swarm — and every committed delivery as a strike between its installations. The
+theme is a look, not a lever: it reads the same snapshot, keeps the theme and
+any race chosen for a base in that browser, and never changes what Town does or writes
+to GitHub.
+
 ## Build and run
 
 ```sh
@@ -13,7 +20,9 @@ make build
 ./bin/bt web --demo
 ```
 
-Bare `bt` runs in the foreground and prints its browser URL. Ctrl+C, SIGTERM or
+Bare `bt` runs in the foreground and prints its browser URL. The URL carries the
+access key, so it is printed only to a terminal; redirected output and the
+background service's log point to `bt web` instead. Ctrl+C, SIGTERM or
 SIGHUP stops Town, its bots and their agent processes. Closing the browser does
 not stop the service. Demo mode is isolated and never invokes bots, agents or GitHub.
 
@@ -110,6 +119,118 @@ the Mayor as decision maker and shows Simplifier Bot's advice on every pending
 arrival. Auto lets the bot's assessment route routine work without a separate
 Mayoral decision, including closing low-value complex issues.
 
+### What each bot takes on
+
+Each house can be told what work to accept and how much of it to produce. Every
+setting here is one the bot already supports, and a house refuses a setting it
+cannot honour rather than accepting it and ignoring it:
+
+| Setting | Flag | Houses |
+| --- | --- | --- |
+| Required labels | `--labels` | bug, feature, issue, review, simplifier |
+| Excluded labels | `--exclude-labels` | issue, review |
+| One selected item | `--only` | issue (an issue number), review (a PR number) |
+| Discovery focus | `--focus` | bug, feature, review |
+| Per-run limit | `--limit` | bug/feature (issues filed), review (findings), simplifier (proposals), repo (repair attempts per revision), hall (bulletin items) |
+| Attempts per item | `--attempts` | bug, feature, issue, review, release |
+| Verification command | `--verify` | every house; overrides the town's `verify` |
+| Release cadence, preflight, required workflows and assets | `--release-*` | release |
+
+```sh
+./bin/bt settings --repo BrokkAi/my-project --role issue --labels agent-ready --exclude-labels needs-discussion
+./bin/bt settings --repo BrokkAi/my-project --role issue --only 412
+./bin/bt settings --repo BrokkAi/my-project --role bug --focus 'the storage layer' --limit 3
+./bin/bt settings --repo BrokkAi/my-project --role review --verify '["make","review-check"]'
+./bin/bt settings --repo BrokkAi/my-project --role release --release-quiet-seconds 900 --release-burst 10 --release-burst-window-seconds 3600 --release-triage on
+./bin/bt settings --repo BrokkAi/my-project --role issue --clear-policy
+```
+
+Config-file towns take the same settings under `bot_policies`, keyed by house;
+the example lists every supported field. A town that sets none behaves exactly
+as it did before these settings existed.
+
+Town applies the same filters to its own queue that it sends to the bot, so the
+queue you read is the queue the house will take from. Filtered work is not
+hidden: each house's inspector states its policy, counts the inventory it holds
+back, and marks each held item, so you can always see what your own filter
+excluded. A house whose bundled bot is too old to read a policy is refused the
+dispatch with the bot and version named, instead of running unfiltered.
+
+### Agent budgets
+
+A town can bound how much automation it starts in a repeating accounting period:
+
+```sh
+./bin/bt settings --repo BrokkAi/my-project --budget-period day --budget-attempts 40 --budget-agent-minutes 600
+./bin/bt settings --repo BrokkAi/my-project --budget-period none
+```
+
+The period is `day`, `week`, or `month` on your local clock, and at least one of
+`--budget-attempts` or `--budget-agent-minutes` is required. Config-file towns
+take the same settings as `"budget": {"period": "day", "max_attempts": 40,
+"max_agent_minutes": 600}`.
+
+Town charges the budget for every attempt that started an agent. A repository
+inventory reads GitHub without one and is never charged; a branch repair is.
+When a ceiling is reached, Town stops dispatching new agent work for that town
+and says so in Town Hall with the time the period resets. Work already running
+finishes normally, cancellation and saved work are untouched, and the repository
+inventory keeps running so uncertain writes can still be reconciled. Other towns
+are unaffected: a budget is per town, not per worker slot.
+
+**Town cannot cap token or dollar spend.** No bundled agent harness reports usage
+back through the worker protocol -- the acp-go runner hands a bot the agent's
+final text and nothing else -- so Town would be enforcing a limit against numbers
+it never receives. Attempts and agent minutes are what it measures, so those are
+what it enforces. Where usage or cost is missing, Town Hall prints "not
+reported"; it never shows absent telemetry as zero. Attempts whose elapsed time
+never arrived are counted and reported separately rather than billed as free.
+
+### Quiet hours
+
+Quiet hours are weekly windows in which Town starts no new agent work and
+makes none of its own GitHub writes: no filing, repairing, reviewing, merging
+or releasing. Set a default for every town, give one town its own windows, or
+opt one town out:
+
+```sh
+# Service default: weeknights and weekends.
+./bin/bt settings --quiet-hours "mon-fri 19:00-07:00; weekends 00:00-24:00"
+./bin/bt settings --quiet-hours none            # remove the service default
+# One town's own windows, none at all, or back to the service default.
+./bin/bt settings --repo BrokkAi/my-project --quiet-hours "daily 12:00-13:00"
+./bin/bt settings --repo BrokkAi/my-project --quiet-hours none
+./bin/bt settings --repo BrokkAi/my-project --quiet-hours default
+```
+
+Each window is `DAYS HH:MM-HH:MM`, joined with `;`. Days are `mon` through
+`sun`, ranges such as `mon-fri` or `fri-mon`, or `daily`, `weekdays` and
+`weekends`, and name the day a window starts. An end at or before the start runs
+past midnight into the next day, and `24:00` ends a window at midnight.
+Overlapping windows count as one. A window with no day, an unknown day, a time
+that is not `HH:MM`, or the same start and end is refused with the reason. The
+browser edits the same schedules: the service default under Capacity, and a
+town's own in Town settings. Config files take `"quiet_hours": [{"days":
+["mon"], "start": "19:00", "end": "07:00"}]` at the top level for the default
+and in a town entry for its own, where `[]` opts the town out.
+
+Windows are read on the local clock of the machine running Town, by the clock
+on the wall: a window holds through a daylight-saving change, an hour the clock
+skips is never quiet, and an hour it repeats is quiet both times.
+
+Inside a window, work already running finishes as it would after Pause, and
+the repository inventory keeps running so uncertain writes are still
+reconciled. Town leaves closing declined issues and retired pull requests and
+filing review follow-ups for the first inventory after the window. Issues you
+submit yourself are still posted. Houses stay awake: the browser shows them as
+*quiet* rather than paused, the town header reads "Quiet hours · until …",
+Town Hall explains the hold, and `bt status` carries the same `quiet_hours`
+state for each town. When the window ends, scheduling resumes on its own with
+each house's usual cadence; nothing missed is replayed. Pause and quiet hours
+are independent and both survive a restart: a paused house stays paused after
+the window, and a woken one resumes. Release Bot's own release quiet period
+(`--release-quiet-seconds`) is unrelated and keeps working as before.
+
 For each profile, select any agent from the
 [official ACP registry](https://agentclientprotocol.com/get-started/registry),
 plus **Anvil**, **Muse ACP**, **Draupnir**, or a custom ACP command. The full
@@ -206,8 +327,14 @@ To remove a town, choose **Settings → Delete town** and confirm, or run:
 Deletion cancels its workers, cancels queued issue submissions, and removes it
 from the browser and terminal. GitHub repositories, issues, and PRs are preserved.
 Local history, uncertain writes, and private worktrees remain as recovery records.
-Adding the same repository again restores that history and its previous settings,
-with automation paused and the reporter enabled. Wait for stopping workers to
+Adding the same repository again restores that history and its previous
+settings, with automation paused and the reporter enabled. A merge policy or
+harness/agent choice given with the add replaces the previous one; budgets, work
+policies, bot profiles, funnels and the branch are kept. A deleted town listed in
+`bt serve --config` is restored with the file's settings, and one named by
+`bt serve --repo` with its previous settings; `bt serve` prints a notice. A town
+that already worked on one branch cannot be restored onto another. Deleting a
+town that is already deleted reports `unknown town`. Wait for stopping workers to
 finish before restoring a town.
 
 ## How work moves
@@ -276,7 +403,8 @@ limit its authority to publish while forbidding its release-preparation PR merge
 Town pauses Release Bot and rejects attempts to start or retry it under this policy.
 `all` also permits eligible external PRs. Town-managed merges require current clean Town evidence, GitHub mergeability, required checks
 and approvals. Town uses an expected-head squash merge, without admin bypass.
-Change this at any time under **Town Settings → External contributions**.
+Change this at any time under **Town Settings → External contributions**, or
+with `./bin/bt settings --repo BrokkAi/my-project --merge-policy manual`.
 Repositories that require a merge queue or prohibit squash merging need manual
 merges for now. GitHub is the final authority at write time.
 
@@ -292,9 +420,12 @@ bot profiles, verification command, and policy, then run:
 Configuration is a JSON array for town-only files. Each entry supplies `repo`, optional `branch` and
 `harness`, `agent`, optional `bot_agents`, optional `verify` argument vector,
 `merge_policy`, `simplifier_mode`, optional `review_close_severity` (`P1`, `P2`
-or `P3`, default `P2`), `poll_seconds`, `report_seconds`, and
-`max_cycles`. The example
-lists all required values. To persist global capacity alongside the town list,
+or `P3`, default `P2`), optional `budget`, optional `bot_policies`,
+`poll_seconds`, `report_seconds`, and `max_cycles`. The example
+lists all required values. A config-file entry gets no defaults for
+`merge_policy`, `poll_seconds`, `report_seconds`, or `max_cycles`: omitting any
+of them rejects the file. The defaults quoted below apply to towns added with
+`bt add` or the browser. To persist global capacity alongside the town list,
 use the object form `{"max_workers": 2, "towns": [...]}`; the legacy array form
 remains accepted. When `serve --config` includes `max_workers`, that value
 overrides the persisted service setting in the same atomic state update; an
@@ -323,7 +454,9 @@ Repo-bot and issue/review scheduling use `poll_seconds` (default 60). Quiet repo
 use `report_seconds` (1800). Bug-bot, feature-bot, and simplifier-bot run at most every 30 minutes; mayor-bot
 writes a bulletin at most every `bulletin_seconds` (21600) and only after something merged; release-bot
 checks every five minutes and retains its own quiet window, minimum gap, and
-batching decisions. Each worker attempt has a two-hour deadline. A pull request
+batching decisions. Each worker attempt, including the repo inventory, has a
+two-hour deadline, and each GitHub call Town makes itself, such as the merge
+gate's read, gives up after one minute. A pull request
 gets one fix round and two attempts per revision at any step; `max_cycles` is
 accepted for compatibility but no longer extends that.
 
@@ -433,10 +566,38 @@ the reported failure and ask Town to lift the budget:
 
 The next release run first calls the bot's `POST /v1/retry` worker API, which
 resets the pending release's attempt budget in its own workspace, then resumes
-the same release. Town never edits the bot's private state. The pinned Release
+the same release. Unlike a task retry, a release retry also starts the release
+house if it was paused. Town never edits the bot's private state. The pinned Release
 Bot must advertise the `retry` capability; older pins report that plainly.
 Use `bt status` to inspect saved details and GitHub to resolve conflicts.
 
+### Snoozing one task
+
+To set one issue or pull request aside without pausing its house, snooze it
+until a chosen time. Open the task in the browser and choose **Snooze…**, or:
+
+```sh
+./bin/bt defer --repo BrokkAi/my-project --task pr:123 --until 2d --reason "waiting on the vendor fix"
+./bin/bt defer --repo BrokkAi/my-project --task issue:45 --until 2026-10-01T09:00:00Z
+./bin/bt undefer --repo BrokkAi/my-project --task pr:123
+```
+
+`--until` takes an RFC 3339 time or a delay from now (`90m`, `4h`, `2d`); the
+resume time must be in the future and within 366 days, and the reason is one
+line of at most 200 characters. The house keeps working the rest of its queue.
+Until the resume time, no agent starts for the snoozed task: Issue, Review and
+Simplifier Bots skip it, Mayor Bot does not judge it, and Town does not merge
+it. A run already under way when you snooze finishes. The Mayor can still decide
+a snoozed arrival by hand.
+
+The task shows as **Snoozed** with its reason and resume time in the browser
+and in `bt status` (`deferred_until`, `defer_reason`). Snoozed is distinct from
+blocked and failed, so a snoozed task does not appear in the inbox. At the
+resume time Town clears the snooze, wakes the house and records the event; the
+snooze is saved state, so it survives a restart and repository reconciliation.
+Resume now (`bt undefer`) makes the task eligible immediately. Finished work
+(merged, closed, declined, or an implemented issue) cannot be snoozed.
+
 The HTTP listener accepts loopback IPs only (default `127.0.0.1:8099`). Host,
 origin, and bearer key checks protect the local API. A browser supporting WebMCP
 can list towns and navigate to a house through optional page tools. Unsupported

package/bots/feature-bot/licenses/THIRD_PARTY_NOTICES.txt

@@ -8,9 +8,9 @@ Node.js and Python interpreters are installed separately and are not bundled.
 
 ==============================================================================
 
-github.com/BrokkAi/acp-go v0.7.0
+github.com/BrokkAi/acp-go v0.10.0
 License: Apache-2.0
-Source: https://github.com/BrokkAi/acp-go/tree/v0.7.0
+Source: https://github.com/BrokkAi/acp-go/tree/v0.10.0
 
 ==============================================================================
 

package/bots/issue-bot/licenses/THIRD_PARTY_NOTICES.txt

@@ -8,9 +8,9 @@ Node.js and Python interpreters are installed separately and are not bundled.
 
 ==============================================================================
 
-github.com/BrokkAi/acp-go v0.1.0
+github.com/BrokkAi/acp-go v0.8.1
 License: Apache-2.0
-Source: https://github.com/BrokkAi/acp-go/tree/v0.1.0
+Source: https://github.com/BrokkAi/acp-go/tree/v0.8.1
 
 ==============================================================================
 
@@ -221,6 +221,25 @@ Source: https://github.com/BrokkAi/acp-go/tree/v0.1.0
 
 ==============================================================================
 
+--- github.com/BrokkAi/acp-go/NOTICE ---
+
+acp-go
+Copyright 2026 Brokk.ai and contributors
+
+This project is licensed under the Apache License, Version 2.0.
+See LICENSE for the full terms. Third-party terms and attribution are
+provided in licenses/THIRD_PARTY_NOTICES.txt.
+
+Originally developed as part of BrokkAi/release-bot.
+
+The pinned Agent Client Protocol JSON Schema artifacts in schema/
+(schema.json, meta.json, VERSION) are distributed by the ACP project
+(https://github.com/agentclientprotocol/agent-client-protocol) under the
+Apache License 2.0. The generated code in schema/*_gen.go derives from
+those artifacts.
+
+==============================================================================
+
 github.com/rivo/uniseg v0.4.7
 License: MIT AND Unicode-3.0
 Source: https://github.com/rivo/uniseg/tree/v0.4.7

package/bots/review-bot/licenses/THIRD_PARTY_NOTICES.txt

@@ -8,9 +8,9 @@ Node.js and Python interpreters are installed separately and are not bundled.
 
 ==============================================================================
 
-github.com/BrokkAi/acp-go v0.1.0
+github.com/BrokkAi/acp-go v0.8.1
 License: Apache-2.0
-Source: https://github.com/BrokkAi/acp-go/tree/v0.1.0
+Source: https://github.com/BrokkAi/acp-go/tree/v0.8.1
 
 ==============================================================================
 
@@ -221,6 +221,25 @@ Source: https://github.com/BrokkAi/acp-go/tree/v0.1.0
 
 ==============================================================================
 
+--- github.com/BrokkAi/acp-go/NOTICE ---
+
+acp-go
+Copyright 2026 Brokk.ai and contributors
+
+This project is licensed under the Apache License, Version 2.0.
+See LICENSE for the full terms. Third-party terms and attribution are
+provided in licenses/THIRD_PARTY_NOTICES.txt.
+
+Originally developed as part of BrokkAi/release-bot.
+
+The pinned Agent Client Protocol JSON Schema artifacts in schema/
+(schema.json, meta.json, VERSION) are distributed by the ACP project
+(https://github.com/agentclientprotocol/agent-client-protocol) under the
+Apache License 2.0. The generated code in schema/*_gen.go derives from
+those artifacts.
+
+==============================================================================
+
 github.com/rivo/uniseg v0.4.7
 License: MIT AND Unicode-3.0
 Source: https://github.com/rivo/uniseg/tree/v0.4.7

package/bundle.json

@@ -3,32 +3,32 @@
     "bug": {
       "project": "bug-bot",
       "command": "bbb",
-      "version": "0.3.7",
-      "source_commit": "ecac6efcee71e64b5ef3a6ad3ac8faf60aaca36a"
+      "version": "0.6.0",
+      "source_commit": "29d20411d60b0eab94910346efef28d42c9c66ac"
     },
     "feature": {
       "project": "feature-bot",
       "command": "bfb",
-      "version": "0.1.4",
-      "source_commit": "7f0967dc8e43d7cfa07c18e7e98cf49a88917fa2"
+      "version": "0.4.0",
+      "source_commit": "4c9cc8cd7dced2c065a5e43c3d875683d0534087"
     },
     "issue": {
       "project": "issue-bot",
       "command": "bib",
-      "version": "0.5.6",
-      "source_commit": "03fea25c14b28a7e3b86488c5f99b90ea6bb28a4"
+      "version": "0.5.9",
+      "source_commit": "88ed397f9862f2c069372b15ef24282ec3bf4ed9"
     },
     "review": {
       "project": "review-bot",
       "command": "brv",
-      "version": "0.2.6",
-      "source_commit": "87ddecf9b1a567795c7624c16cc16ea6243f2779"
+      "version": "0.2.9",
+      "source_commit": "c940c1888346d6d77ad88257cec8946ed8adb90b"
     },
     "release": {
       "project": "release-bot",
       "command": "brb",
-      "version": "0.6.3",
-      "source_commit": "d7222a04471383ab228bda3c4b585ad73f61631d"
+      "version": "0.8.0",
+      "source_commit": "328694104cb6ce20d8276a79a517ff75809a12e8"
     },
     "repo": {
       "project": "repo-bot",

package/licenses/THIRD_PARTY_NOTICES.txt

@@ -8,9 +8,9 @@ Node.js and Python interpreters are installed separately and are not bundled.
 
 ==============================================================================
 
-github.com/BrokkAi/acp-go v0.1.0
+github.com/BrokkAi/acp-go v0.8.1
 License: Apache-2.0
-Source: https://github.com/BrokkAi/acp-go/tree/v0.1.0
+Source: https://github.com/BrokkAi/acp-go/tree/v0.8.1
 
 ==============================================================================
 
@@ -221,6 +221,25 @@ Source: https://github.com/BrokkAi/acp-go/tree/v0.1.0
 
 ==============================================================================
 
+--- github.com/BrokkAi/acp-go/NOTICE ---
+
+acp-go
+Copyright 2026 Brokk.ai and contributors
+
+This project is licensed under the Apache License, Version 2.0.
+See LICENSE for the full terms. Third-party terms and attribution are
+provided in licenses/THIRD_PARTY_NOTICES.txt.
+
+Originally developed as part of BrokkAi/release-bot.
+
+The pinned Agent Client Protocol JSON Schema artifacts in schema/
+(schema.json, meta.json, VERSION) are distributed by the ACP project
+(https://github.com/agentclientprotocol/agent-client-protocol) under the
+Apache License 2.0. The generated code in schema/*_gen.go derives from
+those artifacts.
+
+==============================================================================
+
 Go runtime and standard library (BSD-3-Clause)
 Source: https://go.googlesource.com/go/+/refs/tags/go1.27.1/LICENSE
 

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.6.1",
+  "version": "0.6.3",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",