pulse-memory/MEMORY.md

MEMORY.md — Memória Curada

🧠 Agente OpenClaw

• Debian 12 container, /root/.openclaw/workspace/
• Projeto ativo: @pulse-libs/core — 136/136 testes ✅
• Stack: React/Vue, TS strict, Vitest, Pino/Zod, tsup v8, Docker multi-stage

⚙️ Infra

• Disco 76% (↑ de 66%), 87G total — monitorar (tendência de alta)
• Sem systemd no container
• Gitea: git.octal.tec.br → localhost:3000 (Caddy proxy) — Docker Swarm stack git
• User: Roberto (betotn91@gmail.com), SSH key em ~/.ssh/id_ed25519_gitea
• Repos Gitea: pulse-memory, pulse-skills, pulse-docs, pulse-projects — clonados via HTTPS

🐳 Docker Swarm — Stack Real (inventariado 2026-05-20)

• Node: s1 · ID x3fm004yzn3j7pvhz0fuuskez (Leader) · Docker 29.4.3
• Cluster ID: plz2xbh64yzhgy88jb9stm0pc
• 22 containers · 22 imagens · 9 stacks
• Stacks: bot, code, database, design, dock, git, pro, projects, proxy
• Portainer CE v2.19.4 — https://dock.octal.tec.br — stack dock
• Admin portainer token: ptr_ZE3R0WgRB07W7moQ7rpX135MqZ+F8OMuYC9U7Rqa5dU=

Domínios / Rotas Caddy (confirmados)

Domínio	Stack	Service	Porta
dock.octal.tec.br	dock	dock_portainer	9443/9000
git.octal.tec.br	git	git_gitea	3000
ai.octal.tec.br	bot	bot_beebot	18789
manager.octal.tec.br	pro	pro_leantime	8080
games.octal.tec.br	projects	projects_games-demo	80
test.octal.tec.br	proxy	proxy_test-octal	—

Serviços por Stack

Stack	#svc	Serviços ativos
bot	2	✅ beebot (node:24), ✅ redis:7-alpine
code	1	✅ 8dcode
database	2	✅ mongo:8.0, ✅ mongo-express
design	7	✅ Penpot 2.15.3 (backend+frontend+postgres+valkey+exporter+mcp+mailcatch)
dock	2	✅ portainer-ce:2.19.4, ✅ agent:2.19.4
git	1	✅ gitea:latest
pro	2	✅ leantime, ✅ mariadb:10.6
projects	3	✅ games-demo, ✅ projects-landing, ⚠️ pulse-libs 0/1 (down)
proxy	2	✅ caddy-docker-proxy, ✅ test-octal

Redes Overlay

Rede	Subnet	GW	Containers
ingress	10.0.0.0/24	10.0.0.1	3
public	10.0.1.0/24	10.0.1.1	14
dbn	10.0.2.0/24	10.0.2.1	2
mongo-cluster	10.0.3.0/24	10.0.3.1	3
pro_leantime_net	10.0.4.0/24	10.0.4.1	3
design_internal	10.0.5.0/24	10.0.5.1	8
proxy_proxy-net	10.0.6.0/24	10.0.6.1	0

Docs externas coletadas

• Portainer: https://docs.portainer.io/user/docker/stacks.md
• Portainer add stack: https://docs.portainer.io/user/docker/stacks/add.md
• Portainer edit stack: https://docs.portainer.io/user/docker/stacks/edit.md
• Portainer full corpus: https://docs.portainer.io/llms-full.txt (truncado às 6k chars)
• Armazenadas em pulse-docs/docs/

🔑 Lições High-Signal

• flat(Infinity) quebra tsup DTS — usar flat(2)
• process.env direto quebra SSR — typeof window !== 'undefined'
• Backticks aninhadas em TS → usar .replace() por fora
• Zod: .transform(v => v.replace(...)) não .replace() direto
• vi.useFakeTimers() não usar globalmente (quebra outros hooks)
• fireEvent.change jsdom: value precisa writable via Object.defineProperty
• getByRole('textbox') não funciona no jsdom puro — usar container.querySelector
• Portainer API token ptr_... prefixo PTR — funciona para UI, não para endpoint /api/endpoints (401) → Senha admin necessário para login via POST /api/auth — não documentada em pulse-memory

Decisões Recentes

• react.testing-library e vitest.jsdom.mocks promoted → AGENTS.md (count≥3)
• tsup.flat2-not-flatinfinity pattern criada
• Docker Swarm proxy modelo replicado na stack proxy
• Dominio live: https://test.octal.tec.br (Caddy + Let's Encrypt)
• Domínios mapeados via labels Caddy: 6 confirmados (dock/git/ai/manager/games/test)
• pulse-memory clonado via HTTPS (credenciais fornecidas pelo usuário)