@xera-ai/core 0.12.2 → 0.13.0

package/dist/bin/internal.js

@@ -8268,11 +8268,14 @@ function readStoryFrontmatter(repoRoot, ticket) {
 }
 function readGraphInput(repoRoot, ticket) {
   const path = join10(repoRoot, ".xera", ticket, "graph-input.json");
-  if (!existsSync8(path))
+  if (!existsSync8(path)) {
+    console.warn(`[graph-record fetch] graph-input.json missing for ${ticket} \u2014 modifiesAreas=[] (run step 5 of /xera-fetch to populate)`);
     return { modifiesAreas: [] };
+  }
   try {
     return JSON.parse(readFileSync7(path, "utf8"));
-  } catch {
+  } catch (err) {
+    console.warn(`[graph-record fetch] graph-input.json invalid JSON for ${ticket} at ${path} \u2014 modifiesAreas=[] (${err.message})`);
     return { modifiesAreas: [] };
   }
 }
@@ -11035,7 +11038,8 @@ async function fetchCmd(argv, opts = {}) {
   const body = renderStoryBody(t);
   const storyHash = hashString(body);
   const acLines = parseAcLines(t.acceptanceCriteria);
-  const full = renderStory(t.key, t.summary, storyHash, acLines, body);
+  const acSource = acLines.length > 0 ? "jira-field" : "none";
+  const full = renderStory(t.key, t.summary, storyHash, acLines, acSource, body);
   mkdirSync12(dirname5(paths.storyPath), { recursive: true });
   writeFileSync13(paths.storyPath, full);
   const existing = readMeta(paths.metaPath);
@@ -11080,7 +11084,7 @@ function renderStoryBody(t) {
   return lines.join(`
 `);
 }
-function renderStory(key, summary, storyHash, acLines, body) {
+function renderStory(key, summary, storyHash, acLines, acSource, body) {
   const yamlLines = [
     "---",
     `ticketId: ${key}`,
@@ -11092,6 +11096,7 @@ function renderStory(key, summary, storyHash, acLines, body) {
     for (const ac of acLines)
       yamlLines.push(`  - ${JSON.stringify(ac)}`);
   }
+  yamlLines.push(`acceptanceCriteriaSource: ${acSource}`);
   yamlLines.push("---", "");
   return yamlLines.join(`
 `) + body;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xera-ai/core",
-  "version": "0.12.2",
+  "version": "0.13.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,8 +31,8 @@
   },
   "dependencies": {
     "zod": "4.4.3",
-    "@xera-ai/web": "^0.12.2",
-    "@xera-ai/http": "^0.12.2",
+    "@xera-ai/web": "^0.13.0",
+    "@xera-ai/http": "^0.13.0",
     "@playwright/test": "1.60.0",
     "dotenv": "^16.0.0",
     "fflate": "0.8.3",

package/src/bin-internal/fetch.ts

@@ -47,7 +47,11 @@ export async function fetchCmd(argv: string[], opts: FetchCmdOpts = {}): Promise
   const body = renderStoryBody(t);
   const storyHash = hashString(body);
   const acLines = parseAcLines(t.acceptanceCriteria);
-  const full = renderStory(t.key, t.summary, storyHash, acLines, body);
+  // Track where AC came from so /xera-fetch step 3.5 (cognitive body-extraction)
+  // and `xera doctor --strict <TICKET>` can act on accurate provenance.
+  // `body-extraction` is set later by the skill if it finds AC in the description.
+  const acSource: 'jira-field' | 'none' = acLines.length > 0 ? 'jira-field' : 'none';
+  const full = renderStory(t.key, t.summary, storyHash, acLines, acSource, body);
   mkdirSync(dirname(paths.storyPath), { recursive: true });
   writeFileSync(paths.storyPath, full);
 
@@ -112,6 +116,7 @@ function renderStory(
   summary: string,
   storyHash: string,
   acLines: string[],
+  acSource: 'jira-field' | 'none',
   body: string,
 ): string {
   const yamlLines = [
@@ -124,6 +129,7 @@ function renderStory(
     yamlLines.push('acceptanceCriteria:');
     for (const ac of acLines) yamlLines.push(`  - ${JSON.stringify(ac)}`);
   }
+  yamlLines.push(`acceptanceCriteriaSource: ${acSource}`);
   yamlLines.push('---', '');
   return yamlLines.join('\n') + body;
 }

package/src/bin-internal/graph-record.ts

@@ -50,6 +50,11 @@ interface StoryFrontmatter {
   summary: string;
   storyHash: string;
   acceptanceCriteria?: string[];
+  // Where AC came from. Set by `xera-internal fetch` ('jira-field' | 'none') and
+  // upgraded by /xera-fetch step 4 to 'body-extraction' when the skill extracts
+  // AC out of the description body. Optional for backward compat with
+  // pre-existing story.md files.
+  acceptanceCriteriaSource?: 'jira-field' | 'body-extraction' | 'none';
   linked_issues?: Array<{
     ticketId: string;
     relation: 'blocks' | 'duplicates' | 'relates' | 'supersedes';
@@ -125,10 +130,18 @@ function readStoryFrontmatter(repoRoot: string, ticket: string): StoryFrontmatte
 
 function readGraphInput(repoRoot: string, ticket: string): { modifiesAreas: string[] } {
   const path = join(repoRoot, '.xera', ticket, 'graph-input.json');
-  if (!existsSync(path)) return { modifiesAreas: [] };
+  if (!existsSync(path)) {
+    console.warn(
+      `[graph-record fetch] graph-input.json missing for ${ticket} — modifiesAreas=[] (run step 5 of /xera-fetch to populate)`,
+    );
+    return { modifiesAreas: [] };
+  }
   try {
     return JSON.parse(readFileSync(path, 'utf8'));
-  } catch {
+  } catch (err) {
+    console.warn(
+      `[graph-record fetch] graph-input.json invalid JSON for ${ticket} at ${path} — modifiesAreas=[] (${(err as Error).message})`,
+    );
     return { modifiesAreas: [] };
   }
 }