sdd-cli 0.1.28 → 0.1.30

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

@@ -4,10 +4,25 @@ type ReviewerFinding = {
     severity: "high" | "medium";
     message: string;
 };
+export type UserStory = {
+    id: string;
+    priority: "P0" | "P1";
+    persona: string;
+    story: string;
+    acceptanceCriteria: string[];
+    sourceReviewer: string;
+};
 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 convertFindingsToUserStories(findings: ReviewerFinding[]): UserStory[];
+export declare function storiesToDiagnostics(stories: UserStory[]): string[];
+export declare function writeUserStoriesBacklog(appDir: string, stories: UserStory[]): string | null;
+export declare function writeDigitalReviewReport(appDir: string, review: DigitalReviewResult): string | null;
 export {};

package/dist/commands/digital-reviewers.js

@@ -4,6 +4,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runDigitalHumanReview = runDigitalHumanReview;
+exports.convertFindingsToUserStories = convertFindingsToUserStories;
+exports.storiesToDiagnostics = storiesToDiagnostics;
+exports.writeUserStoriesBacklog = writeUserStoriesBacklog;
+exports.writeDigitalReviewReport = writeDigitalReviewReport;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 function normalizeText(input) {
@@ -89,6 +93,52 @@ function hasUserFlowDocs(root, readme) {
     }
     return Boolean(findDoc(root, ["user-flow.md", "ux-notes.md", "experience.md"]));
 }
+function hasAccessibilityEvidence(root, readme) {
+    if (/\ba11y\b|\baccessibility\b|\bwcag\b|\bkeyboard\b/.test(readme)) {
+        return true;
+    }
+    return Boolean(findDoc(root, ["accessibility.md", "a11y.md"]));
+}
+function hasPerformanceEvidence(root, readme) {
+    if (/\bperformance\b|\blatency\b|\bthroughput\b|\bp95\b|\bp99\b/.test(readme)) {
+        return true;
+    }
+    return Boolean(findDoc(root, ["performance.md", "performance-budget.md", "scalability.md"]));
+}
+function hasSupportEvidence(root, readme) {
+    if (/\btroubleshoot\b|\bsupport\b|\bfaq\b/.test(readme)) {
+        return true;
+    }
+    return Boolean(findDoc(root, ["troubleshooting.md", "support.md", "faq.md"]));
+}
+function hasApiContracts(root) {
+    return Boolean(findDoc(root, ["openapi.yaml", "openapi.yml", "api-contract.md", "api.md"]));
+}
+function hasReleaseNotes(root) {
+    return Boolean(findDoc(root, ["release-notes.md", "changelog.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 +151,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 +185,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",
@@ -137,6 +206,41 @@ function runDigitalHumanReview(appDir, context) {
             message: "User experience flow is unclear. Add user-flow/UX notes and acceptance of critical journeys."
         });
     }
+    if (!hasAccessibilityEvidence(appDir, readme)) {
+        findings.push({
+            reviewer: "accessibility_tester",
+            severity: "medium",
+            message: "Accessibility evidence missing. Add keyboard/contrast/screen-reader validation notes."
+        });
+    }
+    if (!hasPerformanceEvidence(appDir, readme)) {
+        findings.push({
+            reviewer: "performance_engineer",
+            severity: "medium",
+            message: "Performance expectations are unclear. Add performance budget and baseline measurements."
+        });
+    }
+    if (!hasSupportEvidence(appDir, readme)) {
+        findings.push({
+            reviewer: "support_agent",
+            severity: "medium",
+            message: "Support/troubleshooting guidance is missing for operators and end users."
+        });
+    }
+    if (!hasApiContracts(appDir)) {
+        findings.push({
+            reviewer: "integrator_partner",
+            severity: "medium",
+            message: "API contract/documentation missing. Add OpenAPI or API contract document for integrators."
+        });
+    }
+    if (!hasReleaseNotes(appDir)) {
+        findings.push({
+            reviewer: "release_manager",
+            severity: "medium",
+            message: "Release notes/changelog missing. Add release documentation for change visibility."
+        });
+    }
     if (hasSecretLeak(appDir)) {
         findings.push({
             reviewer: "security_reviewer",
@@ -169,9 +273,103 @@ 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 slugReviewer(reviewer) {
+    return reviewer.replace(/[^a-z0-9]+/gi, "_").toLowerCase();
+}
+function acceptanceCriteriaFromFinding(finding) {
+    const base = finding.message.replace(/\.$/, "");
+    return [
+        `Given the generated app, when quality review runs, then ${base.toLowerCase()}.`,
+        "Given CI validation, when documentation/tests are checked, then evidence is discoverable and actionable."
+    ];
+}
+function convertFindingsToUserStories(findings) {
+    const deduped = new Map();
+    for (const finding of findings) {
+        const key = `${finding.reviewer}::${finding.message}`.toLowerCase();
+        if (!deduped.has(key)) {
+            deduped.set(key, finding);
+        }
+    }
+    let index = 1;
+    return [...deduped.values()].map((finding) => {
+        const id = `US-${String(index).padStart(3, "0")}`;
+        index += 1;
+        const persona = slugReviewer(finding.reviewer);
+        const priority = finding.severity === "high" ? "P0" : "P1";
+        return {
+            id,
+            priority,
+            persona,
+            sourceReviewer: finding.reviewer,
+            story: `As a ${persona}, I need ${finding.message.toLowerCase()} so that the delivery is production-ready.`,
+            acceptanceCriteria: acceptanceCriteriaFromFinding(finding)
+        };
+    });
+}
+function storiesToDiagnostics(stories) {
+    return stories.map((story) => `[UserStory:${story.id}][${story.priority}] ${story.story}`);
+}
+function writeUserStoriesBacklog(appDir, stories) {
+    if (!fs_1.default.existsSync(appDir)) {
+        return null;
+    }
+    const deployDir = path_1.default.join(appDir, "deploy");
+    fs_1.default.mkdirSync(deployDir, { recursive: true });
+    const jsonPath = path_1.default.join(deployDir, "digital-review-user-stories.json");
+    fs_1.default.writeFileSync(jsonPath, JSON.stringify({
+        generatedAt: new Date().toISOString(),
+        count: stories.length,
+        stories
+    }, null, 2), "utf-8");
+    const mdPath = path_1.default.join(deployDir, "digital-review-user-stories.md");
+    const lines = [
+        "# Digital Review User Stories",
+        "",
+        ...stories.flatMap((story) => [
+            `## ${story.id} (${story.priority})`,
+            `- Persona: ${story.persona}`,
+            `- Source reviewer: ${story.sourceReviewer}`,
+            `- Story: ${story.story}`,
+            "- Acceptance criteria:",
+            ...story.acceptanceCriteria.map((criterion) => `  - ${criterion}`),
+            ""
+        ])
+    ];
+    fs_1.default.writeFileSync(mdPath, `${lines.join("\n")}\n`, "utf-8");
+    return jsonPath;
+}
+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,12 +457,22 @@ async function runHello(input, runQuestions) {
                         intentDomain: intent.domain,
                         intentFlow: intent.flow
                     });
+                    let stories = (0, digital_reviewers_1.convertFindingsToUserStories)(review.findings);
+                    const initialReviewReport = (0, digital_reviewers_1.writeDigitalReviewReport)(appDir, review);
+                    const initialStoriesPath = (0, digital_reviewers_1.writeUserStoriesBacklog)(appDir, stories);
+                    if (initialReviewReport) {
+                        printWhy(`Digital-review report: ${initialReviewReport}`);
+                    }
+                    if (initialStoriesPath) {
+                        printWhy(`Digital-review user stories: ${initialStoriesPath} (${stories.length} stories)`);
+                    }
                     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) {
-                        const repair = (0, ai_autopilot_1.improveGeneratedApp)(appDir, text, provider, review.diagnostics, intent.domain);
+                        const storyDiagnostics = (0, digital_reviewers_1.storiesToDiagnostics)(stories);
+                        const repair = (0, ai_autopilot_1.improveGeneratedApp)(appDir, text, provider, [...review.diagnostics, ...storyDiagnostics, "Implement all user stories from digital review backlog."], intent.domain);
                         if (!repair.attempted || !repair.applied) {
                             printWhy(`Digital-review repair attempt ${attempt} skipped: ${repair.reason || "unknown reason"}`);
                             break;
@@ -497,6 +507,9 @@ async function runHello(input, runQuestions) {
                             intentDomain: intent.domain,
                             intentFlow: intent.flow
                         });
+                        stories = (0, digital_reviewers_1.convertFindingsToUserStories)(review.findings);
+                        (0, digital_reviewers_1.writeDigitalReviewReport)(appDir, review);
+                        (0, digital_reviewers_1.writeUserStoriesBacklog)(appDir, stories);
                         if (!review.passed) {
                             review.diagnostics.forEach((issue) => printWhy(`Reviewer issue (retry ${attempt}): ${issue}`));
                         }
@@ -506,7 +519,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.30",
   "description": "AI-orchestrated specification-driven delivery CLI that plans, validates, and ships production-ready software projects.",
   "keywords": [
     "cli",