icoa-cli 2.19.66 → 2.19.67

package/dist/lib/exam-state.d.ts

@@ -1,7 +1,7 @@
 import type { ExamState } from '../types/index.js';
-export declare function getExamState(): ExamState | null;
-export declare function getDemoState(): ExamState | null;
 export declare function getRealExamState(): ExamState | null;
+export declare function getDemoState(): ExamState | null;
+export declare function getExamState(): ExamState | null;
 export declare function saveExamState(state: ExamState): void;
 export declare function clearExamState(examId?: string): void;
 export declare function isExamActive(): boolean;

package/dist/lib/exam-state.js

@@ -12,28 +12,8 @@ function demoStateFile() {
 function resolveStateFile(examId) {
     return examId === 'demo-free' ? demoStateFile() : stateFile();
 }
-export function getExamState() {
-    // Check both files, return the most recently active one
-    const files = [stateFile(), demoStateFile()];
-    let latest = null;
-    let latestTime = 0;
-    for (const f of files) {
-        if (!existsSync(f))
-            continue;
-        try {
-            const state = JSON.parse(readFileSync(f, 'utf-8'));
-            const t = new Date(state.session.confirmedAt || state.session.startedAt).getTime();
-            if (t > latestTime) {
-                latest = state;
-                latestTime = t;
-            }
-        }
-        catch { }
-    }
-    return latest;
-}
-export function getDemoState() {
-    const f = demoStateFile();
+export function getRealExamState() {
+    const f = stateFile();
     if (!existsSync(f))
         return null;
     try {
@@ -43,8 +23,8 @@ export function getDemoState() {
         return null;
     }
 }
-export function getRealExamState() {
-    const f = stateFile();
+export function getDemoState() {
+    const f = demoStateFile();
     if (!existsSync(f))
         return null;
     try {
@@ -54,6 +34,18 @@ export function getRealExamState() {
         return null;
     }
 }
+export function getExamState() {
+    // Real exam ALWAYS takes priority over demo when both exist.
+    // Reasoning: real exam is token-gated, has a timer, and represents a serious
+    // commitment. Demo is casual practice. If a real exam is in progress, all
+    // shared commands (exam q N, exam answer, ai4ctf, ctf4ai) must target the
+    // real exam — never silently fall back to demo questions, even if demo was
+    // run more recently. (Demo→Exam→Finals progression principle, exam.md §0)
+    const real = getRealExamState();
+    if (real)
+        return real;
+    return getDemoState();
+}
 export function saveExamState(state) {
     const f = resolveStateFile(state.session.examId);
     writeFileSync(f, JSON.stringify(state, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icoa-cli",
-  "version": "2.19.66",
+  "version": "2.19.67",
   "description": "ICOA CLI — The world's first CLI-native CTF competition terminal",
   "type": "module",
   "bin": {