openlogos status

Show a dashboard of all 9 phases with completion status, list active change proposals, and suggest the next action. In multi-module projects, also shows per-module phase progress.

Synopsis

openlogos status [--module <id>] [--format json]

Must be run from the project root.

Options

Option	Description
`--module <id>`	Filter output to a single module. Shows only that module’s phase progress and suggestion.
`--format json`	Output structured JSON instead of human-readable text.

What it checks

The command scans 11 directories in logos/resources/ to determine phase completion.

Single-module projects — a phase is done when its directory contains at least one non-.gitkeep file.

Multi-module projects — phase completion is module-aware:

Scenario phases (phase.3-1, phase.3-4a): done when every scenario belonging to the module has a matching <moduleId>-SXX-*.md file.
All other phases: done when the directory contains at least one file with a <moduleId>- prefix (e.g., admin-01-requirements.md). Files belonging to other modules are ignored.

Phase	Directory scanned
Phase 1 · Requirements	`logos/resources/prd/1-product-requirements/`
Phase 2 · Product Design	`logos/resources/prd/2-product-design/`
Phase 3-0 · Architecture	`logos/resources/prd/3-technical-plan/1-architecture/`
Phase 3-1 · Scenario Modeling	`logos/resources/prd/3-technical-plan/2-scenario-implementation/`
Phase 3-2 · API Design	`logos/resources/api/`
Phase 3-2 · DB Design	`logos/resources/database/`
Phase 3-3 · Deployment Plan	`logos/resources/prd/3-technical-plan/3-deployment/`
Phase 3-4a · Test Cases	`logos/resources/test/`
Phase 3-4b · Orchestration	`logos/resources/scenario/`
Phase 3-6 · Verification	`logos/resources/verify/`
Phase 3-8 · Smoke Test	`logos/resources/verify/smoke-report.md`

Note: Phase 3-5 (Code Implementation + Test Code) is not tracked as a separate directory because code output goes into the project source tree. Its completion is validated indirectly through Phase 3-6 — when tests pass and openlogos verify reports Gate 3.6 PASS, Phase 3-5 is implicitly confirmed. Phase 3-7 (Deployment Execution) is tracked via the deployment report.

It also scans logos/changes/ for active change proposals (excluding archive/).

Example output (in progress)

📊 OpenLogos Project Status

──────────────────────────────────────────────────
✅  Phase 1 · Requirements (WHY)
     └─ core-01-requirements.md
✅  Phase 2 · Product Design (WHAT)
     └─ 1-feature-specs/core-01-feature-specs.md
🔲  Phase 3-0 · Architecture
🔲  Phase 3-1 · Scenario Modeling
🔲  Phase 3-2 · API Design
🔲  Phase 3-2 · Database Design
🔲  Phase 3-3a · Test Case Design (Unit + Scenario)
🔲  Phase 3-3b · API Orchestration Tests
🔲  Phase 3-4 · Code Implementation + Test Code
🔲  Phase 3-5 · Test Acceptance (verify)
──────────────────────────────────────────────────

🧩 Modules

  🔄  core (Core)  [initial → Phase 3-0 · Architecture]
       💡 Tell AI: "Help me design the technical architecture"

💡 Suggested next step: Phase 3-0 · Architecture
   → Tell AI: "Help me design the technical architecture"

Example output (multi-module)

When multiple modules are registered, each module’s phase progress is shown independently:

📊 OpenLogos Project Status

──────────────────────────────────────────────────
✅  Phase 1 · Requirements (WHY)
✅  Phase 2 · Product Design (WHAT)
✅  Phase 3-0 · Architecture
...
──────────────────────────────────────────────────

🧩 Modules

  ✅  core (Core)  [launched]
       💡 Run openlogos change <slug> to create a new change proposal
  🔄  admin (Admin)  [initial → Phase 1 · Requirements (WHY)]
       💡 Tell AI: "Help me write requirements"

Use --module admin to focus on a single module:

openlogos status --module admin

🧩 Modules

  🔄  admin (Admin)  [initial → Phase 1 · Requirements (WHY)]
       💡 Tell AI: "Help me write requirements"

Example output (all done)

📊 OpenLogos Project Status

──────────────────────────────────────────────────
✅  Phase 1 · Requirements (WHY)
     └─ 01-requirements.md
✅  Phase 2 · Product Design (WHAT)
     └─ ...
✅  Phase 3-0 · Architecture
     └─ 01-architecture-overview.md
✅  Phase 3-1 · Scenario Modeling
     └─ ...
✅  Phase 3-2 · API Design
     └─ openapi.yaml
✅  Phase 3-2 · Database Design
     └─ schema.sql
✅  Phase 3-3a · Test Case Design
     └─ ...
✅  Phase 3-3b · API Orchestration Tests
     └─ ...
✅  Phase 3-4 · Code Implementation + Test Code
     └─ (validated via Phase 3-5)
✅  Phase 3-5 · Test Acceptance (verify)
     └─ acceptance-report.md
──────────────────────────────────────────────────

🎉 All phases complete! Run `openlogos verify` to check test acceptance.
   → Run `openlogos launch` to activate change management for future iterations.

Active change proposals

When the lifecycle is launched and there are open proposals in logos/changes/, the proposal step is shown:

📝 Active Change Proposals
     └─ fix-redirect-bug (proposal.md ✓ | tasks.md ✓ | deltas: 3 files)
──────────────────────────────────────────────────

Proposal steps

The proposal step tracks where a change proposal is in its lifecycle:

Step	Meaning
`writing`	`proposal.md` or `tasks.md` still contains template placeholders
`delta-writing`	Proposal filled in; `[delta]` section tasks not yet all checked
`ready-to-merge`	All `[delta]` section tasks checked (or no `[delta]` section)
`merge-generated`	`openlogos merge` has run; `MERGE_PROMPT.md` generated
`coding`	Specs merged (`SPEC_MERGED` exists); `[code]` section tasks not yet all checked
`ready-to-verify`	All `[code]` section tasks checked (or no `[code]` section)
`verify-passed`	`openlogos verify` passed; `VERIFY_PASS` marker written
`verify-failed`	`openlogos verify` failed; `VERIFY_FAIL` marker written

Errors

Error	Cause	Fix
`logos/logos.config.json not found`	Not in project root	`cd` to project root, or run `openlogos init` first
`Module 'admin' not found in logos-project.yaml`	`--module` value doesn’t match any registered module	Run `openlogos module list` to see valid module IDs

init — Create the project structure that status checks
module — Manage modules (list / add / rename / remove)
launch — Activate change management (suggested when all phases are done)
verify — Run the Phase 3-5 verification check