ralph-hero-knowledge-index 0.1.7 → 0.1.8

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-knowledge",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Knowledge graph for ralph-hero: semantic search, relationship traversal, and document indexing across thoughts/ documents. Optional companion to ralph-hero.",
   "author": {
     "name": "Chad Dubiel",

package/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "ralph-knowledge": {
       "command": "npx",
-      "args": ["-y", "ralph-hero-knowledge-index@0.1.7"]
+      "args": ["-y", "ralph-hero-knowledge-index@0.1.8"]
     }
   }
 }

package/dist/parser.js

@@ -32,7 +32,13 @@ export function parseDocument(id, path, raw) {
         date: frontmatter.date ? String(frontmatter.date) : null,
         type: frontmatter.type ?? null,
         status: frontmatter.status ?? null,
-        githubIssue: typeof frontmatter.github_issue === "number" ? frontmatter.github_issue : null,
+        githubIssue: typeof frontmatter.github_issue === "number"
+            ? frontmatter.github_issue
+            : Array.isArray(frontmatter.github_issues) && typeof frontmatter.github_issues[0] === "number"
+                ? frontmatter.github_issues[0]
+                : typeof frontmatter.primary_issue === "number"
+                    ? frontmatter.primary_issue
+                    : null,
         tags, relationships, content: body,
     };
 }

package/dist/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAqB1C,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAC/C,MAAM,QAAQ,GAAG,WAAW,CAAC;AAC7B,MAAM,eAAe,GAAG,2CAA2C,CAAC;AACpE,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAEzC,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,IAAY,EAAE,GAAW;IACjE,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAErD,MAAM,aAAa,GAAmB,EAAE,CAAC;IACzC,IAAI,KAA6B,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3C,aAAa,CAAC,IAAI,CAAC;YACjB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;YAClB,IAAI,EAAE,KAAK,CAAC,CAAC,CAA6B;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC;IAC/C,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACrD,IAAI,OAAO,EAAE,CAAC;YACZ,aAAa,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAa,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3F,OAAO;QACL,EAAE,EAAE,IAAI,EAAE,KAAK;QACf,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QACxD,IAAI,EAAE,WAAW,CAAC,IAAI,IAAI,IAAI;QAC9B,MAAM,EAAE,WAAW,CAAC,MAAM,IAAI,IAAI;QAClC,WAAW,EAAE,OAAO,WAAW,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI;QAC3F,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI;KACnC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-hero-knowledge-index",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/__tests__/parser.test.ts

@@ -97,4 +97,87 @@ describe("parseDocument", () => {
     expect(doc.content).toContain("current cache has no TTL");
     expect(doc.content).not.toContain("---");
   });
+
+  describe("githubIssue fallback chain", () => {
+    function makeDoc(frontmatter: string, body = "# Test\n\nContent."): string {
+      return `---\n${frontmatter}\n---\n\n${body}`;
+    }
+
+    it("falls back to github_issues[0] when github_issue is absent", () => {
+      const raw = makeDoc("github_issues: [42, 43, 44]");
+      const doc = parseDocument("test", "test.md", raw);
+      expect(doc.githubIssue).toBe(42);
+    });
+
+    it("falls back to primary_issue when both github_issue and github_issues are absent", () => {
+      const raw = makeDoc("primary_issue: 42");
+      const doc = parseDocument("test", "test.md", raw);
+      expect(doc.githubIssue).toBe(42);
+    });
+
+    it("prefers github_issue over github_issues and primary_issue", () => {
+      const raw = makeDoc("github_issue: 10\ngithub_issues: [20, 30]\nprimary_issue: 40");
+      const doc = parseDocument("test", "test.md", raw);
+      expect(doc.githubIssue).toBe(10);
+    });
+
+    it("prefers github_issues[0] over primary_issue when github_issue is absent", () => {
+      const raw = makeDoc("github_issues: [20, 30]\nprimary_issue: 40");
+      const doc = parseDocument("test", "test.md", raw);
+      expect(doc.githubIssue).toBe(20);
+    });
+
+    it("returns null for empty github_issues array with no other fallbacks", () => {
+      const raw = makeDoc("github_issues: []");
+      const doc = parseDocument("test", "test.md", raw);
+      expect(doc.githubIssue).toBeNull();
+    });
+
+    it("returns null when primary_issue is null", () => {
+      const raw = makeDoc("primary_issue: null");
+      const doc = parseDocument("test", "test.md", raw);
+      expect(doc.githubIssue).toBeNull();
+    });
+
+    it("returns null when no issue fields are present", () => {
+      const raw = makeDoc("status: draft\ntype: plan");
+      const doc = parseDocument("test", "test.md", raw);
+      expect(doc.githubIssue).toBeNull();
+    });
+
+    it("returns null when github_issues contains non-number first element", () => {
+      const raw = makeDoc('github_issues: ["not-a-number"]');
+      const doc = parseDocument("test", "test.md", raw);
+      expect(doc.githubIssue).toBeNull();
+    });
+
+    it("handles typical group plan frontmatter with all fields", () => {
+      const raw = makeDoc([
+        "date: 2026-03-09",
+        "status: draft",
+        "type: plan",
+        "github_issue: 550",
+        "github_issues: [550, 551, 552]",
+        "primary_issue: 550",
+        "tags: [knowledge-graph, metadata]",
+      ].join("\n"));
+      const doc = parseDocument("test-plan", "thoughts/shared/plans/test-plan.md", raw);
+      expect(doc.githubIssue).toBe(550);
+      expect(doc.type).toBe("plan");
+      expect(doc.tags).toEqual(["knowledge-graph", "metadata"]);
+    });
+
+    it("handles plan with only github_issues array (no singular)", () => {
+      const raw = makeDoc([
+        "date: 2026-03-09",
+        "status: draft",
+        "type: plan",
+        "github_issues: [550, 551, 552]",
+        "primary_issue: 550",
+        "tags: [knowledge-graph]",
+      ].join("\n"));
+      const doc = parseDocument("test-plan", "thoughts/shared/plans/test-plan.md", raw);
+      expect(doc.githubIssue).toBe(550);
+    });
+  });
 });

package/src/parser.ts

@@ -57,7 +57,13 @@ export function parseDocument(id: string, path: string, raw: string): ParsedDocu
     date: frontmatter.date ? String(frontmatter.date) : null,
     type: frontmatter.type ?? null,
     status: frontmatter.status ?? null,
-    githubIssue: typeof frontmatter.github_issue === "number" ? frontmatter.github_issue : null,
+    githubIssue: typeof frontmatter.github_issue === "number"
+      ? frontmatter.github_issue
+      : Array.isArray(frontmatter.github_issues) && typeof frontmatter.github_issues[0] === "number"
+        ? frontmatter.github_issues[0]
+        : typeof frontmatter.primary_issue === "number"
+          ? frontmatter.primary_issue
+          : null,
     tags, relationships, content: body,
   };
 }