跳转到内容

openlogos status

展示每个阶段完成状态的仪表盘,列出活跃的变更提案,并建议下一步操作。在多模块项目中,还会显示每个模块各自的阶段进度。

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

必须在项目根目录下运行。

选项说明
--module <id>将输出过滤到单个模块。仅显示该模块的阶段进度和建议。
--format json输出结构化 JSON,而非人类可读文本。

命令会扫描 logos/resources/ 中的 11 个目录来判断阶段完成情况。

单模块项目 —— 当某个阶段的目录包含至少一个非 .gitkeep 文件时,该阶段即为完成。

多模块项目 —— 阶段完成情况是模块感知的:

  • 场景阶段(phase.3-1、phase.3-4a):当属于该模块的每个场景都有匹配的 <moduleId>-SXX-*.md 文件时为完成。
  • 所有其他阶段:当目录包含至少一个带 <moduleId>- 前缀的文件(例如 admin-01-requirements.md)时为完成。属于其他模块的文件会被忽略。
阶段扫描的目录
Phase 1 · Requirementslogos/resources/prd/1-product-requirements/
Phase 2 · Product Designlogos/resources/prd/2-product-design/
Phase 3-0 · Architecturelogos/resources/prd/3-technical-plan/1-architecture/
Phase 3-1 · Scenario Modelinglogos/resources/prd/3-technical-plan/2-scenario-implementation/
Phase 3-2 · API Designlogos/resources/api/
Phase 3-2 · DB Designlogos/resources/database/
Phase 3-3 · Deployment Planlogos/resources/prd/3-technical-plan/3-deployment/
Phase 3-4a · Test Caseslogos/resources/test/
Phase 3-4b · Orchestrationlogos/resources/scenario/
Phase 3-6 · Verificationlogos/resources/verify/
Phase 3-8 · Smoke Testlogos/resources/verify/smoke-report.md

注意: Phase 3-5(代码实现 + 测试代码)不作为独立目录跟踪,因为代码输出进入项目源码树。它的完成情况通过 Phase 3-6 间接验证 —— 当测试通过且 openlogos verify 报告 Gate 3.6 PASS 时,Phase 3-5 即被隐式确认。Phase 3-7(部署执行)通过部署报告跟踪。

它还会扫描 logos/changes/ 中的活跃变更提案(排除 archive/)。

📊 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-3 · Deployment Plan
🔲 Phase 3-4a · Test Case Design (Unit + Scenario)
🔲 Phase 3-4b · API Orchestration Tests
🔲 Phase 3-5 · Code Implementation
🔲 Phase 3-6 · 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"

当注册了多个模块时,每个模块的阶段进度会独立展示:

📊 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"

使用 --module admin 聚焦到单个模块:

Terminal window
openlogos status --module admin
🧩 Modules
🔄 admin (Admin) [initial → Phase 1 · Requirements (WHY)]
💡 Tell AI: "Help me write requirements"
📊 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-3 · Deployment Plan
└─ ...
✅ Phase 3-4a · Test Case Design (Unit + Scenario)
└─ ...
✅ Phase 3-4b · API Orchestration Tests
└─ ...
✅ Phase 3-5 · Code Implementation
└─ (validated via Phase 3-6)
✅ Phase 3-6 · 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.

当 lifecycle 为 launched 且 logos/changes/ 中有未关闭的提案时,会显示提案步骤:

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

提案步骤跟踪一个变更提案处于其生命周期中的哪个位置:

步骤含义
writingproposal.md 或 tasks.md 缺失,或尚未通过计划包检查(模板占位、缺章节)
ready-to-delta方案已完成,停在 plan-exit 门(批准方案后再写 delta)
delta-writing方案已批准;[delta] 分节任务尚未全部勾选
ready-to-merge[delta] 任务已全部勾选,停在 spec-exit 门——明确授权执行 openlogos merge <slug>
spec-complete-required没有 [delta] 但需要代码——先执行 no-delta openlogos merge <slug> 写入 SPEC_MERGED
test-id-required规格已合并,但还没有可供切片的真实 UT-* / ST-* / SMOKE-* ID
ready-to-implement规格已合并;[code] 切片尚未规划,或已规划、停在 slice-exit 门等待批准
coding切片已批准(SLICES_APPROVED);[code] 任务尚未全部勾选
ready-to-verify[code] 任务已全部勾选(或没有 [code] 分节)——明确授权执行 openlogos verify
verify-passedopenlogos verify 通过(VERIFY_PASS),且无需部署
verify-failedopenlogos verify 失败(VERIFY_FAIL)
ready-to-deploy验收通过且提案需要部署——部署须由人类明确授权
deploy-done已用 openlogos deploy-done 记录部署完成,且无需 smoke
ready-to-smoke已部署;明确授权执行 openlogos smoke
smoke-passed / smoke-failedopenlogos smoke 的结果(SMOKE_PASS / SMOKE_FAIL)
merge-generated仅历史遗留:提案目录中仍带有 0.15 之前的合并标记且 SPEC_MERGED 不存在时出现。现行 openlogos merge 不会产生该步骤;直接运行 openlogos merge <slug> 完成合并即可

merge 是一次原子调用,因此没有「合并进行中」的中间步骤:SPEC_MERGED 写入后,提案直接从 ready-to-merge(或 spec-complete-required)进入 test-id-required / ready-to-implement。

提案写入 SPEC_MERGED 后,openlogos status --format json 会增加只读对象 modules[].active_change.spec_amend(合并之前不出现):

字段含义
merged_delta_digest / current_delta_digest上次合并时与当前的 delta 摘要
pendingdelta 自上次合并后有变化时为 true——重跑 openlogos merge <slug> 即做增量修正(result:"amended")。没有合并基线时为 null,表示「无法判断」,不能当作 false
blocked_reason修正会被拒绝的原因:drift、baseline-missing、baseline-unreadable、create-withdraw、prototype-changed;否则为 null
amend_count已应用的修正次数

该投影不写任何文件,也不改变 proposal_step。详见 openlogos merge。

项目存在 logos/environments.yaml 登记表时(见环境登记表),openlogos status --format json 新增三个顶层字段;没有登记表时都不出现。

字段含义
environments每个已登记环境一个视图,与 openlogos env list 的对象相同:id、name、tier、current_ref(最近一次成功部署且已确认的版本)、last_deploy、last_smoke(含 verified)。部署执行已启用时另有 previous_ref(回滚目标)、deploy_mode、deploy_in_progress;配置了晋级或审批门禁的环境另有 promote_from、require_approval、open_approvals、promotion
environment_ledger{ "path": "logos/.openlogos-runtime/deployments.jsonl", "corrupt_lines": 0 }——本机部署账本路径与跳过的坏行数
environment_registry_error仅在登记表存在但不合法时出现:{ "code": "ENV_REGISTRY_INVALID", "message": "…" };此时 environments 为 [],退出码不变
"environments": [
{
"id": "test", "name": "测试环境", "tier": "test",
"current_ref": "0235570…", "previous_ref": null,
"deploy_mode": "script", "deploy_in_progress": null,
"last_deploy": { "deploy_id": "7652a96b…", "result": "done", "channel": "proposal", "mode": "script", "ref": "0235570…", … },
"last_smoke": { "result": "pass", "env_evidence": "declared", "verified": true, … }
}
]

status 只读取登记表与账本,不发起任何网络请求。

错误原因解决方法
logos/logos.config.json not found不在项目根目录cd 到项目根目录,或先运行 openlogos init
Module 'admin' not found in logos-project.yaml--module 的值与任何已注册模块都不匹配运行 openlogos module list 查看有效的模块 ID
  • init — 创建 status 所检查的项目结构
  • module — 管理模块(list / add / rename / remove)
  • launch — 激活变更管理(所有阶段完成时建议)
  • verify — 运行 Gate 3.6 验收(Phase 3-6)