create-quiver 0.17.0 → 0.17.1

package/CHANGELOG.md

@@ -40,6 +40,10 @@ All notable changes to this project will be documented in this file.
 - CLI output now follows the shared Quiver palette and hierarchy while keeping `--json`, CI, no-TTY, and `--no-color` output clean.
 - Command docs now cover human-vs-machine output, selectors, Doctor output, and cross-platform usage.
 
+### Fixed
+
+- `ai analyze-project` now shows human TTY progress while provider analysis runs and reports schema validation issues with actionable detail.
+
 ## [0.14.1] - 2026-05-26
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-quiver",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "private": false,
   "description": "Quiver CLI for scaffolding projects from the packaged template",
   "license": "MIT",

package/src/create-quiver/commands/ai.js

@@ -165,6 +165,46 @@ function limitList(items, maxItems = 30) {
   };
 }
 
+function formatAnalyzeProjectIssues(issues = [], maxIssues = 8) {
+  const list = Array.isArray(issues) ? issues : [];
+  const visible = list.slice(0, maxIssues);
+  const lines = visible.map((issue) => {
+    const location = issue.path || 'analysis';
+    const code = issue.issue || 'invalid';
+    const message = issue.message || 'Invalid provider analysis output.';
+    return `- ${location}: ${code} - ${message}`;
+  });
+  const hidden = list.length - visible.length;
+  if (hidden > 0) {
+    lines.push(`- ... ${hidden} more issue${hidden === 1 ? '' : 's'}`);
+  }
+  return lines;
+}
+
+function enhanceAnalyzeProjectAnalysisError(error) {
+  if (!error || error.code !== 'AI_ANALYZE_PROJECT_INVALID') {
+    return error;
+  }
+
+  const issueLines = formatAnalyzeProjectIssues(error.issues);
+  if (issueLines.length === 0) {
+    return error;
+  }
+
+  const wrapped = new Error([
+    error.message,
+    'Issues:',
+    ...issueLines,
+    'Next safe step: inspect the selected evidence with `npx create-quiver ai analyze-project --deep --dry-run --json`, then rerun live. If provider drift repeats, reduce --max-files or --max-bytes.',
+  ].join('\n'));
+  wrapped.name = error.name;
+  wrapped.code = error.code;
+  wrapped.cause = error;
+  wrapped.issues = error.issues;
+  wrapped.details = error.issues;
+  return wrapped;
+}
+
 function formatAnalyzeProjectFileLine(file) {
   const details = [];
   if (Array.isArray(file.signals) && file.signals.length > 0) {
@@ -1883,6 +1923,9 @@ async function runAnalyzeProject(repoRoot, options = {}) {
   const runtimeProfile = resolveRuntimeAgentProfile(repoRoot, role, options, DEFAULT_PLAN_PROVIDER);
   const provider = runtimeProfile.provider;
   const timeoutMs = normalizeTimeout(options.timeout);
+  const ux = createCommandUx(options);
+  const showProgress = shouldShowHumanProgress(ux, options);
+  const progressTranslator = createTranslator(options.language);
   const promptPackage = buildAnalyzeProjectPrompt({
     analysisPlan: report,
     repoRoot,
@@ -1893,6 +1936,17 @@ async function runAnalyzeProject(repoRoot, options = {}) {
   const promptLimit = assertProviderPromptWithinLimit(prompt, options.promptLimitOptions || {});
   const privacyPreflight = promptPackage.privacyPreflight;
 
+  writeProgressChecks(
+    ux,
+    showProgress,
+    plannerProgressTitle(progressTranslator.t('ai.planner.progress.analyze_project'), runtimeProfile, options),
+    [
+      progressTranslator.t('ai.planner.progress.reading_base_docs'),
+      progressTranslator.t('ai.planner.progress.detecting_structure'),
+      progressTranslator.t('ai.planner.progress.preparing_prompt'),
+    ],
+  );
+
   if (!privacyPreflight.ok) {
     const error = new Error(formatError('ai analyze-project privacy preflight failed; provider execution was blocked before sending repository content.'));
     error.code = 'AI_ANALYZE_PROJECT_PRIVACY_PREFLIGHT_FAILED';
@@ -1931,18 +1985,25 @@ async function runAnalyzeProject(repoRoot, options = {}) {
 
   let result;
   try {
-    result = await (options.runProviderFn || runProvider)(provider, {
-      prompt,
-      cwd: repoRoot,
-      timeoutMs,
-      dryRun: false,
-      probe: options.probe,
-      spawn: options.spawn,
-      tempRoot: options.tempRoot,
-      tempFileName: options.tempFileName,
-      tempFilePrefix: options.tempFilePrefix,
-      ...runtimeModelExecutionOptions(runtimeProfile, options),
-      enforceModelSelection: false,
+    result = await runProviderWithProgress({
+      ux,
+      enabled: showProgress,
+      message: progressTranslator.t('ai.planner.progress.running_agent'),
+      successMessage: progressTranslator.t('ai.planner.progress.agent_finished'),
+      failureMessage: progressTranslator.t('ai.planner.progress.agent_failed'),
+      run: () => (options.runProviderFn || runProvider)(provider, {
+        prompt,
+        cwd: repoRoot,
+        timeoutMs,
+        dryRun: false,
+        probe: options.probe,
+        spawn: options.spawn,
+        tempRoot: options.tempRoot,
+        tempFileName: options.tempFileName,
+        tempFilePrefix: options.tempFilePrefix,
+        ...runtimeModelExecutionOptions(runtimeProfile, options),
+        enforceModelSelection: false,
+      }),
     });
   } catch (error) {
     throw annotateProviderError(error, 'analyze-project');
@@ -1953,10 +2014,15 @@ async function runAnalyzeProject(repoRoot, options = {}) {
   }
 
   const clean = extractCleanProviderOutput(result, { prompt, projectRoot: repoRoot });
-  const parsed = parseAnalyzeProjectOutput(clean.cleanOutput, {
-    selectedFiles: report.selected_files,
-    promptFiles: promptPackage.files,
-  });
+  let parsed;
+  try {
+    parsed = parseAnalyzeProjectOutput(clean.cleanOutput, {
+      selectedFiles: report.selected_files,
+      promptFiles: promptPackage.files,
+    });
+  } catch (error) {
+    throw enhanceAnalyzeProjectAnalysisError(error);
+  }
   const completedReport = {
     ...report,
     provider,

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

@@ -272,6 +272,7 @@ module.exports = {
     'ai.plan.with_planner_already_active': 'Planner mode: already active for ai plan; --with-planner is accepted for UX consistency.',
     'ai.planner.progress.agent_failed': 'Agent failed',
     'ai.planner.progress.agent_finished': 'Agent finished',
+    'ai.planner.progress.analyze_project': 'Analyzing project',
     'ai.planner.progress.detecting_structure': 'Detecting structure',
     'ai.planner.progress.onboarding': 'Running onboarding',
     'ai.planner.progress.plan': 'Running plan {phase}',

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

@@ -387,6 +387,7 @@ module.exports = {
     'ai.plan.with_planner_already_active': 'Modo planner: ya esta activo para ai plan; --with-planner se acepta por consistencia de UX.',
     'ai.planner.progress.agent_failed': 'Fallo el agente',
     'ai.planner.progress.agent_finished': 'Agente finalizado',
+    'ai.planner.progress.analyze_project': 'Analizando proyecto',
     'ai.planner.progress.detecting_structure': 'Detectando estructura',
     'ai.planner.progress.onboarding': 'Ejecutando onboarding',
     'ai.planner.progress.plan': 'Ejecutando plan {phase}',