icoa-cli 2.19.100 → 2.19.101

package/dist/commands/files.js

@@ -1,52 +1 @@
-import { join } from 'node:path';
-import { homedir } from 'node:os';
-import chalk from 'chalk';
-import { CTFdClient } from '../lib/ctfd-client.js';
-import { getConfig, isConnected } from '../lib/config.js';
-import { logCommand } from '../lib/logger.js';
-import { printError, createSpinner } from '../lib/ui.js';
-export function registerFilesCommand(program) {
-    program
-        .command('files <id>')
-        .description('Download challenge files')
-        .action(async (id) => {
-        logCommand(`files ${id}`);
-        const config = getConfig();
-        if (!isConnected()) {
-            printError('Not connected. Run: join <url>');
-            return;
-        }
-        const client = new CTFdClient(config.ctfdUrl, config.token);
-        const destDir = join(homedir(), 'icoa-challenges', id);
-        const spinner = createSpinner('Fetching challenge files...');
-        spinner.start();
-        try {
-            const files = await client.getChallengeFiles(parseInt(id));
-            if (!files || files.length === 0) {
-                spinner.info('No files attached to this challenge.');
-                return;
-            }
-            spinner.text = `Downloading ${files.length} file(s)...`;
-            const downloaded = [];
-            for (const filePath of files) {
-                try {
-                    const dest = await client.downloadFile(filePath, destDir);
-                    downloaded.push(dest);
-                }
-                catch (err) {
-                    spinner.warn(`Failed to download: ${filePath}`);
-                }
-            }
-            spinner.succeed(`Downloaded ${downloaded.length} file(s)`);
-            console.log(chalk.gray(`  Location: ${destDir}`));
-            for (const f of downloaded) {
-                console.log(chalk.gray(`    → ${f.split('/').pop()}`));
-            }
-            console.log();
-        }
-        catch (err) {
-            spinner.fail('Failed to download files');
-            printError(err.message);
-        }
-    });
-}
+import{join as o}from"node:path";import{homedir as e}from"node:os";import chalk from"chalk";import{CTFdClient as t}from"../lib/ctfd-client.js";import{getConfig as l,isConnected as n}from"../lib/config.js";import{logCommand as i}from"../lib/logger.js";import{printError as s,createSpinner as a}from"../lib/ui.js";export function registerFilesCommand(c){c.command("files <id>").description("Download challenge files").action(async c=>{i(`files ${c}`);const r=l();if(!n())return void s("Not connected. Run: join <url>");const f=new t(r.ctfdUrl,r.token),d=o(e(),"icoa-challenges",c),g=a("Fetching challenge files...");g.start();try{const o=await f.getChallengeFiles(parseInt(c));if(!o||0===o.length)return void g.info("No files attached to this challenge.");g.text=`Downloading ${o.length} file(s)...`;const e=[];for(const t of o)try{const o=await f.downloadFile(t,d);e.push(o)}catch(o){g.warn(`Failed to download: ${t}`)}g.succeed(`Downloaded ${e.length} file(s)`),console.log(chalk.gray(`  Location: ${d}`));for(const o of e)console.log(chalk.gray(`    → ${o.split("/").pop()}`));console.log()}catch(o){g.fail("Failed to download files"),s(o.message)}})}

package/dist/commands/hint.js

@@ -1,119 +1 @@
-import chalk from 'chalk';
-import { generateHint } from '../lib/gemini.js';
-import { checkBudget, deductBudget, getBudgetDisplay, isTokenCapReached } from '../lib/budget.js';
-import { getConfig } from '../lib/config.js';
-import { logHint } from '../lib/logger.js';
-import { printError, printMarkdown, printHeader, createSpinner } from '../lib/ui.js';
-function getChallengeContext() {
-    const config = getConfig();
-    if (config.currentChallengeName && config.currentChallengeCategory) {
-        return {
-            name: config.currentChallengeName,
-            category: config.currentChallengeCategory,
-        };
-    }
-    return undefined;
-}
-async function handleHint(level, question) {
-    const config = getConfig();
-    // Check token cap
-    if (isTokenCapReached()) {
-        printError('Token cap reached. No more AI hints available.');
-        return;
-    }
-    // Check budget
-    const { allowed, remaining } = checkBudget(level);
-    if (!allowed) {
-        printError(`Level ${level} hint budget exhausted (0 remaining).`);
-        return;
-    }
-    // Level C warning (no confirm — crashes REPL)
-    if (level === 'C') {
-        console.log(chalk.red.bold(`  Warning: Using 1 of ${remaining} Critical Assists remaining.`));
-    }
-    // Log BEFORE API call
-    logHint(level, question, config.currentChallengeId || undefined);
-    const context = getChallengeContext();
-    const levelNames = {
-        A: 'General Guidance',
-        B: 'Deep Analysis',
-        C: 'Critical Assist',
-    };
-    const spinner = createSpinner(`Getting Level ${level} hint (${levelNames[level]})...`);
-    spinner.start();
-    try {
-        const result = await generateHint(level, question, context);
-        spinner.stop();
-        // Deduct budget after successful response
-        deductBudget(level, result.tokensUsed);
-        printHeader(`Level ${level} Hint — ${levelNames[level]}`);
-        printMarkdown(result.text);
-        // Budget summary after hint
-        const afterBudget = checkBudget(level);
-        console.log();
-        console.log(chalk.gray('  ─────────────────────────────────────────────'));
-        console.log(chalk.gray(`  Tokens used: ${result.tokensUsed} | Level ${level} remaining: ${afterBudget.remaining}`));
-        // Suggest next level if stuck
-        if (level === 'A') {
-            const bBudget = checkBudget('B');
-            console.log(chalk.gray('  Need more detail? ') + chalk.white('hint-b "your question"') + chalk.gray(` (${bBudget.remaining} left)`));
-        }
-        else if (level === 'B') {
-            const cBudget = checkBudget('C');
-            if (cBudget.remaining > 0) {
-                console.log(chalk.gray('  Still stuck? ') + chalk.white('hint-c "your question"') + chalk.gray(` (${cBudget.remaining} Critical Assists left)`));
-            }
-        }
-        console.log(chalk.gray('  ─────────────────────────────────────────────'));
-        console.log();
-    }
-    catch (err) {
-        spinner.fail('Hint generation failed');
-        printError(err.message);
-    }
-}
-function showBudget() {
-    printHeader('Hint Budget');
-    console.log(getBudgetDisplay());
-    console.log();
-    console.log(chalk.gray('  How to use hints:'));
-    console.log(chalk.white('    hint "what is XSS?"') + chalk.gray('          Level A — General guidance'));
-    console.log(chalk.white('    hint-b "analyze this code"') + chalk.gray('   Level B — Deep analysis'));
-    console.log(chalk.white('    hint-c "I\'m completely stuck"') + chalk.gray(' Level C — Critical assist'));
-    console.log();
-}
-export function registerHintCommands(program) {
-    // ─── icoa hint <question> ───
-    // Special case: "icoa hint budget" shows budget instead of querying AI
-    program
-        .command('hint <question...>')
-        .description('Level A hint — General guidance (use "hint budget" to check remaining)')
-        .action(async (words) => {
-        if (words[0] === 'budget') {
-            showBudget();
-            return;
-        }
-        await handleHint('A', words.join(' '));
-    });
-    // ─── icoa hint-b <question> ───
-    program
-        .command('hint-b <question...>')
-        .description('Level B hint — Deep analysis')
-        .action(async (words) => {
-        await handleHint('B', words.join(' '));
-    });
-    // ─── icoa hint-c <question> ───
-    program
-        .command('hint-c <question...>')
-        .description('Level C hint — Critical assist (confirmation required)')
-        .action(async (words) => {
-        await handleHint('C', words.join(' '));
-    });
-    // ─── icoa hint-budget (alternative) ───
-    program
-        .command('hint-budget')
-        .description('Show remaining hint budget')
-        .action(() => {
-        showBudget();
-    });
-}
+import chalk from"chalk";import{generateHint as e}from"../lib/gemini.js";import{checkBudget as n,deductBudget as i,getBudgetDisplay as o,isTokenCapReached as t}from"../lib/budget.js";import{getConfig as a}from"../lib/config.js";import{logHint as s}from"../lib/logger.js";import{printError as l,printMarkdown as r,printHeader as c,createSpinner as g}from"../lib/ui.js";async function m(o,m){const u=a();if(t())return void l("Token cap reached. No more AI hints available.");const{allowed:d,remaining:h}=n(o);if(!d)return void l(`Level ${o} hint budget exhausted (0 remaining).`);"C"===o&&console.log(chalk.red.bold(`  Warning: Using 1 of ${h} Critical Assists remaining.`)),s(o,m,u.currentChallengeId||void 0);const y=function(){const e=a();if(e.currentChallengeName&&e.currentChallengeCategory)return{name:e.currentChallengeName,category:e.currentChallengeCategory}}(),f={A:"General Guidance",B:"Deep Analysis",C:"Critical Assist"},C=g(`Getting Level ${o} hint (${f[o]})...`);C.start();try{const t=await e(o,m,y);C.stop(),i(o,t.tokensUsed),c(`Level ${o} Hint — ${f[o]}`),r(t.text);const a=n(o);if(console.log(),console.log(chalk.gray("  ─────────────────────────────────────────────")),console.log(chalk.gray(`  Tokens used: ${t.tokensUsed} | Level ${o} remaining: ${a.remaining}`)),"A"===o){const e=n("B");console.log(chalk.gray("  Need more detail? ")+chalk.white('hint-b "your question"')+chalk.gray(` (${e.remaining} left)`))}else if("B"===o){const e=n("C");e.remaining>0&&console.log(chalk.gray("  Still stuck? ")+chalk.white('hint-c "your question"')+chalk.gray(` (${e.remaining} Critical Assists left)`))}console.log(chalk.gray("  ─────────────────────────────────────────────")),console.log()}catch(e){C.fail("Hint generation failed"),l(e.message)}}function u(){c("Hint Budget"),console.log(o()),console.log(),console.log(chalk.gray("  How to use hints:")),console.log(chalk.white('    hint "what is XSS?"')+chalk.gray("          Level A — General guidance")),console.log(chalk.white('    hint-b "analyze this code"')+chalk.gray("   Level B — Deep analysis")),console.log(chalk.white('    hint-c "I\'m completely stuck"')+chalk.gray(" Level C — Critical assist")),console.log()}export function registerHintCommands(e){e.command("hint <question...>").description('Level A hint — General guidance (use "hint budget" to check remaining)').action(async e=>{"budget"!==e[0]?await m("A",e.join(" ")):u()}),e.command("hint-b <question...>").description("Level B hint — Deep analysis").action(async e=>{await m("B",e.join(" "))}),e.command("hint-c <question...>").description("Level C hint — Critical assist (confirmation required)").action(async e=>{await m("C",e.join(" "))}),e.command("hint-budget").description("Show remaining hint budget").action(()=>{u()})}

package/dist/commands/lang.js

@@ -1,155 +1 @@
-import chalk from 'chalk';
-import { getConfig, saveConfig } from '../lib/config.js';
-import { getExamState } from '../lib/exam-state.js';
-import { logCommand } from '../lib/logger.js';
-import { printSuccess, printError, printInfo } from '../lib/ui.js';
-import { SUPPORTED_LANGUAGES } from '../types/index.js';
-const LANG_NAMES = {
-    en: 'English',
-    zh: '中文 (Chinese)',
-    ja: '日本語 (Japanese)',
-    ko: '한국어 (Korean)',
-    es: 'Español (Spanish)',
-    ar: 'العربية (Arabic)',
-    fr: 'Français (French)',
-    pt: 'Português (Portuguese)',
-    ru: 'Русский (Russian)',
-    hi: 'हिन्दी (Hindi)',
-    de: 'Deutsch (German)',
-    id: 'Bahasa (Indonesian)',
-    th: 'ไทย (Thai)',
-    vi: 'Tiếng Việt (Vietnamese)',
-    tr: 'Türkçe (Turkish)',
-    uk: 'Українська (Ukrainian)',
-    ht: 'Kreyòl (Haitian Creole)',
-};
-export function registerLangCommand(program) {
-    program
-        .command('lang [code]')
-        .description('Switch display language')
-        .action(async (code) => {
-        logCommand(`lang ${code || ''}`);
-        if (!code) {
-            const config = getConfig();
-            printInfo(`Current language: ${chalk.white(LANG_NAMES[config.language] || config.language)}`);
-            console.log();
-            console.log(chalk.gray('  Supported languages:'));
-            for (const lang of SUPPORTED_LANGUAGES) {
-                const current = config.language === lang ? chalk.yellow(' ← current') : '';
-                console.log(`    ${chalk.white(lang)}  ${LANG_NAMES[lang]}${current}`);
-            }
-            console.log();
-            console.log(chalk.gray('  Switch now: ') + chalk.cyan('lang <code>') + chalk.gray('   (e.g. ') + chalk.cyan('lang es') + chalk.gray(')'));
-            console.log(chalk.gray('  No "back" needed — you are still at the ') + chalk.cyan('icoa>') + chalk.gray(' prompt.'));
-            console.log();
-            return;
-        }
-        if (!SUPPORTED_LANGUAGES.includes(code)) {
-            printError(`Unsupported language: ${code}`);
-            const supported = SUPPORTED_LANGUAGES.map((l) => `${l} (${LANG_NAMES[l]?.split(' ')[0] || l})`).join(', ');
-            printInfo(`Supported: ${supported}`);
-            return;
-        }
-        saveConfig({ language: code });
-        printSuccess(`Language set to: ${LANG_NAMES[code] || code}`);
-        // If demo in progress, re-translate each drawn question in place using
-        // sourceNumber + sourceOrder so the user's answers and option positions are
-        // preserved. If an older state lacks these fields (pre-v2.19.22), fall back
-        // to restart-with-fresh-pick so nothing crashes.
-        const state = getExamState();
-        if (state && state.session.examId === 'demo-free') {
-            try {
-                const { pickDemoQuestions, getLocalizedDemoSession, getLocalizedDemoQuestions, getLocalizedExplanations, DEMO_PICK_SIZE, } = await import('../lib/demo-exam.js');
-                const { saveExamState } = await import('../lib/exam-state.js');
-                const canRetranslate = state.questions.every((q) => q.sourceNumber != null && Array.isArray(q.sourceOrder) && q.sourceOrder.length === 4);
-                if (canRetranslate) {
-                    const pool = getLocalizedDemoQuestions();
-                    const explanations = getLocalizedExplanations();
-                    state.questions = state.questions.map((q) => {
-                        const src = pool.find((p) => p.number === q.sourceNumber);
-                        if (!src || !q.sourceOrder)
-                            return q;
-                        return {
-                            ...q,
-                            text: src.text,
-                            category: src.category,
-                            options: {
-                                A: src.options[q.sourceOrder[0]],
-                                B: src.options[q.sourceOrder[1]],
-                                C: src.options[q.sourceOrder[2]],
-                                D: src.options[q.sourceOrder[3]],
-                            },
-                            explanation: explanations[q.sourceNumber],
-                        };
-                    });
-                    state.session.examName = getLocalizedDemoSession().examName;
-                    saveExamState(state);
-                    const currentQ = state._lastQ || 1;
-                    console.log();
-                    console.log(chalk.green(`  Demo continues in ${LANG_NAMES[code] || code}. Your progress is kept.`));
-                    console.log(chalk.white(`  Resume: exam q ${currentQ}`));
-                }
-                else {
-                    // Legacy state from before v2.19.22 — safely reset
-                    state.questions = pickDemoQuestions(DEMO_PICK_SIZE);
-                    state.answers = {};
-                    state.session.examName = getLocalizedDemoSession().examName;
-                    state.session.startedAt = new Date().toISOString();
-                    state._lastQ = 1;
-                    saveExamState(state);
-                    console.log();
-                    console.log(chalk.green(`  Demo restarted in ${LANG_NAMES[code] || code}.`));
-                    console.log(chalk.white('  Type: exam q 1'));
-                }
-            }
-            catch {
-                console.log(chalk.gray('  Language changed. Type: demo'));
-            }
-        }
-        else if (state && state.session.token) {
-            // Real exam with token: re-fetch questions in new language from server
-            try {
-                const { getConfig } = await import('../lib/config.js');
-                const { saveExamState } = await import('../lib/exam-state.js');
-                const { getDeviceFingerprint } = await import('../lib/access.js');
-                const config = getConfig();
-                const serverUrl = config.ctfdUrl || 'https://practice.icoa2026.au';
-                const token = state.session.token;
-                const res = await fetch(`${serverUrl}/api/icoa/exam-token`, {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ token, deviceHash: getDeviceFingerprint(), lang: code }),
-                    signal: AbortSignal.timeout(10000),
-                });
-                if (res.ok) {
-                    const json = await res.json();
-                    const newQuestions = json.data.questions;
-                    // Keep answers, interactions, aiUsage — only update question text
-                    state.questions = newQuestions;
-                    saveExamState(state);
-                    const currentQ = state._lastQ || 1;
-                    console.log();
-                    printSuccess(`Exam questions updated to ${LANG_NAMES[code] || code}. Your answers are kept.`);
-                    console.log(chalk.white(`  Resume: exam q ${currentQ}`));
-                }
-                else {
-                    // Most common cause here: the stored session's token was already
-                    // submitted on the server (409) or the exam window has closed.
-                    // Surface the recovery path so the user isn't locked out.
-                    console.log(chalk.yellow('  Could not reload questions in new language.'));
-                    console.log(chalk.gray('  The saved session may be expired or already submitted server-side.'));
-                    console.log(chalk.gray('  To abandon it and start fresh: ') + chalk.bold.cyan('back') + chalk.gray(' → ') + chalk.bold.cyan('exam reset') + chalk.gray(' → ') + chalk.bold.cyan('exam <new-token>'));
-                }
-            }
-            catch {
-                console.log(chalk.yellow('  Could not reach server. Language changed for UI only.'));
-            }
-        }
-        else if (state) {
-            const currentQ = state._lastQ || 1;
-            console.log();
-            console.log(chalk.gray(`  Exam in progress — resuming Q${currentQ}:`));
-            console.log(chalk.white(`  Type: exam q ${currentQ}`));
-        }
-    });
-}
+import chalk from"chalk";import{getConfig as e,saveConfig as o}from"../lib/config.js";import{getExamState as s}from"../lib/exam-state.js";import{logCommand as a}from"../lib/logger.js";import{printSuccess as n,printError as t,printInfo as i}from"../lib/ui.js";import{SUPPORTED_LANGUAGES as r}from"../types/index.js";const l={en:"English",zh:"中文 (Chinese)",ja:"日本語 (Japanese)",ko:"한국어 (Korean)",es:"Español (Spanish)",ar:"العربية (Arabic)",fr:"Français (French)",pt:"Português (Portuguese)",ru:"Русский (Russian)",hi:"हिन्दी (Hindi)",de:"Deutsch (German)",id:"Bahasa (Indonesian)",th:"ไทย (Thai)",vi:"Tiếng Việt (Vietnamese)",tr:"Türkçe (Turkish)",uk:"Українська (Ukrainian)",ht:"Kreyòl (Haitian Creole)",sw:"Kiswahili (Swahili)"};export function registerLangCommand(c){c.command("lang [code]").description("Switch display language").action(async c=>{if(a(`lang ${c||""}`),!c){const o=e();i(`Current language: ${chalk.white(l[o.language]||o.language)}`),console.log(),console.log(chalk.gray("  Supported languages:"));for(const e of r){const s=o.language===e?chalk.yellow(" ← current"):"";console.log(`    ${chalk.white(e)}  ${l[e]}${s}`)}return console.log(),console.log(chalk.gray("  Switch now: ")+chalk.cyan("lang <code>")+chalk.gray("   (e.g. ")+chalk.cyan("lang es")+chalk.gray(")")),console.log(chalk.gray('  No "back" needed — you are still at the ')+chalk.cyan("icoa>")+chalk.gray(" prompt.")),void console.log()}if(!r.includes(c)){t(`Unsupported language: ${c}`);const e=r.map(e=>`${e} (${l[e]?.split(" ")[0]||e})`).join(", ");return void i(`Supported: ${e}`)}o({language:c}),n(`Language set to: ${l[c]||c}`);const g=s();if(g&&"demo-free"===g.session.examId)try{const{pickDemoQuestions:e,getLocalizedDemoSession:o,getLocalizedDemoQuestions:s,getLocalizedExplanations:a,DEMO_PICK_SIZE:n}=await import("../lib/demo-exam.js"),{saveExamState:t}=await import("../lib/exam-state.js");if(g.questions.every(e=>null!=e.sourceNumber&&Array.isArray(e.sourceOrder)&&4===e.sourceOrder.length)){const e=s(),n=a();g.questions=g.questions.map(o=>{const s=e.find(e=>e.number===o.sourceNumber);return s&&o.sourceOrder?{...o,text:s.text,category:s.category,options:{A:s.options[o.sourceOrder[0]],B:s.options[o.sourceOrder[1]],C:s.options[o.sourceOrder[2]],D:s.options[o.sourceOrder[3]]},explanation:n[o.sourceNumber]}:o}),g.session.examName=o().examName,t(g);const i=g._lastQ||1;console.log(),console.log(chalk.green(`  Demo continues in ${l[c]||c}. Your progress is kept.`)),console.log(chalk.white(`  Resume: exam q ${i}`))}else g.questions=e(n),g.answers={},g.session.examName=o().examName,g.session.startedAt=(new Date).toISOString(),g._lastQ=1,t(g),console.log(),console.log(chalk.green(`  Demo restarted in ${l[c]||c}.`)),console.log(chalk.white("  Type: exam q 1"))}catch{console.log(chalk.gray("  Language changed. Type: demo"))}else if(g&&g.session.token)try{const{getConfig:e}=await import("../lib/config.js"),{saveExamState:o}=await import("../lib/exam-state.js"),{getDeviceFingerprint:s}=await import("../lib/access.js"),a=e().ctfdUrl||"https://practice.icoa2026.au",t=g.session.token,i=await fetch(`${a}/api/icoa/exam-token`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({token:t,deviceHash:s(),lang:c}),signal:AbortSignal.timeout(1e4)});if(i.ok){const e=(await i.json()).data.questions;g.questions=e,o(g);const s=g._lastQ||1;console.log(),n(`Exam questions updated to ${l[c]||c}. Your answers are kept.`),console.log(chalk.white(`  Resume: exam q ${s}`))}else console.log(chalk.yellow("  Could not reload questions in new language.")),console.log(chalk.gray("  The saved session may be expired or already submitted server-side.")),console.log(chalk.gray("  To abandon it and start fresh: ")+chalk.bold.cyan("back")+chalk.gray(" → ")+chalk.bold.cyan("exam reset")+chalk.gray(" → ")+chalk.bold.cyan("exam <new-token>"))}catch{console.log(chalk.yellow("  Could not reach server. Language changed for UI only."))}else if(g){const e=g._lastQ||1;console.log(),console.log(chalk.gray(`  Exam in progress — resuming Q${e}:`)),console.log(chalk.white(`  Type: exam q ${e}`))}})}

package/dist/commands/log.js

@@ -1,165 +1 @@
-import chalk from 'chalk';
-import { readFileSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { getSessionLog } from '../lib/logger.js';
-import { getIcoaDir, getConfig } from '../lib/config.js';
-import { printHeader, printInfo, printTable } from '../lib/ui.js';
-export function registerLogCommand(program) {
-    const logCmd = program
-        .command('log')
-        .description('Display session history')
-        .action(() => {
-        showLog();
-    });
-    // icoa log export — export full audit log for post-competition review
-    logCmd
-        .command('export')
-        .description('Export full audit log for review')
-        .action(async () => {
-        await exportLog();
-    });
-    // icoa log stats — show summary statistics
-    logCmd
-        .command('stats')
-        .description('Show session statistics')
-        .action(() => {
-        showStats();
-    });
-}
-function showLog() {
-    const entries = getSessionLog();
-    if (entries.length === 0) {
-        printInfo('No session log entries yet.');
-        return;
-    }
-    printHeader('Session Log');
-    const rows = entries.map((entry) => {
-        const time = entry.timestamp.replace('T', ' ').substring(0, 19);
-        const levelColor = {
-            A: chalk.green,
-            B: chalk.yellow,
-            C: chalk.red,
-            command: chalk.blue,
-            submit: chalk.magenta,
-        };
-        const colorFn = levelColor[entry.level] || chalk.gray;
-        const input = entry.input.length > 60 ? entry.input.substring(0, 57) + '...' : entry.input;
-        return [
-            chalk.gray(time),
-            colorFn(entry.level.padEnd(7)),
-            input,
-        ];
-    });
-    printTable(['Time', 'Type', 'Content'], rows);
-    console.log(chalk.gray(`  ${entries.length} entries total`));
-    console.log();
-    console.log(chalk.gray('  You are at the ') + chalk.cyan('icoa>') + chalk.gray(' prompt. Also: ') + chalk.cyan('log stats') + chalk.gray(' · ') + chalk.cyan('log export') + chalk.gray(' · ') + chalk.cyan('help') + chalk.gray(' all commands.'));
-    console.log();
-}
-async function exportLog() {
-    const config = getConfig();
-    const icoaDir = getIcoaDir();
-    const logFile = join(icoaDir, 'session.log');
-    const sessionFile = join(icoaDir, 'session-state.json');
-    const configFile = join(icoaDir, 'config.json');
-    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').substring(0, 19);
-    const userName = config.userName || 'unknown';
-    const exportName = `icoa-audit-${userName}-${timestamp}.json`;
-    const exportPath = join(process.cwd(), exportName);
-    // Gather all audit data
-    const audit = {
-        exportedAt: new Date().toISOString(),
-        version: '1.7.2',
-        competitor: {
-            userName: config.userName,
-            userId: config.userId,
-            teamName: config.teamName,
-            teamId: config.teamId,
-            sessionId: config.sessionId,
-        },
-        connection: {
-            ctfdUrl: config.ctfdUrl,
-        },
-        session: existsSync(sessionFile) ? JSON.parse(readFileSync(sessionFile, 'utf-8')) : null,
-        commands: getSessionLog(),
-    };
-    // Count by type
-    const entries = getSessionLog();
-    const counts = {};
-    for (const e of entries) {
-        counts[e.level] = (counts[e.level] || 0) + 1;
-    }
-    audit.summary = {
-        totalCommands: entries.length,
-        byType: counts,
-        firstEntry: entries[0]?.timestamp || null,
-        lastEntry: entries[entries.length - 1]?.timestamp || null,
-    };
-    // Write export
-    const { writeFileSync } = await import('node:fs');
-    writeFileSync(exportPath, JSON.stringify(audit, null, 2));
-    console.log();
-    console.log(chalk.green(`  ✓ Audit log exported`));
-    console.log(chalk.white(`  ${exportPath}`));
-    console.log();
-    console.log(chalk.gray('  Contents:'));
-    console.log(chalk.gray(`    Commands: ${entries.length}`));
-    Object.entries(counts).forEach(([type, count]) => {
-        console.log(chalk.gray(`    ${type}: ${count}`));
-    });
-    console.log();
-    console.log(chalk.gray('  This file contains the complete session audit trail.'));
-    console.log(chalk.gray('  Submit to organizers for post-competition verification.'));
-    console.log();
-}
-function showStats() {
-    const entries = getSessionLog();
-    const icoaDir = getIcoaDir();
-    const sessionFile = join(icoaDir, 'session-state.json');
-    console.log();
-    console.log(chalk.bold.white('  Session Statistics'));
-    console.log(chalk.gray('  ─────────────────────────────────────────────'));
-    if (entries.length === 0) {
-        console.log(chalk.gray('  No activity recorded yet.'));
-        console.log();
-        return;
-    }
-    // Time range
-    const first = new Date(entries[0].timestamp);
-    const last = new Date(entries[entries.length - 1].timestamp);
-    const durationMin = Math.round((last.getTime() - first.getTime()) / 60000);
-    console.log(chalk.gray('  First activity:  ') + chalk.white(first.toLocaleString()));
-    console.log(chalk.gray('  Last activity:   ') + chalk.white(last.toLocaleString()));
-    console.log(chalk.gray('  Duration:        ') + chalk.white(`${durationMin} min`));
-    console.log();
-    // Count by type
-    const counts = {};
-    for (const e of entries) {
-        counts[e.level] = (counts[e.level] || 0) + 1;
-    }
-    console.log(chalk.gray('  Total commands:  ') + chalk.white(String(entries.length)));
-    if (counts['command'])
-        console.log(chalk.blue('    commands:      ') + chalk.white(String(counts['command'])));
-    if (counts['A'])
-        console.log(chalk.green('    hint A:        ') + chalk.white(String(counts['A'])));
-    if (counts['B'])
-        console.log(chalk.yellow('    hint B:        ') + chalk.white(String(counts['B'])));
-    if (counts['C'])
-        console.log(chalk.red('    hint C:        ') + chalk.white(String(counts['C'])));
-    if (counts['submit'])
-        console.log(chalk.magenta('    submissions:   ') + chalk.white(String(counts['submit'])));
-    // Exit info
-    if (existsSync(sessionFile)) {
-        try {
-            const session = JSON.parse(readFileSync(sessionFile, 'utf-8'));
-            console.log();
-            console.log(chalk.gray('  Exit count:      ') + chalk.white(String(session.exitCount || 0)));
-            if (session.totalAwaySeconds) {
-                const awayMin = Math.round(session.totalAwaySeconds / 60);
-                console.log(chalk.gray('  Total away:      ') + chalk.white(`${awayMin} min`));
-            }
-        }
-        catch { /* ignore */ }
-    }
-    console.log();
-}
+import chalk from"chalk";import{readFileSync as o,existsSync as t}from"node:fs";import{join as e}from"node:path";import{getSessionLog as n}from"../lib/logger.js";import{getIcoaDir as s,getConfig as i}from"../lib/config.js";import{printHeader as l,printInfo as a,printTable as r}from"../lib/ui.js";export function registerLogCommand(c){const g=c.command("log").description("Display session history").action(()=>{!function(){const o=n();if(0===o.length)return void a("No session log entries yet.");l("Session Log");const t=o.map(o=>{const t=o.timestamp.replace("T"," ").substring(0,19),e={A:chalk.green,B:chalk.yellow,C:chalk.red,command:chalk.blue,submit:chalk.magenta}[o.level]||chalk.gray,n=o.input.length>60?o.input.substring(0,57)+"...":o.input;return[chalk.gray(t),e(o.level.padEnd(7)),n]});r(["Time","Type","Content"],t),console.log(chalk.gray(`  ${o.length} entries total`)),console.log(),console.log(chalk.gray("  You are at the ")+chalk.cyan("icoa>")+chalk.gray(" prompt. Also: ")+chalk.cyan("log stats")+chalk.gray(" · ")+chalk.cyan("log export")+chalk.gray(" · ")+chalk.cyan("help")+chalk.gray(" all commands.")),console.log()}()});g.command("export").description("Export full audit log for review").action(async()=>{await async function(){const l=i(),a=s(),r=(e(a,"session.log"),e(a,"session-state.json")),c=(e(a,"config.json"),(new Date).toISOString().replace(/[:.]/g,"-").substring(0,19)),g=`icoa-audit-${l.userName||"unknown"}-${c}.json`,m=e(process.cwd(),g),y={exportedAt:(new Date).toISOString(),version:"1.7.2",competitor:{userName:l.userName,userId:l.userId,teamName:l.teamName,teamId:l.teamId,sessionId:l.sessionId},connection:{ctfdUrl:l.ctfdUrl},session:t(r)?JSON.parse(o(r,"utf-8")):null,commands:n()},d=n(),u={};for(const o of d)u[o.level]=(u[o.level]||0)+1;y.summary={totalCommands:d.length,byType:u,firstEntry:d[0]?.timestamp||null,lastEntry:d[d.length-1]?.timestamp||null};const{writeFileSync:p}=await import("node:fs");p(m,JSON.stringify(y,null,2)),console.log(),console.log(chalk.green("  ✓ Audit log exported")),console.log(chalk.white(`  ${m}`)),console.log(),console.log(chalk.gray("  Contents:")),console.log(chalk.gray(`    Commands: ${d.length}`)),Object.entries(u).forEach(([o,t])=>{console.log(chalk.gray(`    ${o}: ${t}`))}),console.log(),console.log(chalk.gray("  This file contains the complete session audit trail.")),console.log(chalk.gray("  Submit to organizers for post-competition verification.")),console.log()}()}),g.command("stats").description("Show session statistics").action(()=>{!function(){const i=n(),l=s(),a=e(l,"session-state.json");if(console.log(),console.log(chalk.bold.white("  Session Statistics")),console.log(chalk.gray("  ─────────────────────────────────────────────")),0===i.length)return console.log(chalk.gray("  No activity recorded yet.")),void console.log();const r=new Date(i[0].timestamp),c=new Date(i[i.length-1].timestamp),g=Math.round((c.getTime()-r.getTime())/6e4);console.log(chalk.gray("  First activity:  ")+chalk.white(r.toLocaleString())),console.log(chalk.gray("  Last activity:   ")+chalk.white(c.toLocaleString())),console.log(chalk.gray("  Duration:        ")+chalk.white(`${g} min`)),console.log();const m={};for(const o of i)m[o.level]=(m[o.level]||0)+1;if(console.log(chalk.gray("  Total commands:  ")+chalk.white(String(i.length))),m.command&&console.log(chalk.blue("    commands:      ")+chalk.white(String(m.command))),m.A&&console.log(chalk.green("    hint A:        ")+chalk.white(String(m.A))),m.B&&console.log(chalk.yellow("    hint B:        ")+chalk.white(String(m.B))),m.C&&console.log(chalk.red("    hint C:        ")+chalk.white(String(m.C))),m.submit&&console.log(chalk.magenta("    submissions:   ")+chalk.white(String(m.submit))),t(a))try{const t=JSON.parse(o(a,"utf-8"));if(console.log(),console.log(chalk.gray("  Exit count:      ")+chalk.white(String(t.exitCount||0))),t.totalAwaySeconds){const o=Math.round(t.totalAwaySeconds/60);console.log(chalk.gray("  Total away:      ")+chalk.white(`${o} min`))}}catch{}console.log()}()})}

package/dist/commands/note.js

@@ -1,40 +1 @@
-import { appendFileSync, readFileSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { homedir } from 'node:os';
-import chalk from 'chalk';
-import { printSuccess, printInfo, printHeader } from '../lib/ui.js';
-import { logCommand } from '../lib/logger.js';
-const NOTES_FILE = join(homedir(), 'icoa-notes.txt');
-export function registerNoteCommand(program) {
-    program
-        .command('note [text...]')
-        .description('Add or view personal notes')
-        .action((words) => {
-        logCommand(`note ${words?.join(' ') || ''}`);
-        if (!words || words.length === 0) {
-            // Display existing notes
-            if (!existsSync(NOTES_FILE)) {
-                printInfo('No notes yet. Add one with: note "your note here"');
-                console.log();
-                console.log(chalk.gray('  You are at the ') + chalk.cyan('icoa>') + chalk.gray(' prompt. Type another command or ') + chalk.cyan('help') + chalk.gray(' for the list.'));
-                console.log();
-                return;
-            }
-            const content = readFileSync(NOTES_FILE, 'utf-8');
-            printHeader('Notes');
-            console.log(content);
-            console.log();
-            console.log(chalk.gray('  ─────────────────────────────────────────────'));
-            console.log(chalk.gray('  End of notes. You are back at the ') + chalk.cyan('icoa>') + chalk.gray(' prompt.'));
-            console.log(chalk.gray('  Add one: ') + chalk.cyan('note "your text"') + chalk.gray('  ·  ') + chalk.cyan('help') + chalk.gray(' for all commands'));
-            console.log();
-            return;
-        }
-        // Add new note
-        const text = words.join(' ');
-        const timestamp = new Date().toISOString().replace('T', ' ').substring(0, 19);
-        const entry = `[${timestamp}] ${text}\n`;
-        appendFileSync(NOTES_FILE, entry);
-        printSuccess(`Note saved: ${chalk.gray(text)}`);
-    });
-}
+import{appendFileSync as o,readFileSync as e,existsSync as t}from"node:fs";import{join as n}from"node:path";import{homedir as r}from"node:os";import chalk from"chalk";import{printSuccess as a,printInfo as l,printHeader as c}from"../lib/ui.js";import{logCommand as s}from"../lib/logger.js";const i=n(r(),"icoa-notes.txt");export function registerNoteCommand(n){n.command("note [text...]").description("Add or view personal notes").action(n=>{if(s(`note ${n?.join(" ")||""}`),!n||0===n.length){if(!t(i))return l('No notes yet. Add one with: note "your note here"'),console.log(),console.log(chalk.gray("  You are at the ")+chalk.cyan("icoa>")+chalk.gray(" prompt. Type another command or ")+chalk.cyan("help")+chalk.gray(" for the list.")),void console.log();const o=e(i,"utf-8");return c("Notes"),console.log(o),console.log(),console.log(chalk.gray("  ─────────────────────────────────────────────")),console.log(chalk.gray("  End of notes. You are back at the ")+chalk.cyan("icoa>")+chalk.gray(" prompt.")),console.log(chalk.gray("  Add one: ")+chalk.cyan('note "your text"')+chalk.gray("  ·  ")+chalk.cyan("help")+chalk.gray(" for all commands")),void console.log()}const r=n.join(" "),g=(new Date).toISOString().replace("T"," ").substring(0,19);o(i,`[${g}] ${r}\n`),a(`Note saved: ${chalk.gray(r)}`)})}

package/dist/commands/ref.js

@@ -1,68 +1 @@
-import { readdirSync, readFileSync, existsSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import chalk from 'chalk';
-import { printHeader, printInfo, printError, printTable } from '../lib/ui.js';
-import { logCommand } from '../lib/logger.js';
-function getRefsDir() {
-    // When bundled, refs/ is at the package root alongside dist/
-    const __dirname = dirname(fileURLToPath(import.meta.url));
-    // Try multiple possible locations
-    const candidates = [
-        join(__dirname, '..', 'refs'), // from dist/index.js
-        join(__dirname, '..', '..', 'refs'), // from src/commands/
-        join(process.cwd(), 'refs'), // from CWD
-    ];
-    for (const dir of candidates) {
-        if (existsSync(dir))
-            return dir;
-    }
-    return candidates[0]; // fallback
-}
-export function registerRefCommand(program) {
-    program
-        .command('ref [topic]')
-        .description('Quick reference for tools and commands')
-        .action((topic) => {
-        logCommand(`ref ${topic || ''}`);
-        const refsDir = getRefsDir();
-        if (!topic) {
-            // List all available refs
-            printHeader('Available References');
-            if (!existsSync(refsDir)) {
-                printError('Reference files not found.');
-                return;
-            }
-            const files = readdirSync(refsDir)
-                .filter((f) => f.endsWith('.txt'))
-                .map((f) => f.replace('.txt', ''))
-                .sort();
-            if (files.length === 0) {
-                printInfo('No reference files available.');
-                return;
-            }
-            const rows = files.map((f) => [chalk.white(f)]);
-            printTable(['Topic'], rows);
-            console.log();
-            console.log(chalk.gray('  Open one: ') + chalk.cyan('ref <topic>') + chalk.gray('   (e.g. ') + chalk.cyan('ref python') + chalk.gray(')'));
-            console.log(chalk.gray('  No "back" needed — ref just prints and returns to the ') + chalk.cyan('icoa>') + chalk.gray(' prompt.'));
-            console.log();
-            return;
-        }
-        // Show specific ref
-        const filePath = join(refsDir, `${topic}.txt`);
-        if (!existsSync(filePath)) {
-            printError(`Reference not found: ${topic}`);
-            printInfo('Run "ref" to see available topics.');
-            return;
-        }
-        const content = readFileSync(filePath, 'utf-8');
-        printHeader(`Reference: ${topic}`);
-        console.log(content);
-        console.log();
-        console.log(chalk.gray('  ─────────────────────────────────────────────'));
-        console.log(chalk.gray('  End of ') + chalk.cyan(`ref ${topic}`) + chalk.gray('. You are back at the ') + chalk.cyan('icoa>') + chalk.gray(' prompt.'));
-        console.log(chalk.gray('  Next: ') + chalk.cyan('ref') + chalk.gray(' list topics · ') + chalk.cyan('ref <topic>') + chalk.gray(' open another · ') + chalk.cyan('help') + chalk.gray(' all commands'));
-        console.log();
-    });
-}
+import{readdirSync as o,readFileSync as e,existsSync as r}from"node:fs";import{join as n,dirname as t}from"node:path";import{fileURLToPath as c}from"node:url";import chalk from"chalk";import{printHeader as a,printInfo as i,printError as f,printTable as l}from"../lib/ui.js";import{logCommand as s}from"../lib/logger.js";export function registerRefCommand(p){p.command("ref [topic]").description("Quick reference for tools and commands").action(p=>{s(`ref ${p||""}`);const g=function(){const o=t(c(import.meta.url)),e=[n(o,"..","refs"),n(o,"..","..","refs"),n(process.cwd(),"refs")];for(const o of e)if(r(o))return o;return e[0]}();if(!p){if(a("Available References"),!r(g))return void f("Reference files not found.");const e=o(g).filter(o=>o.endsWith(".txt")).map(o=>o.replace(".txt","")).sort();if(0===e.length)return void i("No reference files available.");const n=e.map(o=>[chalk.white(o)]);return l(["Topic"],n),console.log(),console.log(chalk.gray("  Open one: ")+chalk.cyan("ref <topic>")+chalk.gray("   (e.g. ")+chalk.cyan("ref python")+chalk.gray(")")),console.log(chalk.gray('  No "back" needed — ref just prints and returns to the ')+chalk.cyan("icoa>")+chalk.gray(" prompt.")),void console.log()}const m=n(g,`${p}.txt`);if(!r(m))return f(`Reference not found: ${p}`),void i('Run "ref" to see available topics.');const y=e(m,"utf-8");a(`Reference: ${p}`),console.log(y),console.log(),console.log(chalk.gray("  ─────────────────────────────────────────────")),console.log(chalk.gray("  End of ")+chalk.cyan(`ref ${p}`)+chalk.gray(". You are back at the ")+chalk.cyan("icoa>")+chalk.gray(" prompt.")),console.log(chalk.gray("  Next: ")+chalk.cyan("ref")+chalk.gray(" list topics · ")+chalk.cyan("ref <topic>")+chalk.gray(" open another · ")+chalk.cyan("help")+chalk.gray(" all commands")),console.log()})}