@miniidealab/openlogos 0.7.3 → 0.8.1

package/dist/lib/migrate-lifecycle.js

@@ -0,0 +1,55 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+/**
+ * Detects old config.lifecycle === 'active' with no launched modules.
+ * Single-module: auto-marks it as launched and returns autoMarked.
+ * Multi-module: emits a warning and returns warned=true.
+ * Called by both sync and launch before deriving isLaunched.
+ */
+export function migrateProjectLifecycle(root) {
+    const configPath = join(root, 'logos', 'logos.config.json');
+    if (!existsSync(configPath))
+        return { migrated: false };
+    let config;
+    try {
+        config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        return { migrated: false };
+    }
+    if (config['lifecycle'] !== 'active')
+        return { migrated: false };
+    const yamlPath = join(root, 'logos', 'logos-project.yaml');
+    if (!existsSync(yamlPath))
+        return { migrated: false };
+    let yaml;
+    try {
+        yaml = parseYaml(readFileSync(yamlPath, 'utf-8')) ?? {};
+    }
+    catch {
+        return { migrated: false };
+    }
+    const modules = Array.isArray(yaml['modules'])
+        ? yaml['modules']
+        : [];
+    const hasLaunched = modules.some(m => m.lifecycle === 'launched');
+    if (hasLaunched)
+        return { migrated: false };
+    if (modules.length === 1) {
+        modules[0].lifecycle = 'launched';
+        writeFileSync(yamlPath, stringifyYaml(yaml, { lineWidth: 0 }));
+        // Remove stale project-level lifecycle field
+        delete config['lifecycle'];
+        writeFileSync(configPath, JSON.stringify(config, null, 2));
+        return { migrated: true, autoMarked: modules[0].id };
+    }
+    if (modules.length > 1) {
+        // Remove stale project-level lifecycle field even in multi-module case
+        delete config['lifecycle'];
+        writeFileSync(configPath, JSON.stringify(config, null, 2));
+        return { migrated: true, warned: true };
+    }
+    return { migrated: false };
+}
+//# sourceMappingURL=migrate-lifecycle.js.map

package/dist/lib/migrate-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-lifecycle.js","sourceRoot":"","sources":["../../src/lib/migrate-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAQtE;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAExD,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAEjE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAEtD,IAAI,IAA6B,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC,CAAE,IAAI,CAAC,SAAS,CAA+C;QAChE,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC;IAClE,IAAI,WAAW;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAE5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,UAAU,CAAC;QAClC,aAAa,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/D,6CAA6C;QAC7C,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3B,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,uEAAuE;QACvE,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3B,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/lib/sync-resource-index.js

@@ -50,19 +50,19 @@ function scanCandidateFiles(root) {
 const RULES = [
     // 1. 场景总览（放在场景文件之前，更具体）
     {
-        pattern: /logos\/resources\/prd\/3-technical-plan\/2-scenario-implementation\/00-scenario-overview\.md$/,
+        pattern: /logos\/resources\/prd\/3-technical-plan\/2-scenario-implementation\/(?:[a-z][a-z0-9-]*-)?00-scenario-overview\.md$/,
         zh: () => '场景实现概览索引。涉及全量场景分类、参与方、实现文档映射关系时必读。',
         en: () => 'Scenario overview index. Required when referencing scenario classification, participants, or document mapping.',
     },
-    // 2. 场景时序图：S01-cli-init.md → S01 场景时序图
+    // 2. 场景时序图：core-S01-cli-init.md → S01 场景时序图
     {
-        pattern: /logos\/resources\/prd\/3-technical-plan\/2-scenario-implementation\/(S\d+)-(.+)\.md$/,
+        pattern: /logos\/resources\/prd\/3-technical-plan\/2-scenario-implementation\/(?:[a-z][a-z0-9-]*-)?(S\d+)-(.+)\.md$/,
         zh: (m) => `${m[1]} 场景时序图。涉及 ${m[1]} 实现细节、API 设计、异常分支时必读。`,
         en: (m) => `${m[1]} sequence diagram. Required when working on ${m[1]} implementation, API design, or exception branches.`,
     },
-    // 3. 测试用例：S01-test-cases.md → S01 测试用例
+    // 3. 测试用例：core-S01-test-cases.md → S01 测试用例
     {
-        pattern: /logos\/resources\/test\/(S\d+)-test-cases\.md$/,
+        pattern: /logos\/resources\/test\/(?:[a-z][a-z0-9-]*-)?(S\d+)-test-cases\.md$/,
         zh: (m) => `${m[1]} 测试用例。涉及 ${m[1]} 单元测试与场景测试的实现与验收时必读。`,
         en: (m) => `${m[1]} test cases. Required when implementing or verifying ${m[1]} unit and scenario tests.`,
     },

package/dist/lib/sync-resource-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync-resource-index.js","sourceRoot":"","sources":["../../src/lib/sync-resource-index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sync-resource-index.js","sourceRoot":"","sources":["../../src/lib/sync-resource-index.ts"],"names":[],"mappings":"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"}

package/opencode-plugin-template/commands/openlogos-launch.md

@@ -1,9 +1,14 @@
 ---
-description: "OpenLogos — activate change management after first cycle / 首轮完成后激活变更管理"
+description: "OpenLogos — launch a module into change-management mode / 将模块切换到变更管理阶段"
 ---
 
 在项目根执行：
 
-!`openlogos launch`
+!`openlogos launch $ARGUMENTS`
 
-向用户解释 lifecycle 已切换为 active 及后续需使用 `change` / `merge` / `archive` 工作流。
+（若项目只有一个模块，可不传参数，CLI 自动识别；多模块时需传 module-id，例如 `/openlogos-launch core`。）
+
+向用户解释：
+- 指定模块的 `lifecycle` 已切换为 `launched`
+- 后续对该模块的修改必须先通过 `openlogos change <slug>` 创建变更提案
+- 使用 `change` / `merge` / `archive` 工作流推进迭代

package/opencode-plugin-template/openlogos.js

@@ -12,7 +12,7 @@ const COMMANDS = {
   next: { cli: ["status"], args: "none" },
   sync: { cli: ["sync"], args: "none" },
   verify: { cli: ["verify"], args: "none" },
-  launch: { cli: ["launch"], args: "none" },
+  launch: { cli: ["launch"], args: "optionalModuleId" },
   init: { cli: ["init"], args: "optionalName" },
   change: { cli: ["change"], args: "requiredSlug" },
   merge: { cli: ["merge"], args: "requiredSlug" },
@@ -34,6 +34,15 @@ function parse(raw) {
   if (spec.args === "none" && rest.length > 0) {
     return { matched: true, ok: false, code: "E_ARG_INVALID", message: `${name} 不接受参数` };
   }
+  if (spec.args === "optionalModuleId") {
+    if (rest.length > 1) {
+      return { matched: true, ok: false, code: "E_ARG_INVALID", message: `${name} 只接受 0 或 1 个参数（module-id）` };
+    }
+    if (rest.length === 1 && !SLUG_RE.test(rest[0])) {
+      return { matched: true, ok: false, code: "E_ARG_INVALID", message: `${name} 的 module-id 必须为合法 slug（小写字母/数字/连字符）` };
+    }
+    return { matched: true, ok: true, name, cliArgs: [...spec.cli, ...rest] };
+  }
   if (spec.args === "optionalName" && rest.length > 1) {
     return { matched: true, ok: false, code: "E_ARG_INVALID", message: "init 最多接受 1 个参数" };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miniidealab/openlogos",
-  "version": "0.7.3",
+  "version": "0.8.1",
   "description": "CLI tool for the OpenLogos software engineering methodology",
   "type": "module",
   "bin": {
@@ -8,8 +8,8 @@
   },
   "scripts": {
     "build": "npx tsc",
-    "prepack": "npm run build && node -e \"require('fs').cpSync('../skills','./skills',{recursive:true});require('fs').cpSync('../spec','./spec',{recursive:true});require('fs').cpSync('../plugin-opencode/template','./opencode-plugin-template',{recursive:true})\"",
-    "postpack": "node -e \"require('fs').rmSync('./skills',{recursive:true,force:true});require('fs').rmSync('./spec',{recursive:true,force:true});require('fs').rmSync('./opencode-plugin-template',{recursive:true,force:true})\"",
+    "prepack": "npm run build && node -e \"require('fs').cpSync('../skills','./skills',{recursive:true});require('fs').cpSync('../spec','./spec',{recursive:true});require('fs').cpSync('../plugin-opencode/template','./opencode-plugin-template',{recursive:true});require('fs').cpSync('../plugin-codex','./codex-plugin-template',{recursive:true})\"",
+    "postpack": "node -e \"require('fs').rmSync('./skills',{recursive:true,force:true});require('fs').rmSync('./spec',{recursive:true,force:true});require('fs').rmSync('./opencode-plugin-template',{recursive:true,force:true});require('fs').rmSync('./codex-plugin-template',{recursive:true,force:true})\"",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
     "lint": "eslint src/",
@@ -45,7 +45,8 @@
     "dist",
     "skills",
     "spec",
-    "opencode-plugin-template"
+    "opencode-plugin-template",
+    "codex-plugin-template"
   ],
   "devDependencies": {
     "@eslint/js": "^9.39.4",
@@ -54,5 +55,8 @@
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.58.0",
     "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "yaml": "^2.8.3"
   }
 }

package/skills/architecture-designer/SKILL.en.md

@@ -156,7 +156,7 @@ external_dependencies:
 
 ## Output Specification
 
-- Architecture overview document: `logos/resources/prd/3-technical-plan/1-architecture/01-architecture-overview.md`
+- Architecture overview document: `logos/resources/prd/3-technical-plan/1-architecture/core-01-architecture-overview.md` (globally unique; always update this file in place, never create a new one)
 - Architecture diagrams use Mermaid format
 - Technology selections use table format, each item must include rationale
 - Update the `tech_stack` and `external_dependencies` fields in `logos-project.yaml`

package/skills/architecture-designer/SKILL.md

@@ -156,7 +156,7 @@ external_dependencies:
 
 ## 输出规范
 
-- 架构概要文档：`logos/resources/prd/3-technical-plan/1-architecture/01-architecture-overview.md`
+- 架构概要文档：`logos/resources/prd/3-technical-plan/1-architecture/core-01-architecture-overview.md`（架构文件全局唯一，后续修改始终在此文件上更新，不新建文件）
 - 架构图使用 Mermaid 格式
 - 技术选型使用表格格式，每项必须有理由
 - 更新 `logos-project.yaml` 的 `tech_stack` 和 `external_dependencies` 字段

package/skills/prd-writer/SKILL.en.md

@@ -172,7 +172,7 @@ Because [reason] → leads to [pain point] → results in [consequence]
 
 - File format: Markdown
 - Storage location: `logos/resources/prd/1-product-requirements/`
-- File naming: `{sequence}-{english-name}.md`, e.g., `01-requirements.md`
+- File naming: `<module>-{sequence}-{english-name}.md`, e.g., `core-01-requirements.md` (read current module from `modules[]` in `logos-project.yaml`, default is `core`)
 - Every scenario must be traceable to at least one user pain point
 - P0/P1 scenarios must have GIVEN/WHEN/THEN (≥1 normal + ≥1 exception)
 - Scenario numbers are globally unique and will carry through Phase 2 and Phase 3

package/skills/prd-writer/SKILL.md

@@ -172,7 +172,7 @@
 
 - 文件格式：Markdown
 - 存放位置：`logos/resources/prd/1-product-requirements/`
-- 文件命名：`{序号}-{英文名}.md`，如 `01-requirements.md`
+- 文件命名：`<module>-{序号}-{英文名}.md`，如 `core-01-requirements.md`（从 `logos-project.yaml` 的 `modules[]` 读取当前模块，默认为 `core`）
 - 每个场景必须可追溯到至少一个用户痛点
 - P0/P1 场景必须有 GIVEN/WHEN/THEN（≥1 正常 + ≥1 异常）
 - 场景编号全局唯一，将贯穿 Phase 2 和 Phase 3

package/skills/product-designer/SKILL.en.md

@@ -202,7 +202,7 @@ This directory has already been initialized as an OpenLogos project.
 
 - Feature specs: `logos/resources/prd/2-product-design/1-feature-specs/`
 - Prototypes: `logos/resources/prd/2-product-design/2-page-design/`
-- Design documents and prototypes appear in pairs: `{number}-{name}-design.md` + `{number}-{name}-prototype.{ext}`
+- Design documents and prototypes appear in pairs: `<module>-{number}-{name}-design.md` + `<module>-{number}-{name}-prototype.{ext}` (read current module from `modules[]` in `logos-project.yaml`, default is `core`)
   - Web Application: `.html`
   - CLI Tool: `-terminal.md` (terminal interaction simulation)
   - AI Skills: `-dialogue.md` (dialogue flow script)

package/skills/product-designer/SKILL.md

@@ -202,7 +202,7 @@ This directory has already been initialized as an OpenLogos project.
 
 - 功能规格：`logos/resources/prd/2-product-design/1-feature-specs/`
 - 原型：`logos/resources/prd/2-product-design/2-page-design/`
-- 设计文档与原型成对出现：`{序号}-{名称}-design.md` + `{序号}-{名称}-prototype.{ext}`
+- 设计文档与原型成对出现：`<module>-{序号}-{名称}-design.md` + `<module>-{序号}-{名称}-prototype.{ext}`（从 `logos-project.yaml` 的 `modules[]` 读取当前模块，默认为 `core`）
   - Web 应用：`.html`
   - CLI 工具：`-terminal.md`（终端交互模拟）
   - AI Skills：`-dialogue.md`（对话流程脚本）

package/skills/scenario-architect/SKILL.en.md

@@ -197,8 +197,8 @@ Summarize the technical implementation status of all scenarios:
 
 ## Output Specification
 
-- **Scenario overview**: `logos/resources/prd/3-technical-plan/2-scenario-implementation/00-scenario-overview.md`
-- **Scenario documents**: `logos/resources/prd/3-technical-plan/2-scenario-implementation/{scenario-number}-{scenario-name}.md`
+- **Scenario overview**: `logos/resources/prd/3-technical-plan/2-scenario-implementation/core-00-scenario-overview.md`
+- **Scenario documents**: `logos/resources/prd/3-technical-plan/2-scenario-implementation/<module>-{scenario-number}-{scenario-name}.md` (read current module from `modules[]` in `logos-project.yaml`, default is `core`; read `scenario_counter.next_id` before generating, increment and write back immediately after)
 - Sequence diagrams use Mermaid format (renderable directly in Markdown)
 - Exception cases use `EX-N.M` numbering, globally unique
 - Each scenario document contains: sequence diagram + step descriptions + exception cases

package/skills/scenario-architect/SKILL.md

@@ -66,7 +66,7 @@
 
    只有用户明确确认清单无误后，才进入 Step 1 开始建模。
 
-2. 确认清单后，告知用户当前已完成哪些场景（`SXX-*.md` 文件存在），还剩哪些场景待建模，然后按用户指示开始目标场景的建模。
+2. 确认清单后，告知用户当前已完成哪些场景（`<module>-SXX-*.md` 文件存在），还剩哪些场景待建模，然后按用户指示开始目标场景的建模。
 
 ---
 
@@ -241,8 +241,8 @@ sequenceDiagram
 
 ## 输出规范
 
-- **场景概览**：`logos/resources/prd/3-technical-plan/2-scenario-implementation/00-scenario-overview.md`
-- **场景文档**：`logos/resources/prd/3-technical-plan/2-scenario-implementation/{场景编号}-{场景名}.md`
+- **场景概览**：`logos/resources/prd/3-technical-plan/2-scenario-implementation/core-00-scenario-overview.md`
+- **场景文档**：`logos/resources/prd/3-technical-plan/2-scenario-implementation/<module>-{场景编号}-{场景名}.md`（从 `logos-project.yaml` 的 `modules[]` 读取当前模块，默认为 `core`；生成前必须读取 `scenario_counter.next_id` 取号，生成后立即将 `next_id` 加 1 写回）
 - 时序图使用 Mermaid 格式（可在 Markdown 中直接渲染）
 - 异常用例使用 `EX-N.M` 编号，全局唯一
 - 每个场景文档包含：时序图 + 步骤说明 + 异常用例
@@ -274,9 +274,9 @@ sequenceDiagram
 ```yaml
 resource_index:
   # ...已有条目...
-  - path: logos/resources/prd/3-technical-plan/2-scenario-implementation/00-scenario-overview.md
+  - path: logos/resources/prd/3-technical-plan/2-scenario-implementation/core-00-scenario-overview.md
     desc: 场景实现概览索引。涉及全量场景分类、参与方、实现文档映射关系时必读。
-  - path: logos/resources/prd/3-technical-plan/2-scenario-implementation/S01-<slug>.md
+  - path: logos/resources/prd/3-technical-plan/2-scenario-implementation/core-S01-<slug>.md
     desc: S01 <场景名称>场景时序图。涉及 S01 实现细节、API 设计、异常分支时必读。
   # 每个场景文件均需单独一条
 ```

package/skills/test-writer/SKILL.en.md

@@ -167,7 +167,7 @@ Guide the user to the next step based on project type:
 
 - **File format**: Markdown
 - **Location**: `logos/resources/test/`
-- **Naming convention**: `{scenario-number}-test-cases.md` (e.g., `S01-test-cases.md`)
+- **Naming convention**: `<module>-{scenario-number}-test-cases.md` (e.g., `core-S01-test-cases.md`; read current module from `modules[]` in `logos-project.yaml`, default is `core`)
 - Each file contains: Unit test cases (grouped by source) + Scenario test cases (happy path + exception paths)
 - Case IDs are globally unique: `UT-{scenario-number}-{sequence}` / `ST-{scenario-number}-{sequence}`
 

package/skills/test-writer/SKILL.md

@@ -167,7 +167,7 @@
 
 - **文件格式**：Markdown
 - **存放位置**：`logos/resources/test/`
-- **命名规则**：`{场景编号}-test-cases.md`（如 `S01-test-cases.md`）
+- **命名规则**：`<module>-{场景编号}-test-cases.md`（如 `core-S01-test-cases.md`；从 `logos-project.yaml` 的 `modules[]` 读取当前模块，默认为 `core`）
 - 每个文件包含：单元测试用例（按来源分组）+ 场景测试用例（主路径 + 异常路径）
 - 用例 ID 全局唯一：`UT-{场景编号}-{序号}` / `ST-{场景编号}-{序号}`
 
@@ -253,7 +253,7 @@
 ```yaml
 resource_index:
   # ...已有条目...
-  - path: logos/resources/test/S01-test-cases.md
+  - path: logos/resources/test/core-S01-test-cases.md
     desc: S01 <场景名称>测试用例。涉及 UT-S01（单元测试）与 ST-S01（场景测试）的实现与验收时必读。
   # 每个场景的测试用例文件均需单独一条
 ```

package/spec/change-management.md

@@ -10,6 +10,7 @@
 2. **影响分析先行**：在 `proposal.md` 中明确变更范围
 3. **按需传播**：不是每次都全链路更新，只更新受影响的环节
 4. **归档留痕**：变更完成后归档，保留完整历史
+5. **guard 互斥**：同一时间只允许一个活动提案；存在活动 guard 时，必须阻止新的 `openlogos change`
 
 ## 目录结构
 
@@ -32,6 +33,8 @@ project-root/
             └── add-remember-me/
 ```
 
+> `logos/.openlogos-guard` 是活动提案锁文件。只要它指向 `logos/changes/` 下一个未归档提案，`openlogos change` 就必须拒绝创建新的提案，直到当前提案被 `openlogos archive` 归档后释放锁。
+
 ## 文件规范
 
 ### proposal.md
@@ -106,6 +109,7 @@ Delta 文件的目录结构映射主文档目录：
 1. 创建变更提案（CLI）
    └── openlogos change {slug}
    └── 生成 logos/changes/{slug}/proposal.md + tasks.md + deltas/
+   └── 写入 logos/.openlogos-guard，锁定当前活动提案
 
 2. AI 辅助填写提案（change-writer Skill）
    └── AI 分析影响范围，填写 proposal.md 和 tasks.md
@@ -126,6 +130,7 @@ Delta 文件的目录结构映射主文档目录：
 7. 归档变更（CLI）
    └── openlogos archive {slug}
    └── 将 logos/changes/{slug}/ 移入 logos/changes/archive/
+   └── 若当前 guard 指向该提案，则删除 logos/.openlogos-guard
 ```
 
 ## 变更传播规则

package/spec/cli-json-output.md

@@ -4,7 +4,7 @@
 
 ## 1. 概述
 
-OpenLogos CLI 的 `status`、`verify`、`detect` 三个命令支持 `--format json` 参数，输出结构化 JSON 供外部工具（如 RunLogos）以编程方式消费。
+OpenLogos CLI 的 `status`、`next`、`verify`、`detect` 四个命令支持 `--format json` 参数，输出结构化 JSON 供外部工具（如 RunLogos）以编程方式消费。
 
 ### 1.1 通用约定
 
@@ -21,7 +21,7 @@ OpenLogos CLI 的 `status`、`verify`、`detect` 三个命令支持 `--format js
 
 ```jsonc
 {
-  "command": "<command-name>",   // "status" | "verify" | "detect"
+  "command": "<command-name>",   // "status" | "next" | "verify" | "detect"
   "version": "<cli-version>",   // CLI 版本号，如 "0.5.9"
   "timestamp": "<ISO-8601>",    // 输出时间戳
   "data": { ... }               // 命令特定的数据负载
@@ -52,7 +52,7 @@ openlogos detect --format json  # JSON 格式
   "project": null | {             // null 表示当前目录不是 OpenLogos 项目
     "name": "my-project",         // 项目名
     "locale": "zh",               // 语言设置
-    "lifecycle": "active",        // "initial" | "active"
+    "lifecycle": "launched",        // "initial" | "launched"
     "description": "项目描述",     // 项目描述
     "source_roots": null | {      // 源代码根目录，null 表示未配置
       "src": ["src"],             // 业务代码根目录列表
@@ -98,7 +98,7 @@ openlogos status --format json  # JSON 格式
       "label": "Phase 1 · 需求文档 (WHY)",
       "done": true,
       "skipped": false,
-      "files": ["01-requirements.md"]
+      "files": ["core-01-requirements.md"]
     },
     {
       "key": "phase.2",
@@ -109,6 +109,43 @@ openlogos status --format json  # JSON 格式
     }
     // ... 所有 10 个 phase
   ],
+  "modules": [                      // 模块注册表（来自 logos-project.yaml）
+    {
+      "id": "core",
+      "name": "核心功能",
+      "lifecycle": "initial",       // "initial" | "launched"
+      "current_phase": "phase.3-2-api",  // 当前推进阶段 key；launched 模块为 null
+      "current_phase_label": "Phase 3.2 · API 设计",
+      "phase_progress": {           // 各阶段进度；launched 模块为 null
+        "phase.1": { "done": true, "skipped": false },
+        "phase.3-1": {
+          "done": false, "skipped": false,
+          "scenario_coverage": { "total": 3, "covered": 2, "missing": ["S03"] }
+        }
+      },
+      "active_change": null,        // 仅 launched 模块有值
+      "suggestion": "对 AI 说：「设计 API」"
+    },
+    {
+      "id": "payment",
+      "name": "支付模块",
+      "lifecycle": "launched",
+      "current_phase": null,
+      "current_phase_label": null,
+      "phase_progress": null,
+      "active_change": {            // 当前活跃变更提案
+        "slug": "add-refund",
+        "proposal_step": "implementing",  // "writing"|"implementing"|"in-progress"|"ready-to-merge"
+        "proposal_step_label": "实现中",
+        "has_proposal": true,
+        "has_tasks": true,
+        "tasks_checked": 2,
+        "tasks_total": 5,
+        "delta_count": 1
+      },
+      "suggestion": "继续实现 add-refund，完成后运行 openlogos merge add-refund"
+    }
+  ],
   "active_proposals": [
     {
       "name": "add-feature",
@@ -120,7 +157,7 @@ openlogos status --format json  # JSON 格式
   "current_phase": "phase.2",      // 第一个未完成 phase 的 key，若全部完成则为 null
   "suggestion": "对 AI 说：「基于需求文档做产品设计」",  // 建议的下一步操作
   "all_done": false,               // 是否所有 phase 都已完成
-  "lifecycle": "active",           // 项目生命周期
+  "lifecycle": "launched",          // 项目生命周期，派生值："initial" | "launched"
   "source_roots": null | {         // 源代码根目录，null 表示未配置
     "src": ["src"],
     "test": ["test"]
@@ -138,6 +175,26 @@ openlogos status --format json  # JSON 格式
 | `phases[].done` | boolean | 是 | 该阶段是否已完成（有文件 = true） |
 | `phases[].skipped` | boolean | 是 | 该阶段是否被跳过（空但后续阶段已完成） |
 | `phases[].files` | string[] | 是 | 该阶段目录下的文件列表 |
+| `modules` | array | 否 | 模块注册表；`logos-project.yaml` 无 `modules[]` 时省略此字段（向下兼容） |
+| `modules[].id` | string | 是 | 模块标识符 |
+| `modules[].name` | string | 是 | 模块名称 |
+| `modules[].lifecycle` | string | 是 | 模块生命周期：`"initial"` 或 `"launched"` |
+| `modules[].current_phase` | string \| null | 是 | 当前推进阶段 key；`launched` 模块为 null |
+| `modules[].current_phase_label` | string \| null | 是 | 当前阶段本地化标签；`launched` 模块为 null |
+| `modules[].phase_progress` | object \| null | 是 | 各阶段进度 map（key = phase key）；`launched` 模块为 null |
+| `modules[].phase_progress[key].done` | boolean | 是 | 该阶段是否已完成 |
+| `modules[].phase_progress[key].skipped` | boolean | 是 | 该阶段是否被跳过 |
+| `modules[].phase_progress[key].scenario_coverage` | object \| undefined | 否 | 仅场景类阶段（`phase.3-1`、`phase.3-3a`）存在 |
+| `modules[].active_change` | object \| null | 是 | 当前活跃变更提案；`initial` 模块或无活跃提案时为 null |
+| `modules[].active_change.slug` | string | 是 | 提案 slug |
+| `modules[].active_change.proposal_step` | string | 是 | 提案阶段：`"writing"` \| `"implementing"` \| `"in-progress"` \| `"ready-to-merge"` |
+| `modules[].active_change.proposal_step_label` | string | 是 | 提案阶段本地化标签 |
+| `modules[].active_change.has_proposal` | boolean | 是 | 是否存在 proposal.md |
+| `modules[].active_change.has_tasks` | boolean | 是 | 是否存在 tasks.md |
+| `modules[].active_change.tasks_checked` | number | 是 | 已勾选任务数 |
+| `modules[].active_change.tasks_total` | number | 是 | 总任务数 |
+| `modules[].active_change.delta_count` | number | 是 | deltas 目录下的文件数 |
+| `modules[].suggestion` | string | 是 | 针对该模块的下一步建议（本地化文本） |
 | `active_proposals` | array | 是 | 活跃变更提案列表 |
 | `active_proposals[].name` | string | 是 | 提案目录名 |
 | `active_proposals[].has_proposal` | boolean | 是 | 是否存在 proposal.md |
@@ -146,7 +203,7 @@ openlogos status --format json  # JSON 格式
 | `current_phase` | string \| null | 是 | 当前应推进的阶段 key；全部完成时为 null |
 | `suggestion` | string | 是 | 建议的下一步操作（本地化文本） |
 | `all_done` | boolean | 是 | 是否全部阶段已完成（skipped 阶段不阻塞） |
-| `lifecycle` | string | 是 | 项目生命周期（`initial` 或 `active`） |
+| `lifecycle` | string | 是 | 项目生命周期（`initial` 或 `launched`，由模块状态派生） |
 | `source_roots` | object \| null | 是 | 源代码根目录配置；未配置时为 null |
 
 ---

package/spec/codex-plugin.md

@@ -0,0 +1,138 @@
+# Codex 原生插件规范（OpenLogos）
+
+> 版本：0.1.0（草案）
+>
+> 本文档定义 OpenLogos 在 OpenAI Codex CLI 平台上的原生插件方案，目标是把当前"AGENTS 兼容模式"升级为"插件优先 + 文档兜底"的双轨机制。
+
+## 目标
+
+1. 提供与 Claude Code 插件接近的交互体验（SessionStart hook + Phase 上下文注入）
+2. 最大化复用现有 CLI（`openlogos *`）与 Skills（`logos/skills/*`）
+3. 保留 `AGENTS.md` 兜底，确保插件不可用时流程不中断
+
+## 运行模式
+
+### 模式 A：兼容模式（当前可用）
+
+- 输入：`AGENTS.md` + `logos/skills/*/SKILL.md`
+- 适用：未安装插件或插件异常时
+- 特点：零额外安装，体验相对基础
+
+### 模式 B：原生插件模式（推荐）
+
+- 输入：`openlogos init/sync` 自动生成的 `.codex-plugin/plugin.json`、`.codex-plugin/hooks/session-start.sh`、`.codex/config.toml`
+- 适用：希望获得 SessionStart Phase 注入、技能自动加载、统一工作流控制
+- 特点：体验增强，便于分发与版本管理
+
+## 与其他工具的对比
+
+| 维度 | Claude Code | OpenCode | Codex |
+|---|---|---|---|
+| 指令文件 | `CLAUDE.md` | `AGENTS.md` | `AGENTS.md` |
+| 技能路径 | `logos/skills/` | `logos/skills/` | `.agents/skills/<name>/SKILL.md` |
+| 插件清单 | `plugin/` 目录 | `.opencode/plugins/openlogos.js` | `.codex-plugin/plugin.json` |
+| 配置文件 | `.claude/settings.json` | `opencode.json` | `.codex/config.toml` |
+| Hook 协议 | stdin/stdout JSON | 事件驱动 JS | stdin/stdout JSON（同 Claude Code） |
+| 技能调用语法 | `/skill-name` | `/openlogos:*` | `$skill-name` |
+| SessionStart | `hooks.json` | `session.created` | `[[hooks.SessionStart]]` |
+
+## 目录结构
+
+```text
+openlogos/
+├── plugin-codex/
+│   ├── plugin.json            # 插件清单模板
+│   └── session-start.sh       # SessionStart hook 脚本模板
+└── spec/codex-plugin.md       # 本规范文档
+```
+
+用户项目部署后：
+
+```text
+<user-project>/
+├── .agents/
+│   └── skills/
+│       ├── prd-writer/SKILL.md
+│       ├── scenario-architect/SKILL.md
+│       └── ... (全部 13 个 skill)
+├── .codex-plugin/
+│   ├── plugin.json
+│   └── hooks/
+│       └── session-start.sh
+├── .codex/
+│   └── config.toml
+└── AGENTS.md                  # 兜底指令（始终保留）
+```
+
+## 构建与发布边界
+
+1. 插件模板随 `@miniidealab/openlogos`（CLI 单包）一起发布，不单独发布 Codex 插件包。
+2. 插件只负责"Hook 注入 + 上下文注入"，不复制 CLI 业务逻辑。
+3. 版本策略：
+   - 插件模板版本与 CLI 版本保持同步
+   - 当依赖 CLI 新参数/新输出时，在同一 CLI 版本内联动升级
+4. 发布产物包含 `codex-plugin-template/`（由构建脚本从 `plugin-codex/` 生成），由 `init/sync` 自动部署到用户项目。
+
+## Hook 事件模型（MVP）
+
+### `SessionStart`
+
+Codex 支持的 SessionStart 输出字段：`systemMessage`、`stopReason`。
+
+执行顺序：
+
+1. 检查项目是否已初始化（`logos/logos.config.json`）
+2. 调用 `openlogos status --format json` 获取当前 Phase 和建议
+3. 读取 guard 文件检测活跃变更提案
+4. 构建 `systemMessage`：包含当前 Phase、变更管理状态、语言策略
+5. 注入失败时静默返回 `{}`，不阻断会话
+
+### Hook 脚本降级策略
+
+| 场景 | 行为 |
+|---|---|
+| `openlogos` CLI 不在 PATH | 静默返回 `{}`，不阻断会话 |
+| 项目未初始化（无 logos.config.json） | 静默返回 `{}` |
+| `openlogos status` 非 0 退出 | 静默返回 `{}` |
+| Python3 和 Node 均不可用 | 输出简化 `systemMessage`（无 JSON 解析） |
+
+## 命令调用
+
+Codex 使用 `$skill-name` 语法调用技能（不同于 Claude Code 的 `/skill-name`）。`AGENTS.md` 中的 Active Skills 章节应使用 `$` 前缀说明。
+
+## 配置格式（`.codex/config.toml`）
+
+```toml
+[plugins.openlogos]
+enabled = true
+
+[[hooks.SessionStart]]
+[[hooks.SessionStart.hooks]]
+type = "command"
+command = ".codex-plugin/hooks/session-start.sh"
+timeout = 5
+async = false
+statusMessage = "Loading OpenLogos phase context..."
+```
+
+## 安全边界
+
+1. **最小权限原则**：hook 脚本只读取项目状态，不修改任何文件
+2. **路径约束**：仅在工作区内执行，不允许跨目录写入
+3. **错误可观测性**：所有 CLI 失败静默降级，不阻断会话
+4. **降级策略**：插件不可用时，回退到 `AGENTS.md` 兼容模式
+
+## 双轨策略
+
+| 模式 | 配置 | 技能来源 | CLI 桥接 |
+|---|---|---|---|
+| **兼容**（兜底） | `AGENTS.md` only | `logos/skills/` | 无 |
+| **原生插件**（推荐） | `.codex-plugin/` + `.codex/config.toml` | `.agents/skills/` | `session-start.sh` → `openlogos status` |
+
+原生插件模式为推荐路径。`AGENTS.md` 始终保留作为降级兜底。
+
+## 验收标准（文档阶段）
+
+- `README.md` 已包含 Codex 原生插件安装说明
+- `spec/agents-md.md` 已明确双轨模式包含 Codex
+- 本文档定义了插件边界、事件、安全策略与双轨策略