@unbrained/pm-cli 2026.8.18 → 2026.8.20

package/scripts/generate-agent-capability-surfaces.mjs

@@ -7,6 +7,7 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { renderPmCommandVisibilityMarkdown } from "../dist/sdk/agent-capability-contracts.js";
+import { renderPmFlagLexiconMarkdown } from "../dist/sdk/cli-contracts/flag-lexicon-contracts.js";
 
 const repositoryRoot = path.resolve(
   path.dirname(fileURLToPath(import.meta.url)),
@@ -16,24 +17,29 @@ export async function main(
   root = repositoryRoot,
   args = process.argv.slice(2),
 ) {
-  const outputPath = path.join(
-    root,
-    "docs",
-    "generated",
-    "AGENT_COMMAND_SURFACE.md",
-  );
-  const expected = renderPmCommandVisibilityMarkdown();
+  const outputs = [
+    ["AGENT_COMMAND_SURFACE.md", renderPmCommandVisibilityMarkdown()],
+    ["FLAG_LEXICON_BUDGETS.md", renderPmFlagLexiconMarkdown()],
+  ];
   if (args.includes("--check")) {
-    const actual = await readFile(outputPath, "utf8").catch(() => "");
-    if (actual !== expected) {
-      throw new Error(
-        "Generated agent command surface is stale. Run pnpm contracts:agent-surfaces:update.",
-      );
+    for (const [filename, expected] of outputs) {
+      const actual = await readFile(
+        path.join(root, "docs", "generated", filename),
+        "utf8",
+      ).catch(() => "");
+      if (actual !== expected) {
+        throw new Error(
+          `Generated agent capability surface ${filename} is stale. Run pnpm contracts:agent-surfaces:update.`,
+        );
+      }
     }
     return;
   }
-  await mkdir(path.dirname(outputPath), { recursive: true });
-  await writeFile(outputPath, expected, "utf8");
+  const outputDirectory = path.join(root, "docs", "generated");
+  await mkdir(outputDirectory, { recursive: true });
+  for (const [filename, expected] of outputs) {
+    await writeFile(path.join(outputDirectory, filename), expected, "utf8");
+  }
 }
 
 /* c8 ignore start -- CLI auto-run guard; logic is covered through main(). */