@galaxy-tool-util/cli 1.0.0 → 1.2.0

package/dist/meta-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-build.d.ts","sourceRoot":"","sources":["../src/meta-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AAC3D,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAO/D"}

package/dist/meta-build.js

@@ -0,0 +1,60 @@
+export function extractProgram(program) {
+    return {
+        name: program.name(),
+        description: program.description(),
+        version: program.version() ?? "",
+        commands: program.commands.map((c) => extractCommand(c, program.name())),
+    };
+}
+function extractCommand(cmd, parentPath) {
+    const name = cmd.name();
+    const fullName = `${parentPath} ${name}`.trim();
+    return {
+        name,
+        fullName,
+        description: cmd.description(),
+        synopsis: `${fullName} ${cmd.usage()}`.trim(),
+        args: cmd.registeredArguments.map(extractArg),
+        options: cmd.options.map(extractOption),
+        commands: cmd.commands.map((c) => extractCommand(c, fullName)),
+    };
+}
+function extractArg(arg) {
+    return {
+        raw: arg.name(),
+        name: arg.name(),
+        required: arg.required,
+        variadic: arg.variadic,
+        description: arg.description || undefined,
+    };
+}
+function extractOption(opt) {
+    const flags = opt.flags;
+    const name = opt.attributeName();
+    const short = opt.short || undefined;
+    const placeholder = extractPlaceholder(flags);
+    return {
+        flags,
+        name,
+        short,
+        description: opt.description,
+        takesArgument: placeholder !== undefined,
+        argumentPlaceholder: placeholder,
+        optionalArgument: placeholder?.startsWith("[") ?? false,
+        negatable: opt.long?.startsWith("--no-") ?? false,
+        defaultValue: serializableDefault(opt.defaultValue),
+    };
+}
+function extractPlaceholder(flags) {
+    const match = flags.match(/[<[][^>\]]+[>\]]/);
+    return match ? match[0] : undefined;
+}
+function serializableDefault(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=meta-build.js.map

package/dist/meta-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-build.js","sourceRoot":"","sources":["../src/meta-build.ts"],"names":[],"mappings":"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"}

package/dist/programs/galaxy-tool-cache.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `galaxy-tool-cache` commander program — built at runtime from
+ * `spec/galaxy-tool-cache.json` plus the handler registry below.
+ */
+import type { Command } from "commander";
+export declare function buildGalaxyToolCacheProgram(): Command;
+//# sourceMappingURL=galaxy-tool-cache.d.ts.map

package/dist/programs/galaxy-tool-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"galaxy-tool-cache.d.ts","sourceRoot":"","sources":["../../src/programs/galaxy-tool-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC,wBAAgB,2BAA2B,IAAI,OAAO,CAErD"}

package/dist/programs/galaxy-tool-cache.js

@@ -0,0 +1,22 @@
+import { runAdd } from "../commands/add.js";
+import { runList } from "../commands/list.js";
+import { runInfo } from "../commands/info.js";
+import { runClear } from "../commands/clear.js";
+import { runPopulateWorkflow } from "../commands/populate-workflow.js";
+import { runSchema } from "../commands/schema.js";
+import { runStructuralSchema } from "../commands/structural-schema.js";
+import { buildProgramFromSpec } from "../spec/build-program.js";
+import { galaxyToolCacheSpec } from "../meta/specs.js";
+const handlers = {
+    add: runAdd,
+    list: runList,
+    info: runInfo,
+    clear: runClear,
+    schema: runSchema,
+    populateWorkflow: runPopulateWorkflow,
+    structuralSchema: runStructuralSchema,
+};
+export function buildGalaxyToolCacheProgram() {
+    return buildProgramFromSpec(galaxyToolCacheSpec, handlers);
+}
+//# sourceMappingURL=galaxy-tool-cache.js.map

package/dist/programs/galaxy-tool-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"galaxy-tool-cache.js","sourceRoot":"","sources":["../../src/programs/galaxy-tool-cache.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAwB,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,QAAQ,GAAoB;IAChC,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,SAAS;IACjB,gBAAgB,EAAE,mBAAmB;IACrC,gBAAgB,EAAE,mBAAmB;CACtC,CAAC;AAEF,MAAM,UAAU,2BAA2B;IACzC,OAAO,oBAAoB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC"}

package/dist/programs/gxwf.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `gxwf` commander program — built at runtime from `spec/gxwf.json`
+ * plus the handler registry below. The JSON spec is the source of truth
+ * for the command surface; this file just wires action functions to
+ * spec entries by name.
+ */
+import type { Command } from "commander";
+export declare function buildGxwfProgram(): Command;
+//# sourceMappingURL=gxwf.d.ts.map

package/dist/programs/gxwf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gxwf.d.ts","sourceRoot":"","sources":["../../src/programs/gxwf.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuEzC,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}

package/dist/programs/gxwf.js

@@ -0,0 +1,56 @@
+import { runClean } from "../commands/clean.js";
+import { runCleanTree } from "../commands/clean-tree.js";
+import { runConvert } from "../commands/convert.js";
+import { runConvertTree } from "../commands/convert-tree.js";
+import { runRoundtrip } from "../commands/roundtrip.js";
+import { runRoundtripTree } from "../commands/roundtrip-tree.js";
+import { runLint } from "../commands/lint.js";
+import { runMermaid } from "../commands/mermaid.js";
+import { runCytoscapeJs } from "../commands/cytoscapejs.js";
+import { runLintTree } from "../commands/lint-tree.js";
+import { runValidateWorkflow } from "../commands/validate-workflow.js";
+import { runValidateTests } from "../commands/validate-tests.js";
+import { runValidateTestsTree } from "../commands/validate-tests-tree.js";
+import { runValidateTree } from "../commands/validate-tree.js";
+import { runToolSearch } from "../commands/tool-search.js";
+import { runToolVersions } from "../commands/tool-versions.js";
+import { runToolRevisions } from "../commands/tool-revisions.js";
+import { runRepoSearch } from "../commands/repo-search.js";
+import { buildProgramFromSpec } from "../spec/build-program.js";
+import { gxwfSpec } from "../meta/specs.js";
+const handlers = {
+    validateWorkflow: runValidateWorkflow,
+    validateTests: runValidateTests,
+    clean: runClean,
+    lint: runLint,
+    convert: runConvert,
+    roundtrip: runRoundtrip,
+    mermaid: (file, output, opts) => runMermaid(file, {
+        output,
+        comments: opts.comments,
+        annotateConnections: opts.annotateConnections,
+        cacheDir: opts.cacheDir,
+    }),
+    cytoscapeJs: (file, output, opts) => runCytoscapeJs(file, {
+        output,
+        html: opts.html,
+        json: opts.json,
+        annotateConnections: opts.annotateConnections,
+        cacheDir: opts.cacheDir,
+        layout: opts.layout,
+    }),
+    validateTree: runValidateTree,
+    lintTree: runLintTree,
+    cleanTree: runCleanTree,
+    convertTree: runConvertTree,
+    roundtripTree: runRoundtripTree,
+    validateTestsTree: runValidateTestsTree,
+    toolSearch: runToolSearch,
+    toolVersions: runToolVersions,
+    toolRevisions: runToolRevisions,
+    repoSearch: runRepoSearch,
+};
+export function buildGxwfProgram() {
+    return buildProgramFromSpec(gxwfSpec, handlers);
+}
+//# sourceMappingURL=gxwf.js.map

package/dist/programs/gxwf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gxwf.js","sourceRoot":"","sources":["../../src/programs/gxwf.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAwB,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,QAAQ,GAAoB;IAChC,gBAAgB,EAAE,mBAAmB;IACrC,aAAa,EAAE,gBAAgB;IAC/B,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,YAAY;IACvB,OAAO,EAAE,CACP,IAAY,EACZ,MAA0B,EAC1B,IAA8E,EAC9E,EAAE,CACF,UAAU,CAAC,IAAI,EAAE;QACf,MAAM;QACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;IACJ,WAAW,EAAE,CACX,IAAY,EACZ,MAA0B,EAC1B,IAMC,EACD,EAAE,CACF,cAAc,CAAC,IAAI,EAAE;QACnB,MAAM;QACN,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;IACJ,YAAY,EAAE,eAAe;IAC7B,QAAQ,EAAE,WAAW;IACrB,SAAS,EAAE,YAAY;IACvB,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,gBAAgB;IAC/B,iBAAiB,EAAE,oBAAoB;IACvC,UAAU,EAAE,aAAa;IACzB,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,gBAAgB;IAC/B,UAAU,EAAE,aAAa;CAC1B,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC"}

package/dist/spec/build-program.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Build a commander `Command` tree from a declarative `ProgramSpec` plus
+ * a name-keyed handler registry. The spec carries the static shape
+ * (commands, args, options, defaults); the registry supplies the
+ * runtime action functions.
+ */
+import { Command } from "commander";
+import type { ProgramSpec } from "../meta/spec-types.js";
+export type HandlerFn = (...args: any[]) => void | Promise<void>;
+export type HandlerRegistry = Record<string, HandlerFn>;
+export declare function buildProgramFromSpec(spec: ProgramSpec, handlers: HandlerRegistry): Command;
+//# sourceMappingURL=build-program.d.ts.map

package/dist/spec/build-program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-program.d.ts","sourceRoot":"","sources":["../../src/spec/build-program.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,uBAAuB,CAAC;AAElF,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAExD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAS1F"}

package/dist/spec/build-program.js

@@ -0,0 +1,102 @@
+/**
+ * Build a commander `Command` tree from a declarative `ProgramSpec` plus
+ * a name-keyed handler registry. The spec carries the static shape
+ * (commands, args, options, defaults); the registry supplies the
+ * runtime action functions.
+ */
+import { Command } from "commander";
+export function buildProgramFromSpec(spec, handlers) {
+    validateSpec(spec, handlers);
+    const program = new Command();
+    program.name(spec.name).description(spec.description).version(spec.version);
+    const groups = spec.optionGroups ?? {};
+    for (const cmd of spec.commands) {
+        program.addCommand(buildCommand(cmd, groups, handlers));
+    }
+    return program;
+}
+/**
+ * Cheap structural checks the YAML loader doesn't catch — duplicate
+ * names, dangling refs, missing handlers. Runs before commander touches
+ * the spec so errors point at the YAML, not at a confusing commander
+ * stack trace.
+ */
+function validateSpec(spec, handlers) {
+    const groups = spec.optionGroups ?? {};
+    const seenCommands = new Set();
+    for (const cmd of spec.commands) {
+        if (seenCommands.has(cmd.name)) {
+            throw new Error(`Duplicate command "${cmd.name}" in spec "${spec.name}"`);
+        }
+        seenCommands.add(cmd.name);
+        if (!handlers[cmd.handler]) {
+            throw new Error(`Missing handler "${cmd.handler}" for command "${cmd.name}"`);
+        }
+        const seenOptions = new Set();
+        const checkOptName = (flags) => {
+            const optName = attributeNameFromFlags(flags);
+            if (seenOptions.has(optName)) {
+                throw new Error(`Duplicate option "${optName}" on command "${cmd.name}"`);
+            }
+            seenOptions.add(optName);
+        };
+        for (const opt of cmd.options ?? [])
+            checkOptName(opt.flags);
+        for (const groupName of cmd.optionGroups ?? []) {
+            const group = groups[groupName];
+            if (!group) {
+                throw new Error(`Command "${cmd.name}" references unknown optionGroup "${groupName}"`);
+            }
+            for (const opt of group)
+                checkOptName(opt.flags);
+        }
+    }
+}
+/**
+ * Extract the option's attributeName the same way commander does — the
+ * first long flag, stripped of `--no-` prefix and camelCased. Used only
+ * for duplicate detection here; commander itself owns the canonical
+ * derivation at runtime.
+ */
+function attributeNameFromFlags(flags) {
+    const long = flags.split(/[ ,|]+/).find((part) => part.startsWith("--"));
+    if (!long)
+        return flags;
+    const stripped = long.replace(/^--(no-)?/, "");
+    return stripped.replace(/-([a-z])/g, (_m, c) => c.toUpperCase());
+}
+function buildCommand(spec, groups, handlers) {
+    const cmd = new Command(spec.name).description(spec.description);
+    for (const arg of spec.args ?? []) {
+        if (arg.description !== undefined)
+            cmd.argument(arg.raw, arg.description);
+        else
+            cmd.argument(arg.raw);
+    }
+    for (const opt of spec.options ?? []) {
+        addOption(cmd, opt);
+    }
+    for (const groupName of spec.optionGroups ?? []) {
+        const group = groups[groupName];
+        if (!group) {
+            throw new Error(`Command "${spec.name}" references unknown optionGroup "${groupName}"`);
+        }
+        for (const opt of group)
+            addOption(cmd, opt);
+    }
+    const handler = handlers[spec.handler];
+    if (!handler) {
+        throw new Error(`Missing handler "${spec.handler}" for command "${spec.name}"`);
+    }
+    cmd.action(handler);
+    return cmd;
+}
+function addOption(cmd, opt) {
+    if (opt.default !== undefined) {
+        cmd.option(opt.flags, opt.description, String(opt.default));
+    }
+    else {
+        cmd.option(opt.flags, opt.description);
+    }
+}
+//# sourceMappingURL=build-program.js.map

package/dist/spec/build-program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-program.js","sourceRoot":"","sources":["../../src/spec/build-program.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galaxy-tool-util/cli",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "galaxy-tool-cache CLI — cache and inspect Galaxy tool metadata",
   "type": "module",
   "bin": {
@@ -11,10 +11,15 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./meta": {
+      "types": "./dist/meta/index.d.ts",
+      "import": "./dist/meta/index.js"
     }
   },
   "files": [
     "dist",
+    "spec",
     "README.md",
     "LICENSE"
   ],
@@ -34,8 +39,10 @@
     "effect": "^3.21.0",
     "nunjucks": "^3.2.4",
     "yaml": "^2.8.3",
-    "@galaxy-tool-util/core": "1.0.0",
-    "@galaxy-tool-util/schema": "1.0.0"
+    "@galaxy-tool-util/connection-validation": "1.2.0",
+    "@galaxy-tool-util/core": "1.2.0",
+    "@galaxy-tool-util/schema": "1.2.0",
+    "@galaxy-tool-util/search": "1.2.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",

package/spec/galaxy-tool-cache.json

@@ -0,0 +1,152 @@
+{
+  "name": "galaxy-tool-cache",
+  "description": "Cache and inspect Galaxy tool metadata",
+  "version": "1.0.0",
+  "commands": [
+    {
+      "name": "add",
+      "description": "Fetch a tool from ToolShed/Galaxy and cache it",
+      "handler": "add",
+      "args": [
+        {
+          "raw": "<tool_id>",
+          "description": "Tool ID (full toolshed path or TRS ID)"
+        }
+      ],
+      "options": [
+        {
+          "flags": "--version <ver>",
+          "description": "Tool version"
+        },
+        {
+          "flags": "--cache-dir <dir>",
+          "description": "Cache directory"
+        },
+        {
+          "flags": "--galaxy-url <url>",
+          "description": "Galaxy instance URL for fallback"
+        }
+      ]
+    },
+    {
+      "name": "list",
+      "description": "List cached tools",
+      "handler": "list",
+      "options": [
+        {
+          "flags": "--json",
+          "description": "Output as JSON"
+        },
+        {
+          "flags": "--cache-dir <dir>",
+          "description": "Cache directory"
+        }
+      ]
+    },
+    {
+      "name": "info",
+      "description": "Show metadata for a cached tool",
+      "handler": "info",
+      "args": [
+        {
+          "raw": "<tool_id>",
+          "description": "Tool ID"
+        }
+      ],
+      "options": [
+        {
+          "flags": "--version <ver>",
+          "description": "Tool version"
+        },
+        {
+          "flags": "--cache-dir <dir>",
+          "description": "Cache directory"
+        }
+      ]
+    },
+    {
+      "name": "clear",
+      "description": "Clear cached tools",
+      "handler": "clear",
+      "args": [
+        {
+          "raw": "[prefix]",
+          "description": "Only clear tools matching this prefix"
+        }
+      ],
+      "options": [
+        {
+          "flags": "--cache-dir <dir>",
+          "description": "Cache directory"
+        }
+      ]
+    },
+    {
+      "name": "schema",
+      "description": "Export JSON Schema for a cached tool's parameters",
+      "handler": "schema",
+      "args": [
+        {
+          "raw": "<tool_id>",
+          "description": "Tool ID"
+        }
+      ],
+      "options": [
+        {
+          "flags": "--version <ver>",
+          "description": "Tool version"
+        },
+        {
+          "flags": "--representation <rep>",
+          "description": "State representation (e.g., workflow_step)",
+          "default": "workflow_step"
+        },
+        {
+          "flags": "--output <file>",
+          "description": "Output file (default: stdout)"
+        },
+        {
+          "flags": "--cache-dir <dir>",
+          "description": "Cache directory"
+        }
+      ]
+    },
+    {
+      "name": "populate-workflow",
+      "description": "Scan a workflow and cache all referenced tools",
+      "handler": "populateWorkflow",
+      "args": [
+        {
+          "raw": "<file>",
+          "description": "Workflow file (.ga, .gxwf.yml)"
+        }
+      ],
+      "options": [
+        {
+          "flags": "--cache-dir <dir>",
+          "description": "Cache directory"
+        },
+        {
+          "flags": "--galaxy-url <url>",
+          "description": "Galaxy instance URL for fallback"
+        }
+      ]
+    },
+    {
+      "name": "structural-schema",
+      "description": "Export the structural JSON Schema for Galaxy workflows",
+      "handler": "structuralSchema",
+      "options": [
+        {
+          "flags": "--format <fmt>",
+          "description": "Workflow format: format2 (default) or native",
+          "default": "format2"
+        },
+        {
+          "flags": "--output <file>",
+          "description": "Output file (default: stdout)"
+        }
+      ]
+    }
+  ]
+}