auroq-os 2.2.2 → 2.3.0

package/agents/etlmaker/data/archive/extraction-lenses.yaml

@@ -1,178 +0,0 @@
-# ═══════════════════════════════════════════════════════════════════════════════
-# 8 LENTES DE EXTRACAO DE CONHECIMENTO — Knowledge ETL
-# ═══════════════════════════════════════════════════════════════════════════════
-# Cada fonte de conhecimento e processada por 8 angulos complementares.
-# Diferente do Squad Forge (iterativo por entrevista), aqui as lentes sao
-# aplicadas sequencialmente sobre texto ja existente.
-#
-# Principios:
-# - Zero-inference: extrair fielmente, nao interpretar
-# - Atomicidade: 1 ideia = 1 MIU
-# - Proveniencia: cada MIU rastreavel ate a fonte
-# - Cobertura: 6/8 lentes e o minimo aceitavel
-# ═══════════════════════════════════════════════════════════════════════════════
-
-version: "1.0.0"
-
-# ─────────────────────────────────────────────────────────────────────────────
-# LENTES
-# ─────────────────────────────────────────────────────────────────────────────
-lenses:
-  L1:
-    name: "Conceitual"
-    icon: "📖"
-    objective: "Extrair definicoes, termos, conceitos-chave do dominio"
-    miu_types: [CONCEPT, DEFINITION]
-    what_to_look_for:
-      - "Termos definidos explicitamente ('X e...')"
-      - "Conceitos novos ou especificos do autor"
-      - "Distincoes entre termos similares"
-      - "Vocabulario tecnico ou jargao do dominio"
-      - "Taxonomias e classificacoes"
-    rules:
-      - "Preservar a definicao EXATA do autor, nao simplificar"
-      - "Se o autor usa um termo diferente do padrao, registrar o termo dele"
-      - "Registrar distincoes explicitas ('X nao e Y')"
-
-  L2:
-    name: "Metodologica"
-    icon: "🔧"
-    objective: "Extrair frameworks, modelos, sistemas e metodos descritos"
-    miu_types: [FRAMEWORK, METHOD]
-    what_to_look_for:
-      - "Modelos com nome ('Metodo X', 'Framework Y')"
-      - "Sistemas com etapas numeradas"
-      - "Representacoes visuais (piramides, ciclos, matrizes)"
-      - "Analogias e metaforas organizadoras"
-      - "Comparacoes entre abordagens"
-    rules:
-      - "Capturar a ESTRUTURA do framework, nao so o nome"
-      - "Se tem componentes, listar todos"
-      - "Se tem sequencia, preservar a ordem"
-      - "Registrar QUEM criou o framework (se mencionado)"
-
-  L3:
-    name: "Pratica"
-    icon: "⚡"
-    objective: "Extrair tecnicas, taticas, receitas, passo-a-passo"
-    miu_types: [TECHNIQUE, PROCEDURE]
-    what_to_look_for:
-      - "'Faca X' — instrucoes diretas"
-      - "Passo-a-passo numerado"
-      - "Templates e formulas"
-      - "Dicas praticas ('um truque e...')"
-      - "Ferramentas recomendadas"
-    rules:
-      - "Preservar a SEQUENCIA se existir"
-      - "Registrar pre-requisitos mencionados"
-      - "Incluir ferramentas/recursos mencionados"
-      - "Se o autor da uma 'receita', capturar completa"
-
-  L4:
-    name: "Relacional"
-    icon: "🔗"
-    objective: "Extrair conexoes, dependencias, relacoes causa-efeito"
-    miu_types: [RELATION, DEPENDENCY]
-    what_to_look_for:
-      - "'X causa Y' — causalidade"
-      - "'X depende de Y' — dependencia"
-      - "'X potencializa Y' — amplificacao"
-      - "'X contradiz Y' — conflito"
-      - "'Sem X, Y nao funciona' — pre-requisito"
-    rules:
-      - "Capturar AMBOS os lados da relacao"
-      - "Especificar o TIPO da relacao (causa, depende, amplifica, contradiz)"
-      - "Se a relacao e condicional ('X causa Y quando Z'), registrar a condicao"
-
-  L5:
-    name: "Contextual"
-    icon: "🎯"
-    objective: "Extrair escopos, pre-requisitos, limitacoes, condicoes de uso"
-    miu_types: [CONTEXT, CONSTRAINT]
-    what_to_look_for:
-      - "'Funciona quando...' — escopo"
-      - "'Nao funciona se...' — limitacao"
-      - "'Voce precisa ter X antes' — pre-requisito"
-      - "'Para publico Y' — segmentacao"
-      - "'Em mercados Z' — contexto"
-    rules:
-      - "Contexto e CRITICO — e o que separa teoria de pratica"
-      - "Registrar TODOS os limitadores mencionados"
-      - "Se o autor assume contexto implicito, registrar o que for explicito"
-
-  L6:
-    name: "Principios"
-    icon: "⚖️"
-    objective: "Extrair regras, leis, fundamentos universais do dominio"
-    miu_types: [PRINCIPLE, RULE]
-    what_to_look_for:
-      - "'A regra e...' — regras explicitas"
-      - "'Sempre faca X' — prescricoes universais"
-      - "'O principio fundamental e...' — fundamentos"
-      - "'Lei de X' — leis nomeadas"
-      - "Hierarquias de prioridade ('X antes de Y, sempre')"
-    rules:
-      - "Principios sao UNIVERSAIS dentro do dominio (nao contextuais)"
-      - "Se o autor atribui o principio a alguem, registrar a atribuicao"
-      - "Se ha hierarquia entre principios, capturar"
-
-  L7:
-    name: "Exemplos"
-    icon: "📌"
-    objective: "Extrair cases, historias, ilustracoes, evidencias praticas"
-    miu_types: [EXAMPLE, CASE]
-    what_to_look_for:
-      - "'Por exemplo...' — exemplos diretos"
-      - "Historias e narrativas ilustrativas"
-      - "Cases de sucesso ou fracasso"
-      - "Dados reais citados"
-      - "Antes/depois — transformacoes"
-    rules:
-      - "Exemplos sao EVIDENCIA — preservar detalhes"
-      - "Registrar contexto do exemplo (quem, quando, resultado)"
-      - "Se o exemplo ilustra um principio, registrar a conexao"
-      - "Exemplos de fracasso sao tao valiosos quanto os de sucesso"
-
-  L8:
-    name: "Contraintuitiva"
-    icon: "🚫"
-    objective: "Extrair anti-padroes, mitos, erros comuns, o que NAO fazer"
-    miu_types: [ANTIPATTERN, MYTH]
-    what_to_look_for:
-      - "'O erro mais comum e...' — anti-padroes"
-      - "'Muita gente acha que X, mas...' — mitos"
-      - "'NUNCA faca X' — proibicoes"
-      - "'O que parece funcionar mas nao funciona' — armadilhas"
-      - "'Contraintuitivamente...' — inversoes de expectativa"
-    rules:
-      - "Anti-padroes sao OURO — frequentemente o conhecimento mais valioso"
-      - "Registrar POR QUE e anti-padrao (a explicacao causal)"
-      - "Se o autor explica o que fazer NO LUGAR, registrar tambem"
-      - "Mitos devem ter a verdade correspondente registrada"
-
-# ─────────────────────────────────────────────────────────────────────────────
-# REGRAS GLOBAIS
-# ─────────────────────────────────────────────────────────────────────────────
-global_rules:
-  zero_inference:
-    - "Extrair o que a fonte DIZ, nao o que IMPLICA"
-    - "Se parece faltar algo, registrar como gap — nao preencher"
-    - "Se precisar especular, marcar como inferred com confidence < 0.5"
-    - "Vocabulario da fonte e sagrado — usar os termos do autor"
-
-  atomicity:
-    - "1 MIU = 1 ideia completa"
-    - "Se um trecho tem 'e' ou 'alem disso' ligando ideias diferentes, quebrar"
-    - "MIU deve fazer sentido sozinho (autocontido)"
-    - "Se MIU precisa de outro pra fazer sentido, adicionar contexto minimo"
-
-  provenance:
-    - "Todo MIU tem source, location, quote"
-    - "Sem proveniencia = MIU invalido"
-    - "Quote e o trecho ORIGINAL que sustenta o MIU"
-
-  coverage:
-    minimum_lens_coverage: 6
-    minimum_total_mius: 20
-    minimum_confidence_avg: 0.7
-    maximum_inferred_pct: 30

package/agents/etlmaker/data/archive/miu-types.yaml

@@ -1,128 +0,0 @@
-# ═══════════════════════════════════════════════════════════════════════════════
-# MIU TYPES — Classificacao de Unidades de Conhecimento
-# ═══════════════════════════════════════════════════════════════════════════════
-
-version: "1.0.0"
-
-miu_types:
-  # ─── L1: Conceitual ───
-  CONCEPT:
-    description: "Conceito ou ideia fundamental do dominio"
-    lens: L1
-    poc_default_layer: factual
-    poc_default_sublayer: "1.1"
-    example: "Growth hacking e uma abordagem de marketing orientada a experimentos rapidos"
-
-  DEFINITION:
-    description: "Definicao precisa de um termo"
-    lens: L1
-    poc_default_layer: factual
-    poc_default_sublayer: "1.1"
-    example: "CTR (Click-Through Rate) e a porcentagem de pessoas que clicam num anuncio apos ve-lo"
-
-  # ─── L2: Metodologica ───
-  FRAMEWORK:
-    description: "Modelo ou estrutura organizadora com componentes"
-    lens: L2
-    poc_default_layer: conceptual
-    poc_default_sublayer: "2.3"
-    example: "O Metodo AIDA: Atencao, Interesse, Desejo, Acao"
-
-  METHOD:
-    description: "Metodo ou sistema com etapas definidas"
-    lens: L2
-    poc_default_layer: procedural
-    poc_default_sublayer: "3.1"
-    example: "Metodo dos 3 Pilares de Escala: Criativo, Publico, Oferta"
-
-  # ─── L3: Pratica ───
-  TECHNIQUE:
-    description: "Tecnica ou tatica especifica e executavel"
-    lens: L3
-    poc_default_layer: procedural
-    poc_default_sublayer: "3.4"
-    example: "Tecnica do gancho de 3 segundos: iniciar video com pergunta provocativa"
-
-  PROCEDURE:
-    description: "Passo-a-passo ou receita executavel"
-    lens: L3
-    poc_default_layer: procedural
-    poc_default_sublayer: "3.2"
-    example: "Para criar um lookalike: 1) Exportar lista de compradores, 2) Subir no Ads Manager, 3) Criar publico similar 1%"
-
-  # ─── L4: Relacional ───
-  RELATION:
-    description: "Relacao causa-efeito entre elementos"
-    lens: L4
-    poc_default_layer: conceptual
-    poc_default_sublayer: "2.4"
-    example: "Aumento de frequencia acima de 3x causa fadiga de anuncio e queda de CTR"
-
-  DEPENDENCY:
-    description: "Dependencia ou pre-requisito entre elementos"
-    lens: L4
-    poc_default_layer: factual
-    poc_default_sublayer: "1.5"
-    example: "Escala vertical depende de margem saudavel — sem margem, escala mata o negocio"
-
-  # ─── L5: Contextual ───
-  CONTEXT:
-    description: "Condicao de uso, escopo ou cenario de aplicacao"
-    lens: L5
-    poc_default_layer: condicional
-    poc_default_sublayer: "4.1"
-    example: "Funciona melhor para produtos acima de R$497 — abaixo disso a margem nao sustenta"
-
-  CONSTRAINT:
-    description: "Limitacao, restricao ou pre-requisito"
-    lens: L5
-    poc_default_layer: condicional
-    poc_default_sublayer: "4.1"
-    example: "Requer audiencia minima de 2K seguidores para funcionar"
-
-  # ─── L6: Principios ───
-  PRINCIPLE:
-    description: "Regra fundamental e universal do dominio"
-    lens: L6
-    poc_default_layer: conceptual
-    poc_default_sublayer: "2.2"
-    example: "Principio da Escada de Valor: o ingresso custa entre 1% e 5% do produto principal"
-
-  RULE:
-    description: "Regra operacional ou prescricao"
-    lens: L6
-    poc_default_layer: condicional
-    poc_default_sublayer: "4.2"
-    example: "Nunca escalar um anuncio que nao teve pelo menos 50 conversoes no conjunto original"
-
-  # ─── L7: Exemplos ───
-  EXAMPLE:
-    description: "Exemplo pratico ou ilustracao"
-    lens: L7
-    poc_default_layer: procedural
-    poc_default_sublayer: "3.4"
-    poc_default_module: repertorio
-    example: "Caso da campanha X que converteu 12% usando gancho emocional no criativo"
-
-  CASE:
-    description: "Case study completo com contexto e resultado"
-    lens: L7
-    poc_default_layer: procedural
-    poc_default_sublayer: "3.4"
-    poc_default_module: repertorio
-    example: "Lancamento pago da expert Y: 3.000 ingressos a R$47, faturamento de R$450K no backend"
-
-  # ─── L8: Contraintuitiva ───
-  ANTIPATTERN:
-    description: "Erro comum, pratica que parece certa mas nao e"
-    lens: L8
-    poc_default_layer: condicional
-    poc_default_sublayer: "4.3"
-    example: "Anti-padrao: aumentar orcamento de anuncio em mais de 20% por dia — resetar a otimizacao"
-
-  MYTH:
-    description: "Crenca popular que e falsa ou parcialmente falsa"
-    lens: L8
-    poc_default_layer: condicional
-    poc_default_sublayer: "4.3"
-    example: "Mito: 'quanto mais segmentado o publico, melhor'. Realidade: publicos muito pequenos nao dao dado suficiente pro algoritmo"

package/agents/etlmaker/data/etlmaker-kb.md

@@ -1,175 +0,0 @@
-# ETLmaker Knowledge Base — Metodologia v3.0
-
-## Visao Geral
-
-O ETLmaker transforma fontes brutas de conhecimento (cursos, livros, transcricoes, conversas, PDFs) em Knowledge Bases ricas, completas e fieis ao original. O output e um conjunto de volumes organizados por dominio, com formatacao rica, exemplos preservados, voz do autor mantida, e validacao em 3 camadas contra fonte.
-
-## Principios Fundamentais
-
-### 1. Composicao > Atomizacao
-
-O pipeline trata conhecimento como um livro, nao como dados. Nao atomiza em unidades menores — compreende o todo e compoe documentos ricos.
-
-### 2. Fidelidade Absoluta
-
-Nada entra no output que nao esteja na fonte. Nada sai da fonte que nao entre no output.
-
-- **Zero invencoes** — Se nao ta na fonte, nao ta no output
-- **Proveniencia inline** — Cada bloco de conteudo tem [Fonte:]
-- **Validacao em 3 camadas** — Spot-check por volume + auditoria exaustiva + 6 passes
-- **Contradicoes preservadas** — Se fontes discordam, ambas posicoes aparecem
-
-### 3. Riqueza Obrigatoria
-
-O output deve ser MELHOR que o original em organizacao, clareza e navegabilidade, mantendo 100% do conteudo.
-
-### 4. Aprovacao do Usuario
-
-O usuario aprova o plano de volumes ANTES da composicao.
-
-### 5. Mapeamento Territorial Antes de Compor
-
-Ver o terreno inteiro de cima antes de mergulhar. Dominar dominios, backbone, autores, frameworks, regras, glossario — tudo num unico documento integrado.
-
-### 6. Composicao Blocada com Checkpoint
-
-1 volume = 1 ciclo completo (ler + compor + spot-check + salvar). Cada volume e independente e persistente.
-
-### 7. Validacao em 3 Camadas
-
-Erros pegos cedo custam menos. Camada 1 pega distorcao/invencao por volume. Camada 2 pega PERDA silenciosa. Camada 3 valida estatisticamente.
-
-### 8. Profundidade > Velocidade
-
-ZERO compressao. Output MAIOR e mais organizado que input, nunca menor. Cada exemplo, cada metafora, cada template preservado intacto.
-
-### 9. Backbone do Autor
-
-Usar a estrutura que o AUTOR criou. Se ele organizou em etapas, modulos, fases — essa e a espinha dorsal natural da KB.
-
-### 10. Persistencia Entre Sessoes
-
-PLANO-ETL.md e MAPA-TERRITORIAL.md SEMPRE sobrevivem. Reler a cada retomada.
-
-## Pipeline v3.0 — 4 Fases (+Setup)
-
-| Fase | Agente | O que faz |
-|------|--------|-----------|
-| 0. Setup | Chief | Escopo, modo, estrutura, PLANO-ETL.md |
-| 1. Mapeamento Territorial | Extractor + Analyst | Ingerir fontes + mapear territorio (11 dimensoes) |
-| 2. Composicao Blocada | Composer + Auditor | Compor volumes em ciclo blocado com spot-check |
-| 3. Integracao | Architect | README, REGRAS, REPERTORIO, GLOSSARIO |
-| 4. Validacao Final | Auditor | Camada 2 (exaustiva) + Camada 3 (6-passes) |
-
-## Agentes
-
-| Agente | Papel |
-|--------|-------|
-| **etl-chief** | Orquestrador — gerencia pipeline, gates, handoffs, checkpoints |
-| **extractor** | Ingestao — normaliza fontes em texto limpo |
-| **analyst** | Mapeamento territorial — dominios, backbone, volumes, voz |
-| **architect** | Integracao — README, REGRAS, REPERTORIO, GLOSSARIO, cross-refs |
-| **composer** | Composicao blocada — volumes ricos em ciclo de 6 steps |
-| **auditor** | Validacao 3 camadas — spot-check, auditoria exaustiva, 6-passes |
-
-## Quality Gates
-
-| Gate | Nome | Threshold Chave |
-|------|------|-----------------|
-| QG-000 | Ingestion Validity | >= 100 palavras, UTF-8, metadados |
-| QG-001 | Territorial Comprehension | >= 3 dominios, backbone, voz, MAPA gerado |
-| QG-002 | Architecture Approval | Usuario aprovou plano de volumes |
-| QG-003 | Composition Richness | >= 300 linhas, spot-check 10 claims (por volume) |
-| QG-004 | Package Integration | README + REGRAS + REPERTORIO + GLOSSARIO + cross-refs |
-| QG-005 | Final Validation | Camada 2 PASS + Aggregate >= 90% + 0 invencoes |
-
-## Validacao em 3 Camadas
-
-### Camada 1: Spot-check por Volume (durante composicao)
-- 10 claims aleatorios verificados contra fonte
-- >= 8 corretos, 0 inventados
-- Pega erros de fidelidade CEDO
-
-### Camada 2: Auditoria Exaustiva (apos integracao)
-- 100% frameworks verificados contra MAPA
-- 100% regras cardinais em volumes E em REGRAS-CARDINAIS.md
-- 100% termos no GLOSSARIO
-- 100% artefatos acionaveis em volumes E no REPERTORIO
-- Consistencia entre volumes, cross-refs validas
-- NAO e amostragem — e varredura COMPLETA
-
-### Camada 3: Validacao Estatistica 6-Passes (final)
-
-| Pass | O que valida | Threshold |
-|------|-------------|-----------|
-| 1. Coverage | Dominios e subtopicos no output | >= 95% |
-| 2. Fidelity | Claims corretos vs fonte | >= 90%, 0 invencoes |
-| 3. Richness | Linhas, tabelas, exemplos por volume | Criterios minimos |
-| 4. Voice | Catchphrases, terminologia, tom | >= 80% |
-| 5. Consistency | Coerencia interna, cross-refs | 0 contradicoes |
-| 6. Integrity | Plano vs output real | 100% |
-
-**Formula:** (Cov×0.20) + (Fid×0.30) + (Rich×0.10) + (Voz×0.10) + (Cons×0.15) + (Int×0.15)
-
-## 8 Conceitos Formalizados
-
-### Mapeamento Territorial
-Fase obrigatoria de compreensao profunda antes de composicao. Output: MAPA-TERRITORIAL.md com 11 secoes.
-
-### Descoberta de Backbone
-Identificacao ativa da estrutura que o AUTOR ja criou. Usar a organizacao do criador, nao impor de fora.
-
-### Fontes Primarias vs Suporte
-Primarias (ancora) dao estrutura. Suporte (enriquecimento) da exemplos e profundidade. Classificacao por volume.
-
-### Composicao Blocada
-1 volume = 1 ciclo completo. Profundidade total. Checkpoint obrigatorio.
-
-### Protocolo de Persistencia
-PLANO-ETL.md e MAPA-TERRITORIAL.md sobrevivem autocompact. Reler a cada retomada.
-
-### Multi-Autor com Hierarquia
-Rastreamento de autores com peso (primary > collaborator > guest).
-
-### Catalogo de Artefatos Acionaveis
-Templates, formulas, benchmarks, checklists, workflows — catalogados no MAPA, preservados nos volumes, indexados no REPERTORIO.
-
-### Validacao em 3 Camadas
-Spot-check (cedo) + Auditoria (exaustiva) + 6-passes (estatistica).
-
-## Estrutura de Output
-
-```
-kbs/{slug}/
-  PLANO-ETL.md                    # Plano persistente (status, decisoes)
-  README.md                       # Indice + navegacao
-  REGRAS-CARDINAIS.md             # Principios absolutos por dominio
-  REPERTORIO.md                   # Artefatos acionaveis (11 secoes)
-  GLOSSARIO.md                    # Terminologia proprietaria
-  VOL-01-{topico}.md              # Volumes por dominio
-  VOL-02-{topico}.md
-  ...
-  completeness-report.yaml        # Metricas e status
-  00-pipeline/                    # Interno (nao entregavel)
-    sources/                      # Fontes normalizadas
-    MAPA-TERRITORIAL.md           # Mapa integrado com 11 secoes
-    critical-audit-report.yaml    # Resultado Camada 2
-    validation-report.yaml        # Resultado Camada 3
-  .state.json                     # Estado do pipeline
-```
-
-## Evolucao v1.0 → v2.0 → v3.0
-
-| Aspecto | v1.0 | v2.0 | v3.0 |
-|---------|------|------|------|
-| Unidade base | MIU (atomica) | Documento rico | Documento rico |
-| Compreensao | Nenhuma | Deep Read (4 yamls) | Mapeamento Territorial (1 MAPA integrado) |
-| Planejamento | Automatico | Architect planeja | Analyst planeja (quem entende planeja) |
-| Composicao | Reassembly de MIUs | Linear | Blocada (1 vol = 1 ciclo) |
-| Validacao | Estrutural | 5-passes no final | 3 camadas (spot-check + exaustiva + 6-passes) |
-| Checkpoint | Nenhum | Nenhum | Por volume + PLANO-ETL.md |
-| Multi-autor | Nao | Nao | Com hierarquia |
-| Backbone | Nao | Nao | Descoberta ativa |
-| Glossario | Nao | Nao | Obrigatorio |
-| Artefatos | Nao catalogados | No REPERTORIO | Catalogados no MAPA + preservados + indexados |
-| Persistencia | 1 sessao | 1 sessao | Protocolo formal |