busybits 0.0.0-stage → 2.0.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 (111) hide show
  1. package/.claude-plugin/marketplace.json +26 -0
  2. package/CHANGELOG.md +675 -0
  3. package/LICENSE +21 -0
  4. package/README.es.md +1457 -0
  5. package/README.fr.md +1435 -0
  6. package/README.md +1605 -2
  7. package/README.pt-BR.md +1373 -0
  8. package/dist/build.json +5 -0
  9. package/dist/cli/busybits.js +14708 -0
  10. package/dist/client/assets/art/framed/painting-abstract.png +0 -0
  11. package/dist/client/assets/art/framed/painting-beach.png +0 -0
  12. package/dist/client/assets/art/framed/painting-cat.png +0 -0
  13. package/dist/client/assets/art/framed/painting-city-night.png +0 -0
  14. package/dist/client/assets/art/framed/painting-mountains.png +0 -0
  15. package/dist/client/assets/art/framed/painting-rio.png +0 -0
  16. package/dist/client/assets/art/framed/painting-sunflowers.png +0 -0
  17. package/dist/client/assets/art/framed/painting-wave.png +0 -0
  18. package/dist/client/assets/art/framed/painting-wide-aurora.png +0 -0
  19. package/dist/client/assets/art/framed/painting-wide-color-fields.png +0 -0
  20. package/dist/client/assets/art/framed/painting-wide-forest-lake.png +0 -0
  21. package/dist/client/assets/art/painting-abstract.png +0 -0
  22. package/dist/client/assets/art/painting-beach.png +0 -0
  23. package/dist/client/assets/art/painting-cat.png +0 -0
  24. package/dist/client/assets/art/painting-city-night.png +0 -0
  25. package/dist/client/assets/art/painting-mountains.png +0 -0
  26. package/dist/client/assets/art/painting-rio.png +0 -0
  27. package/dist/client/assets/art/painting-sunflowers.png +0 -0
  28. package/dist/client/assets/art/painting-wave.png +0 -0
  29. package/dist/client/assets/art/painting-wide-aurora.png +0 -0
  30. package/dist/client/assets/art/painting-wide-color-fields.png +0 -0
  31. package/dist/client/assets/art/painting-wide-forest-lake.png +0 -0
  32. package/dist/client/assets/art/poster-bug.png +0 -0
  33. package/dist/client/assets/art/poster-cat.png +0 -0
  34. package/dist/client/assets/art/poster-code.png +0 -0
  35. package/dist/client/assets/art/poster-coffee.png +0 -0
  36. package/dist/client/assets/art/poster-rocket.png +0 -0
  37. package/dist/client/assets/art/poster-ship-it.png +0 -0
  38. package/dist/client/assets/brand/apple-touch-icon.png +0 -0
  39. package/dist/client/assets/brand/favicon-16.png +0 -0
  40. package/dist/client/assets/brand/favicon-32.png +0 -0
  41. package/dist/client/assets/brand/icon-192.png +0 -0
  42. package/dist/client/assets/brand/icon-512.png +0 -0
  43. package/dist/client/assets/brand/logo-detailed.png +0 -0
  44. package/dist/client/assets/brand/logo-mark.png +0 -0
  45. package/dist/client/assets/brand/logo-mark@4x.png +0 -0
  46. package/dist/client/assets/brand/signage.png +0 -0
  47. package/dist/client/assets/brand/signage@4x.png +0 -0
  48. package/dist/client/assets/emoji/LICENSE-SerenityOS.txt +28 -0
  49. package/dist/client/assets/emoji/sheet.png +0 -0
  50. package/dist/client/assets/illustrations/empty-office.png +0 -0
  51. package/dist/client/assets/manifest.json +260 -0
  52. package/dist/client/assets/og-image.png +0 -0
  53. package/dist/client/bundle/app-AwZeKIeu.js +24 -0
  54. package/dist/client/bundle/app-CoDOLwxe.css +1 -0
  55. package/dist/client/bundle/city-DPTwQLdi.css +1 -0
  56. package/dist/client/bundle/city-YoIG0FsX.js +1 -0
  57. package/dist/client/bundle/daystats-DGzYOP8l.js +1 -0
  58. package/dist/client/bundle/dom-D2vx0KTo.js +1 -0
  59. package/dist/client/bundle/en-DBfNt5uV.js +169 -0
  60. package/dist/client/bundle/es-pnWdszTE.js +169 -0
  61. package/dist/client/bundle/format-C7qb6Cn-.js +1 -0
  62. package/dist/client/bundle/fr-CY8q9pj4.js +169 -0
  63. package/dist/client/bundle/main-DktU0GfB.js +2 -0
  64. package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-Ckz2YJkH.woff2 +0 -0
  65. package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-DfOZNMlW.woff +0 -0
  66. package/dist/client/bundle/pixelify-sans-cyrillic-500-normal--wrb4dVK.woff2 +0 -0
  67. package/dist/client/bundle/pixelify-sans-cyrillic-500-normal-CR9SIKMr.woff +0 -0
  68. package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-B3EuUOZG.woff +0 -0
  69. package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-BhqNJYOZ.woff2 +0 -0
  70. package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-BrZTw8tu.woff +0 -0
  71. package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-CYtG5Rfp.woff2 +0 -0
  72. package/dist/client/bundle/pixelify-sans-latin-400-normal-DLrIX9QE.woff2 +0 -0
  73. package/dist/client/bundle/pixelify-sans-latin-400-normal-JapMNN6Z.woff +0 -0
  74. package/dist/client/bundle/pixelify-sans-latin-500-normal-Bq6pAlou.woff +0 -0
  75. package/dist/client/bundle/pixelify-sans-latin-500-normal-DC052d-m.woff2 +0 -0
  76. package/dist/client/bundle/pixelify-sans-latin-600-normal-BNlgYbDL.woff +0 -0
  77. package/dist/client/bundle/pixelify-sans-latin-600-normal-Dd_Dy7u5.woff2 +0 -0
  78. package/dist/client/bundle/pixelify-sans-latin-700-normal-BctWAS0u.woff +0 -0
  79. package/dist/client/bundle/pixelify-sans-latin-700-normal-D3Xxx3QE.woff2 +0 -0
  80. package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-BkfTUL4s.woff +0 -0
  81. package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-DdH6zlBQ.woff2 +0 -0
  82. package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-BHT4w5qI.woff2 +0 -0
  83. package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-Bkr-oq6R.woff +0 -0
  84. package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-CDaIumwU.woff +0 -0
  85. package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-Dha6RiOG.woff2 +0 -0
  86. package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-BadXkHzZ.woff +0 -0
  87. package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-ClyJstAh.woff2 +0 -0
  88. package/dist/client/bundle/ptypane-BrP-ENHg.css +1 -0
  89. package/dist/client/bundle/ptypane-NIZ2Y8QM.js +16 -0
  90. package/dist/client/bundle/room-name-CFJfHE5L.js +1 -0
  91. package/dist/client/bundle/simulator-BnBPS_Ws.js +7 -0
  92. package/dist/client/bundle/world-model-BIYmgAWC.js +1 -0
  93. package/dist/client/bundle/world-stream-BRkL9Eme.js +1 -0
  94. package/dist/client/index.html +41 -0
  95. package/dist/client/manifest.webmanifest +17 -0
  96. package/dist/server/index.js +40327 -0
  97. package/mod/README.md +193 -0
  98. package/mod/habblaud/.claude-plugin/plugin.json +11 -0
  99. package/mod/habblaud/hooks/hooks.json +4 -0
  100. package/mod/habblaud/hooks/register.ts +517 -0
  101. package/mod/habblaud-codex/hook.mjs +274 -0
  102. package/mod/habblaud-mensagens/.claude-plugin/plugin.json +11 -0
  103. package/mod/habblaud-mensagens/hooks/hooks.json +4 -0
  104. package/mod/habblaud-mensagens/hooks/register.ts +384 -0
  105. package/mod/habblaud-permissoes/.claude-plugin/plugin.json +11 -0
  106. package/mod/habblaud-permissoes/hooks/hooks.json +18 -0
  107. package/mod/habblaud-permissoes/hooks/permission-hook.mjs +265 -0
  108. package/mod/habblaud-pi/core.ts +325 -0
  109. package/mod/habblaud-pi/extension.ts +119 -0
  110. package/mod/habblaud-pi/package.json +12 -0
  111. package/package.json +96 -4
package/mod/README.md ADDED
@@ -0,0 +1,193 @@
1
+ # Plugins do Claude Code do Busybits
2
+
3
+ O repositório é também um marketplace de plugins do Claude Code: `.claude-plugin/marketplace.json` (na raiz)
4
+ lista o marketplace `habblaud` com três plugins, um em cada pasta daqui: o mod `busybits` (só observa; mora na pasta `mod/habblaud`),
5
+ `busybits-permissions` (responder permissões pelo escritório) e `busybits-messages` (mandar mensagens pelo
6
+ escritório). O `npm run mod:install` instala os três; `--sem-permissoes` e `--sem-mensagens` deixam o seu de fora.
7
+ As versões acompanham o `package.json` (o teste `server/test/mod.test.ts` falha se divergirem).
8
+
9
+ Testado com o **Claude Code 2.1.293** (o `busybits-messages`, por enquanto só pelo `claude plugin test` do
10
+ 2.1.295). Mods (hooks em TypeScript carregados pelo próprio Claude Code) existem a partir da 2.1.287; a API ainda é
11
+ "early access" e pode mudar entre versões. Em versões anteriores, use os instaladores de sempre
12
+ (`npm run usage:install` e `npm run hooks:install`); mandar mensagens pelo escritório só existe com o mod. A
13
+ instalação está no README principal.
14
+
15
+ ## `busybits` — o mod
16
+
17
+ `habblaud/hooks/register.ts`, um módulo só, sem build. Liga cada sessão ao escritório sem ler a conversa:
18
+
19
+ - **Uso do plano (5h e semanal):** no início da sessão e a cada `session.measure` (depois de cada turno e quando
20
+ um limite anda um ponto) lê `$.session.usage().rateLimits` e grava `~/.habblaud/usage/<conta>.json` (ou em
21
+ `HABBLAUD_USAGE_DIR`) no mesmo formato do tap de statusline, mais `"source": "mod"`. Substitui o
22
+ `npm run usage:install`: o seu statusline fica intocado. A conta é a pasta de `CLAUDE_CONFIG_DIR` (o primeiro
23
+ item) ou `~/.claude` (`~` é o `HOME`; no Windows sem ele, o `USERPROFILE`). Valores iguais gravados há menos de
24
+ 10 s não são regravados; falha ao gravar = silêncio.
25
+ - **"Precisa de você" embaixo do prompt:** a cada 5 s pergunta ao Busybits local
26
+ (`GET http://127.0.0.1:<HABBLAUD_PORT ou 4747>/api/mod/summary`) quem está esperando, já sem esta sessão e os
27
+ subagentes dela, e mostra `🏢 Valentina precisa de você em loja-virtual` ou
28
+ `🏢 2 precisam de você: Valentina (loja-virtual), Elias (app-mobile)` (até 3 nomes, depois "e mais N").
29
+ Ninguém esperando ou Busybits fora do ar: a linha some; fora do ar, as perguntas passam a ser a cada 30 s até
30
+ ele voltar. Só em sessões que desenham (no `claude -p` não pergunta nada).
31
+ - **`/busybits`:** resumo do escritório inteiro, respondido pelo próprio mod (não chama o modelo, não gasta uso):
32
+
33
+ ```
34
+ Busybits 0.3.0 em http://localhost:4747
35
+ 7 agentes · 3 trabalhando · 2 precisam de você
36
+ ✋ Valentina (loja-virtual): aprovar uma permissão · dá para responder pelo escritório
37
+ ✋ Elias (app-mobile): responder no terminal
38
+ ```
39
+
40
+ Fora do ar: `O Busybits não respondeu em http://localhost:4747. Para subir: npm run docker:up na pasta do Busybits.`
41
+
42
+ ### Language
43
+
44
+ Everything the mod writes (the line under the prompt, the `/busybits` answer and its description, the offline and
45
+ outdated messages) comes out in English, Spanish, Portuguese or French, with singular and plural forms. The mod picks
46
+ the language from the session environment, because the engine interface (`$`) does not expose Claude Code's own
47
+ `language` setting: `HABBLAUD_LANG` first (the same override the server uses), then `LC_ALL`, `LC_MESSAGES`, `LANG`
48
+ and `LANGUAGE`, skipping values it does not translate (`C`, `POSIX`, `de_DE`). With none of them set, it is English.
49
+ Text that comes from the server (the reason an agent is waiting) keeps the server's own language.
50
+
51
+ ### Renamed from `habblaud` (up to 1.0.3)
52
+
53
+ The plugin id is now `busybits@busybits`, in a marketplace named `busybits` (it was `habblaud`). `npm run mod:install`
54
+ removes every `*@habblaud` plugin and the `habblaud` marketplace in each account before adding `busybits`, and
55
+ `npm run mod:uninstall` removes both generations. A packaged install (`busybits setup`) does the same switch, pointing the marketplace at `~/.busybits/marketplace`; until then `npm run mod:status` and `docker:up` report the old name.
56
+
57
+ ### O que ele acessa
58
+
59
+ Saída de `claude plugin validate --strict mod/habblaud` (a análise estática que o Claude Code faz antes de
60
+ carregar o módulo; nada fora desta lista é chamado):
61
+
62
+ ```
63
+ ❯ ./register.ts hooks: session.start, session.measure, command.run{command=busybits}
64
+ ❯ ./register.ts answers its own command: command.run{command=busybits}
65
+ ❯ ./register.ts calls: $.clock.after (via askBusybits), $.clock.every (via schedule), $.clock.now (via writeUsage), $.command.register, $.env.get (via readEnv), $.fs.write (via writeUsage), $.http.fetch (via askBusybits), $.session.id (via poll), $.session.surfaces (via poll), $.session.usage, $.ui.status (via setStatus)
66
+ ❯ ./register.ts env writes: nothing
67
+ ❯ ./register.ts env reads: CLAUDE_CONFIG_DIR, HABBLAUD_LANG, HABBLAUD_PORT, HABBLAUD_USAGE_DIR, HOME, LANG, LANGUAGE, LC_ALL, LC_MESSAGES, USERPROFILE
68
+ ```
69
+
70
+ Em palavras: só observa (nenhum hook decide nada: não aprova ferramentas, não muda prompts, não lê mensagens),
71
+ grava um único arquivo (o de uso), fala só com `127.0.0.1` e lê dez variáveis de ambiente. `$.clock.after` é o
72
+ prazo de 2 s de cada pergunta ao Busybits (`$.http.fetch` não aceita AbortSignal).
73
+
74
+ ## `busybits-permissions` — responder permissões pelo escritório
75
+
76
+ Um hook `PermissionRequest` comum (sem mod), em `habblaud-permissoes/hooks/hooks.json`:
77
+
78
+ ```json
79
+ { "matcher": "*", "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/permission-hook.mjs\"", "timeout": 86430, "statusMessage": "Aguardando resposta no Busybits" }] }
80
+ ```
81
+
82
+ O script `hooks/permission-hook.mjs` é o mesmo que o `npm run hooks:install` instala (fonte única; Node puro, só
83
+ `node:*`, porque o Claude Code copia apenas a pasta do plugin para o cache). Ele manda o pedido ao Busybits local
84
+ e espera a resposta por até 5 min; o diálogo continua no terminal e vale o que você responder primeiro. Sem o
85
+ Busybits no ar ou sem nenhuma página aberta, sai na hora. Porta: `HABBLAUD_PORT` (padrão 4747); espera:
86
+ `HABBLAUD_PERMISSION_TIMEOUT` (padrão 300 s, até 86400 s = 24 h; o tempo limite do hook no plugin é 86430 s). Para aprovar
87
+ pelo celular longe do computador, ponha `"env": { "HABBLAUD_PERMISSION_TIMEOUT": "86400" }` no `settings.json` da
88
+ conta: vale para as sessões abertas depois. Subagentes em segundo plano só mostram o diálogo quando o hook termina,
89
+ por isso o padrão continua 5 min. Precisa de `node` 22+ no `PATH` da sessão.
90
+
91
+ `claude plugin validate --strict mod/habblaud-permissoes`: `✔ Validation passed` (o validador também confere o
92
+ esquema do `hooks.json`).
93
+
94
+ ## `busybits-messages` — mensagens pelo escritório
95
+
96
+ `habblaud-mensagens/hooks/register.ts`, um módulo só, sem build. Leva para a sessão o que você digita no escritório
97
+ (no painel do agente ou no terminal da tecla T), como se você tivesse digitado no terminal:
98
+
99
+ - **Busca:** a cada 2 s, só em sessões que desenham (no `claude -p` não pergunta nada),
100
+ `POST http://127.0.0.1:<HABBLAUD_PORT ou 4747>/api/mod/inbox` com `{session, account}`. A pergunta também marca a
101
+ sessão como presente: é ela que mostra, na página, a caixa de mensagem do agente (sem o plugin, a página dá a dica
102
+ de instalar). Fora do ar, ou respondendo outra coisa (403 com as mensagens desligadas, 404 numa versão sem a
103
+ rota), passa a perguntar a cada 30 s até ele voltar.
104
+ - **Entrega:** cada mensagem, na ordem, vai por `$.prompt.submit({ text, asUser: true })`. O modelo lê o texto como
105
+ seu, sem o "The busybits-messages plugin sent a message" (o registro da sessão ainda diz que veio do plugin), e o
106
+ texto vai exatamente como foi digitado. Com a sessão no meio de um turno, o Claude Code guarda o prompt e o roda
107
+ num turno só dele quando o atual terminar (um prompt de plugin nunca entra no meio do turno, como um digitado
108
+ pode entrar). Um hook que recuse a mensagem (`{drop}`) ou uma exceção viram falha, com o motivo, na página.
109
+ - **Comandos de barra:** a mensagem que começa por `/nome argumentos`, com `nome` na lista de `$.command.list()`,
110
+ roda por `$.command.run({ command, args })` em vez de `$.prompt.submit` (o Claude Code recusa em `$.prompt.submit`
111
+ todo texto que comece por `/`), e o desfecho (ok ou o erro) segue na confirmação. Com a lista fora do ar, quem
112
+ decide é o `$.command.run`, que rejeita nome desconhecido. Texto que começa por `/` e não é comando da sessão
113
+ (`/etc/hosts`, erro de digitação) falha com o motivo, sem ir à sessão. A mesma lista vai ao Busybits em
114
+ `POST /api/mod/commands` com `{session, account, commands: [{name, description, source, plugin?}]}`, só quando muda
115
+ e de minuto em minuto (o Busybits pode ter reiniciado): é ela que alimenta o autocompletar da caixa. Comandos que
116
+ abrem um menu interativo (`/model` sem argumento, `/config`) não têm o que mostrar no escritório: dê argumentos ou
117
+ use o terminal. O texto que o comando imprime não volta para a página.
118
+ - **Confirmação:** um `POST /api/mod/inbox/ack` com o resultado de cada uma (`{session, results: [{id, ok, error?}]}`).
119
+ A espera por mensagem (ou comando) é de no máximo 2 s: passou disso, a sessão está ocupada, a mensagem está na fila dela e
120
+ conta como entregue (as seguintes vão em seguida, na ordem). Assim uma rodada nunca passa de uns poucos segundos e
121
+ a presença (10 s) e a confirmação (30 s) do servidor não vencem com a sessão ocupada; o preço é que uma recusa
122
+ depois desses 2 s não chega à página.
123
+
124
+ Fica separado do mod `habblaud` de propósito: aquele só observa; este age, digitando na sessão em seu nome. Para
125
+ ficar sem ele: `npm run mod:install -- --sem-mensagens` (um já instalado continua; para tirar:
126
+ `claude plugin uninstall busybits-messages@busybits`). O `npm run docker:up` atualiza o plugin de quem já o tem,
127
+ mas não o instala sozinho: numa conta com o mod e sem ele, só dá a dica de rodar o `npm run mod:install`.
128
+
129
+ ### O que ele acessa
130
+
131
+ Saída de `claude plugin validate --strict mod/habblaud-mensagens`:
132
+
133
+ ```
134
+ ❯ ./register.ts hooks: session.start
135
+ ❯ ./register.ts calls: $.clock.after (via waitAtMost), $.clock.every (via schedule), $.clock.now (via publishCommands), $.command.list (via listCommands), $.command.run (via runOne), $.env.get (via readEnv), $.http.fetch (via postJson), $.prompt.submit (via submitOne), $.session.id (via round), $.session.surfaces (via round)
136
+ ❯ ./register.ts env writes: nothing
137
+ ❯ ./register.ts env reads: CLAUDE_CODE_ENTRYPOINT, CLAUDE_CONFIG_DIR, HABBLAUD_PORT, HOME, USERPROFILE
138
+ ```
139
+
140
+ Em palavras: um hook só (`session.start`, que liga o relógio das rodadas); as únicas ações na sessão são o
141
+ `$.prompt.submit` das mensagens e o `$.command.run` dos comandos de barra que você manda (`$.command.list` só lê os
142
+ nomes e as descrições dos comandos para publicá-los); não lê a conversa, não grava arquivo nenhum, fala só com `127.0.0.1` e lê quatro
143
+ variáveis de ambiente (a conta sai do `CLAUDE_CONFIG_DIR`, como no mod). `$.clock.after` é o prazo de 2 s de cada
144
+ pedido ao Busybits, de cada `$.prompt.submit`, `$.command.run` e `$.command.list`.
145
+
146
+ Porta: `HABBLAUD_PORT` (padrão 4747). Precisa do Claude Code 2.1.287+ e de um Busybits com as mensagens ligadas: a
147
+ mesma trava do terminal e das permissões (porta presa ao `127.0.0.1` e cabeçalho Host local) e `HABBLAUD_MENSAGENS`
148
+ não desligado (`0`, `false`, `off` ou `no` desligam). Qualquer processo desta máquina que fale com o Busybits
149
+ consegue mandar uma mensagem às sessões com o plugin: por isso a trava local.
150
+
151
+ ## `habblaud-pi` — Gentle Shell e Pi
152
+
153
+ Não é um plugin do Claude Code: é uma extensão do Pi (`habblaud-pi/extension.ts`, TypeScript carregado pelo próprio Pi, sem
154
+ build; a lógica testável está em `core.ts`, sem dependência do Pi). Instalação: `npm run pi:install` (ou `npm run setup`),
155
+ que põe a pasta `mod/habblaud-pi` em `packages` do `settings.json` de `~/.gentle-shell/agent` e de `~/.pi/agent`
156
+ (o que o `pi install <pasta>` faz; com backup, idempotente, sem tocar em `auth.json` nem em `mcp*.json`);
157
+ `npm run pi:status` e `npm run pi:uninstall` completam. Sessões abertas precisam ser reabertas (ou `/reload` no Pi).
158
+
159
+ - **Mensagens:** o mesmo protocolo do `busybits-messages` (`/api/mod/inbox`, `/ack` e `/commands`), só em sessões com tela
160
+ (`ctx.mode === "tui"`; subagentes, `-p` e RPC não buscam nada). Entrega com `pi.sendUserMessage`: a sessão ociosa recebe
161
+ na hora e, no meio de um turno, a mensagem entra como `followUp`. `/comando` da lista de `pi.getCommands()` (extensões,
162
+ prompt templates e skills) roda com `expandPromptTemplates`; o resto de `/...` falha com o motivo (os comandos embutidos
163
+ do Pi só rodam no terminal).
164
+ - **Precisa de você:** o Pi emite `ui_prompt_start` / `ui_prompt_end` (tipo e título) quando uma extensão abre uma caixa
165
+ bloqueante. O guard do gentle-pi pergunta com `ctx.ui.confirm("Allow guarded git push?", <prévia do comando>)`
166
+ (`extensions/gentle-ai.ts`, `confirmCommand`) e emite também `pi-permission-system:permission-request` (sem o
167
+ comando). Com o agente trabalhando, a extensão avisa o Busybits (`POST /api/permissions` com `answerable: false`, o
168
+ comando vindo da chamada de ferramenta em aberto) e libera o aviso quando a caixa fecha.
169
+ **Responder pelo escritório não é possível com segurança:** os eventos só observam, o `confirm` é resolvido pela
170
+ interface do terminal e o Pi não expõe como responder a caixa de outra extensão; a única saída seria substituir o
171
+ `ctx.ui.confirm` por dentro, o que muda a semântica do guard (a decisão sairia de outro lugar que não a caixa do
172
+ terminal). Por isso o escritório mostra que o agente espera, com o comando, e a resposta continua no terminal.
173
+ - **O que acessa:** `127.0.0.1:<HABBLAUD_PORT ou 4747>` (nenhum outro destino), as variáveis `HABBLAUD_PORT`, `HABBLAUD_PI`
174
+ (`0`, `false`, `off` ou `no` desligam) e `GENTLE_PI_AGENTS_CHILD`; não lê a conversa, não grava arquivo, não bloqueia nem
175
+ decide nenhuma chamada de ferramenta (o handler de `tool_call` só observa).
176
+ - Testes: `server/sources/gentle-shell/pi-extension.test.ts` (núcleo e extensão contra o Busybits de verdade, com um Pi
177
+ falso), `pi-install.test.ts` e `setup.test.ts` (HOME falso).
178
+
179
+ ## Desenvolver
180
+
181
+ ```bash
182
+ claude --plugin-dir mod/habblaud # carrega o mod numa sessão, sem instalar (recarrega ao salvar)
183
+ claude -p "/busybits" --plugin-dir mod/habblaud # testa o comando sem sessão interativa (não chama o modelo)
184
+ cd mod/habblaud && claude plugin test # testes do mod (tests/*.test.ts), sem sessão, login nem rede
185
+ cd mod/habblaud-mensagens && claude plugin test # idem para o plugin de mensagens
186
+ claude plugin validate --strict mod/habblaud # análise estática + manifesto (idem para as outras pastas e .)
187
+ npx tsc -p mod/habblaud # tipos (depois de carregar o mod uma vez com --plugin-dir)
188
+ ```
189
+
190
+ Ao carregar um mod, o Claude Code grava os tipos da versão instalada em `<pasta>/.claude-plugin/types/` e um
191
+ `<pasta>/tsconfig.json` que os estende; os dois são gerados e ficam fora do git (`mod/.gitignore`). Os testes dos
192
+ mods importam `claude-code/testing` e só rodam pelo `claude plugin test`: o `npm test` (vitest) e o
193
+ `npm run typecheck` não olham esta pasta.
@@ -0,0 +1,11 @@
1
+ {
2
+ "name": "busybits",
3
+ "displayName": "Busybits",
4
+ "version": "2.0.0",
5
+ "description": "Connects the session to Busybits: records plan usage (5h and weekly) for the office, shows a line under the prompt when another session needs you, and adds the /busybits command.",
6
+ "author": { "name": "Márcio Junior", "url": "https://github.com/marmottajr" },
7
+ "homepage": "https://github.com/marmottajr/habblaud#readme",
8
+ "repository": "https://github.com/marmottajr/habblaud",
9
+ "license": "MIT",
10
+ "keywords": ["busybits", "habblaud", "escritorio", "uso", "rate-limits", "status"]
11
+ }
@@ -0,0 +1,4 @@
1
+ {
2
+ "description": "Busybits mod hooks module (plan usage, line under the prompt and /busybits)",
3
+ "modules": ["./register.ts"]
4
+ }