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

Testes de hooks (arquivo existe, criar e rodar)
Testes de componentes (arquivo existe, criar e rodar)
Composables Vue 3 (seguindo WürthFlow)
Liberar espaço em disco → instalar gh → configurar GitHub remote
Vue composables expandidos (useFormValidation, useFetch)
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.

4.1 KiB Executable File Raw Blame History