sdd-cli 0.1.22 → 0.1.23

package/README.md

@@ -171,6 +171,7 @@ Use `--questions` when you want the manual question-by-question flow.
 - `sdd-cli import issue <github-issue-url>` -- import issue context and bootstrap autopilot
 - `sdd-cli import jira <ticket-or-browse-url>` -- import Jira context and bootstrap autopilot
 - `sdd-cli import linear <ticket-or-issue-url>` -- import Linear context and bootstrap autopilot
+- `sdd-cli import azure <work-item-or-url>` -- import Azure Boards context and bootstrap autopilot
 
 ### Requirement lifecycle
 - `sdd-cli req create`

package/dist/cli.js

@@ -49,6 +49,7 @@ const status_1 = require("./commands/status");
 const import_issue_1 = require("./commands/import-issue");
 const import_jira_1 = require("./commands/import-jira");
 const import_linear_1 = require("./commands/import-linear");
+const import_azure_1 = require("./commands/import-azure");
 const paths_1 = require("./paths");
 const flags_1 = require("./context/flags");
 const prompt_1 = require("./ui/prompt");
@@ -406,4 +407,11 @@ importCmd
     .action(async (ticket) => {
     await (0, import_linear_1.runImportLinear)(ticket);
 });
+importCmd
+    .command("azure")
+    .description("Import an Azure Boards work item and bootstrap autopilot")
+    .argument("<work-item>", "Azure work item id, AB#id, or work item URL")
+    .action(async (workItem) => {
+    await (0, import_azure_1.runImportAzure)(workItem);
+});
 program.parse(process.argv);

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

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

package/dist/commands/import-azure.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runImportAzure = runImportAzure;
+const hello_1 = require("./hello");
+const errors_1 = require("../errors");
+function parseAzureWorkItem(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        return null;
+    }
+    const shorthand = trimmed.match(/^AB#(\d+)$/i);
+    if (shorthand) {
+        return { id: shorthand[1] };
+    }
+    const numeric = trimmed.match(/^(\d+)$/);
+    if (numeric) {
+        return { id: numeric[1] };
+    }
+    const azureUrl = trimmed.match(/^https?:\/\/dev\.azure\.com\/([^/]+)\/([^/]+)\/_workitems\/edit\/(\d+)(?:[/?#].*)?$/i);
+    if (azureUrl) {
+        const parsed = new URL(trimmed);
+        return {
+            id: azureUrl[3],
+            siteBase: `${parsed.protocol}//${parsed.host}/${azureUrl[1]}`,
+            project: azureUrl[2]
+        };
+    }
+    return null;
+}
+function stripHtml(value) {
+    return value
+        .replace(/<style[\s\S]*?<\/style>/gi, " ")
+        .replace(/<script[\s\S]*?<\/script>/gi, " ")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/gi, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function getAzureApiBase(ref) {
+    if (process.env.SDD_AZURE_API_BASE && process.env.SDD_AZURE_API_BASE.trim().length > 0) {
+        return process.env.SDD_AZURE_API_BASE.trim().replace(/\/$/, "");
+    }
+    if (ref.siteBase && ref.project) {
+        return `${ref.siteBase.replace(/\/$/, "")}/${ref.project}/_apis/wit`;
+    }
+    return null;
+}
+function getAzureAuthHeader() {
+    const pat = (process.env.SDD_AZURE_PAT || "").trim();
+    if (pat.length === 0) {
+        return null;
+    }
+    const basic = Buffer.from(`:${pat}`, "utf-8").toString("base64");
+    return `Basic ${basic}`;
+}
+async function fetchAzureWorkItem(ref) {
+    const apiBase = getAzureApiBase(ref);
+    if (!apiBase) {
+        throw new Error("Azure API base is required. Set SDD_AZURE_API_BASE or provide a full URL: https://dev.azure.com/<org>/<project>/_workitems/edit/<id>");
+    }
+    const endpoint = `${apiBase}/workitems/${encodeURIComponent(ref.id)}?api-version=7.1`;
+    const headers = {
+        Accept: "application/json",
+        "User-Agent": "sdd-cli"
+    };
+    const auth = getAzureAuthHeader();
+    if (auth) {
+        headers.Authorization = auth;
+    }
+    const response = await fetch(endpoint, { headers });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch Azure work item (${response.status}).`);
+    }
+    const payload = (await response.json());
+    const resolvedId = String(payload.id ?? ref.id);
+    const titleRaw = payload.fields?.["System.Title"];
+    const descriptionRaw = payload.fields?.["System.Description"];
+    const sourceUrlRaw = payload._links?.html?.href;
+    const title = typeof titleRaw === "string" && titleRaw.trim().length > 0 ? titleRaw.trim() : `Work item ${resolvedId}`;
+    const description = typeof descriptionRaw === "string" && descriptionRaw.trim().length > 0 ? stripHtml(descriptionRaw) : "";
+    const sourceUrl = typeof sourceUrlRaw === "string" && sourceUrlRaw.trim().length > 0
+        ? sourceUrlRaw.trim()
+        : ref.siteBase && ref.project
+            ? `${ref.siteBase.replace(/\/$/, "")}/${ref.project}/_workitems/edit/${resolvedId}`
+            : `AB#${resolvedId}`;
+    return {
+        id: resolvedId,
+        title,
+        description,
+        sourceUrl
+    };
+}
+function buildSeedText(item) {
+    const bodySnippet = item.description.trim().slice(0, 400).replace(/\s+/g, " ");
+    return `Resolve Azure work item: ${item.id} ${item.title}. Context: ${bodySnippet}. Source: ${item.sourceUrl}`;
+}
+async function runImportAzure(workItemInput) {
+    const ref = parseAzureWorkItem(workItemInput);
+    if (!ref) {
+        (0, errors_1.printError)("SDD-1131", "Invalid Azure work item. Expected AB#1234, 1234, or https://dev.azure.com/<org>/<project>/_workitems/edit/1234");
+        return;
+    }
+    console.log(`Importing Azure work item ${ref.id} ...`);
+    try {
+        const ticket = await fetchAzureWorkItem(ref);
+        console.log(`Imported: ${ticket.title}`);
+        await (0, hello_1.runHello)(buildSeedText(ticket), false);
+    }
+    catch (error) {
+        (0, errors_1.printError)("SDD-1132", error.message);
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sdd-cli",
-  "version": "0.1.22",
-  "description": "Use sdd-cli to turn ideas, GitHub/Jira work items, and PR feedback into actionable requirements, specs, plans, and done-ready delivery records with guided workflows.",
+  "version": "0.1.23",
+  "description": "CLI for turning ideas and tracker work items (GitHub, Jira, Linear, Azure) into actionable requirements, specs, test plans, and done-ready delivery artifacts with guided autopilot workflows.",
   "keywords": [
     "cli",
     "specification-driven-development",