AI disclaimer: one shared component, shown where model output appears

"Freezmo uses AI and can make mistakes. Double-check important info."
(plus a natural informal Czech translation), rendered by a shared
AiDisclaimer so the copy, style and translations live in one place.

Placements — only where the model's words reach the screen:
- Chat: under the composer, below the context/model chips — always (chat
  is pure model output, so it also shows in the empty state).
- Make my homework: under the start CTA (desktop) and the mode cards'
  helper line (phone), plus once under the generated result for all three
  modes (make / check / guide).
- New deck wizard: under the summary helper (phone step 3) and the desktop
  CTA, next to Freeze my deck.
- AI grading (short answers): under the graded feedback; study, review and
  exam all share it.

Stored, already-generated content (deck page, study cards, explanations)
deliberately carries no note: the disclaimer belongs to the moment of
generation, not to browsing. Style: --text-subtle (documented at 5.6:1
light / 8.6:1 dark), 11.5px, centred, wraps to two lines at 360px, not
clickable, no icon.

Suites: chat (composer, phone + desktop), wizard (deck step 3 across
360/390 x en/cs x dark/light, homework start cards), phase3 (homework
trigger + result, phone + desktop), phase2 (stubbed grading feedback).
SW -> freezmo-v37. README: decision 50 + chat composer note.

Also fixes the deploy script's test instance: it now execs the server so
the cleanup kill reaps the real PID (the wrapper subshell left orphans
squatting on the test port — three from earlier sessions were found while
verifying this task), and the readiness poll checks the port serves the
NEW commit rather than just answering, so a leftover instance can never
be tested silently.
This commit is contained in:
Martin Dvořák 2026-10-11 22:51:16 +00:00
commit 37a84df462
14 changed files with 151 additions and 34 deletions

View file

@ -0,0 +1,22 @@
"use client";
import { useI18n } from "@/lib/i18n";
import { cn } from "@/lib/utils";
/**
* The faint "AI can make mistakes" note for surfaces that show model output:
* under the chat composer, next to the generation buttons and results of the
* homework and deck wizards, and under AI grading feedback. One component so
* the copy, the style and the translations stay in one place.
*
* --text-subtle is the muted helper token and is documented at 5.6:1 (light)
* and 8.6:1 (dark), so the note stays readable at this size.
*/
export function AiDisclaimer({ className }: { className?: string }) {
const { t } = useI18n();
return (
<p className={cn("text-center text-[11.5px] leading-snug text-[var(--text-subtle)]", className)}>
{t("common.aiDisclaimer")}
</p>
);
}

View file

@ -4,6 +4,7 @@ import { motion, useReducedMotion } from "framer-motion";
import { useRouter } from "next/navigation";
import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
import { AiDisclaimer } from "@/components/AiDisclaimer";
import { ApiError, generateDeck, type GenerateProgress } from "@/lib/client-api";
import {
DOCUMENT_ACCEPT_ATTR,
@ -1002,6 +1003,7 @@ export function UploadScreen() {
</dl>
<p className="text-[12.5px] text-[var(--text-subtle)]">{phoneHelper}</p>
<AiDisclaimer />
</div>
) : null}
</motion.div>
@ -1330,6 +1332,7 @@ export function UploadScreen() {
? t("upload.ready")
: t("upload.addToStart")}
</p>
<AiDisclaimer />
</div>
</div>
</div>

View file

@ -7,6 +7,7 @@ import { useI18n } from "@/lib/i18n";
import { modelErrorCopy } from "@/lib/model-errors";
import type { Activity } from "@/lib/schemas";
import { cn } from "@/lib/utils";
import { AiDisclaimer } from "@/components/AiDisclaimer";
import { Button, Spinner } from "@/components/ui";
import { ModelErrorActions } from "@/components/ModelErrorActions";
@ -185,6 +186,8 @@ export function ShortAnswer({ activity, active, language, onAnswered, onNext, is
) : null}
</div>
<AiDisclaimer />
<FeedbackPanel
correct={state.correct}
explanation={activity.explanation}

View file

@ -2,6 +2,7 @@
import { useEffect, useRef } from "react";
import { AiDisclaimer } from "@/components/AiDisclaimer";
import { ChatIcon, LayersIcon, PaperclipIcon, SendIcon, StopIcon, XIcon } from "@/components/icons";
import { Spinner } from "@/components/ui";
import { useI18n } from "@/lib/i18n";
@ -175,6 +176,8 @@ export function Composer({
</span>
) : null}
</div>
<AiDisclaimer className="mt-1.5" />
</div>
);
}

View file

@ -4,6 +4,7 @@ import { motion, useReducedMotion } from "framer-motion";
import { useRouter } from "next/navigation";
import { useEffect, useRef, useState } from "react";
import { AiDisclaimer } from "@/components/AiDisclaimer";
import { CameraIcon, CheckCircleIcon, FolderIcon, PlayIcon, PlusIcon, SparklesIcon } from "@/components/icons";
import { Button } from "@/components/ui";
import { WizardActionBar } from "@/components/WizardActionBar";
@ -542,6 +543,7 @@ export function HomeworkInput({
<p className="text-center text-[12px] text-[var(--text-subtle)]">
{online ? t("homework.phone.startHint") : t("offline.generate")}
</p>
<AiDisclaimer />
</div>
) : null}
</motion.div>
@ -779,6 +781,7 @@ export function HomeworkInput({
<p className="text-center text-[12px] text-[var(--text-subtle)]">
{canSubmit ? t("homework.source.ready") : t("homework.source.need")}
</p>
<AiDisclaimer />
</div>
<HomeworkHistory records={history} onOpen={onOpen} onDelete={onDelete} />

View file

@ -3,6 +3,7 @@
import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
import { useRouter } from "next/navigation";
import { AiDisclaimer } from "@/components/AiDisclaimer";
import { documentsToText } from "@/lib/documents";
import { ApiError, generateHomework, type HomeworkProgress } from "@/lib/client-api";
import { setDeckSeed } from "@/lib/deck-seed";
@ -227,37 +228,36 @@ export function HomeworkScreen({ initialRecordId }: { initialRecordId?: string }
}
if (view.kind === "record") {
if (view.record.mode === "make") {
return (
<HomeworkResult
record={view.record}
onAgain={() => again(view.record)}
onNew={newAssignment}
onToDeck={() => turnIntoDeck(view.record)}
againLoading={againLoading}
/>
);
}
if (view.record.mode === "check") {
return (
<HomeworkCheckResult
record={view.record}
onAgain={() => again(view.record)}
onNew={newAssignment}
onToDeck={() => turnIntoDeck(view.record)}
againLoading={againLoading}
/>
);
}
return (
<HomeworkGuide
record={view.record}
onClose={() => setView({ kind: "start" })}
onAgain={() => again(view.record)}
onNew={newAssignment}
onToDeck={() => turnIntoDeck(view.record)}
againLoading={againLoading}
/>
<div className="space-y-5">
{view.record.mode === "make" ? (
<HomeworkResult
record={view.record}
onAgain={() => again(view.record)}
onNew={newAssignment}
onToDeck={() => turnIntoDeck(view.record)}
againLoading={againLoading}
/>
) : view.record.mode === "check" ? (
<HomeworkCheckResult
record={view.record}
onAgain={() => again(view.record)}
onNew={newAssignment}
onToDeck={() => turnIntoDeck(view.record)}
againLoading={againLoading}
/>
) : (
<HomeworkGuide
record={view.record}
onClose={() => setView({ kind: "start" })}
onAgain={() => again(view.record)}
onNew={newAssignment}
onToDeck={() => turnIntoDeck(view.record)}
againLoading={againLoading}
/>
)}
<AiDisclaimer />
</div>
);
}