okengine 0.3.5 → 0.4.3

package/src/console/server/store.ts

@@ -69,6 +69,8 @@ export interface ConsoleStoreChild {
   readonly cache: ConsoleStoreCacheView;
   readonly willNotFire: ConsoleWillNotFire;
   readonly piiColumns: readonly string[];
+  /** Column key → optional human description (SQL tables). */
+  readonly columnDescriptions: Readonly<Record<string, string>>;
 }
 
 /** One row in `console.store.list`. */
@@ -76,6 +78,7 @@ export interface ConsoleStoreRow {
   readonly ref: ResourceRef;
   readonly facet: StoreFacet;
   readonly name: string;
+  readonly description?: string;
   readonly children: readonly ConsoleStoreChild[];
   readonly replicaLagMs: number | null;
   readonly migrationDrift: ConsoleMigrationDrift | null;
@@ -152,6 +155,7 @@ export async function projectStoresList(options: ProjectStoresOptions): Promise<
       ref,
       facet,
       name,
+      ...(store.description !== undefined ? { description: store.description } : {}),
       children,
       replicaLagMs,
       migrationDrift: facet === "sql" ? drift : null,
@@ -219,10 +223,27 @@ function childrenOf(
       },
       willNotFire,
       piiColumns,
+      columnDescriptions: columnDescriptionsFor(store, childName),
     };
   });
 }
 
+function columnDescriptionsFor(
+  store: NonNullable<Manifest["stores"]>[string],
+  tableName: string,
+): Readonly<Record<string, string>> {
+  const cols = store.tables?.[tableName]?.columns;
+  if (!cols) return {};
+  const out: Record<string, string> = {};
+  for (const [key, col] of Object.entries(cols)) {
+    if (col && typeof col === "object" && "description" in col) {
+      const d = (col as { description?: string }).description;
+      if (typeof d === "string" && d.length > 0) out[key] = d;
+    }
+  }
+  return out;
+}
+
 function flowsTouching(manifest: Manifest, ref: ResourceRef, kind: "reads" | "writes"): string[] {
   const out: string[] = [];
   for (const [flowId, flow] of Object.entries(manifest.flows ?? {})) {
@@ -308,6 +329,7 @@ export interface StoreQueryInput {
   readonly prefix?: string;
   readonly limit?: number;
   readonly vector?: readonly number[];
+  readonly q?: string;
   readonly topK?: number;
   readonly revealPii?: boolean;
 }
@@ -329,6 +351,7 @@ export interface StoreQueryResult {
     readonly score: number;
     readonly meta?: Record<string, unknown>;
   }>;
+  readonly facetDistribution?: Record<string, Record<string, number>>;
   readonly masked: boolean;
   readonly routedRole?: "primary" | "replica";
 }
@@ -417,12 +440,20 @@ export async function queryStore(
 
   // index
   const idx = handle as IndexStoreFxHandle;
+  void manifest;
+  if (idx.driverId === "meilisearch") {
+    const q = input.q ?? "";
+    if (q.trim().length === 0) {
+      return { facet, hits: [], masked: false };
+    }
+    const result = await idx.search(q, { topK: input.topK ?? 5 });
+    return { facet, hits: result.hits, facetDistribution: result.facetDistribution, masked: false };
+  }
   const vector = input.vector ?? [];
   if (vector.length === 0) {
     return { facet, hits: [], masked: false };
   }
   const hits = await idx.search(vector, input.topK ?? 5);
-  void manifest;
   return { facet, hits, masked: false };
 }
 
@@ -779,6 +810,9 @@ export function cacheKeyInvalidatedBy(key: string, writeRef: ResourceRef): boole
 /**
  * Open a memory StoreRuntime seeded from Manifest stores (Console default).
  *
+ * The Console Manifest sandbox uses memory drivers for every facet. Real app
+ * boot resolves configured drivers before the Console binds to live runtimes.
+ *
  * @param manifest - Manifest snapshot
  * @param now - Clock
  */

package/src/console/ui/channels/types.ts

@@ -29,6 +29,7 @@ export interface OutcomeRow {
 /** Template row. */
 export interface ChannelTemplate {
   readonly name: string;
+  readonly description?: string;
   readonly medium: string;
   readonly locales: readonly string[];
   readonly from: string | null;

package/src/console/ui/clock/types.ts

@@ -29,6 +29,7 @@ export interface DstAmbiguityView {
 /** One cron row from `console.clock.list`. */
 export interface ClockCronRecord {
   readonly name: string;
+  readonly description?: string;
   readonly status: CronStatus;
   readonly timezone: string;
   readonly overridable: boolean;

package/src/console/ui/display.test.ts

@@ -0,0 +1,14 @@
+import { describe, expect, test } from "bun:test";
+import { displayLabel } from "./display.ts";
+
+describe("displayLabel", () => {
+  test("falls back to the raw key when description is absent", () => {
+    expect(displayLabel("DATABASE_URL")).toBe("DATABASE_URL");
+    expect(displayLabel("DATABASE_URL", undefined)).toBe("DATABASE_URL");
+    expect(displayLabel("DATABASE_URL", "")).toBe("DATABASE_URL");
+  });
+
+  test("prefers a non-empty description", () => {
+    expect(displayLabel("DATABASE_URL", "Primary database URL")).toBe("Primary database URL");
+  });
+});

package/src/console/ui/display.ts

@@ -0,0 +1,9 @@
+/**
+ * Human-facing label for a technical key when an optional description exists.
+ *
+ * @param key - Technical identifier (Manifest map key / declaration name)
+ * @param description - Optional human description
+ */
+export function displayLabel(key: string, description?: string | null): string {
+  return description && description.length > 0 ? description : key;
+}