@makerx/yoke 0.12.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +1 -0
  2. package/dist/cli.js +175 -58
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -31,6 +31,7 @@ yoke sync --user # ~/.claude/skills
31
31
  yoke sync [--user] [--force] # write yoke's skills
32
32
  yoke review [number] # review a PR (used by /review)
33
33
  yoke review-ci # add the CI review workflow (used by /review-ci)
34
+ yoke review-gate <result> # block merging until the PR's latest review succeeds (used by review.yml)
34
35
  yoke models # list each provider's models
35
36
  ```
36
37
 
package/dist/cli.js CHANGED
@@ -7,7 +7,7 @@ import { Command } from "commander";
7
7
  // package.json
8
8
  var package_default = {
9
9
  name: "@makerx/yoke",
10
- version: "0.12.0",
10
+ version: "0.13.0",
11
11
  description: "Lean, user-invoked Claude Code skills for MakerX AI-assisted delivery, plus the CLI they call.",
12
12
  license: "MIT",
13
13
  author: "MakerX",
@@ -415,6 +415,45 @@ import { execFileSync as execFileSync2 } from "child_process";
415
415
  import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
416
416
  import { dirname as dirname2, join as join3 } from "path";
417
417
 
418
+ // src/features/review/shellQuote.ts
419
+ function shellQuote(value) {
420
+ return `'${value.replaceAll("'", `'\\''`)}'`;
421
+ }
422
+
423
+ // src/features/review/ciEntra.ts
424
+ var githubOidcIssuer = "https://token.actions.githubusercontent.com";
425
+ var entraTokenExchangeAudience = "api://AzureADTokenExchange";
426
+ function federatedCredential(repo, environment) {
427
+ return {
428
+ issuer: githubOidcIssuer,
429
+ audience: entraTokenExchangeAudience,
430
+ subject: environment ? `repo:${repo}:environment:${environment}` : `repo:${repo}:pull_request`
431
+ };
432
+ }
433
+ function federatedCredentialCommand(clientId, credential) {
434
+ const parameters = JSON.stringify({
435
+ name: "yoke-review-ci",
436
+ issuer: credential.issuer,
437
+ subject: credential.subject,
438
+ audiences: [credential.audience]
439
+ });
440
+ return `az ad app federated-credential create --id ${shellQuote(clientId)} --parameters ${shellQuote(parameters)}`;
441
+ }
442
+ function entraSetup({ clientId, environment }, repo) {
443
+ const credential = federatedCredential(repo, environment);
444
+ return [
445
+ "",
446
+ `Instead of an API key, the review signs in to Foundry as Entra app ${clientId}. So that the app trusts this repo's review runs, add a federated credential to it with:`,
447
+ ` issuer: ${credential.issuer}`,
448
+ ` audience: ${credential.audience}`,
449
+ ` subject: ${credential.subject}`,
450
+ "for example with:",
451
+ ` ${federatedCredentialCommand(clientId, credential)}`,
452
+ "and give the app the Cognitive Services User role on the Foundry resource.",
453
+ ...environment ? [`The job runs in the ${environment} environment; create it on the repo if it does not exist.`] : []
454
+ ];
455
+ }
456
+
418
457
  // src/features/review/pr.ts
419
458
  import { execFile } from "child_process";
420
459
  import { join as join2 } from "path";
@@ -506,6 +545,9 @@ async function submitPendingReview(pr2, review, body, exec2 = run) {
506
545
  async function discardPendingReview(pr2, review, exec2 = run) {
507
546
  await exec2("gh", ["api", "--method", "DELETE", `${reviewsPath(pr2)}/${review.id}`]);
508
547
  }
548
+ async function githubGet(path, exec2 = run) {
549
+ return JSON.parse(await exec2("gh", ["api", path]));
550
+ }
509
551
  var github = {
510
552
  open: (pr2) => openPendingReview(pr2),
511
553
  add: (review, comment) => addReviewComment(review, comment),
@@ -629,6 +671,8 @@ var reviewWorkflowRef = "MakerXStudio/yoke/.github/workflows/review.yml@main";
629
671
  var callerWorkflowPath = join3(".github", "workflows", "review-pr.yml");
630
672
  var baseUrlVariable = "REVIEW_CI_BASE_URL";
631
673
  var apiKeySecret = "REVIEW_CI_API_KEY";
674
+ var callerTriggerTypes = ["opened", "synchronize", "reopened", "ready_for_review"];
675
+ var gateCheck = "review / gate";
632
676
  function workflowSecrets({ entra }) {
633
677
  return entra ? [] : [apiKeySecret];
634
678
  }
@@ -692,9 +736,10 @@ function renderCallerWorkflow(workflow) {
692
736
  "",
693
737
  "on:",
694
738
  " pull_request:",
695
- " types: [opened, reopened, ready_for_review]",
739
+ ` types: [${callerTriggerTypes.join(", ")}]`,
696
740
  "",
697
741
  "permissions:",
742
+ " actions: read",
698
743
  " contents: read",
699
744
  " pull-requests: write",
700
745
  ...workflow.entra ? [" id-token: write"] : [],
@@ -709,9 +754,6 @@ function renderCallerWorkflow(workflow) {
709
754
  ""
710
755
  ].join("\n");
711
756
  }
712
- function shellQuote(value) {
713
- return `'${value.replaceAll("'", `'\\''`)}'`;
714
- }
715
757
  function setupCommands(settings, workflow) {
716
758
  const baseUrl = settings[`${workflow.provider}.baseUrl`];
717
759
  return [
@@ -719,23 +761,20 @@ function setupCommands(settings, workflow) {
719
761
  ...workflowSecrets(workflow).map((secret2) => `gh secret set ${secret2}`)
720
762
  ];
721
763
  }
722
- var githubOidcIssuer = "https://token.actions.githubusercontent.com";
723
- var entraTokenExchangeAudience = "api://AzureADTokenExchange";
724
- function federatedCredential(repo, environment) {
725
- return {
726
- issuer: githubOidcIssuer,
727
- audience: entraTokenExchangeAudience,
728
- subject: environment ? `repo:${repo}:environment:${environment}` : `repo:${repo}:pull_request`
729
- };
730
- }
731
- function federatedCredentialCommand(clientId, credential) {
732
- const parameters = JSON.stringify({
733
- name: "yoke-review-ci",
734
- issuer: credential.issuer,
735
- subject: credential.subject,
736
- audiences: [credential.audience]
737
- });
738
- return `az ad app federated-credential create --id ${shellQuote(clientId)} --parameters ${shellQuote(parameters)}`;
764
+ var gateRuleset = {
765
+ name: "yoke review",
766
+ target: "branch",
767
+ enforcement: "active",
768
+ conditions: { ref_name: { include: ["~DEFAULT_BRANCH"], exclude: [] } },
769
+ rules: [
770
+ {
771
+ type: "required_status_checks",
772
+ parameters: { strict_required_status_checks_policy: false, required_status_checks: [{ context: gateCheck }] }
773
+ }
774
+ ]
775
+ };
776
+ function rulesetCommand() {
777
+ return `echo ${shellQuote(JSON.stringify(gateRuleset))} | gh api --method POST 'repos/{owner}/{repo}/rulesets' --input -`;
739
778
  }
740
779
  var unknownRepo = "<owner>/<repo>";
741
780
  function githubRepo(cwd = process.cwd()) {
@@ -770,20 +809,6 @@ function writeCallerWorkflow(root, content) {
770
809
  writeFileSync2(path, content);
771
810
  return "wrote";
772
811
  }
773
- function entraSetup({ clientId, environment }, repo) {
774
- const credential = federatedCredential(repo, environment);
775
- return [
776
- "",
777
- `Instead of an API key, the review signs in to Foundry as Entra app ${clientId}. So that the app trusts this repo's review runs, add a federated credential to it with:`,
778
- ` issuer: ${credential.issuer}`,
779
- ` audience: ${credential.audience}`,
780
- ` subject: ${credential.subject}`,
781
- "for example with:",
782
- ` ${federatedCredentialCommand(clientId, credential)}`,
783
- "and give the app the Cognitive Services User role on the Foundry resource.",
784
- ...environment ? [`The job runs in the ${environment} environment; create it on the repo if it does not exist.`] : []
785
- ];
786
- }
787
812
  function reportHeading(outcome, workflow) {
788
813
  if (outcome === "printed")
789
814
  return [`yoke's version of ${callerWorkflowPath}, not saved to the repo:`, "", renderCallerWorkflow(workflow).trimEnd()];
@@ -805,10 +830,90 @@ function reviewCiReport(outcome, settings, workflow, repo) {
805
830
  ...variableAndSecretSetup(settings, workflow),
806
831
  ...workflow.entra ? entraSetup(workflow.entra, repo()) : [],
807
832
  "",
808
- outcome === "printed" ? "Once the repo's review workflow runs this review, commit and push it; each PR opened from this repo then gets a review." : `Commit and push ${callerWorkflowPath}; each PR opened from this repo then gets a review.`
833
+ outcome === "printed" ? "Once the repo's review workflow runs this review, commit and push it; each PR opened from this repo then gets a review." : `Commit and push ${callerWorkflowPath}; each PR opened from this repo then gets a review.`,
834
+ "",
835
+ `To block merging while the review fails, require the ${gateCheck} check on the default branch with:`,
836
+ ` ${rulesetCommand()}`,
837
+ "Run it only after this workflow is merged to the default branch, or pushes to open PRs get stuck waiting for a status."
809
838
  ].join("\n");
810
839
  }
811
840
 
841
+ // src/features/review/gate.ts
842
+ import { appendFileSync, readFileSync as readFileSync3 } from "fs";
843
+ import { setTimeout } from "timers/promises";
844
+ import { z as z2 } from "zod";
845
+ var eventSchema = z2.object({
846
+ action: z2.string(),
847
+ pull_request: z2.object({
848
+ number: z2.number(),
849
+ head: z2.object({ ref: z2.string(), repo: z2.object({ full_name: z2.string() }).nullable() }),
850
+ user: z2.object({ type: z2.string() })
851
+ })
852
+ });
853
+ var runsSchema = z2.object({
854
+ workflow_runs: z2.array(z2.object({ id: z2.number(), run_number: z2.number(), pull_requests: z2.array(z2.object({ number: z2.number() })) }))
855
+ });
856
+ var jobsSchema = z2.object({ jobs: z2.array(z2.object({ name: z2.string(), status: z2.string(), conclusion: z2.string().nullable() })) });
857
+ var pollInterval = 3e4;
858
+ var rerunHint = "Mark the PR as draft, then ready for review, to run the review again.";
859
+ var firstRunHint = "Mark the PR as ready for review (from draft if it is not one) to run it.";
860
+ function verdict(conclusion, message) {
861
+ const pass = conclusion === "success";
862
+ return { pass, message: pass ? message : `${message} ${rerunHint}` };
863
+ }
864
+ function gateContext(env = process.env) {
865
+ const { GITHUB_REPOSITORY, GITHUB_RUN_ID, GITHUB_RUN_NUMBER, GITHUB_SERVER_URL, GITHUB_EVENT_PATH } = env;
866
+ if (!GITHUB_REPOSITORY || !GITHUB_RUN_ID || !GITHUB_RUN_NUMBER || !GITHUB_SERVER_URL || !GITHUB_EVENT_PATH) {
867
+ throw new ReviewError("yoke review-gate runs only in a GitHub Actions pull_request workflow");
868
+ }
869
+ const event = eventSchema.safeParse(JSON.parse(readFileSync3(GITHUB_EVENT_PATH, "utf8")));
870
+ if (!event.success) throw new ReviewError("yoke review-gate runs only on pull_request events");
871
+ return {
872
+ repo: GITHUB_REPOSITORY,
873
+ runId: GITHUB_RUN_ID,
874
+ runNumber: Number(GITHUB_RUN_NUMBER),
875
+ serverUrl: GITHUB_SERVER_URL,
876
+ event: event.data
877
+ };
878
+ }
879
+ async function earlierRuns({ repo, runId, runNumber, event }, deps) {
880
+ const { workflow_id } = z2.object({ workflow_id: z2.number() }).parse(await deps.get(`repos/${repo}/actions/runs/${runId}`));
881
+ const query = new URLSearchParams({ event: "pull_request", branch: event.pull_request.head.ref, per_page: "100" });
882
+ const { workflow_runs } = runsSchema.parse(await deps.get(`repos/${repo}/actions/workflows/${workflow_id}/runs?${query.toString()}`));
883
+ return workflow_runs.filter((run2) => run2.run_number < runNumber && run2.pull_requests.some((pr2) => pr2.number === event.pull_request.number)).toSorted((a, b) => b.run_number - a.run_number).map((run2) => run2.id);
884
+ }
885
+ async function settledReview(repo, run2, deps) {
886
+ for (; ; ) {
887
+ const { jobs } = jobsSchema.parse(await deps.get(`repos/${repo}/actions/runs/${run2}/jobs`));
888
+ const review = jobs.find((job) => job.name.endsWith(" / review"));
889
+ if (!review || review.conclusion === "skipped") return void 0;
890
+ if (review.status === "completed") return review.conclusion ?? "unknown";
891
+ deps.log(`Waiting for the review in run ${run2} to finish (${review.status})`);
892
+ await deps.sleep(pollInterval);
893
+ }
894
+ }
895
+ async function reviewGate(reviewResult, context, deps) {
896
+ if (reviewResult !== "skipped") return verdict(reviewResult, `The review on this event finished with ${reviewResult}.`);
897
+ const { pull_request } = context.event;
898
+ if (pull_request.head.repo?.full_name !== context.repo || pull_request.user.type === "Bot") {
899
+ return verdict("success", "No review runs for PRs from forks or bots.");
900
+ }
901
+ for (const run2 of await earlierRuns(context, deps)) {
902
+ const conclusion = await settledReview(context.repo, run2, deps);
903
+ const url = `${context.serverUrl}/${context.repo}/actions/runs/${run2}`;
904
+ if (conclusion) return verdict(conclusion, `The latest review for this PR, in run ${url}, finished with ${conclusion}.`);
905
+ }
906
+ return { pass: false, message: `No review has completed for this PR yet. ${firstRunHint}` };
907
+ }
908
+ async function runReviewGate(reviewResult, out, env = process.env) {
909
+ const deps = { get: (path) => githubGet(path), sleep: (ms) => setTimeout(ms), log: out };
910
+ const { pass, message } = await reviewGate(reviewResult, gateContext(env), deps);
911
+ out(pass ? message : `::error::${message}`);
912
+ if (env.GITHUB_STEP_SUMMARY) appendFileSync(env.GITHUB_STEP_SUMMARY, `${message}
913
+ `);
914
+ return pass;
915
+ }
916
+
812
917
  // src/features/review/comments.ts
813
918
  var markerPrefix = "<!-- yoke-review:";
814
919
  function slug(text2) {
@@ -950,7 +1055,8 @@ function selfReviewNote(diff) {
950
1055
  This change adds or edits a workflow that calls \`MakerXStudio/yoke/.github/workflows/review.yml\`, the CI setup for this review. Review it like any other file, but these are yoke's deliberate design: do not raise them as findings, keep them in a consolidated review, or mention them in a summary.
951
1056
 
952
1057
  - Calling the workflow at \`@main\` rather than a tag or SHA.
953
- - The trigger types, including leaving out \`synchronize\`: a review is re-run by marking the PR as draft and then ready for review.
1058
+ - The trigger types, including \`synchronize\`: pushes run only the \`review / gate\` job, and a review is re-run by marking the PR as draft and then ready for review.
1059
+ - The \`actions: read\` permission: the gate reads earlier runs of the workflow to find the PR's latest review.
954
1060
  - Draft PRs being reviewed twice: the reusable workflow already skips drafts.
955
1061
 
956
1062
  Real defects in it are still findings, such as:
@@ -1309,7 +1415,7 @@ async function listModels(settings, fetchModels = fetch) {
1309
1415
  }
1310
1416
 
1311
1417
  // src/features/review/review.ts
1312
- import { existsSync as existsSync7, mkdirSync as mkdirSync4, mkdtempSync, readFileSync as readFileSync7, rmSync as rmSync2, writeFileSync as writeFileSync7 } from "fs";
1418
+ import { existsSync as existsSync7, mkdirSync as mkdirSync4, mkdtempSync, readFileSync as readFileSync8, rmSync as rmSync2, writeFileSync as writeFileSync7 } from "fs";
1313
1419
  import { homedir as homedir2, tmpdir } from "os";
1314
1420
  import { join as join8 } from "path";
1315
1421
 
@@ -1379,10 +1485,10 @@ async function withEntraToken(settings, { env, fetch: fetchFn = fetch, mask }) {
1379
1485
 
1380
1486
  // src/features/review/harness.ts
1381
1487
  import { spawn } from "child_process";
1382
- import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
1488
+ import { existsSync as existsSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
1383
1489
 
1384
1490
  // src/features/review/usage.ts
1385
- import { appendFileSync } from "fs";
1491
+ import { appendFileSync as appendFileSync2 } from "fs";
1386
1492
  var fields2 = ["input", "output", "cacheRead", "cacheWrite"];
1387
1493
  var rows = [
1388
1494
  ["reviewer1", "Reviewer 1"],
@@ -1445,7 +1551,7 @@ function writeJobSummary(summary, usage, log, env = process.env) {
1445
1551
  const path = env.GITHUB_STEP_SUMMARY;
1446
1552
  if (!path) return;
1447
1553
  try {
1448
- appendFileSync(path, `${jobSummary(summary, usage)}
1554
+ appendFileSync2(path, `${jobSummary(summary, usage)}
1449
1555
  `);
1450
1556
  log("wrote the review summary and token usage to the job summary");
1451
1557
  } catch (error) {
@@ -1571,7 +1677,7 @@ function exitError(harness, code, output) {
1571
1677
  return [`${harness} exited with code ${code ?? "unknown"}`, ...detail ? [detail] : []].join("\n");
1572
1678
  }
1573
1679
  function hasReview(path) {
1574
- return existsSync3(path) && readFileSync3(path, "utf8").trim().length > 0;
1680
+ return existsSync3(path) && readFileSync4(path, "utf8").trim().length > 0;
1575
1681
  }
1576
1682
  var runHarness = (run2) => new Promise((resolve) => {
1577
1683
  const shell = process.platform === "win32";
@@ -1625,11 +1731,11 @@ var runHarness = (run2) => new Promise((resolve) => {
1625
1731
  import { execFile as execFile2 } from "child_process";
1626
1732
 
1627
1733
  // src/features/review/run.ts
1628
- import { existsSync as existsSync6, readFileSync as readFileSync6, rmSync, writeFileSync as writeFileSync6 } from "fs";
1734
+ import { existsSync as existsSync6, readFileSync as readFileSync7, rmSync, writeFileSync as writeFileSync6 } from "fs";
1629
1735
  import { join as join6 } from "path";
1630
1736
 
1631
1737
  // src/features/review/cachedSlots.ts
1632
- import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "fs";
1738
+ import { existsSync as existsSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
1633
1739
  import { join as join4 } from "path";
1634
1740
  function slotsPath(reviewDir) {
1635
1741
  return join4(reviewDir, "slots.json");
@@ -1640,7 +1746,7 @@ function isCachedSlots(value) {
1640
1746
  function readCachedSlots(reviewDir) {
1641
1747
  const path = slotsPath(reviewDir);
1642
1748
  if (!existsSync4(path)) return {};
1643
- const parsed = JSON.parse(readFileSync4(path, "utf8"));
1749
+ const parsed = JSON.parse(readFileSync5(path, "utf8"));
1644
1750
  return isCachedSlots(parsed) ? parsed : {};
1645
1751
  }
1646
1752
  function cachedSlot(reviewDir, step) {
@@ -1794,7 +1900,7 @@ ${files.join("\n")}
1794
1900
  }
1795
1901
 
1796
1902
  // src/features/review/usedModels.ts
1797
- import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync5 } from "fs";
1903
+ import { existsSync as existsSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "fs";
1798
1904
  import { join as join5 } from "path";
1799
1905
  var repoUrl = "https://github.com/MakerXStudio/yoke";
1800
1906
  function modelsPath(reviewDir) {
@@ -1806,7 +1912,7 @@ function isUsedModels(value) {
1806
1912
  function readUsedModels(reviewDir) {
1807
1913
  const path = modelsPath(reviewDir);
1808
1914
  if (!existsSync5(path)) return {};
1809
- const parsed = JSON.parse(readFileSync5(path, "utf8"));
1915
+ const parsed = JSON.parse(readFileSync6(path, "utf8"));
1810
1916
  return isUsedModels(parsed) ? parsed : {};
1811
1917
  }
1812
1918
  function recordUsedModel(reviewDir, step, harness, model) {
@@ -1877,7 +1983,7 @@ async function runStep({ name, label, slot, ...step }, context) {
1877
1983
  }
1878
1984
  function hasOutput({ name, slot, outputPath }, context) {
1879
1985
  if (cachedSlot(context.reviewDir, name) !== describeSlot(slot)) return false;
1880
- return existsSync6(outputPath) && readFileSync6(outputPath, "utf8").trim().length > 0;
1986
+ return existsSync6(outputPath) && readFileSync7(outputPath, "utf8").trim().length > 0;
1881
1987
  }
1882
1988
  async function runOrReuse(step, context) {
1883
1989
  if (!hasOutput(step, context)) return { ok: await runStep(step, context), ran: true };
@@ -1904,7 +2010,7 @@ function synthesisResult(markdown) {
1904
2010
  function rawReviews(succeeded, context) {
1905
2011
  const report = succeeded.map((reviewer) => `# ${reviewerLabel(reviewer, context)} review
1906
2012
 
1907
- ${readFileSync6(reviewPath(context, reviewer), "utf8").trim()}`).join("\n\n");
2013
+ ${readFileSync7(reviewPath(context, reviewer), "utf8").trim()}`).join("\n\n");
1908
2014
  return { report, synthesis: null, markdown: null };
1909
2015
  }
1910
2016
  function synthesisSlot(succeeded, context) {
@@ -1921,7 +2027,7 @@ async function synthesise(requestPath, succeeded, reviewersRan, context) {
1921
2027
  }));
1922
2028
  const prompt = buildSynthesisPrompt(requestPath, files);
1923
2029
  if ((await runOrReuse({ name: "synthesis", label: `synthesis (${describeSlot(slot)})`, slot, prompt, outputPath }, context)).ok)
1924
- return synthesisResult(readFileSync6(outputPath, "utf8"));
2030
+ return synthesisResult(readFileSync7(outputPath, "utf8"));
1925
2031
  if (context.strict) throw new ReviewFailure("synthesis failed", "The synthesis failed; nothing to post.");
1926
2032
  context.log("showing the raw reviews instead");
1927
2033
  return rawReviews(succeeded, context);
@@ -2029,21 +2135,21 @@ async function assertViable(slots2, check = checks) {
2029
2135
  }
2030
2136
 
2031
2137
  // src/features/review/reviewLog.ts
2032
- import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync3 } from "fs";
2138
+ import { appendFileSync as appendFileSync3, mkdirSync as mkdirSync3 } from "fs";
2033
2139
  import { join as join7 } from "path";
2034
2140
  function reviewLog(command = process.argv.slice(2), now = () => /* @__PURE__ */ new Date()) {
2035
2141
  let path;
2036
2142
  let buffered = [];
2037
2143
  return {
2038
2144
  append: (line) => {
2039
- if (path) appendFileSync2(path, `${line}
2145
+ if (path) appendFileSync3(path, `${line}
2040
2146
  `);
2041
2147
  else buffered.push(line);
2042
2148
  },
2043
2149
  attach: (reviewDir) => {
2044
2150
  mkdirSync3(reviewDir, { recursive: true });
2045
2151
  path = join7(reviewDir, "review.log");
2046
- appendFileSync2(path, `${["", `=== ${now().toISOString()} ===`, `$ yoke ${command.join(" ")}`, ...buffered].join("\n")}
2152
+ appendFileSync3(path, `${["", `=== ${now().toISOString()} ===`, `$ yoke ${command.join(" ")}`, ...buffered].join("\n")}
2047
2153
  `);
2048
2154
  buffered = [];
2049
2155
  }
@@ -2102,7 +2208,7 @@ async function reviewAtHead(pr2, reviewDir, request, slots2, ui, strict) {
2102
2208
  }
2103
2209
  function savedReview(path, post) {
2104
2210
  if (!post || !existsSync7(path)) return null;
2105
- return parseSynthesis(readFileSync7(path, "utf8"));
2211
+ return parseSynthesis(readFileSync8(path, "utf8"));
2106
2212
  }
2107
2213
  function saveReview(path, markdown) {
2108
2214
  if (markdown) writeFileSync7(path, markdown);
@@ -2164,7 +2270,7 @@ async function reviewPr(number, settings, { post, force }, io) {
2164
2270
  }
2165
2271
 
2166
2272
  // src/features/sync/sync.ts
2167
- import { existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync8 } from "fs";
2273
+ import { existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync9, writeFileSync as writeFileSync8 } from "fs";
2168
2274
  import { homedir as homedir3 } from "os";
2169
2275
  import { join as join9 } from "path";
2170
2276
 
@@ -2216,6 +2322,8 @@ A workflow is an LLM review if it has a model review PRs, whatever tool it uses.
2216
2322
 
2217
2323
  Never ask whether to overwrite a workflow. If \`review-pr.yml\` exists and differs, edit it in place.
2218
2324
 
2325
+ The \`review / gate\` merge gate needs the \`synchronize\` trigger and \`actions: read\` permission from \`--print\`; add them to an edited workflow if missing.
2326
+
2219
2327
  If no workflow or setting names the models, ask which model each reviewer runs. For LiteLLM, offer \`yoke models\`. For Foundry, ask for deployment names.
2220
2328
 
2221
2329
  For Foundry with Entra, reuse the client and tenant IDs from the existing workflow; ask only if none is there.
@@ -2229,7 +2337,7 @@ Never ask whether they are set for the organisation, and don't query org setting
2229
2337
 
2230
2338
  With Entra, check \`az ad app federated-credential list --id <client-id>\` and show the printed create command if the credential is missing.
2231
2339
 
2232
- Finish with what changed and what's left: commit and push the workflow.
2340
+ Finish with what changed and what's left: commit and push the workflow, then, only once it is merged to the default branch, run the printed \`gh api\` ruleset command requiring \`review / gate\`. Don't run it before then.
2233
2341
 
2234
2342
  If \`yoke\` is not found, run \`npm i -g @makerx/yoke\`.
2235
2343
  `
@@ -2255,7 +2363,7 @@ function skillsRoot(user, cwd = process.cwd(), home = homedir3()) {
2255
2363
  return join9(user ? home : cwd, ".claude", "skills");
2256
2364
  }
2257
2365
  function isOwnedByUser(skillFile) {
2258
- return existsSync8(skillFile) && !readFileSync8(skillFile, "utf8").includes(ownerMarker);
2366
+ return existsSync8(skillFile) && !readFileSync9(skillFile, "utf8").includes(ownerMarker);
2259
2367
  }
2260
2368
  function syncSkills(destination, userDestination, force = false, skills = bundledSkills) {
2261
2369
  const result = { written: [], skipped: [] };
@@ -2355,6 +2463,15 @@ addSettingOptions(
2355
2463
  process.exitCode = 1;
2356
2464
  }
2357
2465
  });
2466
+ program.command("review-gate").description("Block merging until the latest review that ran for the PR succeeds; fork and bot PRs pass. Used by review.yml's gate job").argument("<result>", "result of the review job on this event: success, failure, cancelled or skipped").action(async (result) => {
2467
+ try {
2468
+ if (!await runReviewGate(result, console.log)) process.exitCode = 1;
2469
+ } catch (error) {
2470
+ if (!(error instanceof ReviewError)) throw error;
2471
+ console.error(error.message);
2472
+ process.exitCode = 1;
2473
+ }
2474
+ });
2358
2475
  addSettingOptions(
2359
2476
  program.command("models").description("List the models each configured provider serves, for review.*.provider and review.*.model"),
2360
2477
  providerKeys
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@makerx/yoke",
3
- "version": "0.12.0",
3
+ "version": "0.13.0",
4
4
  "description": "Lean, user-invoked Claude Code skills for MakerX AI-assisted delivery, plus the CLI they call.",
5
5
  "license": "MIT",
6
6
  "author": "MakerX",