sdd-cli 0.1.18 → 0.1.20

package/dist/commands/gen-project-readme.js

@@ -12,11 +12,12 @@ const validate_1 = require("../validation/validate");
 const gen_utils_1 = require("./gen-utils");
 const flags_1 = require("../context/flags");
 const index_1 = require("../workspace/index");
+const errors_1 = require("../errors");
 async function runGenProjectReadme() {
     const projectName = await (0, prompt_1.askProjectName)();
     const reqId = await (0, prompt_1.ask)("Requirement ID (REQ-...): ");
     if (!projectName || !reqId) {
-        console.log("Project name and requirement ID are required.");
+        (0, errors_1.printError)("SDD-1651", "Project name and requirement ID are required.");
         return;
     }
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -25,12 +26,12 @@ async function runGenProjectReadme() {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1652", error.message);
         return;
     }
     const requirementDir = (0, gen_utils_1.findRequirementDir)(project.name, reqId);
     if (!requirementDir) {
-        console.log("Requirement not found.");
+        (0, errors_1.printError)("SDD-1653", "Requirement not found.");
         return;
     }
     const overview = await (0, prompt_1.ask)("Project overview: ");
@@ -58,8 +59,8 @@ async function runGenProjectReadme() {
     };
     const validation = (0, validate_1.validateJson)("project-readme.schema.json", projectReadmeJson);
     if (!validation.valid) {
-        console.log("Project README validation failed:");
-        validation.errors.forEach((error) => console.log(`- ${error}`));
+        (0, errors_1.printError)("SDD-1654", "Project README validation failed.");
+        validation.errors.forEach((error) => (0, errors_1.printError)("SDD-1654", error));
         return;
     }
     const template = (0, render_1.loadTemplate)("project-readme");

package/dist/commands/gen-technical-spec.js

@@ -13,11 +13,12 @@ const validate_1 = require("../validation/validate");
 const gen_utils_1 = require("./gen-utils");
 const flags_1 = require("../context/flags");
 const index_1 = require("../workspace/index");
+const errors_1 = require("../errors");
 async function runGenTechnicalSpec() {
     const projectName = await (0, prompt_1.askProjectName)();
     const reqId = await (0, prompt_1.ask)("Requirement ID (REQ-...): ");
     if (!projectName || !reqId) {
-        console.log("Project name and requirement ID are required.");
+        (0, errors_1.printError)("SDD-1621", "Project name and requirement ID are required.");
         return;
     }
     const workspace = (0, index_1.getWorkspaceInfo)();
@@ -26,12 +27,12 @@ async function runGenTechnicalSpec() {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1622", error.message);
         return;
     }
     const requirementDir = (0, gen_utils_1.findRequirementDir)(project.name, reqId);
     if (!requirementDir) {
-        console.log("Requirement not found.");
+        (0, errors_1.printError)("SDD-1623", "Requirement not found.");
         return;
     }
     const stack = await (0, prompt_1.ask)("Tech stack - comma separated: ");
@@ -54,8 +55,8 @@ async function runGenTechnicalSpec() {
     };
     const validation = (0, validate_1.validateJson)("technical-spec.schema.json", technicalJson);
     if (!validation.valid) {
-        console.log("Technical spec validation failed:");
-        validation.errors.forEach((error) => console.log(`- ${error}`));
+        (0, errors_1.printError)("SDD-1624", "Technical spec validation failed.");
+        validation.errors.forEach((error) => (0, errors_1.printError)("SDD-1624", error));
         return;
     }
     const template = (0, render_1.loadTemplate)("technical-spec");

package/dist/commands/gen-utils.js

@@ -11,6 +11,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const index_1 = require("../workspace/index");
 const flags_1 = require("../context/flags");
+const errors_1 = require("../errors");
 function findRequirementDir(projectName, reqId) {
     const workspace = (0, index_1.getWorkspaceInfo)();
     let project;
@@ -18,7 +19,7 @@ function findRequirementDir(projectName, reqId) {
         project = (0, index_1.getProjectInfo)(workspace, projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1605", error.message);
         return null;
     }
     const base = path_1.default.join(project.root, "requirements");

package/dist/commands/hello.js

@@ -13,6 +13,8 @@ const req_start_1 = require("./req-start");
 const req_finish_1 = require("./req-finish");
 const route_1 = require("./route");
 const test_plan_1 = require("./test-plan");
+const local_metrics_1 = require("../telemetry/local-metrics");
+const errors_1 = require("../errors");
 const autopilot_checkpoint_1 = require("./autopilot-checkpoint");
 function printStep(step, description) {
     console.log(`${step}: ${description}`);
@@ -101,6 +103,10 @@ function buildAutopilotDraft(input, flow, domain) {
     };
 }
 async function runHello(input, runQuestions) {
+    (0, local_metrics_1.recordActivationMetric)("started", {
+        directIntent: input.trim().length > 0,
+        questionMode: runQuestions === true
+    });
     function loadWorkspace() {
         const workspace = (0, index_1.getWorkspaceInfo)();
         (0, index_1.ensureWorkspace)(workspace);
@@ -181,7 +187,12 @@ async function runHello(input, runQuestions) {
     }
     let text = input || (await (0, prompt_1.ask)("Describe what you want to do: "));
     let checkpoint = null;
-    let fromStep = (0, autopilot_checkpoint_1.normalizeStep)(runtimeFlags.fromStep);
+    const rawFromStep = runtimeFlags.fromStep?.trim();
+    let fromStep = (0, autopilot_checkpoint_1.normalizeStep)(rawFromStep);
+    if (rawFromStep && !fromStep) {
+        (0, errors_1.printError)("SDD-1003", `Invalid --from-step value. Use one of: ${autopilot_checkpoint_1.AUTOPILOT_STEPS.join(", ")}`);
+        return;
+    }
     let activeProjectForCheckpoint = runtimeFlags.project;
     if (!shouldRunQuestions && activeProjectForCheckpoint) {
         checkpoint = (0, autopilot_checkpoint_1.loadCheckpoint)(activeProjectForCheckpoint);
@@ -196,7 +207,7 @@ async function runHello(input, runQuestions) {
         }
     }
     if (!text) {
-        console.log("No input provided. Try again with a short description.");
+        (0, errors_1.printError)("SDD-1001", "No input provided. Try again with a short description.");
         return;
     }
     const intent = (0, intent_1.classifyIntent)(text);
@@ -258,7 +269,7 @@ async function runHello(input, runQuestions) {
             }
         }
         if (!activeProject) {
-            console.log("Project name is required to run autopilot.");
+            (0, errors_1.printError)("SDD-1002", "Project name is required to run autopilot.");
             return;
         }
         printWhy(`Using project: ${activeProject}`);
@@ -270,16 +281,12 @@ async function runHello(input, runQuestions) {
                 fromStep = candidate;
             }
         }
-        if (fromStep && !autopilot_checkpoint_1.AUTOPILOT_STEPS.includes(fromStep)) {
-            console.log(`Invalid --from-step value. Use one of: ${autopilot_checkpoint_1.AUTOPILOT_STEPS.join(", ")}`);
-            return;
-        }
         const draft = buildAutopilotDraft(text, intent.flow, intent.domain);
         draft.project_name = activeProject;
         let reqId = checkpoint?.reqId ?? "";
         const startStep = fromStep ?? "create";
         if (startStep !== "create" && !reqId) {
-            console.log("No checkpoint found for resume. Run full autopilot first or use --from-step create.");
+            (0, errors_1.printError)("SDD-1004", "No checkpoint found for resume. Run full autopilot first or use --from-step create.");
             printRecoveryNext(activeProject, "create", text);
             return;
         }
@@ -375,6 +382,10 @@ async function runHello(input, runQuestions) {
                     return;
                 }
                 (0, autopilot_checkpoint_1.clearCheckpoint)(activeProject);
+                (0, local_metrics_1.recordActivationMetric)("completed", {
+                    project: activeProject,
+                    reqId
+                });
                 console.log(`Autopilot completed successfully for ${reqId}.`);
                 console.log(`Artifacts finalized at: ${finished.doneDir}`);
                 return;

package/dist/commands/import-issue.d.ts

@@ -0,0 +1 @@
+export declare function runImportIssue(issueUrl: string): Promise<void>;

package/dist/commands/import-issue.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runImportIssue = runImportIssue;
+const hello_1 = require("./hello");
+const errors_1 = require("../errors");
+function parseGitHubIssueUrl(input) {
+    const trimmed = input.trim();
+    const match = trimmed.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+)\/issues\/(\d+)(?:[/?#].*)?$/i);
+    if (!match) {
+        return null;
+    }
+    return { owner: match[1], repo: match[2], number: match[3] };
+}
+async function fetchIssue(ref) {
+    const baseApi = process.env.SDD_GITHUB_API_BASE || "https://api.github.com";
+    const endpoint = `${baseApi.replace(/\/$/, "")}/repos/${ref.owner}/${ref.repo}/issues/${ref.number}`;
+    const response = await fetch(endpoint, {
+        headers: {
+            Accept: "application/vnd.github+json",
+            "User-Agent": "sdd-cli"
+        }
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch issue (${response.status}).`);
+    }
+    const payload = (await response.json());
+    return {
+        title: payload.title || `Issue #${ref.number}`,
+        body: payload.body || "",
+        url: payload.html_url || `https://github.com/${ref.owner}/${ref.repo}/issues/${ref.number}`
+    };
+}
+function buildSeedText(issue) {
+    const bodySnippet = issue.body.trim().slice(0, 400).replace(/\s+/g, " ");
+    return `Resolve issue: ${issue.title}. Context: ${bodySnippet}. Source: ${issue.url}`;
+}
+async function runImportIssue(issueUrl) {
+    const ref = parseGitHubIssueUrl(issueUrl);
+    if (!ref) {
+        (0, errors_1.printError)("SDD-1101", "Invalid GitHub issue URL. Expected format: https://github.com/<owner>/<repo>/issues/<number>");
+        return;
+    }
+    console.log(`Importing issue ${ref.owner}/${ref.repo}#${ref.number} ...`);
+    try {
+        const issue = await fetchIssue(ref);
+        const seedText = buildSeedText(issue);
+        console.log(`Imported: ${issue.title}`);
+        await (0, hello_1.runHello)(seedText, false);
+    }
+    catch (error) {
+        (0, errors_1.printError)("SDD-1102", error.message);
+    }
+}

package/dist/commands/import-jira.d.ts

@@ -0,0 +1 @@
+export declare function runImportJira(ticketInput: string): Promise<void>;

package/dist/commands/import-jira.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runImportJira = runImportJira;
+const hello_1 = require("./hello");
+const errors_1 = require("../errors");
+function parseJiraTicket(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        return null;
+    }
+    const keyOnly = trimmed.match(/^([a-z][a-z0-9_]*-\d+)$/i);
+    if (keyOnly) {
+        return { key: keyOnly[1].toUpperCase() };
+    }
+    const browseUrl = trimmed.match(/^https?:\/\/([^/]+)\/browse\/([a-z][a-z0-9_]*-\d+)(?:[/?#].*)?$/i);
+    if (browseUrl) {
+        const parsed = new URL(trimmed);
+        return {
+            key: browseUrl[2].toUpperCase(),
+            siteBase: `${parsed.protocol}//${parsed.host}`
+        };
+    }
+    return null;
+}
+function collectAdfText(node, chunks) {
+    if (!node || typeof node !== "object") {
+        return;
+    }
+    const obj = node;
+    if (typeof obj.text === "string") {
+        chunks.push(obj.text);
+    }
+    if (Array.isArray(obj.content)) {
+        for (const child of obj.content) {
+            collectAdfText(child, chunks);
+        }
+    }
+}
+function toDescriptionText(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (!value || typeof value !== "object") {
+        return "";
+    }
+    const chunks = [];
+    collectAdfText(value, chunks);
+    return chunks.join(" ").trim();
+}
+function getJiraApiBase(ref) {
+    if (process.env.SDD_JIRA_API_BASE && process.env.SDD_JIRA_API_BASE.trim().length > 0) {
+        return [process.env.SDD_JIRA_API_BASE.trim().replace(/\/$/, "")];
+    }
+    if (ref.siteBase) {
+        const site = ref.siteBase.replace(/\/$/, "");
+        return [`${site}/rest/api/3`, `${site}/rest/api/2`];
+    }
+    return [];
+}
+function getJiraAuthHeader() {
+    if (process.env.SDD_JIRA_AUTH && process.env.SDD_JIRA_AUTH.trim().length > 0) {
+        return process.env.SDD_JIRA_AUTH.trim();
+    }
+    const email = process.env.SDD_JIRA_EMAIL || "";
+    const token = process.env.SDD_JIRA_TOKEN || "";
+    if (email.trim().length > 0 && token.trim().length > 0) {
+        const basic = Buffer.from(`${email.trim()}:${token.trim()}`, "utf-8").toString("base64");
+        return `Basic ${basic}`;
+    }
+    return null;
+}
+async function fetchJiraTicket(ref) {
+    const apiBases = getJiraApiBase(ref);
+    if (apiBases.length === 0) {
+        throw new Error("Jira API base is required. Set SDD_JIRA_API_BASE or provide a full browse URL: https://<site>/browse/PROJ-123");
+    }
+    const auth = getJiraAuthHeader();
+    let lastStatus = 0;
+    for (const base of apiBases) {
+        const endpoint = `${base}/issue/${encodeURIComponent(ref.key)}`;
+        const headers = {
+            Accept: "application/json",
+            "User-Agent": "sdd-cli"
+        };
+        if (auth) {
+            headers.Authorization = auth;
+        }
+        const response = await fetch(endpoint, { headers });
+        if (!response.ok) {
+            lastStatus = response.status;
+            continue;
+        }
+        const payload = (await response.json());
+        const key = (payload.key || ref.key).toUpperCase();
+        const summary = payload.fields?.summary?.trim() || `Ticket ${key}`;
+        const description = toDescriptionText(payload.fields?.description);
+        let sourceUrl = `${key}`;
+        if (ref.siteBase) {
+            sourceUrl = `${ref.siteBase.replace(/\/$/, "")}/browse/${key}`;
+        }
+        else if (process.env.SDD_JIRA_SITE_BASE && process.env.SDD_JIRA_SITE_BASE.trim().length > 0) {
+            sourceUrl = `${process.env.SDD_JIRA_SITE_BASE.trim().replace(/\/$/, "")}/browse/${key}`;
+        }
+        return { key, summary, description, sourceUrl };
+    }
+    throw new Error(`Failed to fetch Jira ticket (${lastStatus || "unknown status"}).`);
+}
+function buildSeedText(ticket) {
+    const bodySnippet = ticket.description.trim().slice(0, 400).replace(/\s+/g, " ");
+    return `Resolve Jira ticket: ${ticket.key} ${ticket.summary}. Context: ${bodySnippet}. Source: ${ticket.sourceUrl}`;
+}
+async function runImportJira(ticketInput) {
+    const ref = parseJiraTicket(ticketInput);
+    if (!ref) {
+        (0, errors_1.printError)("SDD-1111", "Invalid Jira ticket. Expected format: PROJ-123 or https://<your-jira-site>/browse/PROJ-123");
+        return;
+    }
+    console.log(`Importing Jira ticket ${ref.key} ...`);
+    try {
+        const ticket = await fetchJiraTicket(ref);
+        console.log(`Imported: ${ticket.summary}`);
+        await (0, hello_1.runHello)(buildSeedText(ticket), false);
+    }
+    catch (error) {
+        (0, errors_1.printError)("SDD-1112", error.message);
+    }
+}

package/dist/commands/learn-deliver.js

@@ -9,10 +9,11 @@ const path_1 = __importDefault(require("path"));
 const prompt_1 = require("../ui/prompt");
 const list_1 = require("../utils/list");
 const learn_utils_1 = require("./learn-utils");
+const errors_1 = require("../errors");
 async function runLearnDeliver() {
     const projectName = await (0, prompt_1.askProjectName)();
     if (!projectName) {
-        console.log("Project name is required.");
+        (0, errors_1.printError)("SDD-1731", "Project name is required.");
         return;
     }
     let sessions = [];
@@ -20,7 +21,7 @@ async function runLearnDeliver() {
         sessions = (0, learn_utils_1.listLearnSessions)(projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1732", error.message);
         return;
     }
     if (sessions.length > 0) {
@@ -29,7 +30,7 @@ async function runLearnDeliver() {
     }
     const sessionId = await (0, prompt_1.ask)("Session ID: ");
     if (!sessionId) {
-        console.log("Session ID is required.");
+        (0, errors_1.printError)("SDD-1733", "Session ID is required.");
         return;
     }
     let loaded;
@@ -37,11 +38,11 @@ async function runLearnDeliver() {
         loaded = (0, learn_utils_1.loadLearnSession)(projectName, sessionId);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1734", error.message);
         return;
     }
     if (!loaded) {
-        console.log("Learning session not found.");
+        (0, errors_1.printError)("SDD-1735", "Learning session not found.");
         return;
     }
     const brief = await (0, prompt_1.ask)("Brief summary: ");

package/dist/commands/learn-refine.js

@@ -9,10 +9,11 @@ const path_1 = __importDefault(require("path"));
 const prompt_1 = require("../ui/prompt");
 const list_1 = require("../utils/list");
 const learn_utils_1 = require("./learn-utils");
+const errors_1 = require("../errors");
 async function runLearnRefine() {
     const projectName = await (0, prompt_1.askProjectName)();
     if (!projectName) {
-        console.log("Project name is required.");
+        (0, errors_1.printError)("SDD-1721", "Project name is required.");
         return;
     }
     let sessions = [];
@@ -20,7 +21,7 @@ async function runLearnRefine() {
         sessions = (0, learn_utils_1.listLearnSessions)(projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1722", error.message);
         return;
     }
     if (sessions.length > 0) {
@@ -29,7 +30,7 @@ async function runLearnRefine() {
     }
     const sessionId = await (0, prompt_1.ask)("Session ID: ");
     if (!sessionId) {
-        console.log("Session ID is required.");
+        (0, errors_1.printError)("SDD-1723", "Session ID is required.");
         return;
     }
     let loaded;
@@ -37,11 +38,11 @@ async function runLearnRefine() {
         loaded = (0, learn_utils_1.loadLearnSession)(projectName, sessionId);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1724", error.message);
         return;
     }
     if (!loaded) {
-        console.log("Learning session not found.");
+        (0, errors_1.printError)("SDD-1725", "Learning session not found.");
         return;
     }
     const purpose = await (0, prompt_1.ask)(`Purpose (${loaded.session.purpose}): `);
@@ -62,11 +63,11 @@ async function runLearnRefine() {
         });
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1726", error.message);
         return;
     }
     if (!updated) {
-        console.log("Failed to update session.");
+        (0, errors_1.printError)("SDD-1727", "Failed to update session.");
         return;
     }
     const sessionMd = [

package/dist/commands/learn-start.js

@@ -9,11 +9,12 @@ const path_1 = __importDefault(require("path"));
 const prompt_1 = require("../ui/prompt");
 const list_1 = require("../utils/list");
 const learn_utils_1 = require("./learn-utils");
+const errors_1 = require("../errors");
 async function runLearnStart() {
     const projectName = await (0, prompt_1.askProjectName)();
     const topic = await (0, prompt_1.ask)("Topic to learn: ");
     if (!projectName || !topic) {
-        console.log("Project name and topic are required.");
+        (0, errors_1.printError)("SDD-1711", "Project name and topic are required.");
         return;
     }
     const purpose = await (0, prompt_1.ask)("Why do you want to learn this? ");
@@ -27,7 +28,7 @@ async function runLearnStart() {
         created = (0, learn_utils_1.createLearnSession)(projectName, topic, "learning");
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1712", error.message);
         return;
     }
     (0, learn_utils_1.updateLearnSession)(projectName, created.session.id, {

package/dist/commands/pr-audit.js

@@ -10,10 +10,11 @@ const prompt_1 = require("../ui/prompt");
 const render_1 = require("../templates/render");
 const list_1 = require("../utils/list");
 const pr_utils_1 = require("./pr-utils");
+const errors_1 = require("../errors");
 async function runPrAudit() {
     const projectName = await (0, prompt_1.askProjectName)();
     if (!projectName) {
-        console.log("Project name is required.");
+        (0, errors_1.printError)("SDD-1346", "Project name is required.");
         return;
     }
     let available = [];
@@ -21,7 +22,7 @@ async function runPrAudit() {
         available = (0, pr_utils_1.listPrReviews)(projectName);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1347", error.message);
         return;
     }
     if (available.length > 0) {
@@ -30,7 +31,7 @@ async function runPrAudit() {
     }
     const prId = await (0, prompt_1.ask)("PR ID: ");
     if (!prId) {
-        console.log("PR ID is required.");
+        (0, errors_1.printError)("SDD-1348", "PR ID is required.");
         return;
     }
     let prDir;
@@ -38,11 +39,11 @@ async function runPrAudit() {
         prDir = (0, pr_utils_1.resolvePrDir)(projectName, prId);
     }
     catch (error) {
-        console.log(error.message);
+        (0, errors_1.printError)("SDD-1349", error.message);
         return;
     }
     if (!fs_1.default.existsSync(prDir)) {
-        console.log(`PR review not found at ${prDir}`);
+        (0, errors_1.printError)("SDD-1350", `PR review not found at ${prDir}`);
         return;
     }
     const prLink = await (0, prompt_1.ask)("PR link: ");

package/dist/commands/pr-bridge-check.d.ts

@@ -0,0 +1 @@
+export declare function runPrBridgeCheck(): Promise<void>;

package/dist/commands/pr-bridge-check.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPrBridgeCheck = runPrBridgeCheck;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const prompt_1 = require("../ui/prompt");
+const gen_utils_1 = require("./gen-utils");
+const errors_1 = require("../errors");
+async function runPrBridgeCheck() {
+    const projectName = await (0, prompt_1.askProjectName)();
+    if (!projectName) {
+        (0, errors_1.printError)("SDD-1331", "Project name is required.");
+        return;
+    }
+    const reqId = await (0, prompt_1.ask)("Requirement ID (REQ-...): ");
+    if (!reqId) {
+        (0, errors_1.printError)("SDD-1332", "Requirement ID is required.");
+        return;
+    }
+    const requirementDir = (0, gen_utils_1.findRequirementDir)(projectName, reqId);
+    if (!requirementDir) {
+        (0, errors_1.printError)("SDD-1333", `Requirement not found: ${reqId}`);
+        return;
+    }
+    const linksPath = path_1.default.join(requirementDir, "pr-links.json");
+    if (!fs_1.default.existsSync(linksPath)) {
+        (0, errors_1.printError)("SDD-1334", "No pr-links.json found for this requirement.");
+        return;
+    }
+    let links = [];
+    try {
+        links = JSON.parse(fs_1.default.readFileSync(linksPath, "utf-8"));
+    }
+    catch {
+        (0, errors_1.printError)("SDD-1335", "Unable to parse pr-links.json.");
+        return;
+    }
+    const checks = links.map((link) => {
+        const prId = link.prId || "unknown";
+        const prDir = link.prDir || "";
+        const bridgeDir = path_1.default.join(requirementDir, "pr-review", prId);
+        const prDirExists = prDir.length > 0 && fs_1.default.existsSync(prDir);
+        const bridgeExists = fs_1.default.existsSync(bridgeDir);
+        const copiedArtifacts = Array.isArray(link.copiedArtifacts) ? link.copiedArtifacts : [];
+        const missingArtifacts = copiedArtifacts.filter((name) => !fs_1.default.existsSync(path_1.default.join(bridgeDir, name)));
+        return {
+            prId,
+            prDir,
+            prDirExists,
+            bridgeDir,
+            bridgeExists,
+            missingArtifacts,
+            ok: prDirExists && bridgeExists && missingArtifacts.length === 0
+        };
+    });
+    const okCount = checks.filter((item) => item.ok).length;
+    const report = {
+        requirement: reqId,
+        checkedAt: new Date().toISOString(),
+        total: checks.length,
+        ok: okCount,
+        failed: checks.length - okCount,
+        checks
+    };
+    fs_1.default.writeFileSync(path_1.default.join(requirementDir, "pr-bridge-integrity.json"), JSON.stringify(report, null, 2), "utf-8");
+    const lines = [
+        `# PR Bridge Integrity: ${reqId}`,
+        "",
+        `- Total links: ${report.total}`,
+        `- OK: ${report.ok}`,
+        `- Failed: ${report.failed}`,
+        "",
+        "## Details"
+    ];
+    checks.forEach((item) => {
+        lines.push(`- ${item.prId}: ok=${item.ok} prDirExists=${item.prDirExists} bridgeExists=${item.bridgeExists} missingArtifacts=${item.missingArtifacts.join(", ") || "none"}`);
+    });
+    fs_1.default.writeFileSync(path_1.default.join(requirementDir, "pr-bridge-integrity.md"), `${lines.join("\n")}\n`, "utf-8");
+    if (report.failed > 0) {
+        (0, errors_1.printError)("SDD-1336", `Bridge integrity failed for ${report.failed} linked PR(s).`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`PR bridge integrity OK for ${reqId}.`);
+}

package/dist/commands/pr-bridge.d.ts

@@ -0,0 +1 @@
+export declare function runPrBridge(): Promise<void>;