sdd-cli 0.1.20 → 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/hello.js

@@ -226,7 +226,14 @@ async function runHello(input, runQuestions) {
     printWhy("I will gather enough context to generate a valid first draft.");
     printBeginnerTip(beginnerMode, "A requirement draft defines scope, acceptance criteria, and constraints.");
     if (shouldRunQuestions) {
-        const packs = (0, prompt_packs_1.loadPromptPacks)();
+        let packs;
+        try {
+            packs = (0, prompt_packs_1.loadPromptPacks)();
+        }
+        catch (error) {
+            (0, errors_1.printError)("SDD-1012", `Unable to load prompt packs: ${error.message}`);
+            return;
+        }
         const packIds = intent_1.FLOW_PROMPT_PACKS[intent.flow] ?? [];
         const answers = {};
         for (const packId of packIds) {

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/dist/commands/list.js

@@ -9,6 +9,7 @@ const path_1 = __importDefault(require("path"));
 const paths_1 = require("../paths");
 const prompt_packs_1 = require("../router/prompt-packs");
 const index_1 = require("../workspace/index");
+const errors_1 = require("../errors");
 function listDirectoryNames(dir, ext) {
     if (!fs_1.default.existsSync(dir)) {
         return [];
@@ -48,7 +49,14 @@ function runList() {
     else {
         templates.forEach((template) => console.log(`- ${template}`));
     }
-    const packs = (0, prompt_packs_1.loadPromptPacks)();
+    let packs;
+    try {
+        packs = (0, prompt_packs_1.loadPromptPacks)();
+    }
+    catch (error) {
+        (0, errors_1.printError)("SDD-1421", `Unable to load prompt packs: ${error.message}`);
+        return;
+    }
     console.log("Prompt packs:");
     if (packs.length === 0) {
         console.log("- none");
@@ -56,9 +64,16 @@ function runList() {
     else {
         packs.forEach((pack) => console.log(`- ${pack.id}`));
     }
-    const workspace = (0, index_1.getWorkspaceInfo)();
-    (0, index_1.ensureWorkspace)(workspace);
-    const projects = (0, index_1.listProjects)(workspace);
+    let projects;
+    try {
+        const workspace = (0, index_1.getWorkspaceInfo)();
+        (0, index_1.ensureWorkspace)(workspace);
+        projects = (0, index_1.listProjects)(workspace);
+    }
+    catch (error) {
+        (0, errors_1.printError)("SDD-1422", error.message);
+        return;
+    }
     console.log("Projects:");
     if (projects.length === 0) {
         console.log("- none");

package/dist/commands/quickstart.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runQuickstart = runQuickstart;
 const flags_1 = require("../context/flags");
 const hello_1 = require("./hello");
+const errors_1 = require("../errors");
 const QUICKSTART_EXAMPLES = {
     saas: "Build a SaaS onboarding workflow for first-time users",
     bugfix: "Fix a high-priority login failure with reproducible steps and tests",
@@ -12,7 +13,10 @@ const QUICKSTART_EXAMPLES = {
 };
 function normalizeExample(example) {
     const value = (example || "saas").trim().toLowerCase();
-    return QUICKSTART_EXAMPLES[value] ? value : "saas";
+    if (!example) {
+        return "saas";
+    }
+    return QUICKSTART_EXAMPLES[value] ? value : null;
 }
 async function runQuickstart(example, listExamples) {
     if (listExamples) {
@@ -23,6 +27,11 @@ async function runQuickstart(example, listExamples) {
         return;
     }
     const selected = normalizeExample(example);
+    if (!selected) {
+        (0, errors_1.printError)("SDD-1011", `Invalid quickstart example: ${example}`);
+        (0, errors_1.printError)("SDD-1011", `Available examples: ${Object.keys(QUICKSTART_EXAMPLES).join(", ")}`);
+        return;
+    }
     const seed = QUICKSTART_EXAMPLES[selected];
     console.log(`Running quickstart example: ${selected}`);
     (0, flags_1.setFlags)({ nonInteractive: true });

package/dist/commands/route.js

@@ -4,10 +4,25 @@ exports.runRoute = runRoute;
 const intent_1 = require("../router/intent");
 const flow_1 = require("../router/flow");
 const prompt_packs_1 = require("../router/prompt-packs");
+const errors_1 = require("../errors");
 function runRoute(input) {
-    const intent = (0, intent_1.classifyIntent)(input);
-    const flow = (0, flow_1.loadFlow)(intent.flow);
-    const packs = (0, prompt_packs_1.loadPromptPacks)();
+    const text = input.trim();
+    if (!text) {
+        (0, errors_1.printError)("SDD-1423", "Route input is required.");
+        return;
+    }
+    let intent;
+    let flow;
+    let packs;
+    try {
+        intent = (0, intent_1.classifyIntent)(text);
+        flow = (0, flow_1.loadFlow)(intent.flow);
+        packs = (0, prompt_packs_1.loadPromptPacks)();
+    }
+    catch (error) {
+        (0, errors_1.printError)("SDD-1424", `Unable to load route context: ${error.message}`);
+        return;
+    }
     const packIds = intent_1.FLOW_PROMPT_PACKS[intent.flow] ?? [];
     console.log(JSON.stringify(intent, null, 2));
     if (flow) {
@@ -15,7 +30,7 @@ function runRoute(input) {
         console.log(flow);
     }
     else {
-        console.log("\nNo flow script found.");
+        (0, errors_1.printError)("SDD-1425", `No flow script found for ${intent.flow}.`);
     }
     if (packIds.length > 0) {
         console.log("\n--- Prompt packs ---\n");

package/dist/commands/scope-list.js

@@ -2,11 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runScopeList = runScopeList;
 const index_1 = require("../workspace/index");
+const errors_1 = require("../errors");
 function runScopeList() {
     const baseRoot = (0, index_1.getWorkspaceBaseRoot)();
     const scopes = (0, index_1.listScopes)(baseRoot);
     if (scopes.length === 0) {
-        console.log("No scopes found.");
+        (0, errors_1.printError)("SDD-1412", "No scopes available in workspace.");
         return;
     }
     console.log(`Workspace base: ${baseRoot}`);

package/dist/commands/status.js

@@ -72,7 +72,7 @@ function runStatus(showNext) {
         return;
     }
     if (!fs_1.default.existsSync(project.root)) {
-        console.log("No projects found.");
+        (0, errors_1.printError)("SDD-1402", `Selected project not found in workspace: ${project.name}`);
         if (showNext) {
             console.log('Next command: sdd-cli quickstart --example saas');
         }

package/dist/paths.js

@@ -6,5 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRepoRoot = getRepoRoot;
 const path_1 = __importDefault(require("path"));
 function getRepoRoot() {
+    const override = process.env.SDD_REPO_ROOT?.trim();
+    if (override) {
+        return path_1.default.resolve(override);
+    }
     return path_1.default.resolve(__dirname, "..");
 }

package/package.json

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