create-principles-disciple 1.82.0 → 1.83.0

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

@@ -0,0 +1,350 @@
+/**
+ * Runtime validators for untrusted API response data.
+ *
+ * These validators follow the Runtime Contract Rules (ERR-001/005/009/013):
+ * - All input is treated as `unknown` (Rule 1)
+ * - No `as` type assertions to bypass validation (Rule 2)
+ * - Required fields fail loud when missing (Rule 3)
+ * - Uses `Object.hasOwn()` for untrusted object keys (Rule 5)
+ * - Graceful degradation includes a reason (Rule 9)
+ */
+/**
+ * Best-effort error envelope validator.
+ *
+ * Unlike success-data validators, this does NOT fail on missing fields —
+ * error responses are inherently unreliable and the caller only needs
+ * whatever fields the server happened to return. Missing/wrong-type fields
+ * are silently omitted rather than causing a null return.
+ */
+export interface ErrorResponse {
+    error?: string;
+    message?: string;
+    nextAction?: string;
+}
+export declare function validateErrorResponse(v: unknown): ErrorResponse | null;
+/**
+ * Validates that `options.headers` is a plain object with string values.
+ * Returns null if the value is not a valid headers object.
+ * Used instead of `as Record<string, string>` on untrusted RequestInit.headers.
+ */
+export declare function validateHeaders(v: unknown): Record<string, string> | null;
+export interface FeedbackReportData {
+    id: string;
+    createdAt: string;
+    report: Record<string, unknown>;
+}
+export declare function validateFeedbackReport(v: unknown): FeedbackReportData | null;
+export interface FeedbackDraftSummaryData {
+    id: string;
+    createdAt: string;
+    type: string;
+    title: string;
+}
+export declare function validateFeedbackDraftsList(v: unknown): FeedbackDraftSummaryData[] | null;
+export interface FeedbackDraftEnvelopeData {
+    report: Record<string, unknown>;
+}
+export declare function validateFeedbackDraftEnvelope(v: unknown): FeedbackDraftEnvelopeData | null;
+export interface DeleteEnvelopeData {
+    deleted: boolean;
+}
+export declare function validateDeleteEnvelope(v: unknown): DeleteEnvelopeData | null;
+interface WorkspaceConfigData {
+    workspaceName: string;
+    enabled: boolean;
+    displayName: string | null;
+    syncEnabled: boolean;
+}
+export interface WorkspaceEntryData {
+    name: string;
+    path: string;
+    lastSync: string | null;
+    config: WorkspaceConfigData | null;
+}
+export declare function validateWorkspaceEntry(v: unknown): WorkspaceEntryData | null;
+export declare function validateWorkspaceList(v: unknown): WorkspaceEntryData[] | null;
+export interface RemovedEnvelopeData {
+    removed: string;
+}
+export declare function validateRemovedEnvelope(v: unknown): RemovedEnvelopeData | null;
+export interface SyncResultData {
+    success: boolean;
+    syncedAt: string;
+}
+export declare function validateSyncResult(v: unknown): SyncResultData | null;
+export type ReadinessStatus = 'ready' | 'not_ready' | 'needs_setup' | 'disabled' | 'unknown';
+export interface RedactedRuntimeProfileSummaryData {
+    id: string;
+    type: string;
+    label: string;
+    apiKeyEnv?: string;
+    readiness: ReadinessStatus;
+}
+export interface RedactedFeatureSummaryData {
+    id: string;
+    category: string;
+    enabled: boolean;
+}
+export interface RedactedAgentSummaryData {
+    name: string;
+    enabled: boolean;
+    runtimeProfileId: string;
+    runtimeProfileLabel: string;
+    readiness: ReadinessStatus;
+}
+interface ConfigErrorData {
+    path: string;
+    reason: string;
+    nextAction: string;
+}
+export type ConfigSource = 'defaults' | 'user_config';
+export interface ConfigSummaryData {
+    version: number;
+    source: ConfigSource;
+    features: RedactedFeatureSummaryData[];
+    runtimeProfiles: RedactedRuntimeProfileSummaryData[];
+    defaultRuntime: string;
+    agents: RedactedAgentSummaryData[];
+    ui: {
+        diagnostics: {
+            mode: string;
+        };
+    };
+    warnings: string[];
+    errors?: ConfigErrorData[];
+}
+export declare function validateConfigSummary(v: unknown): ConfigSummaryData | null;
+export interface ConfigCatalogData {
+    profiles: RedactedRuntimeProfileSummaryData[];
+    errors?: ConfigErrorData[];
+}
+export declare function validateConfigCatalog(v: unknown): ConfigCatalogData | null;
+export interface AgentBindingUpdateData {
+    agent: string;
+    runtimeProfile: string;
+    enabled: boolean;
+}
+export declare function validateAgentBindingUpdate(v: unknown): AgentBindingUpdateData | null;
+export interface ReadinessCheckData {
+    agent: string;
+    readiness: ReadinessStatus;
+    profileId: string;
+    profileLabel: string;
+    reason?: string;
+    nextAction?: string;
+}
+export declare function validateReadinessCheck(v: unknown): ReadinessCheckData | null;
+export interface DefaultRuntimeUpdateData {
+    defaultRuntime: string;
+}
+export declare function validateDefaultRuntimeUpdate(v: unknown): DefaultRuntimeUpdateData | null;
+interface HealthCheckItemData {
+    id: string;
+    name: string;
+    status: string;
+    message: string;
+    lastCheck: string;
+}
+export interface ConfigReadinessData {
+    checks: HealthCheckItemData[];
+    generatedAt: string;
+}
+export declare function validateConfigReadiness(v: unknown): ConfigReadinessData | null;
+export interface StagnationSignalData {
+    type: string;
+    principleId: string;
+    daysSince: number;
+}
+export interface DegradedSignalData {
+    reasonCode: string;
+    nextActionCode: string;
+    reason: string;
+    nextAction: string;
+    source: string;
+}
+export interface GovernanceQueueData {
+    pendingReviewCount: number;
+    behaviorDeviationCount: number;
+    stagnationSignals: StagnationSignalData[];
+    governanceState: 'none' | 'in_progress' | 'owner_review_ready' | 'degraded';
+    stateReasonCode: string;
+    nextActionCode: string;
+    stateReason: string;
+    nextAction: string;
+    inProgressSummary?: string;
+    degradedSignals?: DegradedSignalData[];
+    note?: string;
+    generatedAt?: string;
+}
+export declare function validateGovernanceQueue(v: unknown): GovernanceQueueData | null;
+export interface ActivationRecordData {
+    id: string;
+    artifactId: string;
+    principleId: string;
+    channel: string;
+    action: string;
+    targetRef: string;
+    activatedAt: string | null;
+    status: string;
+}
+export interface ActivationsData {
+    activations: ActivationRecordData[];
+    generatedAt: string;
+    note?: string;
+}
+export declare function validateActivations(v: unknown): ActivationsData | null;
+export interface DisableActivationData {
+    activationId: string;
+    status: string;
+}
+export declare function validateDisableActivation(v: unknown): DisableActivationData | null;
+export interface LifecycleAdherenceData {
+    insufficientData: boolean;
+    rate: number | null;
+    note: string;
+}
+export interface LifecycleRuleMetricData {
+    ruleId: string;
+    triggered: number;
+    lastTriggeredAt: string | null;
+}
+export interface LifecycleMetricsData {
+    principleId: string;
+    adherence: LifecycleAdherenceData;
+    ruleMetrics: LifecycleRuleMetricData[];
+}
+export declare function validateLifecycleMetrics(v: unknown): LifecycleMetricsData | null;
+export interface UpdateStatusData {
+    currentVersion: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+    lastChecked: string;
+}
+export declare function validateUpdateStatus(v: unknown): UpdateStatusData | null;
+export interface UpdateHistoryEntryData {
+    version: string;
+    appliedAt: string;
+    notes: string;
+}
+export interface UpdateHistoryData {
+    updates: UpdateHistoryEntryData[];
+}
+export declare function validateUpdateHistory(v: unknown): UpdateHistoryData | null;
+export interface ApprovalRecordData {
+    approvalId: string;
+    artifactId: string;
+    channel: string;
+    riskLevel: string;
+    status: string;
+    confidence: number | undefined;
+    requestedAt: string;
+    decidedAt: string | undefined;
+    decidedBy: string | undefined;
+    decisionNote: string | undefined;
+    rejectionReason: string | undefined;
+    summary: string | undefined;
+    triggerReason: string | undefined;
+    confidenceLabel: string | undefined;
+    confidenceExplanation: string | undefined;
+    effectDescription: string | undefined;
+    rejectionEffect: string | undefined;
+    isMvpProven?: boolean;
+}
+declare function validateApprovalRecord(v: unknown): ApprovalRecordData | null;
+export interface ApprovalListResultData {
+    items: ApprovalRecordData[];
+    total: number;
+    stats: {
+        pending: number;
+        approved: number;
+        rejected: number;
+        cancelled: number;
+    };
+}
+export declare function validateApprovalListResult(v: unknown): ApprovalListResultData | null;
+export { validateApprovalRecord as validateApprovalRecordDirect };
+export interface PrincipleListItemData {
+    id: string;
+    text: string;
+    triggerPattern: string;
+    action: string;
+    status: string;
+    priority: string;
+    scope: string;
+    domain: string | null;
+    evaluability: string;
+    valueScore: number;
+    adherenceRate: number;
+    painPreventedCount: number;
+    ruleCount: number;
+    conflictsWithCount: number;
+    createdAt: string;
+    updatedAt: string;
+    /** PRI-332: Detected language of the principle text */
+    detectedLanguage: string;
+    /** PRI-332 P1-5: Structured readability warning code */
+    readabilityWarningCode?: 'technical_pattern' | 'diagnostic_residue' | 'title_too_long';
+}
+export interface PrinciplesListData {
+    principles: PrincipleListItemData[];
+    summary: {
+        candidate: number;
+        probation: number;
+        active: number;
+        deprecated: number;
+        archived: number;
+        total: number;
+    };
+    categories?: Record<string, number>;
+    /** If the approval cross-check was unavailable, this explains why (ERR-002) */
+    approvalCrossCheckUnavailable?: string;
+}
+export declare function validatePrinciplesList(v: unknown): PrinciplesListData | null;
+export interface ApprovalGroupRecordData {
+    id: string;
+    artifactId: string;
+    channel: string;
+    createdAt: string;
+}
+export interface ApprovalGroupData {
+    principleId: string;
+    principleTitle: string;
+    status: string;
+    records: ApprovalGroupRecordData[];
+}
+export interface ApprovalsGroupedData {
+    groups: ApprovalGroupData[];
+    generatedAt: string;
+    note?: string;
+}
+export declare function validateApprovalsGrouped(v: unknown): ApprovalsGroupedData | null;
+export type EvidenceChainStateData = 'evidence_only' | 'pain_recorded' | 'diagnosis_queued' | 'diagnosis_running' | 'diagnosis_succeeded' | 'diagnosis_failed' | 'diagnosis_retry_wait' | 'candidate_generated' | 'internalization_started';
+export interface EvidenceChainRecordData {
+    id: string;
+    sourceKind: string;
+    observedAt: string;
+    state: EvidenceChainStateData;
+    summary: string;
+    admissionDecision?: string;
+    linkedPainId?: string;
+    linkedTaskId?: string;
+    linkedTaskStatus?: string;
+    linkedCandidateId?: string;
+    linkedPrincipleId?: string;
+    failureReason?: string;
+    degradedReason?: string;
+    nextAction?: string;
+}
+export interface EvidenceChainData {
+    records: EvidenceChainRecordData[];
+    generatedAt: string;
+    degradedReason?: string;
+    nextAction?: string;
+    note?: string;
+}
+export declare function validateEvidenceChain(v: unknown): EvidenceChainData | null;
+export interface OutputLanguageData {
+    outputLanguage: string;
+    source: string;
+}
+export declare function validateOutputLanguage(v: unknown): OutputLanguageData | null;