@askdb/core 1.0.0-beta.45 → 1.0.0-beta.46

package/dist/logging/askdb-logger.d.ts

@@ -7,6 +7,8 @@
 export type AskDbLogger = {
     info(context: Record<string, unknown>, message: string): void;
     error(context: Record<string, unknown>, message: string): void;
+    /** Optional — a problem the host should fix that doesn't stop the run. Without it, `info` is used. */
+    warn?(context: Record<string, unknown>, message: string): void;
     /** Optional — used for prompt redaction notices without leaking sensitive identifiers. */
     debug?(context: Record<string, unknown>, message: string): void;
 };

package/dist/logging/askdb-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"askdb-logger.d.ts","sourceRoot":"","sources":["../../src/logging/askdb-logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,0FAA0F;IAC1F,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjE,CAAC"}
+{"version":3,"file":"askdb-logger.d.ts","sourceRoot":"","sources":["../../src/logging/askdb-logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,sGAAsG;IACtG,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,0FAA0F;IAC1F,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjE,CAAC"}

package/dist/logging/create-askdb-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-askdb-logger.d.ts","sourceRoot":"","sources":["../../src/logging/create-askdb-logger.ts"],"names":[],"mappings":"AAEA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC;AAEjD,MAAM,MAAM,wBAAwB,GAAG;IACrC,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAgBF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,WAAW,CA8BhF"}
+{"version":3,"file":"create-askdb-logger.d.ts","sourceRoot":"","sources":["../../src/logging/create-askdb-logger.ts"],"names":[],"mappings":"AAEA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC;AAEjD,MAAM,MAAM,wBAAwB,GAAG;IACrC,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAmBF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,WAAW,CA8BhF"}

package/dist/logging/create-askdb-logger.js

@@ -9,6 +9,9 @@ function wrapPinoAsAskDbLogger(pinoLogger) {
         error(context, message) {
             pinoLogger.error(context, message);
         },
+        warn(context, message) {
+            pinoLogger.warn(context, message);
+        },
         debug(context, message) {
             pinoLogger.debug(context, message);
         },

package/dist/logging/create-askdb-logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-askdb-logger.js","sourceRoot":"","sources":["../../src/logging/create-askdb-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAuBxB,SAAS,qBAAqB,CAAC,UAAsB;IACnD,OAAO;QACL,IAAI,CAAC,OAAgC,EAAE,OAAe;YACpD,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,OAAgC,EAAE,OAAe;YACrD,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,OAAgC,EAAE,OAAe;YACrD,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,KAAK,GAAkB,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;IACvD,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,qBAAqB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC;IAC1C,MAAM,YAAY,GAA6B,EAAE,CAAC;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,qBAAqB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,GACR,YAAY,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAE;QAClB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAEnE,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACzF,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"create-askdb-logger.js","sourceRoot":"","sources":["../../src/logging/create-askdb-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAuBxB,SAAS,qBAAqB,CAAC,UAAsB;IACnD,OAAO;QACL,IAAI,CAAC,OAAgC,EAAE,OAAe;YACpD,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,OAAgC,EAAE,OAAe;YACrD,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,OAAgC,EAAE,OAAe;YACpD,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,OAAgC,EAAE,OAAe;YACrD,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,KAAK,GAAkB,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;IACvD,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,qBAAqB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC;IAC1C,MAAM,YAAY,GAA6B,EAAE,CAAC;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,qBAAqB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,GACR,YAAY,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAE;QAClB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAEnE,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACzF,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC"}

package/dist/logging/log-events.d.ts

@@ -31,6 +31,14 @@ export declare const AskDbLogEvent: {
     readonly TenantScopeValidated: "askdb.tenant.scope_validated";
     /** Tenant scope validation failed. Includes `reason`. */
     readonly TenantScopeRejected: "askdb.tenant.scope_rejected";
+    /**
+     * The loaded tenant policy doesn't fully match `schema.json` (ADR 0023). Logged at
+     * `warn` level, once per loaded schema, by the first `ask()` that receives it.
+     * Includes `enforcement`, `warningCount` and `warnings`: schema artifact metadata only
+     * (table and column IDs, and a polymorphic `mapping` key from the policy), never query
+     * text or row values.
+     */
+    readonly TenantPolicyWarnings: "askdb.tenant.policy_warnings";
     /**
      * Generated (or replayed) SQL was found to reference identifiers marked
      * `sensitive` in the schema artifact. Emitted by `ask()` in both `warn` and

package/dist/logging/log-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-events.d.ts","sourceRoot":"","sources":["../../src/logging/log-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;IAIxB,kFAAkF;;;;IAIlF,yFAAyF;;IAEzF,4GAA4G;;IAE5G,yEAAyE;;IAEzE;;;OAGG;;IAEH;;;;OAIG;;IAEH,mFAAmF;;IAEnF,yDAAyD;;IAEzD;;;;;OAKG;;IAEH,yCAAyC;;IAEzC,iFAAiF;;IAEjF;;;;OAIG;;CAEK,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"log-events.d.ts","sourceRoot":"","sources":["../../src/logging/log-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;IAIxB,kFAAkF;;;;IAIlF,yFAAyF;;IAEzF,4GAA4G;;IAE5G,yEAAyE;;IAEzE;;;OAGG;;IAEH;;;;OAIG;;IAEH,mFAAmF;;IAEnF,yDAAyD;;IAEzD;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH,yCAAyC;;IAEzC,iFAAiF;;IAEjF;;;;OAIG;;CAEK,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

package/dist/logging/log-events.js

@@ -31,6 +31,14 @@ export const AskDbLogEvent = {
     TenantScopeValidated: "askdb.tenant.scope_validated",
     /** Tenant scope validation failed. Includes `reason`. */
     TenantScopeRejected: "askdb.tenant.scope_rejected",
+    /**
+     * The loaded tenant policy doesn't fully match `schema.json` (ADR 0023). Logged at
+     * `warn` level, once per loaded schema, by the first `ask()` that receives it.
+     * Includes `enforcement`, `warningCount` and `warnings`: schema artifact metadata only
+     * (table and column IDs, and a polymorphic `mapping` key from the policy), never query
+     * text or row values.
+     */
+    TenantPolicyWarnings: "askdb.tenant.policy_warnings",
     /**
      * Generated (or replayed) SQL was found to reference identifiers marked
      * `sensitive` in the schema artifact. Emitted by `ask()` in both `warn` and

package/dist/logging/log-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-events.js","sourceRoot":"","sources":["../../src/logging/log-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,iBAAiB;IAC3B,MAAM,EAAE,eAAe;IACvB,QAAQ,EAAE,iBAAiB;IAC3B,kFAAkF;IAClF,YAAY,EAAE,qBAAqB;IACnC,qBAAqB,EAAE,+BAA+B;IACtD,wBAAwB,EAAE,kCAAkC;IAC5D,yFAAyF;IACzF,uBAAuB,EAAE,iCAAiC;IAC1D,4GAA4G;IAC5G,gCAAgC,EAAE,2CAA2C;IAC7E,yEAAyE;IACzE,cAAc,EAAE,uBAAuB;IACvC;;;OAGG;IACH,qBAAqB,EAAE,+BAA+B;IACtD;;;;OAIG;IACH,wBAAwB,EAAE,kCAAkC;IAC5D,mFAAmF;IACnF,oBAAoB,EAAE,8BAA8B;IACpD,yDAAyD;IACzD,mBAAmB,EAAE,6BAA6B;IAClD;;;;;OAKG;IACH,2BAA2B,EAAE,sCAAsC;IACnE,yCAAyC;IACzC,qBAAqB,EAAE,+BAA+B;IACtD,iFAAiF;IACjF,qBAAqB,EAAE,+BAA+B;IACtD;;;;OAIG;IACH,qBAAqB,EAAE,8BAA8B;CAC7C,CAAC"}
+{"version":3,"file":"log-events.js","sourceRoot":"","sources":["../../src/logging/log-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,iBAAiB;IAC3B,MAAM,EAAE,eAAe;IACvB,QAAQ,EAAE,iBAAiB;IAC3B,kFAAkF;IAClF,YAAY,EAAE,qBAAqB;IACnC,qBAAqB,EAAE,+BAA+B;IACtD,wBAAwB,EAAE,kCAAkC;IAC5D,yFAAyF;IACzF,uBAAuB,EAAE,iCAAiC;IAC1D,4GAA4G;IAC5G,gCAAgC,EAAE,2CAA2C;IAC7E,yEAAyE;IACzE,cAAc,EAAE,uBAAuB;IACvC;;;OAGG;IACH,qBAAqB,EAAE,+BAA+B;IACtD;;;;OAIG;IACH,wBAAwB,EAAE,kCAAkC;IAC5D,mFAAmF;IACnF,oBAAoB,EAAE,8BAA8B;IACpD,yDAAyD;IACzD,mBAAmB,EAAE,6BAA6B;IAClD;;;;;;OAMG;IACH,oBAAoB,EAAE,8BAA8B;IACpD;;;;;OAKG;IACH,2BAA2B,EAAE,sCAAsC;IACnE,yCAAyC;IACzC,qBAAqB,EAAE,+BAA+B;IACtD,iFAAiF;IACjF,qBAAqB,EAAE,+BAA+B;IACtD;;;;OAIG;IACH,qBAAqB,EAAE,8BAA8B;CAC7C,CAAC"}

package/dist/schema/normalize.d.ts

@@ -44,6 +44,4 @@ export declare function formatSchemaForNlToSql(schema: NormalizedSchema, options
     ddl: string;
     stats: NlToSqlSchemaFormatStats;
 };
-/** Same DDL as {@link formatSchemaForNlToSql} with default options (sensitive names included, tagged). */
-export declare function formatSchemaForPrompt(schema: NormalizedSchema, options?: FormatNlToSqlOptions): string;
 //# sourceMappingURL=normalize.d.ts.map

package/dist/schema/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/schema/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAc9E;AAED,kDAAkD;AAClD,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAC7C;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C,CAAC;AAEF,+HAA+H;AAC/H,MAAM,MAAM,wBAAwB,GAAG;IACrC,kCAAkC,EAAE,OAAO,CAAC;IAC5C,0EAA0E;IAC1E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,uBAAuB,EAAE,MAAM,CAAC;IAChC,4GAA4G;IAC5G,0BAA0B,EAAE,MAAM,CAAC;IACnC,yEAAyE;IACzE,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAmBF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,oBAAyB,GACjC;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,wBAAwB,CAAC;CACjC,CAwDA;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAEtG"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/schema/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAc9E;AAED,kDAAkD;AAClD,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAC7C;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C,CAAC;AAEF,+HAA+H;AAC/H,MAAM,MAAM,wBAAwB,GAAG;IACrC,kCAAkC,EAAE,OAAO,CAAC;IAC5C,0EAA0E;IAC1E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,uBAAuB,EAAE,MAAM,CAAC;IAChC,4GAA4G;IAC5G,0BAA0B,EAAE,MAAM,CAAC;IACnC,yEAAyE;IACzE,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAmBF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,oBAAyB,GACjC;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,wBAAwB,CAAC;CACjC,CAwDA"}

package/dist/schema/normalize.js

@@ -84,8 +84,4 @@ export function formatSchemaForNlToSql(schema, options = {}) {
         },
     };
 }
-/** Same DDL as {@link formatSchemaForNlToSql} with default options (sensitive names included, tagged). */
-export function formatSchemaForPrompt(schema, options) {
-    return formatSchemaForNlToSql(schema, options).ddl;
-}
 //# sourceMappingURL=normalize.js.map

package/dist/schema/normalize.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/schema/normalize.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/schema/normalize.ts"],"names":[],"mappings":"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"}

package/dist/schema/v2/index.d.ts

@@ -1,7 +1,8 @@
-export { loadSchema, loadSchemaFromJson } from "./loader.js";
+export { loadSchema, loadSchemaFromJson, readSchemaDirectory } from "./loader.js";
 export type { BundledSchemaV2 } from "./loader.js";
 export { parseTableMarkdown, parseConceptsMarkdown } from "./parser.js";
 export { writeTableMarkdown, writeConceptsMarkdown, writeTenantPolicyMarkdown } from "./writer.js";
+export { saveSchemaFile } from "./save-file.js";
 export { formatSchemaV2ForNlToSql } from "./format.js";
 export { v2SchemaJsonSchema, v2TableSchema, v2ColumnSchema } from "./physical.js";
 export type { V2SchemaJson, V2Table, V2Column } from "./physical.js";
@@ -9,7 +10,7 @@ export { v2TableFrontmatterSchema, v2ColumnFrontmatterSchema, v2ConceptsFrontmat
 export type { V2TableFrontmatter, V2ColumnFrontmatter, V2ConceptsFrontmatter, V2Concept, ParsedTableMarkdown, ParsedConceptsMarkdown, RecognizedH2Section, } from "./describable.js";
 export type { NormalizedSchemaV2, NormalizedV2Table, NormalizedV2Column, SchemaV2Warning, } from "./normalized.js";
 export { parseTenantPolicyMarkdown, normalizeTenantPolicy } from "./tenant-policy-loader.js";
-export { tenantPolicyFrontmatterSchema, tenantRootSchema, hierarchyEdgeSchema, scopedTableSchema, polymorphicTableSchema, enforcementModeSchema, tenantScopeSchema, tenantAccessSchema, TENANT_POLICY_H2_SECTIONS, } from "./tenant-policy.js";
+export { tenantPolicyFrontmatterSchema, tenantRootSchema, hierarchyEdgeSchema, scopedTableSchema, polymorphicTableSchema, enforcementModeSchema, formatTenantPolicyWarning, tenantScopeSchema, tenantAccessSchema, TENANT_POLICY_H2_SECTIONS, } from "./tenant-policy.js";
 export type { TenantPolicyFrontmatter, TenantRoot, HierarchyEdge, ScopedTable, ScopeThrough, PolymorphicTable, EnforcementMode, TenantScope, TenantAccess, TenantAccessIds, TenantAccessSubtree, TenantAccessMultiRoot, TenantAccessGlobal, TenantScopeContext, ParsedTenantPolicyMarkdown, NormalizedTenantPolicy, TenantPolicyWarning, TableCoverageEntry, TableTenantClassification, TenantPolicyH2Section, } from "./tenant-policy.js";
 export { createMentionMatcher, findMentionedNames, sensitiveMentionNames, type MentionMatcher, type MentionName, } from "./mentions.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/schema/v2/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClF,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,EACT,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClF,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,EACT,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC"}

package/dist/schema/v2/index.js

@@ -1,10 +1,11 @@
-export { loadSchema, loadSchemaFromJson } from "./loader.js";
+export { loadSchema, loadSchemaFromJson, readSchemaDirectory } from "./loader.js";
 export { parseTableMarkdown, parseConceptsMarkdown } from "./parser.js";
 export { writeTableMarkdown, writeConceptsMarkdown, writeTenantPolicyMarkdown } from "./writer.js";
+export { saveSchemaFile } from "./save-file.js";
 export { formatSchemaV2ForNlToSql } from "./format.js";
 export { v2SchemaJsonSchema, v2TableSchema, v2ColumnSchema } from "./physical.js";
 export { v2TableFrontmatterSchema, v2ColumnFrontmatterSchema, v2ConceptsFrontmatterSchema, v2ConceptSchema, RECOGNIZED_H2_SECTIONS, } from "./describable.js";
 export { parseTenantPolicyMarkdown, normalizeTenantPolicy } from "./tenant-policy-loader.js";
-export { tenantPolicyFrontmatterSchema, tenantRootSchema, hierarchyEdgeSchema, scopedTableSchema, polymorphicTableSchema, enforcementModeSchema, tenantScopeSchema, tenantAccessSchema, TENANT_POLICY_H2_SECTIONS, } from "./tenant-policy.js";
+export { tenantPolicyFrontmatterSchema, tenantRootSchema, hierarchyEdgeSchema, scopedTableSchema, polymorphicTableSchema, enforcementModeSchema, formatTenantPolicyWarning, tenantScopeSchema, tenantAccessSchema, TENANT_POLICY_H2_SECTIONS, } from "./tenant-policy.js";
 export { createMentionMatcher, findMentionedNames, sensitiveMentionNames, } from "./mentions.js";
 //# sourceMappingURL=index.js.map

package/dist/schema/v2/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/v2/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAgB1B,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAwB5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,GAGtB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/v2/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAgB1B,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAwB5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,GAGtB,MAAM,eAAe,CAAC"}

package/dist/schema/v2/loader.d.ts

@@ -40,13 +40,31 @@ export declare function loadSchemaFromJson(raw: string): NormalizedSchemaV2;
  *    sibling `tables/*.md`, `concepts.md`, and `tenant-policy.md`
  *
  * Any other JSON file is treated as a standalone physical layer, unless its
- * directory also holds `tenant-policy.md`, `tables/` or `concepts.md`: loading it
- * alone would ignore them, so that throws `SchemaParseError`. To load only the
- * physical layer of such a file, pass its content to `loadSchemaFromJson()`.
+ * directory also holds `tenant-policy.md`, `tables/` or `concepts.md`, in any case:
+ * loading it alone would ignore them, so that throws `SchemaParseError`. To load only
+ * the physical layer of such a file, pass its content to `loadSchemaFromJson()`.
  *
- * Optional sibling files may be absent, but a present file that cannot be read
- * or parsed (e.g. malformed YAML front-matter in `tenant-policy.md`) throws
- * `SchemaParseError` — a broken tenant policy never silently disables tenancy.
+ * A directory is read by {@link readSchemaDirectory}, so a file name the loader looks
+ * up must be spelled exactly (`Tenant-Policy.md` throws on every OS). Optional sibling
+ * files may be absent, but a present file that cannot be read or parsed (e.g.
+ * malformed YAML front-matter in `tenant-policy.md`) throws `SchemaParseError` — a
+ * broken tenant policy never silently disables tenancy.
  */
 export declare function loadSchema(path: string): NormalizedSchemaV2;
+/**
+ * Read a Schema v2 directory into its bundle form, the single file `askdb bundle`
+ * writes. Loading the result with `loadSchemaFromJson()` gives the same schema as
+ * `loadSchema(dir)`, which reads the directory through this function too.
+ *
+ * Every name it looks up must be spelled exactly: `schema.json`, `tenant-policy.md`,
+ * `concepts.md`, `tables/`, and the `.md` extension in `tables/`. A file that matches
+ * one only when case is ignored (`Tenant-Policy.md`, `tables/orders.MD`) throws
+ * `SchemaParseError` on every OS. Where file names are case-sensitive (Linux) it would
+ * otherwise be skipped, and a skipped `tenant-policy.md` turns tenant enforcement off.
+ *
+ * An optional file counts as absent only when the directory doesn't list it. A listed
+ * file that can't be read throws `SchemaParseError`, so does a `schema.json` that is
+ * missing or invalid. The file contents are returned unparsed, except `schema.json`.
+ */
+export declare function readSchemaDirectory(dir: string): BundledSchemaV2;
 //# sourceMappingURL=loader.d.ts.map

package/dist/schema/v2/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,iBAAiB,CAAC;AAezB;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,IAAI,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAYlE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAqC3D"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,iBAAiB,CAAC;AAezB;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,IAAI,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAYlE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAqC3D;AAmCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAEhE"}

package/dist/schema/v2/loader.js

@@ -35,13 +35,15 @@ export function loadSchemaFromJson(raw) {
  *    sibling `tables/*.md`, `concepts.md`, and `tenant-policy.md`
  *
  * Any other JSON file is treated as a standalone physical layer, unless its
- * directory also holds `tenant-policy.md`, `tables/` or `concepts.md`: loading it
- * alone would ignore them, so that throws `SchemaParseError`. To load only the
- * physical layer of such a file, pass its content to `loadSchemaFromJson()`.
+ * directory also holds `tenant-policy.md`, `tables/` or `concepts.md`, in any case:
+ * loading it alone would ignore them, so that throws `SchemaParseError`. To load only
+ * the physical layer of such a file, pass its content to `loadSchemaFromJson()`.
  *
- * Optional sibling files may be absent, but a present file that cannot be read
- * or parsed (e.g. malformed YAML front-matter in `tenant-policy.md`) throws
- * `SchemaParseError` — a broken tenant policy never silently disables tenancy.
+ * A directory is read by {@link readSchemaDirectory}, so a file name the loader looks
+ * up must be spelled exactly (`Tenant-Policy.md` throws on every OS). Optional sibling
+ * files may be absent, but a present file that cannot be read or parsed (e.g.
+ * malformed YAML front-matter in `tenant-policy.md`) throws `SchemaParseError` — a
+ * broken tenant policy never silently disables tenancy.
  */
 export function loadSchema(path) {
     const resolved = resolve(path);
@@ -81,7 +83,7 @@ export function loadSchema(path) {
  * Every optional file the directory loader reads beside `schema.json`, by the exact
  * name it reads, keyed by the `BundledSchemaV2` field that carries it. `satisfies`
  * stops a new bundle field from compiling until it is named here, so the directory
- * loader, the bundle loader and `assertNotInSchemaDirectory` share one list.
+ * read, the bundle loader and `assertNotInSchemaDirectory` share one list.
  */
 const SCHEMA_DIRECTORY_FILES = {
     tenantPolicy: "tenant-policy.md",
@@ -92,11 +94,14 @@ const SCHEMA_DIRECTORY_FILES = {
  * A standalone JSON file must not sit beside schema-directory files. Loading it
  * alone would ignore them, so `cp schema.json prod-schema.json` would silently drop
  * the tenant policy (and with it `ask()`'s tenant scope) and every `tables/*.md`
- * `sensitive: true`. Fail closed instead and say how to load it.
+ * `sensitive: true`. Fail closed instead and say how to load it. A sibling counts in
+ * any case: a wrong-case `Tenant-Policy.md` is still a schema file the load would ignore.
  */
 function assertNotInSchemaDirectory(filePath) {
-    const dir = dirname(filePath);
-    const present = Object.values(SCHEMA_DIRECTORY_FILES).filter((name) => pathExists(join(dir, name)));
+    const siblingKeys = new Set(Object.values(SCHEMA_DIRECTORY_FILES).map(caseKey));
+    const present = readRequiredDir(dirname(filePath))
+        .filter((entry) => siblingKeys.has(caseKey(entry)))
+        .sort();
     if (present.length === 0)
         return;
     throw new SchemaParseError(`Refusing to load ${filePath} as a standalone physical layer: its directory also holds ` +
@@ -104,97 +109,155 @@ function assertNotInSchemaDirectory(filePath) {
         `tenant-policy.md turns tenant enforcement off). Pass the directory, rename the file ` +
         `to schema.json, or pass its content to loadSchemaFromJson() to load only the physical layer.`);
 }
-function loadFromDirectory(dir, schemaJsonPath = join(dir, "schema.json")) {
-    let raw;
-    try {
-        raw = readFileSync(schemaJsonPath, "utf8");
-    }
-    catch {
+/**
+ * Read a Schema v2 directory into its bundle form, the single file `askdb bundle`
+ * writes. Loading the result with `loadSchemaFromJson()` gives the same schema as
+ * `loadSchema(dir)`, which reads the directory through this function too.
+ *
+ * Every name it looks up must be spelled exactly: `schema.json`, `tenant-policy.md`,
+ * `concepts.md`, `tables/`, and the `.md` extension in `tables/`. A file that matches
+ * one only when case is ignored (`Tenant-Policy.md`, `tables/orders.MD`) throws
+ * `SchemaParseError` on every OS. Where file names are case-sensitive (Linux) it would
+ * otherwise be skipped, and a skipped `tenant-policy.md` turns tenant enforcement off.
+ *
+ * An optional file counts as absent only when the directory doesn't list it. A listed
+ * file that can't be read throws `SchemaParseError`, so does a `schema.json` that is
+ * missing or invalid. The file contents are returned unparsed, except `schema.json`.
+ */
+export function readSchemaDirectory(dir) {
+    return readDirectory(resolve(dir));
+}
+const SCHEMA_JSON = "schema.json";
+/**
+ * {@link readSchemaDirectory}, reading the physical layer from `schemaJsonPath` when
+ * the caller named that file (`loadSchema("<dir>/Schema.json")`). That name is the
+ * caller's, so it is read as given and only the names this function looks up itself
+ * are checked.
+ */
+function readDirectory(dir, schemaJsonPath) {
+    const entries = readRequiredDir(dir);
+    const listed = new Set(entries);
+    const tables = SCHEMA_DIRECTORY_FILES.tables;
+    const tableDir = join(dir, tables);
+    // Sorted so warning order is deterministic (readdir order is filesystem-dependent)
+    // and matches the bundle loader, which sorts its `tables` keys the same way.
+    const tableEntries = listed.has(tables) ? readRequiredDir(tableDir).sort() : [];
+    assertExactNames(dir, entries, tableEntries, schemaJsonPath === undefined);
+    if (schemaJsonPath === undefined && !listed.has(SCHEMA_JSON)) {
         throw new SchemaParseError(`No schema.json found in directory: ${dir}`);
     }
+    const physicalPath = schemaJsonPath ?? join(dir, SCHEMA_JSON);
     let parsed;
     try {
-        parsed = JSON.parse(raw);
+        parsed = JSON.parse(readRequiredFile(physicalPath));
     }
-    catch {
-        throw new SchemaParseError(`Failed to parse schema.json in ${dir}`);
-    }
-    const physical = parsePhysicalLayer(parsed, schemaJsonPath);
-    // The describable files below are optional, but only *absence* (ENOENT) is
-    // tolerated. Any other read or parse failure is fatal: silently skipping a
-    // broken tenant-policy.md would load the schema with tenant enforcement off.
-    // Load optional tables/*.md
-    const tableDir = join(dir, SCHEMA_DIRECTORY_FILES.tables);
-    const tableMarkdowns = {};
-    // Sorted so warning order is deterministic (readdir order is filesystem-dependent)
-    // and matches the bundle loader, which sorts its `tables` keys the same way.
-    const entries = (readOptionalDir(tableDir) ?? []).sort();
-    for (const entry of entries) {
-        if (!entry.endsWith(".md"))
-            continue;
-        const filePath = join(tableDir, entry);
-        const content = readRequiredFile(filePath);
-        const parsed = parseOrWrap(filePath, () => parseTableMarkdown(content, filePath));
-        addTableMarkdown(tableMarkdowns, { tableFile: `tables/${entry}`, parsed }, dir);
+    catch (e) {
+        if (e instanceof SchemaParseError)
+            throw e;
+        throw new SchemaParseError(`Failed to parse schema.json in ${dir}`, e);
     }
-    // Load optional concepts.md
-    let concepts;
-    const conceptsPath = join(dir, SCHEMA_DIRECTORY_FILES.concepts);
-    const conceptsContent = readOptionalFile(conceptsPath);
-    if (conceptsContent !== undefined) {
-        concepts = parseOrWrap(conceptsPath, () => parseConceptsMarkdown(conceptsContent, conceptsPath)).frontmatter;
+    const physical = parsePhysicalLayer(parsed, physicalPath);
+    const tableFiles = {};
+    for (const entry of tableEntries) {
+        if (entry.endsWith(".md"))
+            tableFiles[entry] = readRequiredFile(join(tableDir, entry));
     }
-    // Load optional tenant-policy.md
-    let tenantPolicy;
-    const policyPath = join(dir, SCHEMA_DIRECTORY_FILES.tenantPolicy);
-    const policyContent = readOptionalFile(policyPath);
-    if (policyContent !== undefined) {
-        tenantPolicy = parseOrWrap(policyPath, () => {
-            const parsed = parseTenantPolicyMarkdown(policyContent, policyPath);
-            const physicalTableIds = new Set(physical.tables.map((t) => t.id));
-            const physicalColumnIds = new Set(physical.tables.flatMap((t) => t.columns.map((c) => c.id)));
-            return normalizeTenantPolicy(parsed, physicalTableIds, physicalColumnIds);
-        });
+    const bundle = { bundled: true, physical, tables: tableFiles };
+    for (const key of ["concepts", "tenantPolicy"]) {
+        const name = SCHEMA_DIRECTORY_FILES[key];
+        if (listed.has(name))
+            bundle[key] = readRequiredFile(join(dir, name));
     }
-    return buildNormalized(physical, tableMarkdowns, concepts, [], tenantPolicy);
+    return bundle;
 }
-function isMissingPathError(e) {
-    return (typeof e === "object" && e !== null && e.code === "ENOENT");
+/**
+ * The key two names share when a case-insensitive filesystem stores them as one file.
+ * It is ADR 0013's key, checked there against Unicode full case folding: APFS folds
+ * `tableſ` (long s) to `tables`, which `toLowerCase()` alone misses.
+ */
+function caseKey(name) {
+    return name.normalize("NFC").toLowerCase().toUpperCase().toLowerCase();
 }
-function errorMessage(e) {
-    return e instanceof Error ? e.message : String(e);
+/** A `tables/` entry's name with its extension lowercased: `users.MD` → `users.md`. */
+function tableFileKey(entry) {
+    return entry.slice(0, -3) + entry.slice(-3).toLowerCase();
 }
-/** Read an optional file: `undefined` when it does not exist, `SchemaParseError` on any other failure. */
-function readOptionalFile(path) {
-    try {
-        return readFileSync(path, "utf8");
-    }
-    catch (e) {
-        if (isMissingPathError(e))
-            return undefined;
-        throw new SchemaParseError(`Failed to read ${path}: ${errorMessage(e)}`, e);
+/**
+ * Throw when a directory entry matches a name the loader looks up only when case is
+ * ignored. Where file names are case-sensitive (Linux), the loader would skip that
+ * file; on macOS and Windows the same directory loads. Checking on every OS makes a
+ * directory fail on a laptop the way it would fail open in production. One error
+ * names every problem, including the files in a wrong-case `Tables/`, so the user
+ * fixes them in one pass.
+ */
+function assertExactNames(dir, entries, tableEntries, checkSchemaJson) {
+    const tables = SCHEMA_DIRECTORY_FILES.tables;
+    const names = [...(checkSchemaJson ? [SCHEMA_JSON] : []), ...Object.values(SCHEMA_DIRECTORY_FILES)];
+    const problems = spellingProblems(entries, names, caseKey, "");
+    // A lone wrong-case `Tables/` is listed too, so its files are named in this error.
+    const tablesSpellings = entries.filter((entry) => caseKey(entry) === tables);
+    const wrongCaseTables = tablesSpellings.length === 1 && tablesSpellings[0] !== tables
+        ? listOrEmpty(join(dir, tablesSpellings[0])).sort()
+        : [];
+    const files = [...tableEntries, ...wrongCaseTables];
+    const mdNames = [
+        ...new Set(files.map(tableFileKey).filter((key) => key.endsWith(".md"))),
+    ];
+    problems.push(...spellingProblems(files, mdNames, tableFileKey, `${tables}/`));
+    if (problems.length === 0)
+        return;
+    throw new SchemaParseError(`Schema directory ${dir} has a file name in the wrong case: ${problems.join("; ")}. ` +
+        `The loader reads these names exactly. Where file names are case-sensitive (Linux) it ` +
+        `would skip the file, and a skipped tenant-policy.md turns tenant enforcement off, so it ` +
+        `refuses on every OS.`);
+}
+/**
+ * For each name, the entries that spell it differently under `key`: one wrong spelling
+ * is a rename. Two or more spellings can coexist only where names are case-sensitive,
+ * and renaming one onto the other would overwrite a file or move a directory inside
+ * the other, so the problem says to keep one instead.
+ */
+function spellingProblems(entries, names, key, prefix) {
+    const problems = [];
+    for (const name of names) {
+        const spellings = entries.filter((entry) => key(entry) === key(name)).sort();
+        if (spellings.length === 0 || (spellings.length === 1 && spellings[0] === name))
+            continue;
+        problems.push(spellings.length === 1
+            ? `rename ${prefix}${spellings[0]} to ${prefix}${name}`
+            : `keep one of ${spellings.map((s) => prefix + s).join(", ")}, named ${prefix}${name}`);
     }
+    return problems;
 }
-/** Whether a path exists: `false` only when it does not (ENOENT), `SchemaParseError` on any other failure. */
-function pathExists(path) {
+/** List a directory whose contents only add detail to an error: `[]` if it can't be listed. */
+function listOrEmpty(path) {
     try {
-        statSync(path);
-        return true;
+        return readdirSync(path);
     }
-    catch (e) {
-        if (isMissingPathError(e))
-            return false;
-        throw new SchemaParseError(`Failed to read ${path}: ${errorMessage(e)}`, e);
+    catch {
+        return [];
     }
 }
-/** List an optional directory: `undefined` when it does not exist, `SchemaParseError` on any other failure. */
-function readOptionalDir(path) {
+function loadFromDirectory(dir, schemaJsonPath) {
+    const files = readDirectory(dir, schemaJsonPath);
+    // Errors name the file on disk.
+    return loadFromFiles(files, files.physical, (file) => join(dir, file), dir);
+}
+function loadFromBundle(bundle, filePath) {
+    const physical = parsePhysicalLayer(bundle.physical, filePath);
+    // Errors name the bundled file and the bundle that holds it: the user has the
+    // bundle on disk, not a tenant-policy.md or concepts.md.
+    return loadFromFiles(bundle, physical, (file) => `${file} (in ${filePath})`, filePath);
+}
+function errorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+/** List a directory the loader needs: `SchemaParseError` on any failure. */
+function readRequiredDir(path) {
     try {
         return readdirSync(path);
     }
     catch (e) {
-        if (isMissingPathError(e))
-            return undefined;
         throw new SchemaParseError(`Failed to read directory ${path}: ${errorMessage(e)}`, e);
     }
 }
@@ -222,33 +285,34 @@ function parseOrWrap(path, fn) {
         throw new SchemaParseError(`Failed to parse ${path}: ${errorMessage(e)}`, e);
     }
 }
-function loadFromBundle(bundle, filePath) {
-    const physical = parsePhysicalLayer(bundle.physical, filePath);
+/**
+ * Parse a schema's files, read from a directory or carried in a bundle, against its
+ * validated physical layer. `fileLabel` turns a file's path in the schema directory
+ * (`tables/orders.md`, `tenant-policy.md`) into the name errors use.
+ */
+function loadFromFiles(files, physical, fileLabel, schemaPath) {
     const tableMarkdowns = {};
-    // Errors name the bundled file and the bundle that holds it: the user has the
-    // bundle on disk, not a tenant-policy.md or concepts.md.
-    const inBundle = (file) => `${file} (in ${filePath})`;
-    // Bundle keys are the `tables/` filenames (see `bundleSchemaDirectory` in
-    // @askdb/enrich), so warnings name the same path the directory loader would.
-    // Sorted like the directory loader's entries, so both report warnings in one order.
-    for (const [filename, content] of Object.entries(bundle.tables).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
-        const tableFile = `tables/${filename}`;
-        const parsed = parseOrWrap(inBundle(tableFile), () => parseTableMarkdown(content, inBundle(tableFile)));
-        addTableMarkdown(tableMarkdowns, { tableFile, parsed }, filePath);
-    }
-    // Mirror the directory loader: only an *absent* key means "no file". A present
-    // value — including an empty string — is parsed and must be valid, so an empty
-    // or corrupt tenantPolicy can never silently disable tenant enforcement.
+    // `tables` keys are the `tables/` filenames, so warnings name the file as it sits in
+    // the directory. Sorted so both forms report warnings in one order.
+    for (const [filename, content] of Object.entries(files.tables).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
+        const tableFile = `${SCHEMA_DIRECTORY_FILES.tables}/${filename}`;
+        const label = fileLabel(tableFile);
+        const parsed = parseOrWrap(label, () => parseTableMarkdown(content, label));
+        addTableMarkdown(tableMarkdowns, { tableFile, parsed }, schemaPath);
+    }
+    // Only an *absent* file (or bundle key) means "no file". A present value —
+    // including an empty string — is parsed and must be valid, so an empty or corrupt
+    // tenant policy can never silently disable tenant enforcement.
     let concepts;
-    const conceptsContent = bundledFileContent(bundle, "concepts", filePath);
+    const conceptsContent = bundledFileContent(files, "concepts", schemaPath);
     if (conceptsContent !== undefined) {
-        const conceptsFile = inBundle(SCHEMA_DIRECTORY_FILES.concepts);
+        const conceptsFile = fileLabel(SCHEMA_DIRECTORY_FILES.concepts);
         concepts = parseOrWrap(conceptsFile, () => parseConceptsMarkdown(conceptsContent, conceptsFile)).frontmatter;
     }
     let tenantPolicy;
-    const policyContent = bundledFileContent(bundle, "tenantPolicy", filePath);
+    const policyContent = bundledFileContent(files, "tenantPolicy", schemaPath);
     if (policyContent !== undefined) {
-        const policyFile = inBundle(SCHEMA_DIRECTORY_FILES.tenantPolicy);
+        const policyFile = fileLabel(SCHEMA_DIRECTORY_FILES.tenantPolicy);
         tenantPolicy = parseOrWrap(policyFile, () => {
             const parsed = parseTenantPolicyMarkdown(policyContent, policyFile);
             const physicalTableIds = new Set(physical.tables.map((t) => t.id));