create-quiver 0.17.4 → 0.17.6

package/src/create-quiver/lib/ai/analyze-project-validation.js

@@ -4,6 +4,8 @@ const path = require('node:path');
 const {
   ANALYZE_MANAGED_END,
   ANALYZE_MANAGED_START,
+  classifyAnalyzeProjectDoc,
+  collectCriticalPlaceholders,
   normalizeAnalyzeProjectDocProposal,
 } = require('./analyze-project-docs');
 const { normalizeAnalyzeProjectAnalysis } = require('./analyze-project-parser');
@@ -167,6 +169,7 @@ function writeAnalyzeProjectValidationManifest(repoRoot, options = {}) {
     issue_count: issues.length,
     groups: groupAnalyzeProjectIssues(issues, { maxExamplesPerGroup: 5 }),
     retry: options.retry || null,
+    recovery: options.recovery || null,
     issues,
   };
 
@@ -326,6 +329,29 @@ function addPlaceholderValidation(docPath, managedContent, errors) {
   }
 }
 
+function addVisiblePlaceholderValidation(docPath, content, warnings, errors, options = {}) {
+  const classification = classifyAnalyzeProjectDoc(content);
+  const placeholders = collectCriticalPlaceholders(classification.visible_body || '');
+  if (placeholders.length === 0) {
+    return;
+  }
+
+  const issue = makeIssue(
+    docPath,
+    'visible-critical-placeholder',
+    `critical scaffold placeholder remains in primary visible content: ${placeholders.slice(0, 3).join(', ')}`,
+    {
+      classification: classification.classification,
+      placeholders,
+    },
+  );
+  if (options.strict === true) {
+    errors.push(issue);
+  } else {
+    warnings.push(issue);
+  }
+}
+
 function normalizeFactValue(value) {
   return String(value || '')
     .replace(/[`*_]/g, '')
@@ -446,6 +472,7 @@ function validateAnalyzeProjectPostWrite(repoRoot, report, options = {}) {
       content: file.content,
       managedBlock,
     });
+    addVisiblePlaceholderValidation(docPath, file.content, warnings, errors, { strict: options.strict === true });
     if (!managedBlock.ok) {
       errors.push(makeIssue(docPath, managedBlock.issue, `Quiver managed block is missing or unbalanced in ${docPath}.`));
       continue;

package/src/create-quiver/lib/i18n/messages/en.js

@@ -34,6 +34,12 @@ module.exports = {
     'common.unknown': 'unknown',
     'common.warning': 'Warning: {message}',
     'common.yes': 'yes',
+    'analyze_project.recovery.budget': 'Suggested budget: --max-files {files}, --max-bytes {bytes}',
+    'analyze_project.recovery.reason': 'The provider cited evidence that was not included in the selected context sample.',
+    'analyze_project.recovery.recommended_command': 'Recommended command:',
+    'analyze_project.recovery.safe_fallback': 'No safe automatic budget recommendation is available. Inspect the selected evidence with `npx create-quiver ai analyze-project --deep --dry-run --json`, then rerun with a narrower scope.',
+    'analyze_project.recovery.title': 'Recommended fix',
+    'analyze_project.recovery.warning': 'Recovery warning',
     'config.error.unsupported_language': 'unsupported language: {language}. Supported languages: {supported}. Run: npx create-quiver config language set {fallback}',
     'config.error.unsupported_language_command': 'unsupported config language command: {command}. Supported commands: show, set',
     'config.error.unsupported_section': 'unsupported config section: {section}. Supported sections: language',

package/src/create-quiver/lib/i18n/messages/es.js

@@ -150,6 +150,12 @@ module.exports = {
     'common.unknown': 'desconocido',
     'common.warning': 'Advertencia: {message}',
     'common.yes': 'si',
+    'analyze_project.recovery.budget': 'Presupuesto sugerido: --max-files {files}, --max-bytes {bytes}',
+    'analyze_project.recovery.reason': 'El provider cito evidencia que no estaba incluida en la muestra de contexto seleccionada.',
+    'analyze_project.recovery.recommended_command': 'Comando recomendado:',
+    'analyze_project.recovery.safe_fallback': 'No hay una recomendacion automatica segura de presupuesto. Inspecciona la evidencia seleccionada con `npx create-quiver ai analyze-project --deep --dry-run --json` y luego reejecuta con un scope mas acotado.',
+    'analyze_project.recovery.title': 'Solucion recomendada',
+    'analyze_project.recovery.warning': 'Advertencia de recuperacion',
     'config.error.unsupported_language': 'idioma no compatible: {language}. Idiomas soportados: {supported}. Ejecuta: npx create-quiver config language set {fallback}',
     'config.error.unsupported_language_command': 'comando de idioma de config no compatible: {command}. Comandos soportados: show, set',
     'config.error.unsupported_section': 'seccion de config no compatible: {section}. Secciones soportadas: language',