icoa-cli 2.19.368 → 2.19.369

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- import chalk from"chalk";import{createInterface as e}from"node:readline";import{spawn as o}from"node:child_process";import{getMainRl as r}from"../lib/main-rl.js";import{existsSync as n}from"node:fs";import{dirname as l,join as t}from"node:path";import{fileURLToPath as a}from"node:url";import{loadCurriculumById as s,validateEAToken as i,syncProgress as c,syncCardFeedback as u}from"../lib/learn-curricula.js";import{normalizeTokenBody as g}from"../lib/token-format.js";import{streamLearnTutor as d,submitResearch as m}from"../lib/learn-ai.js";import{getConfig as y,saveConfig as h}from"../lib/config.js";import{loadLearnState as f,saveLearnState as p,newLearnState as b,updateStreak as w,markCardComplete as k,recordMCQ as v,recordCheck as A,markPracticalComplete as C,addAchievement as I}from"../lib/learn-state.js";import{renderWelcome as $,renderKnowledgeCard as E,renderMCQCard as _,renderMCQFeedback as M,renderPracticalCard as D,renderPracticalSuccess as T,renderSimDemoCard as O,renderMilestone as P,renderArenaTaskCard as S,renderComingSoonCard as L,renderStatus as q,renderPhaseComplete as x,renderCurriculumComplete as j,setLearnAiEnabled as N}from"../lib/learn-render.js";import{printError as W}from"../lib/ui.js";export function registerLearnCommand(R){R.command("learn [token]").description("Enter learn mode (free demo, or team-issued EA/EI/AC/CA/IO/IA token for full curriculum)").action(async R=>{R&&R.trim()||(console.log(),console.log(chalk.gray(" No token given — starting free 11-card demo (")+chalk.bold.green("LEARNDEMO01")+chalk.gray(").")),console.log(chalk.gray(" Full curriculum: ")+chalk.bold.yellow("learn EA|EI|AC|CA|IO|IA + 8 chars")+chalk.gray(" — token from your country team leader.")),console.log(),R="LEARNDEMO01");let F=R.trim().toUpperCase(),B=null;const z=/^(LEARNDEMO01|AI4CTFDEMO01|CTF4AIDEMO01)$/i.test(F),U=/^[A-Z]{2}[A-Z0-9]{8}$/i.test(F);let J=!1;if(z)console.log(),console.log(chalk.gray(" Loading demo curriculum...")),B=await s(F);else if(U){console.log(),console.log(chalk.gray(" Validating token..."));let e=await i(F);if(!e.ok){const o=g(F);if(o!==F){const r=await i(o);r.ok&&(console.log(chalk.yellow(` Corrected look-alike characters: ${F} → ${o}`)),e=r,F=o)}}if(!e.ok)return W(`Token validation failed: ${e.message}`),console.log(),"device_bound"===e.code?(console.log(chalk.gray(" This learn token is bound to the first computer it was used on,")),console.log(chalk.gray(" and this is a different computer.")),console.log(),console.log(chalk.gray(" If you changed computers or reinstalled, ask the coordinator who")),console.log(chalk.gray(" issued your token to move it to this device, then try again."))):(console.log(chalk.gray(" Possible causes:")),console.log(chalk.gray(" · Token expired or revoked")),console.log(chalk.gray(" · Network down (check connection)")),console.log(chalk.gray(" · Typo in token (check 0/O, 1/I/L, V/U)"))),void console.log();if(console.log(chalk.green(` ✓ Token valid · curriculum: ${e.curriculumId} · status: ${e.status}`)+(!0===e.aiEnabled?chalk.bold.magenta(" · ⭐ AI tutor"):"")),J=!0===e.aiEnabled,console.log(chalk.gray(" Loading curriculum… (downloads ~1 MB; up to a minute on slow venue Wi-Fi — please wait)")),B=await s(e.curriculumId||"LEARNDEMO01"),!B)return W(`Could not open a learn curriculum for token '${F}'.`),console.log(),console.log(chalk.gray(" If this is an ")+chalk.bold.yellow("EXAM token")+chalk.gray(", start it with ")+chalk.bold.green(`exam ${F}`)+chalk.gray(" instead.")),console.log(chalk.gray(" Otherwise: the full curriculum is ~3 MB; on a slow link the download")),console.log(chalk.gray(" can take a while — stay on a stable connection and run ")+chalk.bold.yellow(`learn ${F}`)+chalk.gray(" again")),console.log(chalk.gray(" (it caches after the first load). If it keeps failing, check ")+chalk.cyan("https://practice.icoa2026.au")+chalk.gray(" is reachable.")),void console.log()}if(!B)return W(`Unknown learn token: ${F}`),console.log(),console.log(chalk.gray(" Available tokens:")),console.log(chalk.gray(" ")+chalk.bold.green("LEARNDEMO01")+chalk.gray(" free 11-card demo (anyone can use)")),console.log(chalk.gray(" ")+chalk.bold.yellow("EA|EI|AC|CA|IO|IA")+chalk.gray(" + 8 chars full curriculum (issued by team leader)")),console.log(),console.log(chalk.gray(" Tracks: ")+chalk.cyan("EA")+chalk.gray("=ctf4eai · ")+chalk.cyan("AC")+chalk.gray("=ai4ctf · ")+chalk.cyan("CA")+chalk.gray("=ctf4ai · ")+chalk.cyan("IO")+chalk.gray("=ioai · ")+chalk.cyan("IA")+chalk.gray("=iaio")),console.log(),console.log(chalk.gray(" To get a full curriculum, email ")),console.log(chalk.gray(" ")+chalk.cyan("australia@icoa2026.au")+chalk.gray(" or ask your country's team leader.")),void console.log();let K=f(),Q=!1;try{K&&K.token===F?w(K):(K=b(F,B.id,B.totalCards),Q=!0),p(K),$(B,K,Q)}catch{return W("Could not open this curriculum — it may be malformed or not a learn curriculum."),console.log(chalk.gray(" If this is an ")+chalk.bold.yellow("EXAM token")+chalk.gray(", start it with ")+chalk.bold.green(`exam ${F}`)+chalk.gray(".")),void console.log()}const V=r(),X=null!==V,Z=X?V.listeners("line").slice():[];X&&V.removeAllListeners("line");const G=X?V:e({input:process.stdin,output:process.stdout,terminal:!0}),H=()=>{G.setPrompt(chalk.bold.cyan(ne?"icoa learn ai> ":"icoa learn> ")),G.prompt()};let Y=null,ee=null,oe=null,re=null,ne=!1,le=!1;const te=[];let ae=!1;const se=[];let ie=!1,ce=0;const ue=(y().language||"en").toLowerCase().startsWith("zh");N(J);const ge=[];let de=null;const me=new Promise(e=>{de=e}),ye=()=>{const e=de;de=null,e?.()},he="1"===process.env.ICOA_LEARN_EMBEDDED,fe=e=>B.cards.find(o=>o.number===e),pe=e=>{const o=B.modules.find(o=>o.cardRange[1]===e);if(!o)return!1;const r=B.modules.find(e=>e.number===o.number+1);return x(B,K,o,r),!0},be=()=>{ie=!0,console.log(chalk.gray(ue?" 按 Enter 进入下一阶段…":" Press Enter to continue to the next phase…"))},we=()=>{const e=fe(K.currentCard);if(!e)return console.log(),console.log(chalk.gray(" No more cards in this curriculum.")),console.log(chalk.gray(" Type ")+chalk.bold.green("status")+chalk.gray(" for the dashboard or ")+chalk.bold.green("quit")+chalk.gray(" to exit.")),void console.log();switch(e.type){case"knowledge":E(e,B),e.check?(oe=e.number,ce=Date.now()):(k(K,e.number),p(K));break;case"mcq":_(e,B),Y=e.number;break;case"practical":D(e,B),ee=e.number;break;case"sim_demo":O(e,B),k(K,e.number),p(K);break;case"milestone":P(e,B),I(K,e.badge),k(K,e.number),p(K);break;case"arena_task":S(e,B),k(K,e.number),p(K);break;case"coming_soon":L(e,B),k(K,e.number),p(K)}},ke=()=>{F.endsWith("DEMO01")?console.log(chalk.yellow(ue?" AI 导师需要开通 AI 的正式课程 token(demo 是共享的,没有 AI 额度)。":" The AI tutor needs an AI-enabled curriculum token — demos are shared and carry no AI budget.")):(console.log(chalk.yellow(ue?" 此 token 未开通 AI 导师(高级功能)。":" This token does not include the AI tutor (premium).")),console.log(chalk.gray(ue?" 找你的领队 / 协调人换开通 AI 的 token。":" Ask your team leader / coordinator for an AI-enabled token."))),console.log()},ve=async(e,o)=>{if(J){le=!0;try{console.log(),console.log(chalk.gray("deep"===o?ue?" 🤖 AI 导师(深度思考中,思考过程为灰色小字)…":" 🤖 AI tutor (deepthink — reasoning shown in gray)…":ue?" 🤖 AI 导师(快速模式)…":" 🤖 AI tutor (quick mode)…")),console.log();let r=!1,n=!1;const l=await d({token:F,cardNumber:K.currentCard,question:e,mode:o,history:te},e=>{"reasoning"===e.kind?(r||(process.stdout.write(" "),r=!0),process.stdout.write(chalk.dim(e.text.replace(/\n/g,"\n ")))):(n||(process.stdout.write(r?"\n\n ":" "),n=!0),process.stdout.write(chalk.white(e.text.replace(/\n/g,"\n "))))});if((r||n)&&console.log(),l.ok){for(te.push({role:"user",content:e},{role:"assistant",content:l.answer});te.length>6;)te.shift();null!=l.spent&&null!=l.cap&&l.spent/l.cap>.8&&console.log(chalk.gray(` (${ue?"AI 额度":"AI budget"}: ${Math.round(l.spent/1e3)}k / ${Math.round(l.cap/1e3)}k tokens)`))}else console.log(),console.log(chalk.yellow(` ${l.message||(ue?"AI 导师暂不可用。":"AI tutor unavailable.")}`));null!==oe&&console.log(chalk.gray(ue?" (本卡的判断题还等着你作答 — y 或 n)":" (the y/n check on this card is still waiting — answer y or n)")),console.log()}finally{le=!1}}else ke()},Ae=async()=>{const e=se.join("\n").trim();if(se.length=0,ae=!1,e.length<30)return console.log(chalk.yellow(ue?" 内容太短(至少写几句话)。已取消。":" Too short (write at least a few sentences). Cancelled.")),void console.log();le=!0;try{console.log(),console.log(chalk.gray(ue?" 📝 提交中,AI 评审中…":" 📝 Submitting — AI is reviewing…"));const o=await m({token:F,cardNumber:K.currentCard,submission:e});if(console.log(),!o.ok)return console.log(chalk.yellow(` ${o.message||(ue?"AI 评审暂不可用。":"AI review unavailable.")}`)),void console.log();const r=o.dimensions??{},n=(o.score??0)>=70?chalk.bold.green:(o.score??0)>=40?chalk.bold.yellow:chalk.bold.red;if(console.log(chalk.gray(" ─────────────────────────────────────────")),console.log((ue?chalk.white(" 研究评分: "):chalk.white(" Research score: "))+n(`${o.score??0} / 100`)),console.log(chalk.gray(` ${ue?"准确":"accuracy"} ${r.accuracy??0}/25 · ${ue?"深度":"depth"} ${r.depth??0}/25 · ${ue?"研究":"research"} ${r.research??0}/25 · ${ue?"清晰":"clarity"} ${r.clarity??0}/25`)),o.feedback){console.log();for(const e of o.feedback.match(/.{1,64}(\s|$)/g)??[o.feedback])console.log(chalk.white(" "+e.trim()))}o.improve&&(console.log(),console.log(chalk.cyan(ue?" 改进建议: ":" To improve: ")+chalk.gray(o.improve))),console.log(chalk.gray(" ─────────────────────────────────────────")),null!=o.spent&&null!=o.cap&&o.spent/o.cap>.8&&console.log(chalk.gray(` (${ue?"AI 额度":"AI budget"}: ${Math.round(o.spent/1e3)}k / ${Math.round(o.cap/1e3)}k tokens)`)),console.log()}finally{le=!1}};G.on("line",e=>{(async e=>{const r=e.trim().toLowerCase();if(!le){if(null!==re){const o=e.trim(),r=re;if(re=null,""===o)console.log(chalk.gray(ue?" 已取消(未提交)。":" Cancelled (nothing submitted)."));else{const e=ce>0?Date.now()-ce:void 0;ge.push(u(F,{curriculum_id:B.id,card_number:r,feedback_text:o,time_on_card_ms:e}).catch(()=>{})),console.log(chalk.green(ue?" ✓ 已收到,谢谢帮助完善这张卡。":" ✓ Thanks — your report was recorded."))}return console.log(),void H()}if(ae){const o=e.trim();return"q"===o||"quit"===o?(ae=!1,se.length=0,console.log(chalk.gray(ue?" 已取消提交。":" Submission cancelled.")),console.log(),void H()):"."===o?(await Ae(),void H()):(se.push(e),G.setPrompt(chalk.gray(" … ")),void G.prompt())}if(ie)return ie=!1,we(),void H();if(r){if(ne){if(["q","quit","exit","back","b","menu"].includes(r))return ne=!1,te.length=0,console.log(chalk.gray(ue?" 已退出 AI 导师,回到卡片。":" Left the AI tutor — back to the card.")),console.log(),void H();const o=e.trim().startsWith("!"),n=o?e.trim().slice(1).trim():e.trim();return n&&await ve(n,o?"fast":"deep"),void H()}if("/ai"===r||"/ai!"===r||r.startsWith("/ai ")||r.startsWith("/ai! ")){if(!J)return ke(),void H();const o=r.startsWith("/ai!"),n=e.trim().slice(o?4:3).trim();if(!n){ne=!0;const e=fe(K.currentCard),o=e?e.title??e.badge??"":"";return console.log(),console.log(chalk.bold.magenta(" 🤖 AI ")+chalk.bold.white(ue?"AI 导师":"AI tutor")+(o?chalk.gray(ue?` — 主题「${o}」`:` — topic “${o}”`):"")),console.log(chalk.gray(ue?" 直接输入问题(默认深度思考) · ! 开头 = 快答 · q = 返回卡片":" Type a question (deepthink by default) · prefix ! = quick answer · q = back to card")),console.log(),void H()}return await ve(n,o?"fast":"deep"),void H()}if("/research"===r||r.startsWith("/research ")||"/submit"===r||r.startsWith("/submit ")){if(!J)return ke(),void H();const o=e.trim().replace(/^\/(research|submit)\s*/i,"");if(o)return se.length=0,se.push(o),await Ae(),void H();ae=!0,se.length=0;const r=fe(K.currentCard),n=r?r.title??r.badge??"":"";return console.log(),console.log(chalk.bold.magenta(" 📝 ")+chalk.bold.white(ue?"研究提交":"Research submit")+(n?chalk.gray(ue?` — 主题「${n}」`:` — topic “${n}”`):"")),console.log(chalk.gray(ue?" 写下你对本主题的研究(可多行)· 单独一行输入 . 提交 · q 取消":" Write your research on this topic (multi-line) · a lone . submits · q cancels")),console.log(),G.setPrompt(chalk.gray(" … ")),void G.prompt()}if("menu"!==r&&"menu confirm"!==r)if("quit"!==r&&"exit"!==r&&"q"!==r){if("status"===r)return q(B,K),void H();if("lang"===r||r.startsWith("lang ")){const e=r.slice(4).trim();if(!e)return console.log(chalk.gray(" 当前语言 / current: ")+chalk.white(y().language||"en")+chalk.gray(" · ")+chalk.bold.green("lang zh")+chalk.gray(" / ")+chalk.bold.green("lang en")),void H();const o=B.cards.some(e=>null!=e._zh),n=e.toLowerCase().startsWith("zh")?"zh":e.toLowerCase(),l="en"===n||"zh"===n&&o,t=l?n:"en";return h({language:t}),l?console.log(chalk.green(" ✓ ")+chalk.gray("语言 / language → ")+chalk.white(t)):console.log(chalk.yellow(" ! ")+chalk.gray(`${e} 本课暂无翻译,已用英文 / not available — using English`)),oe=null,Y=null,ee=null,re=null,ie=!1,we(),void H()}if("sim"===r){const e=fe(K.currentCard);return e&&"sim_demo"===e.type?(function(e){const r=function(){const e=l(a(import.meta.url)),o=[t(e,"..","..","panda","mujoco-launcher.py"),t(e,"..","..","..","panda","mujoco-launcher.py")];for(const e of o)if(n(e))return e;return null}();if(!r)return console.log(chalk.yellow(" MuJoCo launcher not found.")),console.log(chalk.gray(" Get it from: https://github.com/newaipanda/ICOA_CLI/blob/main/panda/mujoco-launcher.py")),void console.log(chalk.gray(" Or use the sandbox-vla docker image (Phase 3)."));const s={baseline:"baseline",prompt_injected:"prompt_inj",patch_attacked:"patch",modality_confused:"confused"}[e]||"baseline";console.log(chalk.gray(` Launching MuJoCo viewer (scenario: ${s})...`)),console.log(chalk.gray(" Close the window or press ESC to return to learn mode.")),o("python3",[r,s,"--seconds","5"],{stdio:"inherit"}).on("exit",e=>{0!==e?console.log(chalk.yellow(` MuJoCo exited with code ${e} (install: pip install mujoco)`)):console.log(chalk.gray(" Returned from sim."))})}(e.simAction),void H()):(console.log(chalk.gray(" (sim only available on simulation cards)")),void H())}if("bookmark"===r){const e=K.currentCard;return K.bookmarks.includes(e)||K.bookmarks.push(e),p(K),console.log(chalk.gray(` ✓ Card ${e} bookmarked.`)),void H()}if("e"===r)return re=K.currentCard,console.log(chalk.gray(ue?" 描述问题(回车提交 / 空行取消):":" Describe the issue (Enter to submit / blank to cancel):")),void H();if("back"===r||"b"===r)return K.currentCard>1&&(K.currentCard-=1),Y=null,ee=null,oe=null,p(K),we(),void H();if(r.startsWith("card ")){const e=r.slice(5).trim(),o=parseInt(e,10);return!Number.isInteger(o)||o<1||o>B.totalCards?(console.log(chalk.yellow(` Card number must be 1..${B.totalCards}. Try: `)+chalk.bold.green("card 1")),void H()):(K.currentCard=o,Y=null,ee=null,oe=null,p(K),we(),void H())}if(null!==oe&&["y","yes","n","no"].includes(r)){const e=fe(oe);if(e&&"knowledge"===e.type&&e.check){const o=r.startsWith("y")?"y":"n",n=o===e.check.answer,l=Date.now()-ce;k(K,e.number),A(K,e.number,{answer:o,correct:n,submittedAt:(new Date).toISOString()}),p(K);const{renderCheckFeedback:t}=await import("../lib/learn-render.js");if(t(e,o,n,!1),ge.push(c(F,{card_number:e.number,event_type:"check_answered",check_answer:o,check_correct:n,time_on_card_ms:l}).catch(()=>{})),oe=null,e.solution&&e.solution.length>0)return void H();if(K.currentCard<B.totalCards){const e=K.currentCard;K.currentCard+=1,p(K),pe(e)?be():we(),H()}else j(B,K),H();return}}if(null!==Y&&["a","b","c","d"].includes(r)){const e=fe(Y);if(e&&"mcq"===e.type){const o=r.toUpperCase(),n=o===e.answer;return v(K,e.number,{answer:o,correct:n,submittedAt:(new Date).toISOString()}),k(K,e.number),p(K),M(e,o,n,K),ge.push(c(F,{card_number:e.number,event_type:"mcq_answered",mcq_answer:o,mcq_correct:n}).catch(()=>{})),Y=null,void(n?K.currentCard<B.totalCards?(K.currentCard+=1,p(K),we()):(j(B,K),H()):H())}}if(null!==ee){if("done"===r){const e=fe(ee);if(e&&"practical"===e.type)return C(K,e.number),k(K,e.number),p(K),T(e),ee=null,void H()}if("skip"===r)return k(K,ee),p(K),console.log(chalk.gray(" Skipped (counts as not completed).")),console.log(),ee=null,void H()}if("ok"===r||"next"===r||"continue"===r||"n"===r){if(null!==Y)return console.log(chalk.yellow(" Please answer the MCQ first (A / B / C / D).")),void H();if(null!==ee)return console.log(chalk.yellow(" Please type ")+chalk.bold.green("done")+chalk.yellow(" or ")+chalk.bold.yellow("skip")+chalk.yellow(" for the practical.")),void H();if(null!==oe)return console.log(chalk.yellow(" Please answer the check above (")+chalk.bold.green("y")+chalk.yellow(" or ")+chalk.bold.green("n")+chalk.yellow(").")),void H();const e=K.currentCard;return K.currentCard+=1,p(K),K.currentCard>B.totalCards?j(B,K):pe(e)?be():we(),void H()}if(null!==oe)return console.log(chalk.yellow(" Please answer the check above (")+chalk.bold.green("y")+chalk.yellow(" or ")+chalk.bold.green("n")+chalk.yellow(").")),void H();if(null!==Y)return console.log(chalk.yellow(" Please answer the MCQ first (A / B / C / D).")),void H();if(null!==ee)return console.log(chalk.yellow(" Please type ")+chalk.bold.green("done")+chalk.yellow(" or ")+chalk.bold.yellow("skip")+chalk.yellow(" for the practical.")),void H();console.log(chalk.gray(" Unknown command. Try: ")+chalk.white("ok")+chalk.gray(" / ")+chalk.white("status")+chalk.gray(" / ")+chalk.white("card N")+chalk.gray(" / ")+chalk.white("/ai")+chalk.gray(" / ")+chalk.white("quit")),H()}else if(ge.length>0&&await Promise.race([Promise.allSettled(ge),new Promise(e=>setTimeout(e,5e3))]),console.log(),console.log(chalk.gray(" Saved. See you next session.")),console.log(chalk.gray(" Streak: ")+chalk.yellow(`🔥 ${K.streakDays} day(s)`)),console.log(),X){G.removeAllListeners("line");for(const e of Z)G.on("line",e);G.prompt(),ye()}else G.removeAllListeners("line"),G.close();else if(ge.length>0&&await Promise.race([Promise.allSettled(ge),new Promise(e=>setTimeout(e,3e3))]),G.removeAllListeners("line"),X||!he){const{returnToMainMenu:e}=await import("../lib/menu-nav.js");e(X?G:void 0),ye()}else G.close()}else H()}})(e).catch(e=>{console.log(),console.log(chalk.red(" ⚠ Something went wrong handling that input.")),console.log(chalk.gray(` ${e instanceof Error?e.message:String(e)}`)),console.log(chalk.gray(" Progress is saved. Type ")+chalk.bold.green("ok")+chalk.gray(" to continue or ")+chalk.bold.green("quit")+chalk.gray(" to exit.")),H()})}),X||G.on("close",async()=>{ge.length>0&&await Promise.race([Promise.allSettled(ge),new Promise(e=>setTimeout(e,5e3))]),he?ye():process.exit(0)});try{we(),H()}catch{if(W("Could not render this card — the curriculum may be malformed."),X){G.removeAllListeners("line");for(const e of Z)G.on("line",e);G.prompt()}else G.close();ye()}await me}),R.command("learn-pull [id]").description("Pre-download learn curricula to ~/.icoa/learn-cache/ for offline use (default: all)").action(async e=>{const o=e?[e.trim()]:["LEARNDEMO01","AI4CTFDEMO01","CTF4AIDEMO01","ai4ctf-96","ai4ctf-360","ctf4ai-96","ctf4ai-360","ctf4eai-96","ctf4eai-360","embodied-ai-100","embodied-ai-480"];console.log(),console.log(chalk.bold.cyan(" ICOA learn-pull — fetching curricula for offline use")),console.log(chalk.gray(" Server: https://practice.icoa2026.au")),console.log();let r=0,n=0,l=0;for(const e of o){process.stdout.write(` ${e.padEnd(22)} `);const o=Date.now(),t=await s(e),a=Date.now()-o;if(t){const e=t.cards,o=Array.isArray(e)?e.length:0,n=JSON.stringify(t).length;l+=n,console.log(chalk.green("✓ ")+chalk.gray(`${o.toString().padStart(3)} cards · ${(n/1024).toFixed(1).padStart(6)} KB · ${a.toString().padStart(4)} ms`)),r++}else console.log(chalk.red("✗ failed (server unreachable or unknown id)")),n++}console.log(),console.log(chalk.gray(" Summary: ")+chalk.green.bold(`${r} cached`)+chalk.gray(` · ${n} failed · total ${(l/1024).toFixed(0)} KB`)),console.log(chalk.gray(" Cache: ")+chalk.cyan("~/.icoa/learn-cache/")),console.log()})}
1
+ import chalk from"chalk";import{createInterface as e}from"node:readline";import{spawn as o}from"node:child_process";import{getMainRl as r}from"../lib/main-rl.js";import{existsSync as n}from"node:fs";import{dirname as l,join as t}from"node:path";import{fileURLToPath as a}from"node:url";import{loadCurriculumById as s,validateEAToken as i,syncProgress as c,syncCardFeedback as u}from"../lib/learn-curricula.js";import{normalizeTokenBody as g}from"../lib/token-format.js";import{streamLearnTutor as d,submitResearch as m}from"../lib/learn-ai.js";import{getConfig as y,saveConfig as h}from"../lib/config.js";import{loadLearnState as f,saveLearnState as p,newLearnState as b,updateStreak as w,markCardComplete as k,recordMCQ as v,recordCheck as A,markPracticalComplete as C,addAchievement as I}from"../lib/learn-state.js";import{renderWelcome as $,renderKnowledgeCard as E,renderMCQCard as _,renderMCQFeedback as M,renderPracticalCard as D,renderPracticalSuccess as T,renderSimDemoCard as O,renderMilestone as P,renderArenaTaskCard as S,renderComingSoonCard as L,renderStatus as q,renderPhaseComplete as x,renderCurriculumComplete as j,setLearnAiEnabled as N}from"../lib/learn-render.js";import{printError as W}from"../lib/ui.js";export function registerLearnCommand(R){R.command("learn [token]").description("Enter learn mode (free demo, or team-issued EA/EI/AC/CA/IO/IA token for full curriculum)").action(async R=>{R&&R.trim()||(console.log(),console.log(chalk.gray(" No token given — starting free 11-card demo (")+chalk.bold.green("LEARNDEMO01")+chalk.gray(").")),console.log(chalk.gray(" Full curriculum: ")+chalk.bold.yellow("learn EA|EI|AC|CA|IO|IA + 8 chars")+chalk.gray(" — token from your country team leader.")),console.log(),R="LEARNDEMO01");let F=R.trim().toUpperCase(),B=null;const z=/^(LEARNDEMO01|AI4CTFDEMO01|CTF4AIDEMO01)$/i.test(F),U=/^[A-Z]{2}[A-Z0-9]{8}$/i.test(F);let J=!1;if(z)console.log(),console.log(chalk.gray(" Loading demo curriculum...")),B=await s(F,F);else if(U){console.log(),console.log(chalk.gray(" Validating token..."));let e=await i(F);if(!e.ok){const o=g(F);if(o!==F){const r=await i(o);r.ok&&(console.log(chalk.yellow(` Corrected look-alike characters: ${F} → ${o}`)),e=r,F=o)}}if(!e.ok)return W(`Token validation failed: ${e.message}`),console.log(),"device_bound"===e.code?(console.log(chalk.gray(" This learn token is bound to the first computer it was used on,")),console.log(chalk.gray(" and this is a different computer.")),console.log(),console.log(chalk.gray(" If you changed computers or reinstalled, ask the coordinator who")),console.log(chalk.gray(" issued your token to move it to this device, then try again."))):(console.log(chalk.gray(" Possible causes:")),console.log(chalk.gray(" · Token expired or revoked")),console.log(chalk.gray(" · Network down (check connection)")),console.log(chalk.gray(" · Typo in token (check 0/O, 1/I/L, V/U)"))),void console.log();if(console.log(chalk.green(` ✓ Token valid · curriculum: ${e.curriculumId} · status: ${e.status}`)+(!0===e.aiEnabled?chalk.bold.magenta(" · ⭐ AI tutor"):"")),J=!0===e.aiEnabled,console.log(chalk.gray(" Loading curriculum… (downloads ~1 MB; up to a minute on slow venue Wi-Fi — please wait)")),B=await s(e.curriculumId||"LEARNDEMO01",F),!B)return W(`Could not open a learn curriculum for token '${F}'.`),console.log(),console.log(chalk.gray(" If this is an ")+chalk.bold.yellow("EXAM token")+chalk.gray(", start it with ")+chalk.bold.green(`exam ${F}`)+chalk.gray(" instead.")),console.log(chalk.gray(" Otherwise: the full curriculum is ~3 MB; on a slow link the download")),console.log(chalk.gray(" can take a while — stay on a stable connection and run ")+chalk.bold.yellow(`learn ${F}`)+chalk.gray(" again")),console.log(chalk.gray(" (it caches after the first load). If it keeps failing, check ")+chalk.cyan("https://practice.icoa2026.au")+chalk.gray(" is reachable.")),void console.log()}if(!B)return W(`Unknown learn token: ${F}`),console.log(),console.log(chalk.gray(" Available tokens:")),console.log(chalk.gray(" ")+chalk.bold.green("LEARNDEMO01")+chalk.gray(" free 11-card demo (anyone can use)")),console.log(chalk.gray(" ")+chalk.bold.yellow("EA|EI|AC|CA|IO|IA")+chalk.gray(" + 8 chars full curriculum (issued by team leader)")),console.log(),console.log(chalk.gray(" Tracks: ")+chalk.cyan("EA")+chalk.gray("=ctf4eai · ")+chalk.cyan("AC")+chalk.gray("=ai4ctf · ")+chalk.cyan("CA")+chalk.gray("=ctf4ai · ")+chalk.cyan("IO")+chalk.gray("=ioai · ")+chalk.cyan("IA")+chalk.gray("=iaio")),console.log(),console.log(chalk.gray(" To get a full curriculum, email ")),console.log(chalk.gray(" ")+chalk.cyan("australia@icoa2026.au")+chalk.gray(" or ask your country's team leader.")),void console.log();let K=f(),Q=!1;try{K&&K.token===F?w(K):(K=b(F,B.id,B.totalCards),Q=!0),p(K),$(B,K,Q)}catch{return W("Could not open this curriculum — it may be malformed or not a learn curriculum."),console.log(chalk.gray(" If this is an ")+chalk.bold.yellow("EXAM token")+chalk.gray(", start it with ")+chalk.bold.green(`exam ${F}`)+chalk.gray(".")),void console.log()}const V=r(),X=null!==V,Z=X?V.listeners("line").slice():[];X&&V.removeAllListeners("line");const G=X?V:e({input:process.stdin,output:process.stdout,terminal:!0}),H=()=>{G.setPrompt(chalk.bold.cyan(ne?"icoa learn ai> ":"icoa learn> ")),G.prompt()};let Y=null,ee=null,oe=null,re=null,ne=!1,le=!1;const te=[];let ae=!1;const se=[];let ie=!1,ce=0;const ue=(y().language||"en").toLowerCase().startsWith("zh");N(J);const ge=[];let de=null;const me=new Promise(e=>{de=e}),ye=()=>{const e=de;de=null,e?.()},he="1"===process.env.ICOA_LEARN_EMBEDDED,fe=e=>B.cards.find(o=>o.number===e),pe=e=>{const o=B.modules.find(o=>o.cardRange[1]===e);if(!o)return!1;const r=B.modules.find(e=>e.number===o.number+1);return x(B,K,o,r),!0},be=()=>{ie=!0,console.log(chalk.gray(ue?" 按 Enter 进入下一阶段…":" Press Enter to continue to the next phase…"))},we=()=>{const e=fe(K.currentCard);if(!e)return console.log(),console.log(chalk.gray(" No more cards in this curriculum.")),console.log(chalk.gray(" Type ")+chalk.bold.green("status")+chalk.gray(" for the dashboard or ")+chalk.bold.green("quit")+chalk.gray(" to exit.")),void console.log();switch(e.type){case"knowledge":E(e,B),e.check?(oe=e.number,ce=Date.now()):(k(K,e.number),p(K));break;case"mcq":_(e,B),Y=e.number;break;case"practical":D(e,B),ee=e.number;break;case"sim_demo":O(e,B),k(K,e.number),p(K);break;case"milestone":P(e,B),I(K,e.badge),k(K,e.number),p(K);break;case"arena_task":S(e,B),k(K,e.number),p(K);break;case"coming_soon":L(e,B),k(K,e.number),p(K)}},ke=()=>{F.endsWith("DEMO01")?console.log(chalk.yellow(ue?" AI 导师需要开通 AI 的正式课程 token(demo 是共享的,没有 AI 额度)。":" The AI tutor needs an AI-enabled curriculum token — demos are shared and carry no AI budget.")):(console.log(chalk.yellow(ue?" 此 token 未开通 AI 导师(高级功能)。":" This token does not include the AI tutor (premium).")),console.log(chalk.gray(ue?" 找你的领队 / 协调人换开通 AI 的 token。":" Ask your team leader / coordinator for an AI-enabled token."))),console.log()},ve=async(e,o)=>{if(J){le=!0;try{console.log(),console.log(chalk.gray("deep"===o?ue?" 🤖 AI 导师(深度思考中,思考过程为灰色小字)…":" 🤖 AI tutor (deepthink — reasoning shown in gray)…":ue?" 🤖 AI 导师(快速模式)…":" 🤖 AI tutor (quick mode)…")),console.log();let r=!1,n=!1;const l=await d({token:F,cardNumber:K.currentCard,question:e,mode:o,history:te},e=>{"reasoning"===e.kind?(r||(process.stdout.write(" "),r=!0),process.stdout.write(chalk.dim(e.text.replace(/\n/g,"\n ")))):(n||(process.stdout.write(r?"\n\n ":" "),n=!0),process.stdout.write(chalk.white(e.text.replace(/\n/g,"\n "))))});if((r||n)&&console.log(),l.ok){for(te.push({role:"user",content:e},{role:"assistant",content:l.answer});te.length>6;)te.shift();null!=l.spent&&null!=l.cap&&l.spent/l.cap>.8&&console.log(chalk.gray(` (${ue?"AI 额度":"AI budget"}: ${Math.round(l.spent/1e3)}k / ${Math.round(l.cap/1e3)}k tokens)`))}else console.log(),console.log(chalk.yellow(` ${l.message||(ue?"AI 导师暂不可用。":"AI tutor unavailable.")}`));null!==oe&&console.log(chalk.gray(ue?" (本卡的判断题还等着你作答 — y 或 n)":" (the y/n check on this card is still waiting — answer y or n)")),console.log()}finally{le=!1}}else ke()},Ae=async()=>{const e=se.join("\n").trim();if(se.length=0,ae=!1,e.length<30)return console.log(chalk.yellow(ue?" 内容太短(至少写几句话)。已取消。":" Too short (write at least a few sentences). Cancelled.")),void console.log();le=!0;try{console.log(),console.log(chalk.gray(ue?" 📝 提交中,AI 评审中…":" 📝 Submitting — AI is reviewing…"));const o=await m({token:F,cardNumber:K.currentCard,submission:e});if(console.log(),!o.ok)return console.log(chalk.yellow(` ${o.message||(ue?"AI 评审暂不可用。":"AI review unavailable.")}`)),void console.log();const r=o.dimensions??{},n=(o.score??0)>=70?chalk.bold.green:(o.score??0)>=40?chalk.bold.yellow:chalk.bold.red;if(console.log(chalk.gray(" ─────────────────────────────────────────")),console.log((ue?chalk.white(" 研究评分: "):chalk.white(" Research score: "))+n(`${o.score??0} / 100`)),console.log(chalk.gray(` ${ue?"准确":"accuracy"} ${r.accuracy??0}/25 · ${ue?"深度":"depth"} ${r.depth??0}/25 · ${ue?"研究":"research"} ${r.research??0}/25 · ${ue?"清晰":"clarity"} ${r.clarity??0}/25`)),o.feedback){console.log();for(const e of o.feedback.match(/.{1,64}(\s|$)/g)??[o.feedback])console.log(chalk.white(" "+e.trim()))}o.improve&&(console.log(),console.log(chalk.cyan(ue?" 改进建议: ":" To improve: ")+chalk.gray(o.improve))),console.log(chalk.gray(" ─────────────────────────────────────────")),null!=o.spent&&null!=o.cap&&o.spent/o.cap>.8&&console.log(chalk.gray(` (${ue?"AI 额度":"AI budget"}: ${Math.round(o.spent/1e3)}k / ${Math.round(o.cap/1e3)}k tokens)`)),console.log()}finally{le=!1}};G.on("line",e=>{(async e=>{const r=e.trim().toLowerCase();if(!le){if(null!==re){const o=e.trim(),r=re;if(re=null,""===o)console.log(chalk.gray(ue?" 已取消(未提交)。":" Cancelled (nothing submitted)."));else{const e=ce>0?Date.now()-ce:void 0;ge.push(u(F,{curriculum_id:B.id,card_number:r,feedback_text:o,time_on_card_ms:e}).catch(()=>{})),console.log(chalk.green(ue?" ✓ 已收到,谢谢帮助完善这张卡。":" ✓ Thanks — your report was recorded."))}return console.log(),void H()}if(ae){const o=e.trim();return"q"===o||"quit"===o?(ae=!1,se.length=0,console.log(chalk.gray(ue?" 已取消提交。":" Submission cancelled.")),console.log(),void H()):"."===o?(await Ae(),void H()):(se.push(e),G.setPrompt(chalk.gray(" … ")),void G.prompt())}if(ie)return ie=!1,we(),void H();if(r){if(ne){if(["q","quit","exit","back","b","menu"].includes(r))return ne=!1,te.length=0,console.log(chalk.gray(ue?" 已退出 AI 导师,回到卡片。":" Left the AI tutor — back to the card.")),console.log(),void H();const o=e.trim().startsWith("!"),n=o?e.trim().slice(1).trim():e.trim();return n&&await ve(n,o?"fast":"deep"),void H()}if("/ai"===r||"/ai!"===r||r.startsWith("/ai ")||r.startsWith("/ai! ")){if(!J)return ke(),void H();const o=r.startsWith("/ai!"),n=e.trim().slice(o?4:3).trim();if(!n){ne=!0;const e=fe(K.currentCard),o=e?e.title??e.badge??"":"";return console.log(),console.log(chalk.bold.magenta(" 🤖 AI ")+chalk.bold.white(ue?"AI 导师":"AI tutor")+(o?chalk.gray(ue?` — 主题「${o}」`:` — topic “${o}”`):"")),console.log(chalk.gray(ue?" 直接输入问题(默认深度思考) · ! 开头 = 快答 · q = 返回卡片":" Type a question (deepthink by default) · prefix ! = quick answer · q = back to card")),console.log(),void H()}return await ve(n,o?"fast":"deep"),void H()}if("/research"===r||r.startsWith("/research ")||"/submit"===r||r.startsWith("/submit ")){if(!J)return ke(),void H();const o=e.trim().replace(/^\/(research|submit)\s*/i,"");if(o)return se.length=0,se.push(o),await Ae(),void H();ae=!0,se.length=0;const r=fe(K.currentCard),n=r?r.title??r.badge??"":"";return console.log(),console.log(chalk.bold.magenta(" 📝 ")+chalk.bold.white(ue?"研究提交":"Research submit")+(n?chalk.gray(ue?` — 主题「${n}」`:` — topic “${n}”`):"")),console.log(chalk.gray(ue?" 写下你对本主题的研究(可多行)· 单独一行输入 . 提交 · q 取消":" Write your research on this topic (multi-line) · a lone . submits · q cancels")),console.log(),G.setPrompt(chalk.gray(" … ")),void G.prompt()}if("menu"!==r&&"menu confirm"!==r)if("quit"!==r&&"exit"!==r&&"q"!==r){if("status"===r)return q(B,K),void H();if("lang"===r||r.startsWith("lang ")){const e=r.slice(4).trim();if(!e)return console.log(chalk.gray(" 当前语言 / current: ")+chalk.white(y().language||"en")+chalk.gray(" · ")+chalk.bold.green("lang zh")+chalk.gray(" / ")+chalk.bold.green("lang en")),void H();const o=B.cards.some(e=>null!=e._zh),n=e.toLowerCase().startsWith("zh")?"zh":e.toLowerCase(),l="en"===n||"zh"===n&&o,t=l?n:"en";return h({language:t}),l?console.log(chalk.green(" ✓ ")+chalk.gray("语言 / language → ")+chalk.white(t)):console.log(chalk.yellow(" ! ")+chalk.gray(`${e} 本课暂无翻译,已用英文 / not available — using English`)),oe=null,Y=null,ee=null,re=null,ie=!1,we(),void H()}if("sim"===r){const e=fe(K.currentCard);return e&&"sim_demo"===e.type?(function(e){const r=function(){const e=l(a(import.meta.url)),o=[t(e,"..","..","panda","mujoco-launcher.py"),t(e,"..","..","..","panda","mujoco-launcher.py")];for(const e of o)if(n(e))return e;return null}();if(!r)return console.log(chalk.yellow(" MuJoCo launcher not found.")),console.log(chalk.gray(" Get it from: https://github.com/newaipanda/ICOA_CLI/blob/main/panda/mujoco-launcher.py")),void console.log(chalk.gray(" Or use the sandbox-vla docker image (Phase 3)."));const s={baseline:"baseline",prompt_injected:"prompt_inj",patch_attacked:"patch",modality_confused:"confused"}[e]||"baseline";console.log(chalk.gray(` Launching MuJoCo viewer (scenario: ${s})...`)),console.log(chalk.gray(" Close the window or press ESC to return to learn mode.")),o("python3",[r,s,"--seconds","5"],{stdio:"inherit"}).on("exit",e=>{0!==e?console.log(chalk.yellow(` MuJoCo exited with code ${e} (install: pip install mujoco)`)):console.log(chalk.gray(" Returned from sim."))})}(e.simAction),void H()):(console.log(chalk.gray(" (sim only available on simulation cards)")),void H())}if("bookmark"===r){const e=K.currentCard;return K.bookmarks.includes(e)||K.bookmarks.push(e),p(K),console.log(chalk.gray(` ✓ Card ${e} bookmarked.`)),void H()}if("e"===r)return re=K.currentCard,console.log(chalk.gray(ue?" 描述问题(回车提交 / 空行取消):":" Describe the issue (Enter to submit / blank to cancel):")),void H();if("back"===r||"b"===r)return K.currentCard>1&&(K.currentCard-=1),Y=null,ee=null,oe=null,p(K),we(),void H();if(r.startsWith("card ")){const e=r.slice(5).trim(),o=parseInt(e,10);return!Number.isInteger(o)||o<1||o>B.totalCards?(console.log(chalk.yellow(` Card number must be 1..${B.totalCards}. Try: `)+chalk.bold.green("card 1")),void H()):(K.currentCard=o,Y=null,ee=null,oe=null,p(K),we(),void H())}if(null!==oe&&["y","yes","n","no"].includes(r)){const e=fe(oe);if(e&&"knowledge"===e.type&&e.check){const o=r.startsWith("y")?"y":"n",n=o===e.check.answer,l=Date.now()-ce;k(K,e.number),A(K,e.number,{answer:o,correct:n,submittedAt:(new Date).toISOString()}),p(K);const{renderCheckFeedback:t}=await import("../lib/learn-render.js");if(t(e,o,n,!1),ge.push(c(F,{card_number:e.number,event_type:"check_answered",check_answer:o,check_correct:n,time_on_card_ms:l}).catch(()=>{})),oe=null,e.solution&&e.solution.length>0)return void H();if(K.currentCard<B.totalCards){const e=K.currentCard;K.currentCard+=1,p(K),pe(e)?be():we(),H()}else j(B,K),H();return}}if(null!==Y&&["a","b","c","d"].includes(r)){const e=fe(Y);if(e&&"mcq"===e.type){const o=r.toUpperCase(),n=o===e.answer;return v(K,e.number,{answer:o,correct:n,submittedAt:(new Date).toISOString()}),k(K,e.number),p(K),M(e,o,n,K),ge.push(c(F,{card_number:e.number,event_type:"mcq_answered",mcq_answer:o,mcq_correct:n}).catch(()=>{})),Y=null,void(n?K.currentCard<B.totalCards?(K.currentCard+=1,p(K),we()):(j(B,K),H()):H())}}if(null!==ee){if("done"===r){const e=fe(ee);if(e&&"practical"===e.type)return C(K,e.number),k(K,e.number),p(K),T(e),ee=null,void H()}if("skip"===r)return k(K,ee),p(K),console.log(chalk.gray(" Skipped (counts as not completed).")),console.log(),ee=null,void H()}if("ok"===r||"next"===r||"continue"===r||"n"===r){if(null!==Y)return console.log(chalk.yellow(" Please answer the MCQ first (A / B / C / D).")),void H();if(null!==ee)return console.log(chalk.yellow(" Please type ")+chalk.bold.green("done")+chalk.yellow(" or ")+chalk.bold.yellow("skip")+chalk.yellow(" for the practical.")),void H();if(null!==oe)return console.log(chalk.yellow(" Please answer the check above (")+chalk.bold.green("y")+chalk.yellow(" or ")+chalk.bold.green("n")+chalk.yellow(").")),void H();const e=K.currentCard;return K.currentCard+=1,p(K),K.currentCard>B.totalCards?j(B,K):pe(e)?be():we(),void H()}if(null!==oe)return console.log(chalk.yellow(" Please answer the check above (")+chalk.bold.green("y")+chalk.yellow(" or ")+chalk.bold.green("n")+chalk.yellow(").")),void H();if(null!==Y)return console.log(chalk.yellow(" Please answer the MCQ first (A / B / C / D).")),void H();if(null!==ee)return console.log(chalk.yellow(" Please type ")+chalk.bold.green("done")+chalk.yellow(" or ")+chalk.bold.yellow("skip")+chalk.yellow(" for the practical.")),void H();console.log(chalk.gray(" Unknown command. Try: ")+chalk.white("ok")+chalk.gray(" / ")+chalk.white("status")+chalk.gray(" / ")+chalk.white("card N")+chalk.gray(" / ")+chalk.white("/ai")+chalk.gray(" / ")+chalk.white("quit")),H()}else if(ge.length>0&&await Promise.race([Promise.allSettled(ge),new Promise(e=>setTimeout(e,5e3))]),console.log(),console.log(chalk.gray(" Saved. See you next session.")),console.log(chalk.gray(" Streak: ")+chalk.yellow(`🔥 ${K.streakDays} day(s)`)),console.log(),X){G.removeAllListeners("line");for(const e of Z)G.on("line",e);G.prompt(),ye()}else G.removeAllListeners("line"),G.close();else if(ge.length>0&&await Promise.race([Promise.allSettled(ge),new Promise(e=>setTimeout(e,3e3))]),G.removeAllListeners("line"),X||!he){const{returnToMainMenu:e}=await import("../lib/menu-nav.js");e(X?G:void 0),ye()}else G.close()}else H()}})(e).catch(e=>{console.log(),console.log(chalk.red(" ⚠ Something went wrong handling that input.")),console.log(chalk.gray(` ${e instanceof Error?e.message:String(e)}`)),console.log(chalk.gray(" Progress is saved. Type ")+chalk.bold.green("ok")+chalk.gray(" to continue or ")+chalk.bold.green("quit")+chalk.gray(" to exit.")),H()})}),X||G.on("close",async()=>{ge.length>0&&await Promise.race([Promise.allSettled(ge),new Promise(e=>setTimeout(e,5e3))]),he?ye():process.exit(0)});try{we(),H()}catch{if(W("Could not render this card — the curriculum may be malformed."),X){G.removeAllListeners("line");for(const e of Z)G.on("line",e);G.prompt()}else G.close();ye()}await me}),R.command("learn-pull [id]").description("Pre-download learn curricula to ~/.icoa/learn-cache/ for offline use (default: all)").action(async e=>{const o=e?[e.trim()]:["LEARNDEMO01","AI4CTFDEMO01","CTF4AIDEMO01","ai4ctf-96","ai4ctf-360","ctf4ai-96","ctf4ai-360","ctf4eai-96","ctf4eai-360","embodied-ai-100","embodied-ai-480"];console.log(),console.log(chalk.bold.cyan(" ICOA learn-pull — fetching curricula for offline use")),console.log(chalk.gray(" Server: https://practice.icoa2026.au")),console.log();let r=0,n=0,l=0;for(const e of o){process.stdout.write(` ${e.padEnd(22)} `);const o=Date.now(),t=await s(e),a=Date.now()-o;if(t){const e=t.cards,o=Array.isArray(e)?e.length:0,n=JSON.stringify(t).length;l+=n,console.log(chalk.green("✓ ")+chalk.gray(`${o.toString().padStart(3)} cards · ${(n/1024).toFixed(1).padStart(6)} KB · ${a.toString().padStart(4)} ms`)),r++}else console.log(chalk.red("✗ failed (server unreachable or unknown id)")),n++}console.log(),console.log(chalk.gray(" Summary: ")+chalk.green.bold(`${r} cached`)+chalk.gray(` · ${n} failed · total ${(l/1024).toFixed(0)} KB`)),console.log(chalk.gray(" Cache: ")+chalk.cyan("~/.icoa/learn-cache/")),console.log()})}
@@ -212,7 +212,7 @@ export declare const LEARN_SERVER = "https://practice.icoa2026.au";
212
212
  * 3. Stale cache as fallback → if server unreachable but cache exists
213
213
  * 4. null → no cache, no server
214
214
  */
215
- export declare function loadCurriculumById(id: string): Promise<Curriculum | null>;
215
+ export declare function loadCurriculumById(id: string, token?: string): Promise<Curriculum | null>;
216
216
  /**
217
217
  * Server-side validation for EAxxxxxxxx tokens.
218
218
  * Returns curriculum identifier + status; the actual cards are still
@@ -1 +1 @@
1
- export function localized(r,t){if(!t.startsWith("zh")||!r._zh)return r;const e=r._zh,c={...r};for(const r of Object.keys(e))void 0!==e[r]&&(c[r]=e[r]);return c}export function isValidCurriculum(r){if(!r||"object"!=typeof r)return!1;const t=r;return"string"==typeof t.id&&"number"==typeof t.totalCards&&Array.isArray(t.cards)&&Array.isArray(t.modules)}import{readFileSync as r,writeFileSync as t,mkdirSync as e,existsSync as c,statSync as a,utimesSync as n}from"node:fs";import{join as i}from"node:path";import{homedir as o}from"node:os";import{getDeviceFingerprint as u}from"./access.js";const s=i(o(),".icoa","learn-cache");export const LEARN_SERVER="https://practice.icoa2026.au";function d(r){const t=r.replace(/[^A-Za-z0-9_-]/g,"_");return i(s,`${t}.json`)}function l(r){const t=r.replace(/[^A-Za-z0-9_-]/g,"_");return i(s,`${t}.etag`)}export async function loadCurriculumById(i){"ctf4eai-12"===i&&(i="LEARNDEMO01");const o=function(t){const e=d(t);if(!c(e))return null;try{const t=a(e),c=Date.now()-t.mtimeMs;return{curriculum:JSON.parse(r(e,"utf-8")),ageMs:c}}catch{return null}}(i);if(o&&o.ageMs<6048e5&&isValidCurriculum(o.curriculum))return o.curriculum;const u=await async function(t){const e=LEARN_SERVER.replace(/\/$/,"")+"/api/icoa/learn/curriculum/"+encodeURIComponent(t),a={},n=function(t){const e=l(t);if(!c(e))return null;try{return r(e,"utf-8").trim()||null}catch{return null}}(t);n&&(a["If-None-Match"]=n);try{const r=await fetch(e,{headers:a,signal:AbortSignal.timeout(6e4)});if(304===r.status)return{kind:"unchanged"};if(!r.ok)return{kind:"error"};const t=await r.json();if(!t.success||!t.data)return{kind:"error"};if(!isValidCurriculum(t.data))return{kind:"error"};const c=r.headers.get("etag")||r.headers.get("ETag")||void 0;return{kind:"fresh",curriculum:t.data,etag:c||void 0}}catch{return{kind:"error"}}}(i);return"fresh"===u.kind?(function(r,c,a){try{e(s,{recursive:!0}),t(d(r),JSON.stringify(c)),a&&t(l(r),a)}catch{}}(i,u.curriculum,u.etag),u.curriculum):"unchanged"===u.kind&&o&&isValidCurriculum(o.curriculum)?(function(r){try{const t=d(r);if(c(t)){const r=Date.now()/1e3;n(t,r,r)}}catch{}}(i),o.curriculum):o&&isValidCurriculum(o.curriculum)?o.curriculum:null}export async function validateEAToken(r){const t=LEARN_SERVER.replace(/\/$/,"")+"/api/icoa/learn/validate";try{const e=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({token:r.toUpperCase(),device_fingerprint:u()}),signal:AbortSignal.timeout(8e3)});if(!e.ok){const r=await e.json().catch(()=>({}));return{ok:!1,message:r.message||`HTTP ${e.status}`,code:r.code}}const c=await e.json();return c.success&&c.data?{ok:!0,curriculumId:c.data.curriculum_id,status:c.data.status,validUntil:c.data.valid_until,aiEnabled:1===c.data.ai_enabled||!0===c.data.ai_enabled}:{ok:!1,message:c.message||"Validation failed"}}catch(r){return{ok:!1,message:`Network error: ${r instanceof Error?r.message:String(r)}`}}}export async function syncProgress(r,t){if("LEARNDEMO01"===r.toUpperCase())return;const e=LEARN_SERVER.replace(/\/$/,"")+"/api/icoa/learn/progress/"+r.toUpperCase();try{await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({card_number:t.card_number,event_type:t.event_type,mcq_answer:t.mcq_answer,mcq_correct:t.mcq_correct?1:0,check_answer:t.check_answer,check_correct:t.check_correct?1:0,time_on_card_ms:t.time_on_card_ms,device_fingerprint:u()}),signal:AbortSignal.timeout(5e3)})}catch{}}export async function syncCardFeedback(r,t){const e=LEARN_SERVER.replace(/\/$/,"")+"/api/icoa/learn/feedback/"+r.toUpperCase();try{await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({curriculum_id:t.curriculum_id,card_number:t.card_number,feedback_text:t.feedback_text,time_on_card_ms:t.time_on_card_ms}),signal:AbortSignal.timeout(5e3)})}catch{}}
1
+ export function localized(r,e){if(!e.startsWith("zh")||!r._zh)return r;const t=r._zh,n={...r};for(const r of Object.keys(t))void 0!==t[r]&&(n[r]=t[r]);return n}export function isValidCurriculum(r){if(!r||"object"!=typeof r)return!1;const e=r;return"string"==typeof e.id&&"number"==typeof e.totalCards&&Array.isArray(e.cards)&&Array.isArray(e.modules)}import{readFileSync as r,writeFileSync as e,mkdirSync as t,existsSync as n,statSync as a,utimesSync as c}from"node:fs";import{join as i}from"node:path";import{homedir as o}from"node:os";import{getDeviceFingerprint as u}from"./access.js";import{getCliVersion as s}from"./version.js";const d=i(o(),".icoa","learn-cache");export const LEARN_SERVER="https://practice.icoa2026.au";function l(r){const e=r.replace(/[^A-Za-z0-9_-]/g,"_");return i(d,`${e}.json`)}function m(r){const e=r.replace(/[^A-Za-z0-9_-]/g,"_");return i(d,`${e}.etag`)}export async function loadCurriculumById(i,o){"ctf4eai-12"===i&&(i="LEARNDEMO01");const u=function(e){const t=l(e);if(!n(t))return null;try{const e=a(t),n=Date.now()-e.mtimeMs;return{curriculum:JSON.parse(r(t,"utf-8")),ageMs:n}}catch{return null}}(i);if(u&&u.ageMs<6048e5&&isValidCurriculum(u.curriculum))return u.curriculum;const f=await async function(e,t){const a=LEARN_SERVER.replace(/\/$/,"")+"/api/icoa/learn/curriculum/"+encodeURIComponent(e),c={},i=function(e){const t=m(e);if(!n(t))return null;try{return r(t,"utf-8").trim()||null}catch{return null}}(e);i&&(c["If-None-Match"]=i),t&&(c["X-Learn-Token"]=t.toUpperCase()),c["X-ICOA-Client"]=s();try{const r=await fetch(a,{headers:c,signal:AbortSignal.timeout(6e4)});if(304===r.status)return{kind:"unchanged"};if(!r.ok)return{kind:"error"};const e=await r.json();if(!e.success||!e.data)return{kind:"error"};if(!isValidCurriculum(e.data))return{kind:"error"};const t=r.headers.get("etag")||r.headers.get("ETag")||void 0;return{kind:"fresh",curriculum:e.data,etag:t||void 0}}catch{return{kind:"error"}}}(i,o);return"fresh"===f.kind?(function(r,n,a){try{t(d,{recursive:!0}),e(l(r),JSON.stringify(n)),a&&e(m(r),a)}catch{}}(i,f.curriculum,f.etag),f.curriculum):"unchanged"===f.kind&&u&&isValidCurriculum(u.curriculum)?(function(r){try{const e=l(r);if(n(e)){const r=Date.now()/1e3;c(e,r,r)}}catch{}}(i),u.curriculum):u&&isValidCurriculum(u.curriculum)?u.curriculum:null}export async function validateEAToken(r){const e=LEARN_SERVER.replace(/\/$/,"")+"/api/icoa/learn/validate";try{const t=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({token:r.toUpperCase(),device_fingerprint:u()}),signal:AbortSignal.timeout(8e3)});if(!t.ok){const r=await t.json().catch(()=>({}));return{ok:!1,message:r.message||`HTTP ${t.status}`,code:r.code}}const n=await t.json();return n.success&&n.data?{ok:!0,curriculumId:n.data.curriculum_id,status:n.data.status,validUntil:n.data.valid_until,aiEnabled:1===n.data.ai_enabled||!0===n.data.ai_enabled}:{ok:!1,message:n.message||"Validation failed"}}catch(r){return{ok:!1,message:`Network error: ${r instanceof Error?r.message:String(r)}`}}}export async function syncProgress(r,e){if("LEARNDEMO01"===r.toUpperCase())return;const t=LEARN_SERVER.replace(/\/$/,"")+"/api/icoa/learn/progress/"+r.toUpperCase();try{await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({card_number:e.card_number,event_type:e.event_type,mcq_answer:e.mcq_answer,mcq_correct:e.mcq_correct?1:0,check_answer:e.check_answer,check_correct:e.check_correct?1:0,time_on_card_ms:e.time_on_card_ms,device_fingerprint:u()}),signal:AbortSignal.timeout(5e3)})}catch{}}export async function syncCardFeedback(r,e){const t=LEARN_SERVER.replace(/\/$/,"")+"/api/icoa/learn/feedback/"+r.toUpperCase();try{await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({curriculum_id:e.curriculum_id,card_number:e.card_number,feedback_text:e.feedback_text,time_on_card_ms:e.time_on_card_ms}),signal:AbortSignal.timeout(5e3)})}catch{}}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "icoa-cli",
3
- "version": "2.19.368",
3
+ "version": "2.19.369",
4
4
  "description": "ICOA CLI — The world's first CLI-native cyber & AI security olympiad terminal: AI4CTF (Day 1), CTF4AI (Day 2), VLA4CTF (Pioneer Round — embodied AI)",
5
5
  "type": "module",
6
6
  "bin": {