npm - create-genia-os - Versions diffs - 2.4.0 → 3.0.0 - Mend

create-genia-os 2.4.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (724) hide show

package/template/.genia/CONSTITUTION.md DELETED Viewed

@@ -1,129 +0,0 @@
-# CONSTITUIÇÃO GEN.IA OS v1.0
-> Sistema de governança do GEN.IA OS — {{TEAM_NAME}}
-> Criadora: {{CREATOR_NAME}} | Versão: 1.0.0 | Ratificada: {{SETUP_DATE}}
----
-## ARTIGO I — CLI First (NÃO-NEGOCIÁVEL)
-O Claude Code é a fonte de verdade. Toda ação passa pelos hooks de governança.
-**VIOLAÇÃO → BLOQUEIO automático.**
-Nenhuma ferramenta externa, painel ou interface bypassa o sistema de governança do GEN.IA OS. Toda modificação de código, configuração ou infraestrutura DEVE ser rastreável via CLI e registrada nos logs de auditoria. Ações realizadas fora do fluxo de hooks são consideradas não-autorizadas e podem comprometer a integridade do sistema.
----
-## ARTIGO II — Autoridade do Agente (NÃO-NEGOCIÁVEL)
-Cada agente tem autoridade exclusiva em seu domínio. Agentes DEVEM delegar quando a ação estiver fora de seu escopo.
-- **@devops** é o ÚNICO que pode executar `git push`, criar Pull Requests e realizar releases
-- **@architect** tem veto técnico irrevogável sobre decisões de arquitetura e stack
-- **@sm** é o ÚNICO que cria e altera Stories formalmente
-- **@po** é o ÚNICO que valida e aprova Stories para desenvolvimento
-- **@pm** é o ÚNICO que aprova mudanças de escopo e PRD
-**VIOLAÇÃO → BLOQUEIO automático.**
-Nenhum agente deve agir fora de sua autoridade, mesmo que tecnicamente capaz. A separação de responsabilidades é a garantia de rastreabilidade e qualidade do sistema. Quando em dúvida, delegar é obrigatório.
----
-## ARTIGO III — Story-Driven Development (OBRIGATÓRIO)
-Nenhuma linha de código pode ser escrita sem uma Story aprovada por @po. Toda Story deve ter:
-- Título claro e objetivo
-- Descrição no formato "Como [persona], quero [ação], para [benefício]"
-- Acceptance Criteria mensuráveis e verificáveis
-- Estimativa de esforço acordada
-- Épico pai identificado
-**VIOLAÇÃO → AVISO + documentar justificativa obrigatória.**
-A Story é o contrato entre negócio e técnica. Código sem Story é trabalho não rastreável, não validável e potencialmente fora de escopo. Em situações de emergência documentadas, @architect pode autorizar exceção com registro formal.
----
-## ARTIGO IV — Sem Invenção (OBRIGATÓRIO)
-Agentes derivam especificações APENAS de requisitos explicitamente declarados em briefing, PRD ou SPEC-TECNICO.
-Funcionalidades não especificadas são **estritamente proibidas**.
-**VIOLAÇÃO → AVISO + justificativa obrigatória.**
-A criatividade técnica é bem-vinda na escolha de COMO implementar, nunca no QUE implementar. Se um requisito parece faltar, o agente DEVE questionar e solicitar clarificação ao @pm ou @po, nunca assumir ou inventar. Isso protege o produto de scope creep não intencional.
----
-## ARTIGO V — Qualidade Primeiro (OBRIGATÓRIO)
-Lint, testes unitários e build bem-sucedido são pré-requisitos para qualquer entrega.
-**VIOLAÇÃO → BLOQUEIO de delivery.**
-Qualidade não é opcional nem negociável por prazo. Os quality gates existem para proteger a estabilidade do sistema em produção. Exceções documentadas devem ser aprovadas por @architect e @qa, com plano de remediação obrigatório.
----
-## ARTIGO VI — Imports Absolutos (RECOMENDADO)
-Sempre utilizar `@/` como alias de importação raiz. Caminhos relativos com múltiplos `../` são proibidos.
-**VIOLAÇÃO → AVISO informacional.**
-Imports absolutos melhoram a legibilidade, facilitam refatorações e reduzem erros ao mover arquivos. Esta convenção deve ser configurada no `tsconfig.json` e aplicada em todo o projeto.
----
-## Hierarquia de Autoridade
-```
-NÍVEL 3 — Decisão Final
-└── @architect — veto técnico irrevogável, guardiã da arquitetura
-NÍVEL 2 — Gestão e Validação
-├── @pm      — PRD, escopo, priorização, stakeholders, épicos
-├── @po      — validação de stories, backlog, acceptance criteria
-└── @analyst — requisitos, regras de negócio, briefing
-NÍVEL 1 — Execução
-├── @dev      — implementação de código (SEM permissão de push)
-├── @devops   — push, PR, release, configuração MCP/CI (ÚNICO com push)
-├── @qa       — design e execução de testes, veredictos de qualidade
-├── @reviewer — code review, padrões de código, aprovação formal
-└── @sm       — criação de stories, gestão de sprint, facilitação
-```
----
-## Processo de Emenda à Constituição
-Para alterar qualquer artigo desta Constituição:
-1. **Proposta formal** — Qualquer agente pode propor via documento `EMENDA-XXX.md`
-2. **Justificativa obrigatória** — Motivação clara com impacto nos processos existentes
-3. **Aprovação dupla** — Requer concordância de @architect E @pm
-4. **Versionamento semântico:**
-   - **MAJOR** (ex: 1.0.0 → 2.0.0): mudança breaking em artigos NÃO-NEGOCIÁVEIS
-   - **MINOR** (ex: 1.0.0 → 1.1.0): adição de novo artigo ou expansão significativa
-   - **PATCH** (ex: 1.0.0 → 1.0.1): clarificação, correção de texto, sem mudança de regra
-5. **Propagação** — Atualizar tasks, templates e workflows afetados
-6. **Comunicação** — Notificar todos os agentes sobre a mudança
----
-## Penalidades e Enforcement
-| Severidade | Violação | Consequência |
-|-----------|---------|-------------|
-| CRÍTICA | Artigo I ou II | Bloqueio automático da ação + log de auditoria |
-| ALTA | Artigo III, IV ou V | Aviso formal + documentação de justificativa |
-| MÉDIA | Artigo VI | Aviso informacional + correção na próxima iteração |
----
-*GEN.IA OS v1.0 — {{TEAM_NAME}} — {{CREATOR_NAME}} — Ratificada em 2026-02-24*

package/template/.genia/contexts/api-patterns.md DELETED Viewed

@@ -1,134 +0,0 @@
-# Contexto: API Patterns
-> Principios de design de API e tomada de decisao.
-## Mapa de Conteudo
-| Topico | Quando Usar |
-|--------|-------------|
-| REST vs GraphQL vs tRPC | Escolher tipo de API |
-| Resource naming, HTTP methods | Design REST |
-| Envelope pattern, error format | Estrutura de resposta |
-| Schema design | GraphQL |
-| Type safety | TS fullstack |
-## Arvore de Decisao: Escolher Tipo de API
-```
-Projeto → TypeScript monorepo?
-├── Sim → tRPC (type safety end-to-end)
-│
-└── Nao → Clientes diversos?
-    ├── Sim → REST (universal, cacheable)
-    │
-    └── Nao → Queries complexas?
-        ├── Sim → GraphQL (flexivel, self-documenting)
-        └── Nao → REST (simples, padrao da industria)
-```
-## REST Design
-### Naming de Recursos
-```
-GET    /users           # Lista
-GET    /users/{id}      # Detalhe
-POST   /users           # Criar
-PUT    /users/{id}      # Atualizar (completo)
-PATCH  /users/{id}      # Atualizar (parcial)
-DELETE /users/{id}      # Remover
-```
-### Status Codes
-| Code | Uso |
-|------|-----|
-| 200 | OK - Sucesso |
-| 201 | Created - Recurso criado |
-| 204 | No Content - Deletado |
-| 400 | Bad Request - Input invalido |
-| 401 | Unauthorized - Nao autenticado |
-| 403 | Forbidden - Sem permissao |
-| 404 | Not Found - Recurso nao existe |
-| 422 | Unprocessable - Validacao falhou |
-| 500 | Internal Error - Erro do servidor |
-## Formato de Resposta
-### Sucesso
-```json
-{
-  "data": { ... },
-  "meta": {
-    "pagination": { "page": 1, "total": 100 }
-  }
-}
-```
-### Erro
-```json
-{
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "Email invalido",
-    "details": [
-      { "field": "email", "message": "Formato invalido" }
-    ]
-  }
-}
-```
-## Paginacao
-### Offset-based
-```
-GET /users?page=2&limit=20
-```
-### Cursor-based (recomendado para grandes volumes)
-```
-GET /users?cursor=abc123&limit=20
-```
-## Versionamento
-| Metodo | Exemplo | Uso |
-|--------|---------|-----|
-| URI | `/v1/users` | Mais comum, facil |
-| Header | `Accept: application/vnd.api.v1+json` | Mais limpo |
-| Query | `/users?version=1` | Nao recomendado |
-## Autenticacao
-| Metodo | Quando Usar |
-|--------|-------------|
-| JWT | SPAs, mobile apps |
-| API Keys | Servicos, integracao |
-| OAuth 2.0 | Login social, terceiros |
-| Session | Apps tradicionais |
-## Rate Limiting
-### Headers de Resposta
-```
-X-RateLimit-Limit: 100
-X-RateLimit-Remaining: 95
-X-RateLimit-Reset: 1640995200
-```
-## Anti-Patterns
-| NAO Fazer | Fazer |
-|-----------|-------|
-| `/getUsers` | `GET /users` |
-| `/createUser` | `POST /users` |
-| Retornar 200 para erros | Usar status codes corretos |
-| Expor erros internos | Mensagens genericas |
-| Pular rate limiting | Sempre limitar |
-## Checklist
-- [ ] Escolhi estilo de API para o contexto?
-- [ ] Formato de resposta consistente?
-- [ ] Estrategia de versionamento?
-- [ ] Autenticacao definida?
-- [ ] Rate limiting planejado?
-- [ ] Documentacao (OpenAPI)?

package/template/.genia/contexts/nextjs-react.md DELETED Viewed

@@ -1,210 +0,0 @@
-# Contexto: Next.js & React
-> Patterns de performance e boas praticas para Next.js e React.
-## Eliminando Waterfalls
-### Problema: Requests Sequenciais
-```typescript
-// ERRADO - waterfall
-const user = await getUser(id);
-const posts = await getPosts(user.id);
-const comments = await getComments(posts);
-```
-### Solucao: Parallelizar
-```typescript
-// CORRETO - paralelo
-const [user, posts] = await Promise.all([
-  getUser(id),
-  getPosts(id)
-]);
-```
-## Bundle Size Optimization
-### Code Splitting
-```typescript
-// Dynamic imports
-const HeavyComponent = dynamic(() => import('./Heavy'), {
-  loading: () => <Skeleton />
-});
-```
-### Tree Shaking
-```typescript
-// ERRADO - importa tudo
-import _ from 'lodash';
-// CORRETO - importa so o necessario
-import debounce from 'lodash/debounce';
-```
-## Server-Side Performance
-### Streaming
-```typescript
-// app/page.tsx
-export default function Page() {
-  return (
-    <main>
-      <Header />
-      <Suspense fallback={<Loading />}>
-        <SlowComponent />
-      </Suspense>
-    </main>
-  );
-}
-```
-### Caching
-```typescript
-// Revalidate a cada hora
-export const revalidate = 3600;
-// Ou fetch com cache
-const data = await fetch(url, {
-  next: { revalidate: 3600 }
-});
-```
-## Client-Side Data Fetching
-### SWR ou React Query
-```typescript
-import useSWR from 'swr';
-function Profile() {
-  const { data, error, isLoading } = useSWR('/api/user', fetcher);
-  if (isLoading) return <Loading />;
-  if (error) return <Error />;
-  return <User data={data} />;
-}
-```
-## Re-render Optimization
-### useMemo para calculos pesados
-```typescript
-const expensiveValue = useMemo(() => {
-  return heavyCalculation(data);
-}, [data]);
-```
-### useCallback para funcoes
-```typescript
-const handleClick = useCallback(() => {
-  doSomething(id);
-}, [id]);
-```
-### React.memo para componentes
-```typescript
-const Card = React.memo(function Card({ user }) {
-  return <div>{user.name}</div>;
-});
-```
-## Rendering Performance
-### Keys corretas
-```typescript
-// ERRADO - index como key
-{items.map((item, i) => <Item key={i} />)}
-// CORRETO - id unico
-{items.map(item => <Item key={item.id} />)}
-```
-### Virtualizacao para listas longas
-```typescript
-import { FixedSizeList } from 'react-window';
-<FixedSizeList
-  height={400}
-  itemCount={1000}
-  itemSize={35}
->
-  {Row}
-</FixedSizeList>
-```
-## JavaScript Performance
-### Debounce inputs
-```typescript
-const debouncedSearch = useDebouncedCallback(
-  (value) => search(value),
-  300
-);
-```
-### Web Workers para calculos pesados
-```typescript
-const worker = new Worker('/worker.js');
-worker.postMessage(heavyData);
-worker.onmessage = (e) => setResult(e.data);
-```
-## Advanced Patterns
-### Server Components
-```typescript
-// Componente servidor (default no App Router)
-async function Posts() {
-  const posts = await db.posts.findMany(); // Direto no banco!
-  return <PostList posts={posts} />;
-}
-```
-### Server Actions
-```typescript
-async function submitForm(formData: FormData) {
-  'use server';
-  await db.users.create({ data: formData });
-}
-```
-### Parallel Routes
-```typescript
-// app/@dashboard/page.tsx
-// app/@sidebar/page.tsx
-// Carregam em paralelo
-```
-## Image Optimization
-```typescript
-import Image from 'next/image';
-<Image
-  src="/hero.jpg"
-  width={1200}
-  height={600}
-  placeholder="blur"
-  priority // Para imagens above-the-fold
-/>
-```
-## Font Optimization
-```typescript
-import { Inter } from 'next/font/google';
-const inter = Inter({
-  subsets: ['latin'],
-  display: 'swap',
-});
-```
-## Checklist de Performance
-- [ ] Requests em paralelo (Promise.all)?
-- [ ] Code splitting implementado?
-- [ ] Imagens otimizadas (next/image)?
-- [ ] Fontes otimizadas (next/font)?
-- [ ] Caching configurado?
-- [ ] Listas virtualizadas?
-- [ ] Memos apropriados?
-- [ ] Bundle analisado?

package/template/.genia/contexts/projeto.md DELETED Viewed

@@ -1,18 +0,0 @@
-# Contexto: {{PROJECT_NAME}}
-> Carregue com: `@load-context {{PROJECT_NAME}}`
-## Sobre o Projeto
-- **Nome**: {{PROJECT_NAME}}
-- **Equipe**: {{TEAM_NAME}}
-- **Stack**: {{STACK}}
-## Recursos Principais
-_Adicione aqui as informações de contexto do seu projeto:_
-_APIs, autenticação, endpoints, banco de dados, etc._
-## Links Úteis
-- GitHub: https://github.com/{{GITHUB_USER}}/{{GITHUB_REPO}}

package/template/.genia/contexts/supabase.md DELETED Viewed

@@ -1,152 +0,0 @@
-# Contexto: Supabase
-> Base de conhecimento para integracao com Supabase.
-## Configuracao
-### Credenciais
-```
-URL: [ver .env - SUPABASE_URL]
-API Key: [ver .env - SUPABASE_KEY]
-Service Key: [ver .env - SUPABASE_SERVICE_KEY]
-```
-## Cliente Python
-### Instalacao
-```bash
-pip install supabase
-```
-### Inicializacao
-```python
-from supabase import create_client
-supabase = create_client(
-    supabase_url=os.getenv("SUPABASE_URL"),
-    supabase_key=os.getenv("SUPABASE_KEY")
-)
-```
-## Operacoes CRUD
-### Select
-```python
-# Todos os registros
-data = supabase.table("tabela").select("*").execute()
-# Com filtro
-data = supabase.table("tabela").select("*").eq("coluna", valor).execute()
-# Com ordenacao
-data = supabase.table("tabela").select("*").order("coluna", desc=True).execute()
-# Com limite
-data = supabase.table("tabela").select("*").limit(10).execute()
-# Colunas especificas
-data = supabase.table("tabela").select("id, nome, email").execute()
-```
-### Insert
-```python
-data = supabase.table("tabela").insert({
-    "coluna1": "valor1",
-    "coluna2": "valor2"
-}).execute()
-# Bulk insert
-data = supabase.table("tabela").insert([
-    {"col": "val1"},
-    {"col": "val2"}
-]).execute()
-```
-### Update
-```python
-data = supabase.table("tabela").update({
-    "coluna": "novo_valor"
-}).eq("id", 123).execute()
-```
-### Delete
-```python
-data = supabase.table("tabela").delete().eq("id", 123).execute()
-```
-## Filtros
-| Metodo | SQL | Uso |
-|--------|-----|-----|
-| eq | = | .eq("col", val) |
-| neq | != | .neq("col", val) |
-| gt | > | .gt("col", val) |
-| gte | >= | .gte("col", val) |
-| lt | < | .lt("col", val) |
-| lte | <= | .lte("col", val) |
-| like | LIKE | .like("col", "%val%") |
-| ilike | ILIKE | .ilike("col", "%val%") |
-| in_ | IN | .in_("col", [1,2,3]) |
-| is_ | IS | .is_("col", None) |
-## RPC (Functions)
-```python
-# Chamar funcao
-data = supabase.rpc("nome_funcao", {"param": "valor"}).execute()
-```
-## Storage
-```python
-# Upload
-supabase.storage.from_("bucket").upload("path/file.pdf", file_content)
-# Download
-data = supabase.storage.from_("bucket").download("path/file.pdf")
-# URL publica
-url = supabase.storage.from_("bucket").get_public_url("path/file.pdf")
-```
-## Auth
-```python
-# Sign up
-supabase.auth.sign_up({"email": "...", "password": "..."})
-# Sign in
-supabase.auth.sign_in_with_password({"email": "...", "password": "..."})
-# Sign out
-supabase.auth.sign_out()
-# Get user
-user = supabase.auth.get_user()
-```
-## Gotchas
-1. Usar service key para operacoes admin
-2. RLS (Row Level Security) afeta queries com api key
-3. Timestamps em ISO 8601
-4. UUIDs para IDs
-## Patterns
-### Upsert
-```python
-data = supabase.table("tabela").upsert({
-    "id": 123,
-    "coluna": "valor"
-}).execute()
-```
-### Count
-```python
-count = supabase.table("tabela").select("*", count="exact").execute()
-print(count.count)
-```
----
-*Contexto carregado automaticamente quando detectado uso de Supabase.*