t3code-session-manager 0.0.0-stage → 0.4.1

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 (172) hide show
  1. package/.claude-plugin/marketplace.json +21 -0
  2. package/.claude-plugin/plugin.json +19 -0
  3. package/CHANGELOG.md +149 -0
  4. package/LICENSE +21 -0
  5. package/README.md +661 -2
  6. package/README.pt.md +617 -0
  7. package/bin/entry.d.mts +2 -0
  8. package/bin/entry.mjs +19 -0
  9. package/bin/t3sm.mjs +44 -0
  10. package/commands/import.md +30 -0
  11. package/commands/organize.md +36 -0
  12. package/commands/status.md +24 -0
  13. package/commands/sync.md +26 -0
  14. package/dist/apply/apply.js +993 -0
  15. package/dist/apply/claudeWriter.js +168 -0
  16. package/dist/apply/copyTranscript.js +116 -0
  17. package/dist/apply/importer.js +697 -0
  18. package/dist/apply/materialize.js +335 -0
  19. package/dist/apply/waves.js +108 -0
  20. package/dist/assistant/core.js +295 -0
  21. package/dist/assistant/deps.js +256 -0
  22. package/dist/assistant/i18n.js +38 -0
  23. package/dist/assistant/messages.en.js +494 -0
  24. package/dist/assistant/messages.pt.js +495 -0
  25. package/dist/assistant/runner.js +64 -0
  26. package/dist/assistant/steps.js +1362 -0
  27. package/dist/build.json +1 -0
  28. package/dist/cli/applyScreen.js +158 -0
  29. package/dist/cli/commands/accounts.js +254 -0
  30. package/dist/cli/commands/apply.js +199 -0
  31. package/dist/cli/commands/changelog.js +61 -0
  32. package/dist/cli/commands/doctor.js +105 -0
  33. package/dist/cli/commands/help.js +158 -0
  34. package/dist/cli/commands/merge.js +224 -0
  35. package/dist/cli/commands/organize.js +872 -0
  36. package/dist/cli/commands/plan.js +161 -0
  37. package/dist/cli/commands/projects.js +430 -0
  38. package/dist/cli/commands/quarantine.js +203 -0
  39. package/dist/cli/commands/recover.js +230 -0
  40. package/dist/cli/commands/rollback.js +281 -0
  41. package/dist/cli/commands/scan.js +117 -0
  42. package/dist/cli/commands/schedule.js +288 -0
  43. package/dist/cli/commands/start.js +45 -0
  44. package/dist/cli/commands/status.js +615 -0
  45. package/dist/cli/commands/sync.js +336 -0
  46. package/dist/cli/commands/update.js +398 -0
  47. package/dist/cli/errors.js +53 -0
  48. package/dist/cli/failures.js +91 -0
  49. package/dist/cli/flags.js +53 -0
  50. package/dist/cli/help.en.js +549 -0
  51. package/dist/cli/help.pt.js +566 -0
  52. package/dist/cli/helpText.js +211 -0
  53. package/dist/cli/helpTopics.js +58 -0
  54. package/dist/cli/locked.js +12 -0
  55. package/dist/cli/main.js +155 -0
  56. package/dist/cli/screen.js +3 -0
  57. package/dist/cli/ui.js +111 -0
  58. package/dist/cli/words.js +2 -0
  59. package/dist/core/activity.js +16 -0
  60. package/dist/core/changelog.js +47 -0
  61. package/dist/core/config.js +530 -0
  62. package/dist/core/fsutil.js +171 -0
  63. package/dist/core/glob.js +34 -0
  64. package/dist/core/history.js +32 -0
  65. package/dist/core/journal.js +274 -0
  66. package/dist/core/lock.js +337 -0
  67. package/dist/core/mask.js +31 -0
  68. package/dist/core/paths.js +68 -0
  69. package/dist/core/pid.js +101 -0
  70. package/dist/core/run.js +4 -0
  71. package/dist/core/semver.js +18 -0
  72. package/dist/core/sysroot.js +29 -0
  73. package/dist/core/types.js +229 -0
  74. package/dist/core/uuid.js +29 -0
  75. package/dist/core/version.js +72 -0
  76. package/dist/help/convert.md +20 -0
  77. package/dist/help/convert.pt.md +21 -0
  78. package/dist/help/cwd-unreadable.md +22 -0
  79. package/dist/help/cwd-unreadable.pt.md +22 -0
  80. package/dist/help/decisions.md +20 -0
  81. package/dist/help/decisions.pt.md +20 -0
  82. package/dist/help/errors.md +20 -0
  83. package/dist/help/errors.pt.md +22 -0
  84. package/dist/help/held.md +20 -0
  85. package/dist/help/held.pt.md +20 -0
  86. package/dist/help/history.md +27 -0
  87. package/dist/help/history.pt.md +29 -0
  88. package/dist/help/instance-unavailable.md +18 -0
  89. package/dist/help/instance-unavailable.pt.md +19 -0
  90. package/dist/help/not-imported.md +19 -0
  91. package/dist/help/not-imported.pt.md +19 -0
  92. package/dist/help/orphaned.md +19 -0
  93. package/dist/help/orphaned.pt.md +19 -0
  94. package/dist/help/project-mismatch.md +15 -0
  95. package/dist/help/project-mismatch.pt.md +15 -0
  96. package/dist/help/t3-native.md +22 -0
  97. package/dist/help/t3-native.pt.md +22 -0
  98. package/dist/help/updates.md +26 -0
  99. package/dist/help/updates.pt.md +28 -0
  100. package/dist/help/watcher.md +24 -0
  101. package/dist/help/watcher.pt.md +25 -0
  102. package/dist/i18n/cli.js +41 -0
  103. package/dist/i18n/lang.js +55 -0
  104. package/dist/i18n/messages.en.js +1140 -0
  105. package/dist/i18n/messages.pt.js +1149 -0
  106. package/dist/i18n/words.js +12 -0
  107. package/dist/ops/accounts.js +170 -0
  108. package/dist/ops/autoUpdate.js +223 -0
  109. package/dist/ops/discoverAccounts.js +343 -0
  110. package/dist/ops/doctor.js +811 -0
  111. package/dist/ops/elevated.js +47 -0
  112. package/dist/ops/errorCodes.js +39 -0
  113. package/dist/ops/follow.js +558 -0
  114. package/dist/ops/merge.js +830 -0
  115. package/dist/ops/notify.js +249 -0
  116. package/dist/ops/plugin.js +92 -0
  117. package/dist/ops/projects.js +113 -0
  118. package/dist/ops/quarantine.js +415 -0
  119. package/dist/ops/rollback.js +868 -0
  120. package/dist/ops/schedule.js +464 -0
  121. package/dist/ops/successor.js +51 -0
  122. package/dist/ops/sync.js +859 -0
  123. package/dist/ops/syncStatus.js +290 -0
  124. package/dist/ops/update.js +273 -0
  125. package/dist/ops/updater.js +641 -0
  126. package/dist/ops/watch.js +676 -0
  127. package/dist/ops/watcherControl.js +212 -0
  128. package/dist/ops/watcherHealth.js +75 -0
  129. package/dist/organize/apply.js +495 -0
  130. package/dist/organize/history.js +192 -0
  131. package/dist/organize/plan.js +283 -0
  132. package/dist/organize/rename.js +58 -0
  133. package/dist/organize/sessions.js +100 -0
  134. package/dist/organize/titles.js +70 -0
  135. package/dist/organize/types.js +73 -0
  136. package/dist/plan/categories.js +104 -0
  137. package/dist/plan/dedupe.js +137 -0
  138. package/dist/plan/folders.js +82 -0
  139. package/dist/plan/names.js +93 -0
  140. package/dist/plan/ownership.js +316 -0
  141. package/dist/plan/planner.js +669 -0
  142. package/dist/plan/rehome.js +101 -0
  143. package/dist/plan/report.js +407 -0
  144. package/dist/sources/cache.js +89 -0
  145. package/dist/sources/claude.js +297 -0
  146. package/dist/sources/codex.js +496 -0
  147. package/dist/sources/flatten.js +23 -0
  148. package/dist/sources/jsonl.js +169 -0
  149. package/dist/sources/native.js +233 -0
  150. package/dist/sources/opencode.js +483 -0
  151. package/dist/sources/pi.js +133 -0
  152. package/dist/sources/registry.js +67 -0
  153. package/dist/sources/types.js +80 -0
  154. package/dist/t3/api.js +492 -0
  155. package/dist/t3/auth.js +248 -0
  156. package/dist/t3/compat.js +62 -0
  157. package/dist/t3/decode.js +408 -0
  158. package/dist/t3/errors.js +185 -0
  159. package/dist/t3/rpc.js +185 -0
  160. package/dist/t3/runtime.js +80 -0
  161. package/dist/ui/caps.js +56 -0
  162. package/dist/ui/components.js +202 -0
  163. package/dist/ui/layout.js +205 -0
  164. package/dist/ui/list.js +423 -0
  165. package/dist/ui/locale.js +73 -0
  166. package/dist/ui/organizePreview.js +72 -0
  167. package/dist/ui/progress.js +237 -0
  168. package/dist/ui/style.js +32 -0
  169. package/dist/ui/terminal.js +126 -0
  170. package/dist/ui/text.js +186 -0
  171. package/package.json +58 -4
  172. package/skills/t3code-sessions/SKILL.md +183 -0
@@ -0,0 +1,566 @@
1
+ // O que `t3sm --help` e `t3sm <comando> --help` dizem, em português europeu: o gémeo de help.en.ts, com os mesmos
2
+ // comandos e a mesma forma (blocos separados por linhas em branco, "Uso:", títulos como "Opções:" seguidos de itens
3
+ // recolhidos dois espaços, comandos entre `acentos graves`). As opções são as mesmas do inglês: são os nomes que o
4
+ // t3sm aceita.
5
+
6
+ export const GLOBAL = `
7
+ Opções globais (todos os comandos):
8
+ --lang en|pt A língua do que o t3sm escreve. Por omissão: a variável
9
+ T3SM_LANG, depois "language" no config.json, depois a língua
10
+ do sistema, senão inglês. O --json, o plan.md e os registos
11
+ ficam sempre em inglês.
12
+ --no-color Sem cor (o NO_COLOR também é respeitado)
13
+ `;
14
+
15
+ export const USAGE = `O t3sm traz as tuas sessões do Claude Code, do Codex, do Pi e do OpenCode para o T3 Code.
16
+
17
+ Uso: t3sm [comando] [opções]
18
+
19
+ Começar aqui
20
+ t3sm start Configuração guiada, passo a passo (também só \`t3sm\`; \`--lang en\` em inglês)
21
+
22
+ Importar
23
+ t3sm doctor Verifica esta máquina, o T3 Code e as contas (só leitura)
24
+ t3sm plan Prepara o plano de importação em plan.md (não muda nenhuma sessão)
25
+ t3sm apply Importa as sessões do plano (--dry-run, --only "<pasta>")
26
+
27
+ Contas e projetos
28
+ t3sm accounts As tuas subscrições do Claude e as instâncias delas no T3 Code
29
+ t3sm projects A conta que cada projeto usa (set "<pasta>" <conta>, rename --suggest)
30
+
31
+ Manter sincronizado
32
+ t3sm status O t3sm precisa de ti? Tudo bem, precisa de ti ou a trabalhar (só leitura; saída 10: precisa de ti)
33
+ t3sm sync Importa o que é novo desde a última vez (--watch continua a vigiar)
34
+ t3sm schedule Sincroniza em segundo plano: install [--watch], remove, restart, status
35
+ t3sm merge Traz para o T3 Code as sessões continuadas num terminal
36
+ t3sm recover <id> Traz de volta uma conversa começada no T3 Code cuja thread desapareceu
37
+
38
+ Arrumar o T3 Code
39
+ t3sm organize Arruma o histórico importado: arquiva, muda títulos, mostra, fixa (--undo)
40
+
41
+ Limpar e desfazer
42
+ t3sm quarantine Move as pastas de cópia de segurança para uma quarentena reversível
43
+ t3sm dedupe Move as cópias-espelho do plano para uma quarentena reversível
44
+ t3sm runs Lista o que cada execução fez
45
+ t3sm rollback Desfaz uma execução (--run <id>)
46
+
47
+ Ajuda e manutenção
48
+ t3sm help O que uma mensagem quer dizer e o que fazer (t3sm help <tópico>)
49
+ t3sm scan Conta as sessões por agente e por conta (não precisa do T3 Code)
50
+ t3sm update Atualiza o t3sm para a versão mais recente (--check só vê)
51
+ t3sm changelog O que há de novo nesta versão (--since <versão>)
52
+ t3sm --version Mostra a versão
53
+
54
+ Cada comando explica-se a si próprio: \`t3sm <comando> --help\`. Os comandos que escrevem perguntam primeiro; o
55
+ --dry-run mostra o que fariam.
56
+ `;
57
+
58
+ export const COMMANDS = {
59
+ doctor: `Uso: t3sm doctor [--json] [--repair]
60
+
61
+ Verifica tudo aquilo de que o t3sm depende e diz o que corrigir: o Node, a pasta de estado, o config.json, o bloqueio,
62
+ execuções interrompidas, o CLAUDE_CONFIG_DIR da shell, o T3 Code (a correr, versão, CLI, uma sessão só de leitura),
63
+ as instâncias do Claude e a conta com que cada uma tem sessão iniciada (emails mascarados), contas encontradas nesta
64
+ máquina que faltam no config.json, pastas de cópia de segurança e de quarentena, os agentes (Claude Code, Codex, Pi,
65
+ OpenCode), os comandos /t3sm e a sincronização em segundo plano. Só leitura: abre uma sessão só de leitura no T3 Code
66
+ e revoga-a antes de sair. Sai com 1 quando uma verificação falha.
67
+
68
+ Opções:
69
+ --json Escreve as verificações em JSON (sempre em inglês)
70
+ --repair Repõe as datas dos ficheiros de conversa deixadas adiantadas por
71
+ uma execução interrompida (fica com o bloqueio; é a única coisa
72
+ que o doctor alguma vez escreve)
73
+ `,
74
+ accounts: `Uso: t3sm accounts [--show-emails] [--allow-untested]
75
+ t3sm accounts --init [--force]
76
+ t3sm accounts --apply [--yes] [--allow-untested]
77
+ t3sm accounts --rename <id> "<Nome a mostrar>" [--color "#RRGGBB"]
78
+
79
+ Sem opções: uma tabela, só de leitura, das contas do config.json ao lado das instâncias do T3 Code (o email com
80
+ sessão iniciada, mascarado como b***@example.com; sessão, disponibilidade, onde cada conta foi encontrada), com um
81
+ aviso para emails partilhados, contas sem instância, instâncias com a sessão terminada e contas encontradas nesta
82
+ máquina que faltam no config.json.
83
+
84
+ As contas são procuradas em ~/.claude, nas pastas ~/.claude-*, no CLAUDE_CONFIG_DIR dos perfis da shell (PowerShell,
85
+ bash, zsh, fish; o nome do alias ou da função passa a ser o id da conta), nas fixações de .vscode/settings.json, na
86
+ shell atual e nas pastas das instâncias que já existem no T3. Uma pasta só conta quando tem projects/.
87
+
88
+ Opções:
89
+ --init Escreve o config.json com todas as contas encontradas (nunca emails)
90
+ --force Com --init, substitui um config.json que já exista
91
+ --apply Cria as instâncias que faltam e fixa o claudeAgent em ~/.claude
92
+ --yes Não pergunta (obrigatório quando não há terminal)
93
+ --rename Muda o nome (e a cor) de uma instância no seletor do T3 Code,
94
+ e faz o mesmo no config.json
95
+ --color Com --rename: a cor da instância, como #RRGGBB
96
+ --show-emails Mostra os emails completos na tabela (mascarados por omissão)
97
+ --allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
98
+
99
+ Exemplos:
100
+ t3sm accounts
101
+ t3sm accounts --apply
102
+ t3sm accounts --rename claude-work "Claude Trabalho" --color "#7C3AED"
103
+ `,
104
+ apply: `Uso: t3sm apply [--plan <caminho>] [--yes | --dry-run] [--only <pasta>] [--quiet] [--verbose] [--allow-untested]
105
+
106
+ Importa as sessões de um plano para o T3 Code: cria as instâncias e os projetos que faltam, define a conta por omissão
107
+ de cada projeto e importa por vagas (as conversas antigas têm a data do ficheiro adiantada por um momento, registada
108
+ no diário, para que o próprio importador do T3 Code as aceite; todas as datas são repostas a seguir). O Ctrl+C repõe a
109
+ vaga em curso e para. Sai com 5 quando algumas sessões não puderam ser importadas: uma tabela diz porquê e o que
110
+ fazer, e \`t3sm help <tópico>\` explica cada motivo.
111
+
112
+ Opções:
113
+ --plan <caminho> O plano a aplicar (por omissão: o runs/*/plan.json mais recente)
114
+ --yes Não pergunta (obrigatório quando não há terminal)
115
+ --dry-run Faz todas as verificações (sessão só de leitura no T3
116
+ Code), mostra o resumo e o que faria, não escreve nada
117
+ --only <pasta> Aplica só as sessões da pasta deste projeto
118
+ --quiet Sem progresso (e nada quando outra execução tem o bloqueio)
119
+ --verbose Mostra também uma linha por vaga de importação (a barra de
120
+ progresso continua)
121
+ --allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
122
+
123
+ O T3 Code importa de uma vez todas as conversas recentes de um projeto, de todas as contas. Por isso, enquanto um
124
+ projeto é importado, as outras conversas recentes dele (cópias-espelho e de segurança, excluídas, vagas seguintes)
125
+ ficam estacionadas: a data do ficheiro passa para 7 dias no futuro, o que o T3 Code ignora, e volta logo a seguir (um
126
+ crash é reparado pela execução seguinte do t3sm). Um projeto com uma sessão em uso agora espera pela execução
127
+ seguinte (\`t3sm help held\`). As cópias-espelho dentro da janela são indicadas: corre \`t3sm dedupe\` para que a
128
+ importação de boas-vindas do T3 Code também não as apanhe.
129
+
130
+ Um plano com mais de 24 h, ou feito para outra versão do T3 Code, é recusado: corre \`t3sm plan\` outra vez.
131
+
132
+ Exemplos:
133
+ t3sm apply --dry-run
134
+ t3sm apply --only "~/code/app"
135
+ t3sm apply
136
+ `,
137
+ quarantine: `Uso: t3sm quarantine [--yes | --dry-run]
138
+
139
+ Move as pastas de cópia de segurança dentro da pasta projects/ de cada conta (\`.bak-*\`, \`<pasta>.bak\`,
140
+ \`<pasta>.bak-AAAAMMDD-HHMMSS\`) para <pasta da conta>/session-manager-quarantine/backups/. Nada é apagado: cada
141
+ movimento é uma mudança de nome no mesmo disco (as datas ficam), fica no diário e é desfeito por \`t3sm rollback --run
142
+ <id>\`. Uma pasta com um ficheiro alterado nos últimos 10 minutos fica onde está.
143
+
144
+ Opções:
145
+ --yes Não pergunta (obrigatório quando não há terminal)
146
+ --dry-run Só lista o que seria movido
147
+ `,
148
+ dedupe: `Uso: t3sm dedupe [--plan <caminho>] [--yes | --dry-run]
149
+
150
+ Move as cópias-espelho do plano (uma sessão copiada para uma segunda conta, igual à cópia que fica ou um início mais
151
+ antigo dela) para <pasta da conta>/session-manager-quarantine/mirror/<pasta do projeto>/, junto com a pasta que
152
+ acompanha a sessão. Cada cópia é comparada outra vez mesmo antes de ser movida; ramificações, ficheiros em uso e
153
+ cópias cuja cópia guardada já não existe ficam onde estão. Desfaz-se com \`t3sm rollback --run <id>\`.
154
+
155
+ Opções:
156
+ --plan <caminho> O plano a usar (por omissão: o runs/*/plan.json mais recente; com mais de 24 h é recusado)
157
+ --yes Não pergunta (obrigatório quando não há terminal)
158
+ --dry-run Só lista o que seria movido
159
+ `,
160
+ merge: `Uso: t3sm merge [--session <id> | --all] [--yes | --dry-run] [--allow-untested]
161
+
162
+ Traz para o T3 Code o trabalho continuado num terminal (\`claude --resume\`). O T3 Code continua uma thread importada a
163
+ partir da última mensagem que conhece, por isso as mensagens escritas no terminal depois da importação não aparecem
164
+ lá. Uma junção:
165
+ - cria um ficheiro de sessão novo ao lado do original (<id da revisão>.jsonl) com o ramo que o \`claude --resume\`
166
+ continuaria; o ficheiro original nunca é editado;
167
+ - importa-o para o T3 Code como uma thread nova e arquiva a thread antiga;
168
+ - é reversível com \`t3sm rollback --run <id>\`.
169
+
170
+ Sem --session nem --all só lista as candidatas (projeto, sessão, última atividade no terminal, mensagens novas) e sai
171
+ com 0. Uma sessão só conta como continuada com uma prova: uma mensagem depois da importação escrita por outro ponto
172
+ de entrada que não o T3 Code. As sessões escritas nos últimos 10 minutos esperam; um projeto com outra sessão em uso
173
+ espera. Uma sessão compactada não é juntada (ainda não é suportado), nem uma com a cadeia de mensagens partida. O
174
+ trabalho de terminal num ramo lateral (não o que o \`claude --resume\` continua) é listado com a dica \`claude --resume
175
+ <id>\` e nunca é juntado.
176
+
177
+ Depois de uma junção: continua no T3 Code na thread nova, ou num terminal com \`claude --resume <id da revisão>\`
178
+ (escrito para cada junção). O id da sessão original continua a poder ser retomado no terminal, mas passa a ser um ramo
179
+ desatualizado, e o seletor do \`claude --resume\` mostra os dois. Nunca tenhas a mesma sessão aberta no T3 Code e num
180
+ terminal ao mesmo tempo. Desfaz-se com \`t3sm rollback --run <id>\`: uma revisão intacta é apagada e a thread antiga
181
+ desarquivada; uma revisão continuada entretanto fica (as duas threads ficam). O \`t3sm sync\` só indica as junções por
182
+ fazer, a menos que sync.autoMerge seja true no config (por omissão false): aí junta-as ele próprio.
183
+
184
+ Opções:
185
+ --session <id> Junta uma sessão (o id, ou um início único com 8 ou mais caracteres)
186
+ --all Junta todas as candidatas
187
+ --yes Não pergunta (obrigatório quando não há terminal)
188
+ --dry-run Só lista as candidatas
189
+ --allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
190
+
191
+ Exemplos:
192
+ t3sm merge
193
+ t3sm merge --session 1a2b3c4d
194
+ t3sm merge --all
195
+ `,
196
+ recover: `Uso: t3sm recover <id da sessão> [--yes | --dry-run] [--allow-untested]
197
+
198
+ Traz de volta uma conversa começada no T3 Code cuja thread do T3 Code desapareceu. O t3sm não o consegue saber sozinho
199
+ quando a transcrição não indica nenhuma thread do T3 Code (o \`t3sm status\` lista essas conversas em Bom saber), por
200
+ isso és tu a indicá-la. Recusa a menos que a conversa tenha começado no T3 Code e nenhuma thread do T3 Code que o t3sm
201
+ vê a tenha. A conversa volta como cópia fiel com um id de sessão novo, importada para o seu projeto (fica no diário;
202
+ desfaz-se com \`t3sm rollback --run <id> --archive-threads\`). O ficheiro original fica como está. Se a thread ainda
203
+ existir no T3 Code, isto cria um duplicado. Num terminal mostra o que vai fazer e pergunta primeiro.
204
+
205
+ Opções:
206
+ --yes Não pergunta (obrigatório quando não há terminal)
207
+ --dry-run Só mostra o que faria
208
+ --allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
209
+
210
+ Exemplos:
211
+ t3sm recover 1a2b3c4d --dry-run
212
+ t3sm recover 1a2b3c4d
213
+ `,
214
+ rollback: `Uso: t3sm rollback [--run <id>] [--yes | --dry-run] [--instances] [--archive-threads] [--allow-untested]
215
+
216
+ Desfaz uma execução. Sem --run mostra a execução mais recente que não seja ela própria um rollback (pode ser uma
217
+ sincronização automática) e pergunta; --yes precisa de --run <id>:
218
+ - os ficheiros convertidos que escreveu são apagados, a menos que tenham sido editados entretanto (aí ficam e são
219
+ listados);
220
+ - o que pôs em quarentena volta ao lugar (um caminho original que voltou a existir fica na quarentena e é
221
+ indicado);
222
+ - as contas por omissão que definiu nos projetos são repostas (precisa do T3 Code a correr; senão a parte dos
223
+ ficheiros corre na mesma e o resto é indicado);
224
+ - uma junção (\`t3sm merge\`): a revisão é apagada, a thread antiga desarquivada e a thread da revisão arquivada;
225
+ uma revisão continuada entretanto fica e as duas threads ficam como estão (indicado);
226
+ - uma execução de organize (\`t3sm organize\`, \`t3sm projects rename --suggest\`): as alterações são revertidas onde
227
+ o T3 Code ainda mostra o que o t3sm deixou, tal como \`t3sm organize --undo <run>\`; o que mudaste depois fica.
228
+ As threads importadas e as instâncias e projetos criados são listados, nunca apagados. Corrê-lo duas vezes não muda
229
+ nada na segunda.
230
+
231
+ Opções:
232
+ --run <id> A execução a desfazer (ver \`t3sm runs\`)
233
+ --yes Não pergunta (precisa de --run; obrigatório quando não há terminal)
234
+ --dry-run Só lista o que seria desfeito
235
+ --instances Repõe também os nomes, cores e pastas das instâncias que a execução mudou
236
+ --archive-threads Arquiva (não apaga) as threads que a execução importou
237
+ --allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
238
+
239
+ Exemplos:
240
+ t3sm runs
241
+ t3sm rollback --run 20261114-120000-abcd --dry-run
242
+ t3sm rollback --run 20261114-120000-abcd --yes
243
+ `,
244
+ sync: `Uso: t3sm sync [--quiet] [--verbose] [--allow-untested]
245
+ t3sm sync --watch [--quiet] [--allow-untested]
246
+ t3sm sync --dry-run [--allow-untested]
247
+
248
+ Um ciclo sem supervisão: prepara um plano novo e aplica-o sem perguntar. Foi feito para correr a partir de um
249
+ agendador, por isso é cauteloso:
250
+ - nunca cria instâncias no T3 (as sessões de uma conta que falta esperam por \`t3sm accounts --apply\`), nunca põe
251
+ em quarentena nem tira duplicados;
252
+ - as sessões continuadas num terminal depois de o t3sm as importar são indicadas (corre \`t3sm merge\`); com
253
+ sync.autoMerge true (por omissão false) junta-as ele próprio quando estão paradas há 10 min, no máximo 20 por
254
+ ciclo;
255
+ - uma sessão com uma cópia-espelho dentro da janela de 30 dias do T3 Code espera por \`t3sm dedupe\` (a cópia fica
256
+ estacionada enquanto o projeto importa);
257
+ - um projeto com uma sessão em uso agora espera pelo ciclo seguinte;
258
+ - uma sessão cuja importação falhou (e que não mudou desde então) espera por \`t3sm apply\`;
259
+ - mais de sync.maxUnattendedImports (por omissão 200) por importar: nada é importado, uma linha diz para correr
260
+ \`t3sm apply\` uma vez (mesmo com --quiet);
261
+ - uma conta por omissão que escolheste no T3 Code nunca é substituída;
262
+ - nada para importar quer dizer nada escrito (nem entrada no diário, nem pasta de execução).
263
+ Sai com 3 quando o T3 Code não está a correr (em silêncio com --quiet), com 0 quando outra execução do t3sm tem o
264
+ bloqueio, com 4 para um T3 Code incompatível, com 2 quando a instância do Claude por omissão do T3 Code lê outra pasta.
265
+ Cada ciclo acrescenta uma linha (só contagens e ids de execução) a <estado>/logs/sync.log (rodado a 1 MiB, ficam 3).
266
+
267
+ Opções:
268
+ --quiet Nada no ecrã a não ser um erro numa linha (saída 2/4/1/5)
269
+ --watch Fica a correr: vigia as pastas das conversas, corre um
270
+ ciclo quando as mudanças acalmam e outra vez quando uma
271
+ sessão alterada fica parada 10 min, e ainda a cada
272
+ schedule.everyMinutes; espera enquanto o T3 Code está
273
+ fechado. Escreve <estado>/sync-status.json. O Ctrl+C para
274
+ depois do ciclo em curso. Um segundo vigilante sai com 0.
275
+ --dry-run Só mostra o que um ciclo importaria (não escreve nada, nem
276
+ a cache de descoberta)
277
+ --verbose Mostra também uma linha por vaga de importação (sem efeito
278
+ com --quiet ou --watch, que nunca desenham progresso)
279
+ --allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
280
+
281
+ Exemplos:
282
+ t3sm sync --dry-run
283
+ t3sm sync
284
+ t3sm schedule install --watch
285
+ `,
286
+ schedule: `Uso: t3sm schedule install [--watch] [--yes | --dry-run]
287
+ t3sm schedule remove [--yes | --dry-run]
288
+ t3sm schedule restart [--yes | --dry-run]
289
+ t3sm schedule status
290
+
291
+ Regista \`t3sm sync --quiet\` no agendador do sistema, como o utilizador atual, sem elevação: o Agendador de Tarefas do
292
+ Windows (um XML da tarefa em <estado>/schedule/: a cada schedule.everyMinutes, só com a tua sessão iniciada, janela
293
+ escondida, nunca dois ao mesmo tempo), um LaunchAgent no macOS, ou uma linha do crontab marcada "# t3sm". Com --watch o
294
+ agendador arranca \`t3sm sync --watch --quiet\` quando inicias sessão, carregas ou reinicias, e o Windows e o cron
295
+ verificam a cada 15 min que continua a correr (um que já corre fica como está). O vigilante reinicia-se sozinho para
296
+ um t3sm mais recente depois do ciclo seguinte, quando há um instalado. Corre-o a partir da tua própria conta: numa
297
+ shell aberta como Administrador, o t3sm avisa que o agendamento fica instalado só para esse utilizador.
298
+
299
+ O install e o remove podem ser corridos as vezes que quiseres. O install --watch para primeiro um vigilante em
300
+ execução (pedido pelo próprio canal dele; um processo verificado só em último caso, nunca pelo nome), volta a criar a
301
+ entrada e arranca já o vigilante novo; o remove também o para e di-lo (sai com 1 e o pid se ainda estiver a correr); o
302
+ restart para e arranca o vigilante agendado sem reinstalar (sai com 2 quando nada está instalado). O status mostra a
303
+ entrada do agendador, o comando que corre (e se os caminhos dele ainda existem), o sinal de vida do vigilante e o
304
+ último ciclo registado.
305
+
306
+ Opções:
307
+ --watch Com install: um vigilante sempre a correr desde o início de sessão, em vez de um ciclo de poucos em poucos minutos
308
+ --yes Não pergunta (obrigatório quando não há terminal)
309
+ --dry-run Mostra o que aconteceria; não muda nada
310
+
311
+ Exemplos:
312
+ t3sm schedule install --watch --dry-run
313
+ t3sm schedule install --watch
314
+ t3sm schedule status
315
+ `,
316
+ start: `Uso: t3sm start [--lang en|pt] [--no-color]
317
+
318
+ Uma configuração guiada para quem prefere não aprender os comandos. Em passos curtos, corre por ti os comandos do
319
+ próprio t3sm: verificação (doctor), contas, o plano e a tabela de projetos e contas, limpeza (quarantine, dedupe), uma
320
+ importação de experiência de um projeto, a importação completa, a sincronização em segundo plano e um resumo com os
321
+ ids das execuções e como as desfazer. Antes de cada escrita pergunta, e só s avança (Enter quer dizer não). Em
322
+ qualquer pergunta: ? explica mais, b volta atrás, q para; nada fica a meio. Corre-o outra vez para continuar: descobre
323
+ onde estavas a partir do estado do próprio t3sm (diário, plano, config, agendador).
324
+
325
+ O \`t3sm\` sozinho num terminal também o arranca. Sem terminal, escreve o início rápido e sai com 0.
326
+
327
+ Opções:
328
+ --lang en|pt A língua (ver as opções globais abaixo); o start oferece-se
329
+ para a guardar como "language" no config.json
330
+ `,
331
+ projects: `Uso: t3sm projects [--json] [--allow-untested]
332
+ t3sm projects set "<pasta>" <conta> [--yes | --dry-run] [--force] [--allow-untested]
333
+ t3sm projects unset "<pasta>" [--dry-run]
334
+ t3sm projects rename --suggest [--yes | --dry-run] [--allow-untested]
335
+
336
+ Sem subcomando: uma tabela, só de leitura, de todas as pastas de projeto que o t3sm conhece, com a conta em que as
337
+ threads novas começam, porquê (route: uma regra no config.json; vscode-pin: .vscode/settings.json; recent-activity: a
338
+ conta da sessão mais recente; default: defaultAccount), as sessões por importar, se o projeto já está no T3 Code (sim,
339
+ não, arquivado) e se uma sessão dele está em uso (uma importação espera por ela). Com o T3 Code fechado mostra o que
340
+ esta máquina sabe e di-lo.
341
+
342
+ t3sm projects set "<pasta>" <conta>
343
+ Escreve no config.json uma regra para essa pasta exata (ou substitui a regra dela no mesmo sítio). Uma regra nova
344
+ fica mesmo antes da primeira regra com asterisco que apanhe a pasta, por isso só ganha para essa pasta: a conta de
345
+ nenhuma outra pasta muda. Quando a pasta já é um projeto do T3 Code e o T3 Code está a correr, também define lá a
346
+ conta por omissão do projeto (fica no diário: \`t3sm rollback --run <id>\` desfaz). A regra decide onde começam as
347
+ threads novas e para que conta vão as sessões do OpenCode e as do Codex comprimidas ainda por importar; as sessões
348
+ do Claude Code ficam na conta em que foram gravadas, e as threads que já estão no T3 Code ficam com a sua. ~ é a
349
+ tua pasta pessoal; uma regra cobre essa pasta exata, não as subpastas. Pergunta primeiro.
350
+
351
+ t3sm projects unset "<pasta>"
352
+ Remove a regra dessa pasta (as regras com asterisco ficam). O T3 Code não muda.
353
+
354
+ t3sm projects rename --suggest
355
+ Nomes limpos para os projetos que o t3sm criou e cujo título ainda é o que o t3sm lhes deu (um projeto a que mudaste
356
+ o nome nunca é tocado): o nome da pasta, \`pai/nome\` para pastas genéricas como src ou app, no máximo
357
+ organize.names.maxLength caracteres (por omissão 40), com uma pasta pai acrescentada quando o nome já existe.
358
+ Mostra cada título antes -> depois e pergunta. Cada mudança de nome fica no diário: \`t3sm organize --undo <run>\`
359
+ repõe os títulos antigos.
360
+
361
+ Opções:
362
+ --json Escreve a tabela em JSON
363
+ --yes Não pergunta (obrigatório quando não há terminal)
364
+ --dry-run Só mostra a mudança; não escreve nada
365
+ --force Com set: aceita uma pasta que (ainda) não existe
366
+ --suggest Com rename: calcula os nomes limpos (o único modo)
367
+ --allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
368
+
369
+ Exemplos:
370
+ t3sm projects
371
+ t3sm projects set "~/code/app" claude-work --dry-run
372
+ t3sm projects rename --suggest --dry-run
373
+ `,
374
+ organize: `Uso: t3sm organize [--dry-run | --yes] [--only <pasta>] [--history <dias|all|off>] [--min <n>]
375
+ [--auto-settle <dias|off>] [--no-delete] [--no-pin <ids>] [--no-archive-folders]
376
+ [--allow-untested] [--plain]
377
+ t3sm organize --undo [<run>] [--dry-run | --yes] [--allow-untested]
378
+
379
+ Arruma o histórico que o t3sm importou para o T3 Code. Primeiro mostra uma linha por tipo de alteração, com quantas,
380
+ porquê e como desfazer, depois os projetos com mais conversas à vista (agora -> depois), e pergunta antes de mudar
381
+ alguma coisa:
382
+ - arquiva as conversas automáticas (começadas pelo Agent SDK) e as de um projeto que o t3sm criou numa pasta
383
+ temporária ou do sistema;
384
+ - títulos novos para as conversas cujo título é uma primeira mensagem técnica (<command-name>, <ide_...>, [external
385
+ ...]): o título da própria conversa, o resumo ou a primeira mensagem a sério, no máximo 80 caracteres;
386
+ - mantém arrumado o histórico de cada projeto (organize.history, por omissão os últimos 90 dias e pelo menos 10 por
387
+ projeto): as conversas com atividade nesses dias ficam à vista dentro do projeto, as mais antigas passam para
388
+ Settled (ficam no projeto, na prateleira Settled), e um projeto com menos conversas recentes continua a mostrar as
389
+ mais recentes; a passagem automática para Settled do próprio T3 Code não muda a menos que passes --auto-settle
390
+ (\`t3sm help history\`);
391
+ - fixa os projetos com atividade mais recente (organize.pinRecent, por omissão 5) e desafixa os que o t3sm fixou e
392
+ já não estão entre eles;
393
+ - apaga os projetos vazios que o t3sm criou (sem conversa nenhuma).
394
+ As definições ficam em "organize" no config.json (organize.titles, organize.archiveAutomated, ...).
395
+
396
+ As conversas que começaste no T3 Code nunca são tocadas, nem os projetos que criaste (a não ser para fixar), as
397
+ definições do T3 Code (a menos que passes --auto-settle) ou a base de dados dele. O que mudares no T3 Code depois do
398
+ t3sm fica como deixaste: uma conversa que desarquivaste, a que mudaste o nome, passaste para Settled ou reabriste, ou um projeto
399
+ que desafixaste. Cada alteração fica no diário. Numa versão do T3 Code que o t3sm não testou, avisa uma vez e
400
+ continua.
401
+
402
+ Opções:
403
+ --dry-run Mostra o que mudaria; não escreve nada (nem a cache de
404
+ descoberta do t3sm)
405
+ --yes Não pergunta (obrigatório quando não há terminal)
406
+ --only <pasta> Só as conversas deste projeto do T3 Code (sem fixar, sem
407
+ apagar)
408
+ --undo [<run>] Reverte uma execução de organize. Sem id oferece a mais
409
+ recente ainda por desfazer e pergunta; com --yes o id é
410
+ obrigatório. Só volta atrás o que o T3 Code ainda mostra
411
+ como o t3sm deixou; um projeto apagado é recriado.
412
+ \`t3sm rollback --run <run>\` faz o mesmo.
413
+ --history <dias|all|off> A regra do histórico só para esta execução (o
414
+ config.json não muda): os últimos 1-3650 dias, tudo (all)
415
+ ou desligada (off)
416
+ --min <n> Mostra pelo menos n (0-1000) conversas por projeto, só
417
+ nesta execução (com os dias configurados)
418
+ --auto-settle <dias|off> Muda também a passagem automática para Settled do T3
419
+ Code, para as conversas começadas no T3 Code: depois de
420
+ 1-90 dias (o T3 Code não aceita outra coisa), ou desligada
421
+ (fica registado; o --undo repõe o valor antigo)
422
+ --no-delete Deixa ficar os projetos vazios que o t3sm criou
423
+ --no-pin <ids> Nunca fixa estes projetos (ids de projeto do T3 Code, separados por vírgulas)
424
+ --no-archive-folders Não arquiva as conversas dos projetos que o t3sm criou
425
+ em pastas temporárias ou do sistema
426
+ --allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
427
+ --plain Só texto simples, nunca um ecrã interativo. Num terminal,
428
+ a pergunta oferece d = detalhes: as alterações numa lista
429
+ que revês com as setas; as que desmarcares não são
430
+ aplicadas
431
+
432
+ Exemplos:
433
+ t3sm organize --dry-run
434
+ t3sm organize
435
+ t3sm organize --only "~/code/app" --yes
436
+ t3sm organize --history 90 --min 10 --auto-settle 90 --dry-run
437
+ t3sm organize --undo
438
+ t3sm organize --undo 20261114-120000-abcd --dry-run
439
+ t3sm organize --undo 20261114-120000-abcd --yes
440
+ `,
441
+ update: `Uso: t3sm update [--from <pasta> | --source npm|github] [--yes | --dry-run]
442
+ t3sm update --check
443
+ t3sm update --auto on|off [--dry-run]
444
+
445
+ Atualiza o t3sm para a versão mais recente da origem: o registo do npm (uma instalação que veio de lá), as etiquetas
446
+ vX.Y.Z do GitHub (o repositório do package.json), ou as etiquetas no main de uma cópia do código neste computador.
447
+ Primeiro mostra o que há de novo (uma pasta: o CHANGELOG.md dessa etiqueta; npm e GitHub: depois da instalação, a
448
+ partir do CHANGELOG.md instalado) e depois pergunta. A instalação é um \`npm install -g\` dessa versão exata; o vigilante em segundo plano é parado (pelo próprio
449
+ controlo dele, nunca pelo nome) e volta a arrancar na versão nova, e se nenhum sinal de vida dele chegar em 2 minutos
450
+ a versão anterior é reinstalada. Cada atualização fica no diário. O t3sm nunca volta a uma versão anterior. Uma cópia
451
+ git ou a cache do npx só recebem instruções. Numa shell aberta como Administrador, o t3sm avisa que a atualização fica
452
+ instalada só para esse utilizador.
453
+
454
+ Uma vez por dia o vigilante também procura (update.auto, ligado por omissão): uma versão de correção ou menor mais
455
+ recente (incluindo as menores 0.x) é instalada sozinha, uma versão maior só é anunciada; uma atualização que falhou ou
456
+ voltou atrás aparece no \`t3sm status\` (\`t3sm help updates\`), e a procura automática salta uma versão desfeita (o
457
+ t3sm update ainda a pode instalar). Procurar as versões (npm view, ou git ls-remote para o GitHub) é a única ligação
458
+ à rede do próprio t3sm; instalar uma versão descarrega-a com o npm.
459
+
460
+ Opções:
461
+ --check Só vê: a versão instalada, a mais recente e o tipo dela
462
+ (nenhuma, correção, menor, maior), a origem, se as
463
+ atualizações automáticas estão ligadas, a última procura,
464
+ uma atualização interrompida e como voltar atrás. Só
465
+ leitura (sem bloqueio); sai com 0 mesmo sem rede
466
+ --from <pasta> Atualiza a partir desta cópia do código (um caminho local
467
+ absoluto como D:\\code\\t3sm; nunca uma pasta de rede);
468
+ fica lembrado para as próximas quando a versão nova entra
469
+ --source npm Atualiza a partir do registo do npm (lembrado da mesma forma)
470
+ --source github Atualiza a partir das etiquetas do GitHub (lembrado da mesma forma)
471
+ --auto on|off Liga ou desliga a atualização automática diária no
472
+ config.json (corre t3sm start primeiro se não houver um).
473
+ Uma preferência como o \`projects unset\`: não precisa de --yes
474
+ --yes Não pergunta (obrigatório quando não há terminal); a única
475
+ forma de uma versão maior ser instalada sem perguntar
476
+ --dry-run Mostra o que seria instalado; não muda nada
477
+ --auto-run Usado pelo vigilante com --yes (só correções ou menores);
478
+ não precisas dele
479
+
480
+ Exemplos:
481
+ t3sm update --check
482
+ t3sm update --dry-run
483
+ t3sm update --auto off
484
+ `,
485
+ changelog: `Uso: t3sm changelog [--since <versão>]
486
+
487
+ As notas de versão do t3sm instalado, a partir do próprio CHANGELOG.md (escrito em inglês): a secção desta versão,
488
+ ou com --since todas as versões mais recentes do que essa, da mais nova para a mais antiga. Só leitura.
489
+
490
+ Opções:
491
+ --since <versão> As notas das versões depois desta (como 0.2.1)
492
+ `,
493
+ runs: `Uso: t3sm runs [--json]
494
+
495
+ Lista as execuções registadas no diário: id, hora de início, comando, estado e o que cada uma mudou. Só leitura.
496
+
497
+ Opções:
498
+ --json Escreve as execuções em JSON
499
+ `,
500
+ status: `Uso: t3sm status [--json]
501
+
502
+ Diz se o t3sm precisa de ti. A primeira linha é um nível: "Tudo bem", "Precisa de ti (N)" ou "A trabalhar" (está a
503
+ correr uma execução do t3sm). Depois vêm os itens, primeiro o que precisa de ti, cada um com o comando que o resolve:
504
+ o vigilante em segundo plano (parado, numa versão antiga do t3sm, ou a falhar); uma atualização do t3sm que falhou
505
+ ou foi interrompida; conversas à espera da tua decisão; conversas que continuam a falhar na importação; cópias
506
+ continuadas duas vezes; cópias à espera de uma pasta; alterações que a última execução de organize não conseguiu
507
+ fazer. Bom saber (nunca uma necessidade): uma atualização recente, uma atualização desfeita (a versão anterior voltou
508
+ a correr: o t3sm recuperou sozinho), uma versão mais recente que não foi
509
+ instalada (uma versão maior só é anunciada: o t3sm nunca a instala sozinho), projetos à espera porque uma conversa
510
+ está em uso, conversas começadas no T3 Code que o t3sm deixa de fora. Depois a última e a próxima sincronização, a
511
+ última execução de organize e se o T3 Code está a correr. Estritamente só de leitura: sem bloqueio, sem escrever no
512
+ diário nem na cache, e nunca se liga ao T3 Code (só lê o ficheiro de execução do T3).
513
+
514
+ Sai com 0, ou com 10 quando alguma coisa precisa de ti (para um script ou uma notificação saberem); 10 não é um erro.
515
+ 2 para um erro de uso.
516
+
517
+ Opções:
518
+ --json Escreve os mesmos dados num objeto JSON (sem cor; chaves em inglês):
519
+ version 2
520
+ ran false (e mais nada) quando o t3sm ainda não correu
521
+ level "ok" | "needs-you" | "working"
522
+ items [{ level: "needs-you"|"info", key, text, command }] (command pode ser null)
523
+ needsAttention { reason, detail, command, since, facts } ou null (como o último ciclo o registou)
524
+ waiting [{ project, title, modifiedAt, since }] projetos à espera por uso
525
+ heldRehome cópias à espera de uma pasta de destino no T3 Code
526
+ decisionsPending { <pergunta>: sessões à espera }
527
+ pendingImports { count, source: "sync" | "plan", at } ou null
528
+ lastSync { at, outcome, runId } ou null
529
+ nextSync { at, source: "watcher" } ou null
530
+ watcher { running, pid, version, stale } ou null
531
+ update { installed, available, failure, lastInstalled }
532
+ runInProgress { pid, startedAt } ou null
533
+ lastOrganize { runId, at, changes, reverted, rolledBackBy } ou null
534
+ plugin [{ account, state: installed|outdated|missing, version }] (os comandos /t3sm)
535
+ t3Code { running, version }
536
+ `,
537
+ scan: `Uso: t3sm scan [--json]
538
+
539
+ Conta as sessões desta máquina por agente e por conta. Não precisa do T3 Code a correr. Só escreve a cache de
540
+ descoberta do próprio t3sm (na pasta de estado); nunca um ficheiro de sessão.
541
+
542
+ Opções:
543
+ --json Escreve as sessões encontradas como uma lista JSON
544
+ `,
545
+ plan: `Uso: t3sm plan [--json] [--allow-untested]
546
+
547
+ Liga-se ao T3 Code em execução (só leitura), encontra as sessões e escreve o plano de importação em
548
+ <estado>/runs/<runId>/plan.md e plan.json. Também atualiza a cache de descoberta do t3sm e, na primeira vez, guarda as
549
+ contas detetadas em <estado>/config.json. O T3 Code e os ficheiros das sessões não mudam.
550
+
551
+ Opções:
552
+ --json Escreve o plano em JSON em vez do resumo
553
+ --allow-untested Sem aviso numa versão do T3 Code que o t3sm não testou (nunca bloqueia)
554
+ `,
555
+ help: `Uso: t3sm help [<tópico> | <comando>]
556
+
557
+ O que uma mensagem num ecrã do t3sm quer dizer, porque acontece e o que fazer, na tua língua. Sem tópico, lista-os; um
558
+ ecrã que mostra um problema diz qual é o tópico (\`t3sm help not-imported\`). \`t3sm help <comando>\` é o mesmo que
559
+ \`t3sm <comando> --help\`.
560
+
561
+ Exemplos:
562
+ t3sm help
563
+ t3sm help held
564
+ t3sm help apply
565
+ `,
566
+ };