sdd-cli 0.1.21 → 0.1.23

package/README.md

@@ -14,6 +14,8 @@ Mission and vision live in `docs/MISSION.md` and `docs/VISION.md`.
 
 Start with `docs/INDEX.md` for a full documentation map and `docs/STYLE.md` for formatting guidance.
 Contributing guidelines live in `docs/CONTRIBUTING.md`.
+Contributor quickstart lives in `docs/CONTRIBUTOR_QUICKSTART.md`.
+Issue triage taxonomy lives in `docs/ISSUE_TRIAGE_PLAYBOOK.md`.
 Use the PR template in `.github/PULL_REQUEST_TEMPLATE.md`.
 Maintenance guidance lives in `docs/MAINTENANCE.md`.
 Install troubleshooting lives in `docs/TROUBLESHOOTING.md`.
@@ -168,6 +170,8 @@ Use `--questions` when you want the manual question-by-question flow.
 ### Imports
 - `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`
@@ -253,6 +257,7 @@ For a full onboarding walkthrough, see:
 - 90-day roadmap: `docs/ADOPTION_ROADMAP_90D.md`
 - Value backlog: `docs/VALUE_BACKLOG.md`
 - Error codes and remediation guide: `docs/ERROR_CODES.md`
+- Integration adapters roadmap and contract: `docs/INTEGRATION_ADAPTERS.md`
 
 ## Where files are stored (clean repos)
 
@@ -275,6 +280,10 @@ Optional:
 `npm run release:notes -- --write --version v0.1.20`
 - Generate post-release quality summary:
 `npm run release:metrics`
+- Run fast contributor smoke checks:
+`npm run dev:smoke`
+- Run contributor pre-PR release checks:
+`npm run dev:release-check`
 - Promote `Unreleased` changelog entries into a version:
 `npm run release:changelog -- --version v0.1.20`
 - Verify tag/version consistency:

package/dist/cli.js

@@ -48,6 +48,8 @@ const quickstart_1 = require("./commands/quickstart");
 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");
@@ -398,4 +400,18 @@ importCmd
     .action(async (ticket) => {
     await (0, import_jira_1.runImportJira)(ticket);
 });
+importCmd
+    .command("linear")
+    .description("Import a Linear ticket and bootstrap autopilot")
+    .argument("<ticket>", "Linear ticket key or issue URL")
+    .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/dist/commands/import-linear.d.ts

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

package/dist/commands/import-linear.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runImportLinear = runImportLinear;
+const hello_1 = require("./hello");
+const errors_1 = require("../errors");
+function parseLinearTicket(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        return null;
+    }
+    const keyOnly = trimmed.match(/^([a-z][a-z0-9_]*-\d+)$/i);
+    if (keyOnly) {
+        return { identifier: keyOnly[1].toUpperCase() };
+    }
+    const linearUrl = trimmed.match(/^https?:\/\/linear\.app\/[^/]+\/issue\/([a-z][a-z0-9_]*-\d+)(?:[/?#].*)?$/i);
+    if (linearUrl) {
+        return { identifier: linearUrl[1].toUpperCase() };
+    }
+    return null;
+}
+async function fetchLinearTicket(ref) {
+    const endpoint = (process.env.SDD_LINEAR_API_BASE || "https://api.linear.app/graphql").trim();
+    const token = (process.env.SDD_LINEAR_API_KEY || "").trim();
+    const query = `
+    query IssueByIdentifier($identifier: String!) {
+      issue(identifier: $identifier) {
+        identifier
+        title
+        description
+        url
+      }
+    }
+  `;
+    const headers = {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        "User-Agent": "sdd-cli"
+    };
+    if (token.length > 0) {
+        headers.Authorization = token.startsWith("Bearer ") ? token : `Bearer ${token}`;
+    }
+    const response = await fetch(endpoint, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+            query,
+            variables: { identifier: ref.identifier }
+        })
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch Linear ticket (${response.status}).`);
+    }
+    const payload = (await response.json());
+    if (payload.errors && payload.errors.length > 0) {
+        const message = payload.errors[0]?.message || "Unknown Linear API error.";
+        throw new Error(`Linear API error: ${message}`);
+    }
+    const issue = payload.data?.issue;
+    if (!issue) {
+        throw new Error(`Linear ticket not found: ${ref.identifier}`);
+    }
+    return {
+        identifier: (issue.identifier || ref.identifier).toUpperCase(),
+        title: issue.title?.trim() || `Linear ticket ${ref.identifier.toUpperCase()}`,
+        description: issue.description?.trim() || "",
+        sourceUrl: issue.url?.trim() || `https://linear.app/issue/${ref.identifier.toUpperCase()}`
+    };
+}
+function buildSeedText(ticket) {
+    const bodySnippet = ticket.description.trim().slice(0, 400).replace(/\s+/g, " ");
+    return `Resolve Linear ticket: ${ticket.identifier} ${ticket.title}. Context: ${bodySnippet}. Source: ${ticket.sourceUrl}`;
+}
+async function runImportLinear(ticketInput) {
+    const ref = parseLinearTicket(ticketInput);
+    if (!ref) {
+        (0, errors_1.printError)("SDD-1121", "Invalid Linear ticket. Expected LIN-123 or https://linear.app/<team>/issue/LIN-123/<slug>");
+        return;
+    }
+    console.log(`Importing Linear ticket ${ref.identifier} ...`);
+    try {
+        const ticket = await fetchLinearTicket(ref);
+        console.log(`Imported: ${ticket.title}`);
+        await (0, hello_1.runHello)(buildSeedText(ticket), false);
+    }
+    catch (error) {
+        (0, errors_1.printError)("SDD-1122", error.message);
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sdd-cli",
-  "version": "0.1.21",
-  "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",
@@ -42,6 +42,8 @@
     "build": "tsc -p tsconfig.json",
     "start": "node dist/cli.js",
     "dev": "ts-node src/cli.ts",
+    "dev:smoke": "npm run build && npm run smoke:autopilot",
+    "dev:release-check": "npm run check:error-codes && npm run check:docs && npm test && npm run verify:publish",
     "check:docs": "node scripts/check-docs-flags.js",
     "check:error-codes": "node scripts/check-error-codes.js",
     "release:notes": "node scripts/generate-release-notes.js",