sdd-cli 0.1.21 → 0.1.22

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,7 @@ 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
 
 ### Requirement lifecycle
 - `sdd-cli req create`
@@ -253,6 +256,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 +279,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,7 @@ 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 paths_1 = require("./paths");
 const flags_1 = require("./context/flags");
 const prompt_1 = require("./ui/prompt");
@@ -398,4 +399,11 @@ 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);
+});
 program.parse(process.argv);

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,6 +1,6 @@
 {
   "name": "sdd-cli",
-  "version": "0.1.21",
+  "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.",
   "keywords": [
     "cli",
@@ -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",