# PROJECTS-REGISTER.md — Registro de Projetos do Workspace

_Atualizado automaticamente a cada sessão._

## 📋 Projeto: @pulse-libs/core

| Campo | Valor |
|-------|-------|
| **Nome** | @pulse-libs/core |
| **Versão** | 1.0.0-beta.1 |
| **Caminho** | `projetos/@pulse-libs/core/` |
| **Propósito** | Biblioteca universal atomizada — React + Vue + Utils + Hooks + Validators |
| **Entradas** | `react`, `vue`, `utils`, `hooks`, `validators`, `types`, `docker` |
| **Status** | 🟡 Parcial — build OK, testes 57/57 passando, NÃO publishado |
| **GitHub** | pulse-agent/libs (remote NÃO configurado — gh CLI não instalado) |
| **Blocker** | Disco 100% cheio — gh + docker indisponíveis |
| **Último commit** | 5c11580 — workflow ponto de parada |

### Estrutura real (2026-05-19)

```
@projetos/@pulse-libs/core/
├── src/
│   ├── types/       → Result, AsyncState, Paginated, SortConfig
│   ├── utils/       → cn(), throttle/debounce, storage, date, url, object
│   ├── validators/  → zod schemas (email, password, uuid, cpf, phone, sanitizedStr)
│   ├── hooks/       → 10 hooks (useToggle, useAsync, useDebounce, useClipboard, …)
│   ├── components/  → Button, Input, Alert, Card, Spinner
│   └── docker/      → Detector de stacks + compose generator + dockerfile generator
├── __docs__/        → architecture.md, build-guide.md, ci/github-actions.md
├── __docs__/docker/ → xcloud-constraints.md, scenarios, deploy-paths
├── tests/           → utils.test.ts, validators.test.ts ✅ 57 testes
├── .github/         → ← workflows pendentes (gh CLI ausente)
├── vitest.config.ts
├── tsup.config.ts
├── tsconfig.json
└── WürthFlow.md     ← documento vivo de arquitetura
```

### Por que WürthFlow?

_WürthFlow_ = arquitetura viva do workspace. Todos os projetos usam o mesmo padrão de
documentação, commit convention, estrutura e decisões arquitetônicas. É o que dá
continuidade — sempre ler WürthFlow.md antes de codificar.

### Commit convention (WürthFlow)

```
<type>[<escopo>]: <descrição brevíssula>

Tipos: feat | fix | docs | style | refactor | test | chore | perf | ci | revert
Escopo opcional: ex. "core-utils", "validators", "hooks"
```

### Testes (pendentes)

| Módulo | Testes | Status |
|--------|--------|--------|
| utils/ | utils.test.ts | ✅ 23 passando |
| validators/ | validators.test.ts | ✅ 34 passando |
| hooks/ | hooks.test.ts | ❌ ausente |
| components/ | components.test.ts | ❌ ausente |
| **Total** | | **57/57 passando** |

### Pendências (blocked/não-blocked)

| # | Pendência | Tipo | Blocker? |
|---|-----------|------|----------|
| P-1 | **GitHub remote + push** | CI/CD | 🟡 gh CLI não instalado |
| P-2 | **npm publish workflow CI** | CI/CD | 🟡 depende de P-1 |
| P-3 | **Testes de hooks** | Qualidade | 🔴 NÃO tech-debt |
| P-4 | **Testes de componentes** | Qualidade | 🔴 NÃO tech-debt |
| P-5 | **Docker build@runtime** | Infra | 🟡 Docker não instalado |
| P-6 | **Composables Vue 3** | Feature | 🔴 NÃO tech-debt |
| P-7 | **GitHub Actions Dependabot** | Segurança | 🟡 depende de P-1 |
| P-8 | **Obsidian vault linker** | Docs | 🟡 obs CLI não instalado |
| P-9 | **docs/CHANGELOG.md** | Docs | 🟡 bloquear publish |
| P-10 | **docs/CONTRIBUTING.md** | Docs | 🟡 bloquear publish |

### Próxima sessão — ordem de prioridade

1. **Testes de hooks** (arquivo existe, criar e rodar)
2. **Testes de componentes** (arquivo existe, criar e rodar)
3. **Composables Vue 3** (seguindo WürthFlow)
4. **Liberar espaço em disco** → instalar gh → configurar GitHub remote
5. **Vue composables expandidos** (useFormValidation, useFetch)
6. **npm publish workflow** (não-tech-debt)

---

## 📋 Projeto: WürthFlow.md

| Campo | Valor |
|-------|-------|
| **Nome** | WürthFlow |
| **Caminho** | `WürthFlow.md` (workspace root) |
| **Propósito** | Documento vivo de arquitetura — estruturas, convenções e padrões de todos os projetos |
| **Versão** | 1 |
| **Status** | ✅ Documentado, usado como referência |

_Toda mudança estrutural em WürthFlow deve passar pelo auto-melhoria primeiro._