@precisa-saude/cli 1.0.3 → 1.1.0

package/dist/templates/governance/CONTRIBUTING.md

@@ -1,8 +1,8 @@
-# Contributing
+# Contribuindo
 
-Thanks for considering a contribution to `{{REPO_NAME}}`.
+Obrigado por considerar contribuir com `{{REPO_NAME}}`.
 
-## Development
+## Desenvolvimento
 
 ```bash
 pnpm install
@@ -12,21 +12,21 @@ pnpm -r test
 pnpm -r lint
 ```
 
-Node {{NODE_VERSION}}+ and pnpm {{PNPM_VERSION}}+ are required (see `.nvmrc` and the `packageManager` field).
+Node {{NODE_VERSION}}+ e pnpm {{PNPM_VERSION}}+ são obrigatórios (veja `.nvmrc` e o campo `packageManager`).
 
-## Workflow
+## Fluxo
 
-1. Fork (or branch) from `main`
-2. Open a PR — direct pushes to `main` are not allowed
-3. CI must be green
-4. A reviewer approves and merges via GitHub
+1. Faça fork (ou branch) a partir de `main`
+2. Abra um PR — pushes diretos para `main` não são permitidos
+3. CI precisa estar verde
+4. Um revisor aprova e mescla via GitHub
 
-Commits follow [Conventional Commits](https://www.conventionalcommits.org). Allowed scopes for this repo are configured in `.commitlintrc.cjs`.
+Commits seguem [Conventional Commits](https://www.conventionalcommits.org). Os escopos válidos para este repo estão configurados em `.commitlintrc.cjs`. Mensagens de commit em pt-BR (descrição); o `tipo` (`feat`, `fix`, etc.) permanece em inglês por convenção universal.
 
-## Dependency changes
+## Mudanças de dependências
 
-Ask before adding runtime or peer dependencies. In the PR description explain: what the package does, why it's needed, and whether an existing dependency could serve the purpose.
+Pergunte antes de adicionar dependências runtime ou peer. Na descrição do PR explique: o que o pacote faz, por que é necessário e se uma dependência existente poderia atender ao propósito.
 
-## Signing
+## Assinatura
 
-All commits should be GPG-signed. The `commit-msg` hook blocks AI-attribution footers (`Co-Authored-By: Claude` and similar).
+Todos os commits devem ser assinados via GPG. O hook `commit-msg` bloqueia atribuições de IA (`Co-Authored-By: Claude` e similares).

package/dist/templates/governance/CONVENTIONS.md

@@ -1,37 +1,39 @@
-# Conventions
+# Convenções
 
-## Commit format
+## Formato de commit
 
 [Conventional Commits](https://www.conventionalcommits.org):
 
 ```
-type(scope): short description
+tipo(escopo): descrição curta
 
-optional longer body
+corpo opcional mais longo
 
-BREAKING CHANGE: notes (optional)
+BREAKING CHANGE: notas (opcional)
 ```
 
-**Types**: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`, `build`, `ci`, `revert`
+**Tipos**: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`, `build`, `ci`, `revert`
 
-**Scopes**: declared in `.commitlintrc.cjs`.
+**Escopos**: declarados em `.commitlintrc.cjs`.
 
-**AI attribution**: Do not include `Co-Authored-By: Claude`, `Generated with Claude`, or similar lines. The `commit-msg` hook enforces this.
+**Idioma**: a descrição do commit é escrita em pt-BR; o tipo permanece em inglês (convenção universal do Conventional Commits).
 
-## Code style
+**Atribuição de IA**: não inclua linhas como `Co-Authored-By: Claude`, `Generated with Claude` ou similares. O hook `commit-msg` bloqueia esses padrões.
+
+## Estilo de código
 
 - TypeScript strict mode, `noUncheckedIndexedAccess`
-- ESM modules
-- Prettier-enforced formatting (100 char width, single quotes, semicolons, trailing commas — via `@precisa-saude/prettier-config`)
-- ESLint rules via `@precisa-saude/eslint-config`
-- Imports sorted by `eslint-plugin-simple-import-sort`
-- Interfaces, objects, and JSX props sorted by `eslint-plugin-perfectionist` where applicable
+- Módulos ESM
+- Formatação aplicada via Prettier (100 chars de largura, aspas simples, ponto-e-vírgula, trailing commas — via `@precisa-saude/prettier-config`)
+- Regras ESLint via `@precisa-saude/eslint-config`
+- Imports ordenados por `eslint-plugin-simple-import-sort`
+- Interfaces, objetos e props JSX ordenados por `eslint-plugin-perfectionist` quando aplicável
 
-## Tests
+## Testes
 
-Vitest with an 80% coverage floor (configured per-repo in `vitest.config.ts`).
+Vitest com piso de 80% de cobertura (configurado por repo em `vitest.config.ts`).
 
-## Dependency rules
+## Regras de dependências
 
-- Core/SDK packages avoid runtime dependencies when feasible
-- External dependencies require explicit approval in the PR
+- Pacotes core/SDK evitam dependências runtime quando viável
+- Dependências externas requerem aprovação explícita no PR

package/dist/templates/governance/SECURITY.md

@@ -1,22 +1,22 @@
-# Security Policy
+# Política de Segurança
 
-## Reporting a Vulnerability
+## Reportar uma Vulnerabilidade
 
-If you discover a security vulnerability in this project, please report it responsibly.
+Se você descobrir uma vulnerabilidade de segurança neste projeto, por favor reporte de forma responsável.
 
-**Do not open a public GitHub issue.**
+**Não abra uma issue pública no GitHub.**
 
-Email: **{{SECURITY_EMAIL}}**
+Envie um e-mail para: **{{SECURITY_EMAIL}}**
 
-Include:
+Inclua:
 
-- Description of the vulnerability
-- Steps to reproduce
-- Potential impact
-- Suggested fix (if any)
+- Descrição da vulnerabilidade
+- Passos para reproduzir
+- Impacto potencial
+- Correção sugerida (se houver)
 
-We will acknowledge receipt within 48 hours and provide a timeline for resolution.
+Confirmaremos o recebimento em até 48 horas e forneceremos um cronograma para resolução.
 
-## Disclosure
+## Divulgação
 
-Disclosure is coordinated privately. Fixes are released in the affected package(s) and noted in the CHANGELOG.
+A divulgação é coordenada de forma privada. Correções são lançadas no(s) pacote(s) afetado(s) e registradas no CHANGELOG.

package/dist/templates/governance/SUPPORT.md

@@ -1,14 +1,14 @@
-# Support
+# Suporte
 
-## Getting help
+## Como obter ajuda
 
-- **Report bugs**: [GitHub Issues](https://github.com/{{REPO_SLUG}}/issues)
-- **Request features**: [GitHub Issues](https://github.com/{{REPO_SLUG}}/issues)
-- **Questions and discussions**: [GitHub Discussions](https://github.com/{{REPO_SLUG}}/discussions)
+- **Reportar bugs**: [GitHub Issues](https://github.com/{{REPO_SLUG}}/issues)
+- **Solicitar features**: [GitHub Issues](https://github.com/{{REPO_SLUG}}/issues)
+- **Perguntas e discussões**: [GitHub Discussions](https://github.com/{{REPO_SLUG}}/discussions)
 
-## Before opening an issue
+## Antes de abrir uma issue
 
-1. Search existing issues to avoid duplicates
-2. Include a minimal reproducible example
-3. Specify the package and version
-4. Include Node/pnpm versions and the OS you're on
+1. Pesquise issues existentes para evitar duplicatas
+2. Inclua um exemplo mínimo reproduzível
+3. Especifique o pacote e a versão
+4. Inclua versões de Node/pnpm e o sistema operacional

package/dist/templates/husky/commit-msg

@@ -1,8 +1,10 @@
 pnpm exec commitlint --edit "$1"
 
 # Block AI attribution lines in commit messages
-if grep -q -i -E "co-authored-by:.*claude|generated with.*claude|co-authored-by:.*anthropic|co-authored-by:.*gpt|co-authored-by:.*copilot" "$1"; then
+AI_ATTRIBUTION_PATTERN='co-authored-by:.*claude|generated with.*claude|co-authored-by:.*anthropic|co-authored-by:.*gpt|co-authored-by:.*copilot'
+
+if grep -q -i -E "$AI_ATTRIBUTION_PATTERN" "$1"; then
   echo "❌ Commit message contains AI attribution. Remove these lines:"
-  grep -i -E "co-authored-by:.*claude|generated with.*claude|co-authored-by:.*anthropic|co-authored-by:.*gpt|co-authored-by:.*copilot" "$1"
+  grep -i -E "$AI_ATTRIBUTION_PATTERN" "$1"
   exit 1
 fi

package/dist/templates/husky/pre-commit

@@ -1 +1,11 @@
+#!/usr/bin/env sh
+# Staged-file formatting + full test suite.
+#
+# Running the full test suite on every commit is strict but cheap once
+# turbo's cache is warm (only affected packages rebuild). Catches
+# regressions before they hit PR review; the tradeoff is worth it.
+
+set -e
+
 pnpm exec lint-staged
+pnpm test

package/dist/templates/husky/pre-push

@@ -1,5 +1,10 @@
-# Full-checks hook. Runs the same gates as CI so a failing push is caught locally.
-# Per-repo coverage thresholds live in vitest config, not here.
+#!/usr/bin/env sh
+# Full-checks hook. Runs the same gates as CI so a failing push is
+# caught locally. Per-package coverage thresholds live in vitest config,
+# not here — this hook fails the push if any threshold fails.
+#
+# Uses `pnpm turbo run` when turbo is available (parallelism + caching);
+# falls back to `pnpm -r --parallel` for repos without turbo.
 
 set -e
 
@@ -9,13 +14,22 @@ pnpm install --frozen-lockfile --prefer-offline
 echo "→ prettier"
 pnpm format:check
 
-echo "→ eslint"
-pnpm -r lint
-
-echo "→ typescript"
-pnpm -r typecheck
-
-echo "→ tests"
-pnpm -r test
+if pnpm exec turbo --version >/dev/null 2>&1; then
+  echo "→ lint + typecheck + test + coverage (turbo)"
+  pnpm turbo run lint typecheck test test:coverage
+else
+  # Fallback without turbo. Lint runs in parallel (no cross-package
+  # output dependencies). Typecheck/test run topologically (pnpm -r
+  # default) because they may depend on .d.ts or dist/ from upstream
+  # packages.
+  echo "→ lint"
+  pnpm -r --parallel lint
+  echo "→ typecheck"
+  pnpm -r typecheck
+  echo "→ test"
+  pnpm -r test
+  echo "→ coverage"
+  pnpm -r test:coverage
+fi
 
 echo "✓ pre-push checks passed"

package/dist/templates/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "{{REPO_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "description": "",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/{{REPO_SLUG}}.git"
+  },
+  "license": "Apache-2.0",
+  "author": "Precisa Saúde",
+  "type": "module",
+  "scripts": {
+    "build": "turbo run build",
+    "clean": "turbo run clean",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "turbo run lint",
+    "prepare": "husky",
+    "release": "semantic-release",
+    "test": "turbo run test",
+    "test:coverage": "turbo run test:coverage",
+    "typecheck": "turbo run typecheck"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "prettier --write",
+      "eslint --fix --max-warnings 0 --no-warn-ignored"
+    ],
+    "*.{js,jsx,json,md,css,yml,yaml}": [
+      "prettier --write"
+    ]
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.5.0",
+    "@precisa-saude/agent-instructions": "^1.0.0",
+    "@precisa-saude/commitlint-config": "^1.0.0",
+    "@precisa-saude/eslint-config": "^1.0.0",
+    "@precisa-saude/prettier-config": "^1.0.0",
+    "@precisa-saude/tsconfig": "^1.0.0",
+    "@precisa-saude/worktree-cli": "^1.0.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^7.1.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.6",
+    "@types/node": "^22.10.0",
+    "@vitest/coverage-v8": "^2.1.8",
+    "conventional-changelog-conventionalcommits": "^9.3.1",
+    "eslint": "^10.1.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "prettier": "^3.4.2",
+    "prettier-plugin-packagejson": "^3.0.2",
+    "semantic-release": "^25.0.3",
+    "tsup": "^8.3.5",
+    "turbo": "^2.3.3",
+    "typescript": "~5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "packageManager": "pnpm@{{PNPM_VERSION}}",
+  "engines": {
+    "node": ">={{NODE_VERSION}}",
+    "pnpm": ">=9"
+  },
+  "worktree": {
+    "directoryPrefix": "{{REPO_NAME}}",
+    "portRegistry": "/tmp/{{REPO_NAME}}-worktree-ports.json",
+    "buildCommand": "pnpm turbo run build --filter=./packages/*",
+    "services": []
+  }
+}

package/dist/templates/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+packages:
+  - 'packages/*'
+  - 'site'

package/dist/templates/scripts/worktree.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Thin shim — the real implementation lives in @precisa-saude/worktree-cli.
+# Keep this path for muscle memory; invoke the CLI directly if you prefer:
+#   pnpm exec precisa-worktree <command> [args]
+exec pnpm exec precisa-worktree "$@"

package/dist/templates/templates.manifest.yml

@@ -2,6 +2,40 @@
 # See templates/README.md for schema and placeholder reference.
 
 templates:
+  # ─── Package manifest ─────────────────────────────────────────────────────
+  # The package.json is the single most critical bootstrap file — without
+  # it, `pnpm install` fails and nothing else works.
+  - source: package.json
+    target: package.json
+    required_when: always
+    merge_strategy: skip_if_exists
+
+  - source: pnpm-workspace.yaml
+    target: pnpm-workspace.yaml
+    required_when: always
+    merge_strategy: skip_if_exists
+
+  - source: turbo.json
+    target: turbo.json
+    required_when: always
+    merge_strategy: overwrite
+
+  # ─── TypeScript / ESLint / Prettier / Commitlint configs ──────────────────
+  - source: tsconfig.json
+    target: tsconfig.json
+    required_when: always
+    merge_strategy: overwrite
+
+  - source: eslint.config.js
+    target: eslint.config.js
+    required_when: always
+    merge_strategy: overwrite
+
+  - source: commitlintrc.cjs
+    target: .commitlintrc.cjs
+    required_when: always
+    merge_strategy: overwrite
+
   # ─── Root dotfiles ────────────────────────────────────────────────────────
   - source: dotfiles/editorconfig
     target: .editorconfig
@@ -57,6 +91,56 @@ templates:
     merge_strategy: overwrite
     executable: true
 
+  # ─── Agent instructions ───────────────────────────────────────────────────
+  # AGENTS.md is the repo-specific addendum; the shared base lives in
+  # the @precisa-saude/agent-instructions npm package and is loaded via
+  # CLAUDE.md's @-imports at agent startup.
+  - source: AGENTS.md
+    target: AGENTS.md
+    required_when: always
+    merge_strategy: skip_if_exists
+
+  - source: CLAUDE.md
+    target: CLAUDE.md
+    required_when: always
+    merge_strategy: overwrite
+
+  # ─── Scripts ──────────────────────────────────────────────────────────────
+  - source: scripts/worktree.sh
+    target: scripts/worktree.sh
+    required_when: always
+    merge_strategy: overwrite
+    executable: true
+
+  # ─── Claude Code sub-agents ───────────────────────────────────────────────
+  # Generic agents extracted from platform's .claude/agents/. Repo-specific
+  # agents (iOS QA, UI polish, perf audit for web) stay in the consumer
+  # repo's own .claude/agents/ and are NOT synced by precisa sync.
+  - source: .claude/agents/debugger.md
+    target: .claude/agents/debugger.md
+    required_when: always
+    merge_strategy: overwrite
+
+  - source: .claude/agents/docs-sync.md
+    target: .claude/agents/docs-sync.md
+    required_when: always
+    merge_strategy: overwrite
+
+  - source: .claude/agents/pr-review-responder.md
+    target: .claude/agents/pr-review-responder.md
+    required_when: always
+    merge_strategy: overwrite
+
+  - source: .claude/agents/pre-commit-check.md
+    target: .claude/agents/pre-commit-check.md
+    required_when: always
+    merge_strategy: overwrite
+
+  - source: .claude/agents/refactor-scout.md
+    target: .claude/agents/refactor-scout.md
+    required_when: always
+    merge_strategy: overwrite
+
   # ─── Governance ───────────────────────────────────────────────────────────
   - source: governance/CODE_OF_CONDUCT.md
     target: CODE_OF_CONDUCT.md
@@ -94,13 +178,13 @@ templates:
     required_when: always
     merge_strategy: overwrite
 
-  - source: github/ISSUE_TEMPLATE/bug.md
-    target: .github/ISSUE_TEMPLATE/bug.md
+  - source: github/ISSUE_TEMPLATE/bug_report.md
+    target: .github/ISSUE_TEMPLATE/bug_report.md
     required_when: always
     merge_strategy: overwrite
 
-  - source: github/ISSUE_TEMPLATE/feature.md
-    target: .github/ISSUE_TEMPLATE/feature.md
+  - source: github/ISSUE_TEMPLATE/feature_request.md
+    target: .github/ISSUE_TEMPLATE/feature_request.md
     required_when: always
     merge_strategy: overwrite
 
@@ -109,17 +193,53 @@ templates:
     required_when: always
     merge_strategy: overwrite
 
+  # ─── Workflows (canonical split pattern) ──────────────────────────────────
+  # Orchestrator + reusable workflows. Each reusable is `workflow_call`-only;
+  # the orchestrator (`ci.yml`) wires them together.
   - source: github/workflows/ci.yml
     target: .github/workflows/ci.yml
     required_when: always
     merge_strategy: overwrite
 
-  - source: github/workflows/release.yml
-    target: .github/workflows/release.yml
-    required_when: publishes_to_npm
+  - source: github/workflows/_checks.yml
+    target: .github/workflows/_checks.yml
+    required_when: always
     merge_strategy: overwrite
 
   - source: github/workflows/review.yml
     target: .github/workflows/review.yml
     required_when: always
     merge_strategy: overwrite
+
+  - source: github/workflows/_release.yml
+    target: .github/workflows/_release.yml
+    required_when: publishes_to_npm
+    merge_strategy: overwrite
+
+  - source: github/workflows/_publish.yml
+    target: .github/workflows/_publish.yml
+    required_when: publishes_to_npm
+    merge_strategy: overwrite
+
+  - source: github/workflows/publish-tag.yml
+    target: .github/workflows/publish-tag.yml
+    required_when: publishes_to_npm
+    merge_strategy: overwrite
+
+  - source: github/workflows/_deploy-site.yml
+    target: .github/workflows/_deploy-site.yml
+    required_when: has_site
+    merge_strategy: overwrite
+
+  - source: github/workflows/doctor.yml
+    target: .github/workflows/doctor.yml
+    required_when: always
+    merge_strategy: overwrite
+
+  # Standalone release workflow (alternative to _release+_publish split)
+  # for tooling-style monorepos. Gated off by default; consumers choose
+  # one or the other.
+  - source: github/workflows/release.yml
+    target: .github/workflows/release.yml
+    required_when: never
+    merge_strategy: overwrite

package/dist/templates/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "@precisa-saude/tsconfig/library",
+  "exclude": ["node_modules", "dist"]
+}

package/dist/templates/turbo.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**"]
+    },
+    "clean": {
+      "cache": false
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "lint": {
+      "dependsOn": ["^build"],
+      "outputs": []
+    },
+    "test": {
+      "dependsOn": ["^build"],
+      "outputs": ["coverage/**"]
+    },
+    "test:coverage": {
+      "dependsOn": ["^build"],
+      "outputs": ["coverage/**"]
+    },
+    "typecheck": {
+      "dependsOn": ["^build"],
+      "outputs": []
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@precisa-saude/cli",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "Bootstrap and sync Precisa Saúde repositories — the `precisa` CLI.",
   "keywords": [
     "cli",
@@ -45,7 +45,7 @@
     "@types/prompts": "^2.4.9",
     "tsup": "^8.3.5",
     "typescript": "~5.7.3",
-    "@precisa-saude/tsconfig": "1.0.3"
+    "@precisa-saude/tsconfig": "1.1.0"
   },
   "engines": {
     "node": ">=22.0.0"

package/dist/templates/github/ISSUE_TEMPLATE/bug.md

@@ -1,33 +0,0 @@
----
-name: Bug report
-about: Something is broken
-title: '[bug] '
-labels: [bug]
----
-
-## What happened
-
-<!-- Short description of the unexpected behavior. -->
-
-## Reproduction
-
-<!-- Minimal steps. Include the exact command run, package + version, Node/pnpm versions. -->
-
-```bash
-# command(s)
-```
-
-## Expected
-
-<!-- What you expected to happen. -->
-
-## Environment
-
-- Package + version:
-- Node: `node --version`
-- pnpm: `pnpm --version`
-- OS: macOS / Linux / Windows
-
-## Additional context
-
-<!-- Stack trace, CI logs, etc. -->

package/dist/templates/github/ISSUE_TEMPLATE/feature.md

@@ -1,18 +0,0 @@
----
-name: Feature request
-about: Propose a new feature or improvement
-title: '[feat] '
-labels: [enhancement]
----
-
-## Problem
-
-<!-- What limitation or friction are you hitting? -->
-
-## Proposed solution
-
-<!-- Sketch the API / behavior. Prefer concrete examples over prose. -->
-
-## Alternatives considered
-
-<!-- Other approaches you thought about and why you ruled them out. -->