create-principles-disciple 1.145.11 → 1.145.13

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

@@ -655,6 +655,12 @@ export interface ApprovalGroupData {
         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

package/console/dist/ui/utils/validators.js

@@ -66,6 +66,30 @@ function isGovernanceTimestamp(value) {
 function hasOwnFields(value, fields) {
     return fields.every(field => Object.hasOwn(value, field));
 }
+const PROMPT_BUDGET_FALLBACK_REASONS = new Set([
+    'host_capacity_absent',
+    'host_capacity_source_untrusted',
+    'host_capacity_invalid_value',
+    'catalog_unavailable',
+    'model_identity_absent',
+    'catalog_no_exact_match',
+    'catalog_no_match_for_model_id',
+    'catalog_ambiguous_model_id',
+    'catalog_provider_absent',
+    'catalog_metadata_invalid',
+    // PRI-1017: console-side bounded code — a runtime observation exists but
+    // is too old to be presented as the current budget.
+    'runtime_budget_observation_stale',
+]);
+function isPromptBudgetFallbackReason(value) {
+    return isString(value) && PROMPT_BUDGET_FALLBACK_REASONS.has(value);
+}
+function isPromptBudgetCapacitySource(value) {
+    return value === 'host_effective_window' || value === 'pi_catalog_exact' || value === 'legacy_fallback';
+}
+function isPromptBudgetCapacityStatus(value) {
+    return value === 'confirmed' || value === 'unknown';
+}
 function isStringEnum(value, allowed) {
     return typeof value === 'string' && allowed.has(value);
 }
@@ -1061,7 +1085,7 @@ export function validateGovernanceQueue(v) {
     return result;
 }
 const PROMPT_INJECTION_STATUS_KINDS = new Set([
-    'injectable', 'oversized', 'window_excluded', 'resolution_failed', 'route_unconfirmed',
+    'injectable', 'oversized', 'model_dependent', 'window_excluded', 'resolution_failed', 'route_unconfirmed',
 ]);
 /** rc-1..rc-4: validate the per-activation injection status as untrusted input. */
 function validatePromptActivationInjectionStatus(v) {
@@ -1089,9 +1113,10 @@ function validatePromptActivationInjectionStatus(v) {
         for (const entry of v.perHostFits) {
             if (!isObject(entry))
                 return null;
-            if ((entry.hostKind !== 'openclaw' && entry.hostKind !== 'codex' && entry.hostKind !== 'workbuddy') || typeof entry.fits !== 'boolean')
+            if ((entry.hostKind !== 'openclaw' && entry.hostKind !== 'codex' && entry.hostKind !== 'workbuddy')
+                || (entry.tierFit !== 'fits_all_tiers' && entry.tierFit !== 'model_dependent' && entry.tierFit !== 'exceeds_max_tier'))
                 return null;
-            perHostFits.push({ hostKind: entry.hostKind, fits: entry.fits });
+            perHostFits.push({ hostKind: entry.hostKind, tierFit: entry.tierFit });
         }
         result.perHostFits = perHostFits;
     }
@@ -1162,6 +1187,24 @@ export function validateActivations(v) {
                 summary.nextAction = route.nextAction;
             if (Object.hasOwn(route, 'globalReason') && isString(route.globalReason))
                 summary.globalReason = route.globalReason;
+            // PRI-1017: runtime budget observation timestamp the per-row budget
+            // figures were computed under (additive, drop-on-invalid).
+            if (Object.hasOwn(route, 'budgetObservedAt') && isString(route.budgetObservedAt) && route.budgetObservedAt.length > 0 && Number.isFinite(Date.parse(route.budgetObservedAt))) {
+                summary.budgetObservedAt = route.budgetObservedAt;
+            }
+            if (Object.hasOwn(route, 'budgetCapacitySource') && isPromptBudgetCapacitySource(route.budgetCapacitySource)) {
+                summary.budgetCapacitySource = route.budgetCapacitySource;
+            }
+            if (Object.hasOwn(route, 'budgetCapacityStatus') && isPromptBudgetCapacityStatus(route.budgetCapacityStatus)) {
+                summary.budgetCapacityStatus = route.budgetCapacityStatus;
+            }
+            if (Object.hasOwn(route, 'budgetContextWindowTokens') && typeof route.budgetContextWindowTokens === 'number'
+                && Number.isInteger(route.budgetContextWindowTokens) && route.budgetContextWindowTokens > 0) {
+                summary.budgetContextWindowTokens = route.budgetContextWindowTokens;
+            }
+            if (Object.hasOwn(route, 'budgetFallbackReason') && isPromptBudgetFallbackReason(route.budgetFallbackReason)) {
+                summary.budgetFallbackReason = route.budgetFallbackReason;
+            }
             result.promptInjectionRoute = summary;
         }
     }
@@ -1743,6 +1786,13 @@ function validateApprovalGroup(v) {
     if (Object.hasOwn(v, 'fitsPromptBudget') && typeof v.fitsPromptBudget === 'boolean') {
         result.fitsPromptBudget = v.fitsPromptBudget;
     }
+    // SPEC-PD-MODEL-AWARE-PROMPT-BUDGET-001: optional tier fit, whitelist +
+    // drop-on-invalid (same rule). Absent keeps the boolean-only behavior.
+    if (Object.hasOwn(v, 'promptBudgetTierFit')
+        && (v.promptBudgetTierFit === 'fits_all_tiers' || v.promptBudgetTierFit === 'model_dependent'
+            || v.promptBudgetTierFit === 'exceeds_max_tier' || v.promptBudgetTierFit === 'unconfirmed')) {
+        result.promptBudgetTierFit = v.promptBudgetTierFit;
+    }
     // PRI-940: optional artifactUnavailable. Only a real boolean is propagated; a
     // present-but-wrong value is dropped so the card keeps its plain untitled
     // fallback rather than rendering an unverified claim.
@@ -1806,6 +1856,26 @@ export function validatePromptInjectionBudgetStatus(v) {
     if (Object.hasOwn(v, 'nextAction') && isString(v.nextAction)) {
         result.nextAction = v.nextAction;
     }
+    // SPEC-PD-MODEL-AWARE-PROMPT-BUDGET-001 §7: budget provenance, additive +
+    // drop-on-invalid. Absent behaves as the legacy fixed-budget view
+    // (pre-SPEC server compat).
+    if (Object.hasOwn(v, 'budgetCapacitySource') && isPromptBudgetCapacitySource(v.budgetCapacitySource)) {
+        result.budgetCapacitySource = v.budgetCapacitySource;
+    }
+    if (Object.hasOwn(v, 'budgetFallbackReason') && isPromptBudgetFallbackReason(v.budgetFallbackReason)) {
+        result.budgetFallbackReason = v.budgetFallbackReason;
+    }
+    if (Object.hasOwn(v, 'budgetCapacityStatus') && isPromptBudgetCapacityStatus(v.budgetCapacityStatus)) {
+        result.budgetCapacityStatus = v.budgetCapacityStatus;
+    }
+    if (Object.hasOwn(v, 'budgetContextWindowTokens') && typeof v.budgetContextWindowTokens === 'number' && Number.isInteger(v.budgetContextWindowTokens) && v.budgetContextWindowTokens > 0) {
+        result.budgetContextWindowTokens = v.budgetContextWindowTokens;
+    }
+    // PRI-1017: observation timestamp — a PAST runtime fact, never a live
+    // claim. Present-but-invalid drops (rc-1/rc-2), never propagated.
+    if (Object.hasOwn(v, 'budgetObservedAt') && isString(v.budgetObservedAt) && v.budgetObservedAt.length > 0 && Number.isFinite(Date.parse(v.budgetObservedAt))) {
+        result.budgetObservedAt = v.budgetObservedAt;
+    }
     if (Object.hasOwn(v, 'perHost') && Array.isArray(v.perHost)) {
         // rc-4: validate every element, not just "is array".
         const perHost = [];
@@ -1819,7 +1889,26 @@ export function validatePromptInjectionBudgetStatus(v) {
                 || typeof hostTruncated !== 'boolean') {
                 return null;
             }
-            perHost.push({ hostKind, route, usedChars: hostUsed, truncated: hostTruncated });
+            const forecast = { hostKind, route, usedChars: hostUsed, truncated: hostTruncated };
+            // PRI-1017: per-host budget basis (additive, drop-on-invalid). Absent
+            // behaves as the pre-PRI-1017 payload where the headline budget was
+            // shared — the UI must not present one host's window as another's.
+            if (Object.hasOwn(entry, 'budget') && typeof entry.budget === 'number' && Number.isInteger(entry.budget) && entry.budget > 0) {
+                forecast.budget = entry.budget;
+            }
+            if (Object.hasOwn(entry, 'budgetCapacitySource') && isPromptBudgetCapacitySource(entry.budgetCapacitySource)) {
+                forecast.budgetCapacitySource = entry.budgetCapacitySource;
+            }
+            if (Object.hasOwn(entry, 'budgetCapacityStatus') && isPromptBudgetCapacityStatus(entry.budgetCapacityStatus)) {
+                forecast.budgetCapacityStatus = entry.budgetCapacityStatus;
+            }
+            if (Object.hasOwn(entry, 'budgetObservedAt') && isString(entry.budgetObservedAt) && entry.budgetObservedAt.length > 0 && Number.isFinite(Date.parse(entry.budgetObservedAt))) {
+                forecast.budgetObservedAt = entry.budgetObservedAt;
+            }
+            if (Object.hasOwn(entry, 'budgetFallbackReason') && isPromptBudgetFallbackReason(entry.budgetFallbackReason)) {
+                forecast.budgetFallbackReason = entry.budgetFallbackReason;
+            }
+            perHost.push(forecast);
         }
         result.perHost = perHost;
     }