create-principles-disciple 1.100.0 → 1.102.0

package/console/dist/ui/App.js

@@ -8,7 +8,7 @@ import { AppSidebar } from "./components/layout/app-sidebar.js";
 import { SplashScreen } from "./components/auth/splash-screen.js";
 import { LoginForm } from "./components/auth/login-form.js";
 import { ErrorBoundary } from "./components/error-boundary.js";
-import { checkAuth } from "./api.js";
+import { checkAuth, fetchConfigSummary, fetchWorkspaces } from "./api.js";
 import { NotificationProvider } from "./components/notifications/NotificationProvider.js";
 import { Toaster } from "./components/ui/sonner.js";
 // New page imports (CR2 directory structure)
@@ -19,17 +19,27 @@ import { PrincipleDetailPage } from "./pages/principles/PrincipleDetailPage.js";
 import { ActivationPage } from "./pages/activation/ActivationPage.js";
 import { DebtPage } from "./pages/debt/DebtPage.js";
 import { ControlCenterPage } from "./pages/control-center/ControlCenterPage.js";
+import { SignalKeywordsPage } from "./pages/signal-keywords/SignalKeywordsPage.js";
 import { SettingsPage } from "./pages/settings/SettingsPage.js";
 import { UpdatePage } from "./pages/settings/UpdatePage.js";
 import { ReportProblemPage } from "./pages/report-problem/ReportProblemPage.js";
 import { IntentPage } from "./pages/intent/IntentPage.js";
 import { DesignSystemPage } from "./pages/design-system/DesignSystemPage.js";
+import { WelcomePage } from "./pages/welcome/WelcomePage.js";
+import { getOnboardingState } from "./utils/onboarding-state.js";
 // Vite replaces import.meta.env.DEV with a boolean literal at build time.
 // The cast avoids TS2339 without needing a generated .d.ts file.
 const IS_DEV = import.meta.env.DEV;
 function AuthRoutes() {
     const [authed, setAuthed] = useState(null);
     const [showSplash, setShowSplash] = useState(true);
+    // Onboarding redirect needs workspaceId (for onboarding-state lookup) and
+    // feature flags (to gate the redirect). Both are fetched after auth.
+    const [currentWorkspaceId, setCurrentWorkspaceId] = useState("default");
+    const [featureFlags, setFeatureFlags] = useState(null);
+    // P2-C: tracks whether workspace fetch succeeded. If it failed, we skip
+    // the onboarding redirect so state isn't saved under a fake "default" key.
+    const [workspaceReady, setWorkspaceReady] = useState(false);
     const navigate = useNavigate();
     const verifyAuth = useCallback(async () => {
         const valid = await checkAuth();
@@ -47,27 +57,76 @@ function AuthRoutes() {
         // SplashScreen has its own 2200ms timer; we wait for it to call onComplete
         // This effect only handles the case where auth resolves after splash is done
     }, [authed, showSplash, navigate]);
+    // Fetch workspace list + feature flags after auth for onboarding redirect.
+    // P2-5: use Promise.all so both states update together — prevents the
+    // redirect effect from firing with the wrong workspaceId (race condition).
+    // rc-9: on fetch failure, set featureFlags to {} so the redirect effect
+    // fires (defaults to /focus — safe, no onboarding forced).
     useEffect(() => {
-        if (authed === true) {
-            const currentPath = window.location.hash;
-            if (currentPath === "#/login" || currentPath === "#/splash" || currentPath === "#/") {
-                navigate("/focus", { replace: true });
+        if (authed !== true)
+            return;
+        Promise.all([
+            fetchWorkspaces().catch(() => null),
+            fetchConfigSummary().catch(() => null),
+        ]).then(([wsResult, cfgResult]) => {
+            // Update workspaceId first (if we have a real workspace)
+            if (wsResult &&
+                wsResult.success &&
+                Array.isArray(wsResult.data) &&
+                wsResult.data.length > 0) {
+                const firstWorkspace = wsResult.data[0];
+                if (firstWorkspace) {
+                    setCurrentWorkspaceId(firstWorkspace.name);
+                    // P2-C: only mark workspaceReady when we have a real workspace name.
+                    setWorkspaceReady(true);
+                }
+            }
+            // Then update featureFlags — the redirect effect waits for this.
+            // rc-9: on any failure, default to {} so redirect fires to /focus.
+            const flags = {};
+            if (cfgResult &&
+                cfgResult.success &&
+                cfgResult.data) {
+                const summary = cfgResult.data;
+                for (const f of summary.features) {
+                    flags[f.id] = { enabled: f.enabled };
+                }
             }
+            setFeatureFlags(flags);
+        });
+    }, [authed]);
+    // P1-4: After splash finishes, if user is not authenticated, go to login.
+    // (The authed === true case is handled by the redirect effect below.)
+    useEffect(() => {
+        if (showSplash || authed !== false)
+            return;
+        navigate('/login', { replace: true });
+    }, [showSplash, authed, navigate]);
+    // First-visit redirect: check new_user_onboarding flag + onboarding state.
+    // P1-4: Only redirect AFTER splash is done AND featureFlags are loaded.
+    // This prevents the race where splash navigates to /focus before flags
+    // load, which would bypass the onboarding redirect entirely.
+    useEffect(() => {
+        if (authed !== true || featureFlags === null || showSplash)
+            return;
+        const flagEnabled = featureFlags?.new_user_onboarding?.enabled === true;
+        // P2-C: if workspace fetch failed, don't force onboarding under "default" key.
+        if (flagEnabled && workspaceReady) {
+            const onboardingState = getOnboardingState(currentWorkspaceId);
+            navigate(onboardingState.completed ? '/focus' : '/welcome', { replace: true });
         }
-    }, [authed, navigate]);
+        else {
+            navigate('/focus', { replace: true });
+        }
+    }, [authed, featureFlags, showSplash, currentWorkspaceId, workspaceReady, navigate]);
     const handleAuthSuccess = useCallback(() => {
         setAuthed(true);
-        navigate("/focus", { replace: true });
-    }, [navigate]);
+        // Post-auth redirect is handled by the authed + featureFlags effect above,
+        // which fires once feature flags have loaded.
+    }, []);
     return (_jsxs(Routes, { children: [_jsx(Route, { path: "/splash", element: _jsx(SplashScreen, { onComplete: () => {
                         setShowSplash(false);
-                        if (authed) {
-                            navigate("/focus", { replace: true });
-                        }
-                        else {
-                            navigate("/login", { replace: true });
-                        }
-                    } }) }), _jsx(Route, { path: "/login", element: _jsx(LoginForm, { onAuthSuccess: handleAuthSuccess }) }), _jsx(Route, { path: "/*", element: authed === null ? (_jsx("div", { className: "min-h-screen bg-paper flex items-center justify-center", children: _jsxs("div", { className: "flex flex-col items-center gap-4", children: [_jsx("div", { className: "w-8 h-8 border-2 border-gov border-t-transparent rounded-full animate-spin" }), _jsx("span", { className: "text-[12px] font-mono tracking-wider text-ink-3 uppercase", children: "Verifying Session..." })] }) })) : authed ? (_jsx(NotificationProvider, { children: _jsxs("div", { className: "min-h-screen bg-paper text-ink", children: [_jsx("a", { href: "#main-content", className: "sr-only focus:not-sr-only focus:absolute focus:z-50 focus:p-4 focus:bg-paper focus:text-ink", children: "Skip to main content" }), _jsx(AppSidebar, {}), _jsx("main", { id: "main-content", className: "ml-[256px] min-h-screen overflow-y-auto", children: _jsx(ErrorBoundary, { children: _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(Navigate, { to: "/focus", replace: true }) }), _jsx(Route, { path: "/focus", element: _jsx(FocusPage, {}) }), _jsx(Route, { path: "/pain", element: _jsx(PainPage, {}) }), _jsx(Route, { path: "/principles", element: _jsx(PrinciplesPage, {}) }), _jsx(Route, { path: "/principles/:id", element: _jsx(PrincipleDetailPage, {}) }), _jsx(Route, { path: "/activation", element: _jsx(ActivationPage, {}) }), _jsx(Route, { path: "/debt", element: _jsx(DebtPage, {}) }), _jsx(Route, { path: "/control-center", element: _jsx(ControlCenterPage, {}) }), _jsx(Route, { path: "/settings", element: _jsx(SettingsPage, {}) }), _jsx(Route, { path: "/update", element: _jsx(UpdatePage, {}) }), _jsx(Route, { path: "/report-problem", element: _jsx(ReportProblemPage, {}) }), _jsx(Route, { path: "/intent", element: _jsx(IntentPage, {}) }), IS_DEV && (_jsx(Route, { path: "/design-system", element: _jsx(DesignSystemPage, {}) })), !IS_DEV && (_jsx(Route, { path: "/design-system", element: _jsx(Navigate, { to: "/focus", replace: true }) }))] }) }) })] }) })) : (_jsx(Navigate, { to: "/login", replace: true })) })] }));
+                    } }) }), _jsx(Route, { path: "/login", element: _jsx(LoginForm, { onAuthSuccess: handleAuthSuccess }) }), _jsx(Route, { path: "/*", element: authed === null ? (_jsx("div", { className: "min-h-screen bg-paper flex items-center justify-center", children: _jsxs("div", { className: "flex flex-col items-center gap-4", children: [_jsx("div", { className: "w-8 h-8 border-2 border-gov border-t-transparent rounded-full animate-spin" }), _jsx("span", { className: "text-[12px] font-mono tracking-wider text-ink-3 uppercase", children: "Verifying Session..." })] }) })) : authed ? (_jsx(NotificationProvider, { children: _jsxs("div", { className: "min-h-screen bg-paper text-ink", children: [_jsx("a", { href: "#main-content", className: "sr-only focus:not-sr-only focus:absolute focus:z-50 focus:p-4 focus:bg-paper focus:text-ink", children: "Skip to main content" }), _jsx(AppSidebar, {}), _jsx("main", { id: "main-content", className: "ml-[256px] min-h-screen overflow-y-auto", children: _jsx(ErrorBoundary, { children: _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(Navigate, { to: "/focus", replace: true }) }), _jsx(Route, { path: "/welcome", element: _jsx(WelcomePage, { workspaceId: currentWorkspaceId }) }), _jsx(Route, { path: "/focus", element: _jsx(FocusPage, {}) }), _jsx(Route, { path: "/pain", element: _jsx(PainPage, {}) }), _jsx(Route, { path: "/principles", element: _jsx(PrinciplesPage, {}) }), _jsx(Route, { path: "/principles/:id", element: _jsx(PrincipleDetailPage, {}) }), _jsx(Route, { path: "/activation", element: _jsx(ActivationPage, {}) }), _jsx(Route, { path: "/debt", element: _jsx(DebtPage, {}) }), _jsx(Route, { path: "/control-center", element: _jsx(ControlCenterPage, {}) }), _jsx(Route, { path: "/control-center/signal-keywords", element: _jsx(SignalKeywordsPage, {}) }), _jsx(Route, { path: "/settings", element: _jsx(SettingsPage, {}) }), _jsx(Route, { path: "/update", element: _jsx(UpdatePage, {}) }), _jsx(Route, { path: "/report-problem", element: _jsx(ReportProblemPage, {}) }), _jsx(Route, { path: "/intent", element: _jsx(IntentPage, {}) }), IS_DEV && (_jsx(Route, { path: "/design-system", element: _jsx(DesignSystemPage, {}) })), !IS_DEV && (_jsx(Route, { path: "/design-system", element: _jsx(Navigate, { to: "/focus", replace: true }) }))] }) }) })] }) })) : (_jsx(Navigate, { to: "/login", replace: true })) })] }));
 }
 export function App() {
     return (_jsx(ThemeProvider, { children: _jsxs(I18nextProvider, { i18n: i18n, children: [_jsx(HashRouter, { children: _jsx(AuthRoutes, {}) }), _jsx(Toaster, {})] }) }));

package/console/dist/ui/api.d.ts

@@ -1,8 +1,23 @@
 import type { ApiResponse } from "../types.js";
+import { listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm } from "./utils/signal-keywords-api.js";
 import type { FeedbackReportData, FeedbackDraftSummaryData, FeedbackDraftEnvelopeData, DeleteEnvelopeData, WorkspaceEntryData, RemovedEnvelopeData, SyncResultData, ConfigSummaryData, ConfigCatalogData, AgentBindingUpdateData, DefaultRuntimeUpdateData, FeatureFlagUpdateData, OutputLanguageData, GovernanceQueueData, ActivationsData, DisableActivationData, LifecycleMetricsData, UpdateStatusData, UpdateHistoryData, ApplyUpdateResultData, RollbackResultData, ApprovalRecordData, PrinciplesListData, ApprovalsGroupedData, EvidenceChainData, TrajectoryData, IntentSummaryData, IntentDecisionRecordData, IntentDecisionResultData, IntentDecisionSummaryData, FollowUpResponseData, IntentInitResultData, IntentSaveResultData, IntentRawContentData, IntentVersionData } from "./utils/validators.js";
 declare function getToken(): string | null;
 declare function setToken(token: string): void;
 declare function clearToken(): void;
+/**
+ * Send an authenticated request to the Console API.
+ *
+ * Two overloads:
+ * 1. request(path, options?) → ApiResponse<unknown>
+ *    For endpoints without a runtime validator (health checks, etc.).
+ *    The caller receives unvalidated data and must not assume a specific shape.
+ *
+ * 2. request<T>(path, options, validate) → ApiResponse<T>
+ *    For endpoints with a runtime validator. The validator is applied to the
+ *    raw response; if validation fails, returns an error envelope instead.
+ */
+declare function request(path: string, options?: RequestInit): Promise<ApiResponse<unknown>>;
+declare function request<T>(path: string, options: RequestInit | undefined, validate: (value: unknown) => T | null): Promise<ApiResponse<T>>;
 declare function checkAuth(): Promise<boolean>;
 declare function fetchWorkspaces(): Promise<ApiResponse<WorkspaceEntryData[]>>;
 declare function addWorkspace(name: string, path: string): Promise<ApiResponse<WorkspaceEntryData>>;
@@ -91,8 +106,9 @@ export interface FollowUpPayload {
     candidateId?: string;
 }
 declare function dispatchFollowUp(decisionId: string, payload: FollowUpPayload): Promise<ApiResponse<FollowUpResponseData>>;
-export { getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchPrincipleDetail, fetchPrincipleTrajectory, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };
+export { request, listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm, getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchPrincipleDetail, fetchPrincipleTrajectory, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };
 export type { FeedbackReportData, FeedbackDraftSummaryData, FeedbackDraftEnvelopeData, DeleteEnvelopeData, WorkspaceEntryData, RemovedEnvelopeData, SyncResultData, ConfigSummaryData, ConfigCatalogData, AgentBindingUpdateData, DefaultRuntimeUpdateData, FeatureFlagUpdateData, OutputLanguageData, GovernanceQueueData, ActivationsData, DisableActivationData, LifecycleMetricsData, UpdateStatusData, UpdateHistoryData, ApplyUpdateResultData, RollbackResultData, ApprovalRecordData, PrinciplesListData, ApprovalsGroupedData, EvidenceChainData, EvidenceChainRecordData, EvidenceChainStateData, TrajectoryData, TrajectoryStageData, IntentSummaryData, IntentSectionsData, IntentDocWarningData, IntentDecisionRecordData, IntentDecisionResultData, IntentDecisionSummaryData, FollowUpResponseData, LinkCandidateFollowUpData, GuideRulehostFollowUpData, GeneratePatchProposalFollowUpData, IntentVersionEntry, IntentVersionData, } from "./utils/validators.js";
+export type { SignalKeyword, PendingSignalTerm } from "./utils/signal-keywords-types.js";
 export type { ActivationRecordData as ActivationRecord } from "./utils/validators.js";
 export type { ApprovalRecordData as ApprovalRecord } from "./utils/validators.js";
 export type { WorkspaceEntryData as WorkspaceEntry } from "./utils/validators.js";

package/console/dist/ui/api.js

@@ -1,3 +1,4 @@
+import { listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm, } from "./utils/signal-keywords-api.js";
 import { validateErrorResponse, validateHeaders, validateFeedbackReport, validateFeedbackDraftsList, validateFeedbackDraftEnvelope, validateDeleteEnvelope, validateWorkspaceEntry, validateWorkspaceList, validateRemovedEnvelope, validateSyncResult, validateConfigSummary, validateConfigCatalog, validateAgentBindingUpdate, validateDefaultRuntimeUpdate, validateFeatureFlagUpdate, validateOutputLanguage, validateGovernanceQueue, validateActivations, validateDisableActivation, validateLifecycleMetrics, validateUpdateStatus, validateUpdateHistory, validateApplyUpdateResult, validateRollbackResult, validateApprovalRecordDirect, validatePrinciplesList, validateApprovalsGrouped, validateEvidenceChain, validateTrajectoryData, validateIntentSummary, validateIntentDecisionList, validateIntentDecisionResult, validateIntentDecisionSummary, validateFollowUpResponse, validateIntentInitResult, validateIntentSaveResult, validateIntentRawContent, validateIntentVersions, } from "./utils/validators.js";
 // ── Auth ──────────────────────────────────────────────────────────────────────
 function getToken() {
@@ -308,4 +309,8 @@ async function dispatchFollowUp(decisionId, payload) {
     }, validateFollowUpResponse);
 }
 // ── Exports ───────────────────────────────────────────────────────────────────
-export { getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchPrincipleDetail, fetchPrincipleTrajectory, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };
+export { request, 
+// signal-keywords (UI stubs, see signal-keywords-api.ts)
+listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm, 
+// auth
+getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchPrincipleDetail, fetchPrincipleTrajectory, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };

package/console/dist/ui/components/onboarding/CircuitDiagram.d.ts

@@ -0,0 +1,8 @@
+interface CircuitDiagramProps {
+    /** Highlight a specific node (evidence/principle/ownerGate/behavior) */
+    highlightNode?: 'evidence' | 'principle' | 'ownerGate' | 'behavior' | null;
+    /** Compact mode for smaller spaces */
+    compact?: boolean;
+}
+export declare function CircuitDiagram({ highlightNode, compact }: CircuitDiagramProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/console/dist/ui/components/onboarding/CircuitDiagram.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useTranslation } from 'react-i18next';
+const NODES = [
+    { id: 'evidence', labelKey: 'pages.welcome.step1.circuitNodes.evidence', cx: 80, cy: 80 },
+    { id: 'principle', labelKey: 'pages.welcome.step1.circuitNodes.principle', cx: 240, cy: 80 },
+    { id: 'ownerGate', labelKey: 'pages.welcome.step1.circuitNodes.ownerGate', cx: 240, cy: 180 },
+    { id: 'behavior', labelKey: 'pages.welcome.step1.circuitNodes.behavior', cx: 80, cy: 180 },
+];
+export function CircuitDiagram({ highlightNode = null, compact = false }) {
+    const { t } = useTranslation();
+    const size = compact ? 240 : 320;
+    const nodeRadius = compact ? 28 : 36;
+    return (_jsx("div", { className: "circuit-diagram", role: "img", "aria-label": t('pages.welcome.step1.circuitLabel'), children: _jsxs("svg", { width: size, height: size * 0.75, viewBox: "0 0 320 240", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: [_jsx("line", { x1: NODES[0].cx, y1: NODES[0].cy, x2: NODES[1].cx, y2: NODES[1].cy, stroke: "var(--color-gov)", strokeWidth: "1.5" }), _jsx("line", { x1: NODES[1].cx, y1: NODES[1].cy, x2: NODES[2].cx, y2: NODES[2].cy, stroke: "var(--color-gov)", strokeWidth: "1.5" }), _jsx("line", { x1: NODES[2].cx, y1: NODES[2].cy, x2: NODES[3].cx, y2: NODES[3].cy, stroke: "var(--color-gov)", strokeWidth: "1.5" }), _jsx("line", { x1: NODES[3].cx, y1: NODES[3].cy, x2: NODES[0].cx, y2: NODES[0].cy, stroke: "var(--color-gov)", strokeWidth: "1.5" }), _jsx("polygon", { points: `${NODES[1].cx - 8},${NODES[1].cy - 4} ${NODES[1].cx - 8},${NODES[1].cy + 4} ${NODES[1].cx},${NODES[1].cy}`, fill: "var(--color-gov)" }), _jsx("polygon", { points: `${NODES[2].cx + 4},${NODES[2].cy - 8} ${NODES[2].cx - 4},${NODES[2].cy - 8} ${NODES[2].cx},${NODES[2].cy}`, fill: "var(--color-gov)" }), _jsx("polygon", { points: `${NODES[3].cx + 8},${NODES[3].cy - 4} ${NODES[3].cx + 8},${NODES[3].cy + 4} ${NODES[3].cx},${NODES[3].cy}`, fill: "var(--color-gov)" }), _jsx("polygon", { points: `${NODES[0].cx - 4},${NODES[0].cy + 8} ${NODES[0].cx + 4},${NODES[0].cy + 8} ${NODES[0].cx},${NODES[0].cy}`, fill: "var(--color-gov)" }), NODES.map((node) => {
+                    const isHighlighted = highlightNode === node.id;
+                    const isOwnerGate = node.id === 'ownerGate';
+                    return (_jsxs("g", { children: [_jsx("circle", { cx: node.cx, cy: node.cy, r: nodeRadius, fill: isHighlighted ? 'var(--color-gov)' : 'var(--color-surface)', stroke: isOwnerGate ? 'var(--color-gov)' : 'var(--color-border)', strokeWidth: isOwnerGate ? 2.5 : 1.5 }), _jsx("text", { x: node.cx, y: node.cy, textAnchor: "middle", dominantBaseline: "middle", fontSize: compact ? 9 : 11, fill: isHighlighted ? 'white' : 'var(--color-ink)', fontFamily: "var(--font-sans)", children: t(node.labelKey) })] }, node.id));
+                })] }) }));
+}

package/console/dist/ui/components/onboarding/DemoResultView.d.ts

@@ -0,0 +1,22 @@
+export interface DemoStage {
+    name: string;
+    status: 'passed' | 'failed' | 'degraded' | 'skipped';
+    reason?: string;
+    nextAction?: string;
+    evidenceRef?: string;
+}
+export interface DemoResultData {
+    status: string;
+    generatedAt?: string;
+    narrative?: string;
+    storyDescription?: string;
+    stages?: DemoStage[];
+    simulated?: boolean;
+}
+interface DemoResultViewProps {
+    result: DemoResultData | null;
+    loading: boolean;
+    error: string | null;
+}
+export declare function DemoResultView({ result, loading, error }: DemoResultViewProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/console/dist/ui/components/onboarding/DemoResultView.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useTranslation } from 'react-i18next';
+export function DemoResultView({ result, loading, error }) {
+    const { t } = useTranslation();
+    if (loading) {
+        return (_jsx("div", { className: "demo-result-view demo-loading", role: "status", "aria-live": "polite", children: _jsx("span", { className: "demo-status-text", children: t('pages.welcome.step2.demoRunning') }) }));
+    }
+    if (error) {
+        return (_jsxs("div", { className: "demo-result-view demo-error", role: "alert", children: [_jsx("span", { className: "demo-status-text", children: t('pages.welcome.step2.demoFailed') }), _jsx("p", { className: "demo-error-detail", children: error })] }));
+    }
+    if (!result) {
+        return null;
+    }
+    return (_jsxs("div", { className: "demo-result-view", role: "region", "aria-label": t('pages.welcome.step2.demoComplete'), children: [result.simulated && (_jsx("div", { className: "demo-simulated-banner", role: "note", children: t('pages.welcome.step2.demoSimulatedNote') })), result.stages && result.stages.length > 0 && (_jsx("ol", { className: "demo-stages", children: result.stages.map((stage, idx) => (_jsxs("li", { className: `demo-stage demo-stage-${stage.status}`, children: [_jsx("span", { className: "demo-stage-name", children: stage.name }), stage.reason && _jsx("span", { className: "demo-stage-detail", children: stage.reason })] }, idx))) })), _jsxs("div", { className: "demo-labels", children: [_jsx("div", { className: "demo-label-item", children: _jsx("span", { className: "demo-label-title", children: t('pages.welcome.step2.evidenceLabel') }) }), _jsx("div", { className: "demo-label-item", children: _jsx("span", { className: "demo-label-title", children: t('pages.welcome.step2.candidateLabel') }) }), _jsx("div", { className: "demo-label-item", children: _jsx("span", { className: "demo-label-title", children: t('pages.welcome.step2.ownerGateLabel') }) }), _jsx("div", { className: "demo-label-item", children: _jsx("span", { className: "demo-label-title", children: t('pages.welcome.step2.activationLabel') }) }), _jsx("div", { className: "demo-label-item", children: _jsx("span", { className: "demo-label-title", children: t('pages.welcome.step2.rollbackLabel') }) })] })] }));
+}

package/console/dist/ui/i18n/en.json

@@ -700,6 +700,61 @@
             "unknownAgentsWarning": "Detected {{count}} unrecognized agent(s): {{names}}. They are not shown in groups.",
             "footerNote": "9 agents are distributed across the internalization pipeline and sidechain services. The Core Trio must be enabled together — otherwise PD cannot turn errors into principles."
         },
+        "signalKeywords": {
+            "title": "Signal Keywords",
+            "subtitle": "Manage signal keywords for agents — when the signal collector detects these keywords, it triggers deep analysis.",
+            "empty": "No signal keywords yet",
+            "loadError": "Failed to load signal keywords",
+            "saveError": "Failed to save",
+            "saving": "Saving…",
+            "searchPlaceholder": "Search keywords…",
+            "filterAll": "All",
+            "filterActive": "Active",
+            "filterArchived": "Archived",
+            "active": "Active",
+            "archived": "Archived",
+            "confirmDeleteTitle": "Confirm delete keyword",
+            "confirmDeleteMessage": "Are you sure you want to delete \"{{term}}\"? This action cannot be undone.",
+            "confirmDeleteAck": "Confirm delete",
+            "confirmDeleteCancel": "Cancel",
+            "deleteSuccess": "Deleted",
+            "archiveSuccess": "Archived",
+            "unarchiveSuccess": "Restored",
+            "phase2Tooltip": "This feature will be enabled in a future version",
+            "colTerm": "Term",
+            "colCategory": "Category",
+            "colPrecision": "Precision",
+            "colWeight": "Weight",
+            "colReason": "Reason",
+            "colActions": "Actions",
+            "categoryCorrection": "Correction",
+            "categoryEmpathy": "Empathy",
+            "precisionHigh": "High",
+            "precisionAmbiguous": "Ambiguous",
+            "nTerms": "{{count}} terms",
+            "selectedNOfTotal": "Selected {{selected}} of {{total}}",
+            "nTermsPendingReview": "{{count}} terms pending review",
+            "weightLabel": "Weight: {{percent}}%",
+            "addKeyword": "Add Keyword",
+            "addKeywordDialogTitle": "Add Signal Keyword",
+            "submitAdd": "Add",
+            "noSearchResults": "No matching keywords",
+            "pendingTerms": {
+                "title": "Pending Signal Terms",
+                "subtitle": "The signal collector suggests the following terms as potential keywords from unmatched messages. Review and confirm or ignore.",
+                "empty": "No pending signal terms",
+                "emptyDescription": "When the empathy observer detects recurring unmatched patterns, it will suggest new signal terms here.",
+                "confirm": "Confirm add",
+                "ignore": "Ignore",
+                "confirmBatch": "Confirm all",
+                "ignoreBatch": "Ignore all",
+                "sourceCount": "From {{count}} messages",
+                "confirmSuccess": "Confirmed",
+                "ignoreSuccess": "Ignored",
+                "batchConfirmSuccess": "Confirmed {{count}} terms",
+                "batchIgnoreSuccess": "Ignored {{count}} terms"
+            }
+        },
         "login": {
             "title": "Login",
             "description": "Login to PD Governance Workspace",
@@ -942,6 +997,61 @@
             "demoteTooltip": "Demote endpoint under development",
             "principleAriaLabel": "Debt Principle {{id}}",
             "listAriaLabel": "Debt principles list"
+        },
+        "welcome": {
+            "title": "Welcome to Principles Disciple",
+            "subtitle": "Turn your repeated corrections into reviewed, reversible principles.",
+            "stateSaveError": "Couldn't save onboarding progress. Check browser storage permissions and retry.",
+            "stepIndicator": "Step {{current}} of {{total}}",
+            "step1": {
+                "title": "What is PD?",
+                "description": "An owner-governed behavior internalization system. PD turns behavioral evidence into reviewed, reversible principles that shape future agent behavior.",
+                "circuitLabel": "Core governance loop",
+                "circuitNodes": {
+                    "evidence": "Evidence",
+                    "principle": "Principle",
+                    "ownerGate": "Owner Gate",
+                    "behavior": "Behavior Change"
+                },
+                "startButton": "Start",
+                "skipButton": "Skip onboarding"
+            },
+            "step2": {
+                "title": "See the full governance loop in action",
+                "description": "This is a controlled demo using simulated evidence. In real use, your agent produces evidence through the pd-pain-signal skill.",
+                "runDemoButton": "Run demo",
+                "demoRunning": "Running demo...",
+                "demoComplete": "Demo complete",
+                "demoFailed": "Demo failed",
+                "demoSimulatedNote": "This evidence is simulated for demo purposes.",
+                "nextButton": "Next",
+                "evidenceLabel": "Evidence (simulated)",
+                "candidateLabel": "Candidate Principle",
+                "ownerGateLabel": "Owner Gate: Review and approve",
+                "activationLabel": "Activation Result",
+                "rollbackLabel": "Rollback path available"
+            },
+            "step3": {
+                "title": "Ready to record real evidence",
+                "description": "When your agent makes a mistake or you repeatedly correct it, tell the agent: 'Use pd-pain-signal to record this.'",
+                "examplePrompt": "Example prompt to agent:",
+                "examplePromptText": "I just corrected you on X. Use pd-pain-signal to record this as a pain signal.",
+                "tryNowButton": "Try it now (2-hour window)",
+                "goToFocusButton": "Got it, go to Focus",
+                "skipButton": "Skip for now",
+                "windowHint": "We'll check back in 2 hours. No pressure — you can always record evidence later.",
+                "pollingActive": "Listening for evidence... We'll check every 30 seconds for 2 hours.",
+                "stopPollingButton": "Stop and continue",
+                "evidenceFound": "Evidence detected! You can now review it in the Focus page.",
+                "timeoutHint": "No evidence detected in 2 hours. That's okay — you can record evidence anytime with pd-pain-signal.",
+                "pollingError": "Couldn't check for evidence. The evidence service may be unavailable.",
+                "retryButton": "Retry"
+            },
+            "progress": {
+                "step1": "Welcome",
+                "step2": "Demo",
+                "step3": "Invite"
+            }
         }
     },
     "components": {
@@ -1050,6 +1160,23 @@
             "tooShort": "Reason must be at least 10 characters",
             "cancel": "Cancel",
             "submit": "Confirm Rejection"
+        },
+        "onboardingReset": {
+            "title": "Onboarding",
+            "resetButton": "Reset onboarding state",
+            "resetConfirm": "This will restart the onboarding wizard on next login. Continue?",
+            "resetSuccess": "Onboarding state reset. You'll see the welcome page on next visit.",
+            "resetFailed": "Couldn't reset onboarding. Check browser storage permissions and retry."
+        },
+        "onboardingFlag": {
+            "title": "Onboarding Feature",
+            "label": "New user onboarding wizard",
+            "description": "Show the welcome wizard on first visit. Disable for experienced users.",
+            "toggleAriaLabel": "Toggle new user onboarding feature",
+            "enabled": "Onboarding wizard enabled",
+            "disabled": "Onboarding wizard disabled",
+            "toggleFailed": "Failed to toggle onboarding feature",
+            "loadFailed": "Failed to load onboarding flag state"
         }
     }
 }

package/console/dist/ui/i18n/zh-CN.json

@@ -700,6 +700,61 @@
             "unknownAgentsWarning": "检测到 {{count}} 个未识别的代理：{{names}}。它们未被分组显示。",
             "footerNote": "9 个代理分布在内化管道与侧链服务两条路径上。核心三件套必须一起开，否则 PD 无法把错误转化为原则。"
         },
+        "signalKeywords": {
+            "title": "信号词库",
+            "subtitle": "管理智能体的信号关键词——当信号采集器检测到这些关键词时，会进行深度分析。",
+            "empty": "暂无信号关键词",
+            "loadError": "无法加载信号关键词",
+            "saveError": "保存失败",
+            "saving": "保存中…",
+            "searchPlaceholder": "搜索关键词…",
+            "filterAll": "全部",
+            "filterActive": "活跃",
+            "filterArchived": "归档",
+            "active": "活跃",
+            "archived": "归档",
+            "confirmDeleteTitle": "确认删除关键词",
+            "confirmDeleteMessage": "确定要删除「{{term}}」吗？此操作不可撤销。",
+            "confirmDeleteAck": "确认删除",
+            "confirmDeleteCancel": "取消",
+            "deleteSuccess": "已删除",
+            "archiveSuccess": "已归档",
+            "unarchiveSuccess": "已恢复",
+            "phase2Tooltip": "此操作将在后续版本中启用",
+            "colTerm": "术语",
+            "colCategory": "分类",
+            "colPrecision": "精度",
+            "colWeight": "权重",
+            "colReason": "原因",
+            "colActions": "操作",
+            "categoryCorrection": "纠正",
+            "categoryEmpathy": "共情",
+            "precisionHigh": "高",
+            "precisionAmbiguous": "歧义",
+            "nTerms": "{{count}} 条",
+            "selectedNOfTotal": "已选 {{selected}} / {{total}}",
+            "nTermsPendingReview": "{{count}} 条待审",
+            "weightLabel": "权重：{{percent}}%",
+            "addKeyword": "添加关键词",
+            "addKeywordDialogTitle": "添加信号关键词",
+            "submitAdd": "添加",
+            "noSearchResults": "无匹配关键词",
+            "pendingTerms": {
+                "title": "待确认信号词",
+                "subtitle": "信号采集器建议以下术语从未匹配消息中提取为潜在关键词。审查后确认或忽略。",
+                "empty": "暂无待确认信号词",
+                "emptyDescription": "当共情观察器检测到重复出现的未命中模式时，会建议新的信号词。",
+                "confirm": "确认添加",
+                "ignore": "忽略",
+                "confirmBatch": "全部确认",
+                "ignoreBatch": "全部忽略",
+                "sourceCount": "来自 {{count}} 条消息",
+                "confirmSuccess": "已确认添加",
+                "ignoreSuccess": "已忽略",
+                "batchConfirmSuccess": "已确认 {{count}} 个信号词",
+                "batchIgnoreSuccess": "已忽略 {{count}} 个信号词"
+            }
+        },
         "login": {
             "title": "登录",
             "description": "登录 PD 治理工作台",
@@ -942,6 +997,61 @@
             "demoteTooltip": "降权端点开发中",
             "principleAriaLabel": "原则债务 {{id}}",
             "listAriaLabel": "原则债务列表"
+        },
+        "welcome": {
+            "title": "欢迎使用 Principles Disciple",
+            "subtitle": "把你对智能体的反复纠正，沉淀为可审查、可撤回的行为原则。",
+            "stateSaveError": "无法保存引导进度，请检查浏览器存储权限后重试。",
+            "stepIndicator": "第 {{current}} 步 / 共 {{total}} 步",
+            "step1": {
+                "title": "PD 是什么？",
+                "description": "拥有者治理下的智能体行为内化系统。PD 把行为证据沉淀为可审查、可回滚的原则，让原则进入智能体的后续行为。",
+                "circuitLabel": "核心治理回路",
+                "circuitNodes": {
+                    "evidence": "行为证据",
+                    "principle": "原则",
+                    "ownerGate": "拥有者审查",
+                    "behavior": "行为变更"
+                },
+                "startButton": "开始",
+                "skipButton": "跳过引导"
+            },
+            "step2": {
+                "title": "看一次完整治理回路演示",
+                "description": "这是用模拟证据做的受控演示。真实使用时，由你的智能体通过 pd-pain-signal 技能产生证据。",
+                "runDemoButton": "运行演示",
+                "demoRunning": "演示运行中...",
+                "demoComplete": "演示完成",
+                "demoFailed": "演示失败",
+                "demoSimulatedNote": "此证据为演示模拟数据。",
+                "nextButton": "下一步",
+                "evidenceLabel": "证据（模拟）",
+                "candidateLabel": "候选原则",
+                "ownerGateLabel": "拥有者审查：批准 / 修改 / 拒绝",
+                "activationLabel": "激活结果",
+                "rollbackLabel": "可回滚路径已就绪"
+            },
+            "step3": {
+                "title": "准备好记录真实证据",
+                "description": "当你下次使用智能体时，如果智能体犯错或你重复纠正了它，告诉智能体：'用 pd-pain-signal 记录一下'。",
+                "examplePrompt": "给智能体的示例提示：",
+                "examplePromptText": "我刚纠正了你关于 X 的问题。用 pd-pain-signal 把这个记录为 pain signal。",
+                "tryNowButton": "我现在就试试（2 小时窗口）",
+                "goToFocusButton": "知道了，先看 Focus",
+                "skipButton": "暂时跳过",
+                "windowHint": "我们会在 2 小时后查看。不强制——你随时可以稍后记录证据。",
+                "pollingActive": "正在监听证据... 我们会每 30 秒检查一次，持续 2 小时。",
+                "stopPollingButton": "停止并继续",
+                "evidenceFound": "检测到证据！你现在可以在 Focus 页面查看。",
+                "timeoutHint": "2 小时内未检测到证据。没关系——你随时可以用 pd-pain-signal 记录证据。",
+                "pollingError": "无法检查证据。证据服务可能不可用。",
+                "retryButton": "重试"
+            },
+            "progress": {
+                "step1": "欢迎",
+                "step2": "演示",
+                "step3": "邀请"
+            }
         }
     },
     "components": {
@@ -1050,6 +1160,23 @@
             "tooShort": "拒绝原因至少需要10个字符",
             "cancel": "取消",
             "submit": "确认拒绝"
+        },
+        "onboardingReset": {
+            "title": "引导流程",
+            "resetButton": "重置引导状态",
+            "resetConfirm": "这将在下次登录时重新启动引导向导。继续吗？",
+            "resetSuccess": "引导状态已重置。下次访问时会看到欢迎页。",
+            "resetFailed": "无法重置引导，请检查浏览器存储权限后重试。"
+        },
+        "onboardingFlag": {
+            "title": "引导功能",
+            "label": "新用户引导向导",
+            "description": "首次访问时显示欢迎向导。熟练用户可关闭。",
+            "toggleAriaLabel": "切换新用户引导功能",
+            "enabled": "引导向导已启用",
+            "disabled": "引导向导已关闭",
+            "toggleFailed": "切换引导功能失败",
+            "loadFailed": "加载引导开关状态失败"
         }
     }
 }

package/console/dist/ui/pages/activation/ActivationValidators.js

@@ -14,7 +14,7 @@
 export function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-const VALID_ACTIVATION_STATUSES = new Set(["active", "inactive"]);
+const VALID_ACTIVATION_STATUSES = new Set(["active", "inactive", "deactivated", "suspended_by_flag"]);
 // ── Activation validators ────────────────────────────────────────────────────
 export function validateActivationRecord(raw) {
     if (!isRecord(raw))