create-principles-disciple 1.146.4 → 1.146.7

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

@@ -1,1178 +0,0 @@
-/**
- * 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)
- */
-import type { GovernanceExperienceSnapshot, OwnerGovernanceView, OwnerDecisionViewCore } from '@principles/core/runtime-v2';
-/** Browser-local structural type for the compact inbox response (SPEC §11.1). */
-export interface OwnerDecisionInboxData {
-    schemaVersion: '1';
-    generatedAt: string;
-    totalPrinciples: number;
-    groups: {
-        decision: {
-            principleId: string;
-            decisionState: string;
-            learnedPrinciple: {
-                status: 'known';
-                text: string;
-            } | {
-                status: 'unknown';
-                reasonText: string;
-            };
-            inbox: {
-                group: string;
-                attention: string;
-            };
-            blockerCodes: string[];
-            nextAction: {
-                ownerText: string;
-            };
-        }[];
-        blocked: {
-            principleId: string;
-            decisionState: string;
-            learnedPrinciple: {
-                status: 'known';
-                text: string;
-            } | {
-                status: 'unknown';
-                reasonText: string;
-            };
-            inbox: {
-                group: string;
-                attention: string;
-            };
-            blockerCodes: string[];
-            nextAction: {
-                ownerText: string;
-            };
-        }[];
-        recovery: {
-            principleId: string;
-            decisionState: string;
-            learnedPrinciple: {
-                status: 'known';
-                text: string;
-            } | {
-                status: 'unknown';
-                reasonText: string;
-            };
-            inbox: {
-                group: string;
-                attention: string;
-            };
-            blockerCodes: string[];
-            nextAction: {
-                ownerText: string;
-            };
-        }[];
-    };
-    historicalUnknown: {
-        count: number;
-        reasonText: string;
-    };
-    degraded?: {
-        reason: string;
-        nextAction: string;
-    };
-}
-import type { FeedbackChannelId } from '../../shared/feedback-channel-ids.js';
-import type { FeedbackChannelStatus, FeedbackChannelsData, FeedbackSubmitResult } from '../../shared/feedback-contract.js';
-export type { FeedbackChannelId, FeedbackChannelStatus, FeedbackChannelsData, FeedbackSubmitResult };
-import type { PromptInjectionBudgetStatus, PromptActivationInjectionStatusWire, PromptInjectionRouteSummaryWire } from '../../shared/prompt-injection-contract.js';
-export type { PromptInjectionBudgetStatus };
-export declare function validateOwnerGovernanceView(value: unknown): OwnerGovernanceView | null;
-export declare function isOwnerDecisionViewCore(value: unknown): value is OwnerDecisionViewCore;
-export declare function validateOwnerDecisionViewCore(value: unknown): OwnerDecisionViewCore | null;
-export declare function isOwnerDecisionInbox(value: unknown): value is OwnerDecisionInboxData;
-export declare function validateOwnerDecisionInbox(value: unknown): OwnerDecisionInboxData | null;
-/** Browser-local structural type for the compact library projection (SPEC §11.2). */
-export interface OwnerDecisionLibraryData {
-    schemaVersion: '1';
-    generatedAt: string;
-    entries: Record<string, {
-        decisionState: string;
-        learnedPrinciple: {
-            status: 'known';
-            text: string;
-            sourceTier: string;
-        } | {
-            status: 'unknown';
-            reasonText: string;
-        };
-    }>;
-    degraded?: {
-        reason: string;
-    };
-}
-export declare function isOwnerDecisionLibrary(value: unknown): value is OwnerDecisionLibraryData;
-export declare function validateOwnerDecisionLibrary(value: unknown): OwnerDecisionLibraryData | null;
-export declare function validateGovernanceExperienceSnapshot(value: unknown): GovernanceExperienceSnapshot | null;
-/**
- * Best-effort error envelope validator.
- *
- * 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;
-    reason?: 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;
-/** Legacy UI alias for the shared contract type. */
-export type FeedbackChannelStatusData = FeedbackChannelStatus;
-/** Legacy UI alias for the shared contract type. */
-export type FeedbackSubmitResultData = FeedbackSubmitResult;
-export declare function validateFeedbackChannels(v: unknown): FeedbackChannelsData | null;
-export declare function validateFeedbackSubmitResult(v: unknown): FeedbackSubmitResultData | 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;
-    provider?: string;
-    model?: 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 FeatureFlagUpdateData {
-    feature: string;
-    enabled: boolean;
-}
-export declare function validateFeatureFlagUpdate(v: unknown): FeatureFlagUpdateData | 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;
-/**
- * Response shape for create/update/delete runtime profile endpoints.
- *
- * Server returns `{ profileId: string, profile: { type, provider?, model?, ... } }`.
- * We validate the contract fields (profileId + profile.type) loudly and accept
- * the rest of the profile object as a string-indexed record, since the patch
- * surface is open (timeoutMs, maxRetries, baseUrl, source, etc.). The page only
- * needs profileId to confirm the target; it re-fetches the catalog for display.
- *
- * rc-1: input treated as unknown.
- * rc-2: no `as` bypass — uses Object.hasOwn + typeof guards.
- * rc-3: profileId + profile.type are required and fail loud.
- * rc-5: Object.hasOwn for untrusted keys.
- */
-export interface RuntimeProfileMutationData {
-    profileId: string;
-    profile: {
-        type: string;
-        [key: string]: unknown;
-    };
-}
-export declare function validateRuntimeProfileMutation(v: unknown): RuntimeProfileMutationData | 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;
-    /** Governance Recovery Actions v1: needs_human_review internalization tasks (owner-attention items) */
-    pendingHumanReviewCount?: number;
-    stagnationSignals: StagnationSignalData[];
-    governanceState: 'none' | 'in_progress' | 'owner_review_ready' | 'degraded';
-    stateReasonCode: string;
-    nextActionCode: string;
-    stateReason: string;
-    nextAction: string;
-    inProgressSummary?: string;
-    degradedSignals?: DegradedSignalData[];
-    evidenceInProgressCount?: number;
-    gateBlocksToday?: number;
-    note?: string;
-    generatedAt?: string;
-}
-/** One execution attempt of a failed task (RunRecord projection). */
-export interface FailedTaskDetailRun {
-    runId: string;
-    /** Owning task id — validated to equal the detail's taskId (rc-6 lineage). */
-    taskId: string;
-    attemptNumber: number;
-    executionStatus: string;
-    startedAt: string;
-    endedAt: string | null;
-    reason: string | null;
-    errorCategory: string | null;
-}
-/** Validated shape of GET /api/v1/failed-tasks/:id. */
-export interface FailedTaskDetailData {
-    taskId: string;
-    taskKind: string;
-    status: string;
-    createdAt: string;
-    updatedAt: string;
-    attemptCount: number;
-    maxAttempts: number;
-    lastError: string | null;
-    runs: FailedTaskDetailRun[];
-}
-export declare function validateFailedTaskDetail(v: unknown): FailedTaskDetailData | null;
-export interface RecoveryResultData {
-    taskId: string;
-    previousStatus: string;
-    newStatus: string;
-    /** 'recovered' (failed→pending) | 'requeued' (needs_human_review→pending) */
-    result: string;
-    /** True when the recovery force-reset an exhausted attempt budget */
-    forceApplied?: boolean;
-    nextAction?: string;
-}
-export declare function validateRecoveryResult(v: unknown): RecoveryResultData | null;
-export declare function validateGovernanceQueue(v: unknown): GovernanceQueueData | null;
-export interface ActivationRecordData {
-    activationId: string;
-    artifactId: string;
-    principleId: string;
-    channel: string;
-    action: string;
-    targetRef: string;
-    activatedAt: string | null;
-    status: string;
-    enforcement?: 'eligible' | 'safety_isolated';
-    legacyDecisionUnknown?: boolean;
-    ownerReviewDueAt?: string;
-    /** PD_PROMPT_CAPACITY_V1 R-A3: injection status for live prompt activations. */
-    promptInjection?: PromptActivationInjectionStatusWire;
-}
-export interface ActivationsData {
-    activations: ActivationRecordData[];
-    status: string;
-    reason?: string;
-    nextAction?: string;
-    promptInjectionRoute?: PromptInjectionRouteSummaryWire;
-}
-export declare function validateActivations(v: unknown): ActivationsData | null;
-export interface DisableActivationData {
-    activationId: string;
-    status: string;
-}
-export interface RuleCodeOwnerReviewData {
-    activation: {
-        activationId: string;
-        artifactId: string;
-        action: string;
-    };
-    artifact: {
-        artifactId: string;
-        digest: string;
-        content: Record<string, unknown> | null;
-    };
-    readiness: {
-        status: 'ready' | 'evidence_insufficient' | 'blocked' | 'unavailable';
-        evaluationId: string;
-        failedChecks: {
-            checkId: string;
-            reasonCode: string;
-        }[];
-        evidenceSnapshot: {
-            snapshotDigest: string;
-            shadowSummary: RuleCodeShadowSummaryData;
-            safetyGateResults: {
-                checkId: string;
-                status: 'passed' | 'failed';
-                reasonCode?: string;
-            }[];
-        };
-    };
-    controlState: {
-        enforcement: 'eligible' | 'safety_isolated';
-        version: number;
-    } | null;
-    globalPause: {
-        pauseId: string;
-        status: 'paused' | 'released';
-        version: number;
-    } | null;
-    decisions: RuleCodeOwnerDecisionData[];
-    ownerDecisionEnabled: boolean;
-    runtimeCapability: {
-        hostRuntimeVersion: string;
-        shadowEvidence: boolean;
-    };
-    liveMetrics: {
-        last24Hours: RuleCodeTelemetryWindowData;
-        last7Days: RuleCodeTelemetryWindowData;
-        representativeSamples: {
-            toolName: string;
-            decision: string;
-            pathCategory: string;
-        }[];
-    };
-    behaviorDrift: {
-        approvedBlockRate: number | null;
-        liveBlockRate: number | null;
-        delta: number | null;
-    };
-}
-interface RuleCodeOwnerDecisionData {
-    decisionId: string;
-    decision: string;
-    principalKind: string;
-    actorId: string;
-    authenticationMethod: string;
-    reasonCode: string;
-    note: string | null;
-    decidedAt: string;
-}
-interface RuleCodeShadowSummaryData {
-    observed: number | null;
-    matched: number | null;
-    wouldBlock: number | null;
-    wouldAllow: number | null;
-    requireApproval: number | null;
-    autoCorrect: number | null;
-    errors: number | null;
-    neutralControl: number | null;
-    firstObservedAt: string | null;
-    lastObservedAt: string | null;
-}
-interface RuleCodeTelemetryWindowData {
-    eligible: number | null;
-    matched: number | null;
-    blocked: number | null;
-    unhealthy: number | null;
-    circuitTrips: number;
-    toolDistribution: Record<string, number> | null;
-}
-export declare function validateRuleCodeOwnerReview(v: unknown): RuleCodeOwnerReviewData | null;
-export interface RuleCodeMutationData {
-    decisionId?: string;
-    activationId?: string;
-    status?: string;
-    pauseId?: string;
-    version?: number;
-}
-export declare function validateRuleCodeMutation(v: unknown): RuleCodeMutationData | null;
-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;
-    hasUpdate: boolean;
-    /** PRI-848 (SPEC §12.1): explicit state; optional while servers older than the state contract are possible. */
-    state?: 'up_to_date' | 'update_available' | 'update_blocked' | 'check_failed';
-    error?: string;
-    /** Owner-facing explanation carried by blocked checks (policy refusal message). */
-    message?: string;
-    /** PRI-738 legacy-updater retirement: why a check degraded / what to do next. */
-    reason?: string;
-    nextAction?: string;
-    /** PR-C: present on governed checks — the reported currentVersion comes from the active release identity. */
-    versionSource?: 'active-release' | 'plugin-package';
-    /** PR-C: the plugin-directory copy disagrees with the signed active release. Surfaced, never silently resolved. */
-    identityDivergence?: {
-        activeVersion: string;
-        pluginVersion: string;
-        releaseId: string;
-        generation: number;
-    };
-}
-export declare function validateUpdateStatus(v: unknown): UpdateStatusData | null;
-export interface UpdateHistoryEntryData {
-    id: string;
-    timestamp: string;
-    fromVersion: string;
-    toVersion: string;
-    success: boolean;
-    kind: UpdateHistoryKind;
-    backupPath?: string;
-    reason?: string;
-    nextAction?: string;
-}
-export declare const UPDATE_HISTORY_KINDS: readonly ['update', 'reinstall', 'legacy_migration', 'rollback', 'refusal', 'failure', 'recovery', 'unknown'];
-export type UpdateHistoryKind = (typeof UPDATE_HISTORY_KINDS)[number];
-export declare function validateUpdateHistoryEntry(v: unknown): UpdateHistoryEntryData | null;
-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;
-    /** PRI-890: non-fatal server warnings on the approve response (e.g. prompt
-     * injection budget exclusion). Absent means no warning. */
-    warning?: string;
-}
-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-956 (F15): runtime authority revoked (activations deactivated). */
-    runtimeDeactivated?: boolean;
-    /** 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;
-    /** PRI-956 (F15, D3): if the activations-table query was unavailable, this explains why — runtime status cannot be confirmed */
-    revocationCheckUnavailable?: string;
-}
-export type CorePrincipleLayerData = 'foundational' | 'operating';
-export interface CorePrincipleData {
-    id: string;
-    layer: CorePrincipleLayerData;
-    name: string;
-    nameZh: string;
-    statement: string;
-    statementZh: string;
-}
-export interface CorePrinciplesData {
-    principles: CorePrincipleData[];
-}
-export declare function validateCorePrinciples(v: unknown): CorePrinciplesData | null;
-export declare function validatePrinciplesList(v: unknown): PrinciplesListData | null;
-export interface ApprovalGroupRecordData {
-    id: string;
-    artifactId: string;
-    channel: string;
-    createdAt: string;
-    status: string;
-    /** This record's own revision review is incomplete; absent = no such defect. */
-    revisionReviewUnavailable?: boolean;
-}
-export interface ApprovalGroupData {
-    principleId: string;
-    principleTitle: string;
-    /** Wave 7: human-readable principle text from artifact contentJson, if available */
-    candidateDescription?: string;
-    /**
-     * PR-1894: whether this candidate's own serialized prompt entry fits the
-     * injection budget alone. Absent = unknown, which the badge treats as
-     * "do not promise rotation".
-     */
-    revisionReviewUnavailable?: boolean;
-    revisionReview?: {
-        artifactId?: string;
-        artifactDigest?: string;
-        oldStatement: string;
-        newStatement: string;
-        intentFields: Record<string, string>;
-    };
-    fitsPromptBudget?: boolean;
-    /**
-     * SPEC-PD-MODEL-AWARE-PROMPT-BUDGET-001: honest tier classification of the
-     * candidate's own entry vs the supported budget range. `model_dependent`
-     * qualifies the rotation promise (fits only on larger-context models).
-     */
-    promptBudgetTierFit?: 'fits_all_tiers' | 'model_dependent' | 'exceeds_max_tier' | 'unconfirmed';
-    /**
-     * PRI-940: the pinned artifact is missing from the store, so the card has no
-     * human-readable payload and `principleTitle` carries the synthesized
-     * `unlinked:<artifactId>` machine id, which must never render as a title.
-     */
-    artifactUnavailable?: boolean;
-    status: string;
-    records: ApprovalGroupRecordData[];
-}
-export interface ApprovalsGroupedData {
-    groups: ApprovalGroupData[];
-    generatedAt: string;
-    note?: string;
-    /** PRI-908: prompt-channel injection budget status for the pre-approval forecast. */
-    promptInjection?: PromptInjectionBudgetStatus;
-}
-export declare function validatePromptInjectionBudgetStatus(v: unknown): PromptInjectionBudgetStatus | null;
-export declare function validateApprovalsGrouped(v: unknown): ApprovalsGroupedData | null;
-export type EvidenceChainStateData = 'recorded-only' | 'evidence-only' | 'diagnosis-queued' | 'diagnosis-running' | 'diagnosis-succeeded' | 'diagnosis-failed' | 'diagnosis-retry-wait' | 'candidate-generated' | 'internalization-missing' | 'internalization-pending' | 'internalization-running' | 'internalization-failed' | 'internalization-succeeded' | 'owner-reviewable' | 'malformed' | 'degraded';
-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;
-    /** PRI-340: human-readable evidence fields */
-    candidateTitle?: string;
-    candidateSummary?: string;
-    rootCauseSummary?: string;
-    confidence?: number;
-    recommendationKind?: string;
-    /** PRI-380: internalization task linkage */
-    internalizationTaskId?: string;
-    dreamerTaskStatus?: string;
-    /** PRI-469: optional intent tension from diagnostician artifact (SPEC §16). */
-    intentTension?: IntentTensionData;
-    /** PRI-625 Slice D: evidence host attribution — openclaw | codex | workbuddy | unknown. */
-    hostKind?: 'openclaw' | 'codex' | 'workbuddy' | 'unknown';
-}
-export interface IntentTensionData {
-    source: string;
-    evidenceStrength: string;
-    relatedIntentFields: string[];
-    evidence: string[];
-    explanation: string;
-    suggestedOwnerAction: string;
-    intentDocHash?: string;
-}
-/**
- * Validate an untrusted `intentTension` object from the EvidenceChain API
- * response. Returns `null` when malformed; the caller (validateEvidenceChainRecord)
- * treats a `null` intentTension as "not present" so the record is still usable.
- *
- * SPEC §16.3: `confidence` is forbidden — explicitly rejected here.
- * SPEC §16.4: evidence is capped at 3 items; we accept up to 3 and reject
- * arrays with non-string elements (ERR-005/007).
- */
-export declare function validateIntentTension(v: unknown): IntentTensionData | null;
-export interface IntentDecisionRecordData {
-    id: string;
-    painId?: string;
-    taskId?: string;
-    runId?: string;
-    intentDocHash?: string;
-    source: string;
-    evidenceStrength: string;
-    relatedIntentFields: string[];
-    ownerAction: string;
-    evidenceRefs: string[];
-    resultingCandidateId?: string;
-    resultingRuleCandidateId?: string;
-    patchProposalId?: string;
-    createdAt: string;
-}
-/**
- * Validate an untrusted IntentDecisionRecord object from the API.
- * Returns null when malformed (Rule 3: fail loud on missing/wrong-type fields).
- *
- * Enum fields (source, evidenceStrength, ownerAction) are validated against
- * the same sets used by validateIntentTension. relatedIntentFields elements
- * are validated against VALID_INTENT_RELATED_FIELDS.
- */
-export declare function validateIntentDecisionRecord(v: unknown): IntentDecisionRecordData | null;
-/**
- * Validate a list of IntentDecisionRecord objects. Returns null if any
- * element is malformed (ERR-005/007: validate array element types).
- */
-export declare function validateIntentDecisionList(v: unknown): IntentDecisionRecordData[] | null;
-export interface IntentDecisionResultData {
-    record: IntentDecisionRecordData;
-    created: boolean;
-}
-/**
- * Validate the POST /api/v1/intent-decisions response envelope.
- * Shape: { record: IntentDecisionRecord, created: boolean }
- */
-export declare function validateIntentDecisionResult(v: unknown): IntentDecisionResultData | null;
-export interface IntentDecisionSummaryData {
-    counts: {
-        confirm_drift: number;
-        revise_intent: number;
-        observe: number;
-        dismiss: number;
-        promote_to_principle: number;
-        promote_to_rulehost: number;
-    };
-    lastDecisionAt: string | null;
-}
-/**
- * Validate the GET /api/v1/intent-decisions/summary response.
- * All 6 count keys must be present with non-negative finite numbers.
- * lastDecisionAt: null is valid, string is valid, anything else returns null.
- */
-export declare function validateIntentDecisionSummary(v: unknown): IntentDecisionSummaryData | null;
-export type FollowUpResponseType = 'link_candidate' | 'guide_rulehost' | 'generate_patch_proposal';
-/**
- * Response for `link_candidate` follow-up.
- * - `record` is the updated IntentDecisionRecord with `resultingCandidateId` set.
- * - `linkedCandidateId` echoes the candidate id that was linked.
- */
-export interface LinkCandidateFollowUpData {
-    type: 'link_candidate';
-    decisionId: string;
-    record: IntentDecisionRecordData;
-    linkedCandidateId: string;
-}
-/**
- * Response for `guide_rulehost` follow-up.
- * - `cliCommand` is the command the Owner should run in their terminal.
- * - `note` explains what happens next (RuleHost approval will be created).
- *
- * No DB write occurs for this follow-up type — the response is pure guidance.
- */
-export interface GuideRulehostFollowUpData {
-    type: 'guide_rulehost';
-    decisionId: string;
-    cliCommand: string;
-    note: string;
-}
-/**
- * Response for `generate_patch_proposal` follow-up.
- * - `record` is the updated IntentDecisionRecord with `patchProposalId` set.
- * - `patchProposal.markdown` is the SPEC §10 formatted proposal text.
- *
- * The proposal is read-only — PD never auto-applies it to `.principles/INTENT.md`.
- */
-export interface GeneratePatchProposalFollowUpData {
-    type: 'generate_patch_proposal';
-    decisionId: string;
-    record: IntentDecisionRecordData;
-    patchProposal: {
-        id: string;
-        markdown: string;
-    };
-}
-export type FollowUpResponseData = LinkCandidateFollowUpData | GuideRulehostFollowUpData | GeneratePatchProposalFollowUpData;
-/**
- * Validate the POST /api/v1/intent-decisions/:id/follow-up response.
- *
- * The response is a discriminated union on the `type` field. Each branch has
- * its own required fields (Rule 3: fail loud on missing required fields).
- *
- * Common required fields: `type`, `decisionId`.
- * - link_candidate: + `record` (IntentDecisionRecordData), `linkedCandidateId`
- * - guide_rulehost: + `cliCommand`, `note`
- * - generate_patch_proposal: + `record`, `patchProposal: { id, markdown }`
- */
-export declare function validateFollowUpResponse(v: unknown): FollowUpResponseData | null;
-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;
-export interface ApplyUpdateResultData {
-    success: boolean;
-    message: string;
-    /** PRI-848 (SPEC §12.1): a policy refusal is a structured non-success, never a success-shaped "no update applied". */
-    refusal?: boolean;
-    /** PRI-848: explicit result state. `update_in_progress` = the detached
-     * executor accepted the transaction; poll the transaction endpoint until it
-     * reaches a terminal phase. */
-    state?: 'update_blocked' | 'awaiting_restart' | 'update_in_progress';
-    /** PRI-848: queryable transaction id of the confirmed update (SPEC §12.1 continuation contract). */
-    transactionId?: string;
-    updatedFiles?: string[];
-    backupPath?: string;
-    newVersion?: string;
-    /** True when the update only covered the OpenClaw plugin (Codex adapter not updated). */
-    partialUpdate?: boolean;
-    /** True when a console restart is needed to load the new code (full update). */
-    requiresRestart?: boolean;
-    /** Structured error reason (e.g. 'file_locked' for EPERM). */
-    reason?: string;
-    /** Suggested next action when the update fails. */
-    nextAction?: string;
-    /** Present when the OpenClaw gateway could not be stopped/restarted around the update (PRI-723). */
-    gatewayNotice?: string;
-}
-export declare function validateApplyUpdateResult(v: unknown): ApplyUpdateResultData | null;
-export interface UpdateRecoveryItem {
-    transactionId: string;
-    lastState: string | null;
-    lastAt: string | null;
-    productVersion: string | null;
-    tornTailDetected: boolean;
-}
-export interface UpdateRecoverySuperseded {
-    transactionId: string;
-    reason: string;
-}
-export interface UpdateRecoveryData {
-    needsRecovery: boolean;
-    unfinished: UpdateRecoveryItem[];
-    broken: {
-        transactionId: string;
-        reason: string;
-    }[];
-    /**
-     * PRI-896: non-terminal journals the live release has already superseded.
-     * Reported separately (rc-9: never a silent drop) but never hold the alarm.
-     */
-    superseded: UpdateRecoverySuperseded[];
-    /**
-     * PRI-1069/1070 (G1 P0-4): terminal `failed` transactions whose detail
-     * carries a restore-inconsistency marker — the physical install is NOT what
-     * the terminal state implies. They stay alarmed until a later completed
-     * install records their recovery.
-     */
-    recoveryRequired: {
-        transactionId: string;
-        reason: string;
-    }[];
-    /**
-     * rc-9 (PRI-896/CR-2): active.json could not be read, so recovery had no
-     * live-release evidence and every non-terminal journal is conservatively an
-     * alarm. When true the alarm is retained for lack of a readable active
-     * record — repair active.json rather than the journals.
-     */
-    activeRecordUnreadable?: boolean;
-    nextAction?: string;
-}
-export declare function validateUpdateRecovery(v: unknown): UpdateRecoveryData | null;
-export interface UpdateTransactionData {
-    transactionId: string;
-    exists: boolean;
-    lastState: string | null;
-    terminal: boolean;
-    tornTailDetected?: boolean;
-    startedAt?: string | null;
-    lastAt?: string | null;
-    productVersion?: string | null;
-    reason?: string;
-}
-export declare function validateUpdateTransaction(v: unknown): UpdateTransactionData | null;
-declare const VALID_STAGE_KEYS: readonly ['evidence', 'diagnosis', 'proposal', 'review', 'deploy', 'behavior'];
-type StageKey = typeof VALID_STAGE_KEYS[number];
-declare const VALID_STAGE_STATUSES: readonly ['available', 'unavailable', 'not_applicable'];
-type StageStatus = typeof VALID_STAGE_STATUSES[number];
-export interface TrajectoryStageData {
-    key: StageKey;
-    status: StageStatus;
-    summary: string;
-    detail?: string;
-    timestamp?: string;
-    unavailableReason?: string;
-    nextAction?: string;
-    meta?: Record<string, unknown>;
-}
-export interface TrajectoryData {
-    principleId: string;
-    stages: TrajectoryStageData[];
-    degraded?: {
-        reason: string;
-        nextAction: string;
-    };
-}
-export declare function validateTrajectoryData(v: unknown): TrajectoryData | null;
-export interface IntentDocWarningData {
-    code: string;
-    section?: string;
-    message: string;
-}
-export interface IntentSectionsData {
-    why?: string;
-    desiredOutcome?: string;
-    nonNegotiables?: string;
-    stopEscalation?: string;
-    currentStrategicFocus?: string;
-}
-export interface IntentSummaryData {
-    ok: boolean;
-    found: boolean;
-    flagEnabled: boolean;
-    reason?: string;
-    nextAction?: string;
-    path?: string;
-    contentHash?: string;
-    lastEditedAt?: string;
-    sections?: IntentSectionsData;
-    warnings: IntentDocWarningData[];
-}
-export declare function validateIntentWarning(v: unknown): IntentDocWarningData | null;
-export declare function validateIntentSections(v: unknown): IntentSectionsData | null;
-export declare function validateIntentSummary(v: unknown): IntentSummaryData | null;
-export interface IntentRawContentData {
-    content: string;
-    path: string;
-}
-export declare function validateIntentRawContent(v: unknown): IntentRawContentData | null;
-export interface IntentInitResultData {
-    ok: boolean;
-    created: boolean;
-    path?: string;
-    reason?: string;
-    nextAction?: string;
-}
-export interface IntentSaveResultData {
-    ok: boolean;
-    saved: boolean;
-    path?: string;
-    contentHash?: string;
-    lastEditedAt?: string;
-    warnings?: IntentDocWarningData[];
-    reason?: string;
-    nextAction?: string;
-}
-export declare function validateIntentInitResult(v: unknown): IntentInitResultData | null;
-export declare function validateIntentSaveResult(v: unknown): IntentSaveResultData | null;
-export interface IntentVersionEntry {
-    id: string;
-    lang: string;
-    contentHash: string;
-    contentSnapshot: string;
-    reason: string;
-    createdAt: string;
-}
-export interface IntentVersionData {
-    versions: IntentVersionEntry[];
-}
-export declare function validateIntentVersions(v: unknown): IntentVersionData | null;
-export interface OwnerIdentityResolvedData {
-    ownerId: string | null;
-    credentialId: string | null;
-    source: 'env' | 'file' | 'none' | 'invalid_env';
-    /** Machine-readable reason (partial env pair, unreadable file). No identity values. */
-    error?: string;
-}
-export interface OwnerIdentityRecordData {
-    schemaVersion: number;
-    ownerId: string;
-    credentialId: string;
-    registeredAt: string;
-}
-/** Canonical governance readiness — mirrors core OwnerConfigSnapshot. */
-export interface OwnerGovernanceReadinessData {
-    authenticationMode: 'authenticated' | 'no_auth';
-    ownerIdentityConfiguration: 'configured' | 'missing' | 'invalid';
-}
-export interface OwnerIdentityViewData {
-    resolved: OwnerIdentityResolvedData;
-    fileRecord: OwnerIdentityRecordData | null;
-    fileError?: string;
-    governance: OwnerGovernanceReadinessData;
-}
-export declare function validateOwnerIdentityView(v: unknown): OwnerIdentityViewData | null;
-export interface OwnerIdentityRegisterData {
-    record: OwnerIdentityRecordData;
-    source: 'file';
-    governance: OwnerGovernanceReadinessData;
-}
-export declare function validateOwnerIdentityRegister(v: unknown): OwnerIdentityRegisterData | null;
-export interface OwnerIdentityUnregisterData {
-    ok: boolean;
-    source: 'none';
-    governance: OwnerGovernanceReadinessData;
-}
-export declare function validateOwnerIdentityUnregister(v: unknown): OwnerIdentityUnregisterData | null;
-export interface OwnerDecisionItemData {
-    reviewKey: string;
-    kind: string;
-    taskId: string;
-    title: string;
-    summary: string;
-    reasonCode: string;
-    legacy: boolean;
-    allowedActions: string[];
-    expectedRevisionEpoch: number;
-    expectedSourceRunId: string;
-    expectedSourceArtifactId: string;
-    expectedSourceArtifactHash: string;
-    expectedEvidenceDigest?: string;
-    review?: OwnerDecisionReviewData;
-    evidenceUnavailableReason?: string;
-    createdAt: string;
-    machineRecommendation?: string;
-    score?: number;
-    principleId?: string;
-}
-export interface OwnerDecisionReviewData {
-    brief: {
-        kind: 'evaluator' | 'rollout';
-        principle?: {
-            title?: string;
-            statement?: string;
-            rationale?: string;
-            scope: string[];
-        };
-        implementation?: {
-            summary?: string;
-            affectedTools: string[];
-            risks: string[];
-        };
-        summary?: string;
-        strengths?: string[];
-        concerns?: string[];
-        requiredChanges: string[];
-        risks?: string[];
-        score?: number;
-        /** PRI-704 / PRI-703 Phase 4: 5-item deterministic quality checklist (evaluator briefs only). */
-        qualityChecklist?: {
-            schemaVersion: number;
-            items: {
-                id: string;
-                pass: boolean;
-                note: string;
-            }[];
-        };
-        /**
-         * PRI-858: bounded formation evidence behind this decision — OBSERVATION
-         * only. Nothing in here may be used to derive an action or a gate: the
-         * authority stays in `capability` / `evidence.deterministicChecks`.
-         */
-        formationEvidence?: OwnerFormationEvidenceData;
-    };
-    evidence: {
-        completeness: 'complete' | 'partial' | 'insufficient';
-        deterministicChecks: {
-            check: string;
-            status: 'passed' | 'failed' | 'not_run' | 'unavailable';
-        }[];
-        items: {
-            evidenceClass: string;
-            label: string;
-            value: string;
-        }[];
-        digest: string;
-    };
-    capability: {
-        acceptRequirement: {
-            kind: 'none' | 'acknowledge_partial_evidence' | 'forbidden';
-            reasonCode?: string;
-        };
-    };
-}
-/** PRI-858: bounded diagnosis projection carried by the formation evidence. */
-export interface OwnerFormationDiagnosisData {
-    rootCause: string | null;
-    summary: string | null;
-    evidence: {
-        sourceRef: string;
-        note: string;
-    }[];
-}
-/** PRI-858: formation evidence projected onto one Owner decision (display only). */
-export interface OwnerFormationEvidenceData {
-    version: string;
-    sourcePainId: string | null;
-    diagnosis?: OwnerFormationDiagnosisData;
-    provenance: {
-        sourceDreamerArtifactId: string;
-        sourceDiagnosisArtifactId: string | null;
-        sourceDiagnosisTaskId: string | null;
-    };
-    notes: string[];
-}
-export interface OwnerDecisionsData {
-    items: OwnerDecisionItemData[];
-    total: number;
-    generatedAt: string;
-}
-export declare function validateOwnerDecisionItem(v: unknown): OwnerDecisionItemData | null;
-export declare function validateOwnerDecisionsData(v: unknown): OwnerDecisionsData | null;
-export interface OwnerResolutionResultData {
-    status: 'resolved';
-    resolutionId: string;
-    reviewKey: string;
-    action: string;
-    applied: boolean;
-    runnerWillApply: boolean;
-    effectiveDecision?: string;
-    targetTaskId?: string;
-    nextAction?: string;
-}
-export declare function validateOwnerResolutionResult(v: unknown): OwnerResolutionResultData | null;