create-principles-disciple 1.82.0 → 1.83.0

package/console/dist/ui/pages/focus/FocusPage.js

@@ -0,0 +1,265 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useEffect, useCallback } from "react";
+import { Link } from "react-router-dom";
+import { useTranslation } from "react-i18next";
+import { PageShell } from "../../components/layout/page-shell.js";
+import { SectionTitle } from "../../components/layout/section-title.js";
+import { fetchGovernanceQueue, fetchApprovalsGrouped, } from "../../api.js";
+// ── Approval group validator (not in validators.ts, page-specific) ─────────
+/** Type guard: is this a non-null object with own properties (not inherited)? */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateApprovalGroup(raw) {
+    if (!isRecord(raw))
+        return null;
+    if (!Object.hasOwn(raw, "principleId") ||
+        !Object.hasOwn(raw, "principleTitle") ||
+        !Object.hasOwn(raw, "status") ||
+        !Object.hasOwn(raw, "records")) {
+        return null;
+    }
+    const principleId = raw.principleId;
+    const principleTitle = raw.principleTitle;
+    const status = raw.status;
+    const records = raw.records;
+    if (typeof principleId !== "string" ||
+        typeof principleTitle !== "string" ||
+        typeof status !== "string" ||
+        !["pending", "approved", "rejected"].includes(status) ||
+        !Array.isArray(records)) {
+        return null;
+    }
+    const validRecords = [];
+    for (const r of records) {
+        if (!isRecord(r))
+            return null;
+        if (!Object.hasOwn(r, "id") ||
+            !Object.hasOwn(r, "artifactId") ||
+            !Object.hasOwn(r, "channel") ||
+            !Object.hasOwn(r, "createdAt") ||
+            typeof r.id !== "string" ||
+            typeof r.artifactId !== "string" ||
+            typeof r.channel !== "string" ||
+            typeof r.createdAt !== "string") {
+            return null;
+        }
+        validRecords.push({
+            id: r.id,
+            artifactId: r.artifactId,
+            channel: r.channel,
+            createdAt: r.createdAt,
+        });
+    }
+    return {
+        principleId,
+        principleTitle,
+        status: status,
+        records: validRecords,
+    };
+}
+function validateApprovalsGroupedData(raw) {
+    if (!isRecord(raw))
+        return null;
+    if (!Object.hasOwn(raw, "groups") ||
+        !Object.hasOwn(raw, "generatedAt")) {
+        return null;
+    }
+    const groups = raw.groups;
+    const generatedAt = raw.generatedAt;
+    if (!Array.isArray(groups) || typeof generatedAt !== "string") {
+        return null;
+    }
+    const validatedGroups = [];
+    for (const g of groups) {
+        const validated = validateApprovalGroup(g);
+        if (validated === null)
+            return null;
+        validatedGroups.push(validated);
+    }
+    return {
+        groups: validatedGroups,
+        generatedAt,
+        note: Object.hasOwn(raw, "note") && typeof raw.note === "string" ? raw.note : undefined,
+    };
+}
+// ── i18n code mapping helpers ─────────────────────────────────────────────
+/** Map a stateReasonCode to an i18n key, with optional interpolation params. */
+function getStateReasonText(code, t, pendingReviewCount) {
+    const i18nKey = `pages.focus.stateReason.${code}`;
+    const text = t(i18nKey, { count: pendingReviewCount });
+    // If i18n key is not found, t() returns the key itself — fall back to code
+    return text === i18nKey ? code : text;
+}
+/** Map a nextActionCode to an i18n key. */
+function getNextActionText(code, t) {
+    const i18nKey = `pages.focus.nextAction.${code}`;
+    const text = t(i18nKey);
+    return text === i18nKey ? code : text;
+}
+/** Map a degraded signal reasonCode to an i18n key. */
+function getDegradedReasonText(code, t) {
+    const i18nKey = `pages.focus.degradedReason.${code}`;
+    const text = t(i18nKey);
+    return text === i18nKey ? code : text;
+}
+/** Map a degraded signal nextActionCode to an i18n key. */
+function getDegradedNextActionText(code, t) {
+    const i18nKey = `pages.focus.degradedNextAction.${code}`;
+    const text = t(i18nKey);
+    return text === i18nKey ? code : text;
+}
+// ── Channel label helper ─────────────────────────────────────────────────────
+function getChannelLabel(channel, t) {
+    switch (channel) {
+        case "prompt":
+            return t("pages.focus.channelPrompt");
+        case "defer_archive":
+            return t("pages.focus.channelDeferArchive");
+        case "code_tool_hook":
+            return t("pages.focus.channelCodeToolHook");
+        default:
+            return channel;
+    }
+}
+// ── Sub-components ───────────────────────────────────────────────────────────
+function ProseSummary({ pendingCount, deviationCount, stagnationCount, }) {
+    const { t } = useTranslation();
+    return (_jsxs("div", { className: "text-sm leading-relaxed text-ink-2 mb-7 px-[18px] py-[14px] bg-panel border border-line rounded-[6px]", role: "status", "aria-live": "polite", children: [_jsx("span", { className: "text-ink-3", children: t("pages.focus.summaryLabel") }), " ", _jsx("span", { className: "font-mono font-semibold text-ink", children: pendingCount }), " ", _jsx("span", { className: "text-ink-3", children: t("pages.focus.summaryPending") }), " ", "/", " ", _jsx("span", { className: "font-mono font-semibold text-ink", children: deviationCount }), " ", _jsx("span", { className: "text-ink-3", children: t("pages.focus.summaryDeviation") }), " ", "/", " ", _jsx("span", { className: "font-mono font-semibold text-ink", children: stagnationCount }), " ", _jsx("span", { className: "text-ink-3", children: t("pages.focus.summaryStagnation") })] }));
+}
+function PendingReviewCard({ group, }) {
+    const { t } = useTranslation();
+    const primaryChannel = group.records[0]?.channel ?? "prompt";
+    const channelLabel = getChannelLabel(primaryChannel, t);
+    const isReversible = primaryChannel === "prompt" || primaryChannel === "defer_archive";
+    return (_jsxs("article", { className: "relative pl-[22px] py-[18px] pr-[18px] bg-panel border border-line rounded-[6px] cursor-pointer transition-colors hover:border-line-2", children: [_jsx("div", { className: "absolute left-0 top-0 bottom-0 w-[3px] rounded-l-[6px] bg-gov" }), _jsxs("div", { className: "flex items-center gap-2 flex-wrap", children: [_jsx("span", { className: "inline-flex items-center border border-line rounded-[2px] px-[7px] py-1 font-mono text-[11px] text-ink-3 bg-surface/80 uppercase", children: channelLabel }), isReversible && (_jsx("span", { className: "inline-flex items-center border border-amber/35 text-amber rounded-[2px] px-[7px] py-1 font-mono text-[11px] uppercase", children: primaryChannel === "prompt" ? t("pages.focus.tagReversible") : t("pages.focus.tagLowRisk") }))] }), _jsx("div", { className: "mt-[14px] mb-2 font-semibold text-ink", children: group.principleTitle }), _jsx("div", { className: "mt-2 px-3 py-2 bg-surface/60 border-l-2 border-gov text-ink-3 text-[13px] leading-snug", children: t("pages.focus.evidenceSummary", { count: group.records.length }) }), _jsxs("div", { className: "flex gap-2 mt-4", children: [_jsx(Link, { to: `/principles/${group.principleId}`, className: "inline-flex items-center border border-gov bg-gov text-paper rounded-[3px] px-[14px] py-[6px] text-[12.5px] font-medium hover:bg-gov-2 transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", "data-testid": `review-principle-${group.principleId}`, children: t("pages.focus.reviewAction") }), _jsx(Link, { to: `/principles/${group.principleId}`, className: "inline-flex items-center border border-line bg-surface text-ink rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:border-line-2 transition-colors focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("pages.focus.viewFullChain") })] })] }));
+}
+function StagnationSignalCard({ signal }) {
+    const { t } = useTranslation();
+    const label = signal.type === "never_activated"
+        ? t("pages.focus.stagnationNeverActivated")
+        : t("pages.focus.stagnationNoPain");
+    return (_jsxs("article", { className: "relative pl-[22px] py-[14px] pr-[18px] bg-panel border border-amber/20 border-l-[3px] border-l-amber rounded-[6px]", children: [_jsxs("div", { className: "text-ink-2 text-sm leading-relaxed", children: [_jsx("span", { className: "font-medium text-ink", children: label }), " ", "\u2014 ", signal.principleId, " \u00B7 ", signal.daysSince, " ", t("pages.focus.stagnationDaysSince")] }), _jsxs(Link, { to: `/activation`, className: "inline-flex items-center mt-2 text-gov text-[13px] hover:underline focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: [t("pages.focus.viewFullChain"), " \u2192"] })] }));
+}
+function DegradedSignalCard({ signal }) {
+    const { t } = useTranslation();
+    const sourceLabel = signal.source === "internalization_task"
+        ? t("pages.focus.degradedSourceInternalization")
+        : signal.source === "chain_integrity"
+            ? t("pages.focus.degradedSourceChainIntegrity")
+            : signal.source === "source_unavailable"
+                ? t("pages.focus.degradedSourceUnavailable")
+                : signal.source;
+    // Use i18n-mapped text from reasonCode/nextActionCode
+    const reasonText = getDegradedReasonText(signal.reasonCode, t);
+    const nextActionText = getDegradedNextActionText(signal.nextActionCode, t);
+    return (_jsxs("article", { className: "relative pl-[22px] py-[14px] pr-[18px] bg-panel border border-amber/20 border-l-[3px] border-l-amber rounded-[6px]", children: [_jsx("div", { className: "flex items-center gap-2 mb-2", children: _jsx("span", { className: "inline-flex items-center border border-amber/35 text-amber rounded-[2px] px-[7px] py-1 font-mono text-[11px] uppercase", children: sourceLabel }) }), _jsx("div", { className: "text-ink-2 text-sm leading-relaxed", children: reasonText }), signal.reason && (_jsxs("details", { className: "mt-1", children: [_jsx("summary", { className: "text-ink-4 text-[11px] font-mono cursor-pointer hover:underline", children: t("pages.focus.advancedDiagnostics") }), _jsx("div", { className: "text-ink-4 text-[12px] leading-snug mt-1 font-mono bg-surface/40 px-2 py-1 rounded-[3px] break-all", children: signal.reason })] })), _jsxs("div", { className: "mt-2 text-ink-4 text-[13px] leading-snug", children: [_jsx("span", { className: "font-medium", children: t("pages.focus.degradedNextActionLabel") }), " ", nextActionText] })] }));
+}
+function OnboardingGuide() {
+    const { t } = useTranslation();
+    const steps = [
+        t("pages.focus.onboardingStep1"),
+        t("pages.focus.onboardingStep2"),
+        t("pages.focus.onboardingStep3"),
+        t("pages.focus.onboardingStep4"),
+        t("pages.focus.onboardingStep5"),
+    ];
+    return (_jsxs("div", { className: "bg-panel border border-line rounded-[6px] p-6", children: [_jsx(SectionTitle, { children: t("pages.focus.onboardingTitle") }), _jsx("ol", { className: "space-y-3", children: steps.map((step, i) => (_jsxs("li", { className: "flex gap-3 text-ink-2 text-sm leading-relaxed", children: [_jsx("span", { className: "font-mono text-ink-4 text-[11px] mt-0.5 shrink-0", children: String(i + 1).padStart(2, "0") }), _jsx("span", { children: step })] }, i))) })] }));
+}
+/**
+ * PRI-332: Shown when all counts are zero and sources are healthy.
+ * Explains to the owner that PD has checked everything — not that PD is broken.
+ */
+function ZeroStateHealthy() {
+    const { t } = useTranslation();
+    return (_jsx("div", { className: "bg-panel border border-line rounded-[6px] p-6", children: _jsx("p", { className: "text-ink-2 text-sm leading-relaxed", children: t("pages.focus.zeroStateHealthy") }) }));
+}
+/**
+ * PRI-332: Shown when state_db_missing — first-time setup explanation.
+ */
+function ZeroStateDbMissing() {
+    const { t } = useTranslation();
+    return (_jsxs("div", { className: "bg-panel border border-line rounded-[6px] p-6", children: [_jsx("p", { className: "text-ink-2 text-sm leading-relaxed", children: t("pages.focus.zeroStateDbMissing") }), _jsxs("div", { className: "mt-3 text-ink-4 text-[13px]", children: [_jsx("span", { className: "font-medium", children: t("pages.focus.nextActionLabel") }), " ", getNextActionText("run_config_doctor", t)] })] }));
+}
+function InProgressGuide({ summary }) {
+    const { t } = useTranslation();
+    return (_jsxs("div", { className: "bg-panel border border-line rounded-[6px] p-6", children: [_jsx(SectionTitle, { children: t("pages.focus.inProgressTitle") }), _jsx("p", { className: "text-ink-2 text-sm leading-relaxed mt-2", children: summary }), _jsx("p", { className: "text-ink-4 text-[13px] leading-relaxed mt-3", children: t("pages.focus.inProgressDetail") })] }));
+}
+function DegradedSummary({ signals }) {
+    const { t } = useTranslation();
+    return (_jsxs("div", { className: "bg-panel border border-amber/20 border-l-[3px] border-l-amber rounded-[6px] p-5", children: [_jsx(SectionTitle, { children: t("pages.focus.degradedTitle") }), _jsx("p", { className: "text-ink-2 text-sm leading-relaxed mt-2", children: t("pages.focus.degradedStateReason") }), _jsx("div", { className: "mt-4 space-y-[10px]", children: signals.map((signal, i) => (_jsx(DegradedSignalCard, { signal: signal }, `${signal.source}-${i}`))) })] }));
+}
+export function FocusPage() {
+    const { t } = useTranslation();
+    const [queueData, setQueueData] = useState(null);
+    const [groupedData, setGroupedData] = useState(null);
+    const [loadingState, setLoadingState] = useState("loading");
+    const [errorMessage, setErrorMessage] = useState(null);
+    const [groupedErrorReason, setGroupedErrorReason] = useState(null);
+    const loadData = useCallback(async () => {
+        setLoadingState("loading");
+        setErrorMessage(null);
+        setGroupedErrorReason(null);
+        const [queueResult, groupedResult] = await Promise.all([
+            fetchGovernanceQueue(),
+            fetchApprovalsGrouped(),
+        ]);
+        // Queue data is already validated by the API layer (validateGovernanceQueue)
+        if (!queueResult.success) {
+            setLoadingState("error");
+            setErrorMessage(queueResult.error);
+            return;
+        }
+        setQueueData(queueResult.data);
+        // Validate grouped data (ERR-002: degradation with reason)
+        if (!groupedResult.success) {
+            setGroupedData(null);
+            setGroupedErrorReason(groupedResult.error ?? "Approvals data unavailable");
+        }
+        else {
+            const validatedGrouped = validateApprovalsGroupedData(groupedResult.data);
+            setGroupedData(validatedGrouped);
+            if (validatedGrouped === null) {
+                setGroupedErrorReason("Approvals data has unexpected shape");
+            }
+        }
+        setLoadingState("loaded");
+    }, []);
+    useEffect(() => {
+        loadData();
+    }, [loadData]);
+    // ── Loading state ────────────────────────────────────────────────────────
+    if (loadingState === "loading") {
+        return (_jsx(PageShell, { children: _jsxs("div", { className: "text-ink-3 text-sm", role: "status", "aria-live": "polite", children: [t("common.loading"), "\u2026"] }) }));
+    }
+    // ── Error state (ERR-002: degradation with reason) ───────────────────────
+    if (loadingState === "error") {
+        return (_jsxs(PageShell, { children: [_jsx("div", { className: "font-mono text-[11px] uppercase tracking-[0.1em] text-ink-3 mb-2", children: t("pages.focus.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.focus.title") }), _jsxs("div", { className: "mt-6 p-4 bg-panel border border-line rounded-[6px] text-ink-2 text-sm", children: [_jsx("p", { children: t("pages.focus.loadError") }), errorMessage && (_jsx("p", { className: "mt-2 text-ink-4 text-[13px] font-mono", children: errorMessage }))] })] }));
+    }
+    // ── Loaded state ─────────────────────────────────────────────────────────
+    const pendingGroups = groupedData?.groups.filter((g) => g.status === "pending") ?? [];
+    const pendingCount = queueData?.pendingReviewCount ?? 0;
+    const deviationCount = queueData?.behaviorDeviationCount ?? 0;
+    const stagnationSignals = queueData?.stagnationSignals ?? [];
+    const stagnationCount = stagnationSignals.length;
+    const governanceState = queueData?.governanceState ?? "none";
+    const stateReasonCode = queueData?.stateReasonCode ?? "no_pipeline_activity";
+    const nextActionCode = queueData?.nextActionCode ?? "wait_for_pipeline";
+    const inProgressSummary = queueData?.inProgressSummary;
+    const degradedSignals = queueData?.degradedSignals;
+    const approvalDataUnavailable = (groupedData === null || groupedData.groups.length === 0) && pendingCount > 0;
+    // Map codes to i18n text
+    const stateReason = getStateReasonText(stateReasonCode, t, pendingCount);
+    const nextAction = getNextActionText(nextActionCode, t);
+    return (_jsxs(PageShell, { children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.focus.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.focus.title") }), _jsx("p", { className: "text-ink-3 text-[14px] max-w-[760px] leading-relaxed mb-7", children: t("pages.focus.subtitle") }), _jsxs("div", { className: "mb-7 px-[18px] py-[14px] bg-panel border border-line rounded-[6px]", children: [_jsx("div", { className: "flex items-center gap-2 mb-1", children: _jsx("span", { className: `inline-flex items-center rounded-[2px] px-[7px] py-1 font-mono text-[11px] uppercase ${governanceState === "owner_review_ready"
+                                ? "bg-gov/10 text-gov border border-gov/20"
+                                : governanceState === "degraded"
+                                    ? "bg-amber/10 text-amber border border-amber/20"
+                                    : governanceState === "in_progress"
+                                        ? "bg-green/10 text-green border border-green/20"
+                                        : "text-ink-4 border border-line bg-surface/80"}`, role: "status", children: t(`pages.focus.stateLabel.${governanceState}`) }) }), _jsx("div", { className: "text-ink-2 text-[13px] leading-relaxed mt-1", children: stateReason }), _jsxs("div", { className: "text-ink-4 text-[13px] leading-relaxed mt-1", children: [_jsx("span", { className: "font-medium", children: t("pages.focus.nextActionLabel") }), " ", nextAction] })] }), _jsx(ProseSummary, { pendingCount: pendingCount, deviationCount: deviationCount, stagnationCount: stagnationCount }), governanceState === "none" && pendingCount === 0 && deviationCount === 0 && stagnationCount === 0 && (stateReasonCode === "state_db_missing" ? (_jsx(ZeroStateDbMissing, {})) : (_jsxs(_Fragment, { children: [_jsx(ZeroStateHealthy, {}), _jsx("div", { className: "mt-4", children: _jsx(OnboardingGuide, {}) })] }))), governanceState === "in_progress" && inProgressSummary && (_jsx(InProgressGuide, { summary: inProgressSummary })), degradedSignals && degradedSignals.length > 0 && (_jsx(DegradedSummary, { signals: degradedSignals })), _jsxs("section", { className: "mt-8", "aria-labelledby": "section-pending", children: [_jsx(SectionTitle, { id: "section-pending", children: t("pages.focus.sectionPending") }), pendingGroups.length > 0 ? (_jsx("div", { className: "space-y-[14px]", children: pendingGroups.map((group) => (_jsx(PendingReviewCard, { group: group }, group.principleId))) })) : (_jsx("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3", children: approvalDataUnavailable
+                            ? (groupedErrorReason
+                                ? `${t("pages.focus.loadError")} (${groupedErrorReason})`
+                                : t("pages.focus.loadError"))
+                            : t("pages.focus.emptyPending") }))] }), _jsxs("section", { className: "mt-8", "aria-labelledby": "section-deviation", children: [_jsx(SectionTitle, { id: "section-deviation", children: t("pages.focus.sectionDeviation") }), deviationCount > 0 ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: "text-ink-2 text-sm mb-3", children: [_jsx("span", { className: "font-mono font-semibold text-ink", children: deviationCount }), " ", t("pages.focus.deviationCount", { count: deviationCount })] }), _jsx("div", { className: "text-ink-4 text-[13px] bg-surface/60 border-l-2 border-amber px-3 py-2 mb-4", children: t("pages.focus.deviationDisclaimer") }), _jsxs("details", { className: "group", children: [_jsx("summary", { className: "text-gov text-[13px] cursor-pointer hover:underline focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: t("pages.focus.viewFullChain") }), _jsx("div", { className: "mt-2 pl-4 border-l-2 border-line text-ink-3 text-[13px]", children: t("pages.focus.deviationDetailPending") })] })] })) : (_jsx("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3", children: t("pages.focus.emptyDeviation") }))] }), _jsxs("section", { className: "mt-8", "aria-labelledby": "section-signals", children: [_jsx(SectionTitle, { id: "section-signals", children: t("pages.focus.sectionSignals") }), stagnationSignals.length > 0 ? (_jsx("div", { className: "space-y-[10px]", children: stagnationSignals.map((signal) => (_jsx(StagnationSignalCard, { signal: signal }, signal.principleId))) })) : (_jsx("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3", children: t("pages.focus.emptySignals") }))] }), _jsx("footer", { className: "mt-12 pt-6 border-t border-line text-ink-3 text-[13px]", children: t("pages.focus.footer") })] }));
+}

package/console/dist/ui/pages/pain/PainEvidenceValidators.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Runtime validators and derivation logic for Pain Evidence page data.
+ *
+ * Derives behavior evidence from existing principles data — no new backend
+ * route needed. Principles with `derivedFromPainIds` or `painPreventedCount > 0`
+ * represent evidence that was captured and internalized.
+ *
+ * This follows H-section rules and ERR-001/005/009/010.
+ */
+export interface PainEvidence {
+    /** The principle ID that was derived from this pain evidence */
+    id: string;
+    /** Principle text — serves as the evidence title */
+    title: string;
+    /** The trigger pattern — describes the context where the deviation occurred */
+    context: string;
+    /** The action — describes what the agent should do instead */
+    expectedBehavior: string;
+    /** Source: always 'principle_derivation' since we derive from principles */
+    source: 'principle_derivation';
+    /** Maps principle status to recommendation state */
+    recommendationState: 'pending' | 'candidate' | 'principle' | 'dismissed';
+    /** Pain-related metadata from the principle */
+    trajectorySummary: {
+        principleId: string;
+        painPreventedCount: number;
+        lastPainPreventedAt: string;
+        derivedFromPainIds: string[];
+    };
+    createdAt: string;
+}
+export interface PainEvidenceListData {
+    evidence: PainEvidence[];
+    generatedAt: string;
+    /** Present when data is degraded/missing rather than genuinely zero */
+    note?: string;
+}
+export interface PainEvidenceDegraded {
+    reason: string;
+    nextAction: string;
+}
+/**
+ * Derive a single PainEvidence from a principle list item + detail.
+ * Returns null if the principle has no pain-related data.
+ */
+export declare function derivePainEvidenceFromPrinciple(listItem: unknown, detail?: unknown): PainEvidence | null;
+/**
+ * Validate the principles list response and derive pain evidence.
+ * Uses existing /api/principles data — no new backend route needed.
+ */
+export declare function derivePainEvidenceFromPrinciplesList(raw: unknown): PainEvidenceListData | PainEvidenceDegraded;
+/**
+ * Check if a parsed result is degraded (missing data).
+ */
+export declare function isDegraded(result: PainEvidenceListData | PainEvidenceDegraded): result is PainEvidenceDegraded;
+/**
+ * Get error message from an unknown API error.
+ */
+export declare function getErrorMessage(err: unknown): string;

package/console/dist/ui/pages/pain/PainEvidenceValidators.js

@@ -0,0 +1,125 @@
+/**
+ * Runtime validators and derivation logic for Pain Evidence page data.
+ *
+ * Derives behavior evidence from existing principles data — no new backend
+ * route needed. Principles with `derivedFromPainIds` or `painPreventedCount > 0`
+ * represent evidence that was captured and internalized.
+ *
+ * This follows H-section rules and ERR-001/005/009/010.
+ */
+// ── Validators ────────────────────────────────────────────────────────────────
+const VALID_PRINCIPLE_STATUSES = ['candidate', 'active', 'archived', 'deprecated', 'probation'];
+function isString(value) {
+    return typeof value === 'string';
+}
+function isNumber(value) {
+    return typeof value === 'number' && !Number.isNaN(value);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Map a principle status to a pain evidence recommendationState.
+ * - candidate → pending (not yet reviewed)
+ * - active → principle (internalized)
+ * - probation → candidate (under review)
+ * - archived/deprecated → dismissed
+ */
+function mapRecommendationState(status) {
+    switch (status) {
+        case 'candidate': return 'pending';
+        case 'active': return 'principle';
+        case 'probation': return 'candidate';
+        case 'archived':
+        case 'deprecated': return 'dismissed';
+        default: return 'pending';
+    }
+}
+/**
+ * Derive a single PainEvidence from a principle list item + detail.
+ * Returns null if the principle has no pain-related data.
+ */
+export function derivePainEvidenceFromPrinciple(listItem, detail) {
+    if (!isRecord(listItem))
+        return null;
+    // Must have pain-related fields
+    const { painPreventedCount, derivedFromPainIds, lastPainPreventedAt } = detail && isRecord(detail) ? detail : listItem;
+    const painCount = isNumber(painPreventedCount) ? painPreventedCount : 0;
+    const painIds = Array.isArray(derivedFromPainIds)
+        ? derivedFromPainIds.filter(isString)
+        : [];
+    const lastPainAt = isString(lastPainPreventedAt) ? lastPainPreventedAt : '';
+    // Only derive evidence if there's actual pain data
+    if (painCount === 0 && painIds.length === 0 && !lastPainAt) {
+        return null;
+    }
+    // Required fields from list item
+    const { id, text, triggerPattern, action, status, createdAt } = listItem;
+    if (!isString(id) || !isString(text))
+        return null;
+    const principleStatus = isString(status) && VALID_PRINCIPLE_STATUSES.includes(status)
+        ? status
+        : 'candidate';
+    return {
+        id,
+        title: isString(text) ? text : '',
+        context: isString(triggerPattern) ? triggerPattern : '',
+        expectedBehavior: isString(action) ? action : '',
+        source: 'principle_derivation',
+        recommendationState: mapRecommendationState(principleStatus),
+        trajectorySummary: {
+            principleId: id,
+            painPreventedCount: painCount,
+            lastPainPreventedAt: lastPainAt,
+            derivedFromPainIds: painIds,
+        },
+        createdAt: isString(createdAt) ? createdAt : new Date().toISOString(),
+    };
+}
+/**
+ * Validate the principles list response and derive pain evidence.
+ * Uses existing /api/principles data — no new backend route needed.
+ */
+export function derivePainEvidenceFromPrinciplesList(raw) {
+    if (!isRecord(raw)) {
+        return {
+            reason: 'Invalid response format from server',
+            nextAction: 'Try refreshing the page. If the problem persists, check the Console API.',
+        };
+    }
+    const { principles: rawPrinciples } = raw;
+    if (!Array.isArray(rawPrinciples)) {
+        return {
+            reason: 'Response missing principles array',
+            nextAction: 'Try refreshing the page.',
+        };
+    }
+    // Derive evidence from each principle (ERR-005/007: validate array element types)
+    const evidence = [];
+    for (const item of rawPrinciples) {
+        const derived = derivePainEvidenceFromPrinciple(item);
+        if (derived !== null) {
+            evidence.push(derived);
+        }
+    }
+    return {
+        evidence,
+        generatedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Check if a parsed result is degraded (missing data).
+ */
+export function isDegraded(result) {
+    return !('evidence' in result);
+}
+/**
+ * Get error message from an unknown API error.
+ */
+export function getErrorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    return 'Unknown error';
+}

package/console/dist/ui/pages/pain/PainPage.js

@@ -0,0 +1,136 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * PainPage — Behavior Evidence page showing real evidence/pain/diagnosis chain states.
+ *
+ * PRI-331: Replaces the old approach of deriving evidence from principle metrics
+ * with a direct read model from pain_events, tasks, candidates, and ledger.
+ *
+ * Privacy boundary (G.2 / F.3 / F.5):
+ * - No raw prompt, chat, trajectory, token, full absolute path, or stack trace
+ * - All summaries are already sanitized by the backend EvidenceChainConsoleModel
+ * - Degraded paths show reason + nextAction, never silent fallback (ERR-002)
+ */
+import { useState, useEffect, useCallback } from 'react';
+import { useTranslation } from 'react-i18next';
+import { PageShell } from '../../components/layout/page-shell.js';
+import { Badge } from '../../components/ui/badge.js';
+import { Card, CardContent, CardHeader, CardTitle } from '../../components/ui/card.js';
+import { Button } from '../../components/ui/button.js';
+import { fetchEvidenceChain } from '../../api.js';
+import { formatDate } from '../../utils/format.js';
+/**
+ * Translate with fallback — if the i18n key doesn't exist (returns the key itself),
+ * return the fallback instead. Prevents raw keys like "pages.pain.source_unknown_value"
+ * from being displayed to the user.
+ */
+function tFallback(t, key, fallback) {
+    const result = t(key);
+    return result === key ? fallback : result;
+}
+function groupForState(state) {
+    switch (state) {
+        case 'pain_recorded':
+        case 'diagnosis_queued':
+        case 'diagnosis_running':
+        case 'diagnosis_succeeded':
+        case 'candidate_generated':
+        case 'internalization_started':
+            return 'active_chain';
+        case 'evidence_only':
+            return 'evidence_only';
+        case 'diagnosis_failed':
+        case 'diagnosis_retry_wait':
+            return 'failed';
+        default:
+            return 'evidence_only';
+    }
+}
+const GROUP_ORDER = ['active_chain', 'failed', 'evidence_only'];
+export function PainPage() {
+    const { t } = useTranslation();
+    const [state, setState] = useState({ status: 'loading' });
+    const [expandedIds, setExpandedIds] = useState(new Set());
+    const loadData = useCallback(async () => {
+        setState({ status: 'loading' });
+        const result = await fetchEvidenceChain();
+        if (!result.success) {
+            setState({ status: 'error', message: result.error ?? 'Unknown error' });
+            return;
+        }
+        if (result.data) {
+            setState({ status: 'loaded', data: result.data });
+        }
+        else {
+            // Validation returned null — degraded state
+            setState({
+                status: 'error',
+                message: t('pages.pain.validationError'),
+            });
+        }
+    }, [t]);
+    useEffect(() => {
+        loadData();
+    }, [loadData]);
+    const toggleExpanded = (id) => {
+        setExpandedIds((prev) => {
+            const next = new Set(prev);
+            if (next.has(id)) {
+                next.delete(id);
+            }
+            else {
+                next.add(id);
+            }
+            return next;
+        });
+    };
+    return (_jsxs(PageShell, { children: [_jsxs("div", { className: "mb-8", children: [_jsx("div", { className: "font-mono text-[11px] uppercase tracking-[0.14em] text-ink-3", children: t('pages.pain.eyebrow') }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mt-3 mb-2", children: t('pages.pain.title') }), _jsx("p", { className: "text-ink-3 text-sm leading-relaxed max-w-[712px]", children: t('pages.pain.description') })] }), _jsx("div", { className: "mb-6 p-3 bg-panel border border-line rounded-[var(--radius-md)] text-ink-3 text-[13px] leading-relaxed", children: t('pages.pain.honestyNote') }), state.status === 'loading' && (_jsxs("div", { className: "text-ink-3 text-sm py-8", children: [t('common.loading'), "\u2026"] })), state.status === 'error' && (_jsxs("div", { className: "py-8", children: [_jsxs("div", { className: "text-danger text-sm mb-2", children: [t('pages.pain.loadError'), ": ", state.message] }), _jsx(Button, { variant: "outline", size: "sm", onClick: loadData, children: t('common.refresh') })] })), state.status === 'loaded' && (_jsx(LoadedContent, { data: state.data, expandedIds: expandedIds, onToggle: toggleExpanded, onRefresh: loadData, t: t }))] }));
+}
+function LoadedContent({ data, expandedIds, onToggle, onRefresh, t }) {
+    // Show degraded banner if data sources are partially unavailable
+    const hasDegraded = !!data.degradedReason;
+    // Group records by state category
+    const grouped = new Map();
+    for (const record of data.records) {
+        const group = groupForState(record.state);
+        const existing = grouped.get(group) ?? [];
+        existing.push(record);
+        grouped.set(group, existing);
+    }
+    const hasRecords = data.records.length > 0;
+    return (_jsxs(_Fragment, { children: [hasDegraded && (_jsxs("div", { className: "mb-4 p-3 bg-panel border border-amber/20 rounded-[var(--radius-md)] text-amber text-[13px]", children: [_jsx("div", { className: "mb-1", children: data.degradedReason }), data.nextAction && (_jsx("div", { className: "text-ink-3 text-[12px]", children: data.nextAction }))] })), !hasRecords && data.note && (_jsx("div", { className: "mb-4 p-3 bg-panel border border-line rounded-[var(--radius-md)] text-ink-3 text-[13px]", children: data.note })), !hasRecords && !hasDegraded && _jsx(EmptyState, { t: t }), hasRecords && (_jsx("div", { className: "space-y-8", children: GROUP_ORDER.map((group) => {
+                    const records = grouped.get(group);
+                    if (!records || records.length === 0)
+                        return null;
+                    return (_jsxs("div", { children: [_jsxs("div", { className: "font-mono text-[11px] uppercase tracking-[0.12em] text-ink-4 mb-3", children: [t(`pages.pain.group_${group}`), " (", records.length, ")"] }), _jsx("div", { className: "space-y-4", children: records.map((record) => (_jsx(EvidenceChainCard, { record: record, expanded: expandedIds.has(record.id), onToggle: () => onToggle(record.id), t: t }, record.id))) })] }, group));
+                }) })), _jsxs("div", { className: "mt-8 font-mono text-[11px] text-ink-4", children: [t('pages.pain.generatedAt'), ": ", formatDate(data.generatedAt)] })] }));
+}
+// ── Empty state (E section: guide next step, not "暂无数据") ──────────────────
+function EmptyState({ t }) {
+    return (_jsx("div", { className: "py-8", children: _jsxs("div", { className: "p-5 bg-panel border border-line rounded-[var(--radius-md)]", children: [_jsx("h3", { className: "text-[17px] font-semibold text-ink mb-2", children: t('pages.pain.emptyTitle') }), _jsx("p", { className: "text-ink-3 text-sm leading-relaxed", children: t('pages.pain.emptyDescription') })] }) }));
+}
+function EvidenceChainCard({ record, expanded, onToggle, t }) {
+    const stateVariant = stateToVariant(record.state);
+    const stateLabel = tFallback(t, `pages.pain.state_${record.state}`, record.state);
+    const sourceLabel = tFallback(t, `pages.pain.source_${record.sourceKind}`, record.sourceKind);
+    return (_jsxs(Card, { className: "overflow-hidden", children: [_jsxs(CardHeader, { children: [_jsxs("div", { className: "flex items-start justify-between gap-3", children: [_jsxs("div", { className: "flex items-center gap-2 flex-wrap", children: [_jsx(Badge, { variant: stateVariant, children: stateLabel }), _jsx(Badge, { variant: "outline", children: sourceLabel }), record.admissionDecision && (_jsx(Badge, { variant: "secondary", children: tFallback(t, `pages.pain.admission_${record.admissionDecision}`, record.admissionDecision) }))] }), _jsx("span", { className: "font-mono text-[11px] text-ink-4 whitespace-nowrap", children: formatDate(record.observedAt) })] }), _jsx(CardTitle, { className: "mt-2", children: record.summary })] }), _jsxs(CardContent, { children: [_jsxs("div", { className: "space-y-3 mb-4", children: [record.failureReason && (_jsxs("div", { children: [_jsx("div", { className: "font-mono text-[11px] uppercase tracking-[0.08em] text-ink-4 mb-1", children: t('pages.pain.fieldFailureReason') }), _jsx("p", { className: "text-danger text-sm leading-relaxed", children: record.failureReason })] })), record.nextAction && (_jsxs("div", { children: [_jsx("div", { className: "font-mono text-[11px] uppercase tracking-[0.08em] text-ink-4 mb-1", children: t('pages.pain.fieldNextAction') }), _jsx("p", { className: "text-ink-2 text-sm leading-relaxed", children: record.nextAction })] })), record.degradedReason && (_jsxs("div", { children: [_jsx("div", { className: "font-mono text-[11px] uppercase tracking-[0.08em] text-ink-4 mb-1", children: t('pages.pain.fieldDegradedReason') }), _jsx("p", { className: "text-amber text-sm leading-relaxed", children: record.degradedReason })] }))] }), _jsxs("details", { open: expanded, onToggle: onToggle, children: [_jsx("summary", { className: "font-mono text-[11px] uppercase tracking-[0.1em] text-ink-3 cursor-pointer select-none hover:text-ink transition-colors", children: t('pages.pain.chainToggle') }), _jsx("div", { className: "mt-3 p-3 bg-paper-2 border border-line rounded-[var(--radius-sm)]", children: _jsxs("div", { className: "grid grid-cols-[auto_1fr] gap-x-4 gap-y-2 text-[13px]", children: [_jsx("span", { className: "font-mono text-ink-4", children: t('pages.pain.chainId') }), _jsx("span", { className: "font-mono text-ink-2", children: record.id }), record.linkedTaskId && (_jsxs(_Fragment, { children: [_jsx("span", { className: "font-mono text-ink-4", children: t('pages.pain.chainTaskId') }), _jsx("span", { className: "font-mono text-ink-2", children: record.linkedTaskId })] })), record.linkedTaskStatus && (_jsxs(_Fragment, { children: [_jsx("span", { className: "font-mono text-ink-4", children: t('pages.pain.chainTaskStatus') }), _jsx("span", { className: "font-mono text-ink-2", children: record.linkedTaskStatus })] })), record.linkedCandidateId && (_jsxs(_Fragment, { children: [_jsx("span", { className: "font-mono text-ink-4", children: t('pages.pain.chainCandidateId') }), _jsx("span", { className: "font-mono text-ink-2", children: record.linkedCandidateId })] })), record.linkedPrincipleId && (_jsxs(_Fragment, { children: [_jsx("span", { className: "font-mono text-ink-4", children: t('pages.pain.chainPrincipleId') }), _jsx("span", { className: "font-mono text-ink-2", children: record.linkedPrincipleId })] })), _jsx("span", { className: "font-mono text-ink-4", children: t('pages.pain.chainSourceKind') }), _jsx("span", { className: "font-mono text-ink-2", children: record.sourceKind }), _jsx("span", { className: "font-mono text-ink-4", children: t('pages.pain.chainState') }), _jsx("span", { className: "font-mono text-ink-2", children: record.state })] }) })] })] })] }));
+}
+// ── Helpers ────────────────────────────────────────────────────────────────────
+function stateToVariant(state) {
+    switch (state) {
+        case 'pain_recorded':
+        case 'diagnosis_queued':
+        case 'diagnosis_running':
+            return 'amber';
+        case 'diagnosis_succeeded':
+        case 'candidate_generated':
+        case 'internalization_started':
+            return 'green';
+        case 'diagnosis_failed':
+            return 'destructive';
+        case 'diagnosis_retry_wait':
+            return 'amber';
+        case 'evidence_only':
+        default:
+            return 'secondary';
+    }
+}