create-principles-disciple 1.94.0 → 1.96.0

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

@@ -19,6 +19,7 @@
 export interface ErrorResponse {
     error?: string;
     message?: string;
+    reason?: string;
     nextAction?: string;
 }
 export declare function validateErrorResponse(v: unknown): ErrorResponse | null;
@@ -127,6 +128,11 @@ export interface AgentBindingUpdateData {
     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;
@@ -354,7 +360,138 @@ export interface EvidenceChainRecordData {
     /** PRI-380: internalization task linkage */
     internalizationTaskId?: string;
     dreamerTaskStatus?: string;
+    /** PRI-469: optional intent tension from diagnostician artifact (SPEC §16). */
+    intentTension?: IntentTensionData;
+}
+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;
@@ -404,3 +541,66 @@ export interface TrajectoryData {
     };
 }
 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;