ossrules.md

changeset-validation

Validate changesets in openai-agents-js using LLM judgment against git diffs (including uncommitted local changes). Use when packages/ or .changeset/ are modified, or when verifying PR changeset compliance and bump level.

Install
npx skills add 'https://github.com/openai/openai-agents-js/tree/main/.agents/skills/changeset-validation'
Download bundle ↓
main · 506f736 ↗Scanned 2026-09-17

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

scripts/changeset-assign-milestone.mjs

scripts/changeset-assign-milestone.mjsBrowse 7 files
View on GitHub
1,873 tokens

7,079 bytes
Token encoding: o200k_base
Snapshot 506f736

← Back to SKILL.md
#!/usr/bin/env node import fs from 'fs';import { execFileSync } from 'child_process'; const { fetch, console, process } = globalThis; function printUsage() {  console.log('Usage: pnpm changeset:assign-milestone -- <path-to-json>');} function readJson(filePath) {  const contents = fs.readFileSync(filePath, 'utf8');  return JSON.parse(contents);} function parseMilestoneTitle(title) {  const match = title.match(/^(\d+)\.(\d+)\.x$/);  if (!match) return null;  return { major: Number(match[1]), minor: Number(match[2]), title };} const bumpRanks = {  none: 0,  patch: 1,  minor: 2,  major: 3,}; function maxBump(left, right) {  return bumpRanks[right] > bumpRanks[left] ? right : left;} function bumpFromChangesetLine(line) {  const match = line.match(    /^\s*['"]?[^'":]+['"]?\s*:\s*(patch|minor|major)\s*$/,  );  return match?.[1];} function changesetBumpFromContent(content) {  const parts = content.split('---');  if (parts.length < 3) {    return 'none';  }  let bump = 'none';  for (const line of parts[1].split(/\r?\n/)) {    const lineBump = bumpFromChangesetLine(line);    if (lineBump) {      bump = maxBump(bump, lineBump);    }  }  return bump;} function changedChangesetFiles(baseSha, headSha) {  const diff = execFileSync(    'git',    ['diff', '--name-only', `${baseSha}...${headSha}`, '--', '.changeset'],    { encoding: 'utf8' },  ).trim();  return diff    ? diff        .split(/\r?\n/)        .filter((file) => file.endsWith('.md') && !file.endsWith('README.md'))    : [];} function changesetBumpForEvent(event) {  const baseSha = event?.pull_request?.base?.sha;  const headSha = event?.pull_request?.head?.sha;  if (!baseSha || !headSha) {    return 'none';  }   let bump = 'none';  for (const file of changedChangesetFiles(baseSha, headSha)) {    let content;    try {      content = execFileSync('git', ['show', `${headSha}:${file}`], {        encoding: 'utf8',      });    } catch (_error) {      continue;    }    bump = maxBump(bump, changesetBumpFromContent(content));  }  return bump;} async function listOpenMilestones(owner, repo, token) {  if (process.env.CHANGESET_ASSIGN_MILESTONE_MILESTONES_JSON) {    return JSON.parse(process.env.CHANGESET_ASSIGN_MILESTONE_MILESTONES_JSON);  }   const milestonesResponse = await fetch(    `https://api.github.com/repos/${owner}/${repo}/milestones?state=open&per_page=100`,    {      headers: {        Accept: 'application/vnd.github+json',        Authorization: `Bearer ${token}`,      },    },  );   if (!milestonesResponse.ok) {    console.warn(      `Milestone assignment skipped (failed to list milestones: ${milestonesResponse.status}).`,    );    return null;  }   return milestonesResponse.json();} async function assignMilestone(releaseBump) {  if (releaseBump === 'none') {    console.log('Milestone assignment skipped (no package changes).');    return;  }   const token = process.env.GITHUB_TOKEN;  if (!token) {    console.warn('Milestone assignment skipped (missing GITHUB_TOKEN).');    return;  }   const eventPath = process.env.GITHUB_EVENT_PATH;  if (!eventPath) {    console.warn('Milestone assignment skipped (missing GITHUB_EVENT_PATH).');    return;  }   let event;  try {    event = JSON.parse(fs.readFileSync(eventPath, 'utf8'));  } catch (_error) {    console.warn(      'Milestone assignment skipped (failed to read event payload).',    );    return;  }   const owner = event?.repository?.owner?.login;  const repo = event?.repository?.name;  const prNumber = event?.pull_request?.number;  if (!owner || !repo || !prNumber) {    console.warn(      'Milestone assignment skipped (missing repository or PR info).',    );    return;  }   const milestones = await listOpenMilestones(owner, repo, token);  if (!milestones) {    return;  }   const parsed = milestones    .map((milestone) => ({      milestone,      parsed: parseMilestoneTitle(milestone.title),    }))    .filter((entry) => entry.parsed)    .sort((a, b) => {      if (a.parsed.major !== b.parsed.major)        return a.parsed.major - b.parsed.major;      return a.parsed.minor - b.parsed.minor;    });   if (parsed.length === 0) {    console.warn(      'Milestone assignment skipped (no open milestones matching X.Y.x).',    );    return;  }   const majors = Array.from(    new Set(parsed.map((entry) => entry.parsed.major)),  ).sort((a, b) => a - b);  const currentMajor = majors[0];  const nextMajor = majors[1];   const currentMajorEntries = parsed.filter(    (entry) => entry.parsed.major === currentMajor,  );  const patchTarget = currentMajorEntries[0];  const minorTarget = currentMajorEntries[1] ?? patchTarget;   let majorTarget;  if (nextMajor !== undefined) {    const nextMajorEntries = parsed.filter(      (entry) => entry.parsed.major === nextMajor,    );    majorTarget = nextMajorEntries[0];  }   let targetEntry;  if (releaseBump === 'major') {    targetEntry = majorTarget;  } else if (releaseBump === 'minor') {    targetEntry = minorTarget;  } else {    targetEntry = patchTarget;  }  if (!targetEntry) {    console.warn(      'Milestone assignment skipped (not enough open milestones for selection).',    );    return;  }   if (process.env.CHANGESET_ASSIGN_MILESTONE_DRY_RUN === '1') {    console.log(`Milestone would be set to ${targetEntry.milestone.title}.`);    return;  }   const updateResponse = await fetch(    `https://api.github.com/repos/${owner}/${repo}/issues/${prNumber}`,    {      method: 'PATCH',      headers: {        Accept: 'application/vnd.github+json',        Authorization: `Bearer ${token}`,      },      body: JSON.stringify({ milestone: targetEntry.milestone.number }),    },  );   if (!updateResponse.ok) {    console.warn(      `Milestone assignment skipped (failed to update PR milestone: ${updateResponse.status}).`,    );    return;  }   console.log(`Milestone set to ${targetEntry.milestone.title}.`);} function main() {  const inputPath = process.argv    .slice(2)    .filter((arg) => arg !== '--')    .find(Boolean);  if (!inputPath) {    printUsage();    console.warn('Milestone assignment skipped (missing input path).');    return;  }   let data;  try {    data = readJson(inputPath);  } catch (_error) {    console.warn(      `Milestone assignment skipped (failed to read JSON from ${inputPath}).`,    );    return;  }   const requiredBump = data?.required_bump;  if (!requiredBump) {    console.warn('Milestone assignment skipped (missing required_bump).');    return;  }   let releaseBump = requiredBump;  if (process.env.GITHUB_EVENT_PATH) {    try {      const event = JSON.parse(        fs.readFileSync(process.env.GITHUB_EVENT_PATH, 'utf8'),      );      releaseBump = maxBump(requiredBump, changesetBumpForEvent(event));    } catch (_error) {      releaseBump = requiredBump;    }  }   assignMilestone(releaseBump).catch((error) => {    console.warn(`Milestone assignment skipped: ${error.message}`);  });} main();
← All OpenAI Agents SDK for TypeScript skillsProject instructions →