@hubblecommerce/overmind-core 0.1.3 → 0.1.5

package/dist/src/processors/confluence-html-parser.test.js

@@ -0,0 +1,214 @@
+import { describe, it, expect } from 'vitest';
+import { parseConfluenceHtml } from './confluence-html-parser.js';
+describe('parseConfluenceHtml', () => {
+    describe('basic HTML conversion', () => {
+        it('converts h2 to ## heading', () => {
+            expect(parseConfluenceHtml('<h2>My Section</h2>')).toBe('## My Section');
+        });
+        it('converts h1 to # heading', () => {
+            expect(parseConfluenceHtml('<h1>Title</h1>')).toBe('# Title');
+        });
+        it('converts strong to **bold**', () => {
+            expect(parseConfluenceHtml('<p><strong>bold text</strong></p>')).toContain('**bold text**');
+        });
+        it('converts inline code to backtick', () => {
+            expect(parseConfluenceHtml('<p><code>myFunc()</code></p>')).toContain('`myFunc()`');
+        });
+        it('converts anchor tag to markdown link', () => {
+            const result = parseConfluenceHtml('<a href="https://example.com">click here</a>');
+            expect(result).toContain('[click here](https://example.com)');
+        });
+    });
+    describe('whitespace cleanup', () => {
+        it('collapses 3+ consecutive newlines to 2', () => {
+            const html = '<p>First</p>\n\n\n\n<p>Second</p>';
+            const result = parseConfluenceHtml(html);
+            expect(result).not.toMatch(/\n{3,}/);
+        });
+        it('removes trailing spaces from lines', () => {
+            const result = parseConfluenceHtml('<p>Hello world</p>');
+            const lines = result.split('\n');
+            for (const line of lines) {
+                expect(line).toBe(line.trimEnd());
+            }
+        });
+        it('trims leading and trailing whitespace', () => {
+            const result = parseConfluenceHtml('<p>Hello</p>');
+            expect(result).toBe(result.trim());
+        });
+    });
+    describe('Confluence code macro', () => {
+        it('renders code macro as fenced code block', () => {
+            const html = `<ac:structured-macro ac:name="code">
+                <ac:plain-text-body>const x = 1;</ac:plain-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('```');
+            expect(result).toContain('const x = 1;');
+        });
+        it('includes language when parameter is present', () => {
+            const html = `<ac:structured-macro ac:name="code">
+                <ac:parameter ac:name="language">javascript</ac:parameter>
+                <ac:plain-text-body>const x = 1;</ac:plain-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('```javascript');
+        });
+    });
+    describe('Confluence panel macros', () => {
+        it('renders info macro as blockquote with INFO label', () => {
+            const html = `<ac:structured-macro ac:name="info">
+                <ac:rich-text-body><p>Important info</p></ac:rich-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('> **INFO**');
+        });
+        it('renders warning macro as blockquote with WARNING label', () => {
+            const html = `<ac:structured-macro ac:name="warning">
+                <ac:rich-text-body><p>Be careful</p></ac:rich-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('> **WARNING**');
+        });
+        it('renders tip macro as blockquote with TIP label', () => {
+            const html = `<ac:structured-macro ac:name="tip">
+                <ac:rich-text-body><p>A helpful tip</p></ac:rich-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('> **TIP**');
+        });
+        it('renders note macro as blockquote with NOTE label', () => {
+            const html = `<ac:structured-macro ac:name="note">
+                <ac:rich-text-body><p>Take note</p></ac:rich-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('> **NOTE**');
+        });
+    });
+    describe('Confluence TOC macro', () => {
+        it('renders toc macro as Table of Contents text', () => {
+            // Real Confluence TOC macros include parameters — an empty element is
+            // not matched by the filter in some DOM parsers
+            const html = `<ac:structured-macro ac:name="toc">
+                <ac:parameter ac:name="maxLevel">3</ac:parameter>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('**Table of Contents**');
+        });
+    });
+    describe('Confluence JIRA macro', () => {
+        it('renders jira macro with key as JIRA Issue reference', () => {
+            const html = `<ac:structured-macro ac:name="jira">
+                <ac:parameter ac:name="key">PROJ-123</ac:parameter>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('**JIRA Issue:** PROJ-123');
+        });
+        it('renders empty string when jira macro has no key', () => {
+            const html = `<ac:structured-macro ac:name="jira"></ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).not.toContain('JIRA Issue');
+        });
+    });
+    describe('Confluence status macro', () => {
+        it('renders status macro as **[title]**', () => {
+            const html = `<ac:structured-macro ac:name="status">
+                <ac:parameter ac:name="title">IN PROGRESS</ac:parameter>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('**[IN PROGRESS]**');
+        });
+        it('appends color in parentheses when colour parameter is present', () => {
+            const html = `<ac:structured-macro ac:name="status">
+                <ac:parameter ac:name="title">DONE</ac:parameter>
+                <ac:parameter ac:name="colour">Green</ac:parameter>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('(Green)');
+        });
+    });
+    describe('Confluence anchor macro', () => {
+        it('renders anchor macro as named anchor tag', () => {
+            const html = `<ac:structured-macro ac:name="anchor">
+                <ac:parameter>my-anchor</ac:parameter>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('<a name="my-anchor"></a>');
+        });
+        it('renders empty string when anchor has no parameter text', () => {
+            const html = `<ac:structured-macro ac:name="anchor">
+                <ac:parameter></ac:parameter>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).not.toContain('<a name=');
+        });
+    });
+    describe('Confluence excerpt macro', () => {
+        it('returns rich-text-body content for excerpt macro', () => {
+            const html = `<ac:structured-macro ac:name="excerpt">
+                <ac:rich-text-body><p>Excerpt content</p></ac:rich-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('Excerpt content');
+        });
+    });
+    describe('Confluence expand macro', () => {
+        it('renders expand macro with title and body', () => {
+            const html = `<ac:structured-macro ac:name="expand">
+                <ac:parameter ac:name="title">Click to expand</ac:parameter>
+                <ac:rich-text-body><p>Hidden content</p></ac:rich-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('**Click to expand**');
+            expect(result).toContain('Hidden content');
+        });
+        it('uses "Details" as default title when no title parameter', () => {
+            const html = `<ac:structured-macro ac:name="expand">
+                <ac:rich-text-body><p>Some content</p></ac:rich-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('**Details**');
+        });
+    });
+    describe('Confluence quote macro', () => {
+        it('renders quote macro as blockquote', () => {
+            const html = `<ac:structured-macro ac:name="quote">
+                <ac:rich-text-body><p>A famous quote</p></ac:rich-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('> ');
+            expect(result).toContain('A famous quote');
+        });
+    });
+    describe('Confluence link macro', () => {
+        it('renders ac:link with ri:page as markdown link using content-title', () => {
+            const html = `<ac:link><ri:page ri:content-title="My Page"/><ac:plain-text-link-body>My Page</ac:plain-text-link-body></ac:link>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('[My Page](My Page)');
+        });
+        it('renders ac:link without href as plain text', () => {
+            const html = `<ac:link><ac:plain-text-link-body>Just text</ac:plain-text-link-body></ac:link>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('Just text');
+        });
+    });
+    describe('Confluence unknown macro', () => {
+        it('falls back to text content for unknown macros', () => {
+            const html = `<ac:structured-macro ac:name="unknown-macro">
+                <ac:rich-text-body><p>Fallback text</p></ac:rich-text-body>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('Fallback text');
+        });
+    });
+    describe('Confluence JIRA macro with server', () => {
+        it('includes server name when present', () => {
+            const html = `<ac:structured-macro ac:name="jira">
+                <ac:parameter ac:name="key">PROJ-456</ac:parameter>
+                <ac:parameter ac:name="server">My Jira</ac:parameter>
+            </ac:structured-macro>`;
+            const result = parseConfluenceHtml(html);
+            expect(result).toContain('(My Jira)');
+        });
+    });
+});

package/dist/src/tools/confluence-search.tool.d.ts

@@ -22,7 +22,7 @@ export declare function createConfluenceAgentTool(vectorStore: VectorStoreProvid
         parent_page_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         keywords?: string[] | undefined;
-        content_type?: "template" | "project-info" | "faq" | "guide" | "decision" | undefined;
+        content_type?: "project-info" | "template" | "faq" | "guide" | "decision" | undefined;
         customer?: string | undefined;
         category?: "archived" | "active" | "maintenance" | "legacy" | undefined;
         space_key?: string | undefined;
@@ -36,7 +36,7 @@ export declare function createConfluenceAgentTool(vectorStore: VectorStoreProvid
         parent_page_id?: string | undefined;
     }, {
         keywords?: string[] | undefined;
-        content_type?: "template" | "project-info" | "faq" | "guide" | "decision" | undefined;
+        content_type?: "project-info" | "template" | "faq" | "guide" | "decision" | undefined;
         customer?: string | undefined;
         category?: "archived" | "active" | "maintenance" | "legacy" | undefined;
         space_key?: string | undefined;
@@ -53,7 +53,7 @@ export declare function createConfluenceAgentTool(vectorStore: VectorStoreProvid
     query: string;
     filters?: {
         keywords?: string[] | undefined;
-        content_type?: "template" | "project-info" | "faq" | "guide" | "decision" | undefined;
+        content_type?: "project-info" | "template" | "faq" | "guide" | "decision" | undefined;
         customer?: string | undefined;
         category?: "archived" | "active" | "maintenance" | "legacy" | undefined;
         space_key?: string | undefined;
@@ -70,7 +70,7 @@ export declare function createConfluenceAgentTool(vectorStore: VectorStoreProvid
     query: string;
     filters?: {
         keywords?: string[] | undefined;
-        content_type?: "template" | "project-info" | "faq" | "guide" | "decision" | undefined;
+        content_type?: "project-info" | "template" | "faq" | "guide" | "decision" | undefined;
         customer?: string | undefined;
         category?: "archived" | "active" | "maintenance" | "legacy" | undefined;
         space_key?: string | undefined;
@@ -87,7 +87,7 @@ export declare function createConfluenceAgentTool(vectorStore: VectorStoreProvid
     query: string;
     filters?: {
         keywords?: string[] | undefined;
-        content_type?: "template" | "project-info" | "faq" | "guide" | "decision" | undefined;
+        content_type?: "project-info" | "template" | "faq" | "guide" | "decision" | undefined;
         customer?: string | undefined;
         category?: "archived" | "active" | "maintenance" | "legacy" | undefined;
         space_key?: string | undefined;
@@ -104,7 +104,7 @@ export declare function createConfluenceAgentTool(vectorStore: VectorStoreProvid
     query: string;
     filters?: {
         keywords?: string[] | undefined;
-        content_type?: "template" | "project-info" | "faq" | "guide" | "decision" | undefined;
+        content_type?: "project-info" | "template" | "faq" | "guide" | "decision" | undefined;
         customer?: string | undefined;
         category?: "archived" | "active" | "maintenance" | "legacy" | undefined;
         space_key?: string | undefined;

package/dist/src/tools/get-current-date.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-current-date.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/get-current-date.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAgB,wBAAwB,uJAqBvC"}
+{"version":3,"file":"get-current-date.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/get-current-date.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAgB,wBAAwB,uJAevC"}

package/dist/src/tools/get-current-date.tool.js

@@ -3,11 +3,7 @@ import { z } from 'zod';
 export function createGetCurrentDateTool() {
     const getCurrentDateSchema = z.object({});
     return tool(() => {
-        const currentDate = new Date();
-        const year = currentDate.getFullYear();
-        const month = (currentDate.getMonth() + 1).toString().padStart(2, '0');
-        const day = currentDate.getDate().toString().padStart(2, '0');
-        const formattedDate = `${year}-${month}-${day}`;
+        const formattedDate = new Date().toISOString().slice(0, 10);
         console.log(`\n📅 Returning current date: ${formattedDate}`);
         return formattedDate;
     }, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubblecommerce/overmind-core",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "description": "Shared infrastructure package for the Overmind AI agent system",
   "main": "./dist/src/index.js",
@@ -67,6 +67,9 @@
     "zod": "^3.25.76"
   },
   "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "build": "tsc",
     "prepack": "npm run build",
     "typecheck": "tsc --noEmit",
@@ -84,12 +87,14 @@
     "@types/node": "^24.6.1",
     "@types/pg": "^8.15.5",
     "@types/turndown": "^5.0.5",
+    "@vitest/coverage-v8": "^4.1.2",
     "eslint": "^9.36.0",
     "husky": "^9.0.0",
     "lint-staged": "^15.0.0",
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.45.0"
+    "typescript-eslint": "^8.45.0",
+    "vitest": "^4.1.2"
   },
   "lint-staged": {
     "*.ts": "eslint --fix"