icoa-cli 2.19.457 → 2.19.459

package/dist/lib/learn-ai.d.ts

@@ -1,159 +0,0 @@
-export type TutorEvent = {
-    kind: 'reasoning';
-    text: string;
-} | {
-    kind: 'content';
-    text: string;
-};
-export type TutorTurn = {
-    role: 'user' | 'assistant';
-    content: string;
-};
-export type TutorResult = {
-    ok: boolean;
-    answer: string;
-    message?: string;
-    code?: string;
-    offtopic?: boolean;
-    spent?: number;
-    cap?: number;
-};
-export type PqsResult = {
-    ok: boolean;
-    score?: number;
-    tier?: 'green' | 'blue' | 'yellow' | 'red';
-    manipulation?: boolean;
-    feedback?: string;
-    improve?: string;
-    submissionIndex?: number;
-    submissionsLeft?: number;
-    rank?: number | null;
-    entrants?: number;
-    inTop3?: boolean;
-    turns?: number;
-    spent?: number;
-    cap?: number;
-    message?: string;
-    code?: string;
-};
-export declare function submitPqs(opts: {
-    token: string;
-    cardNumber: number;
-}): Promise<PqsResult>;
-export type PqsTopEntry = {
-    rank: number;
-    score: number;
-    tier: string;
-    me: boolean;
-    name?: string | null;
-    questions: string[];
-};
-export type PqsTopResult = {
-    ok: boolean;
-    top3?: PqsTopEntry[];
-    myRank?: number | null;
-    entrants?: number;
-    message?: string;
-    code?: string;
-};
-export declare function viewPqsTop(opts: {
-    token: string;
-    cardNumber: number;
-}): Promise<PqsTopResult>;
-export type MyScoreEntry = {
-    card: number;
-    score: number;
-    tier: string;
-};
-export declare function fetchMyScores(opts: {
-    token: string;
-    cardLo: number;
-    cardHi: number;
-}): Promise<{
-    ok: boolean;
-    scores?: MyScoreEntry[];
-    code?: string;
-    message?: string;
-}>;
-export type HonorBoardEntry = {
-    rank: number;
-    score: number;
-    tier: string;
-    icon: string;
-    me: boolean;
-    name?: string | null;
-};
-export type HonorMine = {
-    best_score: number;
-    rank: number;
-    entrants: number;
-    submissions_left: number;
-};
-export type HonorCardMedal = {
-    card: number;
-    rank: number;
-    icon: string;
-    score: number;
-    since: string;
-};
-export type HonorChapter = {
-    chapter: number;
-    gold: number;
-    silver: number;
-    bronze: number;
-    cards: HonorCardMedal[];
-};
-export type HonorsResult = {
-    ok: boolean;
-    board?: HonorBoardEntry[];
-    mine?: HonorMine | null;
-    nickname?: string | null;
-    totals?: {
-        gold: number;
-        silver: number;
-        bronze: number;
-    };
-    chapters?: HonorChapter[];
-    floor?: number;
-    message?: string;
-    code?: string;
-};
-export declare function viewHonors(opts: {
-    token: string;
-    curriculumId?: string;
-    cardNumber?: number;
-}): Promise<HonorsResult>;
-export declare function setNickname(opts: {
-    token: string;
-    nickname: string;
-}): Promise<{
-    ok: boolean;
-    nickname?: string;
-    code?: string;
-    message?: string;
-}>;
-export declare function recallCoach(opts: {
-    token: string;
-    phase: number;
-    slot: number;
-    problemTitle: string;
-    statement: string;
-    code: string;
-    level: 1 | 2 | 3;
-    lang: 'en' | 'zh';
-}): Promise<{
-    ok: boolean;
-    hint?: string;
-    level?: number;
-    spent?: number;
-    cap?: number;
-    code?: string;
-    message?: string;
-}>;
-export declare function streamLearnTutor(opts: {
-    token: string;
-    cardNumber: number;
-    question: string;
-    mode: 'deep' | 'fast';
-    history?: TutorTurn[];
-}, onEvent: (ev: TutorEvent) => void): Promise<TutorResult>;

package/dist/lib/learn-contest.d.ts

@@ -1,141 +0,0 @@
-export type ContestProblem = {
-    id: string;
-    title: string;
-    statement: string;
-    title_zh?: string;
-    statement_zh?: string;
-    samples?: Array<{
-        in: string;
-        out: string;
-    }>;
-};
-export type ContestStartData = {
-    phase: number;
-    slot: number;
-    group_count: number;
-    title?: string;
-    attempt: number;
-    resumed: boolean;
-    started_at: string;
-    deadline: string;
-    duration_minutes: number;
-    n: number;
-    need: number;
-    solved: string[];
-    carried?: string[];
-    carryable_ac?: number;
-    problems: ContestProblem[];
-};
-export type SlotRun = {
-    ac?: number;
-    ms: number | null;
-    ts: string;
-    attempt?: number;
-};
-export type SlotState = {
-    slot: number;
-    title?: string;
-    passed: boolean;
-    best_ac: number;
-    need: number;
-    n: number;
-    attempts: number;
-    duration_minutes: number;
-    active_deadline: string | null;
-    best?: SlotRun | null;
-    perfect_runs?: SlotRun[];
-    required?: number;
-    carried_ac?: number;
-    carried_pass?: boolean;
-    carryable_ac?: number;
-};
-export type LinkData = {
-    link_group: string;
-    members: Array<{
-        token: string;
-        curriculum_id: string;
-    }>;
-};
-export type LinkCandidate = {
-    index: number;
-    token: string;
-    curriculum_id: string;
-    carry_problems: number;
-};
-export type LinkSuggestData = {
-    candidates: LinkCandidate[];
-};
-export type ContestSubmitData = {
-    verdict: string;
-    late?: boolean;
-    already_ac?: boolean;
-    test?: number | null;
-    passed_tests?: number | null;
-    total_tests?: number | null;
-    time_ms?: number | null;
-    ac_count: number;
-    need: number;
-    n: number;
-    passed: boolean;
-    deadline?: string;
-};
-export type GatePhase = {
-    phase: number;
-    configured: boolean;
-    passed: boolean;
-    contest?: {
-        passed: boolean;
-        best_ac?: number;
-        need?: number;
-        n?: number;
-        attempts?: number;
-        groups_passed?: number;
-        group_count?: number;
-        slots?: SlotState[];
-    };
-    research?: {
-        good_cards: number;
-        need_cards: number;
-        min_score: number;
-        passed: boolean;
-    };
-    checks?: {
-        enabled: boolean;
-        need: number;
-        good: number;
-        missing: number[];
-        passed: boolean;
-    };
-};
-export type GateData = {
-    gated: number;
-    unlocked_through_phase: number;
-    phases: GatePhase[];
-    link_offer?: {
-        curricula: string[];
-        problems: number;
-    } | null;
-};
-type ApiResult<T> = {
-    ok: boolean;
-    data?: T;
-    code?: string;
-    message?: string;
-};
-export declare function contestStart(token: string, phase: number, slot?: number): Promise<ApiResult<ContestStartData>>;
-export declare function contestSubmit(token: string, phase: number, problemId: string, code: string, slot?: number, dyn?: Record<string, number>): Promise<ApiResult<ContestSubmitData>>;
-export declare function contestReset(token: string, phase: number, slot?: number): Promise<ApiResult<{
-    reset_sessions: number;
-}>>;
-export declare function fetchGate(token: string): Promise<ApiResult<GateData>>;
-/**
- * Link a second token to this one so contest credit carries between tracks.
- * Ownership is proven by DEVICE BINDING, not by knowing the token string — the
- * server refuses a token bound to another machine, so a borrowed one is useless.
- */
-export declare function linkSuggest(token: string): Promise<ApiResult<LinkSuggestData>>;
-/** Link the nth candidate from `linkSuggest` — the student types a digit, never a token. */
-export declare function linkByIndex(token: string, index: number): Promise<ApiResult<LinkData>>;
-export declare function linkToken(token: string, otherToken: string): Promise<ApiResult<LinkData>>;
-export declare function timeLeft(deadlineIso: string): string | null;
-export {};

package/dist/lib/learn-curricula.d.ts

@@ -1,274 +0,0 @@
-/**
- * Learn-mode curriculum content.
- *
- * Phase 0: hardcoded LEARNDEMO01 (n=10 cards, free for everyone).
- * Phase 1+: full EAxxxxxxxx tokens load curriculum from server.
- *
- * Card types:
- *   knowledge   — text + diagram + "ok / next" to advance
- *   mcq         — 4-choice question with instant feedback + explanation
- *   practical   — drop into sandbox Python, return when done
- *   sim_demo    — open MuJoCo viewer, watch action play out
- *   milestone   — section completion celebration with ASCII trophy
- */
-export type CardKnowledge = {
-    number: number;
-    module: number;
-    type: 'knowledge';
-    title: string;
-    body: string[];
-    icoaConnection?: string;
-    check?: {
-        statement: string;
-        answer: 'y' | 'n';
-    };
-    solution?: string[];
-    key_point?: string;
-    chart_ids?: string[];
-    _zh?: {
-        title?: string;
-        body?: string[];
-        icoaConnection?: string;
-        checkStatement?: string;
-        key_point?: string;
-        solution?: string[];
-    };
-};
-export type CardMCQ = {
-    number: number;
-    module: number;
-    type: 'mcq';
-    title: string;
-    question: string;
-    options: {
-        A: string;
-        B: string;
-        C: string;
-        D: string;
-    };
-    answer: 'A' | 'B' | 'C' | 'D';
-    explanation: string;
-    _zh?: {
-        title?: string;
-        question?: string;
-        options?: {
-            A: string;
-            B: string;
-            C: string;
-            D: string;
-        };
-        explanation?: string;
-    };
-};
-export type CardPractical = {
-    number: number;
-    module: number;
-    type: 'practical';
-    title: string;
-    task: string;
-    starterCode?: string;
-    successHint: string;
-    _zh?: {
-        title?: string;
-        task?: string;
-        successHint?: string;
-    };
-};
-export type CardSimDemo = {
-    number: number;
-    module: number;
-    type: 'sim_demo';
-    title: string;
-    description: string;
-    simAction: 'baseline' | 'prompt_injected' | 'patch_attacked' | 'modality_confused';
-    _zh?: {
-        title?: string;
-        description?: string;
-    };
-};
-export type CardMilestone = {
-    number: number;
-    module: number;
-    type: 'milestone';
-    badge: string;
-    emoji: string;
-    unlockedNext: string;
-    realWorldLevel: string;
-    _zh?: {
-        badge?: string;
-        unlockedNext?: string;
-        realWorldLevel?: string;
-    };
-};
-export type CardArenaTask = {
-    number: number;
-    module: number;
-    type: 'arena_task';
-    title: string;
-    task_id: string;
-    origin: string;
-    domain: string;
-    metric: string;
-    statement: string[];
-    core_delta: string[];
-    baseline_ref: string;
-    dataset_ref?: string;
-    submission_format: string;
-    hints?: {
-        a: string;
-        b: string;
-        c: string;
-        d: string;
-        e: string;
-    };
-    _zh?: {
-        title?: string;
-        origin?: string;
-        domain?: string;
-        metric?: string;
-        statement?: string[];
-        core_delta?: string[];
-        baseline_ref?: string;
-        submission_format?: string;
-        hints?: {
-            a: string;
-            b: string;
-            c: string;
-            d: string;
-            e: string;
-        };
-    };
-};
-export type CardComingSoon = {
-    number: number;
-    module: number;
-    type: 'coming_soon';
-    title: string;
-    note?: string;
-    _zh?: {
-        title?: string;
-        note?: string;
-    };
-};
-export type Card = CardKnowledge | CardMCQ | CardPractical | CardSimDemo | CardMilestone | CardArenaTask | CardComingSoon;
-export type ChartArt = {
-    type?: 'chart' | 'code';
-    art?: string;
-    art_t0?: string;
-    width_cols?: number;
-    color_map?: Record<string, string>;
-    lang?: string;
-    code?: string;
-    tier?: string;
-    tags?: string[];
-    embargo_ok?: boolean;
-    first_used?: string;
-};
-/** Returns a copy of `card` with locale-aware fields applied.
- *
- *  As of v2.19.204, all curriculum content is fetched from the server
- *  with _zh and check fields already merged (see panda/seed-server-curricula.js).
- *  This function just picks the localised text out of card._zh when
- *  the requested locale starts with 'zh'. The auto-overlay maps that
- *  used to live in learn-phases-zh.ts and learn-phases-checks.ts are
- *  no longer client-side — they were merged at seed time.
- *
- *  Spread-then-merge keeps undefined keys clean. */
-export declare function localized<T extends Card>(card: T, lang: string): T;
-export type Curriculum = {
-    id: string;
-    name: string;
-    description: string;
-    totalCards: number;
-    modules: {
-        number: number;
-        name: string;
-        cardRange: [number, number];
-    }[];
-    cards: Card[];
-    charts?: Record<string, ChartArt>;
-};
-/**
- * Shape guard for a server curriculum payload.
- *
- * The learn-validate + curriculum endpoints are lenient: a NON-learn token
- * (e.g. an EXAM token typed into `learn`) can return success:true with a
- * payload that is not a curriculum. Before this guard, fetchCurriculum cast it
- * straight to Curriculum, it passed the `!curriculum` null-check in learn.ts,
- * then renderWelcome/newLearnState read `.cards` / `.totalCards` on undefined →
- * TypeError → uncaught → worker exit → "validating… processing… <crash> menu".
- *
- * Returning false makes loadCurriculumById yield null, so learn.ts shows a
- * clean error instead of crashing. Checks only stable core fields.
- */
-export declare function isValidCurriculum(data: unknown): data is Curriculum;
-import { type CardReply } from './learn-replies.js';
-export declare const LEARN_SERVER = "https://practice.icoa2026.au";
-export declare function getLastCurriculumFailure(): 'notfound' | 'offline' | null;
-/**
- * Resolves a curriculum by id. Order:
- *   1. Fresh cache (< 7 days)        → instant return, no network
- *   2. Server fetch + cache write    → if reachable; uses If-None-Match
- *      304 Not Modified              → cache content unchanged, just refresh mtime
- *      200 OK                        → rewrite cache + etag
- *   3. Stale cache as fallback       → if server unreachable but cache exists
- *   4. null                          → no cache, no server
- */
-export declare function loadCurriculumById(id: string, token?: string, force?: boolean): Promise<Curriculum | null>;
-/**
- * Server-side validation for EAxxxxxxxx tokens.
- * Returns curriculum identifier + status; the actual cards are still
- * shipped client-side in this Phase, but the token gates access.
- */
-type ValidateResult = {
-    ok: boolean;
-    curriculumId?: string;
-    status?: string;
-    validUntil?: string;
-    message?: string;
-    code?: string;
-    aiEnabled?: boolean;
-    gated?: boolean;
-    replies?: CardReply[];
-};
-/** Pure shape of the validate payload — exported so the mapping is testable. */
-export declare function validateResultShape(d: Record<string, unknown>): Required<Pick<ValidateResult, 'curriculumId' | 'status' | 'validUntil' | 'aiEnabled' | 'gated' | 'replies'>>;
-export declare function validateEAToken(token: string): Promise<ValidateResult>;
-/**
- * Best-effort progress sync to server. Silent failure — local state is
- * always authoritative; server is for cross-device persistence + analytics.
- */
-export declare function syncProgress(token: string, event: {
-    card_number: number;
-    event_type: 'viewed' | 'mcq_answered' | 'practical_done' | 'bookmarked' | 'check_answered';
-    mcq_answer?: 'A' | 'B' | 'C' | 'D';
-    mcq_correct?: boolean;
-    check_answer?: 'y' | 'n';
-    check_correct?: boolean;
-    time_on_card_ms?: number;
-}, replyAck?: number[]): Promise<void>;
-/**
- * Card-feedback submission (the `e` "report a problem" channel).
- * Crowdsourced card QA — a learner flags an error/confusion on a card; we
- * record it server-side bound to (curriculum_id, card_number) so the author
- * team can triage.
- *
- * Returns whether the server actually accepted the report, so the caller can
- * print an honest ack. (The route spent 43 days undeployed while an
- * unconditional "✓ recorded" hid every 404 — never fake delivery again.)
- *
- * Unlike syncProgress, demo (LEARNDEMO01) feedback IS sent — the demo is the
- * highest-traffic curriculum, so its cards benefit most from crowdsourced QA.
- * The server records feedback for any token-shaped string (no learn_tokens
- * membership required; feedback is low-risk user text).
- *
- * Card identity is the (curriculum_id, card_number) composite — card numbers
- * are curriculum-LOCAL, so curriculum_id is required to disambiguate.
- */
-export declare function syncCardFeedback(token: string, payload: {
-    curriculum_id: string;
-    card_number: number;
-    feedback_text: string;
-    time_on_card_ms?: number;
-}): Promise<boolean>;
-export {};

package/dist/lib/learn-i18n.d.ts

@@ -1,8 +0,0 @@
-/**
- * Chrome (UI scaffolding) i18n for learn mode.
- *
- * Card *content* localisation lives on each card via the `_zh` field on
- * Card types (see learn-curricula.ts). This file is for the rendered
- * frame around the content: welcome screen labels, prompts, dashboards.
- */
-export declare function t(key: string, lang: string): string;

package/dist/lib/learn-input.d.ts

@@ -1,40 +0,0 @@
-/**
- * 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.
- */
-export type LearnInputResolution = {
-    kind: 'back';
-} | {
-    kind: 'token';
-    token: string;
-    from?: string;
-} | {
-    kind: 'continue';
-    which?: number | string;
-} | {
-    kind: 'ambiguous';
-    hint: string;
-} | {
-    kind: 'unknown';
-    hint: string;
-};
-export declare function resolveLearnInput(raw: string): LearnInputResolution;

package/dist/lib/learn-outcome.d.ts

@@ -1 +0,0 @@
-export declare function setLearnSessionStarted(v: boolean): void;