icoa-cli 2.19.356 → 2.19.357

package/dist/lib/learn-render.js

@@ -1 +1,863 @@
-import chalk from"chalk";import o from"string-width";import{localized as e}from"./learn-curricula.js";import{t as n}from"./learn-i18n.js";import{getConfig as l}from"./config.js";import{icoaBannerLines as t}from"./banner.js";import{renderCharts as r,detectCaps as c}from"./render-card.js";function s(){return(l().language||"en").toLowerCase()}const a=64;function g(o="─"){return o.repeat(66)}function i(o,e,n=20){const l=e>0?o/e:0,t=Math.floor(l*n),r=n-t;return`${chalk.green("█".repeat(t))+chalk.gray("░".repeat(r))}  ${(100*l).toFixed(1)}%`}function d(o){return o>=30?chalk.red("🔥🔥🔥 "+o+" days"):o>=7?chalk.yellow("🔥 "+o+" days"):o>=1?chalk.gray("· "+o+" day"+(o>1?"s":"")):chalk.gray("—")}export function renderWelcome(o,e,l){const t=s(),r=e.cardsCompleted.length,c=o.totalCards,a=c-r,y=o.modules.find(o=>e.currentCard>=o.cardRange[0]&&e.currentCard<=o.cardRange[1]),u=/demo/i.test(o.id);if(console.log(),console.log(chalk.cyan("  ╭"+g("═"))),console.log(chalk.cyan("  ║")),console.log(chalk.cyan("  ║ ")+chalk.bold.white("   "+(o.name?.trim()||n("academy_title",t)))),console.log(chalk.cyan("  ║")),l)console.log(chalk.cyan("  ║ ")+chalk.white("   "+n(u?"welcome_new_demo":"welcome_new",t)));else{const o=new Date(e.lastSeenAt),l=Math.floor((Date.now()-o.getTime())/36e5),r=l<1?n("just_now",t):l<24?`${l}${n("ago_hours",t)}`:`${Math.floor(l/24)}${n("ago_days",t)}`;console.log(chalk.cyan("  ║ ")+chalk.white(`   ${n("welcome_back",t)} ${r}`))}console.log(chalk.cyan("  ║"));const h=y?`${y.number}. ${y.name}`:"—";console.log(chalk.cyan("  ║ ")+"   "+chalk.gray(n("module",t).padEnd(11))+chalk.white(h)),console.log(chalk.cyan("  ║ ")+"   "+chalk.gray(n("progress",t).padEnd(11))+i(r,c)+chalk.gray(`  (${r}/${c})`)),console.log(chalk.cyan("  ║ ")+"   "+chalk.gray(n("streak",t).padEnd(11))+d(e.streakDays)),a>0&&e.currentCard<=c&&console.log(chalk.cyan("  ║ ")+"   "+chalk.gray(n("next_card",t).padEnd(11))+chalk.white(`#${e.currentCard} ${n("of",t)} ${c}`)),console.log(chalk.cyan("  ║")),console.log(chalk.cyan("  ╰"+g("═"))),console.log(),console.log(chalk.gray("  ─────────────────────────────────────────────"));const m=0===r?n("continue_start",t):`${n("continue_resume",t)} ${e.currentCard}`;console.log(chalk.bold.green("    continue")+chalk.gray("     "+m)),console.log(chalk.yellow("    status")+chalk.gray("       "+n("status_full",t))),e.bookmarks.length>0&&console.log(chalk.yellow("    bookmarks")+chalk.gray(`    ${e.bookmarks.length} ${n("bookmarks_desc",t)}`)),console.log(chalk.gray("    quit")+chalk.gray("         "+n("quit_desc",t))),console.log(chalk.gray("  ─────────────────────────────────────────────")),console.log()}function y(o,e){const l=s(),t=o.module,r=e.modules.find(o=>o.number===t),c=r?r.name:n("unknown_module",l),g=n("module",l).replace(":","").trim(),i=`${n("card",l)} ${o.number} / ${e.totalCards}  ·  ${g} ${t} · ${c}`;console.log(),console.log(chalk.cyan("  ╭─ ")+chalk.bold.white(i)+" "+chalk.cyan("─".repeat(Math.max(0,a-i.length-4))))}function u(){console.log(chalk.cyan("  ╰"+g())),console.log()}function h(o){console.log(chalk.cyan("  │ ")+chalk.white(o))}function m(){console.log(chalk.cyan("  │"))}const f=/[┌┐└┘├┤┬┴┼─│╔╗╚╝═║╠╣╦╩╬▓▒░█]/;function b(o){return/^(?: {4}|\t)/.test(o)||f.test(o)||/ {3,}/.test(o)}function p(e,n){const l=[];let t="",r=0,c=!1;for(const s of function(e){const n=[],l=e=>{let l="";const t=()=>{l&&(n.push({t:"atom",s:l}),l="")};for(const r of e)" "===r?(t(),n.push({t:"space"})):2===o(r)?(t(),n.push({t:"wide",s:r})):l+=r;t()},t=/`[^`]*`/g;let r,c=0;for(;null!==(r=t.exec(e));)l(e.slice(c,r.index)),n.push({t:"code",s:r[0]}),c=r.index+r[0].length;return l(e.slice(c)),n}(e)){if("space"===s.t){""!==t&&(c=!0);continue}const e=s.s,a=o("code"===s.t?e.replace(/`/g,""):e),g=c?1:0,i="atom"===s.t&&e.length<=2&&/^[.,;:!?)\]}…'"]+$/.test(e);""!==t&&!i&&r+g+a>n?(l.push(t),t=e,r=a,c=!1):(c&&(t+=" ",r+=1,c=!1),t+=e,r+=a)}return t&&l.push(t),l}const w=/\b(?:Common bug|Common mistake|Common error|Pitfall|Gotcha|Footgun)\b[:：]?|\b(?:Warning|Caution)\b[:：]|(?:常见错误|常见陷阱|常见误区|陷阱|注意|警告|误区)[:：]/gi;function _(o,e){const n=e?chalk.bold.white:chalk.white;let l,t="",r=0;for(w.lastIndex=0;null!==(l=w.exec(o));)l.index>r&&(t+=n(o.slice(r,l.index))),t+=chalk.bold.yellow(l[0]),r=l.index+l[0].length;return r<o.length&&(t+=n(o.slice(r))),t}function $(o,e=!1){let n="",l=0;const t=/`([^`]*)`/g;let r;for(;null!==(r=t.exec(o));)r.index>l&&(n+=_(o.slice(l,r.index),e)),n+=chalk.cyan(r[1]),l=r.index+r[0].length;return l<o.length&&(n+=_(o.slice(l),e)),n}function k(o,e=!1){let n=!1;for(const l of o.split("\n"))if(/^\s*```/.test(l))n=!n;else if(n)console.log(chalk.cyan("  │ ")+chalk.cyan(`  ${l}`));else if(""!==l)if(b(l))console.log(chalk.cyan("  │ ")+chalk.white(l));else for(const o of p(l,60))console.log(chalk.cyan("  │ ")+`  ${$(o,e)}`);else m()}function C(o,e){const n=[];for(const l of o.split("\n")){if(""===l){n.push("");continue}if(b(l)){n.push(l);continue}let o="";for(const t of l.split(" "))(o+" "+t).trim().length>e?(n.push(o.trim()),o=t):o=(o+" "+t).trim();o&&n.push(o)}return n}export function renderKnowledgeCard(l,t){const g=s(),i=e(l,g);y(i,t),m();const d=p(i.title,60);for(const o of d)h(chalk.bold.yellow(o));h(chalk.gray("─".repeat(Math.min(Math.max(...d.map(e=>o(e))),a))));const f=!!(l.chart_ids&&l.chart_ids.length>0);if(f&&r(l.chart_ids.slice(0,1),t.charts,c()),i.key_point&&""!==i.key_point.trim()?(f||m(),function(o,e,n){const l=s().startsWith("zh"),t=c().cols,r="-".repeat(Math.min(a,Math.max(24,t-6))),g=l?"要点":"KEY POINT",i=l?`第 ${e} / ${n} 张`:`Card ${e} / ${n}`;console.log(chalk.cyan("  │ ")+chalk.green(r)),console.log(chalk.cyan("  │ ")+chalk.green(`${g}  ·  ${i}`));for(const e of p(o,60))console.log(chalk.cyan("  │ ")+chalk.bold.green("  "+e));console.log(chalk.cyan("  │ ")+chalk.green(r)),m()}(i.key_point,i.number,t.totalCards)):f||m(),i.body.filter(o=>null!=o&&""!==o.trim()).forEach((o,e)=>{const n=0===e?o.match(/^([\s\S]*?(?:[.!?](?=\s|$)|[。！？]))(\s[\s\S]*)?$/):null;if(n&&n[1].trim().length<=180){k(n[1],!0);const o=n[2]?.trimStart();o&&k(o,!1)}else k(o,!1);m()}),i.icoaConnection){h(chalk.magenta("  "+n("icoa_connection",g))),h(chalk.gray("  "+"─".repeat(20)));for(const o of p(i.icoaConnection,60))h("  "+chalk.magenta(o));m()}if(l.check){const o=g.startsWith("zh"),e=l._zh?.checkStatement??l._zh?.check?.statement,n=o?e??l.check.statement:l.check.statement;h(chalk.cyan("  🤔  "+(o?"请回答 (输 y 或 n):":"Quick comprehension check (type y or n):"))),h(chalk.gray("  "+"─".repeat(20)));for(const o of p(n,60))h("  "+chalk.white(o));m()}u(),function(o,e){const n=s().startsWith("zh"),l=c().cols,t="-".repeat(Math.min(a,Math.max(24,l-6))),r=chalk.gray("  "),g=[];o.check?(g.push(chalk.bold.green("[y]")+chalk.gray(n?" 是":" yes")),g.push(chalk.bold.green("[n]")+chalk.gray(n?" 否":" no"))):g.push(chalk.bold.green("[ok]")+chalk.gray(n?" 继续":" next")),g.push(chalk.bold.yellow("[e]")+chalk.gray(n?" 报告问题":" report")),g.push(chalk.bold.cyan("[b]")+chalk.gray(n?" 上一张":" back")),g.push(chalk.bold.cyan("[card N]")+chalk.gray(n?" 跳转":" jump")),g.push(chalk.gray("[quit]")+chalk.gray(n?" 退出":" quit")),console.log(chalk.gray("  "+t)),console.log(chalk.gray("  "+(n?`第 ${o.number} / ${e.totalCards} 张`:`Card ${o.number} / ${e.totalCards}`))),console.log("  "+g.join(r)),console.log(chalk.gray("  "+t)),console.log(chalk.gray("  "+(n?"e = 报告本卡错误,不算作答;提交后回到本题继续":"e = report a problem with this card (not an answer); you return here after"))),console.log(chalk.gray("  "+(n?"更多: bookmark · status · lang zh/en":"more: bookmark · status · lang zh/en"))),console.log()}(l,t)}export function renderCheckFeedback(o,e,n,l=!1){const t=s().startsWith("zh");if(console.log(),n)console.log(chalk.green("  ✓ ")+chalk.white(t?"答对了。":"Correct."));else if(console.log(chalk.yellow("  ✗ ")+chalk.white(t?"记下了,继续。":"Noted — moving on.")),l){const e="y"===o.check?.answer?t?"是":"Yes":t?"否":"No";console.log(chalk.gray("  "+(t?"正确答案: ":"Answer: ")+e+". "+(t?"回看上面那段。":"Re-read the paragraph above.")))}const r=t?o._zh?.solution??o.solution:o.solution;if(r&&r.length>0){console.log(),console.log(chalk.cyan("  📝  "+(t?"解答:":"Worked solution:")));for(const o of r){for(const e of p(o,60))console.log(chalk.white("  "+e));console.log()}}console.log()}function x(o){return[chalk.white("  "+(o?"编著：Charlie Zhu":"Created & edited by Charlie Zhu")),chalk.gray("  "+(o?"ICOA 2026 创始人 · 课程总架构师":"Founder & Chief Curriculum Architect · ICOA 2026"))]}export function renderPhaseComplete(o,e,n,l){const r=s().startsWith("zh"),[c,a]=n.cardRange,g=e.checkResults||{};let i=0,d=0;for(let o=c;o<=a;o++){const e=g[String(o)];e&&(i++,e.correct&&d++)}const y="-".repeat(48);console.log();for(const o of t("  "))console.log(o);console.log(),console.log(chalk.bold.yellow("  "+y)),console.log(chalk.bold.yellow("  "+(r?`阶段 ${n.number} 完成`:`Phase ${n.number} complete`))+chalk.gray("  ·  ")+chalk.white(n.name));const u=i>0&&d===i?chalk.bold.green:chalk.bold.white;console.log(chalk.gray("  "+(r?"理解检查得分: ":"comprehension score: "))+u(`${d}/${i}`)+chalk.gray(0===i?r?"  (本阶段未作答 y/n)":"  (no y/n answered)":"")),l&&console.log(chalk.gray("  "+(r?"下一阶段: ":"next: "))+chalk.bold.cyan(r?`阶段 ${l.number}`:`Phase ${l.number}`)+chalk.gray("  ·  ")+chalk.white(l.name)),console.log(chalk.bold.yellow("  "+y));for(const o of x(r))console.log(o)}export function renderCurriculumComplete(o,e){const n=s().startsWith("zh"),l=e.checkResults||{},r="-".repeat(48);let c=0,a=0;console.log();for(const o of t("  "))console.log(o);console.log(),console.log(chalk.bold.green("  "+r)),console.log(chalk.bold.green("  🏆 "+(n?`${o.name} — 全部完成!`:`${o.name} — complete!`))),console.log(chalk.bold.green("  "+r));for(const e of o.modules){const[o,t]=e.cardRange;let r=0,s=0;for(let e=o;e<=t;e++){const o=l[String(e)];o&&(r++,o.correct&&s++)}c+=r,a+=s;const g=r>0&&s===r?chalk.green:chalk.white;console.log(chalk.gray("  "+(n?`阶段 ${e.number}`:`Phase ${e.number}`).padEnd(8))+g(`${s}/${r}`.padEnd(7))+chalk.gray(e.name))}console.log(chalk.bold.green("  "+r)),console.log(chalk.bold.green("  "+(n?"总分 / overall: ":"Overall: "))+chalk.bold.white(`${a}/${c}`)),console.log(chalk.bold.green("  "+r));for(const o of x(n))console.log(o);console.log()}export function renderMCQCard(o,l){const t=s(),r=e(o,t);y(r,l),m(),h(chalk.bold.yellow("🎯  "+r.title)),h(chalk.gray("─".repeat(Math.min(r.title.length+4,a)))),m();for(const o of C(r.question,60))h("  "+o);m();for(const o of["A","B","C","D"])h(chalk.cyan(`    ${o}.`)+"  "+chalk.white(r.options[o]));m(),u(),console.log(chalk.gray("  "+(t.startsWith("zh")?"输入 ":"Type "))+chalk.bold.green("A")+chalk.gray(" / ")+chalk.bold.green("B")+chalk.gray(" / ")+chalk.bold.green("C")+chalk.gray(" / ")+chalk.bold.green("D")+chalk.gray(" "+n("type_to_answer",t))),console.log()}export function renderMCQFeedback(o,l,t,r){const c=s(),a=e(o,c);console.log(),t?console.log("  "+chalk.bold.green(n("correct",c)+"  ")+chalk.gray(`${n("one_point",c)}  ·  ${l} = ${a.options[l]}`)):console.log("  "+chalk.bold.red(n("not_quite",c)+"  ")+chalk.gray(`${n("you_chose",c)} ${l}; ${n("answer_is",c)} ${a.answer}.`)),console.log(),console.log(chalk.gray("  "+n("explanation",c)));for(const o of C(a.explanation,60))console.log(chalk.gray("    "+o));const g=Object.values(r.mcqResults),i=g.filter(o=>o.correct).length;console.log(),console.log(chalk.gray("  "+n("mcq_accuracy_so_far",c)+" ")+chalk.white(`${i}/${g.length}`)),console.log(),t||(console.log(chalk.gray("  "+n("press_ok_continue",c)+" ")+chalk.bold.green("ok")+chalk.gray(" "+n("to_continue",c))),console.log())}export function renderPracticalCard(o,l){const t=s(),r=e(o,t);y(r,l),m(),h(chalk.bold.yellow("🛠   "+r.title)),h(chalk.gray("─".repeat(Math.min(r.title.length+4,a)))),m();for(const o of C(r.task,60))h("  "+o);if(r.starterCode){m(),h(chalk.gray("  "+n("starter_code",t))),m();for(const o of r.starterCode.split("\n"))h("    "+chalk.cyan(o))}m(),u(),console.log(chalk.gray("  "+n("try_in_sandbox",t)+" ")+chalk.bold.cyan("!python3")+chalk.gray(" "+n("drops_into_python",t))),console.log(chalk.gray("  "+n("when_done",t))),console.log(chalk.gray("    ")+chalk.bold.green("done")+chalk.gray("      "+n("done_desc",t))),console.log(chalk.gray("    ")+chalk.bold.yellow("skip")+chalk.gray("      "+n("skip_desc",t))),console.log(chalk.gray("  card N                 jump to a card by number")),console.log()}export function renderPracticalSuccess(o){const l=s(),t=e(o,l);console.log(),console.log("  "+chalk.bold.green(n("practical_recorded",l))),console.log(),console.log(chalk.gray("  "+n("reference_answer",l)));for(const o of C(t.successHint,60))console.log(chalk.gray("    "+o));console.log(),console.log(chalk.gray("  "+n("press_ok_continue",l)+" ")+chalk.bold.green("ok")+chalk.gray(" "+n("to_continue",l))),console.log()}export function renderSimDemoCard(o,l){const t=s(),r=e(o,t);y(r,l),m(),h(chalk.bold.yellow("🎬  "+r.title)),m();for(const o of C(r.description,60))h("  "+o);m(),h(chalk.gray("  "+n("sim_requires",t))),m(),u(),console.log(chalk.gray("  ")+chalk.bold.cyan("sim")+chalk.gray("                    "+n("sim_launch_desc",t))),console.log(chalk.gray("  ")+chalk.bold.green("ok")+chalk.gray("  /  ")+chalk.bold.green("next")+chalk.gray("     "+n("continue_to_next",t))),console.log(chalk.gray("  bookmark               "+n("bookmark_desc",t))),console.log(chalk.gray("  back                   "+n("back_desc",t))),console.log(chalk.gray("  card N                 jump to a card by number")),console.log(chalk.gray("  quit                   "+n("quit_desc",t))),console.log()}export function renderArenaTaskCard(o,n){const l=s(),t=l.startsWith("zh"),r=e(o,l);y(r,n),m(),h(chalk.bold.cyan("🏟  "+r.title)),h(chalk.gray("  "+r.origin+"  ·  "+r.domain+"  ·  "+r.metric)),m();for(const o of r.statement){for(const e of C(o,60))h("  "+e);m()}h(chalk.bold.green(t?"  核心要点 — baseline → 解法的关键变化":"  CORE DELTA — baseline → solution"));for(const o of r.core_delta)for(const e of C("• "+o,58))h("    "+chalk.white(e));m(),h(chalk.gray((t?"  提交格式: ":"  Submission: ")+r.submission_format)),r.hints&&h(chalk.gray(t?"  本题有 5 级提示 (a–e),进入 arena 后逐级解锁。":"  5 progressive hints (a–e) unlock inside the arena.")),m(),u(),console.log(chalk.gray("  ")+chalk.bold.cyan("arena "+r.task_id)+chalk.gray(t?"   动手做这道题(下载 / 提示 / 提交 / 榜单)":"   open the arena (download / hints / submit / board)")),console.log(chalk.gray("  ")+chalk.bold.green("ok")+chalk.gray("  /  ")+chalk.bold.green("next")+chalk.gray(t?"     继续下一张":"     continue to next")),console.log(chalk.gray("  back                   "+(t?"上一张":"previous"))),console.log(chalk.gray("  card N                 jump to a card by number")),console.log(chalk.gray("  quit                   "+(t?"退出":"exit"))),console.log()}export function renderComingSoonCard(o,n){const l=s(),t=l.startsWith("zh"),r=e(o,l);y(r,n),m(),h(chalk.bold.yellow("🔜  "+r.title)),m();const c=r.note||(t?"这道竞技场题目正在编写中,敬请期待。":"This arena task is coming soon.");for(const o of C(c,60))h("  "+chalk.gray(o));m(),u(),console.log(chalk.gray("  ")+chalk.bold.green("ok")+chalk.gray("  /  ")+chalk.bold.green("next")+chalk.gray(t?"     继续":"     continue")),console.log(chalk.gray("  card N                 jump to a card by number")),console.log(chalk.gray("  quit                   "+(t?"退出":"exit"))),console.log()}export function renderMilestone(o,l){const t=s(),r=e(o,t),c=o.number===l.totalCards;console.log(),console.log(chalk.bold.yellow("  ╭"+g("═"))),console.log(chalk.bold.yellow("  ║")),console.log(chalk.bold.yellow("  ║ ")+chalk.white("              "+n("milestone_header",t))),console.log(chalk.bold.yellow("  ║"));const a=`              ${r.badge}  ${r.emoji}`;console.log(chalk.bold.yellow("  ║ ")+chalk.bold.green(a)),console.log(chalk.bold.yellow("  ║ ")+chalk.gray("              ─".repeat(Math.max(1,Math.floor(r.badge.length/2+2))))),console.log(chalk.bold.yellow("  ║")),console.log(chalk.bold.yellow("  ║ ")+"  "+chalk.gray(n("in_wild_corresponds",t)));for(const o of C(r.realWorldLevel,60))console.log(chalk.bold.yellow("  ║ ")+"    "+chalk.white(o));console.log(chalk.bold.yellow("  ║")),console.log(chalk.bold.yellow("  ║ ")+"  "+chalk.gray(n("whats_next",t)));for(const o of C(r.unlockedNext,60))console.log(chalk.bold.yellow("  ║ ")+"    "+chalk.white(o));console.log(chalk.bold.yellow("  ║")),console.log(chalk.bold.yellow("  ╰"+g("═"))),console.log(),c?(console.log(chalk.gray("  "+n("demo_complete",t))),console.log(),console.log(chalk.gray("  "+n("unlock_full",t)+" ")+chalk.white(n("curriculum_name",t))+chalk.gray(",")),console.log(chalk.gray("  "+n("contact_team_leader",t)+" ")+chalk.bold.yellow("EA")+chalk.gray(" "+n("learn_token",t))),console.log(chalk.gray("  "+n("or_email",t)+" ")+chalk.cyan("australia@icoa2026.au")+chalk.gray(" "+n("for_partnership",t))),console.log(),console.log(chalk.gray("  "+n("type_quit",t)+" ")+chalk.bold.green("quit")+chalk.gray(" "+n("to_exit",t)+" ")+chalk.bold.green("status")+chalk.gray(" "+n("for_dashboard",t)))):(console.log(chalk.gray("  ")+chalk.bold.green("ok")+chalk.gray("  /  ")+chalk.bold.green("next")+chalk.gray("     "+n("continue_to_next",t))),console.log(chalk.gray("  status                 "+n("status_full",t))),console.log(chalk.gray("  card N                 jump to a card by number")),console.log(chalk.gray("  quit                   "+n("quit_desc",t)))),console.log()}export function renderStatus(o,e){const l=s(),t=e.cardsCompleted.length,r=o.totalCards,c=Object.values(e.mcqResults),a=c.filter(o=>o.correct).length;console.log(),console.log(chalk.cyan("  ╭─ ")+chalk.bold.white(n("status_title",l))+" "+chalk.cyan("─".repeat(25))),m(),h("  "+chalk.gray(n("total_progress",l)+" ")+i(t,r)+chalk.gray(`  (${t}/${r})`)),h("  "+chalk.gray(n("streak",l)+" ")+d(e.streakDays)+chalk.gray(`   (${n("longest",l)} ${e.longestStreak})`)),h("  "+chalk.gray(n("mcq_accuracy",l)+" ")+chalk.white(`${a}/${c.length}`)),h("  "+chalk.gray(n("practicals_done",l)+" ")+chalk.white(`${e.practicalsCompleted.length}`)),h("  "+chalk.gray(n("bookmarked",l)+" ")+chalk.white(`${e.bookmarks.length}`)),m();const g=n("module",l).replace(":","").trim();for(const n of o.modules){const[o,l]=n.cardRange,t=e.cardsCompleted.filter(e=>e>=o&&e<=l).length,r=l-o+1;h("  "+(t===r?chalk.green("✓"):t>0?chalk.yellow("▶"):chalk.gray("□"))+" "+chalk.gray(`${g} ${n.number}: `)+chalk.white(`${t}/${r}`)+chalk.gray("  "+n.name))}if(m(),e.achievements.length>0){h("  "+chalk.gray(n("achievements",l)));for(const o of e.achievements)h("    "+chalk.bold.yellow("★ ")+chalk.white(o))}else h("  "+chalk.gray(n("achievements_none",l)));m(),u()}
+/**
+ * Learn-mode rendering helpers.
+ * All output uses chalk (theme.ts sets black background — never use bare console.log).
+ *
+ * Border style: three-sided frame (top / bottom / left). No right border —
+ * variable-length lines (especially with ANSI colour codes) can't be padded
+ * reliably across terminals, so any right edge breaks alignment. Top and
+ * bottom are open-ended horizontal rules; left is a continuous vertical bar.
+ *
+ * i18n: `localized(card, lang)` from learn-curricula.ts applies `_zh` field
+ * overlays on each card. `t(key, lang)` from learn-i18n.ts handles chrome
+ * (welcome screen, prompts, dashboard).
+ */
+import chalk from 'chalk';
+import stringWidth from 'string-width';
+import { localized } from './learn-curricula.js';
+import { t } from './learn-i18n.js';
+import { getConfig } from './config.js';
+import { icoaBannerLines } from './banner.js';
+import { renderCharts, detectCaps } from './render-card.js';
+function lang() {
+    return (getConfig().language || 'en').toLowerCase();
+}
+const W = 64; // content width — drives top/bottom rule length only
+function rule(char = '─') {
+    return char.repeat(W + 2);
+}
+function progressBar(done, total, width = 20) {
+    const ratio = total > 0 ? done / total : 0;
+    const filled = Math.floor(ratio * width);
+    const empty = width - filled;
+    const bar = chalk.green('█'.repeat(filled)) + chalk.gray('░'.repeat(empty));
+    const pct = (ratio * 100).toFixed(1);
+    return `${bar}  ${pct}%`;
+}
+function fireStreak(days) {
+    if (days >= 30)
+        return chalk.red('🔥🔥🔥 ' + days + ' days');
+    if (days >= 7)
+        return chalk.yellow('🔥 ' + days + ' days');
+    if (days >= 1)
+        return chalk.gray('· ' + days + ' day' + (days > 1 ? 's' : ''));
+    return chalk.gray('—');
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Welcome screen
+// ────────────────────────────────────────────────────────────────────────────
+export function renderWelcome(curriculum, state, isNewSession) {
+    const L = lang();
+    const done = state.cardsCompleted.length;
+    const total = curriculum.totalCards;
+    const remaining = total - done;
+    const currentModule = curriculum.modules.find((m) => state.currentCard >= m.cardRange[0] && state.currentCard <= m.cardRange[1]);
+    // Title + "free demo" line are derived from the curriculum itself, never
+    // hardcoded — a fixed "Embodied AI Security Academy / free demo" banner was
+    // wrong for every paid track (ai4ctf/ioai/…). Source of truth = curriculum.name
+    // + an id-based demo check. (Same lesson as the exam header-from-truth rule.)
+    const isDemo = /demo/i.test(curriculum.id);
+    console.log();
+    console.log(chalk.cyan('  ╭' + rule('═')));
+    console.log(chalk.cyan('  ║'));
+    console.log(chalk.cyan('  ║ ') + chalk.bold.white('   ' + (curriculum.name?.trim() || t('academy_title', L))));
+    console.log(chalk.cyan('  ║'));
+    if (isNewSession) {
+        console.log(chalk.cyan('  ║ ') + chalk.white('   ' + t(isDemo ? 'welcome_new_demo' : 'welcome_new', L)));
+    }
+    else {
+        const lastDate = new Date(state.lastSeenAt);
+        const hoursAgo = Math.floor((Date.now() - lastDate.getTime()) / 3600000);
+        const since = hoursAgo < 1
+            ? t('just_now', L)
+            : hoursAgo < 24
+                ? `${hoursAgo}${t('ago_hours', L)}`
+                : `${Math.floor(hoursAgo / 24)}${t('ago_days', L)}`;
+        console.log(chalk.cyan('  ║ ') + chalk.white(`   ${t('welcome_back', L)} ${since}`));
+    }
+    console.log(chalk.cyan('  ║'));
+    const moduleName = currentModule ? `${currentModule.number}. ${currentModule.name}` : '—';
+    console.log(chalk.cyan('  ║ ') + '   ' + chalk.gray(t('module', L).padEnd(11)) + chalk.white(moduleName));
+    console.log(chalk.cyan('  ║ ') +
+        '   ' +
+        chalk.gray(t('progress', L).padEnd(11)) +
+        progressBar(done, total) +
+        chalk.gray(`  (${done}/${total})`));
+    console.log(chalk.cyan('  ║ ') + '   ' + chalk.gray(t('streak', L).padEnd(11)) + fireStreak(state.streakDays));
+    if (remaining > 0 && state.currentCard <= total) {
+        console.log(chalk.cyan('  ║ ') +
+            '   ' +
+            chalk.gray(t('next_card', L).padEnd(11)) +
+            chalk.white(`#${state.currentCard} ${t('of', L)} ${total}`));
+    }
+    console.log(chalk.cyan('  ║'));
+    console.log(chalk.cyan('  ╰' + rule('═')));
+    console.log();
+    console.log(chalk.gray('  ─────────────────────────────────────────────'));
+    const continueLabel = done === 0 ? t('continue_start', L) : `${t('continue_resume', L)} ${state.currentCard}`;
+    console.log(chalk.bold.green('    continue') + chalk.gray('     ' + continueLabel));
+    console.log(chalk.yellow('    status') + chalk.gray('       ' + t('status_full', L)));
+    if (state.bookmarks.length > 0)
+        console.log(chalk.yellow('    bookmarks') + chalk.gray(`    ${state.bookmarks.length} ${t('bookmarks_desc', L)}`));
+    console.log(chalk.gray('    quit') + chalk.gray('         ' + t('quit_desc', L)));
+    console.log(chalk.gray('  ─────────────────────────────────────────────'));
+    console.log();
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Card rendering — varies by type
+// ────────────────────────────────────────────────────────────────────────────
+function cardHeader(card, curriculum) {
+    const L = lang();
+    const moduleNum = card.module;
+    const module = curriculum.modules.find((m) => m.number === moduleNum);
+    const moduleName = module ? module.name : t('unknown_module', L);
+    const moduleLabel = t('module', L).replace(':', '').trim();
+    const header = `${t('card', L)} ${card.number} / ${curriculum.totalCards}  ·  ${moduleLabel} ${moduleNum} · ${moduleName}`;
+    console.log();
+    console.log(chalk.cyan('  ╭─ ') + chalk.bold.white(header) + ' ' + chalk.cyan('─'.repeat(Math.max(0, W - header.length - 4))));
+}
+function cardFooter() {
+    console.log(chalk.cyan('  ╰' + rule()));
+    console.log();
+}
+function bodyLine(text) {
+    console.log(chalk.cyan('  │ ') + chalk.white(text));
+}
+function emptyLine() {
+    console.log(chalk.cyan('  │'));
+}
+// Box-drawing characters used in ASCII diagrams. Arrows (→ ← ↑ ↓) are
+// excluded — they appear inline in 110+ ctf4eai-360 prose paragraphs.
+const BOX_DRAWING = /[┌┐└┘├┤┬┴┼─│╔╗╚╝═║╠╣╦╩╬▓▒░█]/;
+function isPreformatted(line) {
+    return /^(?: {4}|\t)/.test(line) || BOX_DRAWING.test(line) || / {3,}/.test(line);
+}
+function tokenizeForWrap(text) {
+    const toks = [];
+    const pushText = (str) => {
+        let word = '';
+        const flush = () => {
+            if (word) {
+                toks.push({ t: 'atom', s: word });
+                word = '';
+            }
+        };
+        for (const ch of str) {
+            if (ch === ' ') {
+                flush();
+                toks.push({ t: 'space' });
+            }
+            else if (stringWidth(ch) === 2) {
+                flush();
+                toks.push({ t: 'wide', s: ch }); // CJK / emoji — breakable per char
+            }
+            else {
+                word += ch;
+            }
+        }
+        flush();
+    };
+    const re = /`[^`]*`/g;
+    let last = 0;
+    let m;
+    // biome-ignore lint/suspicious/noAssignInExpressions: standard regex-exec loop idiom
+    while ((m = re.exec(text)) !== null) {
+        pushText(text.slice(last, m.index));
+        toks.push({ t: 'code', s: m[0] }); // backticks kept → atomic during wrap
+        last = m.index + m[0].length;
+    }
+    pushText(text.slice(last));
+    return toks;
+}
+function wrapMixed(text, width) {
+    const lines = [];
+    let cur = '';
+    let curW = 0;
+    let pendSpace = false;
+    for (const tok of tokenizeForWrap(text)) {
+        if (tok.t === 'space') {
+            if (cur !== '')
+                pendSpace = true;
+            continue;
+        }
+        const piece = tok.s;
+        const w = stringWidth(tok.t === 'code' ? piece.replace(/`/g, '') : piece);
+        const sep = pendSpace ? 1 : 0;
+        // Short trailing punctuation sticks to the current line (avoids orphaning a
+        // lone "." onto the next line after an over-wide code span).
+        const isPunct = tok.t === 'atom' && piece.length <= 2 && /^[.,;:!?)\]}…'"]+$/.test(piece);
+        if (cur !== '' && !isPunct && curW + sep + w > width) {
+            lines.push(cur);
+            cur = piece;
+            curW = w;
+            pendSpace = false;
+        }
+        else {
+            if (pendSpace) {
+                cur += ' ';
+                curW += 1;
+                pendSpace = false;
+            }
+            cur += piece;
+            curW += w;
+        }
+    }
+    if (cur)
+        lines.push(cur);
+    return lines;
+}
+// Pitfall / warning cue phrases → bold.yellow (#3, "caution" half). Bilingual,
+// bounded set. Ambiguous words (Warning / 注意 / …) require a trailing colon to
+// avoid lighting up ordinary prose; strong phrases (Pitfall / Common bug) don't.
+const PITFALL_RE = /\b(?:Common bug|Common mistake|Common error|Pitfall|Gotcha|Footgun)\b[:：]?|\b(?:Warning|Caution)\b[:：]|(?:常见错误|常见陷阱|常见误区|陷阱|注意|警告|误区)[:：]/gi;
+function emphasize(text, bold) {
+    const base = bold ? chalk.bold.white : chalk.white;
+    let out = '';
+    let last = 0;
+    PITFALL_RE.lastIndex = 0;
+    let m;
+    // biome-ignore lint/suspicious/noAssignInExpressions: standard regex-exec loop idiom
+    while ((m = PITFALL_RE.exec(text)) !== null) {
+        if (m.index > last)
+            out += base(text.slice(last, m.index));
+        out += chalk.bold.yellow(m[0]);
+        last = m.index + m[0].length;
+    }
+    if (last < text.length)
+        out += base(text.slice(last));
+    return out;
+}
+// Strip backticks → inline code cyan; prose via emphasize() (white / bold.white
+// for the lead sentence #3, with pitfall cues lifted to bold.yellow).
+function colorizeInline(s, bold = false) {
+    let out = '';
+    let last = 0;
+    const re = /`([^`]*)`/g;
+    let m;
+    // biome-ignore lint/suspicious/noAssignInExpressions: standard regex-exec loop idiom
+    while ((m = re.exec(s)) !== null) {
+        if (m.index > last)
+            out += emphasize(s.slice(last, m.index), bold);
+        out += chalk.cyan(m[1]);
+        last = m.index + m[0].length;
+    }
+    if (last < s.length)
+        out += emphasize(s.slice(last), bold);
+    return out;
+}
+// Render one body paragraph: ```fenced``` → monospace block (no wrap, cyan);
+// inline `code` → cyan, never split; ASCII diagrams → passthrough; prose → wrap.
+// `bold` paints prose bold.white (used for the lead sentence — #3).
+function renderBodyParagraph(para, bold = false) {
+    let inFence = false;
+    for (const raw of para.split('\n')) {
+        if (/^\s*```/.test(raw)) {
+            inFence = !inFence;
+            continue; // swallow the fence marker line itself
+        }
+        if (inFence) {
+            console.log(chalk.cyan('  │ ') + chalk.cyan(`  ${raw}`));
+            continue;
+        }
+        if (raw === '') {
+            emptyLine();
+            continue;
+        }
+        if (isPreformatted(raw)) {
+            console.log(chalk.cyan('  │ ') + chalk.white(raw));
+            continue;
+        }
+        for (const ln of wrapMixed(raw, W - 4)) {
+            console.log(chalk.cyan('  │ ') + `  ${colorizeInline(ln, bold)}`);
+        }
+    }
+}
+function wrapText(text, width) {
+    const out = [];
+    for (const line of text.split('\n')) {
+        if (line === '') {
+            out.push('');
+            continue;
+        }
+        if (isPreformatted(line)) {
+            out.push(line);
+            continue;
+        }
+        let buf = '';
+        for (const word of line.split(' ')) {
+            if ((buf + ' ' + word).trim().length > width) {
+                out.push(buf.trim());
+                buf = word;
+            }
+            else {
+                buf = (buf + ' ' + word).trim();
+            }
+        }
+        if (buf)
+            out.push(buf);
+    }
+    return out;
+}
+// Green BLUF "key point" band — sandwiched in two ASCII-dash dividers, placed
+// after the visual slot and before the body. Classic black-green CTF look:
+// green dashes + bold-green sentence. Dashes are ASCII '-' (NOT U+2500, which
+// is EAW-ambiguous → CJK width break). The one-liner is an INDEPENDENT
+// proposition (never spoils the y/n). See docs/learn-card-visuals.md.
+function renderKeyPointBand(keyPoint, cardNum, total) {
+    const isZh = lang().startsWith('zh');
+    const cols = detectCaps().cols;
+    const dashes = '-'.repeat(Math.min(W, Math.max(24, cols - 6)));
+    const label = isZh ? '要点' : 'KEY POINT';
+    const cardLabel = isZh ? `第 ${cardNum} / ${total} 张` : `Card ${cardNum} / ${total}`;
+    console.log(chalk.cyan('  │ ') + chalk.green(dashes));
+    console.log(chalk.cyan('  │ ') + chalk.green(`${label}  ·  ${cardLabel}`));
+    for (const ln of wrapMixed(keyPoint, W - 4)) {
+        console.log(chalk.cyan('  │ ') + chalk.bold.green('  ' + ln));
+    }
+    console.log(chalk.cyan('  │ ') + chalk.green(dashes));
+    emptyLine();
+}
+// Poka-yoke action footer for knowledge cards — persistent guidance every
+// screen (Newbie Path Invariant). Adds the `e` report channel + `b` back +
+// `card N` jump, plus the 防呆 one-liner clarifying `e` is not an answer.
+function renderCardActionFooter(card, curriculum) {
+    const isZh = lang().startsWith('zh');
+    const cols = detectCaps().cols;
+    const dashes = '-'.repeat(Math.min(W, Math.max(24, cols - 6)));
+    const sep = chalk.gray('  ');
+    const parts = [];
+    if (card.check) {
+        parts.push(chalk.bold.green('[y]') + chalk.gray(isZh ? ' 是' : ' yes'));
+        parts.push(chalk.bold.green('[n]') + chalk.gray(isZh ? ' 否' : ' no'));
+    }
+    else {
+        parts.push(chalk.bold.green('[ok]') + chalk.gray(isZh ? ' 继续' : ' next'));
+    }
+    parts.push(chalk.bold.yellow('[e]') + chalk.gray(isZh ? ' 报告问题' : ' report'));
+    parts.push(chalk.bold.cyan('[b]') + chalk.gray(isZh ? ' 上一张' : ' back'));
+    parts.push(chalk.bold.cyan('[card N]') + chalk.gray(isZh ? ' 跳转' : ' jump'));
+    parts.push(chalk.gray('[quit]') + chalk.gray(isZh ? ' 退出' : ' quit'));
+    console.log(chalk.gray('  ' + dashes));
+    console.log(chalk.gray('  ' +
+        (isZh ? `第 ${card.number} / ${curriculum.totalCards} 张` : `Card ${card.number} / ${curriculum.totalCards}`)));
+    console.log('  ' + parts.join(sep));
+    console.log(chalk.gray('  ' + dashes));
+    console.log(chalk.gray('  ' +
+        (isZh
+            ? 'e = 报告本卡错误,不算作答;提交后回到本题继续'
+            : 'e = report a problem with this card (not an answer); you return here after')));
+    console.log(chalk.gray('  ' + (isZh ? '更多: bookmark · status · lang zh/en' : 'more: bookmark · status · lang zh/en')));
+    console.log();
+}
+export function renderKnowledgeCard(card, curriculum) {
+    const L = lang();
+    const c = localized(card, L);
+    cardHeader(c, curriculum);
+    emptyLine();
+    const titleLines = wrapMixed(c.title, W - 4);
+    for (const tl of titleLines)
+        bodyLine(chalk.bold.yellow(tl));
+    bodyLine(chalk.gray('─'.repeat(Math.min(Math.max(...titleLines.map((l) => stringWidth(l))), W))));
+    // Slot order: title → ≤1 visual → green key-point band → body.
+    // chart_ids is on the canonical card; localized() preserves it because the
+    // _zh overlay only carries title/body/icoaConnection/checkStatement/key_point.
+    // MAX-ONE: only the first visual id is rendered (docs/learn-card-visuals.md).
+    const hasVisual = !!(card.chart_ids && card.chart_ids.length > 0);
+    if (hasVisual) {
+        renderCharts(card.chart_ids.slice(0, 1), curriculum.charts, detectCaps());
+    }
+    if (c.key_point && c.key_point.trim() !== '') {
+        if (!hasVisual)
+            emptyLine(); // visual already left a trailing blank line
+        renderKeyPointBand(c.key_point, c.number, curriculum.totalCards);
+    }
+    else if (!hasVisual) {
+        emptyLine();
+    }
+    // Drop empty / whitespace-only paragraphs: some cards (e.g. Phase 8) author
+    // body arrays with "" elements as separators, which double-space against the
+    // emptyLine() the loop already adds between paragraphs (looked like 3 blanks).
+    // Filtering first also keeps idx===0 = the first real paragraph (lead bold).
+    c.body
+        .filter((p) => p != null && p.trim() !== '')
+        .forEach((para, idx) => {
+        // #3: bold the lead sentence of the first paragraph (the card's takeaway).
+        // Sentence end = . ! ? followed by space/EOL (skips decimals like 0.75 and
+        // dotted code like np.ndarray) or any CJK terminator 。！？.
+        const lead = idx === 0 ? para.match(/^([\s\S]*?(?:[.!?](?=\s|$)|[。！？]))(\s[\s\S]*)?$/) : null;
+        if (lead && lead[1].trim().length <= 180) {
+            renderBodyParagraph(lead[1], true);
+            const rest = lead[2]?.trimStart();
+            if (rest)
+                renderBodyParagraph(rest, false);
+        }
+        else {
+            renderBodyParagraph(para, false);
+        }
+        emptyLine();
+    });
+    if (c.icoaConnection) {
+        bodyLine(chalk.magenta('  ' + t('icoa_connection', L)));
+        bodyLine(chalk.gray('  ' + '─'.repeat(20)));
+        for (const ln of wrapMixed(c.icoaConnection, W - 4)) {
+            bodyLine('  ' + chalk.magenta(ln));
+        }
+        emptyLine();
+    }
+    // Optional comprehension check — one-keystroke y/n. Pulls the zh override
+    // from card._zh when in zh locale (localized() doesn't reach nested fields).
+    // Supports BOTH the flat seed shape (`_zh.checkStatement`) AND the raw
+    // Claude shape (`_zh.check.statement`) so it works pre- or post-flatten.
+    if (card.check) {
+        const isZh = L.startsWith('zh');
+        const zhStatement = card._zh?.checkStatement ?? card._zh?.check?.statement;
+        const statement = isZh ? (zhStatement ?? card.check.statement) : card.check.statement;
+        bodyLine(chalk.cyan('  🤔  ' + (isZh ? '请回答 (输 y 或 n):' : 'Quick comprehension check (type y or n):')));
+        bodyLine(chalk.gray('  ' + '─'.repeat(20)));
+        for (const ln of wrapMixed(statement, W - 4)) {
+            bodyLine('  ' + chalk.white(ln));
+        }
+        emptyLine();
+    }
+    cardFooter();
+    renderCardActionFooter(card, curriculum);
+}
+// Renders the post-check feedback line. Called from learn.ts after y/n.
+//
+// BASIC tier (default): correct → ✓; wrong → brief ✗ ack ONLY — no answer
+// reveal, no explanation, no pause. Both auto-advance (the card is recorded
+// for the phase-end score either way). Revealing the answer + explanation on
+// a wrong y/n is a PREMIUM learn-token feature (pass premiumExplain=true).
+// See [[project_card_feedback_e]] feedback-tiering.
+export function renderCheckFeedback(card, userAnswer, correct, premiumExplain = false) {
+    const isZh = lang().startsWith('zh');
+    console.log();
+    if (correct) {
+        console.log(chalk.green('  ✓ ') + chalk.white(isZh ? '答对了。' : 'Correct.'));
+    }
+    else {
+        console.log(chalk.yellow('  ✗ ') + chalk.white(isZh ? '记下了,继续。' : 'Noted — moving on.'));
+        if (premiumExplain) {
+            const right = card.check?.answer === 'y' ? (isZh ? '是' : 'Yes') : isZh ? '否' : 'No';
+            console.log(chalk.gray('  ' +
+                (isZh ? '正确答案: ' : 'Answer: ') +
+                right +
+                '. ' +
+                (isZh ? '回看上面那段。' : 'Re-read the paragraph above.')));
+        }
+    }
+    // Worked solution (problem cards): revealed in ALL tiers after the check, both
+    // right and wrong — on a problem card the worked solution IS the lesson. _zh
+    // overlay wins when present. The card pauses after this (learn.ts) so there is
+    // time to read it. Independent of premiumExplain (that gates a one-line hint).
+    const solution = isZh ? (card._zh?.solution ?? card.solution) : card.solution;
+    if (solution && solution.length > 0) {
+        console.log();
+        console.log(chalk.cyan('  📝  ' + (isZh ? '解答:' : 'Worked solution:')));
+        for (const para of solution) {
+            for (const ln of wrapMixed(para, W - 4)) {
+                console.log(chalk.white('  ' + ln));
+            }
+            console.log();
+        }
+    }
+    console.log();
+}
+// Founder sign-off shown at the BOTTOM of score screens (peak-end placement —
+// the name lands at the satisfaction moment, like a film's closing "Directed by").
+// Dim, recedes below the score. NO "Author" (bodies are AI-generated → dispute
+// surface); "Architect" states the real, undisputed contribution. NO jargon.
+// See memory project_learn_attribution_banner_plan.
+function attributionLines(isZh) {
+    return [
+        chalk.white(`  ${isZh ? '编著：Charlie Zhu' : 'Created & edited by Charlie Zhu'}`),
+        chalk.gray(`  ${isZh ? 'ICOA 2026 创始人 · 课程总架构师' : 'Founder & Chief Curriculum Architect · ICOA 2026'}`),
+    ];
+}
+// Phase-end score screen — basic-tier feedback granularity (project_card_feedback_e):
+// shown when a forward advance crosses a module boundary. Computes the y/n score
+// for the just-completed phase and announces the next one. Yellow milestone-style
+// band; ASCII dashes (CJK-safe). Does NOT pause — flows into the next card.
+export function renderPhaseComplete(curriculum, state, done, next) {
+    const isZh = lang().startsWith('zh');
+    const [lo, hi] = done.cardRange;
+    const checks = state.checkResults || {};
+    let answered = 0;
+    let correct = 0;
+    for (let n = lo; n <= hi; n++) {
+        const r = checks[String(n)];
+        if (r) {
+            answered++;
+            if (r.correct)
+                correct++;
+        }
+    }
+    const dashes = '-'.repeat(48);
+    console.log();
+    for (const l of icoaBannerLines('  '))
+        console.log(l);
+    console.log();
+    console.log(chalk.bold.yellow('  ' + dashes));
+    console.log(chalk.bold.yellow('  ' + (isZh ? `阶段 ${done.number} 完成` : `Phase ${done.number} complete`)) +
+        chalk.gray('  ·  ') +
+        chalk.white(done.name));
+    const scoreColor = answered > 0 && correct === answered ? chalk.bold.green : chalk.bold.white;
+    console.log(chalk.gray('  ' + (isZh ? '理解检查得分: ' : 'comprehension score: ')) +
+        scoreColor(`${correct}/${answered}`) +
+        chalk.gray(answered === 0 ? (isZh ? '  (本阶段未作答 y/n)' : '  (no y/n answered)') : ''));
+    if (next) {
+        console.log(chalk.gray('  ' + (isZh ? '下一阶段: ' : 'next: ')) +
+            chalk.bold.cyan(isZh ? `阶段 ${next.number}` : `Phase ${next.number}`) +
+            chalk.gray('  ·  ') +
+            chalk.white(next.name));
+    }
+    console.log(chalk.bold.yellow('  ' + dashes));
+    for (const l of attributionLines(isZh))
+        console.log(l);
+}
+// Curriculum-end OVERALL score — shown after the last card of the last phase.
+// Per-phase y/n breakdown + a grand total across all modules. Green CTF band.
+export function renderCurriculumComplete(curriculum, state) {
+    const isZh = lang().startsWith('zh');
+    const checks = state.checkResults || {};
+    const dashes = '-'.repeat(48);
+    let totA = 0;
+    let totC = 0;
+    console.log();
+    for (const l of icoaBannerLines('  '))
+        console.log(l);
+    console.log();
+    console.log(chalk.bold.green('  ' + dashes));
+    console.log(chalk.bold.green('  🏆 ' + (isZh ? `${curriculum.name} — 全部完成!` : `${curriculum.name} — complete!`)));
+    console.log(chalk.bold.green('  ' + dashes));
+    for (const m of curriculum.modules) {
+        const [lo, hi] = m.cardRange;
+        let a = 0;
+        let c = 0;
+        for (let n = lo; n <= hi; n++) {
+            const r = checks[String(n)];
+            if (r) {
+                a++;
+                if (r.correct)
+                    c++;
+            }
+        }
+        totA += a;
+        totC += c;
+        const col = a > 0 && c === a ? chalk.green : chalk.white;
+        console.log(chalk.gray('  ' + (isZh ? `阶段 ${m.number}` : `Phase ${m.number}`).padEnd(8)) +
+            col(`${c}/${a}`.padEnd(7)) +
+            chalk.gray(m.name));
+    }
+    console.log(chalk.bold.green('  ' + dashes));
+    console.log(chalk.bold.green('  ' + (isZh ? '总分 / overall: ' : 'Overall: ')) + chalk.bold.white(`${totC}/${totA}`));
+    console.log(chalk.bold.green('  ' + dashes));
+    for (const l of attributionLines(isZh))
+        console.log(l);
+    console.log();
+}
+export function renderMCQCard(card, curriculum) {
+    const L = lang();
+    const c = localized(card, L);
+    cardHeader(c, curriculum);
+    emptyLine();
+    bodyLine(chalk.bold.yellow('🎯  ' + c.title));
+    bodyLine(chalk.gray('─'.repeat(Math.min(c.title.length + 4, W))));
+    emptyLine();
+    for (const ln of wrapText(c.question, W - 4))
+        bodyLine('  ' + ln);
+    emptyLine();
+    for (const letter of ['A', 'B', 'C', 'D']) {
+        bodyLine(chalk.cyan(`    ${letter}.`) + '  ' + chalk.white(c.options[letter]));
+    }
+    emptyLine();
+    cardFooter();
+    console.log(chalk.gray('  ' + (L.startsWith('zh') ? '输入 ' : 'Type ')) +
+        chalk.bold.green('A') +
+        chalk.gray(' / ') +
+        chalk.bold.green('B') +
+        chalk.gray(' / ') +
+        chalk.bold.green('C') +
+        chalk.gray(' / ') +
+        chalk.bold.green('D') +
+        chalk.gray(' ' + t('type_to_answer', L)));
+    console.log();
+}
+export function renderMCQFeedback(card, selected, correct, state) {
+    const L = lang();
+    const c = localized(card, L);
+    console.log();
+    if (correct) {
+        console.log('  ' +
+            chalk.bold.green(t('correct', L) + '  ') +
+            chalk.gray(`${t('one_point', L)}  ·  ${selected} = ${c.options[selected]}`));
+    }
+    else {
+        console.log('  ' +
+            chalk.bold.red(t('not_quite', L) + '  ') +
+            chalk.gray(`${t('you_chose', L)} ${selected}; ${t('answer_is', L)} ${c.answer}.`));
+    }
+    console.log();
+    console.log(chalk.gray('  ' + t('explanation', L)));
+    for (const ln of wrapText(c.explanation, W - 4)) {
+        console.log(chalk.gray('    ' + ln));
+    }
+    const mcqEntries = Object.values(state.mcqResults);
+    const correctCount = mcqEntries.filter((e) => e.correct).length;
+    console.log();
+    console.log(chalk.gray('  ' + t('mcq_accuracy_so_far', L) + ' ') + chalk.white(`${correctCount}/${mcqEntries.length}`));
+    console.log();
+    // Correct answers auto-advance (caller bumps the card); only prompt for a
+    // manual continue when wrong, so the student can re-read the explanation.
+    if (!correct) {
+        console.log(chalk.gray('  ' + t('press_ok_continue', L) + ' ') +
+            chalk.bold.green('ok') +
+            chalk.gray(' ' + t('to_continue', L)));
+        console.log();
+    }
+}
+export function renderPracticalCard(card, curriculum) {
+    const L = lang();
+    const c = localized(card, L);
+    cardHeader(c, curriculum);
+    emptyLine();
+    bodyLine(chalk.bold.yellow('🛠   ' + c.title));
+    bodyLine(chalk.gray('─'.repeat(Math.min(c.title.length + 4, W))));
+    emptyLine();
+    for (const ln of wrapText(c.task, W - 4))
+        bodyLine('  ' + ln);
+    if (c.starterCode) {
+        emptyLine();
+        bodyLine(chalk.gray('  ' + t('starter_code', L)));
+        emptyLine();
+        for (const ln of c.starterCode.split('\n')) {
+            bodyLine('    ' + chalk.cyan(ln));
+        }
+    }
+    emptyLine();
+    cardFooter();
+    console.log(chalk.gray('  ' + t('try_in_sandbox', L) + ' ') +
+        chalk.bold.cyan('!python3') +
+        chalk.gray(' ' + t('drops_into_python', L)));
+    console.log(chalk.gray('  ' + t('when_done', L)));
+    console.log(chalk.gray('    ') + chalk.bold.green('done') + chalk.gray('      ' + t('done_desc', L)));
+    console.log(chalk.gray('    ') + chalk.bold.yellow('skip') + chalk.gray('      ' + t('skip_desc', L)));
+    console.log(chalk.gray('  card N                 jump to a card by number'));
+    console.log();
+}
+export function renderPracticalSuccess(card) {
+    const L = lang();
+    const c = localized(card, L);
+    console.log();
+    console.log('  ' + chalk.bold.green(t('practical_recorded', L)));
+    console.log();
+    console.log(chalk.gray('  ' + t('reference_answer', L)));
+    for (const ln of wrapText(c.successHint, W - 4)) {
+        console.log(chalk.gray('    ' + ln));
+    }
+    console.log();
+    console.log(chalk.gray('  ' + t('press_ok_continue', L) + ' ') + chalk.bold.green('ok') + chalk.gray(' ' + t('to_continue', L)));
+    console.log();
+}
+export function renderSimDemoCard(card, curriculum) {
+    const L = lang();
+    const c = localized(card, L);
+    cardHeader(c, curriculum);
+    emptyLine();
+    bodyLine(chalk.bold.yellow('🎬  ' + c.title));
+    emptyLine();
+    for (const ln of wrapText(c.description, W - 4))
+        bodyLine('  ' + ln);
+    emptyLine();
+    bodyLine(chalk.gray('  ' + t('sim_requires', L)));
+    emptyLine();
+    cardFooter();
+    // Action prompts — same style as knowledge cards so students always
+    // know how to advance. Without these the sim_demo is a dead-end.
+    console.log(chalk.gray('  ') + chalk.bold.cyan('sim') + chalk.gray('                    ' + t('sim_launch_desc', L)));
+    console.log(chalk.gray('  ') +
+        chalk.bold.green('ok') +
+        chalk.gray('  /  ') +
+        chalk.bold.green('next') +
+        chalk.gray('     ' + t('continue_to_next', L)));
+    console.log(chalk.gray('  bookmark               ' + t('bookmark_desc', L)));
+    console.log(chalk.gray('  back                   ' + t('back_desc', L)));
+    console.log(chalk.gray('  card N                 jump to a card by number'));
+    console.log(chalk.gray('  quit                   ' + t('quit_desc', L)));
+    console.log();
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Arena task (<track>-frontier) — the READING surface. Hands-on doing lives
+// in the standalone `icoa arena [track] [task]` command (mirrors sim_demo → sim).
+// ────────────────────────────────────────────────────────────────────────────
+export function renderArenaTaskCard(card, curriculum) {
+    const L = lang();
+    const isZh = L.startsWith('zh');
+    const c = localized(card, L);
+    cardHeader(c, curriculum);
+    emptyLine();
+    bodyLine(chalk.bold.cyan('🏟  ' + c.title));
+    bodyLine(chalk.gray('  ' + c.origin + '  ·  ' + c.domain + '  ·  ' + c.metric));
+    emptyLine();
+    for (const para of c.statement) {
+        for (const ln of wrapText(para, W - 4))
+            bodyLine('  ' + ln);
+        emptyLine();
+    }
+    bodyLine(chalk.bold.green(isZh ? '  核心要点 — baseline → 解法的关键变化' : '  CORE DELTA — baseline → solution'));
+    for (const d of c.core_delta) {
+        for (const ln of wrapText('• ' + d, W - 6))
+            bodyLine('    ' + chalk.white(ln));
+    }
+    emptyLine();
+    bodyLine(chalk.gray((isZh ? '  提交格式: ' : '  Submission: ') + c.submission_format));
+    if (c.hints) {
+        bodyLine(chalk.gray(isZh
+            ? '  本题有 5 级提示 (a–e),进入 arena 后逐级解锁。'
+            : '  5 progressive hints (a–e) unlock inside the arena.'));
+    }
+    emptyLine();
+    cardFooter();
+    console.log(chalk.gray('  ') +
+        chalk.bold.cyan('arena ' + c.task_id) +
+        chalk.gray(isZh ? '   动手做这道题(下载 / 提示 / 提交 / 榜单)' : '   open the arena (download / hints / submit / board)'));
+    console.log(chalk.gray('  ') +
+        chalk.bold.green('ok') +
+        chalk.gray('  /  ') +
+        chalk.bold.green('next') +
+        chalk.gray(isZh ? '     继续下一张' : '     continue to next'));
+    console.log(chalk.gray('  back                   ' + (isZh ? '上一张' : 'previous')));
+    console.log(chalk.gray('  card N                 jump to a card by number'));
+    console.log(chalk.gray('  quit                   ' + (isZh ? '退出' : 'exit')));
+    console.log();
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Coming-soon placeholder (frontier-120 partial publish)
+// ────────────────────────────────────────────────────────────────────────────
+export function renderComingSoonCard(card, curriculum) {
+    const L = lang();
+    const isZh = L.startsWith('zh');
+    const c = localized(card, L);
+    cardHeader(c, curriculum);
+    emptyLine();
+    bodyLine(chalk.bold.yellow('🔜  ' + c.title));
+    emptyLine();
+    const note = c.note || (isZh ? '这道竞技场题目正在编写中,敬请期待。' : 'This arena task is coming soon.');
+    for (const ln of wrapText(note, W - 4))
+        bodyLine('  ' + chalk.gray(ln));
+    emptyLine();
+    cardFooter();
+    console.log(chalk.gray('  ') +
+        chalk.bold.green('ok') +
+        chalk.gray('  /  ') +
+        chalk.bold.green('next') +
+        chalk.gray(isZh ? '     继续' : '     continue'));
+    console.log(chalk.gray('  card N                 jump to a card by number'));
+    console.log(chalk.gray('  quit                   ' + (isZh ? '退出' : 'exit')));
+    console.log();
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Milestone — the big celebration
+// ────────────────────────────────────────────────────────────────────────────
+export function renderMilestone(card, curriculum) {
+    const L = lang();
+    const c = localized(card, L);
+    const isFinal = card.number === curriculum.totalCards;
+    console.log();
+    console.log(chalk.bold.yellow('  ╭' + rule('═')));
+    console.log(chalk.bold.yellow('  ║'));
+    console.log(chalk.bold.yellow('  ║ ') + chalk.white('              ' + t('milestone_header', L)));
+    console.log(chalk.bold.yellow('  ║'));
+    const badgeLine = `              ${c.badge}  ${c.emoji}`;
+    console.log(chalk.bold.yellow('  ║ ') + chalk.bold.green(badgeLine));
+    console.log(chalk.bold.yellow('  ║ ') + chalk.gray('              ─'.repeat(Math.max(1, Math.floor(c.badge.length / 2 + 2)))));
+    console.log(chalk.bold.yellow('  ║'));
+    console.log(chalk.bold.yellow('  ║ ') + '  ' + chalk.gray(t('in_wild_corresponds', L)));
+    for (const ln of wrapText(c.realWorldLevel, W - 4)) {
+        console.log(chalk.bold.yellow('  ║ ') + '    ' + chalk.white(ln));
+    }
+    console.log(chalk.bold.yellow('  ║'));
+    console.log(chalk.bold.yellow('  ║ ') + '  ' + chalk.gray(t('whats_next', L)));
+    for (const ln of wrapText(c.unlockedNext, W - 4)) {
+        console.log(chalk.bold.yellow('  ║ ') + '    ' + chalk.white(ln));
+    }
+    console.log(chalk.bold.yellow('  ║'));
+    console.log(chalk.bold.yellow('  ╰' + rule('═')));
+    console.log();
+    if (isFinal) {
+        // Curriculum-end ceremony — what LEARNDEMO01 + n=100/480 ends with.
+        console.log(chalk.gray('  ' + t('demo_complete', L)));
+        console.log();
+        console.log(chalk.gray('  ' + t('unlock_full', L) + ' ') + chalk.white(t('curriculum_name', L)) + chalk.gray(','));
+        console.log(chalk.gray('  ' + t('contact_team_leader', L) + ' ') +
+            chalk.bold.yellow('EA') +
+            chalk.gray(' ' + t('learn_token', L)));
+        console.log(chalk.gray('  ' + t('or_email', L) + ' ') +
+            chalk.cyan('australia@icoa2026.au') +
+            chalk.gray(' ' + t('for_partnership', L)));
+        console.log();
+        console.log(chalk.gray('  ' + t('type_quit', L) + ' ') +
+            chalk.bold.green('quit') +
+            chalk.gray(' ' + t('to_exit', L) + ' ') +
+            chalk.bold.green('status') +
+            chalk.gray(' ' + t('for_dashboard', L)));
+    }
+    else {
+        // Mid-curriculum phase-end — must show advance prompt, not "quit".
+        console.log(chalk.gray('  ') +
+            chalk.bold.green('ok') +
+            chalk.gray('  /  ') +
+            chalk.bold.green('next') +
+            chalk.gray('     ' + t('continue_to_next', L)));
+        console.log(chalk.gray('  status                 ' + t('status_full', L)));
+        console.log(chalk.gray('  card N                 jump to a card by number'));
+        console.log(chalk.gray('  quit                   ' + t('quit_desc', L)));
+    }
+    console.log();
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Status dashboard
+// ────────────────────────────────────────────────────────────────────────────
+export function renderStatus(curriculum, state) {
+    const L = lang();
+    const done = state.cardsCompleted.length;
+    const total = curriculum.totalCards;
+    const mcqEntries = Object.values(state.mcqResults);
+    const mcqCorrect = mcqEntries.filter((e) => e.correct).length;
+    console.log();
+    console.log(chalk.cyan('  ╭─ ') + chalk.bold.white(t('status_title', L)) + ' ' + chalk.cyan('─'.repeat(25)));
+    emptyLine();
+    bodyLine('  ' + chalk.gray(t('total_progress', L) + ' ') + progressBar(done, total) + chalk.gray(`  (${done}/${total})`));
+    bodyLine('  ' +
+        chalk.gray(t('streak', L) + ' ') +
+        fireStreak(state.streakDays) +
+        chalk.gray(`   (${t('longest', L)} ${state.longestStreak})`));
+    bodyLine('  ' + chalk.gray(t('mcq_accuracy', L) + ' ') + chalk.white(`${mcqCorrect}/${mcqEntries.length}`));
+    bodyLine('  ' + chalk.gray(t('practicals_done', L) + ' ') + chalk.white(`${state.practicalsCompleted.length}`));
+    bodyLine('  ' + chalk.gray(t('bookmarked', L) + ' ') + chalk.white(`${state.bookmarks.length}`));
+    emptyLine();
+    const moduleLabel = t('module', L).replace(':', '').trim();
+    for (const m of curriculum.modules) {
+        const [lo, hi] = m.cardRange;
+        const inRange = state.cardsCompleted.filter((c) => c >= lo && c <= hi).length;
+        const moduleTotal = hi - lo + 1;
+        const status = inRange === moduleTotal ? chalk.green('✓') : inRange > 0 ? chalk.yellow('▶') : chalk.gray('□');
+        bodyLine('  ' +
+            status +
+            ' ' +
+            chalk.gray(`${moduleLabel} ${m.number}: `) +
+            chalk.white(`${inRange}/${moduleTotal}`) +
+            chalk.gray('  ' + m.name));
+    }
+    emptyLine();
+    if (state.achievements.length > 0) {
+        bodyLine('  ' + chalk.gray(t('achievements', L)));
+        for (const a of state.achievements) {
+            bodyLine('    ' + chalk.bold.yellow('★ ') + chalk.white(a));
+        }
+    }
+    else {
+        bodyLine('  ' + chalk.gray(t('achievements_none', L)));
+    }
+    emptyLine();
+    cardFooter();
+}