Generate typed QX bindings and add source editing tools

src/capability-language/resource-cli.ts

@@ -2,6 +2,7 @@
 
 import { writeFile } from "node:fs/promises";
 import process from "node:process";
+import { bindingSchema } from "../bindings/index.js";
 import {
   compileCapabilityResourceRepository,
   type ResolvedCapabilityResource,
@@ -10,7 +11,7 @@ import { createGitCapabilityResolver } from "./git-resolver.js";
 
 const usage = `usage: quixos-resource-compile --root DIRECTORY --kind interface|package
        --repository URL --commit GIT_REV --checkout-root DIRECTORY
-       [--snapshot-map PATH] [--graph-out PATH]
+       [--snapshot-map PATH] [--snapshot-only true] [--graph-out PATH] [--schema-out PATH]
 
 Resolves a standalone resource's recursive dependency-lock graph, validates
 its interface.qx or package.qx manifest, and emits the checked resource as JSON.`;
@@ -21,6 +22,7 @@ const parseArgs = (args: string[]) => {
     const key = args[index];
     const value = args[index + 1];
     if (!key?.startsWith("--") || !value) throw new Error(usage);
+    if (!["--root", "--kind", "--repository", "--commit", "--checkout-root", "--snapshot-map", "--snapshot-only", "--graph-out", "--schema-out"].includes(key) || values.has(key)) throw new Error(usage);
     values.set(key, value);
   }
   const rootDirectory = values.get("--root");
@@ -35,6 +37,7 @@ const parseArgs = (args: string[]) => {
   if (!/^([0-9a-f]{40}|[0-9a-f]{64})$/.test(commit)) {
     throw new Error("--commit must be a full Git object ID");
   }
+  if (values.has("--snapshot-only") && values.get("--snapshot-only") !== "true") throw new Error("--snapshot-only accepts true");
   return {
     rootDirectory,
     kind,
@@ -42,7 +45,9 @@ const parseArgs = (args: string[]) => {
     commit,
     checkoutRoot,
     snapshotMap: values.get("--snapshot-map"),
+    snapshotOnly: values.get("--snapshot-only") === "true",
     graphOut: values.get("--graph-out"),
+    schemaOut: values.get("--schema-out"),
   } as const;
 };
 
@@ -70,6 +75,7 @@ const main = async () => {
   const resolveResource = await createGitCapabilityResolver({
     checkoutRoot: options.checkoutRoot,
     snapshotMap: options.snapshotMap,
+    snapshotOnly: options.snapshotOnly,
   });
   const compiled = await compileCapabilityResourceRepository({
     rootDirectory: options.rootDirectory,
@@ -92,6 +98,7 @@ const main = async () => {
       resources: compiled.resources.map(graphEntry),
     }, null, 2)}\n`);
   }
+  if (options.schemaOut) await writeFile(options.schemaOut, `${JSON.stringify(bindingSchema(compiled), null, 2)}\n`);
   process.stdout.write(`${JSON.stringify(compiled.resource, null, 2)}\n`);
 };