sdd-cli 0.1.26 → 0.1.27

package/dist/commands/ai-autopilot.js

@@ -189,8 +189,15 @@ function extraPromptConstraints(intent) {
         constraints.push("Use modern React data layer: @tanstack/react-query (not react-query).");
         constraints.push("Backend architecture must include DTO classes, service interfaces, and repository interfaces.");
         constraints.push("Use Java records for immutable request/response or transport models.");
+        constraints.push("Use Lombok in backend entities/DTOs where appropriate (builder/getter/setter/constructor patterns).");
+        constraints.push("Use Jakarta/Javax Bean Validation annotations and @Valid in request boundaries.");
+        constraints.push("Include @RestControllerAdvice for global exception handling.");
+        constraints.push("Add Spring Actuator telemetry and basic Prometheus-friendly metrics configuration.");
         constraints.push("Frontend architecture must include src/api, src/hooks (use*.ts/tsx), and src/components layers.");
+        constraints.push("Frontend bootstrap must use React.StrictMode.");
+        constraints.push("Frontend should include safe input validation and avoid direct unsafe HTML rendering.");
         constraints.push("Include frontend tests and backend tests that run in local CI.");
+        constraints.push("Include architecture.md and execution-guide.md with clear local run instructions.");
     }
     if (intentSuggestsRelationalDataDomain(intent)) {
         constraints.push("Use a scalable relational database default (prefer PostgreSQL).");

package/dist/commands/app-lifecycle.js

@@ -44,6 +44,15 @@ function countJsTsTests(root, maxDepth = 8) {
     }
     return count;
 }
+function fileExistsAny(root, candidates) {
+    for (const candidate of candidates) {
+        const full = path_1.default.join(root, candidate);
+        if (fs_1.default.existsSync(full)) {
+            return full;
+        }
+    }
+    return null;
+}
 function findFileRecursive(root, predicate, maxDepth = 4) {
     const walk = (current, depth) => {
         if (depth > maxDepth) {
@@ -314,6 +323,15 @@ function advancedQualityCheck(appDir, context) {
                     output: "Outdated frontend dependency detected: react-query. Use @tanstack/react-query."
                 };
             }
+            const requiredFrontendDeps = ["react-router-dom", "@tanstack/react-query"];
+            const missingFrontendDeps = requiredFrontendDeps.filter((dep) => typeof deps[dep] !== "string");
+            if (missingFrontendDeps.length > 0) {
+                return {
+                    ok: false,
+                    command: "advanced-quality-check",
+                    output: `Missing modern frontend dependencies: ${missingFrontendDeps.join(", ")}`
+                };
+            }
         }
         const backendRoot = path_1.default.join(appDir, "backend", "src", "main", "java");
         if (!fs_1.default.existsSync(backendRoot)) {
@@ -351,6 +369,59 @@ function advancedQualityCheck(appDir, context) {
                 output: "Missing service/repository interfaces in Java backend architecture"
             };
         }
+        const hasControllerAdvice = backendFiles.some((rel) => /@RestControllerAdvice\b/.test(fs_1.default.readFileSync(path_1.default.join(backendRoot, rel), "utf-8")));
+        if (!hasControllerAdvice) {
+            return {
+                ok: false,
+                command: "advanced-quality-check",
+                output: "Missing global exception handling (expected @RestControllerAdvice)"
+            };
+        }
+        const hasValidationUsage = backendFiles.some((rel) => {
+            const raw = fs_1.default.readFileSync(path_1.default.join(backendRoot, rel), "utf-8");
+            return /\b@(Valid|NotNull|NotBlank|Size|Email)\b/.test(raw) && /(jakarta|javax)\.validation/.test(raw);
+        });
+        if (!hasValidationUsage) {
+            return {
+                ok: false,
+                command: "advanced-quality-check",
+                output: "Missing bean validation usage (expected @Valid/@NotBlank with jakarta/javax.validation imports)"
+            };
+        }
+        const pomPath = path_1.default.join(appDir, "backend", "pom.xml");
+        const pomRaw = fs_1.default.existsSync(pomPath) ? fs_1.default.readFileSync(pomPath, "utf-8").toLowerCase() : "";
+        const requiredBackendDeps = [
+            "lombok",
+            "spring-boot-starter-validation",
+            "spring-boot-starter-actuator"
+        ];
+        const missingBackendDeps = requiredBackendDeps.filter((dep) => !pomRaw.includes(dep));
+        if (missingBackendDeps.length > 0) {
+            return {
+                ok: false,
+                command: "advanced-quality-check",
+                output: `Missing backend dependencies for production quality: ${missingBackendDeps.join(", ")}`
+            };
+        }
+        const hasMetricsConfig = (() => {
+            const metricsFile = fileExistsAny(path_1.default.join(appDir, "backend"), [
+                "src/main/resources/application.yml",
+                "src/main/resources/application.yaml",
+                "src/main/resources/application.properties"
+            ]);
+            if (!metricsFile) {
+                return false;
+            }
+            const text = normalizeText(fs_1.default.readFileSync(metricsFile, "utf-8"));
+            return /management\.endpoints|prometheus|actuator/.test(text);
+        })();
+        if (!hasMetricsConfig) {
+            return {
+                ok: false,
+                command: "advanced-quality-check",
+                output: "Missing backend telemetry config (expected actuator/prometheus management settings)"
+            };
+        }
         const frontendRoot = path_1.default.join(appDir, "frontend", "src");
         if (!fs_1.default.existsSync(frontendRoot)) {
             return {
@@ -378,6 +449,39 @@ function advancedQualityCheck(appDir, context) {
                 output: `Expected at least 3 frontend tests for Java+React profile, found ${frontendTestCount}`
             };
         }
+        const frontendUsesStrictMode = (() => {
+            const mainCandidate = fileExistsAny(path_1.default.join(appDir, "frontend"), ["src/main.tsx", "src/main.jsx", "src/index.tsx", "src/index.jsx"]);
+            if (!mainCandidate) {
+                return false;
+            }
+            const raw = fs_1.default.readFileSync(mainCandidate, "utf-8");
+            return /StrictMode/.test(raw);
+        })();
+        if (!frontendUsesStrictMode) {
+            return {
+                ok: false,
+                command: "advanced-quality-check",
+                output: "Missing React StrictMode in frontend bootstrap"
+            };
+        }
+        const executionGuideExists = findFileRecursive(appDir, (rel) => rel === "execution-guide.md" || rel.endsWith("/execution-guide.md"), 8) ??
+            findFileRecursive(appDir, (rel) => rel.includes("runbook") && rel.endsWith(".md"), 8);
+        if (!executionGuideExists) {
+            return {
+                ok: false,
+                command: "advanced-quality-check",
+                output: "Missing execution guide/runbook markdown (expected execution-guide.md or runbook*.md)"
+            };
+        }
+        const architectureDocExists = findFileRecursive(appDir, (rel) => rel === "architecture.md" || rel.endsWith("/architecture.md"), 8) ??
+            findFileRecursive(appDir, (rel) => rel.includes("architecture") && rel.endsWith(".md"), 8);
+        if (!architectureDocExists) {
+            return {
+                ok: false,
+                command: "advanced-quality-check",
+                output: "Missing architecture documentation markdown (expected architecture.md)"
+            };
+        }
     }
     const dummyLocalDoc = findFileRecursive(appDir, (rel) => rel.includes("dummylocal") && rel.endsWith(".md")) ??
         findFileRecursive(appDir, (rel) => rel.includes("dummy-local") && rel.endsWith(".md")) ??
@@ -516,7 +620,7 @@ function deriveRepoMetadata(projectName, appDir, context) {
     const goalSeed = context?.goalText ? tokenizeIntent(context.goalText).slice(0, 6).join("-") : "";
     const projectSeed = slugify(rawBase);
     const intentSeed = slugify(goalSeed);
-    const base = projectSeed || intentSeed || "sdd-project";
+    const base = intentSeed || projectSeed || "sdd-project";
     const cleaned = base.replace(/-app$/g, "");
     const repoName = `${cleaned}-app`.slice(0, 63).replace(/-+$/g, "");
     let description = context?.goalText?.trim()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-cli",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "description": "AI-orchestrated specification-driven delivery CLI that plans, validates, and ships production-ready software projects.",
   "keywords": [
     "cli",