@lunora/advisor 1.0.0-alpha.101 → 1.0.0-alpha.103

package/README.md

@@ -79,7 +79,9 @@ for (const finding of findings) {
 
 ### Runtime lints
 
-The runtime tier (`hot_shard`, `index_utilization`, `constraint_validator`) reads observed signal off the `LintContext` (`shardTraffic`, `tableScans`, `indexHits`, `tableSamples`). The Studio backend fills those from each shard's durable counters:
+The runtime tier (`hot_shard`, `index_utilization`, `fan_out_breadth`, `constraint_validator`) reads observed signal off the `LintContext` (`shardTraffic`, `tableScans`, `indexHits`, `tableSamples`). The Studio backend fills `shardTraffic` / `tableScans` / `indexHits` from the shards' admin signal.
+
+`tableSamples` has **no shipped feeder**: nothing in the runtime or the Studio reads bounded row samples out of a shard, so `constraint_validator` is a no-op unless _you_ pass samples yourself (the Studio excludes it from the lint set it runs, rather than running it against an input it cannot fill). It is exported and driveable — the sample shape is `AdvisorTableSample` — but wiring it to a deployment means adding a sampling admin read first.
 
 ```ts
 import { fromServerSchema, runAdvisor } from "@lunora/advisor";

package/dist/index.d.mts

@@ -2241,10 +2241,11 @@ interface LintContext {
   storageUploads?: ReadonlyArray<AdvisorStorageUpload>;
   /**
    * Bounded row samples per table — the `constraint_validator` lint input.
-   * Supplied by the studio backend, which reads up to the configured row cap
-   * from each table via `readTablePage` and assembles the existing-id set for
-   * FK referential-integrity checks. Absent for static callers or codegen
-   * feeders, where the constraint lint simply finds nothing.
+   * There is NO shipped feeder: neither the runtime nor the studio reads row
+   * samples out of a shard, so this is absent for every caller in-tree and the
+   * constraint lint finds nothing. Supply it yourself (a paged read per table,
+   * plus the existing-id set for the FK referential-integrity checks) to drive
+   * that lint.
    *
    * Each entry carries `existingIds` (every `_id` in the sample window) so
    * FK columns can be cross-checked across tables in O(1) per value. When
@@ -2385,6 +2386,12 @@ declare const dedupeCacheKeys: (findings: ReadonlyArray<Finding>) => Finding[];
  * Constraint validator — flag rows that violate declared FK / NOT NULL / UNIQUE
  * constraints by cross-checking sampled row data against the schema.
  *
+ * No shipped feeder fills `context.tableSamples` — neither the runtime nor the
+ * Studio reads bounded row samples out of a shard (the Studio drops this lint
+ * from the set it runs for exactly that reason). It runs only for a caller that
+ * gathers samples itself, which is why the guard below returns `[]` rather than
+ * assuming the feed is present.
+ *
  * This lint reads the `context.tableSamples` feed (bounded row samples supplied
  * by the studio backend via `readTablePage`) and the declared schema. Three
  * families of check run over each sample:

package/dist/index.d.ts

@@ -2241,10 +2241,11 @@ interface LintContext {
   storageUploads?: ReadonlyArray<AdvisorStorageUpload>;
   /**
    * Bounded row samples per table — the `constraint_validator` lint input.
-   * Supplied by the studio backend, which reads up to the configured row cap
-   * from each table via `readTablePage` and assembles the existing-id set for
-   * FK referential-integrity checks. Absent for static callers or codegen
-   * feeders, where the constraint lint simply finds nothing.
+   * There is NO shipped feeder: neither the runtime nor the studio reads row
+   * samples out of a shard, so this is absent for every caller in-tree and the
+   * constraint lint finds nothing. Supply it yourself (a paged read per table,
+   * plus the existing-id set for the FK referential-integrity checks) to drive
+   * that lint.
    *
    * Each entry carries `existingIds` (every `_id` in the sample window) so
    * FK columns can be cross-checked across tables in O(1) per value. When
@@ -2385,6 +2386,12 @@ declare const dedupeCacheKeys: (findings: ReadonlyArray<Finding>) => Finding[];
  * Constraint validator — flag rows that violate declared FK / NOT NULL / UNIQUE
  * constraints by cross-checking sampled row data against the schema.
  *
+ * No shipped feeder fills `context.tableSamples` — neither the runtime nor the
+ * Studio reads bounded row samples out of a shard (the Studio drops this lint
+ * from the set it runs for exactly that reason). It runs only for a caller that
+ * gathers samples itself, which is why the guard below returns `[]` rather than
+ * assuming the feed is present.
+ *
  * This lint reads the `context.tableSamples` feed (bounded row samples supplied
  * by the studio backend via `readTablePage`) and the declared schema. Three
  * families of check run over each sample:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/advisor",
-  "version": "1.0.0-alpha.101",
+  "version": "1.0.0-alpha.103",
   "description": "Schema & query lints (splinter-style advisors) for Lunora, feeding the Studio Advisors view",
   "keywords": [
     "advisor",
@@ -46,8 +46,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/errors": "1.0.0-alpha.26",
-    "@lunora/server": "1.0.0-alpha.95"
+    "@lunora/errors": "1.0.0-alpha.27",
+    "@lunora/server": "1.0.0-alpha.97"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"