busybits 2.0.0 → 2.1.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 (34) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +21 -0
  3. package/README.es.md +27 -27
  4. package/README.fr.md +26 -26
  5. package/README.md +63 -34
  6. package/README.pt-BR.md +28 -28
  7. package/dist/build.json +2 -2
  8. package/dist/cli/busybits.js +302 -35
  9. package/dist/client/bundle/app-BXRp9yel.js +24 -0
  10. package/dist/client/bundle/{app-CoDOLwxe.css → app-Y2N0l58V.css} +1 -1
  11. package/dist/client/bundle/city-SSVRvwxu.js +1 -0
  12. package/dist/client/bundle/{daystats-DGzYOP8l.js → daystats-B5wgtYEK.js} +1 -1
  13. package/dist/client/bundle/{dom-D2vx0KTo.js → dom-DTwIMOMe.js} +1 -1
  14. package/dist/client/bundle/{en-DBfNt5uV.js → en-C1UkXkY6.js} +25 -5
  15. package/dist/client/bundle/{es-pnWdszTE.js → es-DrTXrvU-.js} +25 -5
  16. package/dist/client/bundle/{format-C7qb6Cn-.js → format-COWnO8aN.js} +1 -1
  17. package/dist/client/bundle/{fr-CY8q9pj4.js → fr-DSvgQnax.js} +25 -5
  18. package/dist/client/bundle/{main-DktU0GfB.js → main-CjRdSA5N.js} +2 -2
  19. package/dist/client/bundle/{ptypane-NIZ2Y8QM.js → ptypane-BU6MDOyh.js} +1 -1
  20. package/dist/client/bundle/{room-name-CFJfHE5L.js → room-name-DefEKN7q.js} +1 -1
  21. package/dist/client/bundle/{simulator-BnBPS_Ws.js → simulator-BhSq5TwZ.js} +1 -1
  22. package/dist/client/bundle/world-model-D6tSJZPE.js +1 -0
  23. package/dist/client/bundle/{world-stream-BRkL9Eme.js → world-stream-pGb-glkT.js} +1 -1
  24. package/dist/client/index.html +1 -1
  25. package/dist/server/index.js +1030 -450
  26. package/mod/README.md +144 -144
  27. package/mod/habblaud/.claude-plugin/plugin.json +1 -1
  28. package/mod/habblaud-mensagens/.claude-plugin/plugin.json +1 -1
  29. package/mod/habblaud-permissoes/.claude-plugin/plugin.json +1 -1
  30. package/mod/habblaud-pi/package.json +1 -1
  31. package/package.json +7 -2
  32. package/dist/client/bundle/app-AwZeKIeu.js +0 -24
  33. package/dist/client/bundle/city-YoIG0FsX.js +0 -1
  34. package/dist/client/bundle/world-model-BIYmgAWC.js +0 -1
package/README.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <p align="center">
2
- <img src="client/public/assets/brand/logo-mark@4x.png" width="96" alt="Busybits logo: a tile of small pixel-art blocks" />
2
+ <img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/client/public/assets/brand/logo-mark@4x.png" width="96" alt="Busybits logo: a tile of small pixel-art blocks" />
3
3
  </p>
4
4
 
5
5
  <h1 align="center">Busybits</h1>
@@ -22,7 +22,7 @@
22
22
  </p>
23
23
 
24
24
  <p align="center">
25
- <img src="docs/screenshots/office.gif" width="820" alt="Animation of a Busybits room: characters typing at their desks, subagents with badges and activity bubbles" />
25
+ <img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/office.gif" width="820" alt="Animation of a Busybits room: characters typing at their desks, subagents with badges and activity bubbles" />
26
26
  </p>
27
27
 
28
28
  ---
@@ -63,12 +63,12 @@ external calls.
63
63
  session gets its own room along the hallway. At the top, the counters and each account's usage; on the left, the rooms
64
64
  and agents; at the bottom, the activity feed.
65
65
 
66
- ![Busybits overview: building with lobby, kitchen, restrooms, lounge and project rooms; sidebar with rooms and agents; account usage at the top; activity feed at the bottom](docs/screenshots/overview.png)
66
+ ![Busybits overview: building with lobby, kitchen, restrooms, lounge and project rooms; sidebar with rooms and agents; account usage at the top; activity feed at the bottom](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/overview.png)
67
67
 
68
68
  <table>
69
69
  <tr>
70
- <td width="50%"><img src="docs/screenshots/agent-details.png" alt="Details drawer of an agent with tasks, subagents, timeline and stats" /></td>
71
- <td width="50%"><img src="docs/screenshots/night.png" alt="The office at night, with streetlights on and lit rooms" /></td>
70
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/agent-details.png" alt="Details drawer of an agent with tasks, subagents, timeline and stats" /></td>
71
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/night.png" alt="The office at night, with streetlights on and lit rooms" /></td>
72
72
  </tr>
73
73
  <tr>
74
74
  <td><b>Agent details:</b> current activity, tasks with progress, subagents, timeline and stats.</td>
@@ -78,7 +78,7 @@ and agents; at the bottom, the activity feed.
78
78
 
79
79
  <table>
80
80
  <tr>
81
- <td width="42%"><img src="docs/screenshots/collab.png" alt="Subagent delivering the result to the main agent while another agent asks for permission" /></td>
81
+ <td width="42%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/collab.png" alt="Subagent delivering the result to the main agent while another agent asks for permission" /></td>
82
82
  <td width="58%">
83
83
  <b>Collaboration in plain sight.</b> Subagents are coworkers with their own names and badges: they arrive by elevator, work in
84
84
  the project's room and, when they finish, walk over to the agent that called them to deliver the result (📦) before leaving.<br /><br />
@@ -99,7 +99,7 @@ and agents; at the bottom, the activity feed.
99
99
  25 min it dozes off. When the command finishes, it stands up and celebrates with confetti — or gets a rain cloud, if
100
100
  it failed. In the sidebar list and in the details, a timer shows how long each command has been running.
101
101
  </td>
102
- <td width="42%"><img src="docs/screenshots/shell-wait.png" alt="Agent eating popcorn at its desk, with an hourglass over its head and the bubble 'Run the test suite · 1 min'; in the front row, a coworker has been waiting longer, with cobwebs on the chair and the terminal showing progress" /></td>
102
+ <td width="42%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/shell-wait.png" alt="Agent eating popcorn at its desk, with an hourglass over its head and the bubble 'Run the test suite · 1 min'; in the front row, a coworker has been waiting longer, with cobwebs on the chair and the terminal showing progress" /></td>
103
103
  </tr>
104
104
  </table>
105
105
 
@@ -111,11 +111,11 @@ shrinks on its own.
111
111
 
112
112
  | 1. The room is set up, still dark | 2. Someone turns on the lights and everyone works | 3. The last one leaves and turns off the lights | 4. The room becomes a garden |
113
113
  | --- | --- | --- | --- |
114
- | ![Room being set up, with the furniture appearing and the lights off](docs/screenshots/lifecycle-1.png) | ![Lit room with three agents working at their desks](docs/screenshots/lifecycle-2.png) | ![Room with the lights off and the furniture still in place, after everyone left](docs/screenshots/lifecycle-3.png) | ![The room's lot turned into a garden](docs/screenshots/lifecycle-4.png) |
114
+ | ![Room being set up, with the furniture appearing and the lights off](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/lifecycle-1.png) | ![Lit room with three agents working at their desks](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/lifecycle-2.png) | ![Room with the lights off and the furniture still in place, after everyone left](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/lifecycle-3.png) | ![The room's lot turned into a garden](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/lifecycle-4.png) |
115
115
 
116
116
  <table>
117
117
  <tr>
118
- <td width="34%"><img src="docs/screenshots/mobile.png" alt="Busybits on a phone, with account usage at the top" /></td>
118
+ <td width="34%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/mobile.png" alt="Busybits on a phone, with account usage at the top" /></td>
119
119
  <td>
120
120
  <b>On your phone too.</b> The interface adapts to small screens: account usage stays at the top, the room list
121
121
  becomes a drawer and the details open from the bottom up. See how to allow access over the local network in
@@ -335,14 +335,17 @@ header. Nothing of this exists until you run the setup: without it, no extra por
335
335
 
336
336
  ```bash
337
337
  npm run remote:setup # usuário, senha, nome do endereço e (opcional) um endereço próprio
338
- npm run docker:up
338
+ systemctl --user restart busybits # Node install (macOS: launchctl kickstart -k gui/$UID/com.busybits.server)
339
+ npm run docker:up # Docker install
339
340
  ```
340
341
 
341
342
  `remote:setup` writes the username (`HABBLAUD_REMOTE_USER`) and only the password **hash** (scrypt,
342
- `HABBLAUD_REMOTE_PASSWORD_HASH`) to `.env` — plain-text passwords (`HABBLAUD_REMOTE_PASSWORD`) are intentionally rejected
343
- by the server (see [Remote environment variables](server/README.md#acesso-remoto-pelo-celular-habblaud_remote_)).
343
+ `HABBLAUD_REMOTE_PASSWORD_HASH`) to the file your install reads: the user env file (`~/.config/habblaud/env`) on a Node
344
+ install, which must then **restart its service** (the command above; the script prints it), or the repo `.env` on a
345
+ Docker install — plain-text passwords (`HABBLAUD_REMOTE_PASSWORD`) are intentionally rejected
346
+ by the server (see [Remote environment variables](server/README.md#remote-access-from-the-phone-habblaud_remote_)).
344
347
  It also creates a local CA and the server certificate in `~/.habblaud/remote-tls`, and leaves a service announcing
345
- `<nome>.local` (`HABBLAUD_REMOTE_NAME`, default `habblaud`) on the network (mDNS; LaunchAgent on macOS, systemd on Linux).
348
+ `<nome>.local` (`HABBLAUD_REMOTE_NAME`, default `busybits`) on the network (mDNS; LaunchAgent on macOS, systemd on Linux).
346
349
  Open `https://<nome>.local` on your phone (with `:4748` if port 443 was taken). The first time,
347
350
  accept the warning, tap **Install the Busybits certificate** and trust it (iPhone: Settings › Profile Downloaded ›
348
351
  Install, then Settings › General › About › Certificate Trust Settings; Android: Security › Encryption & credentials ›
@@ -612,8 +615,8 @@ activities and animations. The day/night cycle is still a separate option.
612
615
 
613
616
  <table>
614
617
  <tr>
615
- <td width="50%"><img src="docs/screenshots/seasonal-christmas.png" alt="Office with the Christmas theme: trees with presents in the corners of the rooms, wreaths and lights on the walls, red rugs and characters in Santa hats" /></td>
616
- <td width="50%"><img src="docs/screenshots/seasonal-halloween.png" alt="Office with the Halloween theme: pumpkins and ghosts in place of the plants, cobwebs and bats on the walls, purple rugs and characters in costume" /></td>
618
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/seasonal-christmas.png" alt="Office with the Christmas theme: trees with presents in the corners of the rooms, wreaths and lights on the walls, red rugs and characters in Santa hats" /></td>
619
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/seasonal-halloween.png" alt="Office with the Halloween theme: pumpkins and ghosts in place of the plants, cobwebs and bats on the walls, purple rugs and characters in costume" /></td>
617
620
  </tr>
618
621
  </table>
619
622
 
@@ -700,7 +703,7 @@ feed keeps showing what's happening now.
700
703
  The server records the timeline **from the moment it's turned on** (the past can't be rebuilt):
701
704
  summaries of what the office shows, without conversations, in `~/.habblaud/timeline/` (in Docker, in the data volume), with
702
705
  a size limit per day and the last **7 days** kept. To not record: `HABBLAUD_TIMELINE=0`. Details in
703
- [`server/README.md`](server/README.md#linha-do-tempo-timelapse).
706
+ [`server/README.md`](server/README.md#timeline-timelapse).
704
707
 
705
708
  The characters walk faster in the replay, but at high speeds anyone who stays only briefly in the office barely
706
709
  reaches their desk; jumping to another point shows everyone already in place.
@@ -868,7 +871,7 @@ with the model shown on the agent. Agent Hub does not record the caller's Claude
868
871
  The read-only mirror is `${XDG_DATA_HOME:-~/.local/share}/agent-hub/runs/<jobId>/`: `result.json` contains the job
869
872
  metadata, `prompt.txt` the task, `stdout.log` live output, and `response.txt` the final answer. Busybits reads at most
870
873
  the latest 64 KB of the output log and checks only recently updated job directories (up to 200), keeping completed
871
- jobs from the last 30 minutes. See [server data sources](server/README.md#fontes-de-dados-somente-leitura) for the fields and
874
+ jobs from the last 30 minutes. See [server data sources](server/README.md#data-sources-read-only) for the fields and
872
875
  status mapping. `HABBLAUD_AGENT_HUB=off` disables the source; the default `auto` enables it only when the data
873
876
  directory exists, and `on` forces it on.
874
877
 
@@ -912,8 +915,8 @@ calls in the transcripts (`gh pr create`, `gh pr merge`, `git push`, `gh run wat
912
915
 
913
916
  <table>
914
917
  <tr>
915
- <td width="50%"><img src="docs/screenshots/github-party.png" alt="The app-mobile room partying: confetti falling, the golden banner 'PR #12 merged!' and Jéssica standing with her arms up and a star over her head" /></td>
916
- <td width="50%"><img src="docs/screenshots/github-alarm.png" alt="The data-pipeline room on alert: reddish floor, red banner 'CI failed (feat/checkout)', rotating beacons in the top corners and a red '!' bubble next to Ícaro" /></td>
918
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/github-party.png" alt="The app-mobile room partying: confetti falling, the golden banner 'PR #12 merged!' and Jéssica standing with her arms up and a star over her head" /></td>
919
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/github-alarm.png" alt="The data-pipeline room on alert: reddish floor, red banner 'CI failed (feat/checkout)', rotating beacons in the top corners and a red '!' bubble next to Ícaro" /></td>
917
920
  </tr>
918
921
  </table>
919
922
 
@@ -935,6 +938,17 @@ happens while it's running, and the day follows your browser's time zone. With d
935
938
  shows made-up numbers (with the "demo" badge) and lets you switch to the real data; the demo agents never
936
939
  go into the real stats.
937
940
 
941
+ ### Office inbox
942
+
943
+ Agents and scripts can leave something on your desk: `busybits post --title "ROO7-1234 rejected in QA" --link
944
+ https://example.com/ROO7-1234 --key ROO7-1234` (from a clone: `npm run post -- ...`). In **My office** the open items
945
+ show up as a stack of papers on your desk, with a count; the agent that sent it (found through its process tree) walks
946
+ over with the paper, or a courier does when it came from a script. A bell rings on each new item. Click the stack (or
947
+ the **na mesa** button in the top bar) to open the panel: each item has its title, text, link, sender and age, a
948
+ **Resolve** button, and a **Resolved** toggle shows the ones from the last 7 days. The same `--key` updates an item
949
+ instead of duplicating it, and reopens it if you had resolved it. Details, limits and routes: [Office
950
+ inbox](server/README.md#office-inbox).
951
+
938
952
  ### Demo mode
939
953
 
940
954
  Want to see the office full without having any sessions open?
@@ -1084,14 +1098,14 @@ on; knocks on the door (**Let me know when someone knocks**) only if you turn it
1084
1098
  **City.** The **World** button in the top bar swaps the office for the city: walk with the arrows/WASD or by clicking,
1085
1099
  each building's card shows floors, agents and status, and the minimap sits in the corner; paused or out of the world,
1086
1100
  your building stays dark, but you can still walk around the city. In demo mode (`?mock=1&world=approved&scene=city`,
1087
- only fictional buildings and people): [the city](docs/screenshots/world-cidade.png) and
1088
- [a building's card](docs/screenshots/world-cartao.png).
1101
+ only fictional buildings and people): [the city](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-cidade.png) and
1102
+ [a building's card](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-cartao.png).
1089
1103
 
1090
1104
  **Visits.** Near a building's door, **Enter (E)** takes you inside: the owner's live office, with rooms under made-up
1091
1105
  names and the agents in their current status, view only (no terminal, messages or permissions, and nothing about the
1092
1106
  work); a building closed to visits can only be seen from outside. On yours, you see "N visitors now" (only the count,
1093
- never who). In demo mode: [the visit](docs/screenshots/world-visita.png) and
1094
- [the visit panel](docs/screenshots/world-visita-painel.png).
1107
+ never who). In demo mode: [the visit](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-visita.png) and
1108
+ [the visit panel](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-visita-painel.png).
1095
1109
 
1096
1110
  **Social.** In the city, with no free text anywhere: **L** likes the building by the door, **G** opens the greeting
1097
1111
  wheel (ready-made phrases, translated for whoever reads them) and **K** knocks on the door of owners who accept it; each
@@ -1100,8 +1114,8 @@ any lit building. Inside a building, **Like** and **Leave a stamp** at the front
1100
1114
  square, the thermometer of the city's weekly goal and, when it's reached, fireworks. In the office, the "❤️ N today"
1101
1115
  chip and the "While you were away" card with the visits, likes and stamps left at the front desk (never who); people you
1102
1116
  blocked are listed in **Blocked**, with **Unblock**. In demo mode:
1103
- [the greeting wheel](docs/screenshots/world-social.png) and
1104
- [the square with the fireworks](docs/screenshots/world-praca.png).
1117
+ [the greeting wheel](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-social.png) and
1118
+ [the square with the fireworks](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-praca.png).
1105
1119
 
1106
1120
  **Pause, leave, delete.** **Pause** turns the building off right away and keeps the lot (after 30 days paused, it
1107
1121
  disappears from the map; 30 days later, it's removed). **Leave the world** removes the building and frees the lot; the
@@ -1135,9 +1149,9 @@ example, in Docker, published on port 4848):
1135
1149
  (otherwise it answers `421`).
1136
1150
 
1137
1151
  How the section looks, in demo mode (`?mock=1&world=logged_out`, `waiting` or `approved`; in Portuguese):
1138
- [no account](docs/screenshots/world-sem-conta.png), [waitlist](docs/screenshots/world-lista-de-espera.png),
1139
- [character](docs/screenshots/world-personagem.png), [Your building](docs/screenshots/world-predio.png) and
1140
- [what was sent](docs/screenshots/world-enviado.png).
1152
+ [no account](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-sem-conta.png), [waitlist](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-lista-de-espera.png),
1153
+ [character](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-personagem.png), [Your building](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-predio.png) and
1154
+ [what was sent](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-enviado.png).
1141
1155
 
1142
1156
  ## How it works
1143
1157
 
@@ -1360,13 +1374,25 @@ HABBLAUD_DATA_DIR=/tmp/habblaud-demo HABBLAUD_TIMELINE=0 HABBLAUD_CLAUDE_DIRS=/t
1360
1374
 
1361
1375
  `HABBLAUD_TIMELINE=0` avoids writing to that folder; with recording on, days older than 7 days are deleted.
1362
1376
 
1377
+ **Git hooks (contributors):** `npm install` sets up [Husky](https://typicode.github.io/husky/) hooks through the `prepare`
1378
+ script. They are dev-only and never ship in the npm package.
1379
+
1380
+ | Hook | What it runs |
1381
+ | --- | --- |
1382
+ | `commit-msg` | [commitlint](https://commitlint.js.org/): the message must follow Conventional Commits (`feat(scope): ...`). |
1383
+ | `pre-commit` | `npm run typecheck`, `npm run i18n:check` and `npm run version:check`. |
1384
+ | `pre-push` | `npm test`, `npm run build` and `npm run pack:check`. |
1385
+
1386
+ In an emergency, skip them with `git commit --no-verify` / `git push --no-verify`, or disable them for a command with
1387
+ `HUSKY=0` (for example `HUSKY=0 git push`). CI still runs the same checks.
1388
+
1363
1389
  **Publishing a version:** every version has its own section in [`CHANGELOG.md`](CHANGELOG.md), with what went in. While
1364
1390
  working, note the changes under "Não lançado" (Unreleased). To release:
1365
1391
 
1366
1392
  1. Bump the number with `npm version minor --no-git-tag-version` (or `patch`, for a bug-fix-only version).
1367
1393
  2. Replace "Não lançado" with the version and the date (`## [0.3.0] - AAAA-MM-DD`), leave an empty "Não lançado" above it and
1368
1394
  update the links at the end. `npm test` fails if the `package.json` version doesn't have a section.
1369
- 3. Merge into `main` and run `npm run release` (it needs an authenticated [`gh`](https://cli.github.com/); `-- --dry-run`
1395
+ 3. Merge into `main`, wait for CI to pass on that commit and run `npm run release` (it refuses to run until CI is green; it needs an authenticated [`gh`](https://cli.github.com/); `-- --dry-run`
1370
1396
  only shows the notes). The script creates the `v0.3.0` tag and the release with the section's text. From then on, Busybits
1371
1397
  users see the **New version** badge.
1372
1398
 
@@ -1505,6 +1531,9 @@ npm version minor --no-git-tag-version # bumps and syncs the version files
1505
1531
  npm run release # tags vX.Y.Z from the CHANGELOG section and pushes the tag
1506
1532
  ```
1507
1533
 
1534
+ `npm run release` refuses to continue unless the `ci.yml` GitHub workflow concluded `success` for the exact `HEAD` commit
1535
+ (it asks `gh run list`, also with `--dry-run`): wait for CI to finish on `main`, or fix it, then retry. There is no bypass flag.
1536
+
1508
1537
  Pushing a `vX.Y.Z` tag runs `.github/workflows/release.yml`, which publishes the package to npm and needs the
1509
1538
  `NPM_TOKEN` repository secret. The publish step has no `--provenance` while the repository is private.
1510
1539
 
@@ -1535,7 +1564,7 @@ for a hangout (alone, it sticks with the popcorn) and takes the hourglass along;
1535
1564
  a new request to someone — it lets the group know ("Oops, they're calling me! 🏃") and runs back to its desk.
1536
1565
 
1537
1566
  <p align="center">
1538
- <img src="docs/screenshots/social-lounge.gif" width="816" alt="Busybits lounge with three hangouts at once: three coworkers on the couch watching soccer on TV (the screen flashes GOL), a ping-pong match with fans and an arcade duel with trash talk in the bubbles" />
1567
+ <img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-lounge.gif" width="816" alt="Busybits lounge with three hangouts at once: three coworkers on the couch watching soccer on TV (the screen flashes GOL), a ping-pong match with fans and an arcade duel with trash talk in the bubbles" />
1539
1568
  </p>
1540
1569
 
1541
1570
  ### The hangouts
@@ -1553,16 +1582,16 @@ a new request to someone — it lets the group know ("Oops, they're calling me!
1553
1582
 
1554
1583
  <table>
1555
1584
  <tr>
1556
- <td width="50%"><img src="docs/screenshots/social-rps.png" alt="Rock-paper-scissors in the lobby: Lia celebrates with a coin over her head and the bubble 'I won!', coins fly from Bruna (upset, with the rock icon) to her, '+20' and '−20' floating, and Iara watches from behind" /></td>
1557
- <td width="50%"><img src="docs/screenshots/social-kitchen.png" alt="Kitchen chat: four coworkers sitting at the long table with coffee, with the bubbles 'It'll work out!' and 'Hahaha'" /></td>
1585
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-rps.png" alt="Rock-paper-scissors in the lobby: Lia celebrates with a coin over her head and the bubble 'I won!', coins fly from Bruna (upset, with the rock icon) to her, '+20' and '−20' floating, and Iara watches from behind" /></td>
1586
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-kitchen.png" alt="Kitchen chat: four coworkers sitting at the long table with coffee, with the bubbles 'It'll work out!' and 'Hahaha'" /></td>
1558
1587
  </tr>
1559
1588
  <tr>
1560
1589
  <td><b>Rock-paper-scissors for coins.</b> The bet comes from the personality (betting lovers bet big, penny-pinchers bet little) and never goes over the balance of whoever has less.</td>
1561
1590
  <td><b>Kitchen chat.</b> Whoever is more sociable talks more; the reactions depend on the topic (a big laugh at a joke, 👀 at gossip).</td>
1562
1591
  </tr>
1563
1592
  <tr>
1564
- <td><img src="docs/screenshots/social-mirror.png" alt="Two coworkers at the bathroom sinks freshening up, with their faces reflected in the mirrors and the bubble 'You're killing it!'" /></td>
1565
- <td><img src="docs/screenshots/social-drawer.png" alt="Social life section in the agent's details: 'Watching a soap opera on TV with Bruna and Iara', 115 coins, 1 win and 0 losses, the Vanity and Thrift traits, the catchphrase, friendships, rivalries with the score and the statement" /></td>
1593
+ <td><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-mirror.png" alt="Two coworkers at the bathroom sinks freshening up, with their faces reflected in the mirrors and the bubble 'You're killing it!'" /></td>
1594
+ <td><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-drawer.png" alt="Social life section in the agent's details: 'Watching a soap opera on TV with Bruna and Iara', 115 coins, 1 win and 0 losses, the Vanity and Thrift traits, the catchphrase, friendships, rivalries with the score and the statement" /></td>
1566
1595
  </tr>
1567
1596
  <tr>
1568
1597
  <td><b>At the mirror.</b> Vanity lovers stop by the restroom whenever they can — and show up reflected.</td>
package/README.pt-BR.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <p align="center">
2
- <img src="client/public/assets/brand/logo-mark@4x.png" width="96" alt="Logo do Busybits: um ladrilho de pequenos blocos em pixel art" />
2
+ <img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/client/public/assets/brand/logo-mark@4x.png" width="96" alt="Logo do Busybits: um ladrilho de pequenos blocos em pixel art" />
3
3
  </p>
4
4
 
5
5
  <h1 align="center">Busybits</h1>
@@ -22,7 +22,7 @@
22
22
  </p>
23
23
 
24
24
  <p align="center">
25
- <img src="docs/screenshots/office.gif" width="820" alt="Animação de uma sala do Busybits: personagens digitando nas mesas, subagentes com crachá e balões de atividade" />
25
+ <img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/office.gif" width="820" alt="Animação de uma sala do Busybits: personagens digitando nas mesas, subagentes com crachá e balões de atividade" />
26
26
  </p>
27
27
 
28
28
  ---
@@ -61,12 +61,12 @@ para dar a letra de cada conta). Nada sai do computador: o Busybits não lê cre
61
61
  ganha a sua sala ao longo do corredor. No topo, os contadores e o uso de cada conta; à esquerda, as salas e os
62
62
  agentes; embaixo, o feed de atividade.
63
63
 
64
- ![Visão geral do Busybits: prédio com recepção, copa, banheiros, lounge e salas de projeto; barra lateral com salas e agentes; uso das contas no topo; feed de atividade embaixo](docs/screenshots/overview.png)
64
+ ![Visão geral do Busybits: prédio com recepção, copa, banheiros, lounge e salas de projeto; barra lateral com salas e agentes; uso das contas no topo; feed de atividade embaixo](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/overview.png)
65
65
 
66
66
  <table>
67
67
  <tr>
68
- <td width="50%"><img src="docs/screenshots/agent-details.png" alt="Gaveta de detalhes de um agente com tarefas, subagentes, linha do tempo e estatísticas" /></td>
69
- <td width="50%"><img src="docs/screenshots/night.png" alt="O escritório à noite, com postes acesos e salas iluminadas" /></td>
68
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/agent-details.png" alt="Gaveta de detalhes de um agente com tarefas, subagentes, linha do tempo e estatísticas" /></td>
69
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/night.png" alt="O escritório à noite, com postes acesos e salas iluminadas" /></td>
70
70
  </tr>
71
71
  <tr>
72
72
  <td><b>Detalhes do agente:</b> atividade atual, tarefas com progresso, subagentes, linha do tempo e estatísticas.</td>
@@ -76,7 +76,7 @@ agentes; embaixo, o feed de atividade.
76
76
 
77
77
  <table>
78
78
  <tr>
79
- <td width="42%"><img src="docs/screenshots/collab.png" alt="Subagente entregando o resultado ao agente principal enquanto outra agente pede permissão" /></td>
79
+ <td width="42%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/collab.png" alt="Subagente entregando o resultado ao agente principal enquanto outra agente pede permissão" /></td>
80
80
  <td width="58%">
81
81
  <b>Colaboração à vista.</b> Subagentes são colegas com nome próprio e crachá: chegam pelo elevador, trabalham na
82
82
  sala do projeto e, ao terminar, vão até o agente que os chamou entregar o resultado (📦) antes de ir embora.<br /><br />
@@ -97,7 +97,7 @@ agentes; embaixo, o feed de atividade.
97
97
  25 min cochila. Quando o comando termina, levanta e comemora com confete — ou ganha uma nuvem de chuva, se
98
98
  falhou. Na lista lateral e nos detalhes, um cronômetro mostra há quanto tempo cada comando está rodando.
99
99
  </td>
100
- <td width="42%"><img src="docs/screenshots/shell-wait.png" alt="Agente comendo pipoca na mesa, com uma ampulheta sobre a cabeça e o balão 'Rodar a suíte de testes · 1 min'; na fileira da frente, uma colega espera há mais tempo, com teia de aranha na cadeira e o terminal mostrando o progresso" /></td>
100
+ <td width="42%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/shell-wait.png" alt="Agente comendo pipoca na mesa, com uma ampulheta sobre a cabeça e o balão 'Rodar a suíte de testes · 1 min'; na fileira da frente, uma colega espera há mais tempo, com teia de aranha na cadeira e o terminal mostrando o progresso" /></td>
101
101
  </tr>
102
102
  </table>
103
103
 
@@ -108,11 +108,11 @@ ela, e o endereço antigo apaga e é desmontado. Assim o prédio não fica com b
108
108
 
109
109
  | 1. A sala é montada, ainda apagada | 2. Alguém acende a luz e todos trabalham | 3. O último sai e apaga a luz | 4. A sala vira jardim |
110
110
  | --- | --- | --- | --- |
111
- | ![Sala sendo montada, com os móveis aparecendo e a luz apagada](docs/screenshots/lifecycle-1.png) | ![Sala acesa com três agentes trabalhando nas mesas](docs/screenshots/lifecycle-2.png) | ![Sala com a luz apagada e os móveis ainda no lugar, depois que todos saíram](docs/screenshots/lifecycle-3.png) | ![O lote da sala transformado em jardim](docs/screenshots/lifecycle-4.png) |
111
+ | ![Sala sendo montada, com os móveis aparecendo e a luz apagada](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/lifecycle-1.png) | ![Sala acesa com três agentes trabalhando nas mesas](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/lifecycle-2.png) | ![Sala com a luz apagada e os móveis ainda no lugar, depois que todos saíram](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/lifecycle-3.png) | ![O lote da sala transformado em jardim](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/lifecycle-4.png) |
112
112
 
113
113
  <table>
114
114
  <tr>
115
- <td width="34%"><img src="docs/screenshots/mobile.png" alt="Busybits no celular, com o uso das contas no topo" /></td>
115
+ <td width="34%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/mobile.png" alt="Busybits no celular, com o uso das contas no topo" /></td>
116
116
  <td>
117
117
  <b>Também no celular.</b> A interface se adapta a telas pequenas: o uso das contas fica no topo, a lista de
118
118
  salas vira uma gaveta e os detalhes abrem de baixo para cima. Veja como liberar o acesso pela rede local em
@@ -495,8 +495,8 @@ as atividades e as animações dos agentes. O ciclo dia/noite continua sendo uma
495
495
 
496
496
  <table>
497
497
  <tr>
498
- <td width="50%"><img src="docs/screenshots/seasonal-christmas.png" alt="Escritório no tema Natal: árvores com presentes nos cantos das salas, guirlandas e luzes nas paredes, tapetes vermelhos e personagens de gorro" /></td>
499
- <td width="50%"><img src="docs/screenshots/seasonal-halloween.png" alt="Escritório no tema Halloween: abóboras e fantasmas no lugar das plantas, teias e morcegos nas paredes, tapetes roxos e personagens fantasiados" /></td>
498
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/seasonal-christmas.png" alt="Escritório no tema Natal: árvores com presentes nos cantos das salas, guirlandas e luzes nas paredes, tapetes vermelhos e personagens de gorro" /></td>
499
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/seasonal-halloween.png" alt="Escritório no tema Halloween: abóboras e fantasmas no lugar das plantas, teias e morcegos nas paredes, tapetes roxos e personagens fantasiados" /></td>
500
500
  </tr>
501
501
  </table>
502
502
 
@@ -583,7 +583,7 @@ feed continua mostrando o que acontece agora.
583
583
  O servidor grava a linha do tempo **a partir do momento em que está ligado** (não dá para reconstruir o passado):
584
584
  resumos do que o escritório mostra, sem conversas, em `~/.habblaud/timeline/` (no Docker, no volume de dados), com
585
585
  limite de tamanho por dia e os últimos **7 dias** guardados. Para não gravar: `HABBLAUD_TIMELINE=0`. Detalhes em
586
- [`server/README.md`](server/README.md#linha-do-tempo-timelapse).
586
+ [`server/README.md`](server/README.md#timeline-timelapse).
587
587
 
588
588
  Os personagens andam mais rápido no replay, mas nas velocidades altas quem fica pouco tempo no escritório quase não
589
589
  chega à mesa; pular para outro ponto mostra todos já no lugar.
@@ -709,8 +709,8 @@ transcripts as chamadas (`gh pr create`, `gh pr merge`, `git push`, `gh run watc
709
709
 
710
710
  <table>
711
711
  <tr>
712
- <td width="50%"><img src="docs/screenshots/github-party.png" alt="Sala app-mobile em festa: confete caindo, a faixa dourada 'PR #12 mergeado!' e Jéssica de pé com os braços para cima e uma estrela sobre a cabeça" /></td>
713
- <td width="50%"><img src="docs/screenshots/github-alarm.png" alt="Sala data-pipeline em alarme: chão avermelhado, faixa vermelha 'CI falhou (feat/checkout)', giroflex nos cantos de cima e um balão '!' vermelho ao lado de Ícaro" /></td>
712
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/github-party.png" alt="Sala app-mobile em festa: confete caindo, a faixa dourada 'PR #12 mergeado!' e Jéssica de pé com os braços para cima e uma estrela sobre a cabeça" /></td>
713
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/github-alarm.png" alt="Sala data-pipeline em alarme: chão avermelhado, faixa vermelha 'CI falhou (feat/checkout)', giroflex nos cantos de cima e um balão '!' vermelho ao lado de Ícaro" /></td>
714
714
  </tr>
715
715
  </table>
716
716
 
@@ -876,14 +876,14 @@ milhão…), nunca o número nem o custo, e dá para desligar; placar e compacta
876
876
  **Cidade.** O botão **Mundo**, na barra do topo, troca o escritório pela cidade: anda-se com setas/WASD ou clicando, o
877
877
  cartão de cada prédio mostra andares, agentes e estado, e o minimapa fica no canto; pausado ou fora do mundo, o seu
878
878
  prédio fica apagado, mas dá para andar pela cidade. No modo demonstração (`?mock=1&world=approved&scene=city`, só
879
- prédios e pessoas fictícios): [a cidade](docs/screenshots/world-cidade.png) e
880
- [o cartão de um prédio](docs/screenshots/world-cartao.png).
879
+ prédios e pessoas fictícios): [a cidade](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-cidade.png) e
880
+ [o cartão de um prédio](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-cartao.png).
881
881
 
882
882
  **Visitas.** Perto da porta de um prédio, **Entrar (E)** leva para dentro: o escritório do dono ao vivo, com as salas de
883
883
  nomes fictícios e os agentes no status de agora, só para ver (nada de terminal, mensagens ou permissões, e nada do
884
884
  trabalho); prédio fechado a visitas só se vê por fora. No seu, você vê "N visitantes agora" (só a contagem, nunca quem).
885
- No modo demonstração: [a visita](docs/screenshots/world-visita.png) e
886
- [o painel da visita](docs/screenshots/world-visita-painel.png).
885
+ No modo demonstração: [a visita](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-visita.png) e
886
+ [o painel da visita](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-visita-painel.png).
887
887
 
888
888
  **Social.** Na cidade, sem nenhum texto livre: **L** curte o prédio perto da porta, **G** abre a roda de cumprimentos
889
889
  (frases prontas, traduzidas para quem lê) e **K** bate na porta de quem aceita; o cartão de cada pessoa tem
@@ -891,8 +891,8 @@ Cumprimentar, Bloquear e Denunciar, e o minimapa leva a um prédio pelo código
891
891
  qualquer. Dentro de um prédio, **Curtir** e **Deixar um carimbo** na portaria (um por prédio por dia). Na praça, o
892
892
  termômetro da meta da semana da cidade e, quando ela bate, fogos. No escritório, o chip "❤️ N hoje" e o cartão "Enquanto
893
893
  você estava fora" com as visitas, os likes e os carimbos deixados na portaria (nunca quem); quem você bloqueou fica em
894
- **Bloqueados**, com **Desbloquear**. No modo demonstração: [a roda de cumprimentos](docs/screenshots/world-social.png) e
895
- [a praça com os fogos](docs/screenshots/world-praca.png).
894
+ **Bloqueados**, com **Desbloquear**. No modo demonstração: [a roda de cumprimentos](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-social.png) e
895
+ [a praça com os fogos](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-praca.png).
896
896
 
897
897
  **Pausar, sair, excluir.** **Pausar** apaga o prédio na hora e guarda o lote (com 30 dias pausado, ele some do mapa; 30
898
898
  dias depois, é retirado). **Sair do mundo** retira o prédio e libera o lote; a conta e o personagem continuam, e voltar
@@ -925,9 +925,9 @@ computador (por exemplo, em Docker, publicado na porta 4848):
925
925
  `421`).
926
926
 
927
927
  Como a seção fica, no modo demonstração (`?mock=1&world=logged_out`, `waiting` ou `approved`):
928
- [sem conta](docs/screenshots/world-sem-conta.png), [lista de espera](docs/screenshots/world-lista-de-espera.png),
929
- [personagem](docs/screenshots/world-personagem.png), [Seu prédio](docs/screenshots/world-predio.png) e
930
- [o que foi enviado](docs/screenshots/world-enviado.png).
928
+ [sem conta](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-sem-conta.png), [lista de espera](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-lista-de-espera.png),
929
+ [personagem](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-personagem.png), [Seu prédio](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-predio.png) e
930
+ [o que foi enviado](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-enviado.png).
931
931
 
932
932
  ## Como funciona
933
933
 
@@ -1302,7 +1302,7 @@ para uma roda (sozinho, continua na pipoca) e leva a ampulheta junto; quando o c
1302
1302
  um pedido novo para alguém —, ele avisa a turma ("Opa, me chamaram! 🏃") e corre de volta para a mesa.
1303
1303
 
1304
1304
  <p align="center">
1305
- <img src="docs/screenshots/social-lounge.gif" width="816" alt="Lounge do Busybits com três rodas ao mesmo tempo: três colegas no sofá vendo futebol na TV (a tela pisca GOL), uma partida de pingue-pongue com torcida e um duelo nos fliperamas com provocações nos balões" />
1305
+ <img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-lounge.gif" width="816" alt="Lounge do Busybits com três rodas ao mesmo tempo: três colegas no sofá vendo futebol na TV (a tela pisca GOL), uma partida de pingue-pongue com torcida e um duelo nos fliperamas com provocações nos balões" />
1306
1306
  </p>
1307
1307
 
1308
1308
  ### As rodas
@@ -1320,16 +1320,16 @@ um pedido novo para alguém —, ele avisa a turma ("Opa, me chamaram! 🏃") e
1320
1320
 
1321
1321
  <table>
1322
1322
  <tr>
1323
- <td width="50%"><img src="docs/screenshots/social-rps.png" alt="Jokenpô na recepção: Lia comemora com uma moeda sobre a cabeça e o balão 'Ganhei!', moedinhas voam de Bruna (chateada, com o ícone de pedra) para ela, '+20' e '−20' flutuando, e Iara assiste atrás" /></td>
1324
- <td width="50%"><img src="docs/screenshots/social-kitchen.png" alt="Papo na copa: quatro colegas sentados à mesa comprida com café, com os balões 'Vai dar certo!' e 'Hahaha'" /></td>
1323
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-rps.png" alt="Jokenpô na recepção: Lia comemora com uma moeda sobre a cabeça e o balão 'Ganhei!', moedinhas voam de Bruna (chateada, com o ícone de pedra) para ela, '+20' e '−20' flutuando, e Iara assiste atrás" /></td>
1324
+ <td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-kitchen.png" alt="Papo na copa: quatro colegas sentados à mesa comprida com café, com os balões 'Vai dar certo!' e 'Hahaha'" /></td>
1325
1325
  </tr>
1326
1326
  <tr>
1327
1327
  <td><b>Jokenpô valendo moedinhas.</b> A aposta sai da personalidade (quem é de apostas aposta alto, quem é pão-duro aposta pouco) e nunca passa do saldo de quem tem menos.</td>
1328
1328
  <td><b>Papo na copa.</b> Quem fala mais é quem é mais sociável; as reações dependem do assunto (gargalhada na piada, 👀 na fofoca).</td>
1329
1329
  </tr>
1330
1330
  <tr>
1331
- <td><img src="docs/screenshots/social-mirror.png" alt="Duas colegas diante das pias do banheiro se arrumando, com os rostos refletidos nos espelhos e o balão 'Tá arrasando!'" /></td>
1332
- <td><img src="docs/screenshots/social-drawer.png" alt="Seção Vida social nos detalhes do agente: 'Vendo novela na TV com Bruna e Iara', 115 moedinhas, 1 vitória e 0 derrotas, os traços Vaidade e Economia, o bordão, amizades, rivalidades com o placar e o extrato" /></td>
1331
+ <td><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-mirror.png" alt="Duas colegas diante das pias do banheiro se arrumando, com os rostos refletidos nos espelhos e o balão 'Tá arrasando!'" /></td>
1332
+ <td><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-drawer.png" alt="Seção Vida social nos detalhes do agente: 'Vendo novela na TV com Bruna e Iara', 115 moedinhas, 1 vitória e 0 derrotas, os traços Vaidade e Economia, o bordão, amizades, rivalidades com o placar e o extrato" /></td>
1333
1333
  </tr>
1334
1334
  <tr>
1335
1335
  <td><b>No espelho.</b> Quem é de vaidade passa no banheiro sempre que pode — e aparece refletido.</td>
package/dist/build.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "commit": "ecad78a7dad33328f2f932d84d6232d9e20b55a3",
2
+ "commit": "e5b79730dad40d1ed3dc6ccc9cd75e8aa64eb451",
3
3
  "dirty": false,
4
- "builtAt": "2026-11-12T16:08:16.960Z"
4
+ "builtAt": "2026-11-12T20:25:09.141Z"
5
5
  }