@planu/cli 0.28.0 → 0.30.0

package/dist/engine/spec-templates/query.js

@@ -1,5 +1,6 @@
 // engine/spec-templates/query.ts — Catalog querying: list and find templates.
 import { BUILT_IN_TEMPLATES } from './catalog.js';
+import { loadCustomTemplates, mergeTemplates } from './custom-loader.js';
 /**
  * Converts a full SpecTemplateEntry to a summary TemplateListItem.
  */
@@ -8,20 +9,29 @@ function toListItem(template) {
         id: template.id,
         name: template.name,
         category: template.category,
+        subcategory: template.subcategory,
         description: template.description,
         tags: template.tags,
+        complexityScore: template.complexityScore,
+        criteriaCount: template.criteria.length,
         variableCount: template.variables.length,
         requiredVariableCount: template.variables.filter((v) => v.required).length,
     };
 }
 /**
- * Lists templates from the catalog, optionally filtered by category and/or search term.
+ * Lists templates from the catalog, optionally filtered by category, search, and complexity.
+ * Includes custom user templates from data/global/spec-templates/custom/.
  */
-export function listTemplates(category, search) {
-    let templates = [...BUILT_IN_TEMPLATES];
+export async function listTemplates(category, search, complexityScore, customDir) {
+    const customResult = await loadCustomTemplates(customDir);
+    const allTemplates = mergeTemplates(BUILT_IN_TEMPLATES, customResult.templates);
+    let templates = [...allTemplates];
     if (category !== undefined) {
         templates = templates.filter((t) => t.category === category);
     }
+    if (complexityScore !== undefined) {
+        templates = templates.filter((t) => t.complexityScore === complexityScore);
+    }
     if (search !== undefined && search.trim().length > 0) {
         const term = search.trim().toLowerCase();
         templates = templates.filter((t) => t.name.toLowerCase().includes(term) ||
@@ -30,22 +40,34 @@ export function listTemplates(category, search) {
     }
     const filterLabel = [
         category !== undefined ? `category=${category}` : '',
+        complexityScore !== undefined ? `complexity=${complexityScore}` : '',
         search !== undefined && search.trim().length > 0 ? `search="${search.trim()}"` : '',
     ]
         .filter(Boolean)
         .join(', ');
     return {
-        templates: templates.map(toListItem),
-        total: templates.length,
-        filteredBy: filterLabel.length > 0 ? filterLabel : undefined,
+        result: {
+            templates: templates.map(toListItem),
+            total: templates.length,
+            filteredBy: filterLabel.length > 0 ? filterLabel : undefined,
+        },
+        warnings: customResult.warnings,
     };
 }
 /**
- * Returns a single template by ID, or undefined if not found.
+ * Returns a single template by ID (built-in only, sync).
  */
 export function findTemplate(templateId) {
     return BUILT_IN_TEMPLATES.find((t) => t.id === templateId);
 }
+/**
+ * Returns a single template by ID, searching built-in and custom templates.
+ */
+export async function findTemplateWithCustom(templateId, customDir) {
+    const customResult = await loadCustomTemplates(customDir);
+    const allTemplates = mergeTemplates(BUILT_IN_TEMPLATES, customResult.templates);
+    return allTemplates.find((t) => t.id === templateId);
+}
 /**
  * Returns all available categories that have at least one template.
  */

package/dist/engine/spec-templates/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/engine/spec-templates/query.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAQ9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD;;GAEG;AACH,SAAS,UAAU,CAAC,QAA2B;IAC7C,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM;QACxC,qBAAqB,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM;KAC3E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAA2B,EAAE,MAAe;IACxE,IAAI,SAAS,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC;IAExC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACzC,SAAS,GAAG,SAAS,CAAC,MAAM,CAC1B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;YACnC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC1C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG;QAClB,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;QACpD,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE;KACpF;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;QACpC,KAAK,EAAE,SAAS,CAAC,MAAM;QACvB,UAAU,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/engine/spec-templates/query.ts"],"names":[],"mappings":"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"}

package/dist/engine/spec-templates/renderer.d.ts

@@ -1,4 +1,4 @@
-import type { SpecTemplateEntry, TemplateVariableValue, TemplateVariable } from '../../types/spec-templates.js';
+import type { SpecTemplateEntry, TemplateVariableValue, TemplateVariable, TemplateCriterion } from '../../types/spec-templates.js';
 /**
  * Interpolates all {{Key}} placeholders in a template string with provided values.
  * Falls back to defaultValue if a variable is optional and not provided.
@@ -8,12 +8,37 @@ export declare function interpolate(template: string, variables: TemplateVariabl
  * Returns the keys of required variables that are missing from the provided values.
  */
 export declare function findMissingRequired(template: SpecTemplateEntry, variables: TemplateVariableValue[]): string[];
+/**
+ * Resolves which criteria to include and generates warnings for forced-required criteria.
+ * AC-07: Required criteria cannot be omitted.
+ */
+export declare function resolveCriteria(allCriteria: TemplateCriterion[], includeCriteria?: string[]): {
+    included: TemplateCriterion[];
+    warnings: string[];
+};
+/**
+ * Filters HU template content to include only the selected criteria sections.
+ * Renumbers criteria sequentially (AC-01, AC-02, ...) to avoid gaps.
+ */
+export declare function filterHuByCriteria(huContent: string, allCriteria: TemplateCriterion[], includedCriteria: TemplateCriterion[]): string;
+/**
+ * Filters PROGRESS template to include only selected criteria.
+ */
+export declare function filterProgressByCriteria(progressContent: string, allCriteria: TemplateCriterion[], includedCriteria: TemplateCriterion[]): string;
+/**
+ * Builds the estimation section to inject into the HU.md (AC-09).
+ */
+export declare function buildEstimationSection(template: SpecTemplateEntry): string;
 /**
  * Renders all three template files (HU, FICHA-TECNICA, PROGRESS) with the provided values.
+ * Supports partial criteria selection and estimation injection.
  */
-export declare function renderTemplate(template: SpecTemplateEntry, variables: TemplateVariableValue[]): {
+export declare function renderTemplate(template: SpecTemplateEntry, variables: TemplateVariableValue[], includeCriteria?: string[]): {
     hu: string;
     fichaTecnica: string;
     progress: string;
+    criteriaIncluded: number;
+    criteriaTotal: number;
+    warnings: string[];
 };
 //# sourceMappingURL=renderer.d.ts.map

package/dist/engine/spec-templates/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-templates/renderer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,qBAAqB,EAAE,EAClC,WAAW,EAAE,gBAAgB,EAAE,GAC9B,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,qBAAqB,EAAE,GACjC,MAAM,EAAE,CAWV;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,qBAAqB,EAAE,GACjC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAOxD"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-templates/renderer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,qBAAqB,EAAE,EAClC,WAAW,EAAE,gBAAgB,EAAE,GAC9B,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,qBAAqB,EAAE,GACjC,MAAM,EAAE,CAWV;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,iBAAiB,EAAE,EAChC,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB;IAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAyBvD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,iBAAiB,EAAE,EAChC,gBAAgB,EAAE,iBAAiB,EAAE,GACpC,MAAM,CA+BR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,iBAAiB,EAAE,EAChC,gBAAgB,EAAE,iBAAiB,EAAE,GACpC,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAW1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,qBAAqB,EAAE,EAClC,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB;IACD,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CA0BA"}

package/dist/engine/spec-templates/renderer.js

@@ -1,5 +1,6 @@
 // engine/spec-templates/renderer.ts — Template variable substitution engine.
 // Replaces {{VariableKey}} placeholders with user-provided values.
+// Supports partial criteria selection (AC-07) and estimation injection (AC-09).
 /**
  * Interpolates all {{Key}} placeholders in a template string with provided values.
  * Falls back to defaultValue if a variable is optional and not provided.
@@ -31,15 +32,129 @@ export function findMissingRequired(template, variables) {
     }));
     return template.variables.filter((v) => v.required && !providedKeys.has(v.key)).map((v) => v.key);
 }
+/**
+ * Resolves which criteria to include and generates warnings for forced-required criteria.
+ * AC-07: Required criteria cannot be omitted.
+ */
+export function resolveCriteria(allCriteria, includeCriteria) {
+    if (includeCriteria === undefined || includeCriteria.length === 0) {
+        return { included: allCriteria, warnings: [] };
+    }
+    const requestedIds = new Set(includeCriteria);
+    const warnings = [];
+    const included = [];
+    for (const criterion of allCriteria) {
+        const isRequested = requestedIds.has(criterion.id);
+        if (isRequested) {
+            included.push(criterion);
+        }
+        else if (criterion.required) {
+            // Required criterion was excluded — force-include with warning
+            included.push(criterion);
+            warnings.push(`Criterion "${criterion.id}: ${criterion.title}" is required and was included automatically.`);
+        }
+        // Optional, not requested → omit
+    }
+    return { included, warnings };
+}
+/**
+ * Filters HU template content to include only the selected criteria sections.
+ * Renumbers criteria sequentially (AC-01, AC-02, ...) to avoid gaps.
+ */
+export function filterHuByCriteria(huContent, allCriteria, includedCriteria) {
+    if (includedCriteria.length === allCriteria.length) {
+        return huContent;
+    }
+    const includedIds = new Set(includedCriteria.map((c) => c.id));
+    const lines = huContent.split('\n');
+    const outputLines = [];
+    let currentCriterionId;
+    let isIncluded = true;
+    let renumberIndex = 0;
+    // Map from old AC IDs to which ones are included
+    const criterionIdPattern = /^### (AC-\d+)/;
+    for (const line of lines) {
+        const match = criterionIdPattern.exec(line);
+        if (match?.[1] !== undefined) {
+            currentCriterionId = match[1];
+            isIncluded = includedIds.has(currentCriterionId);
+            if (isIncluded) {
+                renumberIndex++;
+                const renumbered = line.replace(/^### AC-\d+/, `### AC-${renumberIndex}`);
+                outputLines.push(renumbered);
+            }
+        }
+        else if (isIncluded) {
+            outputLines.push(line);
+        }
+    }
+    return outputLines.join('\n');
+}
+/**
+ * Filters PROGRESS template to include only selected criteria.
+ */
+export function filterProgressByCriteria(progressContent, allCriteria, includedCriteria) {
+    if (includedCriteria.length === allCriteria.length) {
+        return progressContent;
+    }
+    const includedIds = new Set(includedCriteria.map((c) => c.id));
+    const lines = progressContent.split('\n');
+    const outputLines = [];
+    let renumberIndex = 0;
+    for (const line of lines) {
+        const criterionMatch = /^- \[ \] (AC-\d+):/.exec(line);
+        if (criterionMatch?.[1] !== undefined) {
+            if (includedIds.has(criterionMatch[1])) {
+                renumberIndex++;
+                const renumbered = line.replace(/AC-\d+/, `AC-${renumberIndex}`);
+                outputLines.push(renumbered);
+            }
+        }
+        else {
+            outputLines.push(line);
+        }
+    }
+    return outputLines.join('\n');
+}
+/**
+ * Builds the estimation section to inject into the HU.md (AC-09).
+ */
+export function buildEstimationSection(template) {
+    const { complexityScore, estimationBase } = template;
+    return [
+        '',
+        '## Estimacion Inicial',
+        '',
+        `- **Complejidad:** ${complexityScore}`,
+        `- **Horas estimadas:** ${estimationBase.hoursMin}–${estimationBase.hoursMax}h`,
+        `- **Notas:** ${estimationBase.notes}`,
+        '',
+    ].join('\n');
+}
 /**
  * Renders all three template files (HU, FICHA-TECNICA, PROGRESS) with the provided values.
+ * Supports partial criteria selection and estimation injection.
  */
-export function renderTemplate(template, variables) {
+export function renderTemplate(template, variables, includeCriteria) {
     const defs = template.variables;
+    // Resolve criteria selection
+    const { included, warnings } = resolveCriteria(template.criteria, includeCriteria);
+    // Interpolate variables first
+    let hu = interpolate(template.huTemplate, variables, defs);
+    const fichaTecnica = interpolate(template.fichaTecnicaTemplate, variables, defs);
+    let progress = interpolate(template.progressTemplate, variables, defs);
+    // Filter criteria if partial selection
+    hu = filterHuByCriteria(hu, template.criteria, included);
+    progress = filterProgressByCriteria(progress, template.criteria, included);
+    // Inject estimation section into HU (AC-09)
+    hu += buildEstimationSection(template);
     return {
-        hu: interpolate(template.huTemplate, variables, defs),
-        fichaTecnica: interpolate(template.fichaTecnicaTemplate, variables, defs),
-        progress: interpolate(template.progressTemplate, variables, defs),
+        hu,
+        fichaTecnica,
+        progress,
+        criteriaIncluded: included.length,
+        criteriaTotal: template.criteria.length,
+        warnings,
     };
 }
 //# sourceMappingURL=renderer.js.map

package/dist/engine/spec-templates/renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../src/engine/spec-templates/renderer.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,mEAAmE;AAQnE;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,SAAkC,EAClC,WAA+B;IAE/B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAiB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEjF,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QAC/D,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QAC1D,IAAI,UAAU,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;YAC3C,OAAO,UAAU,CAAC,YAAY,CAAC;QACjC,CAAC;QAED,qFAAqF;QACrF,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA2B,EAC3B,SAAkC;IAElC,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,SAAS;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QACjD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACvD,CAAC,CAAC,CACL,CAAC;IAEF,OAAO,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACpG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA2B,EAC3B,SAAkC;IAElC,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC;IAChC,OAAO;QACL,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC;QACrD,YAAY,EAAE,WAAW,CAAC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,EAAE,IAAI,CAAC;QACzE,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,EAAE,IAAI,CAAC;KAClE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../src/engine/spec-templates/renderer.ts"],"names":[],"mappings":"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"}

package/dist/engine/spec-templates/templates-api-ui.d.ts

@@ -0,0 +1,6 @@
+import type { SpecTemplateEntry } from '../../types/spec-templates.js';
+/** REST API endpoint spec template. */
+export declare const REST_API_ENDPOINT_TEMPLATE: SpecTemplateEntry;
+/** UI Form spec template. */
+export declare const UI_FORM_TEMPLATE: SpecTemplateEntry;
+//# sourceMappingURL=templates-api-ui.d.ts.map

package/dist/engine/spec-templates/templates-api-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates-api-ui.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-templates/templates-api-ui.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,uCAAuC;AACvC,eAAO,MAAM,0BAA0B,EAAE,iBAiHxC,CAAC;AAEF,6BAA6B;AAC7B,eAAO,MAAM,gBAAgB,EAAE,iBA+F9B,CAAC"}

package/dist/engine/spec-templates/templates-api-ui.js

@@ -0,0 +1,215 @@
+// engine/spec-templates/templates-api-ui.ts — REST API endpoint + UI form templates.
+// Extracted from catalog.ts to keep file sizes within limits.
+/** REST API endpoint spec template. */
+export const REST_API_ENDPOINT_TEMPLATE = {
+    id: 'rest-api-endpoint',
+    name: 'REST API Endpoint',
+    category: 'api',
+    description: 'A single REST endpoint with validation, error handling, and documentation.',
+    tags: ['api', 'rest', 'endpoint', 'openapi'],
+    complexityScore: 'S',
+    estimationBase: {
+        hoursMin: 4,
+        hoursMax: 8,
+        notes: 'Single endpoint with validation and error handling',
+    },
+    criteria: [
+        { id: 'AC-1', title: 'Request validation', required: true },
+        { id: 'AC-2', title: 'Core business logic', required: true },
+        { id: 'AC-3', title: 'Response contract', required: true },
+        { id: 'AC-4', title: 'Error handling', required: true },
+        { id: 'AC-5', title: 'Idempotency', required: false },
+        { id: 'AC-6', title: 'Observability', required: false },
+    ],
+    variables: [
+        {
+            key: 'EndpointName',
+            label: 'Endpoint name',
+            description: 'Short descriptive name for this endpoint',
+            example: 'Submit Order',
+            required: true,
+        },
+        {
+            key: 'HttpMethod',
+            label: 'HTTP Method',
+            description: 'HTTP method: GET, POST, PUT, PATCH, DELETE',
+            example: 'POST',
+            required: true,
+        },
+        {
+            key: 'Path',
+            label: 'URL path',
+            description: 'The URL path for this endpoint',
+            example: '/orders/submit',
+            required: true,
+        },
+    ],
+    huTemplate: `# HU: REST API Endpoint — {{EndpointName}}
+
+## User Story
+As an API consumer, I want a reliable {{HttpMethod}} {{Path}} endpoint so that I can {{EndpointName}} without client-side workarounds.
+
+## Acceptance Criteria
+
+### AC-1: Request validation
+- [ ] Input schema validated at the boundary
+- [ ] Invalid requests return 422 with structured error messages
+- [ ] Content-Type header checked when applicable
+
+### AC-2: Core business logic
+- [ ] {{EndpointName}} logic is encapsulated in a dedicated use-case function
+- [ ] Side effects (emails, notifications, jobs) are isolated and testable
+
+### AC-3: Response contract
+- [ ] Success response follows the API response envelope convention
+- [ ] HTTP status codes match the operation semantics
+- [ ] Response schema is documented (OpenAPI or equivalent)
+
+### AC-4: Error handling
+- [ ] All error paths return structured JSON (not stack traces)
+- [ ] 404 returned for missing resources
+- [ ] 409 returned for conflicts
+- [ ] 500 never leaks internal details
+
+### AC-5: Idempotency (if applicable)
+- [ ] Idempotency key header supported for non-idempotent operations
+- [ ] Duplicate requests handled gracefully
+
+### AC-6: Observability
+- [ ] Endpoint logged with method, path, status, latency
+- [ ] Errors reported to the monitoring system
+`,
+    fichaTecnicaTemplate: `# FICHA TÉCNICA: REST API Endpoint — {{EndpointName}}
+
+## Affected Files
+- handlers/{{Path}} (route handler)
+- use-cases/{{EndpointName}} (business logic)
+- validators/{{EndpointName}}-input
+- openapi/paths/{{Path}} (documentation)
+
+## Types / Entities
+- \`{{EndpointName}}Input\`: validated request payload
+- \`{{EndpointName}}Output\`: response body shape
+- \`ApiError\`: code, message, details[]
+
+## Risks
+- Missing idempotency for mutation → duplicate side effects
+- Unbounded response size → add pagination or field projection
+- Missing auth guard → unauthorized access
+
+## Estimation (rough)
+- Dev: 4–8 hours
+- Review: 1–2 hours
+- Difficulty: 2/5
+`,
+    progressTemplate: `# PROGRESS: REST API Endpoint — {{EndpointName}}
+
+## Status: draft
+
+## Criteria
+- [ ] AC-1: Request validation
+- [ ] AC-2: Core business logic
+- [ ] AC-3: Response contract
+- [ ] AC-4: Error handling
+- [ ] AC-5: Idempotency
+- [ ] AC-6: Observability
+`,
+};
+/** UI Form spec template. */
+export const UI_FORM_TEMPLATE = {
+    id: 'ui-form',
+    name: 'UI Form',
+    category: 'ui',
+    description: 'Interactive form with validation, error display, and accessibility.',
+    tags: ['ui', 'form', 'ux', 'accessibility', 'validation'],
+    complexityScore: 'S',
+    estimationBase: {
+        hoursMin: 4,
+        hoursMax: 10,
+        notes: 'Form with client-side validation and accessibility',
+    },
+    criteria: [
+        { id: 'AC-1', title: 'Field validation', required: true },
+        { id: 'AC-2', title: 'Submit behavior', required: true },
+        { id: 'AC-3', title: 'Accessibility', required: true },
+        { id: 'AC-4', title: 'Responsive design', required: false },
+        { id: 'AC-5', title: 'Reset and cancel', required: false },
+    ],
+    variables: [
+        {
+            key: 'FormName',
+            label: 'Form name',
+            description: 'Name of the form (e.g. Registration, Checkout, Contact)',
+            example: 'Registration',
+            required: true,
+        },
+    ],
+    huTemplate: `# HU: {{FormName}} Form
+
+## User Story
+As a user, I want to fill out the {{FormName}} form with clear guidance so that I can complete the action without confusion.
+
+## Acceptance Criteria
+
+### AC-1: Field validation
+- [ ] Required fields marked visually
+- [ ] Validation runs on blur and on submit
+- [ ] Error messages appear adjacent to invalid fields
+- [ ] Valid fields show positive feedback
+
+### AC-2: Submit behavior
+- [ ] Form is disabled (loading state) during submission
+- [ ] Success state shown after successful submission
+- [ ] Errors from the API are displayed inline
+
+### AC-3: Accessibility
+- [ ] All inputs have visible labels
+- [ ] Error messages linked via aria-describedby
+- [ ] Form navigable via keyboard (Tab, Enter, Escape)
+- [ ] Screen reader announces validation errors
+
+### AC-4: Responsive design
+- [ ] Form renders correctly on mobile, tablet, and desktop
+- [ ] Touch targets meet minimum size (44x44 px)
+
+### AC-5: Reset and cancel
+- [ ] Reset clears all fields and removes error state
+- [ ] Cancel navigates away without data loss warning if form is pristine
+- [ ] Cancel shows confirmation dialog if form has unsaved changes
+`,
+    fichaTecnicaTemplate: `# FICHA TÉCNICA: {{FormName}} Form
+
+## Affected Files
+- components/{{FormName}}Form
+- hooks/use{{FormName}}Form (form state, validation)
+- api/{{FormName}}-client (submission)
+- i18n/{{FormName}}-form.json (strings)
+
+## Types / Entities
+- \`{{FormName}}FormValues\`: all field values
+- \`{{FormName}}FormErrors\`: per-field error messages
+- \`{{FormName}}FormState\`: idle | submitting | success | error
+
+## Risks
+- Missing server-side validation mirror → inconsistent UX
+- Missing loading state → double submissions
+- Missing ARIA attributes → accessibility failures
+
+## Estimation (rough)
+- Dev: 4–10 hours
+- Review: 1–2 hours
+- Difficulty: 2/5
+`,
+    progressTemplate: `# PROGRESS: {{FormName}} Form
+
+## Status: draft
+
+## Criteria
+- [ ] AC-1: Field validation
+- [ ] AC-2: Submit behavior
+- [ ] AC-3: Accessibility
+- [ ] AC-4: Responsive design
+- [ ] AC-5: Reset and cancel
+`,
+};
+//# sourceMappingURL=templates-api-ui.js.map

package/dist/engine/spec-templates/templates-api-ui.js.map

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

package/dist/engine/spec-templates/templates-auth-crud.d.ts

@@ -0,0 +1,6 @@
+import type { SpecTemplateEntry } from '../../types/spec-templates.js';
+/** JWT Authentication spec template. */
+export declare const AUTH_JWT_TEMPLATE: SpecTemplateEntry;
+/** CRUD Entity spec template. */
+export declare const CRUD_ENTITY_TEMPLATE: SpecTemplateEntry;
+//# sourceMappingURL=templates-auth-crud.d.ts.map

package/dist/engine/spec-templates/templates-auth-crud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates-auth-crud.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-templates/templates-auth-crud.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,EAAE,iBA4G/B,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,oBAAoB,EAAE,iBA8GlC,CAAC"}