create-principles-disciple 1.125.0 → 1.126.0

package/console/dist/server/config/pd-config-store.js

@@ -312,11 +312,15 @@ export function updateAgentBinding(workspaceDir, agentName, payload) {
             };
         }
     }
-    // Merge: start from raw config, overlay known sections, update internalAgents.agents
+    // Merge: start from raw config, overlay known sections, update internalAgents.agents.
+    // PRI-637: preserve the file's own `features:` section instead of re-writing
+    // the merged effective map. Defaults belong in the registry, not in config —
+    // snapshotting `effective.config.features` here would materialize every
+    // missing default flag into an immortal override on any agent-binding change.
     const updatedConfig = {
         ...rawConfig,
         version: effective.config.version,
-        features: { ...effective.config.features },
+        features: isRecord(rawConfig.features) ? rawConfig.features : { ...effective.config.features },
         runtimeProfiles: { ...effective.config.runtimeProfiles },
         internalAgents: {
             defaultRuntime: effective.config.internalAgents.defaultRuntime,
@@ -434,11 +438,13 @@ export function updateDefaultRuntime(workspaceDir, payload) {
     else {
         // No agents in file — write nothing (all agents inherit default)
     }
-    // Merge: update only defaultRuntime, preserve agent overrides
+    // Merge: update only defaultRuntime, preserve agent overrides.
+    // PRI-637: preserve the file's own `features:` section (same rationale as
+    // updateAgentBinding — never re-snapshot merged defaults into config).
     const updatedConfig = {
         ...rawConfig,
         version: effective.config.version,
-        features: { ...effective.config.features },
+        features: isRecord(rawConfig.features) ? rawConfig.features : { ...effective.config.features },
         runtimeProfiles: { ...effective.config.runtimeProfiles },
         internalAgents: {
             defaultRuntime: defaultRuntimeRaw,
@@ -814,13 +820,14 @@ export function updateFeatureFlag(workspaceDir, featureName, enabled) {
     //    Use Object.hasOwn for untrusted key check (ERR-013).
     let featuresSection;
     if (!Object.hasOwn(rawConfig, 'features')) {
-        // Section absent — seed with defaults from the registered flag set so the
-        // subsequent validatePdConfig passes (it requires prompt/code_tool_hook /
-        // defer_archive as registered flags). Computed once at module load.
+        // Section absent — create an EMPTY features map (PRI-637). Defaults belong
+        // in the registry, not in config: seeding the whole registered flag set here
+        // would materialize an immortal default snapshot on the first toggle of a
+        // fresh install. `features: {}` is fully valid — validatePdConfig only
+        // requires the key to be an object, and the effective config merges missing
+        // flags from DEFAULT_FEATURE_FLAGS at read time. Step 6 below then writes
+        // exactly one flag: the one the Owner toggled.
         featuresSection = {};
-        for (const [flagId, flag] of Object.entries(_DEFAULT_FLAGS_RESULT.flags)) {
-            featuresSection[flagId] = { category: flag.category, enabled: flag.enabled };
-        }
         rawConfig.features = featuresSection;
     }
     else if (isRecord(rawConfig.features)) {
@@ -865,7 +872,12 @@ export function updateFeatureFlag(workspaceDir, featureName, enabled) {
     const category = (isRecord(existingEntry) && Object.hasOwn(existingEntry, 'category') && typeof existingEntry.category === 'string')
         ? existingEntry.category
         : (DEFAULT_FLAG_CATEGORY.get(featureName) ?? 'quiet');
-    existingFeatures[featureName] = { category, enabled };
+    // PRI-637: the Console toggle is the canonical Owner action — an authenticated
+    // server writes this override under an explicit owner intent, so it records
+    // `source: 'owner'` (OWNER_PIN). This also upgrades a previously source-less
+    // LEGACY_UNKNOWN or system override: an explicit Owner action converts it to
+    // OWNER_PIN, which graduation must forever respect.
+    existingFeatures[featureName] = { category, enabled, source: 'owner' };
     rawConfig.features = existingFeatures;
     // 7. Validate the updated config before writing
     const validation = validatePdConfig(rawConfig);

package/console/dist/server/index.js

@@ -12,7 +12,7 @@ import { handleFeedbackReportsRoute, handleFeedbackChannelsRoute, disposeFeedbac
 import { handleFailedTasksRoute, disposeFailedTasksModels } from './routes/failed-tasks.js';
 import { handleApprovalsRoute, disposeApprovalsModels } from './routes/approvals.js';
 import { handleHealthRoute, disposeHealthModels } from './routes/health.js';
-import { handlePrinciplesRoute, disposePrinciplesModels } from './routes/principles.js';
+import { handlePrinciplesRoute, handleCorePrinciplesRoute, disposePrinciplesModels } from './routes/principles.js';
 import { handleLifecycleRoute, disposeLifecycleModels } from './routes/lifecycle.js';
 import { handleActivationsRoute, disposeActivationsModels } from './routes/activations.js';
 import { handleReceiptsRoute, disposeReceiptsModels } from './routes/receipts.js';
@@ -338,6 +338,13 @@ function handleRequest(services) {
                 asyncHandler(() => handleApprovalsRoute(req, res, services.workspaceDir, subPath))(req, res);
                 return;
             }
+            // GET /api/principles/core — read-only PD Core Principles reference
+            // (MUST be before the /api/principles catch-all so "core" is not parsed
+            // as a principle id; the /api/v1/principles mount does not expose it.)
+            if (urlPath === '/api/principles/core') {
+                asyncHandler(() => handleCorePrinciplesRoute(req, res))(req, res);
+                return;
+            }
             // GET /api/principles, /api/principles/:id
             if (urlPath === '/api/principles' || urlPath.startsWith('/api/principles/')) {
                 const subPath = urlPath.slice('/api/principles'.length);

package/console/dist/server/models/PrinciplesConsoleModel.d.ts

@@ -1,5 +1,15 @@
 import type { PrincipleStatus } from '@principles/core/runtime-v2';
 export type { PrincipleStatus };
+/** Core principle refused for a workspace governance mutation (archive/unarchive). */
+export declare class ImmutableCorePrincipleError extends Error {
+    readonly principleId: string;
+    constructor(principleId: string);
+}
+/** Core principle refused from the ordinary Owner Principle detail flow. */
+export declare class CorePrincipleNotGovernedError extends Error {
+    readonly principleId: string;
+    constructor(principleId: string);
+}
 export type PrinciplePriority = 'P0' | 'P1' | 'P2';
 export type PrincipleScope = 'general' | 'domain';
 export type PrincipleEvaluability = 'manual_only' | 'deterministic' | 'weak_heuristic';

package/console/dist/server/models/PrinciplesConsoleModel.js

@@ -2,6 +2,29 @@ import * as path from 'path';
 import * as fs from 'fs';
 import { classifyPrinciples, filterOwnerActionable } from './PrincipleClassifier.js';
 import { updatePrinciple } from '@principles/core/principle-tree-ledger';
+import { isCorePrincipleId } from '@principles/core/runtime-v2';
+// ── PRI-641: Core principle boundary errors ─────────────────────────────────
+// Core principles (registry T-01..T-10) are PD's built-in semantics, not
+// workspace governance targets. Refusals must be distinguishable from storage
+// failures (`false`), so they surface as typed errors at the model boundary.
+/** Core principle refused for a workspace governance mutation (archive/unarchive). */
+export class ImmutableCorePrincipleError extends Error {
+    principleId;
+    constructor(principleId) {
+        super(`Core principle "${principleId}" is built into Principles Disciple and cannot be modified through workspace governance.`);
+        this.name = 'ImmutableCorePrincipleError';
+        this.principleId = principleId;
+    }
+}
+/** Core principle refused from the ordinary Owner Principle detail flow. */
+export class CorePrincipleNotGovernedError extends Error {
+    principleId;
+    constructor(principleId) {
+        super(`Core principle "${principleId}" is not owner-managed.`);
+        this.name = 'CorePrincipleNotGovernedError';
+        this.principleId = principleId;
+    }
+}
 const VALID_STATUSES = ['candidate', 'active', 'archived', 'deprecated', 'probation'];
 const VALID_PRIORITIES = ['P0', 'P1', 'P2'];
 const VALID_SCOPES = ['general', 'domain'];
@@ -128,34 +151,9 @@ export class PrinciplesConsoleModel {
     async listPrinciples(filter, decidedPrincipleIds, pendingApprovalPrincipleIds) {
         const ledger = this.loadLedger();
         const principles = Object.values(ledger.tree.principles);
-        const summary = {
-            candidate: 0,
-            probation: 0,
-            active: 0,
-            deprecated: 0,
-            archived: 0,
-            total: principles.length,
-        };
         const items = [];
         for (const p of principles) {
             const status = safeCastEnum(p.status, VALID_STATUSES, 'candidate');
-            switch (status) {
-                case 'candidate':
-                    summary.candidate++;
-                    break;
-                case 'probation':
-                    summary.probation++;
-                    break;
-                case 'active':
-                    summary.active++;
-                    break;
-                case 'deprecated':
-                    summary.deprecated++;
-                    break;
-                case 'archived':
-                    summary.archived++;
-                    break;
-            }
             const principleText = p.text ?? '';
             const principleTrigger = p.triggerPattern ?? '';
             items.push({
@@ -180,20 +178,61 @@ export class PrinciplesConsoleModel {
             });
         }
         items.sort((a, b) => b.valueScore - a.valueScore);
-        // PRI-330: classify and optionally filter
+        // PRI-330 + PRI-641: classify first, then remove builtin from the corpus.
+        // The workspace projection is "workspace-governed principles only" —
+        // builtin axioms are PD's immutable semantics and never governance
+        // targets, so they must not reach lists, summary, or Debt consumers.
         const classified = classifyPrinciples(items, decidedPrincipleIds, pendingApprovalPrincipleIds);
+        const workspaceClassified = classified.filter((c) => c.category !== 'builtin');
+        const workspaceItems = workspaceClassified.map((c) => c.principle);
+        // PRI-641: summary and categories are computed over the same workspace
+        // corpus the caller sees, so `principles[]` and `summary` can never
+        // disagree (no "list 3, total 13" projection).
+        const summary = {
+            candidate: 0,
+            probation: 0,
+            active: 0,
+            deprecated: 0,
+            archived: 0,
+            total: workspaceItems.length,
+        };
+        for (const p of workspaceItems) {
+            switch (p.status) {
+                case 'candidate':
+                    summary.candidate++;
+                    break;
+                case 'probation':
+                    summary.probation++;
+                    break;
+                case 'active':
+                    summary.active++;
+                    break;
+                case 'deprecated':
+                    summary.deprecated++;
+                    break;
+                case 'archived':
+                    summary.archived++;
+                    break;
+            }
+        }
         const categories = {};
-        for (const c of classified) {
+        for (const c of workspaceClassified) {
             categories[c.category] = (categories[c.category] ?? 0) + 1;
         }
-        let outputItems = items;
+        let outputItems = workspaceItems;
         if (filter === 'actionable') {
-            const actionable = filterOwnerActionable(classified);
+            const actionable = filterOwnerActionable(workspaceClassified);
             outputItems = actionable.map((c) => c.principle);
         }
         return { principles: outputItems, summary, categories };
     }
     async getPrincipleDetail(principleId) {
+        // PRI-641: Core principles are not workspace-governed objects — they have
+        // no ordinary Owner detail (approvals/lifecycle/trajectory/receipts) and
+        // are viewed read-only via the Core Principles surface instead.
+        if (isCorePrincipleId(principleId)) {
+            throw new CorePrincipleNotGovernedError(principleId);
+        }
         const ledger = this.loadLedger();
         const p = ledger.tree.principles[principleId];
         if (!p) {
@@ -247,6 +286,10 @@ export class PrinciplesConsoleModel {
         return { principle };
     }
     async archivePrinciple(principleId) {
+        // PRI-641: refuse before any write — builtin axioms are immutable
+        if (isCorePrincipleId(principleId)) {
+            throw new ImmutableCorePrincipleError(principleId);
+        }
         try {
             const stateDir = path.join(this.workspaceDir, '.state');
             updatePrinciple(stateDir, principleId, {
@@ -264,6 +307,10 @@ export class PrinciplesConsoleModel {
         }
     }
     async unarchivePrinciple(principleId) {
+        // PRI-641: refuse before any write — builtin axioms are immutable
+        if (isCorePrincipleId(principleId)) {
+            throw new ImmutableCorePrincipleError(principleId);
+        }
         try {
             const stateDir = path.join(this.workspaceDir, '.state');
             updatePrinciple(stateDir, principleId, {

package/console/dist/server/routes/principles.d.ts

@@ -1,4 +1,13 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
+/**
+ * GET /api/principles/core — read-only PD Core Principles reference (PRI-641).
+ *
+ * Served directly from the canonical `CORE_PRINCIPLES` registry (no ledger /
+ * DB read). Dispatched in server/index.ts BEFORE the `/api/principles`
+ * catch-all so `core` is never parsed as `/:id`; the `/api/v1/principles`
+ * mount intentionally does NOT expose this endpoint.
+ */
+export declare function handleCorePrinciplesRoute(req: IncomingMessage, res: ServerResponse): Promise<void>;
 interface PrinciplesRouteParams {
     req: IncomingMessage;
     res: ServerResponse;

package/console/dist/server/routes/principles.js

@@ -1,9 +1,9 @@
 import * as path from 'path';
 import * as fs from 'fs';
-import { PrinciplesConsoleModel } from '../models/PrinciplesConsoleModel.js';
+import { PrinciplesConsoleModel, ImmutableCorePrincipleError, CorePrincipleNotGovernedError, } from '../models/PrinciplesConsoleModel.js';
 import { PrincipleTrajectoryModel } from '../models/PrincipleTrajectoryModel.js';
 import { GovernanceProjectionCollector, GovernanceProjectionCollectionError } from '../models/GovernanceProjectionCollector.js';
-import { OwnerGovernanceViewSchema, deriveOwnerGovernanceView } from '@principles/core/runtime-v2';
+import { CORE_PRINCIPLES, OwnerGovernanceViewSchema, deriveOwnerGovernanceView } from '@principles/core/runtime-v2';
 import { Value } from '@sinclair/typebox/value';
 import { sendSuccess, sendError, sendNotFound } from '../utils/response.js';
 const models = new Map();
@@ -16,6 +16,30 @@ function getModel(workspaceDir) {
     }
     return model;
 }
+/**
+ * GET /api/principles/core — read-only PD Core Principles reference (PRI-641).
+ *
+ * Served directly from the canonical `CORE_PRINCIPLES` registry (no ledger /
+ * DB read). Dispatched in server/index.ts BEFORE the `/api/principles`
+ * catch-all so `core` is never parsed as `/:id`; the `/api/v1/principles`
+ * mount intentionally does NOT expose this endpoint.
+ */
+export async function handleCorePrinciplesRoute(req, res) {
+    if (req.method !== 'GET') {
+        sendNotFound(res, `Route ${req.method} /api/principles/core not found`);
+        return;
+    }
+    sendSuccess(res, {
+        principles: CORE_PRINCIPLES.map((p) => ({
+            id: p.id,
+            layer: p.layer,
+            name: p.name,
+            nameZh: p.nameZh,
+            statement: p.statement,
+            statementZh: p.statementZh,
+        })),
+    });
+}
 /**
  * Safely read an own string property from an unknown object.
  * Returns the string value if the key exists and the value is a string,
@@ -153,6 +177,12 @@ export async function handlePrinciplesRoute({ req, res, workspaceDir, subPath, f
                 }
             }
             catch (err) {
+                if (err instanceof ImmutableCorePrincipleError) {
+                    sendError(res, 403, 'immutable_core_principle', err.message, {
+                        nextAction: 'View this principle under PD Core Principles.',
+                    });
+                    return;
+                }
                 sendError(res, 500, 'archive_failed', err instanceof Error ? err.message : String(err));
             }
             return;
@@ -183,6 +213,12 @@ export async function handlePrinciplesRoute({ req, res, workspaceDir, subPath, f
                 }
             }
             catch (err) {
+                if (err instanceof ImmutableCorePrincipleError) {
+                    sendError(res, 403, 'immutable_core_principle', err.message, {
+                        nextAction: 'View this principle under PD Core Principles.',
+                    });
+                    return;
+                }
                 sendError(res, 500, 'unarchive_failed', err instanceof Error ? err.message : String(err));
             }
             return;
@@ -264,6 +300,14 @@ export async function handlePrinciplesRoute({ req, res, workspaceDir, subPath, f
             sendSuccess(res, result);
         }
         catch (err) {
+            if (err instanceof CorePrincipleNotGovernedError) {
+                // PRI-641: Core principles never enter the ordinary Owner detail flow
+                // (approvals/lifecycle/trajectory/receipts are workspace-governance data).
+                sendError(res, 404, 'core_principle_not_owner_managed', err.message, {
+                    nextAction: 'View this principle under PD Core Principles.',
+                });
+                return;
+            }
             sendError(res, 500, 'principle_detail_error', err instanceof Error ? err.message : String(err));
         }
         return;

package/console/dist/ui/App.js

@@ -15,6 +15,7 @@ import { Toaster } from "./components/ui/sonner.js";
 import { FocusPage } from "./pages/focus/FocusPage.js";
 import { PainPage } from "./pages/pain/PainPage.js";
 import { PrinciplesPage } from "./pages/principles/PrinciplesPage.js";
+import { CorePrinciplesPage } from "./pages/principles/CorePrinciplesPage.js";
 import { PrincipleDetailPage } from "./pages/principles/PrincipleDetailPage.js";
 import { ActivationPage } from "./pages/activation/ActivationPage.js";
 import { DebtPage } from "./pages/debt/DebtPage.js";
@@ -130,7 +131,7 @@ function AuthRoutes() {
     }, []);
     return (_jsxs(Routes, { children: [_jsx(Route, { path: "/splash", element: _jsx(SplashScreen, { onComplete: () => {
                         setShowSplash(false);
-                    } }) }), _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, { featureFlags: featureFlags ?? undefined }), _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, { featureFlags: featureFlags ?? undefined }) }), _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: "/failed-tasks", element: _jsx(FailedTasksPage, {}) }), _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, { featureFlags: featureFlags ?? undefined }), _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, { featureFlags: featureFlags ?? undefined }) }), _jsx(Route, { path: "/pain", element: _jsx(PainPage, {}) }), _jsx(Route, { path: "/principles", element: _jsx(PrinciplesPage, {}) }), _jsx(Route, { path: "/principles/core", element: _jsx(CorePrinciplesPage, {}) }), _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: "/failed-tasks", element: _jsx(FailedTasksPage, {}) }), _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

@@ -3,7 +3,7 @@ import type { OwnerDecisionsData, OwnerResolutionResultData } from "./utils/vali
 import { listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm } from "./utils/signal-keywords-api.js";
 import type { GovernanceExperienceSnapshot, OwnerGovernanceView } from '@principles/core/runtime-v2';
 import type { OwnerIdentityViewData, OwnerIdentityRegisterData, OwnerIdentityUnregisterData } from "./utils/validators.js";
-import type { FeedbackReportData, FeedbackDraftSummaryData, FeedbackDraftEnvelopeData, FeedbackChannelsData, FeedbackSubmitResultData, DeleteEnvelopeData, WorkspaceEntryData, RemovedEnvelopeData, SyncResultData, ConfigSummaryData, ConfigCatalogData, AgentBindingUpdateData, DefaultRuntimeUpdateData, RuntimeProfileMutationData, ReadinessCheckData, FeatureFlagUpdateData, OutputLanguageData, GovernanceQueueData, RecoveryResultData, ActivationsData, DisableActivationData, LifecycleMetricsData, UpdateStatusData, UpdateHistoryData, ApplyUpdateResultData, RollbackResultData, ApprovalRecordData, PrinciplesListData, ApprovalsGroupedData, EvidenceChainData, TrajectoryData, IntentSummaryData, IntentDecisionRecordData, IntentDecisionResultData, IntentDecisionSummaryData, FollowUpResponseData, IntentInitResultData, IntentSaveResultData, IntentRawContentData, IntentVersionData, RuleCodeOwnerReviewData, RuleCodeMutationData } from "./utils/validators.js";
+import type { FeedbackReportData, FeedbackDraftSummaryData, FeedbackDraftEnvelopeData, FeedbackChannelsData, FeedbackSubmitResultData, DeleteEnvelopeData, WorkspaceEntryData, RemovedEnvelopeData, SyncResultData, ConfigSummaryData, ConfigCatalogData, AgentBindingUpdateData, DefaultRuntimeUpdateData, RuntimeProfileMutationData, ReadinessCheckData, FeatureFlagUpdateData, OutputLanguageData, GovernanceQueueData, RecoveryResultData, ActivationsData, DisableActivationData, LifecycleMetricsData, UpdateStatusData, UpdateHistoryData, ApplyUpdateResultData, RollbackResultData, ApprovalRecordData, PrinciplesListData, CorePrinciplesData, ApprovalsGroupedData, EvidenceChainData, TrajectoryData, IntentSummaryData, IntentDecisionRecordData, IntentDecisionResultData, IntentDecisionSummaryData, FollowUpResponseData, IntentInitResultData, IntentSaveResultData, IntentRawContentData, IntentVersionData, RuleCodeOwnerReviewData, RuleCodeMutationData } from "./utils/validators.js";
 declare function getToken(): string | null;
 declare function setToken(token: string): void;
 declare function clearToken(): void;
@@ -27,6 +27,7 @@ declare function addWorkspace(name: string, path: string): Promise<ApiResponse<W
 declare function removeWorkspace(name: string): Promise<ApiResponse<RemovedEnvelopeData>>;
 declare function syncWorkspace(name: string): Promise<ApiResponse<SyncResultData>>;
 declare function fetchPrinciples(filter?: 'all' | 'actionable'): Promise<ApiResponse<PrinciplesListData>>;
+declare function fetchCorePrinciples(): Promise<ApiResponse<CorePrinciplesData>>;
 declare function fetchPrincipleDetail(principleId: string): Promise<ApiResponse<unknown>>;
 declare function fetchPrincipleGovernance(principleId: string): Promise<ApiResponse<OwnerGovernanceView>>;
 declare function archivePrinciple(principleId: string): Promise<ApiResponse<unknown>>;
@@ -230,8 +231,8 @@ export interface FollowUpPayload {
     candidateId?: string;
 }
 declare function dispatchFollowUp(decisionId: string, payload: FollowUpPayload): Promise<ApiResponse<FollowUpResponseData>>;
-export { request, listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm, getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchPrincipleDetail, fetchPrincipleGovernance, fetchPrincipleTrajectory, fetchPrincipleReceipts, fetchReceiptCounts, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, fetchFeedbackChannels, submitFeedbackReport, markFeedbackReportSent, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, createRuntimeProfile, updateRuntimeProfile, deleteRuntimeProfile, fetchAgentReadiness, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchGovernanceExperience, recoverFailedTask, fetchOwnerDecisions, resolveOwnerDecision, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchRuleCodeOwnerReview, ruleCodeDecision, pauseAllRuleCode, releaseRuleCodePause, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, applyFullUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };
-export type { FeedbackReportData, FeedbackDraftSummaryData, FeedbackDraftEnvelopeData, FeedbackChannelsData, FeedbackSubmitResultData, DeleteEnvelopeData, WorkspaceEntryData, RemovedEnvelopeData, SyncResultData, ConfigSummaryData, ConfigCatalogData, AgentBindingUpdateData, DefaultRuntimeUpdateData, RuntimeProfileMutationData, ReadinessCheckData, FeatureFlagUpdateData, OutputLanguageData, GovernanceQueueData, RecoveryResultData, ActivationsData, DisableActivationData, RuleCodeOwnerReviewData, RuleCodeMutationData, 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 { request, listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm, getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchCorePrinciples, fetchPrincipleDetail, fetchPrincipleGovernance, fetchPrincipleTrajectory, fetchPrincipleReceipts, fetchReceiptCounts, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, fetchFeedbackChannels, submitFeedbackReport, markFeedbackReportSent, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, createRuntimeProfile, updateRuntimeProfile, deleteRuntimeProfile, fetchAgentReadiness, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchGovernanceExperience, recoverFailedTask, fetchOwnerDecisions, resolveOwnerDecision, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchRuleCodeOwnerReview, ruleCodeDecision, pauseAllRuleCode, releaseRuleCodePause, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, applyFullUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };
+export type { FeedbackReportData, FeedbackDraftSummaryData, FeedbackDraftEnvelopeData, FeedbackChannelsData, FeedbackSubmitResultData, DeleteEnvelopeData, WorkspaceEntryData, RemovedEnvelopeData, SyncResultData, ConfigSummaryData, ConfigCatalogData, AgentBindingUpdateData, DefaultRuntimeUpdateData, RuntimeProfileMutationData, ReadinessCheckData, FeatureFlagUpdateData, OutputLanguageData, GovernanceQueueData, RecoveryResultData, ActivationsData, DisableActivationData, RuleCodeOwnerReviewData, RuleCodeMutationData, LifecycleMetricsData, UpdateStatusData, UpdateHistoryData, ApplyUpdateResultData, RollbackResultData, ApprovalRecordData, PrinciplesListData, CorePrinciplesData, CorePrincipleData, 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";

package/console/dist/ui/api.js

@@ -1,5 +1,5 @@
 import { listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm, } from "./utils/signal-keywords-api.js";
-import { validateErrorResponse, validateHeaders, validateFeedbackReport, validateFeedbackDraftsList, validateFeedbackDraftEnvelope, validateFeedbackChannels, validateFeedbackSubmitResult, validateDeleteEnvelope, validateWorkspaceEntry, validateWorkspaceList, validateRemovedEnvelope, validateSyncResult, validateConfigSummary, validateConfigCatalog, validateAgentBindingUpdate, validateDefaultRuntimeUpdate, validateRuntimeProfileMutation, validateReadinessCheck, validateFeatureFlagUpdate, validateOutputLanguage, validateGovernanceQueue, validateRecoveryResult, validateOwnerDecisionsData, validateOwnerResolutionResult, validateActivations, validateDisableActivation, validateLifecycleMetrics, validateUpdateStatus, validateUpdateHistory, validateApplyUpdateResult, validateRollbackResult, validateApprovalRecordDirect, validatePrinciplesList, validateApprovalsGrouped, validateEvidenceChain, validateTrajectoryData, validateIntentSummary, validateIntentDecisionList, validateIntentDecisionResult, validateIntentDecisionSummary, validateFollowUpResponse, validateIntentInitResult, validateIntentSaveResult, validateIntentRawContent, validateIntentVersions, validateOwnerGovernanceView, validateGovernanceExperienceSnapshot, validateRuleCodeOwnerReview, validateRuleCodeMutation, validateOwnerIdentityView, validateOwnerIdentityRegister, validateOwnerIdentityUnregister, } from "./utils/validators.js";
+import { validateErrorResponse, validateHeaders, validateFeedbackReport, validateFeedbackDraftsList, validateFeedbackDraftEnvelope, validateFeedbackChannels, validateFeedbackSubmitResult, validateDeleteEnvelope, validateWorkspaceEntry, validateWorkspaceList, validateRemovedEnvelope, validateSyncResult, validateConfigSummary, validateConfigCatalog, validateAgentBindingUpdate, validateDefaultRuntimeUpdate, validateRuntimeProfileMutation, validateReadinessCheck, validateFeatureFlagUpdate, validateOutputLanguage, validateGovernanceQueue, validateRecoveryResult, validateOwnerDecisionsData, validateOwnerResolutionResult, validateActivations, validateDisableActivation, validateLifecycleMetrics, validateUpdateStatus, validateUpdateHistory, validateApplyUpdateResult, validateRollbackResult, validateApprovalRecordDirect, validatePrinciplesList, validateCorePrinciples, validateApprovalsGrouped, validateEvidenceChain, validateTrajectoryData, validateIntentSummary, validateIntentDecisionList, validateIntentDecisionResult, validateIntentDecisionSummary, validateFollowUpResponse, validateIntentInitResult, validateIntentSaveResult, validateIntentRawContent, validateIntentVersions, validateOwnerGovernanceView, validateGovernanceExperienceSnapshot, validateRuleCodeOwnerReview, validateRuleCodeMutation, validateOwnerIdentityView, validateOwnerIdentityRegister, validateOwnerIdentityUnregister, } from "./utils/validators.js";
 // ── Auth ──────────────────────────────────────────────────────────────────────
 function getToken() {
     return sessionStorage.getItem("pd_token");
@@ -113,6 +113,11 @@ async function fetchPrinciples(filter) {
     const query = filter === undefined ? '' : `?filter=${filter}`;
     return request(`/api/principles${query}`, undefined, validatePrinciplesList);
 }
+// PRI-641: read-only PD Core Principles reference. Served from the canonical
+// registry by the server; validated here for network shape only.
+async function fetchCorePrinciples() {
+    return request("/api/principles/core", undefined, validateCorePrinciples);
+}
 // Principle detail is deeply nested; for now we accept unvalidated until a
 // dedicated validator is added (the page already handles missing fields gracefully).
 // This endpoint is marked legacy/deferred for full validation.
@@ -575,6 +580,6 @@ 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, fetchPrincipleGovernance, fetchPrincipleTrajectory, fetchPrincipleReceipts, fetchReceiptCounts, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, 
+getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchCorePrinciples, fetchPrincipleDetail, fetchPrincipleGovernance, fetchPrincipleTrajectory, fetchPrincipleReceipts, fetchReceiptCounts, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, 
 // Feedback submit ladder (Slice 3, spec §8)
 fetchFeedbackChannels, submitFeedbackReport, markFeedbackReportSent, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, createRuntimeProfile, updateRuntimeProfile, deleteRuntimeProfile, fetchAgentReadiness, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchGovernanceExperience, recoverFailedTask, fetchOwnerDecisions, resolveOwnerDecision, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchRuleCodeOwnerReview, ruleCodeDecision, pauseAllRuleCode, releaseRuleCodePause, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, applyFullUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };

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

@@ -506,6 +506,18 @@
             "reviewTitle": "Principle Review",
             "reviewSubtitle": "Review the principles distilled from observed behavior.",
             "reviewDescription": "These are not cold rules — they are behavioral principles your Agent has distilled from real use.",
+            "viewNavLabel": "Principles views",
+            "tabWorkspace": "Workspace Principles",
+            "tabCore": "PD Core Principles",
+            "coreSectionTitle": "PRINCIPLES",
+            "coreTitle": "PD Core Principles",
+            "coreDescription": "These are the built-in principles PD uses to guide how an agent understands problems, makes judgments, and learns from experience. They are provided by the PD Runtime and are not workspace-learned principles.",
+            "coreReadOnly": "Read-only",
+            "coreLayerFoundational": "Foundational Axioms",
+            "coreLayerOperating": "Operating Principles",
+            "coreLoading": "Loading…",
+            "coreLoadFailed": "Unable to load PD Core Principles",
+            "coreRetry": "Retry",
             "metricDeposited": "Deposited Principles",
             "metricActive": "Active Principles",
             "metricLatest": "Last Updated",

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

@@ -506,6 +506,18 @@
             "reviewTitle": "原则审查",
             "reviewSubtitle": "审阅从真实行为中沉淀出的原则。",
             "reviewDescription": "这些不是冰冷的规则，而是智能体在真实使用过程中沉淀下来的行为准则。",
+            "viewNavLabel": "原则视图",
+            "tabWorkspace": "工作区原则",
+            "tabCore": "PD 核心原则",
+            "coreSectionTitle": "原则",
+            "coreTitle": "PD 核心原则",
+            "coreDescription": "这些是 PD 内置的基本原则，用来指导智能体如何理解问题、作出判断，以及从经验中学习。它们由 PD Runtime 提供，不属于工作区的学习原则。",
+            "coreReadOnly": "只读",
+            "coreLayerFoundational": "基础公理",
+            "coreLayerOperating": "操作原则",
+            "coreLoading": "加载中…",
+            "coreLoadFailed": "无法加载 PD 核心原则",
+            "coreRetry": "重试",
             "metricDeposited": "沉淀原则",
             "metricActive": "已生效原则",
             "metricLatest": "最近更新",

package/console/dist/ui/pages/principles/CorePrinciplesPage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * PD Core Principles — read-only reference surface (PRI-641).
+ *
+ * The 10 builtin axioms (T-01..T-10) are PD's own semantics, served from the
+ * canonical registry via GET /api/principles/core. They are not workspace
+ * governance targets: no lifecycle, no approvals, no archive, no edit. This
+ * page renders exactly id / name / statement / layer, localized with the
+ * registry's own bilingual fields.
+ */
+export declare function CorePrinciplesPage(): import("react").JSX.Element;

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

@@ -0,0 +1,59 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect, useCallback } from "react";
+import { useTranslation } from "react-i18next";
+import { PageShell } from "../../components/layout/page-shell.js";
+import { SectionTitle } from "../../components/layout/section-title.js";
+import { Button } from "../../components/ui/button.js";
+import { Skeleton } from "../../components/ui/skeleton.js";
+import { fetchCorePrinciples } from "../../api.js";
+import { PrinciplesViewNav } from "./PrinciplesViewNav.js";
+/**
+ * PD Core Principles — read-only reference surface (PRI-641).
+ *
+ * The 10 builtin axioms (T-01..T-10) are PD's own semantics, served from the
+ * canonical registry via GET /api/principles/core. They are not workspace
+ * governance targets: no lifecycle, no approvals, no archive, no edit. This
+ * page renders exactly id / name / statement / layer, localized with the
+ * registry's own bilingual fields.
+ */
+export function CorePrinciplesPage() {
+    const { t, i18n } = useTranslation("pages");
+    const [principles, setPrinciples] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const loadCore = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        try {
+            // Response shape is runtime-validated in fetchCorePrinciples
+            // (validateCorePrinciples); no fallback to hardcoded principles on error.
+            const result = await fetchCorePrinciples();
+            if (!result.success) {
+                setError(result.error ?? t("principles.coreLoadFailed"));
+                return;
+            }
+            setPrinciples(result.data.principles);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : t("principles.coreLoadFailed"));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [t]);
+    useEffect(() => {
+        loadCore();
+    }, [loadCore]);
+    const isZh = (i18n.language ?? "").startsWith("zh");
+    const foundational = principles.filter((p) => p.layer === "foundational");
+    const operating = principles.filter((p) => p.layer === "operating");
+    return (_jsxs(PageShell, { children: [_jsx(SectionTitle, { children: t("principles.coreSectionTitle") }), _jsx("h1", { className: "text-[29px] font-semibold tracking-tight text-ink mb-2", children: t("principles.coreTitle") }), _jsx("p", { className: "text-ink-3 text-[14px] leading-relaxed mb-1", children: t("principles.coreDescription") }), _jsxs("p", { className: "text-ink-4 text-[12px] font-mono mb-6", children: ["\uD83D\uDD12 ", t("principles.coreReadOnly")] }), _jsx(PrinciplesViewNav, { view: "core" }), loading && (_jsx("div", { className: "grid gap-3", role: "status", "aria-live": "polite", "aria-label": t("principles.coreLoading"), children: Array.from({ length: 4 }).map((_, i) => (_jsxs("div", { className: "bg-panel border border-line rounded-[var(--radius-md)] p-4", children: [_jsx(Skeleton, { className: "h-5 w-[40%] rounded-sm mb-3" }), _jsx(Skeleton, { className: "h-4 w-full rounded-sm mb-2" }), _jsx(Skeleton, { className: "h-4 w-[70%] rounded-sm" })] }, i))) })), error && (_jsxs("div", { className: "border border-danger/30 rounded-[var(--radius-md)] p-4 mb-4", children: [_jsx("p", { className: "text-danger text-sm", children: t("principles.coreLoadFailed") }), _jsx("p", { className: "text-ink-4 text-[12px] mt-1 font-mono break-all", children: error }), _jsx(Button, { variant: "outline", size: "sm", onClick: loadCore, className: "mt-2", children: t("principles.coreRetry") })] })), !loading && !error && (_jsxs(_Fragment, { children: [_jsx(CoreLayerGroup, { label: t("principles.coreLayerFoundational"), principles: foundational, isZh: isZh }), _jsx(CoreLayerGroup, { label: t("principles.coreLayerOperating"), principles: operating, isZh: isZh })] }))] }));
+}
+function CoreLayerGroup({ label, principles, isZh, }) {
+    const { t } = useTranslation("pages");
+    return (_jsxs("section", { className: "mb-8", "aria-label": label, children: [_jsxs("h2", { className: "font-mono text-[11px] uppercase tracking-[0.02em] text-ink-3 border-b border-line pb-2 mb-4", children: [label, " \u00B7 ", principles.length] }), _jsx("div", { className: "grid gap-3 animate-[pdFadeIn_400ms_ease-out]", children: principles.map((p) => {
+                    const name = isZh ? p.nameZh : p.name;
+                    const statement = isZh ? p.statementZh : p.statement;
+                    return (_jsxs("article", { id: p.id, className: "bg-panel border border-line rounded-[var(--radius-md)] p-4", children: [_jsxs("div", { className: "flex items-center gap-2 mb-2", children: [_jsx("span", { className: "font-mono text-[11px] tracking-[0.02em] border border-line rounded-[2px] px-2 py-0.5 text-ink-3", children: p.id }), _jsx("span", { className: "font-mono text-[11px] tracking-[0.02em] text-ink-4", children: t("principles.coreLayer" + (p.layer === "foundational" ? "Foundational" : "Operating")) })] }), _jsx("h3", { className: "font-semibold text-ink mb-1", children: name }), _jsx("p", { className: "text-ink-3 text-[13px] leading-relaxed", children: statement })] }, p.id));
+                }) })] }));
+}

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

@@ -10,6 +10,7 @@ import { ShinyText } from "../../components/ui/shiny-text.js";
 import { fetchPrinciples, fetchApprovalsGrouped, } from "../../api.js";
 import { enumLabel } from "../../utils/enum-labels.js";
 import { formatDate } from "../../utils/format-date.js";
+import { PrinciplesViewNav } from "./PrinciplesViewNav.js";
 // ── Map principle status to review status ───────────────────────────────────
 function toReviewStatus(principleStatus, approvalStatus) {
     if (approvalStatus === "approved")
@@ -259,7 +260,7 @@ export function PrinciplesPage() {
     ];
     // PRI-558: most recent update across loaded principles (drives "Last Updated" metric)
     const latestUpdatedAt = principles.reduce((max, p) => (new Date(p.updatedAt).getTime() > new Date(max).getTime() ? p.updatedAt : max), principles[0]?.updatedAt ?? "");
-    return (_jsxs(PageShell, { children: [_jsx(SectionTitle, { children: t("principles.reviewTitle") }), _jsx(ShinyText, { as: "h1", className: "text-[29px] font-semibold tracking-tight text-ink mb-2", duration: 4.5, brightness: 0.5, disabled: !(filterMode === 'actionable' && (categories?.owner_actionable ?? 0) > 0), children: t("principles.reviewSubtitle") }), _jsx("p", { className: "text-ink-3 text-[14px] leading-relaxed mb-6", children: t("principles.reviewDescription") }), _jsxs("div", { className: "flex flex-wrap items-center gap-3 mb-6", children: [_jsxs("div", { className: "flex gap-1", role: "group", "aria-label": "Filter mode", children: [_jsxs("button", { onClick: () => setFilterMode('actionable'), className: "font-mono text-[11px] uppercase tracking-[0.02em] border rounded-[2px] px-2 py-1 transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-gov " +
+    return (_jsxs(PageShell, { children: [_jsx(SectionTitle, { children: t("principles.reviewTitle") }), _jsx(ShinyText, { as: "h1", className: "text-[29px] font-semibold tracking-tight text-ink mb-2", duration: 4.5, brightness: 0.5, disabled: !(filterMode === 'actionable' && (categories?.owner_actionable ?? 0) > 0), children: t("principles.reviewSubtitle") }), _jsx("p", { className: "text-ink-3 text-[14px] leading-relaxed mb-6", children: t("principles.reviewDescription") }), _jsx(PrinciplesViewNav, { view: "workspace" }), _jsxs("div", { className: "flex flex-wrap items-center gap-3 mb-6", children: [_jsxs("div", { className: "flex gap-1", role: "group", "aria-label": "Filter mode", children: [_jsxs("button", { onClick: () => setFilterMode('actionable'), className: "font-mono text-[11px] uppercase tracking-[0.02em] border rounded-[2px] px-2 py-1 transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-gov " +
                                     (filterMode === 'actionable'
                                         ? "bg-gov text-paper border-gov"
                                         : "bg-surface text-ink-3 border-line hover:border-line-2"), children: [t("principles.filterActionable", { defaultValue: "Actionable" }), categories?.owner_actionable ? ` (${categories.owner_actionable})` : ''] }), _jsxs("button", { onClick: () => setFilterMode('all'), className: "font-mono text-[11px] uppercase tracking-[0.02em] border rounded-[2px] px-2 py-1 transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-gov " +

package/console/dist/ui/pages/principles/PrinciplesViewNav.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PRI-641: internal navigation inside the Principles section — Workspace
+ * Principles vs the read-only PD Core Principles reference surface. The
+ * sidebar keeps a single "Principles" entry; this is the only extra nav.
+ */
+export declare function PrinciplesViewNav({ view }: {
+    view: "workspace" | "core";
+}): import("react").JSX.Element;