create-principles-disciple 1.143.0 → 1.143.1

package/console/dist/ui/pages/principles/PrinciplesPage.js

@@ -7,7 +7,7 @@ import { SectionTitle } from "../../components/layout/section-title.js";
 import { Button } from "../../components/ui/button.js";
 import { Skeleton } from "../../components/ui/skeleton.js";
 import { ShinyText } from "../../components/ui/shiny-text.js";
-import { fetchPrinciples, fetchApprovalsGrouped, } from "../../api.js";
+import { fetchPrinciples, fetchApprovalsGrouped, fetchOwnerDecisionLibrary, } from "../../api.js";
 import { enumLabel } from "../../utils/enum-labels.js";
 import { formatDate } from "../../utils/format-date.js";
 import { PrinciplesViewNav } from "./PrinciplesViewNav.js";
@@ -155,15 +155,20 @@ export function PrinciplesPage() {
     // "只看待决策"不再作为默认视图 (真实决策在治理焦点)。
     const [filterMode, setFilterMode] = useState('all');
     const [categories, setCategories] = useState();
+    // Owner Decision Experience v1: backend semantic titles + decision states
+    // (display-only — the page never re-derives decision qualification).
+    const [ownerDecisionLibrary, setOwnerDecisionLibrary] = useState(null);
     // Fetch data
     const loadData = useCallback(async () => {
         setLoading(true);
         setError(null);
         try {
-            const [pResult, aResult] = await Promise.all([
+            const [pResult, aResult, dResult] = await Promise.all([
                 fetchPrinciples(filterMode),
                 fetchApprovalsGrouped(),
+                fetchOwnerDecisionLibrary(),
             ]);
+            setOwnerDecisionLibrary(dResult.success && dResult.data ? dResult.data : null);
             if (!pResult.success) {
                 setError(pResult.error ?? "Failed to load principles");
                 return;
@@ -203,18 +208,25 @@ export function PrinciplesPage() {
             ? ag.records.map((r) => r.channel).filter(isString)
             : ["prompt"];
         const uniqueChannels = [...new Set(channels)];
-        const confidence = p.evaluability === "deterministic"
-            ? "high"
-            : p.evaluability === "weak_heuristic"
-                ? "low"
-                : "medium";
+        // Owner Decision Experience v1 (SPEC §10/§11.2): the card title comes
+        // from the backend Semantic Selector; when no readable principle exists
+        // the card shows a NEUTRAL placeholder — the technical trigger/original
+        // text stays reachable in the collapsed details below (never the title).
+        const decision = ownerDecisionLibrary?.entries[p.id];
+        const semanticTitle = decision?.learnedPrinciple.status === 'known' ? decision.learnedPrinciple.text : undefined;
         // PRI-332: Determine display title with bounded fallback for unreadable titles
         const rawTitle = p.triggerPattern || p.text.slice(0, 80);
         const detectedLang = p.detectedLanguage ?? 'unknown';
         const readWarningCode = p.readabilityWarningCode;
         let displayTitle = rawTitle;
         let usedFallback = false;
-        if (readWarningCode) {
+        if (semanticTitle !== undefined) {
+            displayTitle = semanticTitle;
+            usedFallback = rawTitle !== semanticTitle;
+        }
+        else if (readWarningCode || decision !== undefined) {
+            // No qualified semantic text: neutral placeholder instead of a
+            // technical trigger as the Owner-facing title.
             displayTitle = t("principles.readabilityFallbackTitle");
             usedFallback = true;
         }
@@ -227,7 +239,8 @@ export function PrinciplesPage() {
             action: p.action,
             status: toReviewStatus(p.status, ag?.status),
             channels: uniqueChannels,
-            confidence,
+            evaluability: p.evaluability,
+            decisionState: decision?.decisionState,
             updatedAt: p.updatedAt,
             createdAt: p.createdAt,
             priority: p.priority,
@@ -291,7 +304,9 @@ export function PrinciplesPage() {
                                                 STATUS_TEXT[card.status] +
                                                 " border-current/20", children: t("principles.status" + card.status.charAt(0).toUpperCase() + card.status.slice(1)) }), card.channels.map((ch) => (_jsx("span", { className: "font-mono text-[11px] uppercase tracking-[0.02em] border border-line rounded-[2px] px-2 py-0.5 text-ink-3", children: enumLabel('channel', ch, t) }, ch))), card.detectedLanguage && card.detectedLanguage !== 'unknown' && (_jsx("span", { className: "font-mono text-[11px] tracking-[0.02em] border border-line rounded-[2px] px-2 py-0.5 text-ink-4", children: card.detectedLanguage === 'zh'
                                                 ? t("principles.languageHintZh")
-                                                : t("principles.languageHintEn") })), _jsxs("span", { className: "font-mono text-[11px] text-ink-4", children: [t("principles.confidence"), ": ", enumLabel('confidence', card.confidence, t)] })] }), card.readabilityWarningCode && (_jsx("div", { className: "mb-2 px-3 py-1.5 bg-amber/5 border border-amber/20 rounded-[3px] text-ink-3 text-[12px] leading-snug", children: t("principles.readabilityWarning." + card.readabilityWarningCode, { defaultValue: t("principles.readabilityFallbackTitle") }) })), card.detectedLanguage && card.detectedLanguage !== 'unknown' && i18n.language && !i18n.language.startsWith(card.detectedLanguage) && (_jsx("div", { className: "mb-2 px-3 py-1.5 bg-surface/60 border-l-2 border-line rounded-[3px] text-ink-4 text-[12px] leading-snug", children: t("principles.languageMismatchHint", { lang: card.detectedLanguage === 'en' ? 'English' : '中文' }) })), _jsx("h3", { className: "font-semibold text-ink mb-1", children: card.title }), card.titleUsedFallback && card.originalTitle && (_jsxs("details", { className: "mb-1", children: [_jsx("summary", { className: "text-ink-4 text-[11px] font-mono cursor-pointer hover:underline", children: t("principles.readabilityOriginalLabel") }), _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: card.originalTitle })] })), _jsx("p", { className: "text-ink-3 text-[13px] line-clamp-3 leading-relaxed", children: card.text }), _jsxs("p", { className: "font-mono text-[11px] text-ink-4 mt-2", children: [t("principles.updatedAt"), ": ", formatDate(card.updatedAt, i18n.language)] }), _jsx(EvolutionBlock, { label: t("principles.blockBasis"), children: ag?.candidateDescription ?? t("principles.blockBasisFallback") }), _jsx(EvolutionBlock, { label: t("principles.blockImpact"), children: t(BLOCK_IMPACT_KEY[card.status]) }), _jsx(EvolutionBlock, { label: t("principles.blockBehavior"), children: card.action ? card.action : t("principles.blockBehaviorFallback") }), _jsx("div", { className: "mt-3 pt-3 border-t border-line/60", children: _jsxs("div", { className: "flex items-center justify-between gap-3 bg-gov/5 border border-line rounded-[3px] px-3 py-2", children: [_jsxs("div", { className: "flex items-center gap-2 flex-wrap", children: [_jsx("span", { className: "font-mono text-[11px] uppercase tracking-[0.02em] text-ink-4", children: t("principles.govDecision") }), _jsxs("span", { className: "font-mono text-[11px] uppercase tracking-[0.02em] border rounded-[2px] px-2 py-0.5 " +
+                                                : t("principles.languageHintEn") })), _jsxs("span", { className: "font-mono text-[11px] text-ink-4", children: [t("principles.evaluabilityLabel", { defaultValue: "可评价性" }), ": ", enumLabel('evaluability', card.evaluability, t)] }), card.decisionState !== undefined && (_jsx("span", { className: "font-mono text-[11px] tracking-[0.02em] border border-line rounded-[2px] px-2 py-0.5 text-ink-4", children: t(`principles.ownerDecision.state.${card.decisionState}`, { defaultValue: card.decisionState }) }))] }), card.readabilityWarningCode && (_jsx("div", { className: "mb-2 px-3 py-1.5 bg-amber/5 border border-amber/20 rounded-[3px] text-ink-3 text-[12px] leading-snug", children: t("principles.readabilityWarning." + card.readabilityWarningCode, { defaultValue: t("principles.readabilityFallbackTitle") }) })), card.detectedLanguage && card.detectedLanguage !== 'unknown' && i18n.language && !i18n.language.startsWith(card.detectedLanguage) && (_jsx("div", { className: "mb-2 px-3 py-1.5 bg-surface/60 border-l-2 border-line rounded-[3px] text-ink-4 text-[12px] leading-snug", children: t("principles.languageMismatchHint", { lang: card.detectedLanguage === 'en' ? 'English' : '中文' }) })), _jsx("h3", { className: "font-semibold text-ink mb-1", children: card.title }), card.titleUsedFallback && card.originalTitle && (_jsxs("details", { className: "mb-1", children: [_jsx("summary", { className: "text-ink-4 text-[11px] font-mono cursor-pointer hover:underline", children: t("principles.readabilityOriginalLabel") }), _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: card.originalTitle })] })), _jsx("p", { className: "text-ink-3 text-[13px] line-clamp-3 leading-relaxed", children: card.text }), _jsxs("p", { className: "font-mono text-[11px] text-ink-4 mt-2", children: [t("principles.updatedAt"), ": ", formatDate(card.updatedAt, i18n.language)] }), _jsx(EvolutionBlock, { label: t("principles.blockBasis"), children: ag?.candidateDescription ?? t("principles.blockBasisFallback") }), _jsx(EvolutionBlock, { label: t("principles.blockImpact"), children: card.decisionState !== undefined
+                                        ? t("principles.blockImpactSeeDecisionView", { defaultValue: "以详情页「当前实际执行」为准（本卡片不据此判断影响）。" })
+                                        : t(BLOCK_IMPACT_KEY[card.status]) }), _jsx(EvolutionBlock, { label: t("principles.blockBehavior"), children: card.action ? card.action : t("principles.blockBehaviorFallback") }), _jsx("div", { className: "mt-3 pt-3 border-t border-line/60", children: _jsxs("div", { className: "flex items-center justify-between gap-3 bg-gov/5 border border-line rounded-[3px] px-3 py-2", children: [_jsxs("div", { className: "flex items-center gap-2 flex-wrap", children: [_jsx("span", { className: "font-mono text-[11px] uppercase tracking-[0.02em] text-ink-4", children: t("principles.govDecision") }), _jsxs("span", { className: "font-mono text-[11px] uppercase tracking-[0.02em] border rounded-[2px] px-2 py-0.5 " +
                                                             STATUS_TEXT[card.status] +
                                                             " border-current/20", children: [decision.glyph, " ", t(decision.labelKey)] })] }), decisionDate && (_jsx("span", { className: "font-mono text-[11px] text-ink-4 whitespace-nowrap", children: formatDate(decisionDate, i18n.language) }))] }) })] }, card.principleId));
                     })] }))] }));

package/console/dist/ui/utils/enum-labels.d.ts

@@ -19,7 +19,7 @@
  * - Local map keyed by the RAW value (with hyphens) for exact lookup
  */
 type TFunc = (key: string) => string;
-export type EnumCategory = 'evidenceState' | 'sourceKind' | 'channel' | 'readiness' | 'featureCategory' | 'featureId' | 'confidence' | 'feedbackType' | 'admission';
+export type EnumCategory = 'evidenceState' | 'sourceKind' | 'channel' | 'readiness' | 'featureCategory' | 'featureId' | 'confidence' | 'feedbackType' | 'admission' | 'evaluability';
 /**
  * Resolve an enum value to a human-readable label.
  *

package/console/dist/ui/utils/enum-labels.js

@@ -99,6 +99,14 @@ const LOCAL_LABELS = {
         'evidence_only': '仅作证据',
         'owner_confirmation_required': '待确认',
     },
+    // Owner Decision Experience v1 (T10): evaluability is NOT confidence — it
+    // describes how the principle's adherence can be evaluated, and must never
+    // be displayed as a confidence score.
+    evaluability: {
+        'deterministic': '可确定性检查',
+        'weak_heuristic': '弱启发式',
+        'manual_only': '仅人工',
+    },
 };
 // ── Helpers ──────────────────────────────────────────────────────────────────
 /**

package/console/dist/ui/utils/validators.d.ts

@@ -8,11 +8,109 @@
  * - Uses `Object.hasOwn()` for untrusted object keys (Rule 5)
  * - Graceful degradation includes a reason (Rule 9)
  */
-import type { GovernanceExperienceSnapshot, OwnerGovernanceView } from '@principles/core/runtime-v2';
+import type { GovernanceExperienceSnapshot, OwnerGovernanceView, OwnerDecisionViewCore } from '@principles/core/runtime-v2';
+/** Browser-local structural type for the compact inbox response (SPEC §11.1). */
+export interface OwnerDecisionInboxData {
+    schemaVersion: '1';
+    generatedAt: string;
+    totalPrinciples: number;
+    groups: {
+        decision: {
+            principleId: string;
+            decisionState: string;
+            learnedPrinciple: {
+                status: 'known';
+                text: string;
+            } | {
+                status: 'unknown';
+                reasonText: string;
+            };
+            inbox: {
+                group: string;
+                attention: string;
+            };
+            blockerCodes: string[];
+            nextAction: {
+                ownerText: string;
+            };
+        }[];
+        blocked: {
+            principleId: string;
+            decisionState: string;
+            learnedPrinciple: {
+                status: 'known';
+                text: string;
+            } | {
+                status: 'unknown';
+                reasonText: string;
+            };
+            inbox: {
+                group: string;
+                attention: string;
+            };
+            blockerCodes: string[];
+            nextAction: {
+                ownerText: string;
+            };
+        }[];
+        recovery: {
+            principleId: string;
+            decisionState: string;
+            learnedPrinciple: {
+                status: 'known';
+                text: string;
+            } | {
+                status: 'unknown';
+                reasonText: string;
+            };
+            inbox: {
+                group: string;
+                attention: string;
+            };
+            blockerCodes: string[];
+            nextAction: {
+                ownerText: string;
+            };
+        }[];
+    };
+    historicalUnknown: {
+        count: number;
+        reasonText: string;
+    };
+    degraded?: {
+        reason: string;
+        nextAction: string;
+    };
+}
 import type { FeedbackChannelId } from '../../shared/feedback-channel-ids.js';
 import type { FeedbackChannelStatus, FeedbackChannelsData, FeedbackSubmitResult } from '../../shared/feedback-contract.js';
 export type { FeedbackChannelId, FeedbackChannelStatus, FeedbackChannelsData, FeedbackSubmitResult };
 export declare function validateOwnerGovernanceView(value: unknown): OwnerGovernanceView | null;
+export declare function isOwnerDecisionViewCore(value: unknown): value is OwnerDecisionViewCore;
+export declare function validateOwnerDecisionViewCore(value: unknown): OwnerDecisionViewCore | null;
+export declare function isOwnerDecisionInbox(value: unknown): value is OwnerDecisionInboxData;
+export declare function validateOwnerDecisionInbox(value: unknown): OwnerDecisionInboxData | null;
+/** Browser-local structural type for the compact library projection (SPEC §11.2). */
+export interface OwnerDecisionLibraryData {
+    schemaVersion: '1';
+    generatedAt: string;
+    entries: Record<string, {
+        decisionState: string;
+        learnedPrinciple: {
+            status: 'known';
+            text: string;
+            sourceTier: string;
+        } | {
+            status: 'unknown';
+            reasonText: string;
+        };
+    }>;
+    degraded?: {
+        reason: string;
+    };
+}
+export declare function isOwnerDecisionLibrary(value: unknown): value is OwnerDecisionLibraryData;
+export declare function validateOwnerDecisionLibrary(value: unknown): OwnerDecisionLibraryData | null;
 export declare function validateGovernanceExperienceSnapshot(value: unknown): GovernanceExperienceSnapshot | null;
 /**
  * Best-effort error envelope validator.

package/console/dist/ui/utils/validators.js

@@ -130,6 +130,121 @@ function isOwnerGovernanceView(value) {
 export function validateOwnerGovernanceView(value) {
     return isOwnerGovernanceView(value) ? value : null;
 }
+// ── Owner Decision Experience v1 — browser-local structural validator ───────
+//
+// Mirrors the authoritative TypeBox contract in principles-core
+// (owner-decision-view-contract.ts). Type-only import keeps the browser bundle
+// free of the Node-oriented core barrel (same reason as the governance
+// validator above, ERR-100).
+const ownerDecisionStates = new Set(['needs_owner_decision', 'processing', 'blocked', 'recovery_needed', 'decided', 'no_action']);
+const ownerInboxGroups = new Set(['decision', 'blocked', 'recovery', 'none']);
+const ownerInboxAttention = new Set(['individual', 'aggregate', 'none']);
+function isOwnerInboxItem(value) {
+    // Codex review P2 fix: the page dereferences item.inbox.attention,
+    // item.principleId and item.nextAction.ownerText on every entry — a
+    // malformed entry (e.g. `[null]` from a version-skewed server) must be
+    // rejected here instead of crashing the render.
+    if (!isObject(value) || !hasOwnFields(value, ['principleId', 'decisionState', 'learnedPrinciple', 'inbox', 'blockerCodes', 'nextAction']))
+        return false;
+    if (!isString(value.principleId) || value.principleId.length === 0)
+        return false;
+    if (!isString(value.decisionState) || !ownerDecisionStates.has(value.decisionState))
+        return false;
+    const principle = value.learnedPrinciple;
+    if (!isObject(principle))
+        return false;
+    if (principle.status === 'known') {
+        if (!hasOwnFields(principle, ['text', 'sourceTier'])
+            || !isString(principle.text) || principle.text.length === 0
+            || !isString(principle.sourceTier))
+            return false;
+    }
+    else if (principle.status === 'unknown') {
+        if (!hasOwnFields(principle, ['reasonText']) || !isString(principle.reasonText))
+            return false;
+    }
+    else
+        return false;
+    if (!isObject(value.inbox) || !hasOwnFields(value.inbox, ['group', 'attention'])
+        || !isStringEnum(value.inbox.group, ownerInboxGroups)
+        || !isStringEnum(value.inbox.attention, ownerInboxAttention))
+        return false;
+    if (!Array.isArray(value.blockerCodes) || !value.blockerCodes.every(isString))
+        return false;
+    return isObject(value.nextAction) && hasOwnFields(value.nextAction, ['ownerText'])
+        && isString(value.nextAction.ownerText);
+}
+function isOwnerReason(value) {
+    return isObject(value) && hasOwnFields(value, ['code', 'ownerText', 'sourceRefs'])
+        && isString(value.code) && value.code.length > 0
+        && isString(value.ownerText) && value.ownerText.length > 0
+        && Array.isArray(value.sourceRefs);
+}
+function isOwnerAction(value) {
+    return isObject(value) && hasOwnFields(value, ['key', 'semantic', 'label', 'channel', 'confirmation', 'expectedConsequence'])
+        && isString(value.key) && value.key.length > 0
+        && isString(value.semantic) && value.semantic.length > 0
+        && isString(value.label)
+        && isObject(value.confirmation) && typeof value.confirmation.required === 'boolean' && isString(value.confirmation.text);
+}
+export function isOwnerDecisionViewCore(value) {
+    if (!isObject(value) || !hasOwnFields(value, ['schemaVersion', 'principleId', 'asOf', 'sourceReadStatus', 'sourceReads',
+        'incidentSummary', 'learnedPrinciple', 'rationale', 'applicability', 'nonApplicabilityOrUnknown', 'expectedBehavior',
+        'currentEnforcement', 'evidenceSummary', 'uncertainty', 'risk', 'rollback', 'decisionState', 'decisionSubjects',
+        'availableActions', 'blockers', 'nextAction', 'inbox', 'technicalDetails']))
+        return false;
+    if (value.schemaVersion !== '1' || !isString(value.principleId) || !isString(value.asOf))
+        return false;
+    if (value.sourceReadStatus !== 'complete' && value.sourceReadStatus !== 'partial')
+        return false;
+    if (!isStringEnum(value.decisionState, ownerDecisionStates))
+        return false;
+    if (!Array.isArray(value.availableActions) || !value.availableActions.every(isOwnerAction))
+        return false;
+    if (!Array.isArray(value.blockers) || !value.blockers.every(item => isObject(item) && hasOwnFields(item, ['subjectKey', 'kind', 'reason']) && isOwnerReason(item.reason)))
+        return false;
+    return isObject(value.nextAction) && hasOwnFields(value.nextAction, ['code', 'ownerText'])
+        && isString(value.nextAction.ownerText)
+        && isObject(value.inbox) && hasOwnFields(value.inbox, ['group', 'attention', 'reason']) && isOwnerReason(value.inbox.reason);
+}
+export function validateOwnerDecisionViewCore(value) {
+    return isOwnerDecisionViewCore(value) ? value : null;
+}
+export function isOwnerDecisionInbox(value) {
+    return isObject(value)
+        && hasOwnFields(value, ['schemaVersion', 'generatedAt', 'totalPrinciples', 'groups', 'historicalUnknown'])
+        && value.schemaVersion === '1'
+        && isString(value.generatedAt)
+        && typeof value.totalPrinciples === 'number'
+        && isObject(value.groups) && hasOwnFields(value.groups, ['decision', 'blocked', 'recovery'])
+        && ['decision', 'blocked', 'recovery'].every((key) => {
+            const group = value.groups[key];
+            return Array.isArray(group) && group.every(isOwnerInboxItem);
+        })
+        && isObject(value.historicalUnknown) && typeof (value.historicalUnknown).count === 'number';
+}
+export function validateOwnerDecisionInbox(value) {
+    return isOwnerDecisionInbox(value) ? value : null;
+}
+function isOwnerDecisionLibraryEntry(value) {
+    return isObject(value) && hasOwnFields(value, ['decisionState', 'learnedPrinciple'])
+        && isString(value.decisionState)
+        && isObject(value.learnedPrinciple)
+        && (value.learnedPrinciple.status === 'known'
+            ? isString(value.learnedPrinciple.text) && isString(value.learnedPrinciple.sourceTier)
+            : value.learnedPrinciple.status === 'unknown' && isString(value.learnedPrinciple.reasonText));
+}
+export function isOwnerDecisionLibrary(value) {
+    return isObject(value)
+        && hasOwnFields(value, ['schemaVersion', 'generatedAt', 'entries'])
+        && value.schemaVersion === '1'
+        && isString(value.generatedAt)
+        && isObject(value.entries)
+        && Object.values(value.entries).every(isOwnerDecisionLibraryEntry);
+}
+export function validateOwnerDecisionLibrary(value) {
+    return isOwnerDecisionLibrary(value) ? value : null;
+}
 // ── PRI-586: Governance Experience Snapshot v1.5.1 (browser-local validator) ──
 // Mirrors the authoritative TypeBox contract in principles-core
 // (governance-experience-contract.ts). Type-only import above keeps the client

package/console/dist/web/assets/app.css

@@ -1890,6 +1890,9 @@
   .text-\[12px\] {
     font-size: 12px;
   }
+  .text-\[13\.5px\] {
+    font-size: 13.5px;
+  }
   .text-\[13px\] {
     font-size: 13px;
   }