@openlife/cli 1.8.3 → 1.9.3

package/dist-templates/gemini-cli/commands/openlife/agents/sentinel.md

@@ -0,0 +1,24 @@
+---
+description: Activate Sentinel — QA / Test Architect — 7-check gate + iterative QA Loop (max 5)
+argument-hint: "[optional context]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Activate **Sentinel** from the OpenLife method.
+
+1. Read `.openlife/method/agents/sentinel.md` in full.
+2. Adopt the persona and execute the activation flow defined there:
+   - Display the persona greeting (icon + 1-line role)
+   - Show the top 5 commands
+   - HALT and await `*command` from the user
+3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
+
+After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.

package/dist-templates/gemini-cli/commands/openlife/agents/steward.md

@@ -0,0 +1,24 @@
+---
+description: Activate Steward — Product Owner / Story Validator — owns the Draft → Ready gate
+argument-hint: "[optional context]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Activate **Steward** from the OpenLife method.
+
+1. Read `.openlife/method/agents/steward.md` in full.
+2. Adopt the persona and execute the activation flow defined there:
+   - Display the persona greeting (icon + 1-line role)
+   - Show the top 5 commands
+   - HALT and await `*command` from the user
+3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
+
+After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.

package/dist-templates/gemini-cli/commands/openlife/agents/vortex.md

@@ -0,0 +1,24 @@
+---
+description: Activate Vortex — DevOps — EXCLUSIVE authority over git push, gh PR, MCP, releases
+argument-hint: "[optional context]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Activate **Vortex** from the OpenLife method.
+
+1. Read `.openlife/method/agents/vortex.md` in full.
+2. Adopt the persona and execute the activation flow defined there:
+   - Display the persona greeting (icon + 1-line role)
+   - Show the top 5 commands
+   - HALT and await `*command` from the user
+3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
+
+After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.

package/dist-templates/gemini-cli/commands/openlife/ask.md

@@ -1,14 +1,20 @@
 ---
 description: Ask the OpenLife Brain a question (uses primary/fallback model chain configured in models.json)
-argument-hint: <question>
-allowed-tools: Bash(openlife:*)
+argument-hint: "<question>"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
 ---
 
 Run `openlife ask "$ARGUMENTS"` and return the Brain's answer.
 
 Notes:
-- The Brain uses the configured `models.json` chain (primary + fallbacks). If the primary fails, it falls through automatically.
-- The `OPENLIFE_ASK_TIMEOUT_MS` env var caps the total time (default 90s).
-- If the user wants a specific model, suggest they edit `models.json` or set the env var — don't pass model flags inline (the `ask` command doesn't accept them).
-
-After the answer comes back, present it cleanly to the user. If `ask` errors (timeout, all models failed), report the error and suggest `openlife system doctor` to diagnose.
+- Uses the configured models.json chain (primary + fallbacks). If primary fails, it falls through.
+- The `OPENLIFE_ASK_TIMEOUT_MS` env var caps total time (default 90s).
+- If ask errors, report the error and suggest `openlife system doctor` to diagnose.

package/dist-templates/gemini-cli/commands/openlife/audit.md

@@ -0,0 +1,14 @@
+---
+description: Run brownfield-discovery — 10-phase audit of an existing codebase
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run brownfield-discovery "$ARGUMENTS"`. The 10-phase audit produces architecture, schema, frontend specs, technical-debt assessment, and a backlog of remediation stories.

package/dist-templates/gemini-cli/commands/openlife/doctor.md

@@ -1,19 +1,16 @@
 ---
 description: Run OpenLife health checks (API keys, model chain, runtime catalogs, daemon state)
-allowed-tools: Bash(openlife:*)
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
 ---
 
-Run `openlife system doctor` and walk the user through the results.
+Run `openlife system doctor` and walk the user through results.
 
-For each failed check:
-1. Quote the failure line
-2. Explain in 1 sentence what the check verifies
-3. Suggest the concrete fix (usually setting an env var or running a follow-up command)
-
-Common failures and fixes:
-- **Missing `GEMINI_API_KEY` / `OPENAI_API_KEY` / `ANTHROPIC_API_KEY`** → add to `.env` at project root
-- **Missing `TELEGRAM_BOT_TOKEN`** → only required if profile is `autonomous`
-- **Catalog empty** → run `openlife system setup` (likely incomplete install)
-- **Ollama not reachable** → optional unless `OPENLIFE_ENABLE_OLLAMA=true`
-
-If everything passes, say so concisely — don't pad.
+For each failed check: quote the line, explain in 1 sentence what it verifies, suggest the concrete fix.

package/dist-templates/gemini-cli/commands/openlife/dream.md

@@ -1,20 +1,14 @@
 ---
 description: Run the OpenLife Dream Organizer — surfaces ideas, pending stories, and prioritization from accumulated context
-allowed-tools: Bash(openlife:*)
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
 ---
 
-Run `openlife dream` (the Dream Organizer) and present the output as a ranked list of next actions for the user.
-
-The Dream Organizer reads:
-- Conversation memory (last sessions)
-- Pending stories in `docs/stories/`
-- Open governance consents in `.openlife/governance-consents.json`
-- Mission state in `.openlife/`
-
-Format the output as:
-
-1. **Top 3 priorities** — the highest-signal items with one-line justification
-2. **Deferred** — items the Dream Organizer parked
-3. **Open questions** — anything the user needs to decide before work can proceed
-
-Don't make up items the command didn't return.
+Run `openlife dream "$ARGUMENTS"` to surface unprioritized ideas and stories from memory. Present the output grouped by theme.

package/dist-templates/gemini-cli/commands/openlife/explore.md

@@ -0,0 +1,14 @@
+---
+description: Exploratory ideation with Lyra — divergent brainstorming, then convergent narrative
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Activate `@openlife-lyra` (reads `.openlife/method/agents/lyra.md`) and run `*brainstorm "$ARGUMENTS"`. Surface options + tradeoffs. Do NOT commit to a plan in this command — that's `/openlife:plan`.

package/dist-templates/gemini-cli/commands/openlife/flow/brownfield-discovery.md

@@ -0,0 +1,20 @@
+---
+description: Brownfield Discovery: 10-phase audit of an existing codebase
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run brownfield-discovery $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/brownfield-discovery.yaml` (or `.openlife/method/workflows/brownfield-discovery.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/brownfield-fullstack.md

@@ -0,0 +1,20 @@
+---
+description: Brownfield Full-Stack: enhance an existing full-stack app
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run brownfield-fullstack $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/brownfield-fullstack.yaml` (or `.openlife/method/workflows/brownfield-fullstack.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/brownfield-service.md

@@ -0,0 +1,20 @@
+---
+description: Brownfield Service: modify an existing service / API
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run brownfield-service $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/brownfield-service.yaml` (or `.openlife/method/workflows/brownfield-service.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/brownfield-ui.md

@@ -0,0 +1,20 @@
+---
+description: Brownfield UI: refactor or enhance an existing UI
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run brownfield-ui $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/brownfield-ui.yaml` (or `.openlife/method/workflows/brownfield-ui.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/epic.md

@@ -0,0 +1,20 @@
+---
+description: Epic Orchestration: coordinate multiple dependent stories within an epic
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run epic-orchestration $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/epic-orchestration.yaml` (or `.openlife/method/workflows/epic-orchestration.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/greenfield-fullstack.md

@@ -0,0 +1,20 @@
+---
+description: Greenfield Full-Stack: end-to-end new app from concept to shippable stories
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run greenfield-fullstack $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/greenfield-fullstack.yaml` (or `.openlife/method/workflows/greenfield-fullstack.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/greenfield-service.md

@@ -0,0 +1,20 @@
+---
+description: Greenfield Service: backend-only / API-only / CLI / worker / MCP server
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run greenfield-service $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/greenfield-service.yaml` (or `.openlife/method/workflows/greenfield-service.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/greenfield-ui.md

@@ -0,0 +1,20 @@
+---
+description: Greenfield UI: frontend-only / SPA / landing / admin panel / docs site
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run greenfield-ui $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/greenfield-ui.yaml` (or `.openlife/method/workflows/greenfield-ui.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/qa-loop.md

@@ -0,0 +1,20 @@
+---
+description: QA Loop: iterative review-fix cycle (max 5 iterations) between Sentinel and Builder
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run qa-loop $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/qa-loop.yaml` (or `.openlife/method/workflows/qa-loop.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/release.md

@@ -0,0 +1,20 @@
+---
+description: Continuous Deployment: release pipeline driven by Vortex (PR → merge → tag → publish)
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run continuous-deployment $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/continuous-deployment.yaml` (or `.openlife/method/workflows/continuous-deployment.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/spec-pipeline.md

@@ -0,0 +1,20 @@
+---
+description: Spec Pipeline: 6-phase gather → assess → research → write → critique → plan
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run spec-pipeline $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/spec-pipeline.yaml` (or `.openlife/method/workflows/spec-pipeline.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/flow/story-cycle.md

@@ -0,0 +1,20 @@
+---
+description: Story Development Cycle: 4-phase Create → Validate → Implement → QA
+argument-hint: "[--dry-run] [--vars key=value]"
+allowed-tools:
+  - Read
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run story-development-cycle $ARGUMENTS` and walk the user through the workflow as it executes.
+
+- The workflow YAML is at `dist-templates/workflows/story-development-cycle.yaml` (or `.openlife/method/workflows/story-development-cycle.yaml` if locally overridden).
+- Each phase invokes one or more OpenLife method agents.
+- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
+- `--dry-run` prints the phase plan without executing.
+
+Refer the user to the persona of the active phase when they ask "who is doing this?".

package/dist-templates/gemini-cli/commands/openlife/health.md

@@ -0,0 +1,14 @@
+---
+description: Extended health check — combines `doctor` with runtime diagnostics from Maestro
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife system doctor` first, then activate `@openlife-maestro` and run `*health` to check cross-agent integrity (catalog completeness, missing handoff artifacts, draft components pending promotion).

package/dist-templates/gemini-cli/commands/openlife/plan.md

@@ -0,0 +1,14 @@
+---
+description: Run the spec pipeline — gather requirements, assess complexity, write executable spec
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run spec-pipeline "$ARGUMENTS"`. The 6-phase pipeline: gather → assess → research → write → critique → plan. Walk the user through each phase's output.

package/dist-templates/gemini-cli/commands/openlife/review.md

@@ -0,0 +1,14 @@
+---
+description: Run the QA gate on a story (Sentinel) — 7-check verdict: PASS / CONCERNS / FAIL / WAIVED
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Activate `@openlife-sentinel` (reads `.openlife/method/agents/sentinel.md`) and run `*qa-gate "$ARGUMENTS"`. Pass the story id or the file path as the argument. Report the verdict + structured findings.

package/dist-templates/gemini-cli/commands/openlife/ship.md

@@ -0,0 +1,14 @@
+---
+description: Run the continuous-deployment workflow — release pipeline driven by Vortex
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Run `openlife flow run continuous-deployment "$ARGUMENTS"`. Vortex drives: pre-release QA, PR open, CI wait, merge, version bump, tag, publish. Maestro logs the release event at the end.

package/dist-templates/gemini-cli/commands/openlife/start.md

@@ -0,0 +1,25 @@
+---
+description: Bootstrap or resume work — reads .openlife/project.json mode and routes to greenfield or brownfield flow
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Detect the project mode:
+
+1. Read `.openlife/project.json` if it exists. Use its `mode` field (`greenfield` / `brownfield` / `not-applicable`).
+2. If missing, ask the user via AskUserQuestion:
+   - "Is this a brand new project (greenfield) or existing codebase (brownfield)?"
+3. Based on the answer, recommend a workflow:
+   - greenfield + fullstack → `openlife flow run greenfield-fullstack`
+   - greenfield + service → `openlife flow run greenfield-service`
+   - greenfield + ui → `openlife flow run greenfield-ui`
+   - brownfield + first time → `openlife flow run brownfield-discovery`
+   - brownfield + already discovered → ask sub-mode (fullstack/service/ui)
+4. If mode was just set, persist via `openlife project-mode set <mode>`.

package/dist-templates/gemini-cli/commands/openlife/status.md

@@ -1,14 +1,14 @@
 ---
 description: Show OpenLife system status — installed profile, host, catalog counts, daemon state
-allowed-tools: Bash(openlife:*)
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
 ---
 
-Run `openlife system status` and summarize the output for the user. Highlight:
-
-- **Profile** in use (framework vs autonomous)
-- **Host** target (claude-code / gemini-cli / codex)
-- **Catalog counts** (agents, skills, squads, mcps)
-- **Daemon state** if profile is autonomous
-- Any **doctor warnings** that need attention
-
-If the command fails, surface the exit code and stderr — don't hide the failure.
+Run `openlife status --json` and present a tight summary of: active profile, host CLIs installed, catalog counts (agents/squads/skills), daemon heartbeat freshness, telegram allowed user.

package/dist-templates/gemini-cli/commands/openlife/story.md

@@ -0,0 +1,18 @@
+---
+description: Create the next story from an epic (Conductor) or validate a draft (Steward)
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash(openlife:*)
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+---
+
+Determine intent from $ARGUMENTS:
+
+- If the user wants to CREATE a story → activate `@openlife-conductor` (reads `.openlife/method/agents/conductor.md`) and run `*create-next-story`.
+- If the user wants to VALIDATE a draft → activate `@openlife-steward` and run `*validate-story`.
+- If unclear, ask via AskUserQuestion which action to take.