@brokkai/brokk-town-linux-x64 0.5.0 → 0.6.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.
Files changed (38) hide show
  1. package/BUILD.json +1 -1
  2. package/README.md +74 -239
  3. package/bin/bbb +0 -0
  4. package/bin/bfb +0 -0
  5. package/bin/bib +0 -0
  6. package/bin/bmb +0 -0
  7. package/bin/brb +0 -0
  8. package/bin/brp +0 -0
  9. package/bin/brv +0 -0
  10. package/bin/bsb +0 -0
  11. package/bin/bt +0 -0
  12. package/bots/bug-bot/LICENSE +202 -0
  13. package/bots/bug-bot/NOTICE +6 -0
  14. package/bots/bug-bot/licenses/THIRD_PARTY_NOTICES.txt +488 -0
  15. package/bots/feature-bot/LICENSE +202 -0
  16. package/bots/feature-bot/NOTICE +11 -0
  17. package/bots/feature-bot/licenses/THIRD_PARTY_NOTICES.txt +507 -0
  18. package/bots/issue-bot/LICENSE +202 -0
  19. package/bots/issue-bot/NOTICE +6 -0
  20. package/bots/issue-bot/licenses/THIRD_PARTY_NOTICES.txt +488 -0
  21. package/bots/mayor-bot/LICENSE +21 -0
  22. package/bots/mayor-bot/NOTICE +6 -0
  23. package/bots/mayor-bot/licenses/THIRD_PARTY_NOTICES.txt +326 -0
  24. package/bots/release-bot/LICENSE +202 -0
  25. package/bots/release-bot/NOTICE +6 -0
  26. package/bots/release-bot/licenses/THIRD_PARTY_NOTICES.txt +507 -0
  27. package/bots/repo-bot/LICENSE +21 -0
  28. package/bots/repo-bot/NOTICE +6 -0
  29. package/bots/repo-bot/licenses/THIRD_PARTY_NOTICES.txt +488 -0
  30. package/bots/review-bot/LICENSE +202 -0
  31. package/bots/review-bot/NOTICE +9 -0
  32. package/bots/review-bot/licenses/THIRD_PARTY_NOTICES.txt +488 -0
  33. package/bots/simplifier-bot/LICENSE +21 -0
  34. package/bots/simplifier-bot/NOTICE +6 -0
  35. package/bots/simplifier-bot/licenses/THIRD_PARTY_NOTICES.txt +488 -0
  36. package/bundle.json +52 -0
  37. package/licenses/THIRD_PARTY_NOTICES.txt +0 -386
  38. package/package.json +1 -1
package/BUILD.json CHANGED
@@ -1 +1 @@
1
- {"commit": "e186fa3cf4a19489ee7b26f71554b3d0e4650429", "tag": "v0.5.0", "target": "linux-amd64"}
1
+ {"commit": "fe09bb76832dc28fd874ee55cd809c4c8b874d27", "tag": "v0.6.0-town", "target": "linux-amd64"}
package/README.md CHANGED
@@ -1,245 +1,98 @@
1
1
  # Brokk Town
2
2
 
3
- One repository, one little town. Brokk Town runs several repository towns from a
4
- local Go service, with an animated browser village and a compact terminal control
5
- panel. Each town owns its houses, queues, review loops, releases, and history.
6
- Branches and private worktrees belong to their repository's town. Your machine
7
- hosts the towns and shares a configurable pool of agent worker slots between
8
- them (four by default, from one to 64).
3
+ Brokk Town is a local service that coordinates independent repository bots through
4
+ private worker processes. Use the browser to watch and control work, or the CLI
5
+ for scripts. Everything runs on your machine.
9
6
 
10
- The browser shows worker houses, wheelbarrows carrying completed handoffs, trucks
11
- bringing external issues and PRs, and shipments leaving the release depot. Every
12
- house label names the harness, model and effort that house runs, so a bot on a
13
- different harness or a higher effort is visible without opening it; the terminal
14
- panel carries the same profile in its house table. Visit a house to inspect its
15
- queue, activity, errors, and controls. Town hall holds
16
- repo-bot's reports. The all-towns overview shows activity and attention counts
17
- without visiting each repository.
18
-
19
- [![CI](https://github.com/BrokkAi/brokk-town/actions/workflows/ci.yml/badge.svg)](https://github.com/BrokkAi/brokk-town/actions/workflows/ci.yml)
20
-
21
- This is the first local implementation. The browser UI is embedded in the Go
22
- binary; Node.js is only needed for UI development checks and agents that use it.
23
- Linux and macOS are supported. No hosted service is required.
24
-
25
- ## Try the town
26
-
27
- Build with the Go version in `go.mod`:
7
+ ## Build and run
28
8
 
29
9
  ```sh
30
10
  make build
31
- ./bin/bt tui --demo
11
+ ./bin/bt --demo
12
+ # In another terminal:
13
+ ./bin/bt web --demo
32
14
  ```
33
15
 
34
- Any `bt` command starts the town service in the background when it is not
35
- running. Press `q` to leave the terminal panel; the town keeps going. Print the
36
- browser address with:
16
+ Bare `bt` runs in the foreground and prints its browser URL. Ctrl+C, SIGTERM or
17
+ SIGHUP stops Town, its bots and their agent processes. Closing the browser does
18
+ not stop the service. Demo mode is isolated and never invokes bots, agents or GitHub.
37
19
 
38
20
  ```sh
39
- ./bin/bt web --demo
21
+ bt -d # explicitly start in the background
22
+ bt service status
23
+ bt web # print the running service's browser URL
24
+ bt service stop # stop Town and its bots
40
25
  ```
41
26
 
42
- Demo mode uses an isolated state directory and simulated activity in two towns.
43
- It never calls GitHub or launches agents. Orchard cycles through bug and feature discovery,
44
- implementation, review, repair, merge, release, and external arrivals. The initial
45
- board includes blocked, inconclusive, uncertain-write, queued, ready, and shipped
46
- fixtures, with active worker profiles available to inspect. Paper-trail illustrates
47
- a neighboring repository with a failed watchtower. Pause a house to hold its next step.
48
-
49
- The browser and TUI attach to the same service. Closing either leaves workers
50
- running. `bt` without a command opens the TUI. Use `bt web` to print the browser
51
- address again; the local access key is persistent, so bookmarks and open tabs
52
- survive restarts.
53
-
54
- ### The service keeps itself running
55
-
56
- There is nothing to install or remember. The first `bt` command that starts a
57
- real town also registers the service with your login session: a launchd agent
58
- on macOS (`~/Library/LaunchAgents/ai.brokk.town.plist`) or a systemd user unit
59
- on Linux (`~/.config/systemd/user/brokk-town.service`). From then on the town
60
- restarts after a crash and returns after a reboot without any command, and the
61
- browser page reloads itself when a new version comes up. The demo town is never
62
- registered; it starts on demand and stays until stopped.
63
-
64
- - `bt service status` shows the service, its registration, and log locations
65
- (`logs/serve.log` and `logs/serve.err.log` under the state directory).
66
- - `bt service stop` stops it until the next `bt` command. `bt service restart`
67
- restarts it in place.
68
- - `bt service off` keeps the service out of your login session; `bt` still
69
- starts it on demand, but it will not return by itself after logout or reboot.
70
- `bt service on` registers it again.
71
- - `bt serve` still runs the service in the foreground for development. It
72
- refuses to start while another service holds the state directory and names
73
- that process.
74
-
75
- The registration captures the `PATH` of the shell that created it, so `gh`,
76
- `git`, `npx`, and your chosen agent are found without a login shell. A
77
- `--listen` address given to any command is remembered for that town, so a later
78
- command's default never moves a registered service to another port. On Linux,
79
- `bt` enables lingering for your user so the town survives logout; if that needs
80
- administrator approval, it says so. Over SSH on a Mac without a logged-in
81
- session there is no launchd user domain, so the service runs unregistered.
82
-
83
- When you rebuild or upgrade `bt`, the next `bt` command notices that the running
84
- service is older and restarts it on the new binary. An older `bt` never
85
- downgrades a running service.
86
-
87
- The browser header switches among **Town**, **Board**, and **Compact** without
88
- restarting. Town keeps the animated houses first-class; Board groups durable work
89
- into fixed workflow columns with bounded, independently scrollable task lists;
90
- Compact lists worker activity, profiles, scheduling
91
- eligibility and tasks. Select **All towns** or a repository in the sidebar to
92
- change scope. View and scope survive reloads. Cards and rows open the shared
93
- inspector and controls, retaining repository context across SSE updates. Board
94
- column headings stay visible while scrolling; live updates preserve each column’s
95
- scroll position.
96
-
97
- Use **T**, **B**, or **C** to switch views, **0** for all towns, and **1–7** for
98
- houses. The view tabs also support arrow keys, Home and End. Tab/Enter open cards
99
- and controls; Escape closes the inspector. Narrow screens stack operations
100
- content and reduced-motion preferences keep the animated Town usable.
101
-
102
- Blocked, failed, inconclusive, uncertain-write and GitHub-waiting states retain
103
- separate labels. Active worker cards do not imply every task at that house is
104
- running. Merged PRs and implemented/closed tasks remain distinct from shipped
105
- commits; only release ancestry confirmed by repository reconciliation can mark
106
- a commit shipped. Columns, prompts and transitions are not programmable.
27
+ Client commands require a running service. There is no login registration,
28
+ automatic service replacement, terminal UI, version polling or in-app installer.
29
+ `bt serve` is an explicit alias for foreground operation. Use `--state-dir` for
30
+ an independent installation and `--listen` for a loopback address.
107
31
 
108
- ## Installation and releases
32
+ ## Independent bot projects
109
33
 
110
- Source is published at [BrokkAi/brokk-town](https://github.com/BrokkAi/brokk-town).
111
- The stable release is available from [GitHub](https://github.com/BrokkAi/brokk-town/releases/tag/v0.1.1)
112
- and npm:
34
+ The `bots/` directories are standalone projects with their own Go modules, CLI
35
+ commands, tests, documentation and packaging:
113
36
 
114
- ```sh
115
- npm install -g @brokkai/brokk-town
116
- ```
37
+ | Project | Command |
38
+ |---|---|
39
+ | bug-bot | bbb |
40
+ | feature-bot | bfb |
41
+ | issue-bot | bib |
42
+ | review-bot | brv |
43
+ | release-bot | brb |
44
+ | repo-bot | brp |
45
+ | simplifier-bot | bsb |
46
+ | mayor-bot | bmb |
47
+
48
+ Build any bot by running `go build ./cmd/<command>` inside its directory.
49
+ Town never imports bot Go packages. Each module chooses its own released acp-go
50
+ dependency. The only integration boundary is the local worker protocol.
117
51
 
118
- While the service is running, Town checks npm outside its input and render loops.
119
- When a newer stable release is available, the browser offers an **Upgrade Town**
120
- button and the TUI offers `u`. After confirmation, the service installs that exact
121
- version through the channel it was installed from (npm for the npm package,
122
- otherwise the checksum-verified release archive over the current binary) and
123
- restarts itself in place; the browser page reloads when the new version is up.
124
- Bots that were mid-run keep working through the restart and are reconnected.
125
- A failed or offline check never interrupts local operation.
52
+ `bundle.json` records the exact bot versions supported by this Town build and
53
+ original source commits. `make build` builds all nine executables into `bin/`.
54
+ Town resolves its bots beside its own executable and verifies their versions.
55
+ A standalone `go install` of only `bt` is not a complete Town installation.
126
56
 
127
- You can also build from source as above or install the current branch:
57
+ ## Installation and releases
128
58
 
129
59
  ```sh
130
- go install github.com/BrokkAi/brokk-town/cmd/bt@master
60
+ npm install -g @brokkai/brokk-town
61
+ # Or install a published complete native bundle:
62
+ sh install.sh vX.Y.Z-town
131
63
  ```
132
64
 
133
- The release pipeline builds checksum-verified Linux/macOS archives for amd64 and
134
- arm64, plus `@brokkai/brokk-town` and four native npm packages. All packages carry
135
- the project license, attribution, and complete third-party notices. The supported
136
- installer commands are:
65
+ Both installation paths include Town and all eight supported bots. To install a
66
+ new version, stop Town, install the complete package, and start Town again.
67
+ The shell installer requires Python 3 and keeps each complete installation in
68
+ its own directory under `INSTALL_DIR/.brokk-town`, with `bt` pointing to it.
137
69
 
138
- ```sh
139
- sh install.sh # From a checkout; defaults to ~/.local/bin
140
- npm install -g @brokkai/brokk-town # Installs the bt launcher and native package
141
- ```
70
+ Projects have independent versions and suffix release tags: `vX.Y.Z-town`,
71
+ `vX.Y.Z-issue-bot`, and equivalent tags for the other bots. A Town release bundles
72
+ the versions in its manifest without publishing unchanged standalone bots.
73
+ See [RELEASING.md](RELEASING.md) for workflows and publishing configuration.
74
+
75
+ ## Connect repositories
142
76
 
143
- Pushing a `v*` tag publishes the release: the `Publish packages` workflow runs
144
- CI, builds the archives and npm packages, publishes with provenance, and
145
- finalizes the GitHub release. The `packages-publish` environment and npm
146
- trusted publishers are bound to this repository and `publish-packages.yml`;
147
- keep both names stable. Visibility is public and
148
- collaborator/developers-team access matches mjolnir. See [RELEASING.md](RELEASING.md)
149
- for tag rules, pipeline steps, and recovery.
150
-
151
- ## Connect real repositories
152
-
153
- Install and authenticate `git`, GitHub CLI (`gh`), Node.js/npm, and your chosen
154
- coding agent. Town does not require a separate bot installation: each dispatch
155
- uses `npx --yes` with an exact compatible release of bug-bot, feature-bot,
156
- issue-bot, review-bot, release-bot, simplifier-bot, or mayor-bot, then communicates with it over a private
157
- Unix socket. Town never selects an ambient or floating bot version.
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
161
- npm's stable tag, and **Use VERSION** stages that exact version for the Mayor to
162
- save. The pin changes only for that town and takes effect on the bot's next run;
163
- capability and reported-version checks still run before any repository work.
164
-
165
- Town also checks npm's stable tags on its own, at start and every fifteen minutes.
166
- When a bot has a newer stable release than a town's pin, the town receives a
167
- Mayoral decision at Town Hall: **Upgrade now** pins the new version for the
168
- bot's next run, **Delay a day** asks again after 24 hours, and **Decline** keeps
169
- the current pin until an even newer release is published. The **Update bots
170
- automatically** town setting (off by default) pins new stable releases as they
171
- appear instead, including any offer already waiting. A registry outage never
172
- changes a pin or stops a town.
173
-
174
- The worker uses
175
- standard-library HTTP/JSON, negotiates protocol and capabilities before work,
176
- streams contiguous progress events, and returns explicit typed results. It never
177
- requires Town to parse bot-private state. Until the worker protocol carries job
178
- outcomes, Town uses the same pinned issue-bot release's validated public state
179
- API to import blocked/submitted scheduling metadata and perform explicit retries.
180
- See
181
- [docs/WORKER_PROTOCOL.md](docs/WORKER_PROTOCOL.md) for the contract.
182
-
183
- Town defaults to the official ACP registry’s `codex-acp` npm distribution, which
184
- requires Node.js and `npx`. Choose another harness in Settings as described below.
185
- Git must already be able to clone and push your GitHub repositories; Town uses
186
- the current Git/gh credentials.
187
-
188
- Town resolves and hashes the `npx` executable for every dispatch and rechecks it
189
- and the pinned bot's reported version afterward. A mid-dispatch executable or
190
- version change fails uncertainly and is resolved through durable bot state and
191
- GitHub reconciliation.
77
+ Authenticate `gh` and your chosen agent first. Start Town, then add a repository:
192
78
 
193
79
  ```sh
194
- ./bin/bt serve --repo BrokkAi/my-project
80
+ bt
195
81
  # In another terminal:
196
- ./bin/bt add --repo BrokkAi/another-project
197
- ./bin/bt tui
82
+ bt add --repo OWNER/REPO
83
+ bt start --repo OWNER/REPO --role issue
84
+ bt capacity --max-workers 4
198
85
  ```
199
86
 
200
- Town starts and manages the bot libraries internally; the standalone bot CLIs are
201
- not companion processes. New towns start with Bug Bot, Feature Bot, Issue Bot,
202
- Review Bot, Release Bot, and Simplifier Bot **paused**. Repo Bot starts its inventory;
203
- its configured agent is used only when branch checks require a repair.
204
- The town header shows whether the town is paused, awake,
205
- or partly awake, and its button offers the action that changes that state.
206
- Inspect the town, then start individual workers or choose **Wake the town**, which
207
- enables all six automation workers (except Release Bot under manual merge policy).
208
- Starting workers authorizes their real work: filing issues,
209
- creating and repairing PRs, posting reviews, merging under the configured policy,
210
- and publishing releases. Agents and verification commands run with your local
211
- permissions. Use an isolated account or machine for repositories you don't trust.
212
-
213
- ```sh
214
- ./bin/bt start --repo BrokkAi/my-project --role bug
215
- ./bin/bt start --repo BrokkAi/my-project --role feature
216
- ./bin/bt pause --repo BrokkAi/my-project --role all
217
- ./bin/bt stop --repo BrokkAi/my-project --role issue
218
- ./bin/bt status
219
- # Change the global pool; status also reports active and limit capacity.
220
- ./bin/bt capacity --max-workers 2
221
- ```
87
+ Each configured town starts all eight bot processes immediately, including paused
88
+ houses. Pausing controls work; it does not remove the process. Agents start only
89
+ when jobs are dispatched. Repo Bot begins with read-only inventory; automation
90
+ houses start paused. Existing concurrency limits and GitHub authority checks apply.
222
91
 
223
- Pause finishes active work and stops scheduling more. Stop also cancels active
224
- work. Enabled/paused settings survive restarts. A restart resumes enabled workers;
225
- uncertain external writes retain their saved intent and are reconciled first.
226
-
227
- Stopping or restarting the service (Ctrl+C, SIGTERM, SIGHUP from a closed
228
- terminal or dropped SSH session, `bt service restart`, or
229
- an in-app upgrade) does not stop the external bots. Each bot process runs detached, and Town commits its handle (PID,
230
- socket, and exact task) before requesting work. The next `bt serve` reconnects to
231
- those processes before scheduling anything new. Bots that advertise the `detach`
232
- capability replay the events Town missed and their results are applied normally.
233
- Older bots finish on their own, and Town records that attempt as uncertain rather
234
- than guessing; repo-bot then reconciles whatever landed on GitHub. Only an explicit
235
- Stop, a town deletion, or the two-hour dispatch deadline ends a bot process.
236
-
237
- Capacity is a persisted service setting shared by every town. It reserves
238
- non-reporter bot runs; repo-bot inventory, issue publishing, and prompt-free model
239
- choice discovery stay outside the pool, while a Repo Bot repair uses one slot.
240
- Lowering the limit lets current work finish and
241
- holds new dispatches until a slot is free. `bt capacity` requires `--max-workers N`,
242
- where `N` is an integer from 1 through 64.
92
+ Deleting a town stops its workers. Ending Town stops every worker. A lost parent
93
+ pipe also stops workers after an unexpected Town exit. An interrupted write remains
94
+ uncertain until repository reconciliation or an explicit retry establishes what
95
+ happened; a restart never blindly repeats it.
243
96
 
244
97
  ## Town settings, requests, and deletion
245
98
 
@@ -480,7 +333,7 @@ It proposes scoped features with user value, repository evidence and acceptance
480
333
  criteria. A separate review rejects duplicate, already implemented, rejected or
481
334
  uncertain proposals before filing. Its verifier receives `FEATURE_COMMIT` and
482
335
  `FEATURE_FINDING`; shared verification commands must support the selected bot's
483
- environment. New and upgraded towns keep feature discovery paused until started.
336
+ environment. New towns keep feature discovery paused until started.
484
337
 
485
338
  Town Hall's **Automation outcomes** report separates worker attempts, filed
486
339
  findings, submitted implementation PRs, repository-confirmed merges, repair
@@ -589,31 +442,13 @@ origin, and bearer key checks protect the local API. A browser supporting WebMCP
589
442
  can list towns and navigate to a house through optional page tools. Unsupported
590
443
  browsers use the ordinary interface.
591
444
 
592
- ## Keyboard and development
593
-
594
- Browser: `0` overview, `1` Bug, `2` Issue, `3` Review, `4` Release, `5` Repo, `6` Town Hall, `7` Feature, `8` Simplifier, `?` help, Escape closes
595
- the inspector. Motion follows reduced-motion preferences and can be switched off.
596
- Terminal: `0` overview, Tab next town, `1`–`7` or `j`/`k` select a house, `s` start,
597
- `p` pause, `x` stop, `a` wake the selected town, `d` delete with `y`/`n` confirmation,
598
- `q` detach. Use `bt settings` and `bt request` for agent settings and new work, or
599
- the forms in the browser. Bracketed paste is
600
- ignored as commands. Network and agent work stay off the input/render loops.
601
-
602
- ```sh
603
- make check
604
- make smoke
605
- ```
606
445
 
607
- Tests use fake GitHub and agents, temporary local Git remotes, authenticated HTTP
608
- fixtures, and the isolated simulation. Do not use live repository automation as a
609
- development test. See [CONTRIBUTING.md](CONTRIBUTING.md),
610
- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), and
611
- [licenses/README.md](licenses/README.md).
446
+ ## Development
612
447
 
613
- Licensed under [Apache-2.0](LICENSE). Attribution is in [NOTICE](NOTICE) and
614
- [third-party notices](licenses/THIRD_PARTY_NOTICES.txt). Artwork provenance is in
615
- [docs/ARTWORK.md](docs/ARTWORK.md). Native and npm packaging is configured, and the npm bootstrap and trusted
616
- publishers are established. Stable GitHub release publication remains separate.
448
+ `make check` runs independent Go race tests and vet in all nine modules, browser
449
+ syntax/tests, launcher tests, packaging tests and license checks. `make smoke`
450
+ builds the complete suite and runs isolated demo integration checks. Use fake
451
+ GitHub and agents for write tests; never use live repository automation as a test.
617
452
 
618
- For scheduling stalls, stale reviews, and interrupted workers, see
619
- [blocked-town recovery](docs/blocked-town-recovery.md).
453
+ [Imported open bot issues](docs/imported-bot-issues.md) retain their source links
454
+ and attributed discussion history.
package/bin/bbb ADDED
Binary file
package/bin/bfb ADDED
Binary file
package/bin/bib ADDED
Binary file
package/bin/bmb ADDED
Binary file
package/bin/brb ADDED
Binary file
package/bin/brp ADDED
Binary file
package/bin/brv ADDED
Binary file
package/bin/bsb ADDED
Binary file
package/bin/bt CHANGED
Binary file
@@ -0,0 +1,202 @@
1
+
2
+ Apache License
3
+ Version 2.0, January 2004
4
+ http://www.apache.org/licenses/
5
+
6
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
7
+
8
+ 1. Definitions.
9
+
10
+ "License" shall mean the terms and conditions for use, reproduction,
11
+ and distribution as defined by Sections 1 through 9 of this document.
12
+
13
+ "Licensor" shall mean the copyright owner or entity authorized by
14
+ the copyright owner that is granting the License.
15
+
16
+ "Legal Entity" shall mean the union of the acting entity and all
17
+ other entities that control, are controlled by, or are under common
18
+ control with that entity. For the purposes of this definition,
19
+ "control" means (i) the power, direct or indirect, to cause the
20
+ direction or management of such entity, whether by contract or
21
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
22
+ outstanding shares, or (iii) beneficial ownership of such entity.
23
+
24
+ "You" (or "Your") shall mean an individual or Legal Entity
25
+ exercising permissions granted by this License.
26
+
27
+ "Source" form shall mean the preferred form for making modifications,
28
+ including but not limited to software source code, documentation
29
+ source, and configuration files.
30
+
31
+ "Object" form shall mean any form resulting from mechanical
32
+ transformation or translation of a Source form, including but
33
+ not limited to compiled object code, generated documentation,
34
+ and conversions to other media types.
35
+
36
+ "Work" shall mean the work of authorship, whether in Source or
37
+ Object form, made available under the License, as indicated by a
38
+ copyright notice that is included in or attached to the work
39
+ (an example is provided in the Appendix below).
40
+
41
+ "Derivative Works" shall mean any work, whether in Source or Object
42
+ form, that is based on (or derived from) the Work and for which the
43
+ editorial revisions, annotations, elaborations, or other modifications
44
+ represent, as a whole, an original work of authorship. For the purposes
45
+ of this License, Derivative Works shall not include works that remain
46
+ separable from, or merely link (or bind by name) to the interfaces of,
47
+ the Work and Derivative Works thereof.
48
+
49
+ "Contribution" shall mean any work of authorship, including
50
+ the original version of the Work and any modifications or additions
51
+ to that Work or Derivative Works thereof, that is intentionally
52
+ submitted to Licensor for inclusion in the Work by the copyright owner
53
+ or by an individual or Legal Entity authorized to submit on behalf of
54
+ the copyright owner. For the purposes of this definition, "submitted"
55
+ means any form of electronic, verbal, or written communication sent
56
+ to the Licensor or its representatives, including but not limited to
57
+ communication on electronic mailing lists, source code control systems,
58
+ and issue tracking systems that are managed by, or on behalf of, the
59
+ Licensor for the purpose of discussing and improving the Work, but
60
+ excluding communication that is conspicuously marked or otherwise
61
+ designated in writing by the copyright owner as "Not a Contribution."
62
+
63
+ "Contributor" shall mean Licensor and any individual or Legal Entity
64
+ on behalf of whom a Contribution has been received by Licensor and
65
+ subsequently incorporated within the Work.
66
+
67
+ 2. Grant of Copyright License. Subject to the terms and conditions of
68
+ this License, each Contributor hereby grants to You a perpetual,
69
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
70
+ copyright license to reproduce, prepare Derivative Works of,
71
+ publicly display, publicly perform, sublicense, and distribute the
72
+ Work and such Derivative Works in Source or Object form.
73
+
74
+ 3. Grant of Patent License. Subject to the terms and conditions of
75
+ this License, each Contributor hereby grants to You a perpetual,
76
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
77
+ (except as stated in this section) patent license to make, have made,
78
+ use, offer to sell, sell, import, and otherwise transfer the Work,
79
+ where such license applies only to those patent claims licensable
80
+ by such Contributor that are necessarily infringed by their
81
+ Contribution(s) alone or by combination of their Contribution(s)
82
+ with the Work to which such Contribution(s) was submitted. If You
83
+ institute patent litigation against any entity (including a
84
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
85
+ or a Contribution incorporated within the Work constitutes direct
86
+ or contributory patent infringement, then any patent licenses
87
+ granted to You under this License for that Work shall terminate
88
+ as of the date such litigation is filed.
89
+
90
+ 4. Redistribution. You may reproduce and distribute copies of the
91
+ Work or Derivative Works thereof in any medium, with or without
92
+ modifications, and in Source or Object form, provided that You
93
+ meet the following conditions:
94
+
95
+ (a) You must give any other recipients of the Work or
96
+ Derivative Works a copy of this License; and
97
+
98
+ (b) You must cause any modified files to carry prominent notices
99
+ stating that You changed the files; and
100
+
101
+ (c) You must retain, in the Source form of any Derivative Works
102
+ that You distribute, all copyright, patent, trademark, and
103
+ attribution notices from the Source form of the Work,
104
+ excluding those notices that do not pertain to any part of
105
+ the Derivative Works; and
106
+
107
+ (d) If the Work includes a "NOTICE" text file as part of its
108
+ distribution, then any Derivative Works that You distribute must
109
+ include a readable copy of the attribution notices contained
110
+ within such NOTICE file, excluding those notices that do not
111
+ pertain to any part of the Derivative Works, in at least one
112
+ of the following places: within a NOTICE text file distributed
113
+ as part of the Derivative Works; within the Source form or
114
+ documentation, if provided along with the Derivative Works; or,
115
+ within a display generated by the Derivative Works, if and
116
+ wherever such third-party notices normally appear. The contents
117
+ of the NOTICE file are for informational purposes only and
118
+ do not modify the License. You may add Your own attribution
119
+ notices within Derivative Works that You distribute, alongside
120
+ or as an addendum to the NOTICE text from the Work, provided
121
+ that such additional attribution notices cannot be construed
122
+ as modifying the License.
123
+
124
+ You may add Your own copyright statement to Your modifications and
125
+ may provide additional or different license terms and conditions
126
+ for use, reproduction, or distribution of Your modifications, or
127
+ for any such Derivative Works as a whole, provided Your use,
128
+ reproduction, and distribution of the Work otherwise complies with
129
+ the conditions stated in this License.
130
+
131
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
132
+ any Contribution intentionally submitted for inclusion in the Work
133
+ by You to the Licensor shall be under the terms and conditions of
134
+ this License, without any additional terms or conditions.
135
+ Notwithstanding the above, nothing herein shall supersede or modify
136
+ the terms of any separate license agreement you may have executed
137
+ with Licensor regarding such Contributions.
138
+
139
+ 6. Trademarks. This License does not grant permission to use the trade
140
+ names, trademarks, service marks, or product names of the Licensor,
141
+ except as required for reasonable and customary use in describing the
142
+ origin of the Work and reproducing the content of the NOTICE file.
143
+
144
+ 7. Disclaimer of Warranty. Unless required by applicable law or
145
+ agreed to in writing, Licensor provides the Work (and each
146
+ Contributor provides its Contributions) on an "AS IS" BASIS,
147
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
148
+ implied, including, without limitation, any warranties or conditions
149
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
150
+ PARTICULAR PURPOSE. You are solely responsible for determining the
151
+ appropriateness of using or redistributing the Work and assume any
152
+ risks associated with Your exercise of permissions under this License.
153
+
154
+ 8. Limitation of Liability. In no event and under no legal theory,
155
+ whether in tort (including negligence), contract, or otherwise,
156
+ unless required by applicable law (such as deliberate and grossly
157
+ negligent acts) or agreed to in writing, shall any Contributor be
158
+ liable to You for damages, including any direct, indirect, special,
159
+ incidental, or consequential damages of any character arising as a
160
+ result of this License or out of the use or inability to use the
161
+ Work (including but not limited to damages for loss of goodwill,
162
+ work stoppage, computer failure or malfunction, or any and all
163
+ other commercial damages or losses), even if such Contributor
164
+ has been advised of the possibility of such damages.
165
+
166
+ 9. Accepting Warranty or Additional Liability. While redistributing
167
+ the Work or Derivative Works thereof, You may choose to offer,
168
+ and charge a fee for, acceptance of support, warranty, indemnity,
169
+ or other liability obligations and/or rights consistent with this
170
+ License. However, in accepting such obligations, You may act only
171
+ on Your own behalf and on Your sole responsibility, not on behalf
172
+ of any other Contributor, and only if You agree to indemnify,
173
+ defend, and hold each Contributor harmless for any liability
174
+ incurred by, or claims asserted against, such Contributor by reason
175
+ of your accepting any such warranty or additional liability.
176
+
177
+ END OF TERMS AND CONDITIONS
178
+
179
+ APPENDIX: How to apply the Apache License to your work.
180
+
181
+ To apply the Apache License to your work, attach the following
182
+ boilerplate notice, with the fields enclosed by brackets "[]"
183
+ replaced with your own identifying information. (Don't include
184
+ the brackets!) The text should be enclosed in the appropriate
185
+ comment syntax for the file format. We also recommend that a
186
+ file or class name and description of purpose be included on the
187
+ same "printed page" as the copyright notice for easier
188
+ identification within third-party archives.
189
+
190
+ Copyright [yyyy] [name of copyright owner]
191
+
192
+ Licensed under the Apache License, Version 2.0 (the "License");
193
+ you may not use this file except in compliance with the License.
194
+ You may obtain a copy of the License at
195
+
196
+ http://www.apache.org/licenses/LICENSE-2.0
197
+
198
+ Unless required by applicable law or agreed to in writing, software
199
+ distributed under the License is distributed on an "AS IS" BASIS,
200
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
201
+ See the License for the specific language governing permissions and
202
+ limitations under the License.
@@ -0,0 +1,6 @@
1
+ Brokk Bug Bot
2
+ Copyright 2026 Brokk.ai and contributors
3
+
4
+ This project is licensed under the Apache License, Version 2.0.
5
+ See LICENSE for the full terms. Third-party terms and attribution are
6
+ provided in licenses/THIRD_PARTY_NOTICES.txt.