oficio-pro 2.1.0 → 2.2.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.
package/README.md CHANGED
@@ -6,19 +6,25 @@ Instalador do **Ofício Pro** (assinatura da Codetrade) para o Claude Code.
6
6
  npx oficio-pro
7
7
  ```
8
8
 
9
- Ele confere a sua chave no servidor do Ofício Pro, instala o plugin pelo marketplace
10
- [`codetradeai/oficio-pro`](https://github.com/codetradeai/oficio-pro), salva a chave **só no seu computador**
9
+ Ele confere a sua chave no servidor do Ofício Pro, cria o catálogo do Ofício Pro em `~/.claude/oficio-pro/marketplace`,
10
+ instala o plugin (pacote npm [`oficio-pro-plugin`](https://www.npmjs.com/package/oficio-pro-plugin)), salva a chave **só no seu computador**
11
11
  (`~/.claude/settings.json`, permissão 600, com backup do arquivo anterior) e liga a atualização automática.
12
12
 
13
13
  | Comando | O que faz |
14
14
  |---|---|
15
15
  | `npx oficio-pro` | instala ou reinstala |
16
16
  | `npx oficio-pro status` | mostra plugin, atualização automática e assinatura |
17
- | `npx oficio-pro atualizar` | baixa a versão mais nova do plugin |
17
+ | `npx oficio-pro atualizar` | baixa a versão mais nova do plugin e migra instalações da 2.1 (que usavam o GitHub) |
18
18
  | `npx oficio-pro trocar-chave` | troca a chave salva |
19
19
  | `npx oficio-pro desinstalar` | remove o plugin e apaga a chave |
20
20
 
21
- Opções: `--chave-stdin` (lê a chave da entrada), `--marketplace <dono/repo ou pasta>`, `--sim`, `--ajuda`.
21
+ Opções: `--chave-stdin` (lê a chave da entrada), `--sim`, `--ajuda`. Só para testes: `--marketplace <pasta, dono/repo ou URL git>`.
22
+
23
+ **Instalou a 2.1?** Rode uma vez `npx oficio-pro@latest atualizar`: troca a origem do plugin sem pedir a chave de novo.
24
+
25
+ **Instalação:** o instalador cria um ID aleatório para este computador (`OFICIO_PRO_INSTALACAO`, no mesmo
26
+ `settings.json`), mantido ao reinstalar, atualizar ou trocar a chave. O plugin manda esse ID ao servidor, que limita
27
+ quantos computadores usam a mesma chave.
22
28
 
23
29
  **Segurança:** sem dependências; a chave só vai para `https://pro.codetrade.me` (nunca segue redirecionamento),
24
30
  nunca aparece na tela, em logs ou nos argumentos do `claude`.
package/lib/cli.js CHANGED
@@ -17,7 +17,7 @@ ${negrito("Ofício Pro · instalador")} ${VERSAO}
17
17
  Uso:
18
18
  npx oficio-pro instala (ou reinstala) o plugin e salva a sua chave
19
19
  npx oficio-pro status mostra o que está instalado e se a chave vale
20
- npx oficio-pro atualizar baixa a versão mais nova do plugin
20
+ npx oficio-pro atualizar baixa a versão mais nova do plugin (e migra instalações antigas)
21
21
  npx oficio-pro trocar-chave troca a chave salva por uma nova
22
22
  npx oficio-pro desinstalar remove o plugin e apaga a chave deste computador
23
23
 
@@ -25,7 +25,7 @@ Opções:
25
25
  --chave-stdin lê a chave da entrada. Ex.: macOS: pbpaste | npx oficio-pro --chave-stdin
26
26
  Linux: xclip -o | npx oficio-pro --chave-stdin · Windows (PowerShell): Get-Clipboard | npx oficio-pro --chave-stdin
27
27
  --chave <chave> passa a chave direto (fica no histórico do terminal: evite)
28
- --marketplace <x> origem do marketplace: dono/repo do GitHub ou pasta local (testes)
28
+ --marketplace <x> só para testes: outra origem do marketplace (pasta local, dono/repo ou URL git)
29
29
  --sim, -y responde "sim" às confirmações
30
30
  --ajuda, -h esta ajuda
31
31
  --versao, -v versão do instalador
package/lib/constantes.js CHANGED
@@ -1,9 +1,17 @@
1
1
  // Valores fixos do instalador do Ofício Pro.
2
- export const VERSAO = "2.1.0";
2
+ export const VERSAO = "2.2.0";
3
3
  export const SERVIDOR_PADRAO = "https://pro.codetrade.me";
4
- export const MARKETPLACE_PADRAO = "codetradeai/oficio-pro"; // repositório público no GitHub
4
+ // O plugin (magro) é publicado no npm com este nome. O Claude Code baixa e atualiza por aqui,
5
+ // sem depender de nenhum repositório no GitHub.
6
+ export const PACOTE_PLUGIN = "oficio-pro-plugin";
7
+ // Origem antiga (até a 2.1.x): marketplace no GitHub. Hoje o repositório é privado.
8
+ export const MARKETPLACE_ANTIGO = "codetradeai/oficio-pro";
5
9
  export const NOME_MARKETPLACE = "oficio-pro";
6
10
  export const NOME_PLUGIN = "oficio-pro";
7
11
  export const PLUGIN_ID = `${NOME_PLUGIN}@${NOME_MARKETPLACE}`;
8
12
  export const VAR_CHAVE = "OFICIO_PRO_CHAVE";
13
+ // ID aleatório desta instalação (não é segredo). O plugin manda no cabeçalho X-Oficio-Instalacao,
14
+ // e o servidor usa para o limite de computadores por chave.
15
+ export const VAR_INSTALACAO = "OFICIO_PRO_INSTALACAO";
16
+ export const CABECALHO_INSTALACAO = "x-oficio-instalacao";
9
17
  export const URL_REENVIO = `${SERVIDOR_PADRAO}/reenviar-chave`;
package/lib/fluxos.js CHANGED
@@ -5,11 +5,12 @@ import { homedir } from "node:os";
5
5
  import { isAbsolute, resolve } from "node:path";
6
6
  import { formatoValido, limparChave, mascarar } from "./chave.js";
7
7
  import { acharClaude, criarExecutor, lerJsonSaida } from "./claude.js";
8
- import { MARKETPLACE_PADRAO, NOME_MARKETPLACE, PLUGIN_ID, URL_REENVIO, VAR_CHAVE, VERSAO } from "./constantes.js";
8
+ import { MARKETPLACE_ANTIGO, NOME_MARKETPLACE, PACOTE_PLUGIN, PLUGIN_ID, URL_REENVIO, VAR_CHAVE, VERSAO } from "./constantes.js";
9
+ import { apagarMarketplace, pastaMarketplace, prepararMarketplace } from "./marketplace.js";
9
10
  import { statusAssinatura, urlServidor, validarChave } from "./servidor.js";
10
11
  import {
11
- apagarBackup, autoUpdateLigado, caminhoSettings, chaveSalva, comAutoUpdate, comChave, ErroSettings,
12
- lerSettings, permissaoAberta, salvarSettings, semChave,
12
+ apagarBackup, autoUpdateLigado, caminhoSettings, chaveSalva, comAutoUpdate, comChave, comInstalacao, ErroSettings,
13
+ instalacaoSalva, lerSettings, novoIdInstalacao, permissaoAberta, salvarSettings, semChave,
13
14
  } from "./settings.js";
14
15
  import { amarelo, cinza, negrito, verde, vermelho } from "./terminal.js";
15
16
 
@@ -17,9 +18,17 @@ export class ErroFluxo extends Error {
17
18
  constructor(msg, codigo = 1) { super(msg); this.codigo = codigo; }
18
19
  }
19
20
 
20
- /** De onde vem o marketplace: GitHub (padrão), URL git, ou pasta local (testes). */
21
- export function resolverOrigem(valor, { cwd = process.cwd(), home = homedir() } = {}) {
22
- const v = String(valor || MARKETPLACE_PADRAO).trim();
21
+ /**
22
+ * De onde vem o marketplace. Padrão (oficial): uma pasta local que o próprio instalador cria
23
+ * (~/.claude/oficio-pro/marketplace), com o catálogo apontando para o pacote npm do plugin.
24
+ * Para testes: dono/repo do GitHub, URL git ou outra pasta local.
25
+ */
26
+ export function resolverOrigem(valor, { cwd = process.cwd(), home = homedir(), env = process.env } = {}) {
27
+ if (!String(valor || "").trim()) {
28
+ const caminho = pastaMarketplace(env, home);
29
+ return { tipo: "oficial", arg: caminho, rotulo: `npm: ${PACOTE_PLUGIN}`, settings: { source: "directory", path: caminho } };
30
+ }
31
+ const v = String(valor).trim();
23
32
  const expandido = v.startsWith("~") ? home + v.slice(1) : v;
24
33
  const pareceCaminho = /^(\.{1,2}[\\/]|[\\/]|~|[a-zA-Z]:[\\/])/.test(v) || v === "." || v === "..";
25
34
  if (pareceCaminho || (isAbsolute(expandido) && existsSync(expandido))) {
@@ -34,7 +43,7 @@ export function resolverOrigem(valor, { cwd = process.cwd(), home = homedir() }
34
43
 
35
44
  function mesmaOrigem(entrada, origem) {
36
45
  if (!entrada) return false;
37
- if (origem.tipo === "local") return entrada.path === origem.arg || entrada.installLocation === origem.arg;
46
+ if (origem.tipo === "local" || origem.tipo === "oficial") return entrada.path === origem.arg || entrada.installLocation === origem.arg;
38
47
  if (origem.tipo === "github") return (entrada.repo || "").toLowerCase() === origem.arg.toLowerCase();
39
48
  return entrada.url === origem.arg;
40
49
  }
@@ -50,6 +59,20 @@ function contexto(d) {
50
59
  return { ...d, env, home, io, arquivo, caminhoClaude, claude, fetchOpc, opcoes: d.opcoes ?? {} };
51
60
  }
52
61
 
62
+ /**
63
+ * ID desta instalação: o salvo no settings.json (mantido em reinstalação, atualização e migração)
64
+ * ou um novo, aleatório. Vai no cabeçalho X-Oficio-Instalacao das conferências do instalador.
65
+ */
66
+ function idInstalacao(c) {
67
+ if (!c.instalacao) {
68
+ let salvo = "";
69
+ try { salvo = instalacaoSalva(lerSettings(c.arquivo)); } catch { /* settings quebrado: tratado em outro lugar */ }
70
+ c.instalacao = salvo || novoIdInstalacao();
71
+ }
72
+ c.fetchOpc.instalacao = c.instalacao;
73
+ return c.instalacao;
74
+ }
75
+
53
76
  function cabecalho(io, titulo) {
54
77
  io.escrever("");
55
78
  io.escrever(negrito(` ✦ Ofício Pro · ${titulo}`));
@@ -97,6 +120,7 @@ async function obterChave(c, { podeReusar }) {
97
120
  async function chaveConferida(c, { podeReusar }) {
98
121
  const { io } = c;
99
122
  const servidor = urlServidor(c.env); // falha cedo se OFICIO_PRO_SERVIDOR for inseguro
123
+ idInstalacao(c);
100
124
  if (servidor !== "https://pro.codetrade.me") io.escrever(amarelo(`⚠ Modo teste: servidor ${servidor}`));
101
125
  for (let tentativa = 1; tentativa <= 3; tentativa++) {
102
126
  const chave = await obterChave(c, { podeReusar: podeReusar && tentativa === 1 });
@@ -147,15 +171,25 @@ function passo(c, rotulo, args) {
147
171
  return true;
148
172
  }
149
173
 
174
+ const ehOrigemAntiga = (m) => (m?.repo || "").toLowerCase() === MARKETPLACE_ANTIGO.toLowerCase()
175
+ || /github\.com[/:]codetradeai\/oficio-pro(\.git)?$/i.test(m?.url || "");
176
+
150
177
  /** Marketplace + plugin pelo CLI. Devolve true se deu tudo certo. */
151
178
  async function instalarPlugin(c, origem) {
152
179
  const { io } = c;
180
+ if (origem.tipo === "oficial") prepararMarketplace({ env: c.env, home: c.home });
153
181
  const mkts = listarMarketplaces(c);
154
182
  const atual = mkts?.find((m) => m.name === NOME_MARKETPLACE);
155
183
  if (atual && !mesmaOrigem(atual, origem)) {
156
- io.escrever(amarelo(`⚠ Já existe um marketplace "${NOME_MARKETPLACE}" vindo de outro lugar (${atual.path || atual.repo || atual.url || atual.source}).`));
157
- io.escrever(" Vou trocar pela origem oficial. O plugin é reinstalado em seguida; a sua chave não muda.");
158
- if (!c.opcoes.sim && io.interativo && !(await io.confirmar("Pode trocar?"))) return false;
184
+ if (ehOrigemAntiga(atual) && origem.tipo === "oficial") {
185
+ // Migração da 2.1.x: o marketplace antigo vinha do GitHub, que não é mais usado.
186
+ io.escrever(amarelo("⚠ Esta instalação usa a origem antiga do plugin (GitHub), que não recebe mais atualizações."));
187
+ io.escrever(" Vou trocar pela origem nova. O plugin é reinstalado em seguida; a sua chave e os seus dados não mudam.");
188
+ } else {
189
+ io.escrever(amarelo(`⚠ Já existe um marketplace "${NOME_MARKETPLACE}" vindo de outro lugar (${atual.path || atual.repo || atual.url || atual.source}).`));
190
+ io.escrever(" Vou trocar pela origem oficial. O plugin é reinstalado em seguida; a sua chave não muda.");
191
+ if (!c.opcoes.sim && io.interativo && !(await io.confirmar("Pode trocar?"))) return false;
192
+ }
159
193
  if (!passo(c, "removendo o marketplace antigo", ["plugin", "marketplace", "remove", NOME_MARKETPLACE])) return false;
160
194
  }
161
195
  if (atual && mesmaOrigem(atual, origem)) {
@@ -177,14 +211,14 @@ function instrucoesManuais(io, origem) {
177
211
  io.escrever("");
178
212
  io.escrever(amarelo("Não consegui instalar o plugin sozinho. Faça à mão (leva 1 minuto):"));
179
213
  io.escrever(` 1. Abra o Terminal e digite ${negrito("claude")}`);
180
- io.escrever(` 2. Dentro do Claude Code, cole: ${negrito(`/plugin marketplace add ${origem.arg}`)}`);
214
+ io.escrever(` 2. Dentro do Claude Code, cole: ${negrito(`/plugin marketplace add ${/\s/.test(origem.arg) ? `"${origem.arg}"` : origem.arg}`)}`);
181
215
  io.escrever(` 3. Depois: ${negrito(`/plugin install ${PLUGIN_ID}`)}`);
182
216
  io.escrever(` 4. Em /plugin → Marketplaces → ${NOME_MARKETPLACE}, escolha "Enable auto-update".`);
183
217
  io.escrever(cinza(" A chave já ficou salva (se apareceu ✔ acima); não precisa colar de novo."));
184
218
  }
185
219
 
186
220
  function salvarComChave(c, chave, origem) {
187
- let s = comChave(lerSettings(c.arquivo), chave);
221
+ let s = comInstalacao(comChave(lerSettings(c.arquivo), chave), idInstalacao(c));
188
222
  if (origem !== undefined) s = comAutoUpdate(s, origem?.settings ?? null);
189
223
  const backup = salvarSettings(c.arquivo, s);
190
224
  c.io.escrever(verde(`✔ Chave salva só neste computador`) + cinza(` (${c.arquivo}, em "env" → ${VAR_CHAVE})`));
@@ -198,17 +232,22 @@ function finalizar(io) {
198
232
  io.escrever(` 1. Feche e abra o Claude Code (o que estiver aberto não vê a chave nova).`);
199
233
  io.escrever(` 2. Digite ${negrito("/mcp")}: o ${negrito("oficio-pro")} deve aparecer conectado.`);
200
234
  io.escrever(` 3. Teste: ${negrito("/oficio-pro:decidir aceito o emprego novo ou fico?")}`);
201
- io.escrever(cinza(" Ver depois: npx oficio-pro status · Trocar a chave: npx oficio-pro trocar-chave"));
235
+ io.escrever(cinza(" O plugin se atualiza sozinho. Ver depois: npx oficio-pro status · Trocar a chave: npx oficio-pro trocar-chave"));
202
236
  io.escrever("");
203
237
  }
204
238
 
239
+ function origemPedida(c) {
240
+ const origem = resolverOrigem(c.opcoes.marketplace || c.env.OFICIO_PRO_MARKETPLACE, { home: c.home, env: c.env });
241
+ if (origem.tipo !== "oficial") c.io.escrever(amarelo(`⚠ Marketplace de teste: ${origem.rotulo}`));
242
+ return origem;
243
+ }
244
+
205
245
  export async function instalar(d) {
206
246
  const c = contexto(d);
207
247
  cabecalho(c.io, "instalação");
208
248
  c.io.escrever("Olá! Vou deixar o Ofício Pro pronto no seu Claude Code em 3 passos: conferir a chave, instalar o plugin e salvar a chave.");
209
249
  c.io.escrever("");
210
- const origem = resolverOrigem(c.opcoes.marketplace || c.env.OFICIO_PRO_MARKETPLACE, { home: c.home });
211
- if (origem.tipo !== "github" || origem.arg !== MARKETPLACE_PADRAO) c.io.escrever(amarelo(`⚠ Marketplace de teste: ${origem.rotulo}`));
250
+ const origem = origemPedida(c);
212
251
  exigirClaude(c);
213
252
  lerSettings(c.arquivo); // se o settings.json estiver quebrado, para aqui, antes de qualquer coisa
214
253
  const chave = await chaveConferida(c, { podeReusar: true });
@@ -235,14 +274,21 @@ export async function trocarChave(d) {
235
274
  export async function atualizar(d) {
236
275
  const c = contexto(d);
237
276
  cabecalho(c.io, "atualizar");
277
+ const origem = origemPedida(c);
238
278
  exigirClaude(c);
239
- const ok1 = passo(c, "atualizando o marketplace", ["plugin", "marketplace", "update", NOME_MARKETPLACE]);
240
- const ok2 = ok1 && passo(c, "atualizando o plugin", ["plugin", "update", PLUGIN_ID]);
279
+ lerSettings(c.arquivo);
280
+ // Também migra quem instalou pela origem antiga (GitHub): não precisa colar a chave de novo.
281
+ const ok2 = await instalarPlugin(c, origem);
241
282
  const s = lerSettings(c.arquivo);
242
- if (!autoUpdateLigado(s) && s?.extraKnownMarketplaces?.[NOME_MARKETPLACE]) {
243
- salvarSettings(c.arquivo, comAutoUpdate(s, null));
283
+ if (!autoUpdateLigado(s) && (ok2 || s?.extraKnownMarketplaces?.[NOME_MARKETPLACE])) {
284
+ salvarSettings(c.arquivo, comAutoUpdate(s, origem.settings));
244
285
  c.io.escrever(verde("✔ Atualização automática ligada"));
245
286
  }
287
+ if (!instalacaoSalva(s) && chaveSalva(s)) {
288
+ salvarSettings(c.arquivo, comInstalacao(lerSettings(c.arquivo), idInstalacao(c)));
289
+ c.io.escrever(verde("✔ ID desta instalação criado (usado no limite de computadores por chave)"));
290
+ }
291
+ if (!chaveSalva(s)) c.io.escrever(amarelo("⚠ Não achei a chave salva neste computador. Rode: npx oficio-pro"));
246
292
  if (!ok2) {
247
293
  c.io.escrever(amarelo("Se o plugin não estiver instalado, rode: npx oficio-pro"));
248
294
  return 1;
@@ -279,7 +325,9 @@ export async function desinstalar(d) {
279
325
  }
280
326
  salvarSettings(c.arquivo, s);
281
327
  apagarBackup(c.arquivo); // o backup ainda teria a chave
328
+ apagarMarketplace({ env: c.env, home: c.home });
282
329
  c.io.escrever(verde("✔ Chave apagada deste computador"));
330
+ c.io.escrever(cinza(" O ID desta instalação fica no settings.json (não é segredo): se reinstalar aqui, não conta como computador novo."));
283
331
  c.io.escrever(ok ? verde("✔ Ofício Pro removido. Até breve!") : amarelo("⚠ Parte da remoção falhou; veja acima. A chave já foi apagada."));
284
332
  c.io.escrever(cinza(" Isto não cancela a assinatura. Para cancelar: consumer.hotmart.com"));
285
333
  return ok ? 0 : 1;
@@ -297,7 +345,9 @@ export async function status(d) {
297
345
  const p = listarPlugins(c)?.find((x) => x.id === PLUGIN_ID);
298
346
  io.escrever(p ? `${verde("✔")} Plugin: ${PLUGIN_ID} ${p.version ?? ""}${p.enabled === false ? amarelo(" (desligado)") : ""}` : `${vermelho("✘")} Plugin: não instalado (rode npx oficio-pro)`);
299
347
  const m = listarMarketplaces(c)?.find((x) => x.name === NOME_MARKETPLACE);
300
- io.escrever(m ? `${verde("✔")} Marketplace: ${m.repo || m.path || m.url || m.source}` : `${vermelho("✘")} Marketplace: não adicionado`);
348
+ if (m && ehOrigemAntiga(m)) io.escrever(`${amarelo("⚠")} Marketplace: origem antiga (GitHub), sem atualizações. Rode: npx oficio-pro@latest atualizar`);
349
+ else if (m && mesmaOrigem(m, resolverOrigem("", { home: c.home, env: c.env }))) io.escrever(`${verde("✔")} Marketplace: oficial (npm: ${PACOTE_PLUGIN})`);
350
+ else io.escrever(m ? `${verde("✔")} Marketplace: ${m.repo || m.path || m.url || m.source}` : `${vermelho("✘")} Marketplace: não adicionado (rode npx oficio-pro)`);
301
351
  } else {
302
352
  io.escrever(`${vermelho("✘")} Claude Code: não encontrado`);
303
353
  }
@@ -309,6 +359,9 @@ export async function status(d) {
309
359
  }
310
360
  io.escrever(`${verde("✔")} Chave: ${mascarar(chave)} (em ${c.arquivo})`);
311
361
  if (permissaoAberta(c.arquivo)) io.escrever(amarelo(`⚠ Outras contas deste computador podem ler o arquivo. Rode: chmod 600 "${c.arquivo}"`));
362
+ const inst = instalacaoSalva(s);
363
+ if (inst) { c.instalacao = inst; c.fetchOpc.instalacao = inst; }
364
+ io.escrever(inst ? `${verde("✔")} Instalação: ${inst.slice(0, 9)}…` : `${amarelo("•")} Instalação: sem ID (rode npx oficio-pro@latest atualizar)`);
312
365
  const r = await validarChave(chave, c.fetchOpc);
313
366
  if (r.estado === "valida") {
314
367
  const t = await statusAssinatura(chave, c.fetchOpc);
@@ -0,0 +1,48 @@
1
+ // Marketplace local do Ofício Pro: uma pasta no computador da pessoa com só o catálogo
2
+ // (.claude-plugin/marketplace.json). O plugin em si vem do npm (pacote oficio-pro-plugin),
3
+ // então o Claude Code baixa e atualiza sozinho, sem GitHub e sem chave nenhuma no catálogo.
4
+ import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
5
+ import { join } from "node:path";
6
+ import { NOME_MARKETPLACE, NOME_PLUGIN, PACOTE_PLUGIN } from "./constantes.js";
7
+ import { pastaClaude } from "./settings.js";
8
+
9
+ /** Pasta do marketplace local: ~/.claude/oficio-pro/marketplace (ou dentro de $CLAUDE_CONFIG_DIR). */
10
+ export const pastaMarketplace = (env, home) => join(pastaClaude(env, home), "oficio-pro", "marketplace");
11
+
12
+ /** O catálogo: um plugin, vindo do npm, sempre na versão "latest". */
13
+ export function catalogo() {
14
+ const source = { source: "npm", package: PACOTE_PLUGIN };
15
+ return {
16
+ name: NOME_MARKETPLACE,
17
+ owner: { name: "Codetrade / C&T.AI", email: "contato@codetrade.me" },
18
+ description: "Ofício Pro (assinatura) da Codetrade. Plugin magro; o conteúdo vem de https://pro.codetrade.me com a chave do assinante.",
19
+ plugins: [
20
+ {
21
+ name: NOME_PLUGIN,
22
+ source,
23
+ description: "Ofício Pro (assinatura): skills, agentes e comandos em português. Precisa da chave OFICIO_PRO_CHAVE.",
24
+ author: { name: "Codetrade / C&T.AI", email: "contato@codetrade.me" },
25
+ homepage: "https://oficio.codetrade.me/",
26
+ category: "productivity",
27
+ },
28
+ ],
29
+ };
30
+ }
31
+
32
+ /** Grava (ou regrava) o catálogo. Devolve a pasta. Só escreve se mudou. */
33
+ export function prepararMarketplace({ env = process.env, home } = {}) {
34
+ const pasta = pastaMarketplace(env, home);
35
+ const dir = join(pasta, ".claude-plugin");
36
+ const arquivo = join(dir, "marketplace.json");
37
+ const texto = `${JSON.stringify(catalogo(), null, 2)}\n`;
38
+ if (existsSync(arquivo) && readFileSync(arquivo, "utf8") === texto) return pasta;
39
+ mkdirSync(dir, { recursive: true });
40
+ const tmp = `${arquivo}.tmp-${process.pid}`;
41
+ writeFileSync(tmp, texto);
42
+ try { renameSync(tmp, arquivo); } catch (e) { rmSync(tmp, { force: true }); throw e; }
43
+ return pasta;
44
+ }
45
+
46
+ export function apagarMarketplace({ env = process.env, home } = {}) {
47
+ rmSync(join(pastaClaude(env, home), "oficio-pro"), { recursive: true, force: true });
48
+ }
package/lib/servidor.js CHANGED
@@ -1,6 +1,6 @@
1
1
  // Conversa com o servidor do Ofício Pro. A chave só vai para https://pro.codetrade.me
2
2
  // (ou para localhost, em testes com OFICIO_PRO_SERVIDOR). Nunca segue redirecionamento.
3
- import { SERVIDOR_PADRAO, VERSAO } from "./constantes.js";
3
+ import { CABECALHO_INSTALACAO, SERVIDOR_PADRAO, VERSAO } from "./constantes.js";
4
4
 
5
5
  /** Endereço do servidor. Só aceita o oficial (HTTPS) ou localhost (testes). */
6
6
  export function urlServidor(env = process.env) {
@@ -18,7 +18,7 @@ const INIT = {
18
18
  params: { protocolVersion: "2025-06-18", capabilities: {}, clientInfo: { name: "oficio-pro-instalador", version: VERSAO } },
19
19
  };
20
20
 
21
- async function postarMcp(chave, corpo, { fetch = globalThis.fetch, env = process.env, timeoutMs = 15000 } = {}) {
21
+ async function postarMcp(chave, corpo, { fetch = globalThis.fetch, env = process.env, timeoutMs = 15000, instalacao = null } = {}) {
22
22
  const url = `${urlServidor(env)}/mcp`;
23
23
  const ctrl = new AbortController();
24
24
  const t = setTimeout(() => ctrl.abort(), timeoutMs);
@@ -32,6 +32,7 @@ async function postarMcp(chave, corpo, { fetch = globalThis.fetch, env = process
32
32
  "content-type": "application/json",
33
33
  accept: "application/json, text/event-stream",
34
34
  "user-agent": `oficio-pro-instalador/${VERSAO}`,
35
+ ...(instalacao ? { [CABECALHO_INSTALACAO]: instalacao } : {}),
35
36
  },
36
37
  body: JSON.stringify(corpo),
37
38
  });
package/lib/settings.js CHANGED
@@ -1,10 +1,11 @@
1
1
  // Leitura e escrita segura do ~/.claude/settings.json (ou $CLAUDE_CONFIG_DIR/settings.json).
2
2
  // Regras: nunca sobrescreve um arquivo que não é JSON válido; faz backup (600) antes de mudar;
3
3
  // grava num arquivo temporário (600) e troca de uma vez (rename), para não deixar o arquivo pela metade.
4
+ import { randomBytes } from "node:crypto";
4
5
  import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
5
6
  import { homedir } from "node:os";
6
7
  import { dirname, join } from "node:path";
7
- import { NOME_MARKETPLACE, VAR_CHAVE } from "./constantes.js";
8
+ import { NOME_MARKETPLACE, VAR_CHAVE, VAR_INSTALACAO } from "./constantes.js";
8
9
 
9
10
  export class ErroSettings extends Error {}
10
11
 
@@ -47,6 +48,26 @@ export function semChave(settings) {
47
48
  return s;
48
49
  }
49
50
 
51
+ /** Formato aceito pelo servidor: ^[A-Za-z0-9_-]{8,64}$. */
52
+ export const idInstalacaoValido = (v) => typeof v === "string" && /^[A-Za-z0-9_-]{8,64}$/.test(v);
53
+
54
+ /** ID novo: "inst_" + 24 caracteres aleatórios (144 bits). */
55
+ export const novoIdInstalacao = () => `inst_${randomBytes(18).toString("base64url")}`;
56
+
57
+ export const instalacaoSalva = (settings) => {
58
+ const v = ehObjeto(settings?.env) ? settings.env[VAR_INSTALACAO] : "";
59
+ return idInstalacaoValido(v) ? v : "";
60
+ };
61
+
62
+ /** Guarda o ID da instalação em env.OFICIO_PRO_INSTALACAO (junto da chave), sem tocar no resto. */
63
+ export function comInstalacao(settings, id) {
64
+ if (!idInstalacaoValido(id)) throw new ErroSettings("ID de instalação inválido.");
65
+ const s = structuredClone(settings);
66
+ if (s.env !== undefined && !ehObjeto(s.env)) throw new ErroSettings('O campo "env" do settings.json não é um objeto. Corrija à mão e rode de novo.');
67
+ s.env = { ...(s.env ?? {}), [VAR_INSTALACAO]: id };
68
+ return s;
69
+ }
70
+
50
71
  export const chaveSalva = (settings) => (ehObjeto(settings.env) && typeof settings.env[VAR_CHAVE] === "string" ? settings.env[VAR_CHAVE] : "");
51
72
 
52
73
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oficio-pro",
3
- "version": "2.1.0",
3
+ "version": "2.2.0",
4
4
  "description": "Instalador do Ofício Pro (assinatura) da Codetrade para o Claude Code: confere a sua chave, instala o plugin e deixa tudo pronto.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -26,12 +26,7 @@
26
26
  "codetrade"
27
27
  ],
28
28
  "author": "Codetrade / C&T.AI <contato@codetrade.me> (https://codetrade.me)",
29
- "homepage": "https://github.com/codetradeai/oficio-pro#readme",
30
- "repository": {
31
- "type": "git",
32
- "url": "git+https://github.com/codetradeai/oficio-pro.git",
33
- "directory": "installer"
34
- },
29
+ "homepage": "https://oficio.codetrade.me/",
35
30
  "bugs": {
36
31
  "email": "contato@codetrade.me"
37
32
  },