@mcoda/core 0.1.18 → 0.1.20

package/dist/services/docs/review/gates/PdrFolderTreeGate.d.ts

@@ -0,0 +1,7 @@
+import { DocgenArtifactInventory } from "../../DocgenRunContext.js";
+import { ReviewGateResult } from "../ReviewTypes.js";
+export interface PdrFolderTreeGateInput {
+    artifacts: DocgenArtifactInventory;
+}
+export declare const runPdrFolderTreeGate: (input: PdrFolderTreeGateInput) => Promise<ReviewGateResult>;
+//# sourceMappingURL=PdrFolderTreeGate.d.ts.map

package/dist/services/docs/review/gates/PdrFolderTreeGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdrFolderTreeGate.d.ts","sourceRoot":"","sources":["../../../../../src/services/docs/review/gates/PdrFolderTreeGate.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAe,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,uBAAuB,CAAC;CACpC;AAqFD,eAAO,MAAM,oBAAoB,GAC/B,OAAO,sBAAsB,KAC5B,OAAO,CAAC,gBAAgB,CAwF1B,CAAC"}

package/dist/services/docs/review/gates/PdrFolderTreeGate.js

@@ -0,0 +1,151 @@
+import { promises as fs } from "node:fs";
+const FOLDER_TREE_HEADING = /folder tree|directory structure|repository structure|target structure/i;
+const TREE_ENTRY_MINIMUM = 8;
+const isFenceLine = (line) => /^```|^~~~/.test(line.trim());
+const extractSection = (lines, headingMatch) => {
+    let inFence = false;
+    let capture = false;
+    let startLine = 0;
+    const collected = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        const trimmed = line.trim();
+        if (isFenceLine(trimmed)) {
+            inFence = !inFence;
+            if (capture)
+                collected.push(trimmed);
+            continue;
+        }
+        const heading = trimmed.match(/^#{1,6}\s+(.*)$/);
+        if (heading && !inFence) {
+            const title = heading[1]?.trim() ?? "";
+            if (headingMatch.test(title)) {
+                capture = true;
+                startLine = i + 1;
+                continue;
+            }
+            if (capture)
+                break;
+        }
+        if (capture)
+            collected.push(line);
+    }
+    if (!capture)
+        return undefined;
+    return { content: collected, line: startLine };
+};
+const extractTreeBlock = (content) => {
+    const match = content.match(/```(?:text)?\s*([\s\S]*?)```/i);
+    if (!match)
+        return undefined;
+    return match[1]?.trim();
+};
+const countTreeEntries = (treeBlock) => treeBlock
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter((line) => {
+    if (!line)
+        return false;
+    if (line === ".")
+        return true;
+    if (/^[├└│]/.test(line))
+        return true;
+    if (/[A-Za-z0-9_.-]+\/?(\s+[#-].*)?$/.test(line))
+        return true;
+    return false;
+}).length;
+const hasResponsibilityHints = (treeBlock) => /#|responsibilit|owner|module|service|tests?|scripts?/i.test(treeBlock);
+const buildIssue = (input) => ({
+    id: input.id,
+    gateId: "gate-pdr-folder-tree",
+    severity: "high",
+    category: "completeness",
+    artifact: "pdr",
+    message: input.message,
+    remediation: input.remediation,
+    location: {
+        kind: "line_range",
+        path: input.record.path,
+        lineStart: input.line ?? 1,
+        lineEnd: input.line ?? 1,
+        excerpt: input.message,
+    },
+    metadata: input.metadata,
+});
+export const runPdrFolderTreeGate = async (input) => {
+    const pdr = input.artifacts.pdr;
+    if (!pdr) {
+        return {
+            gateId: "gate-pdr-folder-tree",
+            gateName: "PDR Folder Tree",
+            status: "skipped",
+            issues: [],
+            notes: ["No PDR artifact available for folder tree validation."],
+        };
+    }
+    const issues = [];
+    const notes = [];
+    try {
+        const content = await fs.readFile(pdr.path, "utf8");
+        const lines = content.split(/\r?\n/);
+        const section = extractSection(lines, FOLDER_TREE_HEADING);
+        if (!section) {
+            issues.push(buildIssue({
+                id: "gate-pdr-folder-tree-missing-section",
+                message: "PDR is missing a target folder tree section.",
+                remediation: "Add a dedicated folder tree section with an expanded repository tree and responsibilities.",
+                record: pdr,
+                metadata: { issueType: "missing_folder_tree_section" },
+            }));
+        }
+        else {
+            const sectionText = section.content.join("\n").trim();
+            const treeBlock = extractTreeBlock(sectionText);
+            if (!treeBlock) {
+                issues.push(buildIssue({
+                    id: "gate-pdr-folder-tree-missing-fence",
+                    message: "Folder tree section does not include a fenced text tree block.",
+                    remediation: "Add a fenced block (```text ... ```) that describes the target repository tree.",
+                    record: pdr,
+                    line: section.line,
+                    metadata: { issueType: "missing_fenced_tree" },
+                }));
+            }
+            else {
+                const entryCount = countTreeEntries(treeBlock);
+                if (entryCount < TREE_ENTRY_MINIMUM) {
+                    issues.push(buildIssue({
+                        id: "gate-pdr-folder-tree-sparse-tree",
+                        message: `Folder tree block is too sparse (${entryCount} entries).`,
+                        remediation: "Expand the tree to include major docs/source/contracts/db/deploy/tests/scripts paths.",
+                        record: pdr,
+                        line: section.line,
+                        metadata: { issueType: "sparse_tree", entryCount, minimum: TREE_ENTRY_MINIMUM },
+                    }));
+                }
+                if (!hasResponsibilityHints(treeBlock)) {
+                    issues.push(buildIssue({
+                        id: "gate-pdr-folder-tree-missing-responsibilities",
+                        message: "Folder tree block is missing responsibility hints for listed paths.",
+                        remediation: "Annotate key paths with short purpose/ownership comments to make the structure actionable.",
+                        record: pdr,
+                        line: section.line,
+                        metadata: { issueType: "missing_tree_responsibilities" },
+                    }));
+                }
+            }
+        }
+    }
+    catch (error) {
+        notes.push(`Unable to read PDR ${pdr.path}: ${error.message ?? String(error)}`);
+    }
+    const status = issues.length === 0 ? "pass" : "fail";
+    return {
+        gateId: "gate-pdr-folder-tree",
+        gateName: "PDR Folder Tree",
+        status,
+        issues,
+        notes: notes.length ? notes : undefined,
+        metadata: { issueCount: issues.length },
+    };
+};

package/dist/services/docs/review/gates/PdrNoUnresolvedItemsGate.d.ts

@@ -0,0 +1,7 @@
+import { DocgenArtifactInventory } from "../../DocgenRunContext.js";
+import { ReviewGateResult } from "../ReviewTypes.js";
+export interface PdrNoUnresolvedItemsGateInput {
+    artifacts: DocgenArtifactInventory;
+}
+export declare const runPdrNoUnresolvedItemsGate: (input: PdrNoUnresolvedItemsGateInput) => Promise<ReviewGateResult>;
+//# sourceMappingURL=PdrNoUnresolvedItemsGate.d.ts.map

package/dist/services/docs/review/gates/PdrNoUnresolvedItemsGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdrNoUnresolvedItemsGate.d.ts","sourceRoot":"","sources":["../../../../../src/services/docs/review/gates/PdrNoUnresolvedItemsGate.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAe,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,uBAAuB,CAAC;CACpC;AA4CD,eAAO,MAAM,2BAA2B,GACtC,OAAO,6BAA6B,KACnC,OAAO,CAAC,gBAAgB,CAsF1B,CAAC"}

package/dist/services/docs/review/gates/PdrNoUnresolvedItemsGate.js

@@ -0,0 +1,109 @@
+import { promises as fs } from "node:fs";
+const UNRESOLVED_PATTERNS = [
+    /\bTBD\b/i,
+    /\bTBC\b/i,
+    /\bTODO\b/i,
+    /\bFIXME\b/i,
+    /\bto be (determined|decided|filled)\b/i,
+    /\bunknown\b/i,
+    /\bunresolved\b/i,
+];
+const OPEN_QUESTIONS_HEADING = /open questions?/i;
+const RESOLVED_LINE = /^[-*+\d.)\s]*resolved:/i;
+const NO_OPEN_ITEMS_LINE = /no unresolved questions remain|no open questions remain/i;
+const isFenceLine = (line) => /^```|^~~~/.test(line.trim());
+const buildIssue = (input) => ({
+    id: input.id,
+    gateId: "gate-pdr-no-unresolved-items",
+    severity: "high",
+    category: "open_questions",
+    artifact: "pdr",
+    message: input.message,
+    remediation: input.remediation,
+    location: {
+        kind: "line_range",
+        path: input.record.path,
+        lineStart: input.line,
+        lineEnd: input.line,
+        excerpt: input.excerpt,
+    },
+    metadata: input.metadata,
+});
+export const runPdrNoUnresolvedItemsGate = async (input) => {
+    const pdr = input.artifacts.pdr;
+    if (!pdr) {
+        return {
+            gateId: "gate-pdr-no-unresolved-items",
+            gateName: "PDR No Unresolved Items",
+            status: "skipped",
+            issues: [],
+            notes: ["No PDR artifact available for unresolved item validation."],
+        };
+    }
+    const issues = [];
+    const notes = [];
+    try {
+        const content = await fs.readFile(pdr.path, "utf8");
+        const lines = content.split(/\r?\n/);
+        let inFence = false;
+        let inOpenQuestions = false;
+        for (let i = 0; i < lines.length; i += 1) {
+            const line = lines[i] ?? "";
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            if (isFenceLine(trimmed)) {
+                inFence = !inFence;
+                continue;
+            }
+            if (inFence)
+                continue;
+            const heading = trimmed.match(/^#{1,6}\s+(.*)$/);
+            if (heading) {
+                const title = heading[1]?.trim() ?? "";
+                inOpenQuestions = OPEN_QUESTIONS_HEADING.test(title);
+                continue;
+            }
+            if (inOpenQuestions) {
+                if (NO_OPEN_ITEMS_LINE.test(trimmed))
+                    continue;
+                if (RESOLVED_LINE.test(trimmed))
+                    continue;
+                issues.push(buildIssue({
+                    id: `gate-pdr-no-unresolved-items-open-${i + 1}`,
+                    message: "Open Questions section contains an unresolved entry.",
+                    remediation: "Rewrite entries as resolved decisions (prefix each line with 'Resolved:') or remove unresolved items.",
+                    record: pdr,
+                    line: i + 1,
+                    excerpt: trimmed,
+                    metadata: { issueType: "unresolved_open_question" },
+                }));
+                continue;
+            }
+            const unresolvedPattern = UNRESOLVED_PATTERNS.find((pattern) => pattern.test(trimmed));
+            if (unresolvedPattern) {
+                issues.push(buildIssue({
+                    id: `gate-pdr-no-unresolved-items-marker-${i + 1}`,
+                    message: "PDR contains unresolved placeholder language.",
+                    remediation: "Replace unresolved markers with explicit decisions and concrete implementation details.",
+                    record: pdr,
+                    line: i + 1,
+                    excerpt: trimmed,
+                    metadata: { issueType: "unresolved_marker", pattern: unresolvedPattern.source },
+                }));
+            }
+        }
+    }
+    catch (error) {
+        notes.push(`Unable to read PDR ${pdr.path}: ${error.message ?? String(error)}`);
+    }
+    const status = issues.length === 0 ? "pass" : "fail";
+    return {
+        gateId: "gate-pdr-no-unresolved-items",
+        gateName: "PDR No Unresolved Items",
+        status,
+        issues,
+        notes: notes.length ? notes : undefined,
+        metadata: { issueCount: issues.length },
+    };
+};

package/dist/services/docs/review/gates/PdrTechStackRationaleGate.d.ts

@@ -0,0 +1,7 @@
+import { DocgenArtifactInventory } from "../../DocgenRunContext.js";
+import { ReviewGateResult } from "../ReviewTypes.js";
+export interface PdrTechStackRationaleGateInput {
+    artifacts: DocgenArtifactInventory;
+}
+export declare const runPdrTechStackRationaleGate: (input: PdrTechStackRationaleGateInput) => Promise<ReviewGateResult>;
+//# sourceMappingURL=PdrTechStackRationaleGate.d.ts.map

package/dist/services/docs/review/gates/PdrTechStackRationaleGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdrTechStackRationaleGate.d.ts","sourceRoot":"","sources":["../../../../../src/services/docs/review/gates/PdrTechStackRationaleGate.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAe,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,uBAAuB,CAAC;CACpC;AAqED,eAAO,MAAM,4BAA4B,GACvC,OAAO,8BAA8B,KACpC,OAAO,CAAC,gBAAgB,CAoF1B,CAAC"}

package/dist/services/docs/review/gates/PdrTechStackRationaleGate.js

@@ -0,0 +1,128 @@
+import { promises as fs } from "node:fs";
+const SECTION_HEADING = /platform model|technology stack|tech stack/i;
+const CHOSEN_STACK_PATTERNS = [/chosen stack/i, /selected stack/i, /primary stack/i, /\bwe use\b/i];
+const ALTERNATIVES_PATTERNS = [/alternatives? considered/i, /\balternative\b/i, /options? considered/i];
+const RATIONALE_PATTERNS = [/rationale/i, /trade[- ]?off/i, /\bbecause\b/i, /why (this|the) stack/i];
+const isFenceLine = (line) => /^```|^~~~/.test(line.trim());
+const extractSection = (lines, headingMatch) => {
+    let inFence = false;
+    let capture = false;
+    let startLine = 0;
+    const collected = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        const trimmed = line.trim();
+        if (isFenceLine(trimmed)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        const heading = trimmed.match(/^#{1,6}\s+(.*)$/);
+        if (heading) {
+            const title = heading[1]?.trim() ?? "";
+            if (headingMatch.test(title)) {
+                capture = true;
+                startLine = i + 1;
+                continue;
+            }
+            if (capture)
+                break;
+        }
+        if (capture && trimmed)
+            collected.push(trimmed);
+    }
+    if (!capture)
+        return undefined;
+    return { content: collected, line: startLine };
+};
+const containsAny = (lines, patterns) => lines.some((line) => patterns.some((pattern) => pattern.test(line)));
+const buildIssue = (input) => ({
+    id: input.id,
+    gateId: "gate-pdr-tech-stack-rationale",
+    severity: "high",
+    category: "decision",
+    artifact: "pdr",
+    message: input.message,
+    remediation: input.remediation,
+    location: {
+        kind: "line_range",
+        path: input.record.path,
+        lineStart: input.line ?? 1,
+        lineEnd: input.line ?? 1,
+        excerpt: input.message,
+    },
+    metadata: input.metadata,
+});
+export const runPdrTechStackRationaleGate = async (input) => {
+    const pdr = input.artifacts.pdr;
+    if (!pdr) {
+        return {
+            gateId: "gate-pdr-tech-stack-rationale",
+            gateName: "PDR Tech Stack Rationale",
+            status: "skipped",
+            issues: [],
+            notes: ["No PDR artifact available for tech stack rationale validation."],
+        };
+    }
+    const issues = [];
+    const notes = [];
+    try {
+        const content = await fs.readFile(pdr.path, "utf8");
+        const lines = content.split(/\r?\n/);
+        const stackSection = extractSection(lines, SECTION_HEADING);
+        if (!stackSection) {
+            issues.push(buildIssue({
+                id: "gate-pdr-tech-stack-rationale-missing-section",
+                message: "PDR is missing a platform model / technology stack section.",
+                remediation: "Add a section that defines the selected stack, alternatives considered, and decision rationale.",
+                record: pdr,
+                metadata: { issueType: "missing_tech_stack_section" },
+            }));
+        }
+        else {
+            if (!containsAny(stackSection.content, CHOSEN_STACK_PATTERNS)) {
+                issues.push(buildIssue({
+                    id: "gate-pdr-tech-stack-rationale-missing-chosen",
+                    message: "Tech stack section does not explicitly state the chosen stack baseline.",
+                    remediation: "Add explicit chosen/selected stack statements for runtime, language, persistence, and tooling.",
+                    record: pdr,
+                    line: stackSection.line,
+                    metadata: { issueType: "missing_chosen_stack" },
+                }));
+            }
+            if (!containsAny(stackSection.content, ALTERNATIVES_PATTERNS)) {
+                issues.push(buildIssue({
+                    id: "gate-pdr-tech-stack-rationale-missing-alternatives",
+                    message: "Tech stack section does not document alternatives considered.",
+                    remediation: "Document at least one realistic alternative and explain why it was not selected.",
+                    record: pdr,
+                    line: stackSection.line,
+                    metadata: { issueType: "missing_alternatives" },
+                }));
+            }
+            if (!containsAny(stackSection.content, RATIONALE_PATTERNS)) {
+                issues.push(buildIssue({
+                    id: "gate-pdr-tech-stack-rationale-missing-rationale",
+                    message: "Tech stack section does not include explicit decision rationale/trade-offs.",
+                    remediation: "Add rationale that explains trade-offs and why the selected stack is preferred for this phase.",
+                    record: pdr,
+                    line: stackSection.line,
+                    metadata: { issueType: "missing_rationale" },
+                }));
+            }
+        }
+    }
+    catch (error) {
+        notes.push(`Unable to read PDR ${pdr.path}: ${error.message ?? String(error)}`);
+    }
+    const status = issues.length === 0 ? "pass" : "fail";
+    return {
+        gateId: "gate-pdr-tech-stack-rationale",
+        gateName: "PDR Tech Stack Rationale",
+        status,
+        issues,
+        notes: notes.length ? notes : undefined,
+        metadata: { issueCount: issues.length },
+    };
+};

package/dist/services/docs/review/gates/SdsFolderTreeGate.d.ts

@@ -0,0 +1,7 @@
+import { DocgenArtifactInventory } from "../../DocgenRunContext.js";
+import { ReviewGateResult } from "../ReviewTypes.js";
+export interface SdsFolderTreeGateInput {
+    artifacts: DocgenArtifactInventory;
+}
+export declare const runSdsFolderTreeGate: (input: SdsFolderTreeGateInput) => Promise<ReviewGateResult>;
+//# sourceMappingURL=SdsFolderTreeGate.d.ts.map

package/dist/services/docs/review/gates/SdsFolderTreeGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdsFolderTreeGate.d.ts","sourceRoot":"","sources":["../../../../../src/services/docs/review/gates/SdsFolderTreeGate.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAe,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,uBAAuB,CAAC;CACpC;AAsFD,eAAO,MAAM,oBAAoB,GAC/B,OAAO,sBAAsB,KAC5B,OAAO,CAAC,gBAAgB,CAwF1B,CAAC"}

package/dist/services/docs/review/gates/SdsFolderTreeGate.js

@@ -0,0 +1,153 @@
+import { promises as fs } from "node:fs";
+const FOLDER_TREE_HEADING = /folder tree|directory structure|repository structure|target structure/i;
+const TREE_ENTRY_MINIMUM = 8;
+const isFenceLine = (line) => /^```|^~~~/.test(line.trim());
+const extractSection = (lines, headingMatch) => {
+    let inFence = false;
+    let capture = false;
+    let startLine = 0;
+    const collected = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        const trimmed = line.trim();
+        if (isFenceLine(trimmed)) {
+            inFence = !inFence;
+            if (capture)
+                collected.push(trimmed);
+            continue;
+        }
+        const heading = trimmed.match(/^#{1,6}\s+(.*)$/);
+        if (heading && !inFence) {
+            const title = heading[1]?.trim() ?? "";
+            if (headingMatch.test(title)) {
+                capture = true;
+                startLine = i + 1;
+                continue;
+            }
+            if (capture)
+                break;
+        }
+        if (capture)
+            collected.push(line);
+    }
+    if (!capture)
+        return undefined;
+    return { content: collected, line: startLine };
+};
+const extractTreeBlock = (content) => {
+    const match = content.match(/```(?:text)?\s*([\s\S]*?)```/i);
+    if (!match)
+        return undefined;
+    return match[1]?.trim();
+};
+const countTreeEntries = (treeBlock) => {
+    return treeBlock
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => {
+        if (!line)
+            return false;
+        if (line === ".")
+            return true;
+        if (/^[├└│]/.test(line))
+            return true;
+        if (/[A-Za-z0-9_.-]+\/?(\s+[#-].*)?$/.test(line))
+            return true;
+        return false;
+    }).length;
+};
+const hasResponsibilityHints = (treeBlock) => /#|responsibilit|owner|module|service|tests?|scripts?/i.test(treeBlock);
+const buildIssue = (input) => ({
+    id: input.id,
+    gateId: "gate-sds-folder-tree",
+    severity: "high",
+    category: "completeness",
+    artifact: "sds",
+    message: input.message,
+    remediation: input.remediation,
+    location: {
+        kind: "line_range",
+        path: input.record.path,
+        lineStart: input.line ?? 1,
+        lineEnd: input.line ?? 1,
+        excerpt: input.message,
+    },
+    metadata: input.metadata,
+});
+export const runSdsFolderTreeGate = async (input) => {
+    const sds = input.artifacts.sds;
+    if (!sds) {
+        return {
+            gateId: "gate-sds-folder-tree",
+            gateName: "SDS Folder Tree",
+            status: "skipped",
+            issues: [],
+            notes: ["No SDS artifact available for folder tree validation."],
+        };
+    }
+    const issues = [];
+    const notes = [];
+    try {
+        const content = await fs.readFile(sds.path, "utf8");
+        const lines = content.split(/\r?\n/);
+        const section = extractSection(lines, FOLDER_TREE_HEADING);
+        if (!section) {
+            issues.push(buildIssue({
+                id: "gate-sds-folder-tree-missing-section",
+                message: "SDS is missing a target folder tree section.",
+                remediation: "Add a dedicated folder tree section with an expanded repository tree and responsibilities.",
+                record: sds,
+                metadata: { issueType: "missing_folder_tree_section" },
+            }));
+        }
+        else {
+            const sectionText = section.content.join("\n").trim();
+            const treeBlock = extractTreeBlock(sectionText);
+            if (!treeBlock) {
+                issues.push(buildIssue({
+                    id: "gate-sds-folder-tree-missing-fence",
+                    message: "Folder tree section does not include a fenced text tree block.",
+                    remediation: "Add a fenced block (```text ... ```) that describes the target repository tree.",
+                    record: sds,
+                    line: section.line,
+                    metadata: { issueType: "missing_fenced_tree" },
+                }));
+            }
+            else {
+                const entryCount = countTreeEntries(treeBlock);
+                if (entryCount < TREE_ENTRY_MINIMUM) {
+                    issues.push(buildIssue({
+                        id: "gate-sds-folder-tree-sparse-tree",
+                        message: `Folder tree block is too sparse (${entryCount} entries).`,
+                        remediation: "Expand the tree to include major docs/source/contracts/db/deploy/tests/scripts paths.",
+                        record: sds,
+                        line: section.line,
+                        metadata: { issueType: "sparse_tree", entryCount, minimum: TREE_ENTRY_MINIMUM },
+                    }));
+                }
+                if (!hasResponsibilityHints(treeBlock)) {
+                    issues.push(buildIssue({
+                        id: "gate-sds-folder-tree-missing-responsibilities",
+                        message: "Folder tree block is missing responsibility hints for listed paths.",
+                        remediation: "Annotate key paths with short purpose/ownership comments to make the structure actionable.",
+                        record: sds,
+                        line: section.line,
+                        metadata: { issueType: "missing_tree_responsibilities" },
+                    }));
+                }
+            }
+        }
+    }
+    catch (error) {
+        notes.push(`Unable to read SDS ${sds.path}: ${error.message ?? String(error)}`);
+    }
+    const status = issues.length === 0 ? "pass" : "fail";
+    return {
+        gateId: "gate-sds-folder-tree",
+        gateName: "SDS Folder Tree",
+        status,
+        issues,
+        notes: notes.length ? notes : undefined,
+        metadata: { issueCount: issues.length },
+    };
+};

package/dist/services/docs/review/gates/SdsNoUnresolvedItemsGate.d.ts

@@ -0,0 +1,7 @@
+import { DocgenArtifactInventory } from "../../DocgenRunContext.js";
+import { ReviewGateResult } from "../ReviewTypes.js";
+export interface SdsNoUnresolvedItemsGateInput {
+    artifacts: DocgenArtifactInventory;
+}
+export declare const runSdsNoUnresolvedItemsGate: (input: SdsNoUnresolvedItemsGateInput) => Promise<ReviewGateResult>;
+//# sourceMappingURL=SdsNoUnresolvedItemsGate.d.ts.map

package/dist/services/docs/review/gates/SdsNoUnresolvedItemsGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdsNoUnresolvedItemsGate.d.ts","sourceRoot":"","sources":["../../../../../src/services/docs/review/gates/SdsNoUnresolvedItemsGate.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAe,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,uBAAuB,CAAC;CACpC;AA4CD,eAAO,MAAM,2BAA2B,GACtC,OAAO,6BAA6B,KACnC,OAAO,CAAC,gBAAgB,CAsF1B,CAAC"}