@formigio/fazemos-cli 0.10.53 → 0.10.54

package/dist/index.js

@@ -3814,6 +3814,30 @@ function findPhaseById(definition, phaseId) {
     return (definition?.phases || []).find((p) => p.id === phaseId);
 }
 const VALID_STEP_TYPES = ['human', 'agent', 'script', 'gate', 'human_approval'];
+/**
+ * G15 — resolve a template identifier that may be a UUID *or* a template name
+ * to a UUID. The template-by-id endpoints (`GET/PUT/PATCH /api/pipeline-templates/:id`)
+ * require a UUID param (`requireUuidParam` middleware — a non-UUID arg returns
+ * "id must be a valid UUID" with empty stdout), so a name like "aiv-full-auto"
+ * must first be resolved via the project-scoped list. UUIDs pass through
+ * untouched (no extra API call). Names are matched within the active project
+ * (or `--project <slug>`); slug is also matched for forward-compatibility if the
+ * API ever adds one.
+ */
+async function resolveTemplateId(idOrName, opts = {}) {
+    if (UUID_RE.test(idOrName))
+        return idOrName;
+    const data = await api('GET', '/api/pipeline-templates', undefined, projectOpts(opts));
+    const matches = (data.templates ?? []).filter((t) => t.name === idOrName || t.slug === idOrName);
+    if (matches.length === 1)
+        return matches[0].id;
+    if (matches.length === 0) {
+        throw new Error(`No template named "${idOrName}" in the active project. ` +
+            `Run "tpl list" to see names/IDs, pass --project <slug> to look in another project, or use the template UUID.`);
+    }
+    throw new Error(`Multiple templates named "${idOrName}" (${matches.map((t) => t.id).join(', ')}). ` +
+        `Use the template UUID to disambiguate.`);
+}
 // ── Templates ──────────────────────────────────────────────
 const templates = program.command('templates').alias('tpl').description('Pipeline template commands.\n\n' +
     '  Templates define multi-step workflows: template → phases → steps → I/O.\n' +
@@ -3856,12 +3880,14 @@ templates
 templates
     .command('show')
     .description('Show template detail including phases, steps, I/O declarations, pipeline inputs, and revision number. Use this to inspect the full structure of a template and discover phase/step IDs needed by other commands.')
-    .argument('<id>', 'Template ID (use "tpl list" to find IDs)')
+    .argument('<id>', 'Template ID or name (use "tpl list" to find them)')
     .option('--json', 'Output the template definition as JSON (same as tpl export). Useful for piping/inspecting without a temp file.')
     .option('--show-sections', 'Print full sections content for all steps (default: truncated at 200 chars)')
+    .option('--project <slug>', 'Override active project when resolving a template name')
     .action(async (id, opts) => {
     try {
-        const data = await api('GET', `/api/pipeline-templates/${id}`);
+        const resolvedId = await resolveTemplateId(id, opts);
+        const data = await api('GET', `/api/pipeline-templates/${resolvedId}`);
         const t = data.template;
         // --json mode: emit definition JSON (same as tpl export)
         if (opts.json) {
@@ -3982,11 +4008,13 @@ templates
 templates
     .command('export')
     .description('Export a template\'s full definition JSON to stdout or a file. Includes all phases, steps, sections, verification, uat, agent_config, I/O wires, and pipeline inputs. The exported JSON is the canonical input to "tpl update-definition". Round-trip: tpl export <id> > def.json && tpl update-definition <id> def.json is a no-op.')
-    .argument('<id>', 'Template ID (use "tpl list" to find IDs)')
+    .argument('<id>', 'Template ID or name (use "tpl list" to find them)')
     .option('--out <file>', 'Write output to file instead of stdout')
+    .option('--project <slug>', 'Override active project when resolving a template name')
     .action(async (id, opts) => {
     try {
-        const data = await api('GET', `/api/pipeline-templates/${id}`);
+        const resolvedId = await resolveTemplateId(id, opts);
+        const data = await api('GET', `/api/pipeline-templates/${resolvedId}`);
         const t = data.template;
         const json = JSON.stringify(t.definition, null, 2);
         if (opts.out) {