raptor-aios 0.6.2 → 0.6.3

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.6.3] - 2026-06-06
+
+### Fixed
+
+- **`raptor new --jira=<KEY>` no longer creates an empty, mislabelled spec when the Jira card can't be read.** Previously, when a ticket was given but Jira was not connected (or the token had expired, or the issue was unreachable), `new` warned and then degraded to seeding a spec stamped with the Jira ID but **no card content** — and created the branch too. Now, when a fetch was expected (the default), an unreadable card is a **hard stop**: `new` aborts **before any side effect** (no spec, no directory, no branch) with an actionable message that states the reason and points to `raptor jira connect` (or configuring the Jira MCP server). The intentional offline path is unchanged — pass `--no-jira-fetch` to record the ticket ID only.
+
+### Internal
+
+- `New.fetchJiraContext` now returns a discriminated result (`{ ok, context }` | `{ ok: false, reason }`) so the caller can abort with the specific failure reason instead of silently degrading. Removed the now-unreachable `"id only (fetch unavailable)"` status tag.
+
 ## [0.6.2] - 2026-06-06
 
 ### Changed

package/dist/_core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raptor/core",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "type": "module",
   "main": "dist/index.js"
 }

package/dist/commands/new.js

@@ -113,7 +113,26 @@ export default class New extends BaseCommand {
         const specNeedsSeeding = !existsSync(specPath);
         let jiraContext = null;
         if (specNeedsSeeding && flags.jira && flags["jira-fetch"]) {
-            jiraContext = await this.fetchJiraContext(root, flags.jira);
+            const result = await this.fetchJiraContext(root, flags.jira);
+            if (result.ok) {
+                jiraContext = result.context;
+            }
+            else {
+                this.error([
+                    `${result.reason}`,
+                    ``,
+                    `Aborting: --jira=${flags.jira} was given but its Jira card could not be read,`,
+                    `so there is no card content to seed the spec from. No spec or branch was`,
+                    `created — a spec stamped with a Jira ID but no Jira content would be misleading.`,
+                    ``,
+                    `To fix, do one of:`,
+                    `  • Connect Jira, then retry:`,
+                    `      raptor jira connect`,
+                    `      (or configure the Jira MCP server under 'jira:' in .raptor/raptor.yml)`,
+                    `  • Record the ticket ID only, without fetching the card:`,
+                    `      raptor new ${args.slug} --jira=${flags.jira} --no-jira-fetch`,
+                ].join("\n"), { exit: 1 });
+            }
         }
         const designText = specNeedsSeeding
             ? [
@@ -271,9 +290,7 @@ export default class New extends BaseCommand {
                 ? "seeded spec"
                 : !specNeedsSeeding
                     ? "id recorded — spec already authored, not re-seeded"
-                    : flags["jira-fetch"]
-                        ? "id only (fetch unavailable)"
-                        : "id only";
+                    : "id only";
             this.log(`  Jira:      ${flags.jira} (${tag})`);
         }
         if (designContext.hasDesign) {
@@ -416,28 +433,27 @@ export default class New extends BaseCommand {
     async fetchJiraContext(root, key) {
         const conn = jiraConn(readConfig(root));
         if (!conn) {
-            this.warn(`--jira=${key} given but Jira is not connected — recording the ID only. Run 'raptor jira connect' to seed specs.`);
-            return null;
+            return { ok: false, reason: `Jira is not connected.` };
         }
         if (!jiraReadyNonInteractive(conn)) {
-            this.warn(`Jira tokens missing — run 'raptor jira connect'. Recording ID only.`);
-            return null;
+            return { ok: false, reason: `Jira credentials are missing.` };
         }
         let client;
         try {
             client = await openJiraClient(conn);
         }
         catch {
-            this.warn(`Jira session expired — run 'raptor jira connect'. Recording ID only.`);
-            return null;
+            return { ok: false, reason: `Jira session expired.` };
         }
         try {
             const issue = await client.getJiraIssue(conn.cloudId, key);
-            return mapIssueToSpecContext(issue);
+            return { ok: true, context: mapIssueToSpecContext(issue) };
         }
         catch (err) {
-            this.warn(`Could not fetch ${key} (${err instanceof Error ? err.message : String(err)}) — recording ID only.`);
-            return null;
+            return {
+                ok: false,
+                reason: `Could not fetch ${key} from Jira (${err instanceof Error ? err.message : String(err)}).`,
+            };
         }
         finally {
             await client.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raptor-aios",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Raptor — Spec-Driven Development (SDD) CLI for modern mobile apps. Constitutional gates, audit trail, real verification (a11y/perf/stores/OS matrix), and AI-agent slash commands.",
   "type": "module",
   "bin": {

package/scripts/prepare-npm.mjs

@@ -29,7 +29,7 @@ const CLI = join(ROOT, "packages", "cli");
 const CORE = join(ROOT, "packages", "core");
 const OUT = join(ROOT, "build", "npm");
 
-const VERSION = "0.6.2";
+const VERSION = "0.6.3";
 
 function log(msg) {
   process.stdout.write(`  ${msg}\n`);