@miniidealab/openlogos 0.7.2 → 0.8.0

package/codex-plugin-template/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "openlogos",
+  "version": "1.0.0",
+  "description": "OpenLogos methodology — Why→What→How structured AI-driven development",
+  "interface": {
+    "display_name": "OpenLogos",
+    "short_description": "Structured development: PRD → Design → Scenarios → API → Code",
+    "default_prompt": ["What should I do next in the OpenLogos workflow?"]
+  }
+}

package/codex-plugin-template/session-start.sh

@@ -0,0 +1,125 @@
+#!/usr/bin/env bash
+# OpenLogos Codex Plugin — SessionStart hook
+# Injects current phase and next-step context into the Codex session.
+# Falls back silently (returns {}) if the CLI is unavailable or project is not initialized.
+#
+# Output format: {"systemMessage": "...", "hookSpecificOutput": {"hookEventName": "SessionStart", "additionalContext": "..."}}
+# Codex uses systemMessage; additionalContext is included for forward compatibility.
+
+set -euo pipefail
+
+if ! command -v openlogos &>/dev/null; then
+  echo "{}"
+  exit 0
+fi
+
+if [ ! -f "logos/logos.config.json" ]; then
+  echo "{}"
+  exit 0
+fi
+
+STATUS=$(openlogos status --format json 2>/dev/null) || { echo "{}"; exit 0; }
+
+# Parse JSON using python3 (preferred) or node
+_py_parse() {
+  python3 -c "import sys,json; d=json.load(sys.stdin); $1" 2>/dev/null || echo "$2"
+}
+_node_parse() {
+  node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{try{const r=JSON.parse(d);$1}catch(e){process.stdout.write('$2')}})" 2>/dev/null || echo "$2"
+}
+
+if command -v python3 &>/dev/null; then
+  LOCALE=$(python3 -c "import json; d=json.load(open('logos/logos.config.json')); print(d.get('locale','en'))" 2>/dev/null || echo "en")
+  LIFECYCLE=$(python3 -c "import json; d=json.load(open('logos/logos.config.json')); print(d.get('lifecycle','initial'))" 2>/dev/null || echo "initial")
+  PROJECT_NAME=$(python3 -c "import json; d=json.load(open('logos/logos.config.json')); print(d.get('name',''))" 2>/dev/null || echo "")
+  CURRENT_PHASE=$(echo "$STATUS" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('data',{}).get('current_phase') or 'all-done')" 2>/dev/null || echo "unknown")
+  SUGGESTION=$(echo "$STATUS" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('data',{}).get('suggestion','Run openlogos status for next steps'))" 2>/dev/null || echo "")
+  ALL_DONE=$(echo "$STATUS" | python3 -c "import sys,json; d=json.load(sys.stdin); print('true' if d.get('data',{}).get('all_done') else 'false')" 2>/dev/null || echo "false")
+elif command -v node &>/dev/null; then
+  LOCALE=$(node -e "const d=JSON.parse(require('fs').readFileSync('logos/logos.config.json','utf-8')); console.log(d.locale||'en')" 2>/dev/null || echo "en")
+  LIFECYCLE=$(node -e "const d=JSON.parse(require('fs').readFileSync('logos/logos.config.json','utf-8')); console.log(d.lifecycle||'initial')" 2>/dev/null || echo "initial")
+  PROJECT_NAME=$(node -e "const d=JSON.parse(require('fs').readFileSync('logos/logos.config.json','utf-8')); console.log(d.name||'')" 2>/dev/null || echo "")
+  CURRENT_PHASE=$(echo "$STATUS" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{try{const r=JSON.parse(d);console.log((r.data||{}).current_phase||'all-done')}catch(e){console.log('unknown')}})" 2>/dev/null || echo "unknown")
+  SUGGESTION=$(echo "$STATUS" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{try{const r=JSON.parse(d);console.log((r.data||{}).suggestion||'')}catch(e){console.log('')}})" 2>/dev/null || echo "")
+  ALL_DONE=$(echo "$STATUS" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{try{const r=JSON.parse(d);console.log((r.data||{}).all_done?'true':'false')}catch(e){console.log('false')}})" 2>/dev/null || echo "false")
+else
+  echo "{}"
+  exit 0
+fi
+
+# Language policy
+if [ "$LOCALE" = "zh" ]; then
+  LANG_POLICY="Language Policy: ALL output MUST be in Chinese (中文)."
+else
+  LANG_POLICY="Language Policy: ALL output MUST be in English."
+fi
+
+# Change management status
+GUARD_FILE="logos/.openlogos-guard"
+CHANGE_MGMT=""
+GUARD_STATUS=""
+
+if [ "$LIFECYCLE" = "active" ] && [ -f "$GUARD_FILE" ]; then
+  if command -v python3 &>/dev/null; then
+    ACTIVE_CHANGE=$(python3 -c "import json; d=json.load(open('$GUARD_FILE')); print(d.get('activeChange',''))" 2>/dev/null || echo "")
+  elif command -v node &>/dev/null; then
+    ACTIVE_CHANGE=$(node -e "const d=JSON.parse(require('fs').readFileSync('$GUARD_FILE','utf-8')); console.log(d.activeChange||'')" 2>/dev/null || echo "")
+  else
+    ACTIVE_CHANGE=""
+  fi
+
+  if [ -n "$ACTIVE_CHANGE" ]; then
+    GUARD_STATUS="🔓 Active change: $ACTIVE_CHANGE"
+    CHANGE_MGMT="Change Management: ACTIVE — guard file detected. Active change proposal: '$ACTIVE_CHANGE'. Only modify files within the scope of logos/changes/$ACTIVE_CHANGE/proposal.md. When done, run openlogos merge $ACTIVE_CHANGE then openlogos archive $ACTIVE_CHANGE."
+  else
+    GUARD_STATUS="⛔ NO active change proposal"
+    CHANGE_MGMT="Change Management: ACTIVE — ⛔ NO guard file found. Before modifying ANY source code, you MUST first run openlogos change <slug> to create a change proposal."
+  fi
+elif [ "$LIFECYCLE" = "active" ]; then
+  GUARD_STATUS="⛔ NO active change proposal"
+  CHANGE_MGMT="Change Management: ACTIVE — ⛔ NO guard file found. Before modifying ANY source code, you MUST first run openlogos change <slug> to create a change proposal."
+else
+  CHANGE_MGMT="Change Management: Initial development — follow Phase progression, no change proposals needed."
+fi
+
+# Build system message
+if [ "$ALL_DONE" = "true" ]; then
+  STATUS_LINE="📊 OpenLogos: All phases complete"
+elif [ -n "$GUARD_STATUS" ]; then
+  STATUS_LINE="📊 OpenLogos: $CURRENT_PHASE | $GUARD_STATUS"
+else
+  STATUS_LINE="📊 OpenLogos: $CURRENT_PHASE"
+fi
+
+# Build additional context
+CONTEXT="=== OpenLogos Project Context ===
+Project: $PROJECT_NAME
+Locale: $LOCALE
+Lifecycle: $LIFECYCLE
+Current Phase: $CURRENT_PHASE
+Suggested Next: $SUGGESTION
+$LANG_POLICY
+$CHANGE_MGMT
+=== End OpenLogos Context ==="
+
+# JSON-escape context and status line
+if command -v python3 &>/dev/null; then
+  CONTEXT_ESCAPED=$(printf '%s' "$CONTEXT" | python3 -c "import sys,json; print(json.dumps(sys.stdin.read()))" 2>/dev/null || echo '""')
+  SYS_MSG_ESCAPED=$(printf '%s' "$STATUS_LINE" | python3 -c "import sys,json; s=sys.stdin.read(); print(json.dumps(s)[1:-1])" 2>/dev/null || echo "$STATUS_LINE")
+elif command -v node &>/dev/null; then
+  CONTEXT_ESCAPED=$(printf '%s' "$CONTEXT" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>console.log(JSON.stringify(d)))" 2>/dev/null || echo '""')
+  SYS_MSG_ESCAPED=$(printf '%s' "$STATUS_LINE" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const s=JSON.stringify(d);process.stdout.write(s.slice(1,-1))})" 2>/dev/null || echo "$STATUS_LINE")
+else
+  CONTEXT_ESCAPED='""'
+  SYS_MSG_ESCAPED="$STATUS_LINE"
+fi
+
+cat <<ENDJSON
+{
+  "systemMessage": "$SYS_MSG_ESCAPED",
+  "hookSpecificOutput": {
+    "hookEventName": "SessionStart",
+    "additionalContext": $CONTEXT_ESCAPED
+  }
+}
+ENDJSON

package/dist/commands/change.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../../src/commands/change.ts"],"names":[],"mappings":"AAIA,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,QAwDnC"}
+{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../../src/commands/change.ts"],"names":[],"mappings":"AAIA,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,QA0EnC"}

package/dist/commands/change.js

@@ -1,4 +1,4 @@
-import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { mkdirSync, writeFileSync, existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { readLocale, t, proposalTemplate, tasksTemplate } from '../i18n.js';
 export function change(slug) {
@@ -16,11 +16,30 @@ export function change(slug) {
         process.exit(1);
     }
     const changePath = join(root, 'logos', 'changes', slug);
+    const locale = readLocale(root);
     if (existsSync(changePath)) {
         console.error(`Error: Change proposal '${slug}' already exists.`);
         process.exit(1);
     }
-    const locale = readLocale(root);
+    const guardPath = join(root, 'logos', '.openlogos-guard');
+    if (existsSync(guardPath)) {
+        try {
+            const guard = JSON.parse(readFileSync(guardPath, 'utf-8'));
+            const activeChange = typeof guard.activeChange === 'string' ? guard.activeChange : null;
+            const activeChangePath = activeChange ? join(root, 'logos', 'changes', activeChange) : null;
+            const archivedChangePath = activeChange ? join(root, 'logos', 'changes', 'archive', activeChange) : null;
+            if (activeChange && activeChangePath && archivedChangePath && existsSync(activeChangePath) && !existsSync(archivedChangePath)) {
+                console.error(t(locale, 'change.guardConflict', { activeChange }));
+                console.error(t(locale, 'change.guardConflictHint', { activeChange }));
+                process.exit(1);
+            }
+        }
+        catch {
+            console.error(t(locale, 'change.guardInvalid'));
+            console.error(t(locale, 'change.guardInvalidHint'));
+            process.exit(1);
+        }
+    }
     console.log(`\n${t(locale, 'change.creating', { slug })}\n`);
     const deltaDirs = ['deltas/prd', 'deltas/api', 'deltas/database', 'deltas/scenario'];
     mkdirSync(changePath, { recursive: true });
@@ -32,7 +51,6 @@ export function change(slug) {
     writeFileSync(join(changePath, 'tasks.md'), tasksTemplate(locale));
     console.log(`  ✓ logos/changes/${slug}/tasks.md`);
     console.log(`  ✓ logos/changes/${slug}/deltas/`);
-    const guardPath = join(root, 'logos', '.openlogos-guard');
     const guard = JSON.stringify({
         activeChange: slug,
         createdAt: new Date().toISOString(),

package/dist/commands/change.js.map

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

package/dist/commands/init.d.ts

@@ -1,5 +1,5 @@
 import { type Locale } from '../i18n.js';
-export type AiTool = 'claude-code' | 'opencode' | 'cursor' | 'other' | 'all';
+export type AiTool = 'claude-code' | 'opencode' | 'codex' | 'cursor' | 'other' | 'all';
 type NameSource = 'argument' | 'package.json' | 'Cargo.toml' | 'pyproject.toml' | 'directory';
 interface NameResult {
     name: string;
@@ -11,6 +11,14 @@ export declare const SKILL_NAMES: readonly ["project-init", "prd-writer", "produ
 export declare function findSkillsSource(): string | null;
 export declare function findSpecSource(): string | null;
 export declare function findOpenCodePluginTemplateSource(): string | null;
+export declare function findCodexPluginTemplateSource(): string | null;
+export declare function deployCodexPlugin(root: string, locale?: Locale): {
+    target: string;
+    config: {
+        created: boolean;
+        updated: boolean;
+    };
+} | null;
 export declare function deployOpenCodePlugin(root: string, locale?: Locale): {
     target: string;
     config: {

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAiD,MAAM,YAAY,CAAC;AAExF,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAE7E,KAAK,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAE9F,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA+B9D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAI1D;AAsFD,eAAO,MAAM,WAAW,uPAcd,CAAC;AAkBX,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAahD;AAED,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAW9C;AAED,wBAAgB,gCAAgC,IAAI,MAAM,GAAG,IAAI,CAahE;AAuDD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6BzK;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAalE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,SAAqB,GAAG,MAAM,CAkE1F;AAYD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAa,EACrB,SAAS,GAAE,SAAqB,EAChC,YAAY,CAAC,EAAE,MAAM,GACpB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkC1C;AA0ID,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAiB,GAAG,MAAM,CA4DjG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYvE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,SAAS,GAAE,SAAqB,GAAG,MAAM,CAoJtI;AAED,wBAAsB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,iBA4FvF"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAiD,MAAM,YAAY,CAAC;AAExF,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAEvF,KAAK,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAE9F,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA+B9D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAI1D;AAwFD,eAAO,MAAM,WAAW,uPAcd,CAAC;AAkBX,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAahD;AAED,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAW9C;AAED,wBAAgB,gCAAgC,IAAI,MAAM,GAAG,IAAI,CAahE;AAED,wBAAgB,6BAA6B,IAAI,MAAM,GAAG,IAAI,CAa7D;AAqCD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAAG,IAAI,CAyBhJ;AAuDD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6BzK;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAalE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,SAAqB,GAAG,MAAM,CAkE1F;AAYD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAa,EACrB,SAAS,GAAE,SAAqB,EAChC,YAAY,CAAC,EAAE,MAAM,GACpB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgD1C;AA+KD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAiB,GAAG,MAAM,CA4DjG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAqBvE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,SAAS,GAAE,SAAqB,GAAG,MAAM,CAoJtI;AAED,wBAAsB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,iBAwGvF"}

package/dist/commands/init.js

@@ -1,4 +1,4 @@
-import { mkdirSync, writeFileSync, readFileSync, existsSync, copyFileSync, readdirSync } from 'node:fs';
+import { mkdirSync, writeFileSync, readFileSync, existsSync, copyFileSync, readdirSync, chmodSync } from 'node:fs';
 import { join, basename, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { createInterface } from 'node:readline';
@@ -84,7 +84,7 @@ async function chooseLocale() {
     if (!isTTY()) {
         console.error('Error: --locale is required in non-interactive mode.');
         console.error('');
-        console.error('Usage: openlogos init --locale <en|zh> [--ai-tool <claude-code|opencode|cursor|other>] [name]');
+        console.error('Usage: openlogos init --locale <en|zh> [--ai-tool <claude-code|opencode|codex|cursor|other|all>] [name]');
         console.error('');
         console.error('Ask the user to choose a language first:');
         console.error('  --locale en    English');
@@ -103,6 +103,7 @@ async function chooseAiTool(locale) {
     console.log(`\n${t(locale, 'init.aiToolHeader')}`);
     console.log(t(locale, 'init.aiToolClaudeCode'));
     console.log(t(locale, 'init.aiToolOpenCode'));
+    console.log(t(locale, 'init.aiToolCodex'));
     console.log(t(locale, 'init.aiToolCursor'));
     console.log(t(locale, 'init.aiToolOther'));
     console.log(t(locale, 'init.aiToolAll') + '\n');
@@ -110,10 +111,12 @@ async function chooseAiTool(locale) {
     if (answer === '2')
         return 'opencode';
     if (answer === '3')
-        return 'cursor';
+        return 'codex';
     if (answer === '4')
-        return 'other';
+        return 'cursor';
     if (answer === '5')
+        return 'other';
+    if (answer === '6')
         return 'all';
     return 'claude-code';
 }
@@ -184,6 +187,71 @@ export function findOpenCodePluginTemplateSource() {
         return devTemplate;
     return null;
 }
+export function findCodexPluginTemplateSource() {
+    const currentFile = fileURLToPath(import.meta.url);
+    const currentDir = dirname(currentFile);
+    // npm package layout: <pkg>/dist/commands/init.js → <pkg>/codex-plugin-template/
+    const packageTemplate = join(currentDir, '..', '..', 'codex-plugin-template');
+    if (existsSync(packageTemplate))
+        return packageTemplate;
+    // dev layout: cli/src/commands/init.ts → <repo>/plugin-codex/
+    const devTemplate = join(currentDir, '..', '..', '..', 'plugin-codex');
+    if (existsSync(devTemplate))
+        return devTemplate;
+    return null;
+}
+function mergeCodexConfig(root) {
+    const configDir = join(root, '.codex');
+    const configPath = join(configDir, 'config.toml');
+    const pluginBlock = `\n[plugins.openlogos]\nenabled = true\n`;
+    const hookBlock = `\n[[hooks.SessionStart]]\n[[hooks.SessionStart.hooks]]\ntype = "command"\ncommand = ".codex-plugin/hooks/session-start.sh"\ntimeout = 5\nasync = false\nstatusMessage = "Loading OpenLogos phase context..."\n`;
+    mkdirSync(configDir, { recursive: true });
+    if (!existsSync(configPath)) {
+        writeFileSync(configPath, pluginBlock + hookBlock);
+        return { created: true, updated: true };
+    }
+    const existing = readFileSync(configPath, 'utf-8');
+    let content = existing;
+    let changed = false;
+    const hasPluginBlock = content.includes('[plugins.openlogos]');
+    const hasOpenLogosHook = content.includes('command = ".codex-plugin/hooks/session-start.sh"');
+    if (!hasPluginBlock) {
+        content += pluginBlock;
+        changed = true;
+    }
+    if (!hasOpenLogosHook) {
+        content += hookBlock;
+        changed = true;
+    }
+    if (changed) {
+        writeFileSync(configPath, content);
+    }
+    return { created: false, updated: changed };
+}
+export function deployCodexPlugin(root, locale = 'en') {
+    const source = findCodexPluginTemplateSource();
+    if (!source || !existsSync(source))
+        return null;
+    const pluginDir = join(root, '.codex-plugin');
+    const hooksDir = join(pluginDir, 'hooks');
+    mkdirSync(hooksDir, { recursive: true });
+    const pluginJsonSrc = join(source, 'plugin.json');
+    const hookSrc = join(source, 'session-start.sh');
+    if (!existsSync(pluginJsonSrc) || !existsSync(hookSrc))
+        return null;
+    copyFileSync(pluginJsonSrc, join(pluginDir, 'plugin.json'));
+    const hookDest = join(hooksDir, 'session-start.sh');
+    copyFileSync(hookSrc, hookDest);
+    try {
+        chmodSync(hookDest, 0o755);
+    }
+    catch { /* ignore on platforms that don't support chmod */ }
+    const configResult = mergeCodexConfig(root);
+    const targetLabel = locale === 'zh'
+        ? '.codex-plugin/ + .codex/config.toml'
+        : '.codex-plugin/ + .codex/config.toml';
+    return { target: targetLabel, config: configResult };
+}
 function mergeOpenCodeConfig(root) {
     const configPath = join(root, 'opencode.json');
     const defaultConfig = {
@@ -366,6 +434,19 @@ export function deploySkills(root, aiTool, locale = 'en', lifecycle = 'initial',
         writeFileSync(join(targetDir, 'openlogos-policy.mdc'), generatePolicyMdc(locale, lifecycle));
         return { target: '.cursor/rules/', count };
     }
+    if (aiTool === 'codex') {
+        const targetDir = join(root, '.agents', 'skills');
+        for (const name of SKILL_NAMES) {
+            const skillDir = join(targetDir, name);
+            mkdirSync(skillDir, { recursive: true });
+            const srcPath = resolveSkillFile(source, name, locale);
+            if (srcPath) {
+                copyFileSync(srcPath, join(skillDir, 'SKILL.md'));
+                count++;
+            }
+        }
+        return { target: '.agents/skills/', count };
+    }
     const targetDir = join(root, 'logos', 'skills');
     for (const name of SKILL_NAMES) {
         const skillDir = join(targetDir, name);
@@ -387,18 +468,27 @@ function shouldIncludeActiveSkills(aiTool, target) {
         return target === 'claude';
     if (aiTool === 'opencode')
         return target === 'agents';
+    if (aiTool === 'codex')
+        return target === 'agents';
     return true;
 }
-function generateActiveSkillsSection(locale) {
+function skillBasePath(aiTool, target) {
+    if (aiTool === 'codex' && target === 'agents') {
+        return '.agents/skills';
+    }
+    return 'logos/skills';
+}
+function generateActiveSkillsSection(locale, aiTool, target) {
     let section = '';
+    const basePath = skillBasePath(aiTool, target);
     for (const name of SKILL_NAMES) {
         const desc = SKILL_DESCRIPTIONS[name]?.[locale] ?? SKILL_DESCRIPTIONS[name]?.en ?? name;
-        section += `- \`skills/${name}/\` — ${desc}\n`;
+        section += `- \`${basePath}/${name}/SKILL.md\` — ${desc}\n`;
     }
     return section;
 }
-function skillPath(name) {
-    return `logos/skills/${name}/SKILL.md`;
+function skillPath(name, aiTool, target) {
+    return `${skillBasePath(aiTool, target)}/${name}/SKILL.md`;
 }
 function generatePhaseDetectionPlain(locale) {
     if (locale === 'zh') {
@@ -411,7 +501,14 @@ function generatePhaseDetectionPlain(locale) {
 - API 存在但 \`logos/resources/test/\` 为空 → 建议 Phase 3 Step 3a（test-writer）
 - 测试用例存在但 \`logos/resources/scenario/\` 为空 → 建议 Phase 3 Step 3b（test-orchestrator，仅 API 项目）
 - 编排测试存在但 \`logos/resources/implementation/\` 为空 → 建议 Phase 3 Step 4（code-implementor）
-- 代码已生成但 \`logos/resources/verify/\` 为空 → 建议 Phase 3 Step 5（运行测试后 \`openlogos verify\`）`;
+- 代码已生成但 \`logos/resources/verify/\` 为空 → 建议 Phase 3 Step 5（运行测试后 \`openlogos verify\`）
+
+文件命名规范（模块前缀）：
+- 所有设计文档遵循 \`<module>-<序号>-<类型>.md\` 格式，初始项目默认使用 \`core-\` 前缀
+- 场景实现文件：\`<module>-SXX-<slug>.md\`（如 \`core-S01-cli-init.md\`）
+- 测试用例文件：\`<module>-SXX-test-cases.md\`（如 \`core-S01-test-cases.md\`）
+- 场景编号全局唯一，由 \`logos-project.yaml\` 的 \`scenario_counter.next_id\` 维护，严禁不同模块从 S01 重新开始
+- 多模块状态：\`openlogos status\` 聚合展示所有模块（in-progress 置顶）；\`openlogos next\` 单模块直接建议，多模块并列列出，无 in-progress 时提示 \`module add\``;
     }
     return `Phase detection logic:
 - \`logos/resources/prd/1-product-requirements/\` is empty → suggest Phase 1 (prd-writer)
@@ -422,31 +519,52 @@ function generatePhaseDetectionPlain(locale) {
 - API exists but \`logos/resources/test/\` is empty → suggest Phase 3 Step 3a (test-writer)
 - test cases exist but \`logos/resources/scenario/\` is empty → suggest Phase 3 Step 3b (test-orchestrator, API projects only)
 - orchestration tests exist but \`logos/resources/implementation/\` is empty → suggest Phase 3 Step 4 (code-implementor)
-- code generated but \`logos/resources/verify/\` is empty → suggest Phase 3 Step 5 (run tests then \`openlogos verify\`)`;
+- code generated but \`logos/resources/verify/\` is empty → suggest Phase 3 Step 5 (run tests then \`openlogos verify\`)
+
+File naming convention (module prefix):
+- All design documents follow \`<module>-<number>-<type>.md\` format; default module is \`core-\` prefix
+- Scenario implementation files: \`<module>-SXX-<slug>.md\` (e.g. \`core-S01-cli-init.md\`)
+- Test case files: \`<module>-SXX-test-cases.md\` (e.g. \`core-S01-test-cases.md\`)
+- Scenario numbers are globally unique, maintained by \`scenario_counter.next_id\` in \`logos-project.yaml\`; never restart from S01 for a new module
+- Multi-module status: \`openlogos status\` shows all modules (in-progress first); \`openlogos next\` gives direct suggestion for single module, lists all for multiple, prompts \`module add\` when none in-progress`;
 }
-function generatePhaseDetectionWithSkills(locale) {
+function generatePhaseDetectionWithSkills(locale, aiTool, target) {
     if (locale === 'zh') {
         return `Phase 检测逻辑（检测到对应阶段时，**必须先读取** Skill 文件并按其步骤执行）：
-- \`logos/resources/prd/1-product-requirements/\` 为空 → Phase 1 → **读取 \`${skillPath('prd-writer')}\` 并按其步骤执行**
-- 需求存在但 \`2-product-design/\` 为空 → Phase 2 → **读取 \`${skillPath('product-designer')}\` 并按其步骤执行**
-- 设计存在但 \`3-technical-plan/1-architecture/\` 为空 → Phase 3 Step 0 → **读取 \`${skillPath('architecture-designer')}\` 并按其步骤执行**
-- 架构存在但 \`3-technical-plan/2-scenario-implementation/\` 为空 → Phase 3 Step 1 → **读取 \`${skillPath('scenario-architect')}\` 并按其步骤执行**
-- 场景存在但 \`logos/resources/api/\` 为空 → Phase 3 Step 2 → **读取 \`${skillPath('api-designer')}\` 和 \`${skillPath('db-designer')}\` 并按其步骤执行**
-- API 存在但 \`logos/resources/test/\` 为空 → Phase 3 Step 3a → **读取 \`${skillPath('test-writer')}\` 并按其步骤执行**
-- 测试用例存在但 \`logos/resources/scenario/\` 为空 → Phase 3 Step 3b → **读取 \`${skillPath('test-orchestrator')}\` 并按其步骤执行**（仅 API 项目）
-- 编排测试存在但 \`logos/resources/implementation/\` 为空 → Phase 3 Step 4 → **读取 \`${skillPath('code-implementor')}\` 并按其步骤执行**（完成后可用 \`${skillPath('code-reviewer')}\` 进行代码审查）
-- 代码已生成但 \`logos/resources/verify/\` 为空 → Phase 3 Step 5（运行测试后 \`openlogos verify\`）`;
+- \`logos/resources/prd/1-product-requirements/\` 为空 → Phase 1 → **读取 \`${skillPath('prd-writer', aiTool, target)}\` 并按其步骤执行**
+- 需求存在但 \`2-product-design/\` 为空 → Phase 2 → **读取 \`${skillPath('product-designer', aiTool, target)}\` 并按其步骤执行**
+- 设计存在但 \`3-technical-plan/1-architecture/\` 为空 → Phase 3 Step 0 → **读取 \`${skillPath('architecture-designer', aiTool, target)}\` 并按其步骤执行**
+- 架构存在但 \`3-technical-plan/2-scenario-implementation/\` 为空 → Phase 3 Step 1 → **读取 \`${skillPath('scenario-architect', aiTool, target)}\` 并按其步骤执行**
+- 场景存在但 \`logos/resources/api/\` 为空 → Phase 3 Step 2 → **读取 \`${skillPath('api-designer', aiTool, target)}\` 和 \`${skillPath('db-designer', aiTool, target)}\` 并按其步骤执行**
+- API 存在但 \`logos/resources/test/\` 为空 → Phase 3 Step 3a → **读取 \`${skillPath('test-writer', aiTool, target)}\` 并按其步骤执行**
+- 测试用例存在但 \`logos/resources/scenario/\` 为空 → Phase 3 Step 3b → **读取 \`${skillPath('test-orchestrator', aiTool, target)}\` 并按其步骤执行**（仅 API 项目）
+- 编排测试存在但 \`logos/resources/implementation/\` 为空 → Phase 3 Step 4 → **读取 \`${skillPath('code-implementor', aiTool, target)}\` 并按其步骤执行**（完成后可用 \`${skillPath('code-reviewer', aiTool, target)}\` 进行代码审查）
+- 代码已生成但 \`logos/resources/verify/\` 为空 → Phase 3 Step 5（运行测试后 \`openlogos verify\`）
+
+文件命名规范（模块前缀）：
+- 所有设计文档遵循 \`<module>-<序号>-<类型>.md\` 格式，初始项目默认使用 \`core-\` 前缀
+- 场景实现文件：\`<module>-SXX-<slug>.md\`（如 \`core-S01-cli-init.md\`）
+- 测试用例文件：\`<module>-SXX-test-cases.md\`（如 \`core-S01-test-cases.md\`）
+- 场景编号全局唯一，由 \`logos-project.yaml\` 的 \`scenario_counter.next_id\` 维护，严禁不同模块从 S01 重新开始
+- 多模块状态：\`openlogos status\` 聚合展示所有模块（in-progress 置顶）；\`openlogos next\` 单模块直接建议，多模块并列列出，无 in-progress 时提示 \`module add\``;
     }
     return `Phase detection logic (**when a phase is detected, you MUST read the corresponding Skill file and follow its steps**):
-- \`logos/resources/prd/1-product-requirements/\` is empty → Phase 1 → **read \`${skillPath('prd-writer')}\` and follow its steps**
-- requirements exist but \`2-product-design/\` is empty → Phase 2 → **read \`${skillPath('product-designer')}\` and follow its steps**
-- design exists but \`3-technical-plan/1-architecture/\` is empty → Phase 3 Step 0 → **read \`${skillPath('architecture-designer')}\` and follow its steps**
-- architecture exists but \`3-technical-plan/2-scenario-implementation/\` is empty → Phase 3 Step 1 → **read \`${skillPath('scenario-architect')}\` and follow its steps**
-- scenarios exist but \`logos/resources/api/\` is empty → Phase 3 Step 2 → **read \`${skillPath('api-designer')}\` and \`${skillPath('db-designer')}\` and follow their steps**
-- API exists but \`logos/resources/test/\` is empty → Phase 3 Step 3a → **read \`${skillPath('test-writer')}\` and follow its steps**
-- test cases exist but \`logos/resources/scenario/\` is empty → Phase 3 Step 3b → **read \`${skillPath('test-orchestrator')}\` and follow its steps** (API projects only)
-- orchestration tests exist but \`logos/resources/implementation/\` is empty → Phase 3 Step 4 → **read \`${skillPath('code-implementor')}\` and follow its steps** (after completion, use \`${skillPath('code-reviewer')}\` for code review)
-- code generated but \`logos/resources/verify/\` is empty → Phase 3 Step 5 (run tests then \`openlogos verify\`)`;
+- \`logos/resources/prd/1-product-requirements/\` is empty → Phase 1 → **read \`${skillPath('prd-writer', aiTool, target)}\` and follow its steps**
+- requirements exist but \`2-product-design/\` is empty → Phase 2 → **read \`${skillPath('product-designer', aiTool, target)}\` and follow its steps**
+- design exists but \`3-technical-plan/1-architecture/\` is empty → Phase 3 Step 0 → **read \`${skillPath('architecture-designer', aiTool, target)}\` and follow its steps**
+- architecture exists but \`3-technical-plan/2-scenario-implementation/\` is empty → Phase 3 Step 1 → **read \`${skillPath('scenario-architect', aiTool, target)}\` and follow its steps**
+- scenarios exist but \`logos/resources/api/\` is empty → Phase 3 Step 2 → **read \`${skillPath('api-designer', aiTool, target)}\` and \`${skillPath('db-designer', aiTool, target)}\` and follow their steps**
+- API exists but \`logos/resources/test/\` is empty → Phase 3 Step 3a → **read \`${skillPath('test-writer', aiTool, target)}\` and follow its steps**
+- test cases exist but \`logos/resources/scenario/\` is empty → Phase 3 Step 3b → **read \`${skillPath('test-orchestrator', aiTool, target)}\` and follow its steps** (API projects only)
+- orchestration tests exist but \`logos/resources/implementation/\` is empty → Phase 3 Step 4 → **read \`${skillPath('code-implementor', aiTool, target)}\` and follow its steps** (after completion, use \`${skillPath('code-reviewer', aiTool, target)}\` for code review)
+- code generated but \`logos/resources/verify/\` is empty → Phase 3 Step 5 (run tests then \`openlogos verify\`)
+
+File naming convention (module prefix):
+- All design documents follow \`<module>-<number>-<type>.md\` format; default module is \`core-\` prefix
+- Scenario implementation files: \`<module>-SXX-<slug>.md\` (e.g. \`core-S01-cli-init.md\`)
+- Test case files: \`<module>-SXX-test-cases.md\` (e.g. \`core-S01-test-cases.md\`)
+- Scenario numbers are globally unique, maintained by \`scenario_counter.next_id\` in \`logos-project.yaml\`; never restart from S01 for a new module
+- Multi-module status: \`openlogos status\` shows all modules (in-progress first); \`openlogos next\` gives direct suggestion for single module, lists all for multiple, prompts \`module add\` when none in-progress`;
 }
 function generateStep4ExecutionRules(locale) {
     if (locale === 'zh') {
@@ -510,7 +628,7 @@ const DIRECTORIES = [
 ];
 export function createLogosConfig(name, locale, aiTool = 'cursor') {
     const aiToolValue = aiTool === 'all'
-        ? ['claude-code', 'opencode', 'cursor']
+        ? ['claude-code', 'opencode', 'codex', 'cursor']
         : aiTool;
     return JSON.stringify({
         name,
@@ -577,6 +695,15 @@ export function createLogosProject(name, locale) {
 
 tech_stack: {}
 
+scenario_counter:
+  next_id: 1
+
+modules:
+  - id: core
+    name: ${locale === 'zh' ? '核心功能' : 'Core'}
+    status: in-progress
+    loop_phase: requirements
+
 resource_index: []
 
 ${conventionsForYaml(locale)}
@@ -626,7 +753,7 @@ When the user's request is vague or they ask "what should I do next":
 3. Provide a ready-to-use prompt the user can directly say
 4. Never start generating documents without confirming key information
 
-${includeSkills ? generatePhaseDetectionWithSkills(locale) : generatePhaseDetectionPlain(locale)}
+${includeSkills ? generatePhaseDetectionWithSkills(locale, aiTool, target) : generatePhaseDetectionPlain(locale)}
 
 ${generateStep4ExecutionRules(locale)}
 
@@ -639,7 +766,7 @@ ${generateDocumentPostEditVerify(locale)}
         content += `
 ## Active Skills
 ${skillAutoLoadInstr}
-${generateActiveSkillsSection(locale)}`;
+${generateActiveSkillsSection(locale, aiTool, target)}`;
     }
     const changeMgmt = lifecycle === 'active'
         ? (locale === 'zh'
@@ -731,7 +858,7 @@ export async function init(name, options) {
         process.exit(1);
     }
     const locale = options?.locale === 'zh' ? 'zh' : options?.locale === 'en' ? 'en' : await chooseLocale();
-    const aiTool = options?.aiTool === 'claude-code' ? 'claude-code' : options?.aiTool === 'opencode' ? 'opencode' : options?.aiTool === 'cursor' ? 'cursor' : options?.aiTool === 'other' ? 'other' : options?.aiTool === 'all' ? 'all' : await chooseAiTool(locale);
+    const aiTool = options?.aiTool === 'claude-code' ? 'claude-code' : options?.aiTool === 'opencode' ? 'opencode' : options?.aiTool === 'codex' ? 'codex' : options?.aiTool === 'cursor' ? 'cursor' : options?.aiTool === 'other' ? 'other' : options?.aiTool === 'all' ? 'all' : await chooseAiTool(locale);
     const { name: projectName, source: nameSource } = await resolveProjectName(locale, root, name);
     const sourceLabel = {
         'argument': '',
@@ -755,7 +882,7 @@ export async function init(name, options) {
     console.log(`  ✓ AGENTS.md`);
     writeFileSync(join(root, 'CLAUDE.md'), createAgentsMd(locale, aiTool, 'claude', 'initial'));
     console.log(`  ✓ CLAUDE.md`);
-    const deployTools = aiTool === 'all' ? ['claude-code', 'opencode', 'cursor'] : [aiTool];
+    const deployTools = aiTool === 'all' ? ['claude-code', 'opencode', 'codex', 'cursor'] : [aiTool];
     for (const tool of deployTools) {
         const deployResult = deploySkills(root, tool, locale, 'initial');
         if (deployResult && deployResult.count > 0) {
@@ -777,6 +904,18 @@ export async function init(name, options) {
             }
         }
     }
+    if (aiTool === 'codex' || aiTool === 'all') {
+        const codexResult = deployCodexPlugin(root, locale);
+        if (codexResult) {
+            console.log(`  ✓ ${t(locale, 'init.codexPluginDeployed', { target: codexResult.target })}`);
+            if (codexResult.config.created) {
+                console.log(`  ✓ ${t(locale, 'init.codexConfigCreated')}`);
+            }
+            else if (codexResult.config.updated) {
+                console.log(`  ✓ ${t(locale, 'init.codexConfigUpdated')}`);
+            }
+        }
+    }
     const specResult = deploySpecs(root);
     if (specResult && specResult.count > 0) {
         console.log(`  ✓ ${specResult.count} specs deployed to logos/spec/`);