dev: sync with main

.github/templates/agenda.md

@@ -1,4 +1,4 @@
-## Weekly meetings happen on Thursdays at 9am - 10am Pacific
+## Weekly meetings happen on Thursdays at 9am - 10am Pacific Standard Time / Pacific Daylight Time (UTC-0800, UTC-0700)
 
 This agenda gives visibility into discussion topics for the weekly Technical Developer Community (TDC) meetings. Sharing agenda items in advance allows people to plan to attend meetings where they have an interest in specific topics. 
 
@@ -31,8 +31,7 @@ Intros and governance meta-topics (5 mins) | TDC | |
 Reports from Special Interest Groups (5 mins) | SIG members | |
 Any other business (add comments below to suggest topics) | TDC | |
 [Approved spec PRs](https://github.com/OAI/OpenAPI-Specification/pulls?q=is%3Apr+is%3Aopen+review%3Aapproved) | @OAI/tsc | |
-[Active Projects](https://github.com/OAI/OpenAPI-Specification/projects?query=is%3Aopen) | @OAI/openapi-maintainers | |
-[New issues needing attention](https://github.com/search?q=repo%3Aoai%2Fopenapi-specification+is%3Aissue+comments%3A0+no%3Alabel+is%3Aopen) | @OAI/triage  | |
+[Spec Publishing PRs](https://github.com/OAI/spec.openapis.org/pulls) | @OAI/tsc | |
 Identify next week's meeting host (2 mins) | All | Comment on next week's agenda |
 
 /cc [@OAI/tsc](https://github.com/orgs/OAI/teams/tsc) please suggest items for inclusion.

AI.md

@@ -46,16 +46,16 @@ Do not use AI to summarise discussion content and then reply to the summary. The
 
 ## Enforcement
 
-Maintainers reserve the right to close any pull request, issue, or discussion thread that appears to represent low-effort or AI-generated content, without providing detailed justification.
+Maintainers reserve the right to close any pull request, issue, or discussion thread that appears to represent low-effort or undisclosed AI-generated content, without providing detailed justification.
 Repeated violations may result in a block from OpenAPI Initiative repositories.
 
-Reviewer time and expertise are the scarcest resources this project has, and so this policy is there to protect them and ensure the long-term healthy and viability of the project.
+Reviewer time and expertise are the scarcest resources this project has, and so this policy is there to protect them and ensure the long-term health and viability of the project.
 You are always welcome to reach out to us via GitHub or Slack to discuss any of these points or their application.
 
 ## Acknowledgements
 
 This policy builds on and acknowledges the work of:
 
-- [Mastodon AI Contribution Policy](https://github.com/mastodon/mastodon/blob/main/AI_POLICY.md)
+- [Mastodon AI Contribution Policy](https://github.com/mastodon/.github/blob/main/AI_POLICY.md)
 - [W3C: Use of Large Language Models in Standards Work](https://www.w3.org/TR/llms-standards/)
 - [FastAPI / tiangolo contributing guidelines](https://tiangolo.com/open-source/contributing/#automated-code-and-ai), in particular the framing of low-effort AI submissions as a denial-of-service attack on human effort

CONTRIBUTING.md

@@ -209,7 +209,7 @@ Before creating a pull request or marking a draft pull request as ready for revi
    | `yarn validate-markdown` | markdownlint + link check only — fast loop while editing |
    | `yarn format-markdown` | auto-fix markdownlint violations |
    | `yarn build-src` | full check: validation, HTML build, schema publish |
-   | `yarn test` | runs the JSON Schema and build tooling test suites |
+   | `yarn test` | runs the repository's JSON Schema and Markdown rendering fixture tests |
 
 5. After `yarn build-src`, open output file `deploy-preview/oas.html` with a browser and check your changes
 

spec.config.json

@@ -39,6 +39,17 @@
     "schema.yaml",
     "schema-base.yaml"
   ],
+  "tests": {
+    "md2html": {
+      "fixtures": "tests/md2html/fixtures",
+      "config": "spec.config.json",
+      "otherVersions": [
+        "path/31.0.0.md",
+        "path/30.0.1.md",
+        "path/30.0.0.md"
+      ]
+    }
+  },
   "release": {
     "sourcePath": "src/oas.md",
     "releaseHistoryNote": "$releaseType of the OpenAPI Specification $version",

tests/md2html/md2html.test.mjs

@@ -1,49 +1,3 @@
-import { readdirSync, readFileSync } from "node:fs";
-import { execFile } from "node:child_process";
-import { resolve } from "node:path";
-import { describe, test, expect } from "@oai/build-infra/test";
-import assert from "node:assert";
+import { registerMd2htmlFixtureTests } from "@oai/build-infra/test/md2html";
 
-const folder = "./tests/md2html/fixtures/";
-describe("md2html", async () => {
-  readdirSync(folder, { withFileTypes: true })
-    .filter((entry) => entry.isFile() && /\.md$/.test(entry.name))
-    .forEach((entry) => {
-      test(entry.name, async () => {
-        const expected = readFileSync(
-          folder + entry.name.replace(".md", ".html"),
-          "utf8",
-        ); 
-        const output = await md2html(
-          [
-            "--spec-config",
-            "spec.config.json",
-            "--maintainers",
-            entry.name.replace(".md", ".maintainers"),
-            entry.name,
-            "path/31.0.0.md\npath/30.0.1.md\npath/30.0.0.md",
-          ],
-          folder,
-        );
-        expect(output.stdout).to.equal(expected);
-      });
-    });
-});
-
-function md2html(args, cwd) {
-  return new Promise((res) => {
-    execFile(
-      "node",
-      [`${resolve("./node_modules/@oai/build-infra/src/md2html/md2html.js")}`, ...args],
-      { cwd },
-      (error, stdout, stderr) => {
-        res({
-          code: error?.code || 0,
-          error,
-          stdout,
-          stderr,
-        });
-      },
-    );
-  });
-}
+registerMd2htmlFixtureTests();