baldart 3.6.3 → 3.6.4

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to BALDART will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.6.4] - 2026-05-22
+
+Two configure-flow fixes surfaced by a real-world `mayo` install audit.
+
+### Fixed
+
+- **API docs false negative** — `has_api_docs` only checked for `docs/.../api/schemas.md` (and OpenAPI/GraphQL specs). Projects that ship API docs as one markdown per resource (e.g. `docs/references/api/{index,admin,push,…}.md`) were marked `has_api_docs: false` despite having extensive API documentation. Added a populated-directory probe: if `docs/references/api/` or `docs/api/` exists and contains ≥1 `.md` file, the feature flag flips to `true` and `api_index` falls back to `<dir>/index.md`.
+
+### Changed
+
+- **Prompt label clarity** — `"Charting libraries (canonical, comma-separated)"` → `"Approved charting libraries — comma-separated package names (empty if none)"`. Same edit for forbidden and animation. The previous label read like the user was being asked to type the word `canonical`; one tester actually did.
+
 ## [3.6.3] - 2026-05-22
 
 Smarter project autodetection in `baldart configure`. The previous probe only looked at a single hardcoded path (`docs/design-system/INDEX.md`), which silently failed on the vast majority of real projects (monorepos, inline `src/ui/`, `packages/ui/`, shadcn/ui setups, Tailwind-theme-only projects, etc.). The redundant "Design philosophy" prompt is now skipped automatically when a design system is detected.

package/VERSION

@@ -1 +1 @@
-3.6.3
+3.6.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baldart",
-  "version": "3.6.3",
+  "version": "3.6.4",
   "description": "Claude Agent Framework - Reusable framework for coordinating AI agents and humans in software projects",
   "bin": {
     "baldart": "./bin/baldart.js"

package/src/commands/configure.js

@@ -192,7 +192,7 @@ function detect(cwd = process.cwd()) {
     )
   );
 
-  // ---- API docs (widened — OpenAPI, GraphQL) -----------------------------
+  // ---- API docs (widened — OpenAPI, GraphQL, populated dir) --------------
   const apiIndex = findFirst('docs/references/api/index.md', 'docs/api/index.md');
   const apiSchemas = findFirst('docs/references/api/schemas.md', 'docs/api/schemas.md');
   const apiErrors = findFirst('docs/references/errors.md', 'docs/errors.md');
@@ -206,6 +206,11 @@ function detect(cwd = process.cwd()) {
   const graphqlSchema = findFirst(
     ...expandCandidates('schema.graphql', 'schema.gql', 'src/schema.graphql')
   );
+  // Many projects ship API docs as one markdown per resource (admin.md, push.md, …)
+  // without a `schemas.md` or OpenAPI spec. Count any populated docs/.../api dir as
+  // a positive signal.
+  const apiDocsDir = findFirst('docs/references/api', 'docs/api');
+  const apiDocsDirPopulated = apiDocsDir && countMatches(apiDocsDir, /\.md$/) > 0;
 
   // ---- Brand name (multi-fallback) ---------------------------------------
   let brandName = pkg?.name || '';
@@ -236,7 +241,7 @@ function detect(cwd = process.cwd()) {
     paths: {
       design_system: designSystemPath,
       ui_guidelines: uiGuidelines,
-      api_index: apiIndex,
+      api_index: apiIndex || (apiDocsDirPopulated ? path.join(apiDocsDir, 'index.md') : ''),
       api_schemas: apiSchemas || openapiSpec || graphqlSchema,
       api_errors: apiErrors,
       components_primitives: componentsPrimitives,
@@ -287,7 +292,7 @@ function detect(cwd = process.cwd()) {
     features: {
       has_design_system: hasDesignSystem,
       multi_tenant_theming: null,
-      has_api_docs: !!(apiSchemas || openapiSpec || graphqlSchema),
+      has_api_docs: !!(apiSchemas || openapiSpec || graphqlSchema || apiIndex || apiDocsDirPopulated),
       has_backlog: countMatches('backlog', /\.ya?ml$/) > 0,
       has_adrs: countMatches('docs/decisions', /^ADR-.*\.md$/) > 0,
       has_prd_workflow: exists('docs/prd'),
@@ -439,14 +444,14 @@ async function interactivePrompts(merged, detected) {
   UI.section('Stack (autodetected from package.json — confirm or override)');
   const charting = merged.stack.charting;
   const chartingCanonical = await promptForKey(
-    'Charting libraries (canonical, comma-separated)',
+    'Approved charting libraries — comma-separated package names (empty if none)',
     (charting.canonical || detected.stack.charting.canonical).join(',')
   );
   charting.canonical = chartingCanonical
     ? chartingCanonical.split(',').map((s) => s.trim()).filter(Boolean)
     : [];
   const chartingForbidden = await promptForKey(
-    'Charting libraries (forbidden, comma-separated) — empty for none',
+    'Forbidden charting libraries — comma-separated (empty if none)',
     (charting.forbidden || []).join(',')
   );
   charting.forbidden = chartingForbidden
@@ -459,7 +464,7 @@ async function interactivePrompts(merged, detected) {
 
   const animation = merged.stack.animation;
   const animCanonical = await promptForKey(
-    'Animation libraries (canonical, comma-separated)',
+    'Approved animation libraries — comma-separated package names (empty if none)',
     (animation.canonical || detected.stack.animation.canonical).join(',')
   );
   animation.canonical = animCanonical