sdd-cli 0.1.29 → 0.1.30

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

@@ -4,6 +4,14 @@ 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[];
@@ -13,5 +21,8 @@ export type DigitalReviewResult = {
     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,9 @@ 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"));
@@ -90,6 +93,30 @@ 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)) {
@@ -179,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",
@@ -227,6 +289,72 @@ function runDigitalHumanReview(appDir, context) {
         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;

package/dist/commands/hello.js

@@ -457,16 +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 (${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;
@@ -501,7 +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}`));
                         }

package/package.json

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