@openlife/cli 1.7.3

package/INSTALL.md

@@ -0,0 +1,266 @@
+# OpenLife Installation Manual
+
+Este manual deixa qualquer usuário pronto para instalar e usar o OpenLife.
+
+## Quick start
+
+```bash
+npm install -g @openlife/cli
+openlife init
+```
+
+`openlife init` é o **wizard interativo** recomendado: pergunta profile, host, ordem de modelos LLM, Telegram (autonomous) e doctor, e roda o `InstallFlow` para você. Se já houver instalação prévia (`.openlife/install-manifest.json`), o wizard oferece `reinstall | repair | abort`.
+
+Para automação/CI use o caminho não-interativo na seção 5.
+
+### Disponibilidade no npm
+
+A primeira versão pública (`@openlife/cli@1.6.0`) é publicada via GitHub
+Actions (`.github/workflows/publish.yml`) quando o owner do repositório
+dispara o workflow após registrar o secret `NPM_TOKEN`. Detalhes em
+`docs/release-process.md` seção 8.
+
+Se `npm install -g @openlife/cli` retornar **404 Not Found**, o publish
+ainda não foi acionado. Caminhos alternativos enquanto isso:
+
+- **Via código-fonte** (seção 8 deste manual) — funciona em qualquer
+  máquina com Node 20+ e Git.
+- **Via `npm link` local** — se você está desenvolvendo no próprio
+  clone: `git clone … && cd openlife-core && npm install && npm run
+  build && npm link`. Depois `openlife --help` resolve para o checkout.
+
+Conflito conhecido: se você já fez `npm link` local e depois roda
+`npm install -g @openlife/cli`, o instalador global pode falhar.
+Rode `npm unlink -g @openlife/cli` antes do `install -g`.
+
+## 1) Requisitos
+
+- Node.js **20+**
+- npm **10+**
+- Git (para instalação por fonte)
+
+Verificação:
+
+```bash
+node -v
+npm -v
+git --version
+```
+
+## 2) Hosts suportados
+
+OpenLife instala artefatos no host CLI escolhido. Cada host tem um documento dedicado em `docs/install/`.
+
+| Host         | Status                          | Detecção (env var)                       | Artefatos instalados                                                                |
+|--------------|---------------------------------|------------------------------------------|-------------------------------------------------------------------------------------|
+| `claude-code`| **Supported (v1.0)**            | `CLAUDECODE` ou `CLAUDE_PROJECT_DIR`     | `.claude/agents/openlife-*.md`, `.claude/commands/openlife/*.md`, MCP staged        |
+| `gemini-cli` | Reserved for v1.1 follow-up     | `GEMINI_CONFIG_DIR`                      | Nenhum no host — `.openlife/` é criado; install retorna `HOST_NOT_YET_SUPPORTED`    |
+| `codex`      | Reserved for v1.1 follow-up     | `CODEX_HOME`                             | Nenhum no host — `.openlife/` é criado; install retorna `HOST_NOT_YET_SUPPORTED`    |
+
+**Degradação graciosa:** escolher `gemini-cli` ou `codex` não trava o setup. O `InstallFlow` captura `HostNotYetSupportedError` e segue: `.openlife/` (state dir) ainda é provisionado, e o resultado reporta `hostInstall: { ok: false, reason: 'host_not_yet_supported' }` em vez de abortar.
+
+Documentação por host:
+
+- `docs/install/claude-code.md`
+- `docs/install/gemini-cli.md`
+- `docs/install/codex.md`
+
+## 3) Detecção automática de host
+
+Se você não passar `--host`, o `InstallFlow.detectHostFromEnv()` infere a partir do ambiente (ordem de precedência):
+
+1. `CLAUDECODE` ou `CLAUDE_PROJECT_DIR` → `claude-code`
+2. `GEMINI_CONFIG_DIR` → `gemini-cli`
+3. `CODEX_HOME` → `codex`
+4. Sem match → default `claude-code`
+
+Para forçar um host independentemente do ambiente, use `--host <name>`.
+
+## 4) Profiles: `framework` vs `autonomous`
+
+| Profile      | Quando usar                                                                                  | O que muda                                                                  |
+|--------------|----------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
+| `framework`  | Uso interativo local — operador no terminal chamando comandos.                               | Não inicia daemon, não exige `TELEGRAM_BOT_TOKEN`.                           |
+| `autonomous` | Runtime contínuo — daemon + Telegram gateway + governance always-on.                         | Exige `TELEGRAM_BOT_TOKEN`; o wizard checa e avisa se ausente.               |
+
+### Runtime profiles (advanced)
+
+Além do profile de instalação (`framework` vs `autonomous`), existe um profile **runtime** opcional controlado por `OPENLIFE_RUNTIME_PROFILE`. Hoje só há um valor suportado:
+
+| `OPENLIFE_RUNTIME_PROFILE` | Efeito |
+|----------------------------|--------|
+| `oauth-only` (case-insensitive) | `openlife doctor world` rebaixa quatro checks para **`info`** quando falham: `cli:ollama` (default: `blocker`) e `env:OPENAI_API_KEY` / `env:GEMINI_API_KEY` / `env:ANTHROPIC_API_KEY` (default: `warning`). |
+
+Use quando o operador roda exclusivamente via CLIs autenticadas por OAuth (`claude`, `codex`, `gemini`) e não tem API keys nem Ollama local — essas ausências deixam de bloquear o doctor. **É apenas um classificador de severidade**: a fallback chain do `Brain.ts` continua igual; nenhum provider é ligado/desligado. Para detalhes (incluindo exemplo before/after) veja [`docs/install/runtime-profiles.md`](docs/install/runtime-profiles.md).
+
+## 5) Instalação não-interativa
+
+Para scripts, CI e automação, pule o wizard e use os flags diretos:
+
+```bash
+# Framework + claude-code (caminho mais comum)
+openlife system setup --profile framework --host claude-code
+
+# Autonomous + claude-code
+openlife system setup --profile autonomous --host claude-code
+
+# Forçar host reservado (state dir é criado, host install é skipped)
+openlife system setup --profile framework --host gemini-cli
+```
+
+Explicação dos flags:
+
+- `--profile <framework|autonomous>` — required. Veja seção 4.
+- `--host <claude-code|gemini-cli|codex>` — opcional. Sem ele, usa `detectHostFromEnv()` → default `claude-code`.
+- O comando imprime um JSON com o resultado por etapa (`stateDir`, `hostInstall`, `manifestPath`) para que CI processe.
+
+## 6) Instalação recomendada (npm global)
+
+```bash
+npm install -g @openlife/cli
+openlife --help
+openlife init        # ou: openlife system setup --profile framework --host claude-code
+```
+
+## 7) Instalação sem global (npx)
+
+```bash
+npx @openlife/cli --help
+npx @openlife/cli init
+```
+
+## 8) Instalação via código-fonte
+
+```bash
+git clone https://github.com/GOOODZ/openlife-core.git
+cd openlife-core
+npm install
+npm run build
+node bin/openlife.js init
+```
+
+## 9) Modo autônomo (após install)
+
+### Instalação de artefatos do daemon
+
+```bash
+openlife agent install
+```
+
+### Start manual
+
+```bash
+openlife agent start
+openlife agent status
+```
+
+### Bundle automatizado (local/WSL/Linux)
+
+```bash
+./scripts/openlife-autonomous-install.sh
+```
+
+## 10) Uninstall reversível
+
+```bash
+openlife system uninstall --host claude-code
+```
+
+**Removido** (apenas artefatos OpenLife):
+- `.claude/agents/openlife-*.md` — somente arquivos com prefixo `openlife-`, agentes do usuário ficam intactos
+- `.claude/commands/openlife/` — diretório inteiro (namespace nosso)
+- MCP snippet staged
+
+**Preservado** (intencionalmente, para evitar perda de dados):
+- `.openlife/` — runtime state, missions, governance consents, learning, pilots
+- `.catalog/` — catálogos runtime de agents/skills/squads
+- `~/.claude.json` — config global do Claude Code (operator merges manualmente)
+
+Para começar do zero: `rm -rf .openlife/` após o uninstall.
+
+## 11) Linux server (systemd)
+
+```bash
+sudo cp scripts/openlife-agent.service.example /etc/systemd/system/openlife-agent.service
+sudo systemctl daemon-reload
+sudo systemctl enable --now openlife-agent
+sudo systemctl status openlife-agent
+```
+
+## 12) Fallback (Supervisor)
+
+```bash
+sudo supervisorctl reread
+sudo supervisorctl update
+sudo supervisorctl status
+```
+
+Use o template: `scripts/openlife-agent.supervisord.conf.example`.
+
+## 13) PATH e pós-instalação
+
+O pacote executa checks automáticos no `postinstall`:
+- valida Node/npm no PATH
+- avisa sobre PATH global npm
+- alerta sobre dependências opcionais (`claude`, `codex`, `gemini`)
+
+Descobrir diretório de binários globais npm:
+
+```bash
+npm bin -g
+```
+
+## 14) Diagnóstico
+
+Após o install, rode:
+
+```bash
+openlife system doctor
+openlife system status
+openlife models status
+```
+
+No Claude Code (depois de instalar para `claude-code`), use os slash commands:
+
+- `/openlife:status`
+- `/openlife:doctor`
+- `/openlife:ask`
+- `/openlife:dream`
+
+## 15) Troubleshooting
+
+### Problema 1 — Missing API keys (`OPENAI_API_KEY` / `ANTHROPIC_API_KEY` / `GEMINI_API_KEY`)
+
+`openlife system doctor` reporta keys ausentes. Crie `.env` na raiz do projeto:
+
+```bash
+OPENAI_API_KEY=sk-...
+ANTHROPIC_API_KEY=sk-ant-...
+GEMINI_API_KEY=...
+```
+
+O wizard `openlife init` não bloqueia por falta de keys (`framework` profile roda com fallback), mas o autonomous profile precisa de pelo menos um provider funcional + Telegram.
+
+### Problema 2 — Host não detectado / wizard escolhe o errado
+
+Sintoma: `openlife init` propõe `claude-code` quando você queria `gemini-cli` (ou vice-versa).
+
+Causa: env vars ausentes ou conflitantes. Verifique:
+
+```bash
+echo $CLAUDECODE $CLAUDE_PROJECT_DIR $GEMINI_CONFIG_DIR $CODEX_HOME
+```
+
+Solução: passe `--host` explicitamente no caminho não-interativo, ou aceite o default proposto pelo wizard e troque depois com um novo `openlife system setup`.
+
+### Problema 3 — Install para `gemini-cli` ou `codex` retorna `skipped`
+
+Esperado. Esses hosts estão **reservados para v1.1 follow-up** (ver seção 2). O `.openlife/` ainda é criado e o restante do sistema funciona — só não há agents/commands no host. Quando a Story 3.7 (gemini-cli/codex installers) for shipada, o mesmo comando passa a instalar sem alterações de flags.
+
+## 16) Links úteis
+
+- README: [README.md](README.md)
+- Per-host docs: [docs/install/claude-code.md](docs/install/claude-code.md), [docs/install/gemini-cli.md](docs/install/gemini-cli.md), [docs/install/codex.md](docs/install/codex.md)
+- Quickstart: [docs/quickstart.md](docs/quickstart.md)
+- Comandos: [docs/commands.md](docs/commands.md)
+- Autônomo: [docs/autonomous-install.md](docs/autonomous-install.md)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rafa Leão
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# OpenLife CLI
+
+OpenLife é um CLI/framework de orquestração com dois modos principais:
+
+- **CLI framework**: uso local por terminal, automações e comandos de operador.
+- **Agente autônomo**: runtime contínuo com daemon, Telegram e governança.
+
+> OpenLife é separado do Hermes. Hermes pode ajudar a operar/desenvolver OpenLife, mas o runtime do OpenLife não deve depender de `~/.hermes` nem de pastas do Obsidian.
+
+## Fonte executável canônica
+
+- Código/dev: `D:\VSCODDE-DEV\openlife-core-main`
+- WSL: `/mnt/d/VSCODDE-DEV/openlife-core-main`
+- GitHub: `https://github.com/GOOODZ/openlife-core`
+
+Obsidian (`OPENLIFE_PRODUCTION` e `LARA/OPEN-LIFE`) é camada estratégica/documental. Catálogos runtime devem viver no repo/cloud, por exemplo:
+
+```txt
+.catalog/agents/
+.catalog/squads/
+.catalog/skills/
+.catalog/mcps/
+```
+
+## Quick Start
+
+### Caminho recomendado — wizard interativo
+
+```bash
+npm install -g @openlife/cli
+openlife init
+```
+
+`openlife init` pergunta profile, host, ordem de modelos LLM, Telegram (autonomous) e doctor; depois chama o mesmo `InstallFlow` que o caminho não-interativo. Detalhes completos em [INSTALL.md](INSTALL.md).
+
+### Fallback não-interativo (CI / scripts)
+
+```bash
+openlife system setup --profile framework --host claude-code
+# ou
+openlife system setup --profile autonomous --host claude-code
+```
+
+### Hosts suportados
+
+| Host         | Status                          | Detecção (env)                       |
+|--------------|---------------------------------|--------------------------------------|
+| `claude-code`| **Supported (v1.0)**            | `CLAUDECODE` ou `CLAUDE_PROJECT_DIR` |
+| `gemini-cli` | Reserved for v1.1 follow-up     | `GEMINI_CONFIG_DIR`                  |
+| `codex`      | Reserved for v1.1 follow-up     | `CODEX_HOME`                         |
+
+`gemini-cli` e `codex` são aceitos pelo wizard e pelo CLI mas retornam `HOST_NOT_YET_SUPPORTED` no passo de instalação no host — `.openlife/` ainda é criado. Veja [INSTALL.md](INSTALL.md) para o quadro completo e os documentos por host em [docs/install/](docs/install/).
+
+## Outros comandos
+
+### Subir operação diária
+
+```bash
+openlife up
+```
+
+### Iniciar daemon manualmente
+
+```bash
+openlife start --daemon
+```
+
+### Chat local
+
+```bash
+openlife ask "sua mensagem aqui"
+```
+
+## Rodar do código-fonte
+
+```bash
+git clone https://github.com/GOOODZ/openlife-core.git
+cd openlife-core
+npm install
+npm run build
+node bin/openlife.js --help
+```
+
+## Quickstart de validação
+
+```bash
+node bin/openlife.js --help
+node bin/openlife.js status
+node bin/openlife.js doctor
+node bin/openlife.js system doctor
+node bin/openlife.js phase1-check
+node bin/openlife.js agents list
+node bin/openlife.js squads list
+node bin/openlife.js skills list
+node bin/openlife.js mcp status --real
+```
+
+## Testes e qualidade
+
+```bash
+npm run build
+npm run test:all
+```
+
+Testes essenciais individuais:
+
+```bash
+npm run test:distribution
+npm run test:orchestration
+npm run test:runtime-source
+```
+
+## Pré-requisitos
+
+- Node.js 20+
+- npm 10+
+- CLIs opcionais de execução: `claude`, `codex`, `gemini`
+- Telegram configurado para modo autônomo
+
+## Telegram
+
+O bot/routing Telegram deve:
+
+- validar `TELEGRAM_BOT_TOKEN` antes de iniciar;
+- validar `OPENLIFE_TELEGRAM_ALLOWED_USER_ID` em produção;
+- evitar múltiplos long-pollers com o mesmo token;
+- responder de forma verdadeira, sem fallback mock enganoso.
+
+## Troubleshooting rápido
+
+```bash
+openlife doctor
+openlife system doctor
+openlife status
+openlife phase1-check
+```
+
+Se o comando global não funcionar, rode via repo:
+
+```bash
+node bin/openlife.js --help
+```

package/bin/openlife.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../dist/index.js');

package/dist/admin_panel_server.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = __importDefault(require("express"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const app = (0, express_1.default)();
+app.use(express_1.default.json());
+function readJson(filePath) {
+    if (!fs_1.default.existsSync(filePath))
+        return [];
+    try {
+        return JSON.parse(fs_1.default.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return [];
+    }
+}
+function writeJson(filePath, payload) {
+    fs_1.default.mkdirSync(path_1.default.dirname(filePath), { recursive: true });
+    fs_1.default.writeFileSync(filePath, JSON.stringify(payload, null, 2), 'utf-8');
+}
+const catalogDir = path_1.default.join(process.cwd(), '.catalog');
+const teamsFile = path_1.default.join(catalogDir, 'teams.json');
+const networksFile = path_1.default.join(catalogDir, 'skill-networks.json');
+app.get('/api/v1/admin/teams', (_req, res) => {
+    res.json({ ok: true, teams: readJson(teamsFile) });
+});
+app.get('/api/v1/admin/networks', (_req, res) => {
+    res.json({ ok: true, networks: readJson(networksFile) });
+});
+app.post('/api/v1/admin/teams/upsert', (req, res) => {
+    const body = req.body || {};
+    if (!body.id)
+        return res.status(400).json({ ok: false, error: 'id obrigatório' });
+    const arr = readJson(teamsFile);
+    const next = { id: String(body.id), domain: String(body.domain || 'general'), description: String(body.description || ''), slaProfile: String(body.slaProfile || 'balanced'), members: Array.isArray(body.members) ? body.members : [] };
+    const idx = arr.findIndex((x) => x.id === next.id);
+    if (idx >= 0)
+        arr[idx] = { ...arr[idx], ...next };
+    else
+        arr.push(next);
+    writeJson(teamsFile, arr);
+    res.json({ ok: true, team: next });
+});
+app.post('/api/v1/admin/networks/upsert', (req, res) => {
+    const body = req.body || {};
+    if (!body.id)
+        return res.status(400).json({ ok: false, error: 'id obrigatório' });
+    const arr = readJson(networksFile);
+    const next = { id: String(body.id), domain: String(body.domain || 'general'), nodes: Array.isArray(body.nodes) ? body.nodes : [] };
+    const idx = arr.findIndex((x) => x.id === next.id);
+    if (idx >= 0)
+        arr[idx] = { ...arr[idx], ...next };
+    else
+        arr.push(next);
+    writeJson(networksFile, arr);
+    res.json({ ok: true, network: next });
+});
+app.get('/admin', (_req, res) => {
+    res.sendFile(path_1.default.join(process.cwd(), 'src', 'admin_panel.html'));
+});
+const port = Number(process.env.ADMIN_PANEL_PORT || 8091);
+app.listen(port, () => console.log(`[ADMIN_PANEL] running at http://localhost:${port}/admin`));

package/dist/cli/AgentManager.js

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class AgentManager {
+    root;
+    constructor(root = process.cwd()) {
+        this.root = root;
+    }
+    filePath() {
+        return path.join(this.root, '.openlife', 'agents.json');
+    }
+    list() {
+        const p = this.filePath();
+        if (!fs.existsSync(p))
+            return [{ id: 'default', name: 'Lara', isDefault: true }];
+        try {
+            return JSON.parse(fs.readFileSync(p, 'utf-8'));
+        }
+        catch {
+            return [{ id: 'default', name: 'Lara', isDefault: true }];
+        }
+    }
+    save(list) {
+        const p = this.filePath();
+        fs.mkdirSync(path.dirname(p), { recursive: true });
+        fs.writeFileSync(p, JSON.stringify(list, null, 2), 'utf-8');
+    }
+    ensureDefault(defaultName) {
+        const list = this.list();
+        const hasDefault = list.some(a => a.isDefault);
+        if (!hasDefault)
+            list.unshift({ id: 'default', name: defaultName || 'Lara', isDefault: true });
+        if (defaultName) {
+            const idx = list.findIndex(a => a.isDefault);
+            if (idx >= 0)
+                list[idx].name = defaultName;
+        }
+        // Dedup extras by normalized name and avoid collision with default name
+        const defaultAgent = list.find(a => a.isDefault);
+        const defaultNorm = (defaultAgent?.name || 'lara').trim().toLowerCase();
+        const seen = new Set();
+        const normalized = [];
+        for (const a of list) {
+            if (a.isDefault) {
+                normalized.push(a);
+                continue;
+            }
+            const key = a.name.trim().toLowerCase();
+            if (key === defaultNorm)
+                continue;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            normalized.push(a);
+        }
+        this.save(normalized);
+        return normalized;
+    }
+    createAdditional(name) {
+        const list = this.ensureDefault();
+        const normalized = name.trim().toLowerCase();
+        const defaultNorm = (list.find(a => a.isDefault)?.name || 'lara').trim().toLowerCase();
+        const exists = list.some(a => !a.isDefault && a.name.trim().toLowerCase() === normalized);
+        if (exists || normalized === defaultNorm) {
+            this.save(list);
+            return list;
+        }
+        const id = `agent-${Date.now()}`;
+        list.push({ id, name, isDefault: false });
+        this.save(list);
+        return list;
+    }
+}
+exports.AgentManager = AgentManager;