@openlife/cli 1.7.5 → 1.7.7

package/docs/getting-started.md

@@ -0,0 +1,137 @@
+# Getting Started
+
+A 5-minute walkthrough to get OpenLife CLI running on your machine.
+
+## 1. Install globally
+
+```bash
+npm install -g @openlife/cli
+openlife --version
+```
+
+You should see the current version (matching the npm tag).
+
+## 2. Run the wizard
+
+```bash
+openlife init
+```
+
+The wizard prints the OpenLife banner, then walks you through:
+
+1. **Profile** — choose `framework` (CLI only), `autonomous` (daemon),
+   or `both`. `both` installs the autonomous profile, which includes
+   the framework layer.
+2. **Host** — `claude-code`, `gemini-cli`, or `codex`. Auto-detected
+   when you launch `openlife init` from inside one of these CLIs.
+3. **API keys** — paste your `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`,
+   `GEMINI_API_KEY`, and/or `OPENROUTER_API_KEY`. Press Enter to skip
+   any one. Keys are saved to `.env` in the project directory.
+4. **OAuth pointer** — answer `y` if you plan to use `openlife auth
+   gemini` or `openlife auth openai` later. The wizard does not start
+   the OAuth flow itself; it just reminds you to run those commands
+   after init completes.
+5. **Model chain** — comma-separated `provider/model` list, e.g.
+   `openai-api/gpt-5.4-mini,anthropic-api/claude-sonnet-4-6`. Leave
+   blank to accept the defaults from `models.json`.
+6. **Telegram** (autonomous only) — confirm whether `TELEGRAM_BOT_TOKEN`
+   and `OPENLIFE_TELEGRAM_ALLOWED_USER_ID` are already in `.env`.
+7. **Doctor** — answer `n` to run system diagnostics after install.
+8. **Confirm** — review the summary and answer `Y` to proceed.
+
+When the wizard finishes you should see:
+
+```
+✅ OpenLife ready.
+
+Try:
+  openlife ask "hello, what can you do?"
+  openlife status
+  openlife --help
+
+Docs: https://github.com/GOOODZ/openlife-core
+```
+
+## 3. Try your first command
+
+```bash
+openlife ask "summarize this README in one sentence"
+```
+
+OpenLife will route the request to the highest-priority model in your
+chain that has a working key. If no API key is configured, it falls
+back to local Ollama (if available) or returns an error.
+
+## 4. Common follow-ups
+
+- **Set up OAuth (no API key needed):**
+  ```bash
+  openlife auth gemini    # browser-based Google login
+  openlife auth openai    # browser-based OpenAI login
+  ```
+- **Start the autonomous daemon (autonomous profile):**
+  ```bash
+  openlife start --daemon
+  ```
+- **Inspect runtime state:**
+  ```bash
+  ls .openlife/
+  cat .openlife/heartbeat.json
+  cat .openlife/install-manifest.json
+  ```
+- **Update to latest version:**
+  ```bash
+  npm install -g @openlife/cli@latest
+  ```
+
+## Troubleshooting
+
+### `openlife: command not found` after install
+
+The global npm bin directory is probably not on your `PATH`. Run:
+
+```bash
+npm bin -g
+```
+
+Add that path to your shell profile (`~/.bashrc`, `~/.zshrc`).
+
+### `npm install -g` says EEXIST
+
+You have a leftover symlink from a previous `npm link`. Run:
+
+```bash
+npm unlink -g @openlife/cli
+rm -f $(which openlife)
+npm install -g @openlife/cli
+```
+
+### `openlife ask` fails with `MODEL_TIMEOUT` or `no provider available`
+
+No API key is configured and no fallback (Ollama, OAuth) is wired up.
+Either:
+
+- Edit `.env` to add `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or
+  `GEMINI_API_KEY`, then retry, or
+- Run `openlife auth gemini` / `openlife auth openai` to use OAuth, or
+- Start a local Ollama server (`ollama serve`) and set
+  `OPENLIFE_ENABLE_OLLAMA=true` in `.env`.
+
+### Telegram autonomous mode reports `TELEGRAM_NOT_CONFIGURED`
+
+Set both in `.env`:
+
+```
+TELEGRAM_BOT_TOKEN=<from BotFather>
+OPENLIFE_TELEGRAM_ALLOWED_USER_ID=<your Telegram user id>
+```
+
+Then restart with `openlife start --daemon`.
+
+## Where to go next
+
+- [INSTALL.md](../INSTALL.md) — full install options including
+  non-interactive (`openlife system setup`) for CI use.
+- [README.md](../README.md) — feature overview and architecture.
+- [CHANGELOG.md](../CHANGELOG.md) — what changed across versions.
+- [CONTRIBUTING.md](../CONTRIBUTING.md) — dev setup and conventions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlife/cli",
-  "version": "1.7.5",
+  "version": "1.7.7",
   "description": "OPEN-LIFE Córtex Orquestrador Dual-Core",
   "main": "dist/index.js",
   "files": [
@@ -10,6 +10,7 @@
     "dist-templates",
     "docs/README.md",
     "docs/quickstart.md",
+    "docs/getting-started.md",
     "docs/workflow-schema.md",
     "docs/toolset-enforcement.md",
     "docs/release-process.md",
@@ -155,8 +156,10 @@
     "test:doctor-sandbox-check": "npm run build && node dist/test_doctor_sandbox_check.js",
     "test:task-executor-sandbox-optin": "npm run build && node dist/test_task_executor_sandbox_optin.js",
     "test:forecast-brain-wiring": "npm run build && node dist/test_forecast_brain_wiring.js",
+    "test:status-command": "npm run build && node dist/test_status_command.js",
+    "test:logs-command": "npm run build && node dist/test_logs_command.js",
     "pretest:all": "node scripts/clean-test-pollution.js",
-    "test:all": "npm run build && node dist/test_distribution_installability.js && node dist/test_orchestration_assets_lifecycle.js && node dist/test_openlife_runtime_source_truth.js && node dist/test_openlife_evolution_surface.js && node dist/test_openlife_routing_surface.js && node dist/test_openlife_auto_creator_routing.js && node dist/test_openlife_gatekeeper_routing.js && node dist/test_enterprise_agentic_core.js && node dist/test_admin_teams_networks.js && node dist/test_agent_team_skill_network.js && node dist/test_benchmark_engine.js && node dist/test_cli_service_commands.js && node dist/test_consequence_forecaster.js && node dist/test_conversation_memory.js && node dist/test_create_entities.js && node dist/test_designmd_import_registry.js && node dist/test_designmd_mode.js && node dist/test_designmd_mode_workspace.js && node dist/test_dream_organizer.js && node dist/test_dual_mode.js && node dist/test_governance.js && node dist/test_governance_advanced.js && node dist/test_install_flow.js && node dist/test_job_lifecycle.js && node dist/test_memory_orchestrator.js && node dist/test_memory_promotion.js && node dist/test_memory_retention.js && node dist/test_operating_system.js && node dist/test_optimization_loop.js && node dist/test_outcome_simulator.js && node dist/test_performance_scorecard.js && node dist/test_phase6_board.js && node dist/test_phase6_cadence.js && node dist/test_phase6_ops.js && node dist/test_release_gate.js && node dist/test_reversa_contracts_e2e.js && node dist/test_reversa_export_and_strict.js && node dist/test_reversa_full_execution.js && node dist/test_reversa_lite.js && node dist/test_runtime_policy.js && node dist/test_runtime_probe.js && node dist/test_runtime_registry.js && node dist/test_security_download_guard.js && node dist/test_service_command_surface.js && node dist/test_service_completion_policy.js && node dist/test_service_guardrails_delete.js && node dist/test_sources_import_ref.js && node dist/test_sources_scaffold.js && node dist/test_teammate_learning.js && node dist/test_telegram_delete_guardrail.js && node dist/test_daemon_sigterm.js && node dist/test_ask_exit.js && node dist/test_brain_error_diagnostics.js && node dist/test_cli_doc_parity.js && node dist/test_trigger_basic_auth.js && node dist/test_brain_fallback_chain.js && node dist/test_cli_help_surface.js && node dist/test_cli_diagnostics.js && node dist/test_cli_crud_roundtrip.js && node dist/test_subsystems_routing_governance.js && node dist/test_subsystems_org_state.js && node dist/test_subsystems_promotion_memory_assets.js && node dist/test_phase1_check_exit.js && node dist/test_install_flow_host_validation.js && node dist/test_dist_templates_layout.js && node dist/test_host_installer.js && node dist/test_host_uninstaller.js && node dist/test_install_wizard.js && node dist/test_multi_host_docs_parity.js && node dist/test_host_install_e2e.js && node dist/test_runtime_profile_oauth_only.js && node dist/test_atomic_writer.js && node dist/test_mission_checkpoint.js && node dist/test_workflow_parser.js && node dist/test_workflow_engine.js && node dist/test_workflow_e2e.js && node dist/test_distributed_lock.js && node dist/test_watchdog_heartbeat.js && node dist/test_runtime_health_backoff.js && node dist/test_queue_scheduler.js && node dist/test_squad_skill_creator.js && node dist/test_aiobuilder_cli_parity.js && node dist/test_catalog_quality.js && node dist/test_royal_stack_golden.js && node dist/test_capability_pack_schema.js && node dist/test_capability_genesis_engine.js && node dist/test_workflow_schema_backward_compat.js && node dist/test_service_mode_explicit_only.js && node dist/test_deep_research_capability.js && node dist/test_guided_creator_cli.js && node dist/test_governance_v13_policies.js && node dist/test_gateway_telegram_guardrails.js && node dist/test_cron_manager.js && node dist/test_profile_toolset_mcp.js && node dist/test_squad_skill_design_llm.js && node dist/test_workflow_condition_parser.js && node dist/test_security_download_and_scan.js && node dist/test_host_installers_gemini_codex.js && node dist/test_toolset_enforcement.js && node dist/test_creator_placeholders_completed.js && node dist/test_performance_latency.js && node dist/test_post_mission_evaluation.js && node dist/test_governance_scope_ledger.js && node dist/test_consequence_forecast_brain.js && node dist/test_remote_publish.js && node dist/test_process_sandbox.js && node dist/test_v15_e2e_integration.js && node dist/test_doctor_sandbox_check.js && node dist/test_task_executor_sandbox_optin.js && node dist/test_forecast_brain_wiring.js",
+    "test:all": "npm run build && node dist/test_distribution_installability.js && node dist/test_orchestration_assets_lifecycle.js && node dist/test_openlife_runtime_source_truth.js && node dist/test_openlife_evolution_surface.js && node dist/test_openlife_routing_surface.js && node dist/test_openlife_auto_creator_routing.js && node dist/test_openlife_gatekeeper_routing.js && node dist/test_enterprise_agentic_core.js && node dist/test_admin_teams_networks.js && node dist/test_agent_team_skill_network.js && node dist/test_benchmark_engine.js && node dist/test_cli_service_commands.js && node dist/test_consequence_forecaster.js && node dist/test_conversation_memory.js && node dist/test_create_entities.js && node dist/test_designmd_import_registry.js && node dist/test_designmd_mode.js && node dist/test_designmd_mode_workspace.js && node dist/test_dream_organizer.js && node dist/test_dual_mode.js && node dist/test_governance.js && node dist/test_governance_advanced.js && node dist/test_install_flow.js && node dist/test_job_lifecycle.js && node dist/test_memory_orchestrator.js && node dist/test_memory_promotion.js && node dist/test_memory_retention.js && node dist/test_operating_system.js && node dist/test_optimization_loop.js && node dist/test_outcome_simulator.js && node dist/test_performance_scorecard.js && node dist/test_phase6_board.js && node dist/test_phase6_cadence.js && node dist/test_phase6_ops.js && node dist/test_release_gate.js && node dist/test_reversa_contracts_e2e.js && node dist/test_reversa_export_and_strict.js && node dist/test_reversa_full_execution.js && node dist/test_reversa_lite.js && node dist/test_runtime_policy.js && node dist/test_runtime_probe.js && node dist/test_runtime_registry.js && node dist/test_security_download_guard.js && node dist/test_service_command_surface.js && node dist/test_service_completion_policy.js && node dist/test_service_guardrails_delete.js && node dist/test_sources_import_ref.js && node dist/test_sources_scaffold.js && node dist/test_teammate_learning.js && node dist/test_telegram_delete_guardrail.js && node dist/test_daemon_sigterm.js && node dist/test_ask_exit.js && node dist/test_brain_error_diagnostics.js && node dist/test_cli_doc_parity.js && node dist/test_trigger_basic_auth.js && node dist/test_brain_fallback_chain.js && node dist/test_cli_help_surface.js && node dist/test_cli_diagnostics.js && node dist/test_cli_crud_roundtrip.js && node dist/test_subsystems_routing_governance.js && node dist/test_subsystems_org_state.js && node dist/test_subsystems_promotion_memory_assets.js && node dist/test_phase1_check_exit.js && node dist/test_install_flow_host_validation.js && node dist/test_dist_templates_layout.js && node dist/test_host_installer.js && node dist/test_host_uninstaller.js && node dist/test_install_wizard.js && node dist/test_multi_host_docs_parity.js && node dist/test_host_install_e2e.js && node dist/test_runtime_profile_oauth_only.js && node dist/test_atomic_writer.js && node dist/test_mission_checkpoint.js && node dist/test_workflow_parser.js && node dist/test_workflow_engine.js && node dist/test_workflow_e2e.js && node dist/test_distributed_lock.js && node dist/test_watchdog_heartbeat.js && node dist/test_runtime_health_backoff.js && node dist/test_queue_scheduler.js && node dist/test_squad_skill_creator.js && node dist/test_aiobuilder_cli_parity.js && node dist/test_catalog_quality.js && node dist/test_royal_stack_golden.js && node dist/test_capability_pack_schema.js && node dist/test_capability_genesis_engine.js && node dist/test_workflow_schema_backward_compat.js && node dist/test_service_mode_explicit_only.js && node dist/test_deep_research_capability.js && node dist/test_guided_creator_cli.js && node dist/test_governance_v13_policies.js && node dist/test_gateway_telegram_guardrails.js && node dist/test_cron_manager.js && node dist/test_profile_toolset_mcp.js && node dist/test_squad_skill_design_llm.js && node dist/test_workflow_condition_parser.js && node dist/test_security_download_and_scan.js && node dist/test_host_installers_gemini_codex.js && node dist/test_toolset_enforcement.js && node dist/test_creator_placeholders_completed.js && node dist/test_performance_latency.js && node dist/test_post_mission_evaluation.js && node dist/test_governance_scope_ledger.js && node dist/test_consequence_forecast_brain.js && node dist/test_remote_publish.js && node dist/test_process_sandbox.js && node dist/test_v15_e2e_integration.js && node dist/test_doctor_sandbox_check.js && node dist/test_task_executor_sandbox_optin.js && node dist/test_forecast_brain_wiring.js && node dist/test_status_command.js && node dist/test_logs_command.js",
     "prepublishOnly": "npm run test:all"
   },
   "dependencies": {