@babav/knowledge-core-client 0.51.0 → 0.52.0

package/dist/index.d.ts

@@ -540,7 +540,7 @@ export interface QueryProfile {
     visual_max_revisions: number | null;
     visual_combine_generation_and_concept: boolean | null;
     concept_model_mode: string | null;
-    scoring_status: "unscored" | "queued" | "running" | "scored" | "failed" | "stale" | null;
+    scoring_status: "no_score" | "queued" | "running" | "scored" | null;
     scoring_progress_done: number | null;
     scoring_progress_total: number | null;
     scoring_updated_at: string | null;
@@ -589,7 +589,7 @@ export interface BenchmarkScore {
     cache_hit: boolean;
     config_hash: string;
     eval_version: string | null;
-    scoring_status: "unscored" | "queued" | "running" | "scored" | "failed" | "stale";
+    scoring_status: "no_score" | "queued" | "running" | "scored";
     composite_q: number | null;
     sub_scores: Record<string, unknown>;
     per_language: Record<string, number>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babav/knowledge-core-client",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "description": "TypeScript client for the Babav Knowledge Core API (Deno + Node 18+, zero deps). Includes the babav.visual grammar TYPES at the ./visual subpath (types only; all visual rendering is server-side).",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -510,7 +510,11 @@ export interface QueryProfile {
   // --- score-my-profile status/progress (READ-only; not settable) ---------------------------------
   // Durable on the profile so a client can kick scoring, leave, and see the status/result on any later
   // read. score_composite_q/score_scored_at are the cached score for the CURRENT eval version.
-  scoring_status: "unscored" | "queued" | "running" | "scored" | "failed" | "stale" | null;
+  // Authoritative, derived from reality on every read: "scored" (a score exists), "running"/"queued"
+  // (a run is actively in progress, see scoring_progress_*), or "no_score" (no score and nothing
+  // running — covers never-scored, a failed/interrupted attempt, or a config change). Never a lingering
+  // "failed". null only transiently before the first read enriches it — treat null as "no_score".
+  scoring_status: "no_score" | "queued" | "running" | "scored" | null;
   scoring_progress_done: number | null;
   scoring_progress_total: number | null;
   scoring_updated_at: string | null;         // ISO timestamp; heartbeat while running
@@ -549,7 +553,7 @@ export interface BenchmarkScore {
   cache_hit: boolean;
   config_hash: string;
   eval_version: string | null;
-  scoring_status: "unscored" | "queued" | "running" | "scored" | "failed" | "stale";
+  scoring_status: "no_score" | "queued" | "running" | "scored";
   composite_q: number | null;
   sub_scores: Record<string, unknown>;
   per_language: Record<string, number>;