@dogfood-lab/schemas 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-tool-shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# @dogfood-lab/schemas
+
+> JSON schemas for the testing-os contract spine — record, finding, pattern, recommendation, doctrine, policy, scenario, submission.
+
+Part of the [`testing-os`](https://github.com/dogfood-lab/testing-os) monorepo — the operating system for testing in the AI era.
+
+This package ships the 8 canonical JSON Schemas (2020-12 dialect) that the testing-os contract spine validates against. Every record, finding, pattern, recommendation, doctrine artifact, policy file, scenario definition, and submission envelope produced by the rest of the monorepo conforms to one of these schemas. Consumer packages (`@dogfood-lab/verify`, `@dogfood-lab/findings`, `@dogfood-lab/report`) load the schemas via the `./json/*` subpath export and compile them with `ajv`.
+
+## Install
+
+```bash
+npm install @dogfood-lab/schemas
+```
+
+## The 8 Schemas
+
+| Schema file | Purpose |
+|---|---|
+| `dogfood-record.schema.json` | Persisted test/audit record produced by dogfood runs |
+| `dogfood-record-submission.schema.json` | Envelope shape `repository_dispatch` payloads must match |
+| `dogfood-finding.schema.json` | Evidence-bound finding contract — anchored to source line + severity + status |
+| `dogfood-pattern.schema.json` | Reusable pattern derived from findings (synthesis layer) |
+| `dogfood-recommendation.schema.json` | Recommendation derived from patterns |
+| `dogfood-doctrine.schema.json` | Doctrine artifact synthesized from patterns + recommendations |
+| `policy.schema.json` | Per-repo policy YAML shape (gate accumulation, severity thresholds) |
+| `scenario.schema.json` | Scenario definition shape (what gets tested + how) |
+
+## Usage — TypeScript surface
+
+The package exports `validatePayload` and the compiled validators:
+
+```ts
+import { validatePayload } from '@dogfood-lab/schemas';
+
+const result = validatePayload(submission, 'dogfood-record-submission');
+if (!result.ok) {
+  console.error('schema mismatch:', result.errors);
+  process.exit(1);
+}
+```
+
+## Usage — Raw JSON schemas
+
+The raw schema files are available via the `./json/*` subpath export. Use `createRequire` to load them at runtime:
+
+```js
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+
+const recordSchema = require('@dogfood-lab/schemas/json/dogfood-record.schema.json');
+const findingSchema = require('@dogfood-lab/schemas/json/dogfood-finding.schema.json');
+```
+
+Or with import attributes (Node 22+):
+
+```js
+import recordSchema from '@dogfood-lab/schemas/json/dogfood-record.schema.json' with { type: 'json' };
+```
+
+## Compatibility
+
+| | Constraint |
+|---|---|
+| JSON Schema dialect | 2020-12 |
+| Node | ≥ 20 |
+| `$id` form | `https://github.com/dogfood-lab/testing-os/packages/schemas/src/json/<name>.schema.json` |
+
+`$id` is a contract field. Changes that consumers should treat as contract changes bump the monorepo's lockstep version.
+
+## Docs
+
+📖 Full handbook: **<https://dogfood-lab.github.io/testing-os/handbook/>**
+
+## License
+
+MIT © 2026 mcp-tool-shop

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+export interface JsonSchema {
+    $schema?: string;
+    $id?: string;
+    title?: string;
+    description?: string;
+    type?: string | string[];
+    required?: string[];
+    properties?: Record<string, unknown>;
+    additionalProperties?: boolean | JsonSchema;
+    [key: string]: unknown;
+}
+export declare const recordSchema: JsonSchema;
+export declare const recordSubmissionSchema: JsonSchema;
+export declare const findingSchema: JsonSchema;
+export declare const patternSchema: JsonSchema;
+export declare const recommendationSchema: JsonSchema;
+export declare const doctrineSchema: JsonSchema;
+export declare const policySchema: JsonSchema;
+export declare const scenarioSchema: JsonSchema;
+export declare const allSchemas: {
+    readonly record: JsonSchema;
+    readonly recordSubmission: JsonSchema;
+    readonly finding: JsonSchema;
+    readonly pattern: JsonSchema;
+    readonly recommendation: JsonSchema;
+    readonly doctrine: JsonSchema;
+    readonly policy: JsonSchema;
+    readonly scenario: JsonSchema;
+};
+export type SchemaName = keyof typeof allSchemas;
+export { compileSchema, validatePayload, createAjv, _resetValidatorCacheForTests, type ValidationError, type ValidationResult, } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * @dogfood-lab/schemas — JSON-schema spine for testing-os.
+ *
+ * Each schema is a JSON Schema 2020-12 document. Consumers can either:
+ *
+ *   1. Import the typed schema object:
+ *        import { recordSchema } from '@dogfood-lab/schemas';
+ *
+ *   2. Reference the raw JSON file via the subpath export:
+ *        import recordSchema from '@dogfood-lab/schemas/json/dogfood-record.schema.json'
+ *          with { type: 'json' };
+ *
+ * The schemas are the same files served by the legacy
+ * `mcp-tool-shop-org/dogfood-labs/schemas/` URLs during the cutover window.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const here = dirname(fileURLToPath(import.meta.url));
+const jsonDir = resolve(here, '../src/json');
+function load(filename) {
+    const raw = readFileSync(resolve(jsonDir, filename), 'utf8');
+    return JSON.parse(raw);
+}
+export const recordSchema = load('dogfood-record.schema.json');
+export const recordSubmissionSchema = load('dogfood-record-submission.schema.json');
+export const findingSchema = load('dogfood-finding.schema.json');
+export const patternSchema = load('dogfood-pattern.schema.json');
+export const recommendationSchema = load('dogfood-recommendation.schema.json');
+export const doctrineSchema = load('dogfood-doctrine.schema.json');
+export const policySchema = load('policy.schema.json');
+export const scenarioSchema = load('scenario.schema.json');
+export const allSchemas = {
+    record: recordSchema,
+    recordSubmission: recordSubmissionSchema,
+    finding: findingSchema,
+    pattern: patternSchema,
+    recommendation: recommendationSchema,
+    doctrine: doctrineSchema,
+    policy: policySchema,
+    scenario: scenarioSchema,
+};
+export { compileSchema, validatePayload, createAjv, _resetValidatorCacheForTests, } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/validate.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Ajv2020 validator factory for the schemas owned by this package.
+ *
+ * This is the canonical place to compile a testing-os schema. Sibling packages
+ * (verify, findings, ingest) historically each wired their own Ajv instance per
+ * schema; consumers can now go through {@link compileSchema} or
+ * {@link validatePayload} to share one warm validator per schema and stay in
+ * lockstep with the contract package itself.
+ *
+ * Ajv setup mirrors the existing in-tree convention:
+ *   - `ajv/dist/2020.js` for draft 2020-12
+ *   - `ajv-formats` registered for `date-time`, `uri`, etc.
+ *   - `allErrors: true, strict: false`
+ *
+ * Strict is off because the in-tree schemas use `description` on root objects
+ * (which Ajv strict mode treats as an unknown keyword in some contexts) and
+ * we want all errors to surface in tests, not just the first.
+ */
+import type { ValidateFunction } from 'ajv';
+import { type SchemaName } from './index.js';
+declare const Ajv2020Ctor: new (opts?: {
+    allErrors?: boolean;
+    strict?: boolean;
+}) => {
+    compile: (schema: unknown) => ValidateFunction;
+    addFormat: (...args: unknown[]) => unknown;
+};
+export interface ValidationError {
+    path: string;
+    message: string;
+    params?: Record<string, unknown>;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Build a fresh Ajv2020 instance with the in-tree convention. Exposed so
+ * callers that need to register additional schemas, vocabularies, or formats
+ * can do so without forking this module.
+ */
+export declare function createAjv(): InstanceType<typeof Ajv2020Ctor>;
+/**
+ * Compile (and cache) the validator for one of the eight named schemas.
+ *
+ * Use this when you want the raw Ajv {@link ValidateFunction} — for example,
+ * to inspect `validate.errors` directly or wire it into a custom error
+ * formatter. For the common case prefer {@link validatePayload}.
+ */
+export declare function compileSchema(name: SchemaName): ValidateFunction;
+/**
+ * Validate a payload against one of the named schemas and return a
+ * structured result with normalised error paths/messages.
+ *
+ * Mirrors the shape used by `packages/verify/validators/schema.js` and
+ * `packages/findings/validate.js` so consumers can migrate without
+ * refactoring their error-handling code.
+ */
+export declare function validatePayload(name: SchemaName, payload: unknown): ValidationResult;
+/**
+ * Test-only helper for clearing the compiled-validator cache. Production code
+ * should never need this — the cache is correct because schemas are immutable
+ * for the lifetime of the process.
+ */
+export declare function _resetValidatorCacheForTests(): void;
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +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"}

package/dist/validate.js

@@ -0,0 +1,87 @@
+/**
+ * Ajv2020 validator factory for the schemas owned by this package.
+ *
+ * This is the canonical place to compile a testing-os schema. Sibling packages
+ * (verify, findings, ingest) historically each wired their own Ajv instance per
+ * schema; consumers can now go through {@link compileSchema} or
+ * {@link validatePayload} to share one warm validator per schema and stay in
+ * lockstep with the contract package itself.
+ *
+ * Ajv setup mirrors the existing in-tree convention:
+ *   - `ajv/dist/2020.js` for draft 2020-12
+ *   - `ajv-formats` registered for `date-time`, `uri`, etc.
+ *   - `allErrors: true, strict: false`
+ *
+ * Strict is off because the in-tree schemas use `description` on root objects
+ * (which Ajv strict mode treats as an unknown keyword in some contexts) and
+ * we want all errors to surface in tests, not just the first.
+ */
+import Ajv2020Module from 'ajv/dist/2020.js';
+import addFormatsModule from 'ajv-formats';
+import { allSchemas } from './index.js';
+// 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.
+const Ajv2020Ctor = (Ajv2020Module.default ?? Ajv2020Module);
+const addFormats = (addFormatsModule.default ?? addFormatsModule);
+const validatorCache = new Map();
+/**
+ * Build a fresh Ajv2020 instance with the in-tree convention. Exposed so
+ * callers that need to register additional schemas, vocabularies, or formats
+ * can do so without forking this module.
+ */
+export function createAjv() {
+    const ajv = new Ajv2020Ctor({ allErrors: true, strict: false });
+    addFormats(ajv);
+    return ajv;
+}
+/**
+ * Compile (and cache) the validator for one of the eight named schemas.
+ *
+ * Use this when you want the raw Ajv {@link ValidateFunction} — for example,
+ * to inspect `validate.errors` directly or wire it into a custom error
+ * formatter. For the common case prefer {@link validatePayload}.
+ */
+export function compileSchema(name) {
+    const cached = validatorCache.get(name);
+    if (cached)
+        return cached;
+    const schema = allSchemas[name];
+    if (!schema) {
+        throw new Error(`Unknown schema name: ${String(name)}`);
+    }
+    const ajv = createAjv();
+    const validate = ajv.compile(schema);
+    validatorCache.set(name, validate);
+    return validate;
+}
+/**
+ * Validate a payload against one of the named schemas and return a
+ * structured result with normalised error paths/messages.
+ *
+ * Mirrors the shape used by `packages/verify/validators/schema.js` and
+ * `packages/findings/validate.js` so consumers can migrate without
+ * refactoring their error-handling code.
+ */
+export function validatePayload(name, payload) {
+    const validate = compileSchema(name);
+    const valid = validate(payload);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validate.errors ?? []).map(err => ({
+        path: err.instancePath || '/',
+        message: err.message ?? 'unknown error',
+        params: err.params,
+    }));
+    return { valid: false, errors };
+}
+/**
+ * Test-only helper for clearing the compiled-validator cache. Production code
+ * should never need this — the cache is correct because schemas are immutable
+ * for the lifetime of the process.
+ */
+export function _resetValidatorCacheForTests() {
+    validatorCache.clear();
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@dogfood-lab/schemas",
+  "version": "1.2.0",
+  "description": "JSON schemas for the testing-os contract spine — record, finding, pattern, recommendation, doctrine, policy, scenario, submission.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./json/*": "./src/json/*"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests"
+  },
+  "files": [
+    "dist",
+    "src/json",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1"
+  },
+  "devDependencies": {
+    "vitest": "^3.0.0"
+  },
+  "author": "mcp-tool-shop",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dogfood-lab/testing-os.git",
+    "directory": "packages/schemas"
+  },
+  "homepage": "https://github.com/dogfood-lab/testing-os",
+  "bugs": {
+    "url": "https://github.com/dogfood-lab/testing-os/issues"
+  },
+  "keywords": [
+    "testing-os",
+    "dogfood-lab",
+    "json-schema",
+    "evidence",
+    "verification",
+    "contracts"
+  ]
+}

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

@@ -0,0 +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" }
+  }
+}