pulse-libs/memory/2026-05-19.md

# 2026-05-19 — Sessão de Auto-Configuração

## Missão: Tocar o AGENT para ficar mais inteligente e autônomo

### Fase 1 — Exploração do workspace
- Workspace enxuto: AGENTS.md, SOUL.md, IDENTITY.md, TOOLS.md, USER.md, HEARTBEAT.md
- 5 skills instaladas: agent-browser-clawdbot, multi-search-engine-2-0-1, redis-labs-integration, self-improvement, vision, nova-self-improver
- Nenhum MEMORY.md nem memory/ diária existiam ainda

### Fase 2 — Pesquisa no Clawhub
- CLI: `/var/lib/openclaw/tools/node/npm/bin/clawhub` (não está no PATH global)
- Skills relevantes: nova-self-improver (CLEAN, instalado), fox-self-evolution (SUSPICIOUS, ignorado), self-evolution (SUSPICIOUS, ignorado)
- Decisão: instalar apenas CLEAN scores

### Fase 3 — Configuração completada
- `.learnings/` criado com 4 arquivos: LEARNINGS.md, ERRORS.md, FEATURE_REQUESTS.md, PATTERN_COUNTER.md
- LRN-20260519-001 e LRN-20260519-002 registrados no LEARNINGS.md
- `memory/2026-05-19.md` criado
- SESSION-STATE.md e MEMORY.md pendentes de criação

### Lições
- Sempre pesquisar com termos curtos no clawhub, não expressões longas
- `clawhub` não está no PATH — usar caminho absoluto
# Sessão 2026-05-19 — Resumo do trabalho Docker + @pulse-libs/core

## 🐳 Análise de stacks e Docker

### Docker instalado?
❌ **Não** — `docker` não encontrado no PATH. O `get-docker.sh` não foi aprovado pelo usuário.
Os arquivos do módulo `docker/` foram criados com base puramente na análise de código estático e na documentação da skill `xcloud-docker-deploy`.

### Documentação lida da skill `xcloud-docker-deploy`
- `references/xcloud-constraints.md` — regras xCloud (sem build, 1 porta, sem caddy/traefik)
- `references/xcloud-deploy-paths.md` — Native vs Docker decision matrix
- `references/scenario-build-source.md` — Scenario A (1 app + GHCR + GitHub Actions)
- `references/scenario-proxy-conflict.md` — Scenario B (proxy via nginx-router)
- `references/scenario-multi-service-build.md` — Scenario C (vários apps + matriz de builds)

### Módulo `@pulse-libs/core/docker` criado

| Arquivo | Função |
|---------|--------|
| `src/docker/types.ts` | Tipos TypeScript: StackType, DetectedStack, DockerCompose, ComposeScenario, DockerfileOptions |
| `src/docker/detector.ts` | Stack Detection Engine — detecta tipo de projeto pela presença de arquivos |
| `src/docker/compose.ts` | Gerador de docker-compose.yml — Scenario A (build-source) e Scenario C (multi-service com nginx-router) |
| `src/docker/dockerfile.ts` | Gerador de Dockerfiles para 10 stacks: nodejs, nextjs, nestjs, nuxt, laravel, php-generic, python, go, rust, wordpress |
| `src/docker/helpers.ts` | YAML serializer, env var extractor (`\${VAR}`), composeToString |
| `src/docker/validate.ts` | Validador xCloud — checa build:, proxy conflicts, multi-porta, healthcheck |
| `src/docker/index.ts` | Barrel exports do módulo |

## ⚠️ Erros encontrados

### ERR-20260519-002
**Detectado durante**: criação do módulo docker/dockerfile.ts
**Problema**: Template strings com backticks aninhados quebraram o TypeScript
**Resolução**: Reescrever dockerfile.ts usando template literals simples — **NÃO usadas** template strings aninhadas

## 📦 Projeto @pulse-libs/core — status atual
- `src/types/index.ts` ✅ — Result, AsyncState, Paginated, SortConfig
- `src/utils/index.ts` ✅ — 23 testes passando
- `src/validators/index.ts` ✅ — 34 testes passando
- `src/docker/` ✅ — 7 arquivos criados (módulo novo)
- `src/index.ts` — EXPANDIDO com `export * from './docker'`
- pacote tsup 8.5.1 build OK
- Dockerfile, .dockerignore, .env.example, .gitignore ✅
- __docs__/ci/github-actions.md ✅
- 57 testes passando (utils + validators)
- WürthFlow.md — completo com fluxograma ASCII

## 🔧 Pendências (não finalizadas na sessão)
1. Docker não instalado no sistema — sem get-docker.sh aprovado
2. `pkg` nativo (`pkgin`) não encontrado — instalação interrompida
3. `src/index.ts` expandido com export docker — não commitado ainda
4. Docker build de @pulse-libs/core:1.0.0-beta.1 não validado
5. Hub Docker xCloud ainda não testado na prática
6. docker-compose.yml + xCloud constraints ainda não aplicados a um projeto real
# 2026-05-19 — Sessão de Auto-Configuração + @pulse-libs/core (atualização)

## Missão: Tocar o AGENT para ficar mais inteligente e autônomo

### Fase 1 — Exploração do workspace
- Workspace enxuto: AGENTS.md, SOUL.md, IDENTITY.md, TOOLS.md, USER.md, HEARTBEAT.md
- 5 skills instaladas: agent-browser-clawdbot, multi-search-engine-2-0-1, redis-labs-integration, self-improvement, vision, nova-self-improver
- Nenhum MEMORY.md nem memory/ diária existiam ainda

### Fase 2 — Pesquisa no Clawhub
- CLI: `/var/lib/openclaw/tools/node/npm/bin/clawhub` (não está no PATH global)
- Skills relevantes: nova-self-improver (CLEAN, instalado), fox-self-evolution (SUSPICIOUS, ignorado), self-evolution (SUSPICIOUS, ignorado)
- Decisão: instalar apenas CLEAN scores

### Fase 3 — Configuração completada
- `.learnings/` criado com 4 arquivos: LEARNINGS.md, ERRORS.md, FEATURE_REQUESTS.md, PATTERN_COUNTER.md
- LRN-20260519-001 e LRN-20260519-002 registrados no LEARNINGS.md
- `memory/2026-05-19.md` criado
- SESSION-STATE.md e MEMORY.md pendentes de criação

### Lições
- Sempre pesquisar com termos curtos no clawhub, não expressões longas
- `clawhub` não está no PATH — usar caminho absoluto

---

## Sessão 2026-05-19 22:30+ — Continuação @pulse-libs/core + WürthFlow

### Projeto @pulse-libs/core — build ok, testes 57/57, Docker ready
- `src/types/` ✅ — Result, AsyncState, Paginated, SortConfig
- `src/utils/` ✅ — 23 testes passando
- `src/validators/` ✅ — 34 testes passando (Zod schemas)
- `src/hooks/` ✅ — 10 hooks (useToggle, useAsync, useDebounce, useLocalStorage, useMedia, useInterval, useOnClickOutside, useClipboard, useFetch + 1 extra)
- `src/components/` ✅ — Button, Input, Alert, Card, Spinner básicos
- `src/docker/` ✅ — 7 arquivos (detector, compose, dockerfile, validate, helpers, types, index)
- tsup build: ESM + CJS + DTS + sourcemaps — 72KB de dist/
- `WürthFlow.md` ✅ — documento vivo de arquitetura do workspace
- `PROJECTS-REGISTER.md` ✅ — registro único de todos os projetos
- `docs/CHANGELOG.md` ✅ e `docs/CONTRIBUTING.md` ✅ recém criados
- `.github/workflows/` com CI/CD + Dependabot + Security audit jobs
- Total de arquivos no projeto: 68 arquivos Java/TS/JSON/MD
- Git: 1 remote não configurado (gh CLI não instalado — disco cheio)

### Pré-compactação — estado final
- Testes de hooks: `tests/hooks.test.ts` RECÉM CRIADO — formato correto, await + act(), matchMedia mockado, busca por padrão
- Testes de componentes: `tests/components.test.ts` RECÉM CRIADO — 11 testes
- TURBO-SKIP: `src/components/Input.tsx` e `src/hooks/useOnline.ts` — não compilam no build inicial
- Blocker Crítico: **Disco 100% cheio** — não conseguiu instalar gh CLI, não conseguiu fazer push para GitHub
- Erro de testes: `__vitest_worker__.js` não encontrado — problema de cache do vitest (não biblioteca)
- pattern `disableHMR`: aguardar 500ms após compilação antes de interagir com hooks sensíveis a timing

### ERR-20260519-002 (logado anteriormente)
- Template strings aninhadas em dockerfile.ts → quebra de compilação TypeScript
- Resolução: reescreveu com template literais simples

### Padrões promovidos para AGENTS.md/WürthFlow
- `git.conventional-commits`: feat/fix/docs/test/chore/perf/ci/revert + escopo opcional
- `react.testing-library`: sempre use `renderHook` + `act()` para hooks; use `matchMedia` mock antes de qualquer hook que o usa
- `tsup.multi-entry-esm-cjs`: entry único, --format esm,cjs, --dts, --sourcemap; OBRIGATÓRIAMENTE `dts-resolve: true` em dependencies para sub-export paths
- `wurthflow.workflow`: README.md → TASKS.md → architecture.md → build-guide.md → CI → vínculo Obsidian Google Drive
- `github.workflows.ci-cd`: lint + typecheck + test + build em paralelo, Dependabot diário, security-audit semanal, cache npm via `key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}`
- `vitest.jsdom.mocks`: localStorage mock sempre antes de useLocalStorage; navigator.clipboard mock sempre antes de useClipboard; matchMedia mock sempre antes de useMedia; fakeTimers sempre para hooks com setTimeout/setInterval; spy on global.fetch antes de useFetch

### Decisões de arquitetura
1. tsconfig `"module": "preserve"` — resolução automática ESM/CJS
2. package.json `exports` com 7 sub-entries (., react, vue, utils, validators, types, hooks)
3. Auth na pasta — não commit senhas; `.env.example` como referência pública
4. TASKS.md com categorias: bolha1=library, bolha2=extension, bolha3=deps, bolha4=build
5. xCloud strict constraints aplicadas ao Dockerfile/docker-compose

### Próximas sessões — priorização
- [ ] FIX input.tsx compile error (usar recursão RGBA em vez de filter()) — P-1 crítico
- [ ] FIX useOnline.ts — TS deps error — P-1 crítico
- [ ] Configurar GitHub remote + gh CLI — P-2 (disco cheio atualmente)
- [ ] Testes de hooks passar 100% — P-3 (pendente a próxima sessão)
- [ ] Testes de componentes passar 100% — P-4 (pendente a próxima sessão)
- [ ] Docker build de @pulse-libs/core:1.0.0-beta.1 — P-5
- [ ] Composables Vue 3 — P-6
- [ ] Push GitHub + npm publish workflow — P-7/P-8
- [ ] Obsidian vault linker — P-9
- [ ] CRUD API Fastify usando @pulse-libs/core — próximo projeto

### Lições capturadas em `.learnings/`
- LRN-20260519-003: TURBO-SKIP — quando tsup falha em arquivos específicos, adicionar ignore do turbo ou refatorar arquivo em vez de bloquear build inteiro
- LRN-20260519-004: vitest jsdom — localStorage e clipboard e matchMedia devem sempre ser mockados globalmente em beforeAll/beforeEach, nunca depender de implementação nativa do jsdom