sdd-cli 0.1.28 → 0.1.29

package/dist/commands/digital-reviewers.d.ts

@@ -8,6 +8,10 @@ export type DigitalReviewResult = {
     passed: boolean;
     findings: ReviewerFinding[];
     diagnostics: string[];
+    score: number;
+    threshold: number;
+    summary: string;
 };
 export declare function runDigitalHumanReview(appDir: string, context?: LifecycleContext): DigitalReviewResult;
+export declare function writeDigitalReviewReport(appDir: string, review: DigitalReviewResult): string | null;
 export {};

package/dist/commands/digital-reviewers.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runDigitalHumanReview = runDigitalHumanReview;
+exports.writeDigitalReviewReport = writeDigitalReviewReport;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 function normalizeText(input) {
@@ -89,6 +90,28 @@ function hasUserFlowDocs(root, readme) {
     }
     return Boolean(findDoc(root, ["user-flow.md", "ux-notes.md", "experience.md"]));
 }
+function parseThreshold() {
+    const raw = Number.parseInt(process.env.SDD_DIGITAL_REVIEW_MIN_SCORE ?? "", 10);
+    if (!Number.isFinite(raw)) {
+        return 85;
+    }
+    return Math.max(60, Math.min(98, raw));
+}
+function scoreForFindings(findings) {
+    let score = 100;
+    for (const finding of findings) {
+        score -= finding.severity === "high" ? 20 : 8;
+    }
+    return Math.max(0, score);
+}
+function hasArchitectureAndExecutionDocs(root) {
+    const architecture = findDoc(root, ["architecture.md"]);
+    const execution = findDoc(root, ["execution-guide.md", "runbook.md", "operations-runbook.md"]);
+    return Boolean(architecture && execution);
+}
+function hasLicense(root) {
+    return fs_1.default.existsSync(path_1.default.join(root, "LICENSE"));
+}
 function hasSecretLeak(root) {
     const files = collectFilesRecursive(root, 8).filter((rel) => /\.(env|txt|md|json|yml|yaml|properties|ts|js|py|java)$/i.test(rel));
     const patterns = [/api[_-]?key\s*[:=]\s*[^\s]+/i, /secret\s*[:=]\s*[^\s]+/i, /password\s*[:=]\s*[^\s]+/i];
@@ -101,11 +124,16 @@ function hasSecretLeak(root) {
 }
 function runDigitalHumanReview(appDir, context) {
     const findings = [];
+    const threshold = parseThreshold();
     if (!fs_1.default.existsSync(appDir)) {
+        const diagnostics = ["[DigitalReviewer:program_manager][high] Generated app directory is missing."];
         return {
             passed: false,
             findings: [{ reviewer: "program_manager", severity: "high", message: "Generated app directory is missing." }],
-            diagnostics: ["[DigitalReviewer:program_manager][high] Generated app directory is missing."]
+            diagnostics,
+            score: 0,
+            threshold,
+            summary: "failed: app directory missing"
         };
     }
     const readmePath = path_1.default.join(appDir, "README.md");
@@ -130,6 +158,20 @@ function runDigitalHumanReview(appDir, context) {
             message: `Automated test depth is low (${totalTests}). Minimum expected is 8 tests for acceptance.`
         });
     }
+    if (!hasArchitectureAndExecutionDocs(appDir)) {
+        findings.push({
+            reviewer: "program_manager",
+            severity: "medium",
+            message: "Architecture and execution/runbook docs are required for production readiness."
+        });
+    }
+    if (!hasLicense(appDir)) {
+        findings.push({
+            reviewer: "program_manager",
+            severity: "medium",
+            message: "Project should include a LICENSE file for delivery readiness."
+        });
+    }
     if (!hasUserFlowDocs(appDir, readme)) {
         findings.push({
             reviewer: "ux_researcher",
@@ -169,9 +211,37 @@ function runDigitalHumanReview(appDir, context) {
         }
     }
     const diagnostics = findings.map((finding) => `[DigitalReviewer:${finding.reviewer}][${finding.severity}] ${finding.message}`);
+    const score = scoreForFindings(findings);
+    const highCount = findings.filter((finding) => finding.severity === "high").length;
+    const mediumCount = findings.length - highCount;
+    const passed = findings.length === 0 || (highCount === 0 && score >= threshold);
+    const summary = passed
+        ? `passed: score ${score}/${threshold} (high=${highCount}, medium=${mediumCount})`
+        : `failed: score ${score}/${threshold} (high=${highCount}, medium=${mediumCount})`;
     return {
-        passed: findings.length === 0,
+        passed,
         findings,
-        diagnostics
+        diagnostics,
+        score,
+        threshold,
+        summary
     };
 }
+function writeDigitalReviewReport(appDir, review) {
+    if (!fs_1.default.existsSync(appDir)) {
+        return null;
+    }
+    const deployDir = path_1.default.join(appDir, "deploy");
+    fs_1.default.mkdirSync(deployDir, { recursive: true });
+    const reportPath = path_1.default.join(deployDir, "digital-review-report.json");
+    fs_1.default.writeFileSync(reportPath, JSON.stringify({
+        generatedAt: new Date().toISOString(),
+        passed: review.passed,
+        score: review.score,
+        threshold: review.threshold,
+        summary: review.summary,
+        findings: review.findings,
+        diagnostics: review.diagnostics
+    }, null, 2), "utf-8");
+    return reportPath;
+}

package/dist/commands/hello.js

@@ -457,8 +457,12 @@ async function runHello(input, runQuestions) {
                         intentDomain: intent.domain,
                         intentFlow: intent.flow
                     });
+                    const initialReviewReport = (0, digital_reviewers_1.writeDigitalReviewReport)(appDir, review);
+                    if (initialReviewReport) {
+                        printWhy(`Digital-review report: ${initialReviewReport}`);
+                    }
                     if (!review.passed) {
-                        printWhy("Digital human reviewers found delivery issues. Applying targeted refinements.");
+                        printWhy(`Digital human reviewers found delivery issues (${review.summary}). Applying targeted refinements.`);
                         review.diagnostics.forEach((issue) => printWhy(`Reviewer issue: ${issue}`));
                     }
                     for (let attempt = 1; attempt <= maxReviewAttempts && !review.passed; attempt += 1) {
@@ -497,6 +501,7 @@ async function runHello(input, runQuestions) {
                             intentDomain: intent.domain,
                             intentFlow: intent.flow
                         });
+                        (0, digital_reviewers_1.writeDigitalReviewReport)(appDir, review);
                         if (!review.passed) {
                             review.diagnostics.forEach((issue) => printWhy(`Reviewer issue (retry ${attempt}): ${issue}`));
                         }
@@ -506,7 +511,7 @@ async function runHello(input, runQuestions) {
                         printRecoveryNext(activeProject, "finish", text);
                         return;
                     }
-                    printWhy("Digital reviewers approved delivery quality.");
+                    printWhy(`Digital reviewers approved delivery quality (${review.summary}).`);
                 }
                 (0, local_metrics_1.recordActivationMetric)("completed", {
                     project: activeProject,

package/package.json

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