@dogfood-lab/schemas 1.2.2 → 1.3.0

package/README.md

@@ -33,18 +33,20 @@ npm install @dogfood-lab/schemas
 
 ## Usage — TypeScript surface
 
-The package exports `validatePayload` and the compiled validators:
+The package exports `validatePayload` and the compiled validators. `validatePayload(name, payload)` takes the **schema name first** (one of `record`, `recordSubmission`, `finding`, `pattern`, `recommendation`, `doctrine`, `policy`, `scenario` — all camelCase, NOT the file basename) and the payload second. The return shape is `{ valid: boolean, errors: ValidationError[] }` — each error carries `path`, `message`, `keyword` (the Ajv rule that fired, e.g. `required` / `pattern` / `enum`), and optional `params`.
 
 ```ts
 import { validatePayload } from '@dogfood-lab/schemas';
 
-const result = validatePayload(submission, 'dogfood-record-submission');
-if (!result.ok) {
+const result = validatePayload('recordSubmission', submission);
+if (!result.valid) {
   console.error('schema mismatch:', result.errors);
   process.exit(1);
 }
 ```
 
+`compileSchema(name)` returns the raw Ajv `ValidateFunction` for advanced cases (custom error formatting, direct `validate.errors` inspection). Sibling packages (`@dogfood-lab/verify`, `@dogfood-lab/findings`, `@dogfood-lab/ingest`, `@dogfood-lab/report`) all delegate to `validatePayload` — collapsing N Ajv instances to one per schema per process via the module-scope `validatorCache`.
+
 ## Usage — Raw JSON schemas
 
 The raw schema files are available via the `./json/*` subpath export. Use `createRequire` to load them at runtime:

package/dist/index.d.ts

@@ -28,5 +28,5 @@ export declare const allSchemas: {
     readonly scenario: JsonSchema;
 };
 export type SchemaName = keyof typeof allSchemas;
-export { compileSchema, validatePayload, createAjv, _resetValidatorCacheForTests, type ValidationError, type ValidationResult, } from './validate.js';
+export { compileSchema, validatePayload, createAjv, _resetValidatorCacheForTests, _schemasModuleInstanceCount, type ValidationError, type ValidationResult, } from './validate.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,YAAY,EAAE,UAA+C,CAAC;AAC3E,eAAO,MAAM,sBAAsB,EAAE,UAA0D,CAAC;AAChG,eAAO,MAAM,aAAa,EAAE,UAAgD,CAAC;AAC7E,eAAO,MAAM,aAAa,EAAE,UAAgD,CAAC;AAC7E,eAAO,MAAM,oBAAoB,EAAE,UAAuD,CAAC;AAC3F,eAAO,MAAM,cAAc,EAAE,UAAiD,CAAC;AAC/E,eAAO,MAAM,YAAY,EAAE,UAAuC,CAAC;AACnE,eAAO,MAAM,cAAc,EAAE,UAAyC,CAAC;AAEvE,eAAO,MAAM,UAAU;;;;;;;;;CASb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,UAAU,CAAC;AAEjD,OAAO,EACL,aAAa,EACb,eAAe,EACf,SAAS,EACT,4BAA4B,EAC5B,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,YAAY,EAAE,UAA+C,CAAC;AAC3E,eAAO,MAAM,sBAAsB,EAAE,UAA0D,CAAC;AAChG,eAAO,MAAM,aAAa,EAAE,UAAgD,CAAC;AAC7E,eAAO,MAAM,aAAa,EAAE,UAAgD,CAAC;AAC7E,eAAO,MAAM,oBAAoB,EAAE,UAAuD,CAAC;AAC3F,eAAO,MAAM,cAAc,EAAE,UAAiD,CAAC;AAC/E,eAAO,MAAM,YAAY,EAAE,UAAuC,CAAC;AACnE,eAAO,MAAM,cAAc,EAAE,UAAyC,CAAC;AAEvE,eAAO,MAAM,UAAU;;;;;;;;;CASb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,UAAU,CAAC;AAEjD,OAAO,EACL,aAAa,EACb,eAAe,EACf,SAAS,EACT,4BAA4B,EAC5B,2BAA2B,EAC3B,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -40,5 +40,5 @@ export const allSchemas = {
     policy: policySchema,
     scenario: scenarioSchema,
 };
-export { compileSchema, validatePayload, createAjv, _resetValidatorCacheForTests, } from './validate.js';
+export { compileSchema, validatePayload, createAjv, _resetValidatorCacheForTests, _schemasModuleInstanceCount, } from './validate.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AAE7C,SAAS,IAAI,CAAC,QAAgB;IAC5B,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;AACvC,CAAC;AAcD,MAAM,CAAC,MAAM,YAAY,GAAe,IAAI,CAAC,4BAA4B,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAAe,IAAI,CAAC,uCAAuC,CAAC,CAAC;AAChG,MAAM,CAAC,MAAM,aAAa,GAAe,IAAI,CAAC,6BAA6B,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAe,IAAI,CAAC,6BAA6B,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,oBAAoB,GAAe,IAAI,CAAC,oCAAoC,CAAC,CAAC;AAC3F,MAAM,CAAC,MAAM,cAAc,GAAe,IAAI,CAAC,8BAA8B,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAe,IAAI,CAAC,oBAAoB,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAe,IAAI,CAAC,sBAAsB,CAAC,CAAC;AAEvE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,YAAY;IACpB,gBAAgB,EAAE,sBAAsB;IACxC,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,aAAa;IACtB,cAAc,EAAE,oBAAoB;IACpC,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,cAAc;CAChB,CAAC;AAIX,OAAO,EACL,aAAa,EACb,eAAe,EACf,SAAS,EACT,4BAA4B,GAG7B,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AAE7C,SAAS,IAAI,CAAC,QAAgB;IAC5B,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;AACvC,CAAC;AAcD,MAAM,CAAC,MAAM,YAAY,GAAe,IAAI,CAAC,4BAA4B,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAAe,IAAI,CAAC,uCAAuC,CAAC,CAAC;AAChG,MAAM,CAAC,MAAM,aAAa,GAAe,IAAI,CAAC,6BAA6B,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAe,IAAI,CAAC,6BAA6B,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,oBAAoB,GAAe,IAAI,CAAC,oCAAoC,CAAC,CAAC;AAC3F,MAAM,CAAC,MAAM,cAAc,GAAe,IAAI,CAAC,8BAA8B,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAe,IAAI,CAAC,oBAAoB,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAe,IAAI,CAAC,sBAAsB,CAAC,CAAC;AAEvE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,YAAY;IACpB,gBAAgB,EAAE,sBAAsB;IACxC,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,aAAa;IACtB,cAAc,EAAE,oBAAoB;IACpC,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,cAAc;CAChB,CAAC;AAIX,OAAO,EACL,aAAa,EACb,eAAe,EACf,SAAS,EACT,4BAA4B,EAC5B,2BAA2B,GAG5B,MAAM,eAAe,CAAC"}

package/dist/validate.d.ts

@@ -18,6 +18,14 @@
  */
 import type { ValidateFunction } from 'ajv';
 import { type SchemaName } from './index.js';
+/**
+ * Returns how many times this module has been evaluated in the current
+ * Node process. Used by the D2B-015 single-cache invariant test to
+ * detect a workspace-hoist split. A green seal requires `=== 1`.
+ *
+ * Test-only export: production code has no reason to read this.
+ */
+export declare function _schemasModuleInstanceCount(): number;
 declare const Ajv2020Ctor: new (opts?: {
     allErrors?: boolean;
     strict?: boolean;
@@ -28,6 +36,24 @@ declare const Ajv2020Ctor: new (opts?: {
 export interface ValidationError {
     path: string;
     message: string;
+    /**
+     * Ajv `errors[].keyword` — the rule that fired (`required`, `pattern`,
+     * `enum`, `additionalProperties`, `minLength`, etc.).
+     *
+     * H3 keyword extension: surfacing this at the canonical seam means
+     * downstream wrappers (e.g. ingest's RecordValidationError) can preserve
+     * the keyword pin (packages/ingest/ingest.test.js:208-220 asserts
+     * `typeof e.keyword === 'string'` for every error). Without this field
+     * here, every consumer would have to ride compileSchema() and read
+     * `validate.errors` directly to recover the keyword — which would
+     * defeat the migration's goal of collapsing N Ajv instances to one
+     * per schema.
+     *
+     * Optional in the type so future synthesised errors (e.g. higher-level
+     * "validator failed to compile" envelopes) aren't forced to invent a
+     * keyword. Live validation always populates it.
+     */
+    keyword?: string;
     params?: Record<string, unknown>;
 }
 export interface ValidationResult {

package/dist/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,EAAc,KAAK,UAAU,EAAmB,MAAM,YAAY,CAAC;AAK1E,QAAA,MAAM,WAAW,EAED,KAAK,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK;IACxE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,gBAAgB,CAAC;IAC/C,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CAC5C,CAAC;AAMF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAID;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAAC,OAAO,WAAW,CAAC,CAI5D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAahE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAepF;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,EAAc,KAAK,UAAU,EAAmB,MAAM,YAAY,CAAC;AAuC1E;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAKD,QAAA,MAAM,WAAW,EAED,KAAK,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK;IACxE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,gBAAgB,CAAC;IAC/C,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CAC5C,CAAC;AAMF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAID;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAAC,OAAO,WAAW,CAAC,CAI5D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAahE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAgBpF;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}

package/dist/validate.js

@@ -19,6 +19,51 @@
 import Ajv2020Module from 'ajv/dist/2020.js';
 import addFormatsModule from 'ajv-formats';
 import { allSchemas } from './index.js';
+/**
+ * Process-global module-instance counter — H3 fix-up.
+ *
+ * The H3 migration collapsed N Ajv instances to one per schema by routing
+ * every consumer through {@link validatePayload}. That single-instance
+ * guarantee depends on every consumer resolving `@dogfood-lab/schemas` to
+ * the SAME loaded module — same `validate.js` evaluation → same
+ * `validatorCache` Map → same compiled `ValidateFunction`s.
+ *
+ * Under npm workspace hoist resolution this can split: if any consumer's
+ * `node_modules/@dogfood-lab/schemas/` symlinks differently than others,
+ * Node loads the module twice. Each load gets its own `validatorCache` —
+ * the C1 two-Ajv gap RELOCATED to the cache layer instead of sealed.
+ *
+ * The naive "compileSchema returns the same reference twice" check is
+ * vacuous against this failure: a consumer in a split second instance
+ * populates ITS OWN cache; the original instance's cache is untouched;
+ * `compileSchema()` called twice from the original still returns the
+ * same reference. Same assertion, both green and split states.
+ *
+ * The fix: a counter rooted in `globalThis` (via `Symbol.for`, which is
+ * shared across module instances because the Symbol registry is
+ * process-global). Every evaluation of this module increments it. The
+ * D2B-015 seal test asserts the count is exactly 1 after every consumer
+ * has been imported — if hoist split the package, two evaluations
+ * happened, count >= 2, gate trips.
+ *
+ * The Symbol key is namespaced to `@dogfood-lab/schemas` so a second
+ * unrelated package can't shadow it. The counter is the only
+ * load-time side effect of this module — keeping it minimal so the
+ * cost is unobservable.
+ */
+const _schemasInstanceSymbol = Symbol.for('@dogfood-lab/schemas.instances');
+const _globalSlot = globalThis;
+_globalSlot[_schemasInstanceSymbol] = (_globalSlot[_schemasInstanceSymbol] ?? 0) + 1;
+/**
+ * Returns how many times this module has been evaluated in the current
+ * Node process. Used by the D2B-015 single-cache invariant test to
+ * detect a workspace-hoist split. A green seal requires `=== 1`.
+ *
+ * Test-only export: production code has no reason to read this.
+ */
+export function _schemasModuleInstanceCount() {
+    return _globalSlot[_schemasInstanceSymbol] ?? 0;
+}
 // CommonJS default-export interop: under NodeNext+esModuleInterop the named
 // `default` is what we actually want at runtime. Sibling JS packages get this
 // for free via Node's CJS interop; the TS source has to be explicit.
@@ -72,6 +117,7 @@ export function validatePayload(name, payload) {
     const errors = (validate.errors ?? []).map(err => ({
         path: err.instancePath || '/',
         message: err.message ?? 'unknown error',
+        keyword: err.keyword,
         params: err.params,
     }));
     return { valid: false, errors };

package/dist/validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,gBAAgB,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAoC,MAAM,YAAY,CAAC;AAE1E,4EAA4E;AAC5E,8EAA8E;AAC9E,qEAAqE;AACrE,MAAM,WAAW,GAAG,CACjB,aAA+D,CAAC,OAAO,IAAI,aAAa,CAI1F,CAAC;AAEF,MAAM,UAAU,GAAG,CAChB,gBAAqE,CAAC,OAAO,IAAI,gBAAgB,CACrC,CAAC;AAahE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAgC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAgB;IAC5C,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAe,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB,EAAE,OAAgB;IAChE,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEhC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAsB,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,EAAE,GAAG,CAAC,YAAY,IAAI,GAAG;QAC7B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,eAAe;QACvC,MAAM,EAAE,GAAG,CAAC,MAA6C;KAC1D,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B;IAC1C,cAAc,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,gBAAgB,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAoC,MAAM,YAAY,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAE5E,MAAM,WAAW,GAAG,UAA0C,CAAC;AAC/D,WAAW,CAAC,sBAAsB,CAAC,GAAG,CAAC,WAAW,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAErF;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,WAAW,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,4EAA4E;AAC5E,8EAA8E;AAC9E,qEAAqE;AACrE,MAAM,WAAW,GAAG,CACjB,aAA+D,CAAC,OAAO,IAAI,aAAa,CAI1F,CAAC;AAEF,MAAM,UAAU,GAAG,CAChB,gBAAqE,CAAC,OAAO,IAAI,gBAAgB,CACrC,CAAC;AA+BhE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAgC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAgB;IAC5C,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAe,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB,EAAE,OAAgB;IAChE,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEhC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAsB,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,EAAE,GAAG,CAAC,YAAY,IAAI,GAAG;QAC7B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,eAAe;QACvC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,MAA6C;KAC1D,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B;IAC1C,cAAc,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogfood-lab/schemas",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "JSON schemas for the testing-os contract spine — record, finding, pattern, recommendation, doctrine, policy, scenario, submission.",
   "type": "module",
   "main": "dist/index.js",
@@ -26,13 +26,14 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "dependencies": {
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1"
   },
   "devDependencies": {
+    "@types/node": "^25.3.5",
     "vitest": "^4.1.6"
   },
   "author": "mcp-tool-shop",

package/src/json/dogfood-doctrine.schema.json

@@ -1,86 +1,86 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dogfood-lab/testing-os/packages/schemas/src/json/dogfood-doctrine.schema.json",
-  "title": "Dogfood Doctrine",
-  "description": "A hardened portfolio rule earned from repeated patterns. Doctrine represents durable operating law — the strongest tier of dogfood learning. Must be backed by multiple accepted patterns.",
-  "type": "object",
-  "required": [
-    "schema_version",
-    "doctrine_id",
-    "title",
-    "status",
-    "doctrine_kind",
-    "statement",
-    "rationale",
-    "based_on_pattern_ids",
-    "transfer_scope"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "schema_version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$"
-    },
-    "doctrine_id": {
-      "type": "string",
-      "pattern": "^ddoc-[a-z0-9][a-z0-9-]*$",
-      "minLength": 6
-    },
-    "title": {
-      "type": "string",
-      "minLength": 10,
-      "maxLength": 200
-    },
-    "status": {
-      "type": "string",
-      "enum": ["candidate", "accepted", "rejected"]
-    },
-    "doctrine_kind": {
-      "type": "string",
-      "enum": [
-        "rollout_law",
-        "evidence_law",
-        "surface_law",
-        "verification_law",
-        "calibration_law"
-      ]
-    },
-    "statement": {
-      "type": "string",
-      "minLength": 20,
-      "maxLength": 500,
-      "description": "The doctrine rule itself. Must read as a directive, not a suggestion."
-    },
-    "rationale": {
-      "type": "string",
-      "minLength": 20,
-      "maxLength": 1000,
-      "description": "Why this doctrine exists. Must reference recurrence evidence."
-    },
-    "based_on_pattern_ids": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "type": "string", "minLength": 1 }
-    },
-    "transfer_scope": {
-      "type": "string",
-      "enum": ["surface_archetype", "execution_mode", "org_wide"]
-    },
-    "strength": {
-      "type": "string",
-      "enum": ["emerging", "proven", "foundational"]
-    },
-    "review": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "reviewed_by": { "type": "string" },
-        "reviewed_at": { "type": "string", "format": "date-time" },
-        "decision_reason": { "type": "string", "maxLength": 1000 },
-        "last_action": { "type": "string", "enum": ["accept", "reject", "edit"] }
-      }
-    },
-    "created_at": { "type": "string", "format": "date-time" },
-    "updated_at": { "type": "string", "format": "date-time" }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/dogfood-lab/testing-os/packages/schemas/src/json/dogfood-doctrine.schema.json",
+  "title": "Dogfood Doctrine",
+  "description": "A hardened portfolio rule earned from repeated patterns. Doctrine represents durable operating law — the strongest tier of dogfood learning. Must be backed by multiple accepted patterns.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "doctrine_id",
+    "title",
+    "status",
+    "doctrine_kind",
+    "statement",
+    "rationale",
+    "based_on_pattern_ids",
+    "transfer_scope"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "doctrine_id": {
+      "type": "string",
+      "pattern": "^ddoc-[a-z0-9][a-z0-9-]*$",
+      "minLength": 6
+    },
+    "title": {
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 200
+    },
+    "status": {
+      "type": "string",
+      "enum": ["candidate", "accepted", "rejected"]
+    },
+    "doctrine_kind": {
+      "type": "string",
+      "enum": [
+        "rollout_law",
+        "evidence_law",
+        "surface_law",
+        "verification_law",
+        "calibration_law"
+      ]
+    },
+    "statement": {
+      "type": "string",
+      "minLength": 20,
+      "maxLength": 500,
+      "description": "The doctrine rule itself. Must read as a directive, not a suggestion."
+    },
+    "rationale": {
+      "type": "string",
+      "minLength": 20,
+      "maxLength": 1000,
+      "description": "Why this doctrine exists. Must reference recurrence evidence."
+    },
+    "based_on_pattern_ids": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "transfer_scope": {
+      "type": "string",
+      "enum": ["surface_archetype", "execution_mode", "org_wide"]
+    },
+    "strength": {
+      "type": "string",
+      "enum": ["emerging", "proven", "foundational"]
+    },
+    "review": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "reviewed_by": { "type": "string" },
+        "reviewed_at": { "type": "string", "format": "date-time" },
+        "decision_reason": { "type": "string", "maxLength": 1000 },
+        "last_action": { "type": "string", "enum": ["accept", "reject", "edit"] }
+      }
+    },
+    "created_at": { "type": "string", "format": "date-time" },
+    "updated_at": { "type": "string", "format": "date-time" }
+  }
+}