auroq-os 1.0.0

package/.auroq-core/core/synapse/utils/paths.js

@@ -0,0 +1,57 @@
+/**
+ * SYNAPSE Path Utilities
+ *
+ * Cross-platform path resolution for the .synapse/ directory.
+ * Compatible with Windows (backslash) and Unix (forward slash).
+ *
+ * @module core/synapse/utils/paths
+ * @version 1.0.0
+ * @created Story SYN-1 - Domain Loader + Manifest Parser
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Resolve the .synapse/ directory path from a given working directory
+ *
+ * Looks for a `.synapse/` directory in the given cwd.
+ * Uses path.join for cross-platform compatibility (Windows \ and Unix /).
+ *
+ * @param {string} cwd - The working directory to search from
+ * @returns {{ exists: boolean, synapsePath: string, manifestPath: string }}
+ */
+function resolveSynapsePath(cwd) {
+  const synapsePath = path.join(cwd, '.synapse');
+  const manifestPath = path.join(synapsePath, 'manifest');
+
+  let exists = false;
+  try {
+    const stat = fs.statSync(synapsePath);
+    exists = stat.isDirectory();
+  } catch (_error) {
+    exists = false;
+  }
+
+  return {
+    exists,
+    synapsePath,
+    manifestPath,
+  };
+}
+
+/**
+ * Resolve a domain file path within the .synapse/ directory
+ *
+ * @param {string} synapsePath - Path to .synapse/ directory
+ * @param {string} fileName - Domain file name (e.g., 'agent-dev')
+ * @returns {string} Full path to domain file
+ */
+function resolveDomainPath(synapsePath, fileName) {
+  return path.join(synapsePath, fileName);
+}
+
+module.exports = {
+  resolveSynapsePath,
+  resolveDomainPath,
+};

package/.auroq-core/core/synapse/utils/tokens.js

@@ -0,0 +1,25 @@
+/**
+ * SYNAPSE Token Utilities
+ *
+ * Shared token estimation used by formatter and memory bridge.
+ *
+ * @module core/synapse/utils/tokens
+ * @version 1.0.0
+ * @created Story SYN-10 - Pro Memory Bridge (extracted from formatter.js)
+ */
+
+'use strict';
+
+/**
+ * Estimate the number of tokens from a string.
+ *
+ * Uses the proven heuristic: tokens ~ string.length / 4
+ *
+ * @param {string} text - Text to estimate
+ * @returns {number} Estimated token count
+ */
+function estimateTokens(text) {
+  return Math.ceil((text || '').length / 4);
+}
+
+module.exports = { estimateTokens };

package/.auroq-core/core-config.yaml

@@ -0,0 +1,80 @@
+project:
+  name: "Auroq OS"
+  type: greenfield
+  version: 1.0.0
+  installedAt: '2026-03-16'
+
+ide:
+  selected:
+    - claude-code
+  configs:
+    claude-code: true
+
+mcp:
+  enabled: false
+  configLocation: .claude/mcp.json
+  servers: []
+
+# Paths do framework
+businessLocation: business
+knowledgeLocation: docs/knowledge
+agentsLocation: agents
+slashPrefix: AuroqOS
+
+# Lazy loading
+lazyLoading:
+  enabled: true
+  heavySections:
+    - squads
+
+# Git
+git:
+  showConfigWarning: true
+  cacheTimeSeconds: 300
+
+# Decision logging
+decisionLogging:
+  enabled: true
+  async: true
+  location: .auroq/
+  indexFile: decision-logs-index.md
+  format: adr
+  performance:
+    maxOverhead: 50
+
+# Project status
+projectStatus:
+  enabled: true
+  autoLoadOnAgentActivation: true
+  showInGreeting: true
+  cacheTimeSeconds: 60
+  components:
+    gitBranch: true
+    gitStatus: true
+    recentWork: true
+  statusFile: .auroq/project-status.yaml
+  maxModifiedFiles: 5
+  maxRecentCommits: 2
+
+# Framework boundary (L1-L4)
+boundary:
+  frameworkProtection: true
+  protected:
+    - .auroq-core/core/**
+    - .auroq-core/development/tasks/**
+    - .auroq-core/development/templates/**
+    - .auroq-core/development/checklists/**
+    - .auroq-core/development/workflows/**
+    - .auroq-core/infrastructure/**
+    - .auroq-core/constitution.md
+  exceptions:
+    - .auroq-core/development/agents/*/MEMORY.md
+
+# Agent identity
+agentIdentity:
+  greeting:
+    contextDetection: true
+    sessionDetection: hybrid
+    performance:
+      gitCheckCache: true
+      gitCheckTTL: 300

package/.auroq-core/development/sistema-gestao-projetos.md

@@ -0,0 +1,193 @@
+# Sistema de Gestao de Projetos — Auroq OS
+
+> Como o expert opera seu negocio via projetos dentro do Auroq OS.
+> Fundamentacao: 10 mestres (Allen/GTD, Sutherland/Scrum, Goldratt/TOC, Drucker, Ohno/TPS, Cohn, Appelo, Gawande, Cagan, Deming)
+
+---
+
+## Problema que Resolve
+
+Expert operando com IA tem um problema novo: muitas possibilidades, muita velocidade, muita coisa rodando ao mesmo tempo. Sem sistema:
+- Perde visao do todo (o que ta rodando?)
+- Agentes trabalham sem saber o que outros fizeram
+- Projetos ficam pendurados sem conclusao
+- Ideias se misturam com compromissos
+- Nao tem historico de decisoes
+
+---
+
+## 10 Principios
+
+| # | Principio | Mestre | No Auroq OS |
+|---|-----------|--------|-------------|
+| 1 | **Capturar tudo, processar depois** | Allen (GTD) | Inbox → Companion classifica |
+| 2 | **Limitar trabalho em progresso** | Goldratt (TOC) | Max 3 projetos ativos. Sem excecao |
+| 3 | **Puxar, nao empurrar** | Ohno (TPS) | Agentes leem tracker e puxam trabalho |
+| 4 | **Processo sem dono esta morto** | Drucker | Toda tarefa tem dono (agente ou pessoa) |
+| 5 | **Checklists em pontos criticos** | Gawande | Weekly review = 6-item DO-CONFIRM |
+| 6 | **Melhoria continua** | Deming (PDSA) | Todo projeto termina com retro (3 perguntas) |
+| 7 | **Medir resultados, nao outputs** | Cagan | Metricas = outcomes, nao task count |
+| 8 | **Transparencia e ritmo** | Sutherland | Tracker visivel, weekly review e o ritmo |
+| 9 | **Estimar com honestidade** | Cohn | Deadlines reais, next action explicita |
+| 10 | **Sistema remove atrito** | Appelo | Agentes auto-orientam, expert valida |
+
+---
+
+## Arquitetura de 4 Camadas
+
+```
+CAMADA 4 — INBOX
+"O que eu pensei / preciso resolver?"
+  ↓ Companion captura e classifica
+
+CAMADA 3 — COCKPIT
+"O que ta rodando na empresa?" (Fonte unica de verdade)
+  ↓ cada projeto ativo usa
+
+CAMADA 2 — PLAYBOOKS
+"Como se faz isso?" (Receita reutilizavel)
+  ↓ quando o processo roda de verdade
+
+CAMADA 1 — TRACKERS
+"Onde estamos AGORA nesse que ta rodando?"
+```
+
+### Camada 4: Inbox
+- Ideias brutas capturadas pelo Companion
+- Nao sao projetos — sao possibilidades
+- Processadas no weekly review: sobe pra fila, congela, ou descarta
+- Vive no cockpit, secao INBOX
+
+### Camada 3: Cockpit (`business/cockpit.md`)
+- Fonte UNICA de verdade sobre projetos
+- 7 secoes: ATIVOS (max 3), FILA, INBOX, CONGELADOS, OPERACOES, ARQUIVO, REGRAS
+- Mantido pelo Companion, validado pelo expert
+- Todo agente consulta antes de trabalhar
+
+### Camada 2: Playbooks (`business/processos/`)
+- Receitas reutilizaveis (como fazer lancamento, como rodar campanha, etc.)
+- Criados apos fazer pela primeira vez (pavimentar → documentar → reutilizar)
+- Referenciados nos trackers
+
+### Camada 1: Trackers (`business/campanhas/{projeto}/tracker.md`)
+- Execucao ao vivo do projeto
+- Fases, tarefas, dependencias, blockers, log, metricas, retro
+- Todo agente le ANTES de trabalhar e atualiza DEPOIS
+- Template padrao em `business/templates/tracker-template.md`
+
+---
+
+## Ciclo de Vida do Projeto
+
+```
+IDEIA (inbox) → FILA (priorizada) → ATIVO (max 3) → CONCLUIDO (arquivo)
+                                        ↕
+                                   CONGELADO (someday)
+```
+
+### Nasce
+1. Ideia capturada no inbox (pelo expert ou Companion)
+2. Weekly review processa: vira projeto na fila ou descarta
+3. Quando vaga abre (ativo sai), primeiro da fila entra
+
+### Vive
+1. Tracker criado (do template)
+2. Fases e tarefas definidas
+3. Agentes puxam trabalho (pull, nao push)
+4. Log atualizado a cada acao
+5. Blockers registrados imediatamente
+
+### Morre
+1. Ultima tarefa da ultima fase concluida
+2. Metricas preenchidas
+3. Retro feita (3 perguntas)
+4. Move pro ARQUIVO no cockpit
+5. Vaga abre — proximo da fila entra
+
+---
+
+## Protocolo de Agentes
+
+**Regra global** (`rules/project-tracker-protocol.md`):
+
+### ANTES de trabalhar
+1. Ler tracker → entender onde estamos
+2. Verificar dependencias → nao comecar bloqueado
+3. Identificar sua tarefa → saber exatamente o que fazer
+
+### DURANTE
+4. Focar no escopo → fazer o que o tracker define
+5. Registrar blockers novos → imediatamente
+
+### DEPOIS
+6. Marcar tarefas Done + data
+7. Adicionar log (data — @agente: o que fez)
+8. Se desbloqueou outra tarefa → visivel automaticamente
+9. Se completou ultima tarefa da fase → marcar fase Done
+
+---
+
+## Weekly Review (Companion conduz)
+
+**Frequencia:** Semanal (7 dias). Force alert em 14 dias.
+**Duracao:** 20 minutos max.
+
+### 4 Passos:
+1. **Briefing** — Companion apresenta estado de todos os projetos
+2. **DO-CONFIRM checklist** (6 itens):
+   - Todo ativo tem next action?
+   - Algum ativo parado 5+ dias?
+   - Algum blocker sem acao?
+   - Fila ordenada corretamente?
+   - Inbox processado?
+   - Operacoes continuas saudaveis?
+3. **Update** — Atualizar cockpit e trackers
+4. **Close** — Resumo e proxima data de review
+
+---
+
+## Escalacao Automatica (Companion monitora)
+
+| Condicao | Acao |
+|----------|------|
+| Blocker 3+ dias | Alertar expert |
+| Projeto sem movimento 5+ dias | Perguntar: congelar? |
+| Deadline em 7 dias | Marcar urgente |
+| Weekly review atrasado 7+ dias | Pull automatico |
+| Weekly review atrasado 14+ dias | Force alert |
+
+---
+
+## Anti-Padroes
+
+| Anti-padrao | Por que e ruim |
+|-------------|---------------|
+| Mais de 3 ativos | Context switching mata throughput |
+| Cockpit sem weekly review | Vira documento abandonado |
+| Tracker sem donos | Ninguem se responsabiliza |
+| 50+ tarefas por tracker | Ninguem le |
+| Ignorar blockers | Perpetua impedimentos |
+| Pular retro | Repete mesmos erros |
+| Tracker sem cockpit | Fragmenta de volta |
+| Criar tracker sem projeto no cockpit | Projeto fantasma |
+
+---
+
+## Mapa de Arquivos
+
+```
+business/
+├── cockpit.md                          ← Fonte unica de verdade
+├── templates/
+│   └── tracker-template.md             ← Molde de tracker
+├── processos/
+│   └── {playbooks documentados}/       ← Receitas reutilizaveis
+└── campanhas/
+    ├── _template/                      ← Template de campanha
+    └── {projeto-ativo}/
+        └── tracker.md                  ← Execucao ao vivo
+```
+
+---
+
+*Sistema desenhado com fundamentacao nos 10 mestres. Adaptado para expert operando com SO de IA.*

package/.auroq-core/development/sistema-memoria.md

@@ -0,0 +1,157 @@
+# Sistema de Memoria Inteligente — Auroq OS
+
+> Como o sistema lembra, persiste e consolida informacao. Nao e sobre arquivos — e sobre QUANDO, O QUE e ONDE salvar.
+
+---
+
+## Por que existe
+
+IA sem memoria e amnesia. Cada sessao comeca do zero. Autocompact apaga contexto. Troca de agente perde informacao. O expert nao pode ser responsavel por lembrar de tudo — o sistema lembra por ele.
+
+---
+
+## Arquitetura de 3 Camadas
+
+```
+CAMADA 1 — MEMORIA DE SESSAO (efemera)
+  Onde: na conversa ativa
+  Sobrevive: dentro da sessao
+  Morre: no autocompact se nao salva
+  Acao: salvar em doc de trabalho ou data/ antes de perder
+
+CAMADA 2 — MEMORIA OPERACIONAL (curto/medio prazo)
+  Onde: agents/companion/data/
+  Sobrevive: entre sessoes
+  Atualizado: toda sessao significativa
+  Consolidado: weekly review
+
+CAMADA 3 — MEMORIA PERMANENTE (longo prazo — Exocortex)
+  Onde: docs/knowledge/ + business/processos/
+  Sobrevive: pra sempre
+  Atualizado: quando conhecimento e tratado ou processo e documentado
+  Cresce: via ETL, SOPs, vivencia documentada
+```
+
+### Mapa de Arquivos por Camada
+
+**Camada 2 — Memoria Operacional:**
+
+| Arquivo | Conteudo | Frequencia de atualizacao |
+|---------|---------|--------------------------|
+| `contexto-dinamico.md` | Onde estamos AGORA. Estado da empresa, sessao, foco atual | Toda sessao (no boot e no encerramento) |
+| `log-decisoes.md` | Decisoes tomadas + racional + contexto. Append-only | Quando decisao e tomada |
+| `demandas-backlog.md` | Ideias, pendencias, tarefas futuras | Quando surge ideia. Processado no weekly |
+| `padroes-observados.md` | Meta-cognicao. Padroes recorrentes no expert e no sistema | Quando Companion detecta padrao |
+
+**Camada 3 — Memoria Permanente:**
+
+| Local | Conteudo | Quando muda |
+|-------|---------|-------------|
+| `expert-mind/` | Identidade, valores, tom, historia | Raramente (quando expert evolui) |
+| `expert-business/` | Posicionamento, publico, metodologia | Quando negocio evolui |
+| `biblioteca-pmi/` | Conhecimento tratado (ETL) | Quando novo conhecimento e processado |
+| `business/processos/` | SOPs documentados | Quando processo e pavimentado |
+| `business/cockpit.md` | Estado dos projetos | Toda sessao (via project protocol) |
+
+---
+
+## 6 Triggers de Salvamento
+
+### Trigger 1: Decisao Tomada
+**Detecta:** Expert decidiu algo significativo (estrategia, preco, foco, cancelamento, prioridade)
+**Acao:** Agente ativo pergunta: "Registro essa decisao no log?"
+**Formato:**
+```markdown
+## [DATA] — [TITULO]
+**Contexto:** [o que tava acontecendo]
+**Decisao:** [o que foi decidido]
+**Racional:** [por que]
+**Impacto:** [o que muda]
+```
+**Destino:** `agents/companion/data/log-decisoes.md`
+
+### Trigger 2: Projeto Progrediu
+**Detecta:** Tarefa de projeto concluida, fase avancou, blocker resolvido
+**Acao:** Agente ativo atualiza tracker (conforme project-tracker protocol)
+**Destino:** `business/campanhas/{projeto}/tracker.md`
+
+### Trigger 3: Conhecimento Criado
+**Detecta:** Expert ou agente produziu documento, framework, analise, processo novo
+**Acao:** Agente ativo pergunta: "Salvo na biblioteca? Onde faz mais sentido?"
+**Destino:** `docs/knowledge/` (subpasta adequada) ou `business/processos/`
+
+### Trigger 4: Padrao Detectado
+**Detecta:** Companion percebe comportamento recorrente (positivo ou negativo)
+**Exemplos:** "Expert sempre adia decisoes de preco", "Lancamentos que comecam na segunda performam melhor", "Expert produz mais de manha"
+**Acao:** Companion registra sem perguntar (meta-cognicao silenciosa)
+**Formato:**
+```markdown
+## [PADRAO]
+**Observado em:** [quando/contexto]
+**Frequencia:** [quantas vezes]
+**Descricao:** [o que acontece]
+**Recomendacao:** [o que fazer quando esse padrao aparece]
+```
+**Destino:** `agents/companion/data/padroes-observados.md`
+
+### Trigger 5: Sessao Encerrando
+**Detecta:** Expert pede commit final ou indica que vai fechar
+**Acao:** Ops verifica (via commit inteligente):
+- contexto-dinamico reflete onde paramos?
+- trackers dos projetos ativos atualizados?
+- decisoes nao registradas?
+**Destino:** `contexto-dinamico.md` + trackers
+
+### Trigger 6: Autocompact Iminente
+**Detecta:** Sessao longa, muitos tokens consumidos
+**Acao:** Agente ativo salva estado IMEDIATAMENTE:
+- Criar/atualizar documento de trabalho com tudo que importa
+- Atualizar contexto-dinamico se nao fez ainda
+**Destino:** Doc de trabalho + `contexto-dinamico.md`
+
+---
+
+## Regra de Ouro
+
+**"Na duvida, salva."**
+
+E mais barato salvar informacao que nao vai usar do que perder informacao que precisava. 1 minuto salvando = horas poupadas no futuro.
+
+---
+
+## Consolidacao
+
+Memoria se move das camadas inferiores pras superiores:
+
+### No Commit (toda sessao significativa)
+- contexto-dinamico atualizado com estado atual
+- Trackers atualizados
+- Decisoes logadas
+
+### No Weekly Review (semanal)
+- Inbox processado (ideias → fila ou descarte)
+- Cockpit validado
+- Padroes revisados — algum padrao virou regra?
+- Log-decisoes revisado — alguma decisao precisa virar processo?
+
+### Quando Acumula
+- log-decisoes com 20+ entradas → Companion sugere extrair padroes
+- padroes-observados com padrao confirmado 3+ vezes → vira recomendacao ativa
+- Processo feito 3+ vezes → vira SOP em business/processos/
+
+---
+
+## Anti-Padroes de Memoria
+
+| Anti-padrao | Por que e ruim |
+|-------------|---------------|
+| Nao salvar decisoes | Repete mesmos debates, perde racional |
+| contexto-dinamico desatualizado | Companion abre sessao com info velha |
+| Salvar tudo sem criterio | Poluicao — ninguem (nem IA) le tudo |
+| Nunca consolidar | Memoria operacional incha, perde utilidade |
+| Depender da conversa | Autocompact apaga, troca de sessao perde |
+| Expert responsavel por lembrar | Derrota o proposito do sistema |
+
+---
+
+*Sistema de Memoria v1.0.0 — Auroq OS*

package/.auroq-core/dna-operacional.md

@@ -0,0 +1,134 @@
+# DNA Operacional — Auroq OS
+
+> Todo agente, squad, worker e mind criado dentro do Auroq OS herda este DNA. Nao e uma regra externa — e algo embutido no jeito que cada agente e construido.
+
+---
+
+## 1. Projeto antes de execucao
+
+Todo trabalho complexo comeca com documento estruturado.
+
+**Padrao:**
+```
+Briefing → Plano de Acao → Execucao → Validacao
+```
+
+- O Companion ou o Coordenador do Squad cria o plano
+- Executores seguem o plano aprovado
+- O plano E a coleira do agente — executa o que ta no plano, nao inventa
+
+**Quando pular:** Tasks simples e diretas (ex: "muda a data do template") nao precisam de plano formal. Mas qualquer trabalho com mais de 3 etapas ou que envolve decisoes estrategicas — planeja primeiro.
+
+---
+
+## 2. Documentacao continua
+
+A cada etapa significativa, o agente atualiza o documento de trabalho:
+
+- **Progresso** — o que ja fez, o que falta
+- **Decisoes** — o que decidiu e por que
+- **Problemas** — o que encontrou e como resolveu
+- **Estado atual** — se parar agora, onde retoma?
+
+**Por que e critico:** Autocompact pode apagar contexto a qualquer momento. Se o progresso ta no documento, sobrevive. Se ta so na conversa, morre.
+
+**Frequencia:**
+- Antes de operacoes longas: SALVAR ESTADO
+- A cada milestone natural do trabalho: ATUALIZAR
+- Antes de autocompact iminente: CONSOLIDAR TUDO
+
+---
+
+## 3. Handoff perfeito
+
+Quando um agente passa trabalho pra outro (ou quando troca de sessao), o contexto nao se perde.
+
+### 3 cenarios:
+
+| Cenario | Como funciona |
+|---------|-------------|
+| **Entre agentes (mesma sessao)** | Handoff protocol automatico — compacta persona anterior em ~379 tokens |
+| **Autocompact** | Documento de trabalho atualizado + reativar agente (le arquivos + resumo) |
+| **Novo chat** | Commit → novo chat → ativar agente → apontar pro documento |
+
+### O documento de trabalho E o handoff
+- Quem ler o documento sabe exatamente onde esta o trabalho
+- Nao precisa perguntar "o que ta acontecendo?"
+- Handoff artifact compacto acompanha: de quem, pra quem, decisoes, proxima acao
+
+---
+
+## 4. Anti-viagem
+
+O agente executa o que foi planejado. Nao inventa features, nao muda escopo, nao adiciona "melhorias".
+
+**Regras:**
+- Quality gates verificam se output corresponde ao plano
+- Veto conditions bloqueiam caminhos errados
+- Se o agente percebe que precisa mudar o plano: **PARA e pergunta**
+- Nao decide sozinho mudar escopo
+
+**Fundamenta em:**
+- KB e conhecimento tratado
+- Instrucao explicita do expert
+- Plano aprovado
+
+**Nao fundamenta em:**
+- "Acho que ficaria melhor se..."
+- "Aproveitei e adicionei..."
+- Dados inventados ou estimados
+
+---
+
+## 5. Anti-entropia
+
+Mecanismos que IMPEDEM degradacao do sistema:
+
+| Mecanismo | Como funciona |
+|-----------|-------------|
+| **Tasks com I/O definidos** | Inputs e outputs explicitos — nao conversacao livre |
+| **Separacao de papeis** | Coordenador nao executa, executor nao se auto-valida, juiz nao cria |
+| **Documentos > conversas** | O que importa vira .md, nao fica so na thread |
+| **Quality gates** | Verificam output antes de aceitar |
+| **Evolucao incremental** | Cada execucao melhora o sistema (refinar agentes, atualizar KBs) |
+| **Premissas e rules** | Regras do jogo seguidas sempre, nao so quando lembra |
+
+---
+
+## 6. Template DNA (para Forges)
+
+Todo agente criado por qualquer Forge deve incluir este bloco no seu arquivo de definicao:
+
+```yaml
+DNA_OPERACIONAL:
+  planejamento:
+    - Comeca com documento estruturado (briefing/plano) para trabalhos complexos
+    - Plano aprovado antes de executar
+
+  documentacao_continua:
+    - Atualiza documento de trabalho a cada etapa significativa
+    - Salva estado antes de operacoes longas
+    - Registra: progresso, decisoes, problemas, estado atual
+
+  handoff:
+    - Documento de trabalho sempre atualizado (E o handoff)
+    - Handoff artifact compacto em troca de agente
+    - Qualquer agente que ler o documento consegue continuar
+
+  anti_viagem:
+    - Executa o planejado, nao inventa
+    - Muda plano so com aprovacao explicita
+    - Veto conditions bloqueiam caminhos errados
+    - Fundamenta em KB, instrucao ou plano — nunca em suposicao
+
+  anti_entropia:
+    - Tasks com inputs/outputs definidos
+    - Separacao de papeis (coordenador/executor/juiz)
+    - Documentos > conversas
+    - Quality gates verificam output
+    - Cada execucao melhora o sistema
+```
+
+---
+
+*Auroq OS DNA Operacional v1.0.0*