icoa-cli 2.19.357 → 2.19.359

package/dist/lib/learn-input.js

@@ -1,101 +1 @@
-/**
- * Fuzzy resolver for the 🧠 Learn token-input picker.
- *
- * Problem: a first-time newbie at the prompt:
- *
- *   Learn token (or blank to go back): _
- *
- * naturally tries any of the following (none of which used to work):
- *
- *   learn LEARNDEMO01      (echoes the command they expect to type)
- *   ctf4eai                (the track-name they saw in the list)
- *   3                      (the third listed option)
- *   learndemo01            (lower-case the token they saw)
- *   demo                   (it said "Free 12-card demos:")
- *
- * Only the correct input — bare upper-case LEARNDEMO01 — used to work.
- * That's a >20% bounce point on the new-user funnel. This resolver maps
- * all the above to the correct token (or returns a friendly hint).
- *
- * See [[reference-newbie-path-invariant]] + CLAUDE.md "Newbie Path
- * Invariant" rule. Gold standard for inline guidance + accept-many-
- * variants is the pre-v2.19.180 national-selection demo flow.
- */
-const DEMO_BY_TRACK = {
-    ai4ctf: 'AI4CTFDEMO01',
-    ctf4ai: 'CTF4AIDEMO01',
-    ctf4eai: 'LEARNDEMO01',
-    // ".-12" variants (curriculum-id form)
-    'ai4ctf-12': 'AI4CTFDEMO01',
-    'ctf4ai-12': 'CTF4AIDEMO01',
-    'ctf4eai-12': 'LEARNDEMO01',
-    // Common aliases / typos
-    ctf4vla: 'LEARNDEMO01',
-    vla: 'LEARNDEMO01',
-    embodied: 'LEARNDEMO01',
-    ai4ctfdemo: 'AI4CTFDEMO01',
-    ctf4aidemo: 'CTF4AIDEMO01',
-    learndemo: 'LEARNDEMO01',
-};
-// Numeric shortcuts mirror the order shown in the picker UI.
-const DEMO_BY_NUMBER = {
-    '1': 'AI4CTFDEMO01',
-    '2': 'CTF4AIDEMO01',
-    '3': 'LEARNDEMO01',
-};
-// Any 2-letter cohort prefix + 6+ chars. Generic on purpose: the prefix list
-// (AC/CA/EA/EI/IO/IA/PH/MP/…) lives in panda/bootstrap-learn-tokens.py and the
-// server is authoritative — never hard-code it here (new tracks would bounce).
-const COHORT_TOKEN_RE = /^[A-Z]{2}[A-Z0-9]{6,}$/;
-const DEMO_TOKEN_RE = /^(AI4CTFDEMO\d+|CTF4AIDEMO\d+|LEARNDEMO\d+)$/;
-export function resolveLearnInput(raw) {
-    const trimmed = raw.trim();
-    if (!trimmed)
-        return { kind: 'back' };
-    // Strip common command-echo prefixes the user types out of muscle memory.
-    // Case-insensitive: "learn ", "icoa learn ", "/learn ", "> learn ".
-    const core = trimmed.replace(/^\s*(?:[/>])?\s*(?:icoa\s+)?learn\s+/i, '').trim();
-    if (!core) {
-        return {
-            kind: 'ambiguous',
-            hint: 'Type just the token (e.g. LEARNDEMO01) or one of: ai4ctf / ctf4ai / ctf4eai',
-        };
-    }
-    // Numeric shortcut (1/2/3 → demo by list order).
-    if (DEMO_BY_NUMBER[core])
-        return { kind: 'token', token: DEMO_BY_NUMBER[core] };
-    // Track-name / alias lookup (case-insensitive).
-    const lowered = core.toLowerCase();
-    if (DEMO_BY_TRACK[lowered])
-        return { kind: 'token', token: DEMO_BY_TRACK[lowered] };
-    // "demo" alone is ambiguous — there are three. Ask which.
-    if (lowered === 'demo' || lowered === 'demos') {
-        return {
-            kind: 'ambiguous',
-            hint: 'Which demo? Type: 1 (ai4ctf) / 2 (ctf4ai) / 3 (ctf4eai)',
-        };
-    }
-    // Looks like a literal token — uppercase + validate format. Reject if
-    // it contains internal whitespace (multi-word input like "something
-    // random" is clearly NOT a token).
-    if (/\s/.test(core)) {
-        return {
-            kind: 'unknown',
-            hint: `Don't recognize "${trimmed}". Try one of: ai4ctf / ctf4ai / ctf4eai (for the free demos), 1/2/3, or paste your AC/CA/EA/EI/IO/IA + 8 chars cohort token. Blank to go back.`,
-        };
-    }
-    const upper = core.toUpperCase();
-    if (DEMO_TOKEN_RE.test(upper))
-        return { kind: 'token', token: upper };
-    if (COHORT_TOKEN_RE.test(upper))
-        return { kind: 'token', token: upper };
-    // Last-ditch: alphanumeric + 8+ chars (no spaces by definition since we
-    // returned above) → optimistic try (server will reject cleanly if invalid).
-    // Better than refusing a typo'd cohort token at the client.
-    if (/^[A-Z0-9]{8,}$/.test(upper))
-        return { kind: 'token', token: upper };
-    return {
-        kind: 'unknown',
-        hint: `Don't recognize "${trimmed}". Try one of: ai4ctf / ctf4ai / ctf4eai (for the free demos), 1/2/3, or paste your AC/CA/EA/EI/IO/IA + 8 chars cohort token. Blank to go back.`,
-    };
-}
+const t={ai4ctf:"AI4CTFDEMO01",ctf4ai:"CTF4AIDEMO01",ctf4eai:"LEARNDEMO01","ai4ctf-12":"AI4CTFDEMO01","ctf4ai-12":"CTF4AIDEMO01","ctf4eai-12":"LEARNDEMO01",ctf4vla:"LEARNDEMO01",vla:"LEARNDEMO01",embodied:"LEARNDEMO01",ai4ctfdemo:"AI4CTFDEMO01",ctf4aidemo:"CTF4AIDEMO01",learndemo:"LEARNDEMO01"},e={1:"AI4CTFDEMO01",2:"CTF4AIDEMO01",3:"LEARNDEMO01"},o=/^[A-Z]{2}[A-Z0-9]{6,}$/,n=/^(AI4CTFDEMO\d+|CTF4AIDEMO\d+|LEARNDEMO\d+)$/;export function resolveLearnInput(i){const r=i.trim();if(!r)return{kind:"back"};const a=r.replace(/^\s*(?:[/>])?\s*(?:icoa\s+)?learn\s+/i,"").trim();if(!a)return{kind:"ambiguous",hint:"Type just the token (e.g. LEARNDEMO01) or one of: ai4ctf / ctf4ai / ctf4eai"};if(e[a])return{kind:"token",token:e[a]};const c=a.toLowerCase();if(t[c])return{kind:"token",token:t[c]};if("demo"===c||"demos"===c)return{kind:"ambiguous",hint:"Which demo? Type: 1 (ai4ctf) / 2 (ctf4ai) / 3 (ctf4eai)"};if(/\s/.test(a))return{kind:"unknown",hint:`Don't recognize "${r}". Try one of: ai4ctf / ctf4ai / ctf4eai (for the free demos), 1/2/3, or paste your AC/CA/EA/EI/IO/IA + 8 chars cohort token. Blank to go back.`};const f=a.toUpperCase();return n.test(f)||o.test(f)||/^[A-Z0-9]{8,}$/.test(f)?{kind:"token",token:f}:{kind:"unknown",hint:`Don't recognize "${r}". Try one of: ai4ctf / ctf4ai / ctf4eai (for the free demos), 1/2/3, or paste your AC/CA/EA/EI/IO/IA + 8 chars cohort token. Blank to go back.`}}