create-principles-disciple 1.82.0 → 1.83.0

package/console/dist/ui/pages/settings/UpdatePage.js

@@ -0,0 +1,168 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useState, useEffect, useCallback } from "react";
+import { useTranslation } from "react-i18next";
+import { toast } from "sonner";
+import { PageShell } from "../../components/layout/page-shell.js";
+import { SectionTitle } from "../../components/layout/section-title.js";
+import { fetchUpdateStatus, fetchUpdateHistory, } from "../../api.js";
+// ── Runtime validators (H section / ERR-001/005/009/013) ─────────────────────
+/** 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);
+}
+export function validateUpdateStatusData(raw) {
+    if (!isRecord(raw))
+        return null;
+    if (!Object.hasOwn(raw, "currentVersion") ||
+        !Object.hasOwn(raw, "latestVersion") ||
+        !Object.hasOwn(raw, "updateAvailable") ||
+        !Object.hasOwn(raw, "lastChecked")) {
+        return null;
+    }
+    const currentVersion = raw.currentVersion;
+    const latestVersion = raw.latestVersion;
+    const updateAvailable = raw.updateAvailable;
+    const lastChecked = raw.lastChecked;
+    if (typeof currentVersion !== "string" ||
+        typeof latestVersion !== "string" ||
+        typeof updateAvailable !== "boolean" ||
+        typeof lastChecked !== "string") {
+        return null;
+    }
+    return { currentVersion, latestVersion, updateAvailable, lastChecked };
+}
+export function validateUpdateHistoryEntry(raw) {
+    if (!isRecord(raw))
+        return null;
+    if (!Object.hasOwn(raw, "version") ||
+        !Object.hasOwn(raw, "appliedAt") ||
+        !Object.hasOwn(raw, "notes")) {
+        return null;
+    }
+    const version = raw.version;
+    const appliedAt = raw.appliedAt;
+    const notes = raw.notes;
+    if (typeof version !== "string" ||
+        typeof appliedAt !== "string" ||
+        typeof notes !== "string") {
+        return null;
+    }
+    return { version, appliedAt, notes };
+}
+export function validateUpdateHistoryData(raw) {
+    if (!isRecord(raw))
+        return null;
+    if (!Object.hasOwn(raw, "updates")) {
+        return null;
+    }
+    const updates = raw.updates;
+    if (!Array.isArray(updates)) {
+        return null;
+    }
+    // Fail loud: any invalid entry rejects the entire payload (ERR-009)
+    const validatedEntries = [];
+    for (const entry of updates) {
+        const validated = validateUpdateHistoryEntry(entry);
+        if (validated === null)
+            return null;
+        validatedEntries.push(validated);
+    }
+    return { updates: validatedEntries };
+}
+// ── Helper: format ISO date string to locale-aware display ────────────────────
+function formatDate(isoString, locale) {
+    try {
+        const date = new Date(isoString);
+        if (Number.isNaN(date.getTime()))
+            return isoString;
+        return date.toLocaleDateString(locale, {
+            year: "numeric",
+            month: "short",
+            day: "numeric",
+            hour: "2-digit",
+            minute: "2-digit",
+        });
+    }
+    catch {
+        return isoString;
+    }
+}
+export function UpdatePage() {
+    const { t, i18n } = useTranslation();
+    const [statusData, setStatusData] = useState(null);
+    const [historyData, setHistoryData] = useState(null);
+    const [loadingState, setLoadingState] = useState("loading");
+    const [checking, setChecking] = useState(false);
+    const [errorMessage, setErrorMessage] = useState(null);
+    const [historyErrorReason, setHistoryErrorReason] = useState(null);
+    const locale = i18n.language === "zh-CN" ? "zh-CN" : "en-US";
+    const loadData = useCallback(async () => {
+        setLoadingState("loading");
+        setErrorMessage(null);
+        setHistoryErrorReason(null);
+        const [statusResult, historyResult] = await Promise.all([
+            fetchUpdateStatus(),
+            fetchUpdateHistory(),
+        ]);
+        // Validate status data (H section / ERR-001/005)
+        if (!statusResult.success) {
+            setLoadingState("error");
+            setErrorMessage(statusResult.error);
+            return;
+        }
+        const validatedStatus = validateUpdateStatusData(statusResult.data);
+        if (validatedStatus === null) {
+            setLoadingState("error");
+            setErrorMessage("Update status data has unexpected shape");
+            return;
+        }
+        setStatusData(validatedStatus);
+        // Validate history data (ERR-002: degradation with reason)
+        if (!historyResult.success) {
+            setHistoryData(null);
+            setHistoryErrorReason(historyResult.error ?? "Update history unavailable");
+        }
+        else {
+            const validatedHistory = validateUpdateHistoryData(historyResult.data);
+            setHistoryData(validatedHistory);
+            if (validatedHistory === null) {
+                setHistoryErrorReason("Update history data has unexpected shape");
+            }
+        }
+        setLoadingState("loaded");
+    }, []);
+    useEffect(() => {
+        loadData();
+    }, [loadData]);
+    const handleCheckForUpdates = useCallback(async () => {
+        setChecking(true);
+        const result = await fetchUpdateStatus();
+        if (!result.success) {
+            toast.error(t("pages.update.checkFailed"));
+            setChecking(false);
+            return;
+        }
+        const validated = validateUpdateStatusData(result.data);
+        if (validated === null) {
+            toast.error(t("pages.update.checkFailed"));
+            setChecking(false);
+            return;
+        }
+        setStatusData(validated);
+        setChecking(false);
+    }, [t]);
+    // ── 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-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.update.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.update.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.update.loadError") }), errorMessage && (_jsx("p", { className: "mt-2 text-ink-4 text-[13px] font-mono", children: errorMessage }))] })] }));
+    }
+    // ── Loaded state ─────────────────────────────────────────────────────────
+    const isUpToDate = statusData ? !statusData.updateAvailable : true;
+    const lastCheckedDisplay = statusData
+        ? (statusData.lastChecked ? formatDate(statusData.lastChecked, locale) : t("pages.update.neverChecked"))
+        : t("pages.update.neverChecked");
+    return (_jsxs(PageShell, { children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.update.eyebrow") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("pages.update.title") }), _jsx("p", { className: "text-ink-3 text-[14px] max-w-[760px] leading-relaxed mb-7", children: t("pages.update.subtitle") }), _jsxs("section", { className: "mb-8", "aria-labelledby": "section-update-status", children: [_jsx(SectionTitle, { id: "section-update-status", children: t("pages.update.currentVersion") }), _jsxs("div", { className: "bg-panel border border-line rounded-[6px] p-5", children: [_jsxs("div", { className: "space-y-4", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: "text-ink-3 text-[13px]", children: t("pages.update.currentVersion") }), _jsx("span", { className: "font-mono text-[13px] text-ink", children: statusData?.currentVersion ?? "—" })] }), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: "text-ink-3 text-[13px]", children: t("pages.update.latestVersion") }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "font-mono text-[13px] text-ink", children: statusData?.latestVersion ?? "—" }), isUpToDate ? (_jsx("span", { className: "inline-flex items-center border border-green/35 text-green rounded-[2px] px-[7px] py-1 font-mono text-[11px] uppercase", children: t("pages.update.upToDate") })) : (_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: t("pages.update.updateAvailable") }))] })] }), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: "text-ink-3 text-[13px]", children: t("pages.update.lastChecked") }), _jsx("span", { className: "text-ink-3 text-[13px]", children: lastCheckedDisplay })] })] }), _jsx("div", { className: "mt-5 pt-4 border-t border-line", children: _jsx("button", { type: "button", onClick: handleCheckForUpdates, disabled: checking, className: "border border-line bg-surface text-ink rounded-[3px] px-[14px] py-[6px] text-[12.5px] hover:border-line-2 transition-colors disabled:opacity-50 disabled:cursor-not-allowed focus-visible:outline-2 focus-visible:outline-gov focus-visible:outline-offset-2", children: checking ? t("pages.update.checking") : t("pages.update.checkForUpdates") }) })] })] }), _jsxs("section", { "aria-labelledby": "section-update-history", children: [_jsx(SectionTitle, { id: "section-update-history", children: t("pages.update.history") }), historyErrorReason ? (_jsxs("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3", children: [t("pages.update.loadError"), " (", historyErrorReason, ")"] })) : historyData && historyData.updates.length > 0 ? (_jsx("div", { className: "space-y-[10px]", children: historyData.updates.map((entry, index) => (_jsxs("article", { className: "bg-panel border border-line rounded-[6px] px-5 py-4", children: [_jsxs("div", { className: "flex items-center justify-between mb-2", children: [_jsxs("div", { className: "flex items-center gap-2", 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: t("pages.update.version") }), _jsx("span", { className: "font-mono text-[13px] text-ink", children: entry.version })] }), _jsx("span", { className: "text-ink-3 text-[13px]", children: formatDate(entry.appliedAt, locale) })] }), entry.notes && (_jsx("div", { className: "text-ink-2 text-[13px] leading-relaxed mt-1", children: entry.notes }))] }, `${entry.version}-${index}`))) })) : (_jsx("div", { className: "text-ink-3 text-[13px] leading-relaxed py-3", children: t("pages.update.noHistory") }))] })] }));
+}

package/console/dist/ui/utils/control-center-helpers.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Control Center Helpers — PRI-303
+ *
+ * Pure logic for the Control Center UI:
+ * - Readiness badge/label mapping
+ * - Overall readiness computation
+ * - Agent grouping by readiness
+ * - Redacted diagnostics for clipboard copy
+ *
+ * ERR entries:
+ * - ERR-001/ERR-005: No `as` bypasses on untrusted data
+ * - ERR-014/ERR-016/ERR-017: Safe serialization for diagnostics copy
+ * - ERR-045: ANY-segment redaction for sensitive keys
+ */
+import type { ReadinessStatus } from '../api.js';
+export interface RedactedRuntimeProfileSummary {
+    id: string;
+    type: string;
+    label: string;
+    apiKeyEnv?: string;
+    readiness: ReadinessStatus;
+}
+export interface RedactedAgentSummary {
+    name: string;
+    enabled: boolean;
+    runtimeProfileId: string;
+    runtimeProfileLabel: string;
+    readiness: ReadinessStatus;
+}
+export interface RedactedFeatureSummary {
+    id: string;
+    category: string;
+    enabled: boolean;
+}
+export interface ControlCenterDiagnostics {
+    version: number;
+    source: 'defaults' | 'user_config';
+    features: RedactedFeatureSummary[];
+    runtimeProfiles: RedactedRuntimeProfileSummary[];
+    defaultRuntime: string;
+    agents: RedactedAgentSummary[];
+    ui: {
+        diagnostics: {
+            mode: string;
+        };
+    };
+    warnings: string[];
+    errors?: {
+        path: string;
+        reason: string;
+        nextAction: string;
+    }[];
+}
+export declare function getReadinessBadgeVariant(readiness: ReadinessStatus): 'default' | 'secondary' | 'destructive' | 'outline';
+export declare function getReadinessLabel(readiness: ReadinessStatus): string;
+export declare function computeOverallReadiness(diag: ControlCenterDiagnostics): ReadinessStatus;
+export declare function groupAgentsByReadiness(diag: ControlCenterDiagnostics): Record<ReadinessStatus, RedactedAgentSummary[]>;
+export declare function redactDiagnosticsForCopy(diag: ControlCenterDiagnostics): string;

package/console/dist/ui/utils/control-center-helpers.js

@@ -0,0 +1,152 @@
+/**
+ * Control Center Helpers — PRI-303
+ *
+ * Pure logic for the Control Center UI:
+ * - Readiness badge/label mapping
+ * - Overall readiness computation
+ * - Agent grouping by readiness
+ * - Redacted diagnostics for clipboard copy
+ *
+ * ERR entries:
+ * - ERR-001/ERR-005: No `as` bypasses on untrusted data
+ * - ERR-014/ERR-016/ERR-017: Safe serialization for diagnostics copy
+ * - ERR-045: ANY-segment redaction for sensitive keys
+ */
+// ── Readiness Badge Variant ──────────────────────────────────────────────────
+export function getReadinessBadgeVariant(readiness) {
+    switch (readiness) {
+        case 'ready': return 'default';
+        case 'needs_setup': return 'secondary';
+        case 'disabled': return 'outline';
+        case 'not_ready': return 'destructive';
+        case 'unknown': return 'secondary';
+        default: return 'secondary';
+    }
+}
+// ── Readiness Label ──────────────────────────────────────────────────────────
+export function getReadinessLabel(readiness) {
+    switch (readiness) {
+        case 'ready': return 'Ready';
+        case 'needs_setup': return 'Needs Setup';
+        case 'disabled': return 'Disabled';
+        case 'not_ready': return 'Not Ready';
+        case 'unknown': return 'Unknown';
+        default: return 'Unknown';
+    }
+}
+// ── Overall Readiness ────────────────────────────────────────────────────────
+export function computeOverallReadiness(diag) {
+    const enabledAgents = diag.agents.filter(a => a.enabled);
+    if (enabledAgents.length === 0) {
+        return diag.agents.length === 0 ? 'unknown' : 'disabled';
+    }
+    const readinessOrder = ['not_ready', 'needs_setup', 'unknown', 'disabled', 'ready'];
+    for (const status of readinessOrder) {
+        if (status === 'disabled')
+            continue; // disabled agents are filtered out above
+        if (enabledAgents.some(a => a.readiness === status)) {
+            return status;
+        }
+    }
+    return 'ready';
+}
+// ── Group Agents by Readiness ────────────────────────────────────────────────
+export function groupAgentsByReadiness(diag) {
+    const groups = {
+        ready: [],
+        needs_setup: [],
+        disabled: [],
+        not_ready: [],
+        unknown: [],
+    };
+    for (const agent of diag.agents) {
+        const status = agent.readiness;
+        if (Object.hasOwn(groups, status)) {
+            groups[status].push(agent);
+        }
+        else {
+            groups.unknown.push(agent);
+        }
+    }
+    return groups;
+}
+// ── Redacted Diagnostics for Copy ────────────────────────────────────────────
+/** Maximum items per section in diagnostics output (ERR-014/ERR-016/ERR-017) */
+const MAX_ITEMS_PER_SECTION = 50;
+function takeBounded(arr) {
+    if (arr.length <= MAX_ITEMS_PER_SECTION)
+        return { items: arr, truncated: 0 };
+    return {
+        items: arr.slice(0, MAX_ITEMS_PER_SECTION),
+        truncated: arr.length - MAX_ITEMS_PER_SECTION,
+    };
+}
+export function redactDiagnosticsForCopy(diag) {
+    const overall = computeOverallReadiness(diag);
+    const lines = [];
+    lines.push('=== PD Control Center Diagnostics ===');
+    lines.push(`Overall Status: ${getReadinessLabel(overall)}`);
+    lines.push(`Config Source: ${diag.source}`);
+    lines.push(`Config Version: ${diag.version}`);
+    lines.push('');
+    // Features
+    lines.push('--- Features ---');
+    const features = takeBounded(diag.features);
+    for (const f of features.items) {
+        lines.push(`  ${f.id}: ${f.category} / ${f.enabled ? 'enabled' : 'disabled'}`);
+    }
+    if (features.truncated > 0)
+        lines.push(`  ... +${features.truncated} more`);
+    lines.push('');
+    // Runtime Profiles (redacted)
+    lines.push('--- Runtime Profiles ---');
+    const profiles = takeBounded(diag.runtimeProfiles);
+    for (const p of profiles.items) {
+        const parts = [`  ${p.id}: ${p.label} [${getReadinessLabel(p.readiness)}]`];
+        // apiKeyEnv is a secret-like key — redact it (ERR-045)
+        if (p.apiKeyEnv) {
+            parts.push(`    apiKeyEnv: [REDACTED]`);
+        }
+        lines.push(parts.join('\n'));
+    }
+    if (profiles.truncated > 0)
+        lines.push(`  ... +${profiles.truncated} more`);
+    lines.push('');
+    // Default Runtime
+    lines.push(`Default Runtime: ${diag.defaultRuntime}`);
+    lines.push('');
+    // Agents
+    lines.push('--- Agents ---');
+    const agents = takeBounded(diag.agents);
+    for (const a of agents.items) {
+        const status = a.enabled ? getReadinessLabel(a.readiness) : 'Disabled';
+        lines.push(`  ${a.name}: ${status} (profile: ${a.runtimeProfileLabel})`);
+    }
+    if (agents.truncated > 0)
+        lines.push(`  ... +${agents.truncated} more`);
+    lines.push('');
+    // Warnings
+    if (diag.warnings.length > 0) {
+        lines.push('--- Warnings ---');
+        const warnings = takeBounded(diag.warnings);
+        for (const w of warnings.items) {
+            lines.push(`  - ${w}`);
+        }
+        if (warnings.truncated > 0)
+            lines.push(`  ... +${warnings.truncated} more`);
+        lines.push('');
+    }
+    // Errors
+    if (diag.errors && diag.errors.length > 0) {
+        lines.push('--- Errors ---');
+        const errors = takeBounded(diag.errors);
+        for (const e of errors.items) {
+            lines.push(`  ${e.path}: ${e.reason} → ${e.nextAction}`);
+        }
+        if (errors.truncated > 0)
+            lines.push(`  ... +${errors.truncated} more`);
+        lines.push('');
+    }
+    lines.push('=== End Diagnostics ===');
+    return lines.join('\n');
+}