@xera-ai/cli 0.12.2 → 0.13.0

package/dist/index.js

@@ -15,7 +15,104 @@ import pc from "picocolors";
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { loadConfig, readAuthState } from "@xera-ai/core";
-async function runChecks(cwd) {
+import { parse as parseYaml } from "yaml";
+function pushTicketChecks(checks, cwd, ticket, acFieldConfigured) {
+  const ticketDir = join(cwd, ".xera", ticket);
+  if (!existsSync(ticketDir)) {
+    checks.push({
+      name: `${ticket}: .xera/${ticket}/ exists`,
+      ok: false,
+      message: `no artifact dir \u2014 run \`/xera-fetch ${ticket}\` first`
+    });
+    return;
+  }
+  const giPath = join(ticketDir, "graph-input.json");
+  if (!existsSync(giPath)) {
+    checks.push({
+      name: `${ticket}: graph-input.json present`,
+      ok: false,
+      message: `missing \u2014 modifiesAreas will be []; run step 5 of /xera-fetch (extract-areas prompt)`
+    });
+  } else {
+    try {
+      const data = JSON.parse(readFileSync(giPath, "utf8"));
+      if (!Array.isArray(data.modifiesAreas)) {
+        checks.push({
+          name: `${ticket}: graph-input.json present`,
+          ok: false,
+          message: `parsed but modifiesAreas is not an array \u2014 re-run step 5 of /xera-fetch`
+        });
+      } else {
+        checks.push({
+          name: `${ticket}: graph-input.json present`,
+          ok: true,
+          message: `${data.modifiesAreas.length} area(s)`
+        });
+      }
+    } catch (e) {
+      checks.push({
+        name: `${ticket}: graph-input.json present`,
+        ok: false,
+        message: `invalid JSON (${e.message}) \u2014 re-run step 5 of /xera-fetch`
+      });
+    }
+  }
+  const storyPath = join(ticketDir, "story.md");
+  if (!existsSync(storyPath)) {
+    checks.push({
+      name: `${ticket}: story.md acceptanceCriteria`,
+      ok: false,
+      message: `story.md missing \u2014 re-run /xera-fetch ${ticket}`
+    });
+    return;
+  }
+  const raw = readFileSync(storyPath, "utf8");
+  const m = raw.match(/^---\n([\s\S]*?)\n---/);
+  if (!m) {
+    checks.push({
+      name: `${ticket}: story.md acceptanceCriteria`,
+      ok: false,
+      message: `frontmatter missing \u2014 re-run /xera-fetch ${ticket}`
+    });
+    return;
+  }
+  let fm;
+  try {
+    fm = parseYaml(m[1]);
+  } catch (e) {
+    checks.push({
+      name: `${ticket}: story.md acceptanceCriteria`,
+      ok: false,
+      message: `frontmatter unparseable (${e.message})`
+    });
+    return;
+  }
+  const ac = Array.isArray(fm.acceptanceCriteria) ? fm.acceptanceCriteria : [];
+  const source = fm.acceptanceCriteriaSource === "jira-field" || fm.acceptanceCriteriaSource === "body-extraction" || fm.acceptanceCriteriaSource === "none" ? fm.acceptanceCriteriaSource : undefined;
+  if (ac.length > 0) {
+    const suffix = source ? ` from ${source}` : "";
+    checks.push({
+      name: `${ticket}: story.md acceptanceCriteria`,
+      ok: true,
+      message: `${ac.length} AC item(s)${suffix}`
+    });
+    return;
+  }
+  let hint;
+  if (source === "none") {
+    hint = acFieldConfigured ? `jira.fields.acceptanceCriteria is configured but Jira returned no AC for this ticket, and /xera-fetch step 4 found no AC section in the body \u2014 add AC to the Jira ticket` : `AC not in Jira (no custom field configured) and /xera-fetch step 4 found no AC section in the description body \u2014 add AC/DoD to the Jira ticket, or edit story.md frontmatter manually`;
+  } else if (source === "body-extraction") {
+    hint = `acceptanceCriteriaSource: body-extraction but acceptanceCriteria is empty \u2014 re-run /xera-fetch ${ticket}`;
+  } else {
+    hint = acFieldConfigured ? `jira.fields.acceptanceCriteria is configured but Jira returned no AC for this ticket \u2014 check the ticket in Jira` : `no AC in frontmatter; AC-level coverage will be empty. Re-run /xera-fetch ${ticket} so step 4 can extract AC from the body (set jira.fields.acceptanceCriteria in xera.config.ts if your project uses a dedicated Jira field)`;
+  }
+  checks.push({
+    name: `${ticket}: story.md acceptanceCriteria`,
+    ok: false,
+    message: hint
+  });
+}
+async function runChecks(cwd, opts = {}) {
   const checks = [];
   checks.push({
     name: `bun ${process.versions.bun ?? "unknown"}`,
@@ -181,6 +278,10 @@ async function runChecks(cwd) {
         }
       } catch {}
     }
+    if (opts.ticket) {
+      const acFieldConfigured = Boolean(cfg.jira?.fields?.acceptanceCriteria);
+      pushTicketChecks(checks, cwd, opts.ticket, acFieldConfigured);
+    }
   } catch (e) {
     checks.push({
       name: "xera.config.ts found and valid",
@@ -261,7 +362,7 @@ async function doctorCommand(opts) {
     console.log("Token usage estimation requires log lines with tokens_in/tokens_out fields (added by skills).");
     return 0;
   }
-  const checks = await runChecks(cwd);
+  const checks = await runChecks(cwd, opts.strict ? { ticket: opts.strict } : {});
   for (const c of checks) {
     const icon = c.ok ? pc.green("\u2713") : pc.red("\u2717");
     console.log(`${icon} ${c.name}${c.message ? pc.dim(` \u2014 ${c.message}`) : ""}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xera-ai/cli",
-  "version": "0.12.2",
+  "version": "0.13.0",
   "type": "module",
   "bin": {
     "xera": "./bin/xera"
@@ -15,10 +15,11 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@xera-ai/core": "^0.12.2",
-    "@xera-ai/skills": "^0.12.2",
+    "@xera-ai/core": "^0.13.0",
+    "@xera-ai/skills": "^0.13.0",
     "@clack/prompts": "1.4.0",
     "cac": "7.0.0",
-    "picocolors": "1.1.1"
+    "picocolors": "1.1.1",
+    "yaml": "2.9.0"
   }
 }