npm - @walker-di/fortalece-ai-sdk - Versions diffs - 0.3.7 → 0.3.9 - Mend

@walker-di/fortalece-ai-sdk 0.3.7 → 0.3.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/dist/ci/__tests__/cli.test.d.ts +2 -0
package/dist/ci/__tests__/cli.test.d.ts.map +1 -0
package/dist/ci/__tests__/cli.test.js +23 -0
package/dist/ci/__tests__/notify.test.d.ts +2 -0
package/dist/ci/__tests__/notify.test.d.ts.map +1 -0
package/dist/ci/__tests__/notify.test.js +130 -0
package/dist/ci/cli.d.ts +20 -0
package/dist/ci/cli.d.ts.map +1 -1
package/dist/ci/cli.js +57 -6
package/dist/ci/notify.d.ts +3 -1
package/dist/ci/notify.d.ts.map +1 -1
package/dist/ci/notify.js +173 -19
package/dist/ci/types.d.ts +27 -0
package/dist/ci/types.d.ts.map +1 -1
package/package.json +1 -1

package/dist/ci/__tests__/cli.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=cli.test.d.ts.map

package/dist/ci/__tests__/cli.test.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"cli.test.d.ts","sourceRoot":"","sources":["../../../src/ci/__tests__/cli.test.ts"],"names":[],"mappings":""}

package/dist/ci/__tests__/cli.test.js ADDED Viewed

@@ -0,0 +1,23 @@
+import { describe, expect, it } from 'vitest';
+import { parseArgs } from '../cli.js';
+describe('notify-ci CLI argument parsing', () => {
+    it('parses manual override flags for local runs', () => {
+        const parsed = parseArgs([
+            '--status',
+            'success',
+            '--repository',
+            'acme/repo',
+            '--branch',
+            'fortalece/wi_123',
+            '--commit-sha',
+            'abc123',
+            '--delivery-id',
+            'delivery-1',
+        ]);
+        expect(parsed.status).toBe('success');
+        expect(parsed.repository).toBe('acme/repo');
+        expect(parsed.branch).toBe('fortalece/wi_123');
+        expect(parsed.commitSha).toBe('abc123');
+        expect(parsed.deliveryId).toBe('delivery-1');
+    });
+});

package/dist/ci/__tests__/notify.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=notify.test.d.ts.map

package/dist/ci/__tests__/notify.test.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"notify.test.d.ts","sourceRoot":"","sources":["../../../src/ci/__tests__/notify.test.ts"],"names":[],"mappings":""}

package/dist/ci/__tests__/notify.test.js ADDED Viewed

@@ -0,0 +1,130 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { execSync } from 'node:child_process';
+import { notifyCi } from '../notify.js';
+vi.mock('node:child_process', () => ({
+    execSync: vi.fn(),
+}));
+const execSyncMock = vi.mocked(execSync);
+const ORIGINAL_ENV = { ...process.env };
+function createSuccessResponse() {
+    return new Response('{}', {
+        status: 200,
+        headers: {
+            'content-type': 'application/json',
+        },
+    });
+}
+function clearGitHubEnv() {
+    delete process.env.GITHUB_EVENT_PATH;
+    delete process.env.GITHUB_REPOSITORY;
+    delete process.env.GITHUB_SHA;
+    delete process.env.GITHUB_HEAD_REF;
+    delete process.env.GITHUB_REF;
+    delete process.env.GITHUB_REF_NAME;
+    delete process.env.GITHUB_RUN_ID;
+    delete process.env.GITHUB_RUN_NUMBER;
+    delete process.env.GITHUB_RUN_ATTEMPT;
+    delete process.env.GITHUB_WORKFLOW;
+    delete process.env.GITHUB_ACTOR;
+    delete process.env.GITHUB_EVENT_NAME;
+    delete process.env.GITHUB_SERVER_URL;
+}
+describe('notifyCi local/manual fallback behavior', () => {
+    beforeEach(() => {
+        process.env = { ...ORIGINAL_ENV };
+        clearGitHubEnv();
+        execSyncMock.mockReset();
+    });
+    afterEach(() => {
+        process.env = { ...ORIGINAL_ENV };
+        vi.unstubAllGlobals();
+    });
+    it('uses local git fallback when GitHub environment is absent', async () => {
+        execSyncMock.mockImplementation((command) => {
+            if (command === 'git rev-parse --abbrev-ref HEAD') {
+                return 'fortalece/wi_local\n';
+            }
+            if (command === 'git rev-parse HEAD') {
+                return 'abc123local\n';
+            }
+            if (command === 'git config --get remote.origin.url') {
+                return 'git@github.com:acme/fallback-repo.git\n';
+            }
+            throw new Error(`Unexpected command: ${command}`);
+        });
+        const fetchMock = vi.fn().mockResolvedValue(createSuccessResponse());
+        vi.stubGlobal('fetch', fetchMock);
+        const result = await notifyCi({
+            webhookUrl: 'https://example.com/webhook',
+            webhookSecret: 'secret',
+            status: 'success',
+        });
+        expect(result.success).toBe(true);
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const fetchInit = fetchMock.mock.calls[0]?.[1];
+        const payload = JSON.parse(String(fetchInit.body));
+        expect(payload.repository).toBe('acme/fallback-repo');
+        expect(payload.branch).toBe('fortalece/wi_local');
+        expect(payload.commit_sha).toBe('abc123local');
+        expect(payload.work_item_id).toBe('wi_local');
+    });
+    it('prefers manual overrides over GitHub env and local git fallback', async () => {
+        process.env.GITHUB_REPOSITORY = 'env/repo';
+        process.env.GITHUB_SHA = 'env-sha';
+        process.env.GITHUB_REF_NAME = 'env-branch';
+        execSyncMock.mockImplementation((command) => {
+            if (command === 'git rev-parse --abbrev-ref HEAD') {
+                return 'fortalece/wi_from_git\n';
+            }
+            if (command === 'git rev-parse HEAD') {
+                return 'git-sha';
+            }
+            if (command === 'git config --get remote.origin.url') {
+                return 'git@github.com:git/fallback.git\n';
+            }
+            throw new Error(`Unexpected command: ${command}`);
+        });
+        const fetchMock = vi.fn().mockResolvedValue(createSuccessResponse());
+        vi.stubGlobal('fetch', fetchMock);
+        await notifyCi({
+            webhookUrl: 'https://example.com/webhook',
+            webhookSecret: 'secret',
+            status: 'success',
+            repository: 'override/repo',
+            branch: 'fortalece/wi_override',
+            commitSha: 'override-sha',
+            prTitle: 'Fixes #wi_from_title',
+        });
+        const fetchInit = fetchMock.mock.calls[0]?.[1];
+        const payload = JSON.parse(String(fetchInit.body));
+        expect(payload.repository).toBe('override/repo');
+        expect(payload.branch).toBe('fortalece/wi_override');
+        expect(payload.commit_sha).toBe('override-sha');
+        expect(payload.work_item_id).toBe('wi_override');
+    });
+    it('keeps inference behavior from PR title when branch has no token', async () => {
+        execSyncMock.mockImplementation((command) => {
+            if (command === 'git rev-parse --abbrev-ref HEAD') {
+                return 'feature/no-token\n';
+            }
+            if (command === 'git rev-parse HEAD') {
+                return 'abc123title\n';
+            }
+            if (command === 'git config --get remote.origin.url') {
+                return 'https://github.com/acme/title-fallback.git\n';
+            }
+            throw new Error(`Unexpected command: ${command}`);
+        });
+        const fetchMock = vi.fn().mockResolvedValue(createSuccessResponse());
+        vi.stubGlobal('fetch', fetchMock);
+        await notifyCi({
+            webhookUrl: 'https://example.com/webhook',
+            webhookSecret: 'secret',
+            status: 'building',
+            prTitle: 'Do thing #wi_from_title',
+        });
+        const fetchInit = fetchMock.mock.calls[0]?.[1];
+        const payload = JSON.parse(String(fetchInit.body));
+        expect(payload.work_item_id).toBe('wi_from_title');
+    });
+});

package/dist/ci/cli.d.ts CHANGED Viewed

@@ -8,5 +8,25 @@
  *   npx @walker-di/fortalece-ai-sdk notify-ci --status success --preview-url https://preview.example.com
  *   npx @walker-di/fortalece-ai-sdk notify-ci --status failed --error-message "Build failed"
  */
+import type { CiStatus } from './types.js';
+interface CliArgs {
+    status?: CiStatus;
+    webhookUrl?: string;
+    webhookSecret?: string;
+    previewUrl?: string;
+    logsUrl?: string;
+    errorMessage?: string;
+    workItemId?: string;
+    serviceName?: string;
+    prUrl?: string;
+    prTitle?: string;
+    prNumber?: string;
+    branch?: string;
+    repository?: string;
+    commitSha?: string;
+    deliveryId?: string;
+    help?: boolean;
+}
+export declare function parseArgs(args: string[]): CliArgs;
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/ci/cli.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/ci/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}
1	+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/ci/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,UAAU,OAAO;IACf,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAmFjD"}

package/dist/ci/cli.js CHANGED Viewed

@@ -9,7 +9,8 @@
  *   npx @walker-di/fortalece-ai-sdk notify-ci --status failed --error-message "Build failed"
  */
 import { notifyCi } from './notify.js';
-function parseArgs(args) {
+import { pathToFileURL } from 'node:url';
+export function parseArgs(args) {
     const result = {};
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
@@ -54,6 +55,34 @@ function parseArgs(args) {
                 result.serviceName = nextArg;
                 i++;
                 break;
+            case '--pr-url':
+                result.prUrl = nextArg;
+                i++;
+                break;
+            case '--pr-title':
+                result.prTitle = nextArg;
+                i++;
+                break;
+            case '--pr-number':
+                result.prNumber = nextArg;
+                i++;
+                break;
+            case '--branch':
+                result.branch = nextArg;
+                i++;
+                break;
+            case '--repository':
+                result.repository = nextArg;
+                i++;
+                break;
+            case '--commit-sha':
+                result.commitSha = nextArg;
+                i++;
+                break;
+            case '--delivery-id':
+                result.deliveryId = nextArg;
+                i++;
+                break;
             case '--help':
             case '-h':
                 result.help = true;
@@ -78,6 +107,13 @@ Options:
   -e, --error-message <msg>    Error message for failures (optional)
   -w, --work-item-id <id>      Link to a specific work item (optional)
       --service-name <name>    Service name (optional)
+      --pr-url <url>           Pull request URL (optional)
+      --pr-title <title>       Pull request title (optional)
+      --pr-number <number>     Pull request number (optional)
+      --branch <name>          Branch override for manual/local runs (optional)
+      --repository <owner/repo> Repository override for manual/local runs (optional)
+      --commit-sha <sha>       Commit SHA override for manual/local runs (optional)
+      --delivery-id <id>       Delivery ID override for idempotency (optional)
   -h, --help                   Show this help message
 Environment Variables:
@@ -94,6 +130,12 @@ Examples:
   # Notify build failure with error message
   npx @walker-di/fortalece-ai-sdk notify-ci --status failed --error-message "Tests failed"
+  # Notify with PR metadata
+  npx @walker-di/fortalece-ai-sdk notify-ci --status success --pr-url "https://github.com/org/repo/pull/42" --pr-title "Fix bug #wi_123"
+  # Manual/local run overrides
+  npx @walker-di/fortalece-ai-sdk notify-ci --status success --repository org/repo --branch "fortalece/wi_123" --commit-sha "$(git rev-parse HEAD)"
   # Using environment variables (recommended for secrets)
   FORTALECE_WEBHOOK_URL="\${{ secrets.FORTALECE_WEBHOOK_URL }}" \\
   FORTALECE_WEBHOOK_SECRET="\${{ secrets.FORTALECE_WEBHOOK_SECRET }}" \\
@@ -140,6 +182,13 @@ async function main() {
         errorMessage: parsed.errorMessage,
         workItemId: parsed.workItemId,
         serviceName: parsed.serviceName,
+        prUrl: parsed.prUrl,
+        prTitle: parsed.prTitle,
+        prNumber: parsed.prNumber,
+        branch: parsed.branch,
+        repository: parsed.repository,
+        commitSha: parsed.commitSha,
+        deliveryId: parsed.deliveryId,
     });
     if (result.success) {
         console.log('✅ CI notification sent successfully');
@@ -150,8 +199,10 @@ async function main() {
         process.exit(1);
     }
 }
-// Run CLI
-main().catch((error) => {
-    console.error('Fatal error:', error);
-    process.exit(1);
-});
+const invokedPath = process.argv[1];
+if (invokedPath && pathToFileURL(invokedPath).href === import.meta.url) {
+    main().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}

package/dist/ci/notify.d.ts CHANGED Viewed

@@ -10,7 +10,9 @@ import type { CiEventPayload, CiNotifyConfig, CiNotifyResponse, NotifyOptions }
  * @param payload - Event payload
  * @returns Response from the webhook
  */
-export declare function notifyCiEvent(config: CiNotifyConfig, payload: CiEventPayload): Promise<CiNotifyResponse>;
+export declare function notifyCiEvent(config: CiNotifyConfig, payload: CiEventPayload, options?: {
+    deliveryId?: string;
+}): Promise<CiNotifyResponse>;
 /**
  * Notify Fortalece about a CI event using GitHub Actions environment
  * Automatically reads environment variables for context

package/dist/ci/notify.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/ci/notify.ts"],"names":[],"mappings":"AAAA;;;GAGG;~~AAGH~~,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EACd,gBAAgB,EAEhB,aAAa,EACd,MAAM,YAAY,CAAC;~~AAqCpB~~;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,cAAc,~~GACtB~~,OAAO,CAAC,gBAAgB,CAAC,~~CAwC3B~~;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,~~CAkChF~~;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAExF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}
1	+ {"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/ci/notify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EACd,gBAAgB,EAEhB,aAAa,EACd,MAAM,YAAY,CAAC;AA2KpB;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC,gBAAgB,CAAC,CA0C3B;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2EhF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAExF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}

package/dist/ci/notify.js CHANGED Viewed

@@ -2,23 +2,146 @@
  * Fortalece AI CI - Notify Functions
  * Send CI events to Fortalece webhooks from GitHub Actions
  */
+import fs from 'node:fs';
+import { execSync } from 'node:child_process';
 import { signWebhookBody } from './hmac.js';
+function normalizeValue(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function readGitHubEventPayload() {
+    const eventPath = process.env.GITHUB_EVENT_PATH;
+    if (!eventPath) {
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(eventPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function runGitCommand(args) {
+    try {
+        const output = execSync(`git ${args}`, {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return normalizeValue(output);
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseRepositorySlug(remoteUrl) {
+    const normalizedRemote = normalizeValue(remoteUrl);
+    if (!normalizedRemote) {
+        return undefined;
+    }
+    const sshMatch = normalizedRemote.match(/^[^@]+@[^:]+:([^/]+\/[^/]+?)(?:\.git)?$/);
+    if (sshMatch?.[1]) {
+        return sshMatch[1];
+    }
+    try {
+        const parsed = new URL(normalizedRemote);
+        const pathSegments = parsed.pathname.replace(/\.git$/, '').split('/').filter(Boolean);
+        if (pathSegments.length < 2) {
+            return undefined;
+        }
+        const owner = pathSegments[pathSegments.length - 2];
+        const repository = pathSegments[pathSegments.length - 1];
+        return `${owner}/${repository}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractBranchFromRef(ref) {
+    if (!ref)
+        return undefined;
+    if (ref.startsWith('refs/heads/')) {
+        return ref.slice('refs/heads/'.length);
+    }
+    return undefined;
+}
+function extractWorkItemIdFromBranch(branch) {
+    if (!branch)
+        return undefined;
+    const match = branch.match(/(?:^|\/)fortalece\/([a-zA-Z0-9_-]+)(?:$|\/)/i);
+    return match?.[1];
+}
+function extractWorkItemIdFromPrTitle(title) {
+    if (!title)
+        return undefined;
+    const match = title.match(/#([a-zA-Z0-9_-]+)/);
+    return match?.[1];
+}
+function resolveDeliveryId(payload, fallbackStatus) {
+    const statusEvent = payload.event || statusToEventType(fallbackStatus);
+    const runId = payload.github_run_id || payload.build_id || 'manual';
+    const runAttempt = payload.github_run_attempt || 1;
+    const serviceKey = payload.service_name || payload.repository || 'default';
+    return `${runId}:${runAttempt}:${statusEvent}:${serviceKey}`;
+}
 /**
  * Get GitHub Actions environment variables
  */
 function getGitHubEnv() {
+    const eventPayload = readGitHubEventPayload();
+    const pullRequest = eventPayload?.pull_request || undefined;
+    const prUrl = typeof pullRequest?.html_url === 'string' ? pullRequest.html_url : undefined;
+    const prTitle = typeof pullRequest?.title === 'string' ? pullRequest.title : undefined;
+    const prNumberValue = pullRequest?.number;
+    const prNumber = typeof prNumberValue === 'number' || typeof prNumberValue === 'string'
+        ? String(prNumberValue)
+        : undefined;
+    const prHead = pullRequest?.head || undefined;
+    const prHeadRef = typeof prHead?.ref === 'string' ? prHead.ref : undefined;
+    const githubRef = process.env.GITHUB_REF || '';
+    const githubRefName = process.env.GITHUB_REF_NAME || '';
+    const branch = process.env.GITHUB_HEAD_REF ||
+        prHeadRef ||
+        githubRefName ||
+        extractBranchFromRef(githubRef) ||
+        '';
     return {
-        repository: process.env.GITHUB_REPOSITORY || '',
-        branch: process.env.GITHUB_REF_NAME || process.env.GITHUB_HEAD_REF || '',
-        commit_sha: process.env.GITHUB_SHA || '',
-        github_run_id: process.env.GITHUB_RUN_ID,
-        github_run_number: process.env.GITHUB_RUN_NUMBER,
-        github_workflow: process.env.GITHUB_WORKFLOW,
-        github_actor: process.env.GITHUB_ACTOR,
+        repository: normalizeValue(process.env.GITHUB_REPOSITORY) || '',
+        branch: normalizeValue(branch) || '',
+        commit_sha: normalizeValue(process.env.GITHUB_SHA) || '',
+        pr_url: prUrl,
+        pr_title: prTitle,
+        pr_number: prNumber,
+        github_run_id: normalizeValue(process.env.GITHUB_RUN_ID),
+        github_run_number: normalizeValue(process.env.GITHUB_RUN_NUMBER),
+        github_run_attempt: process.env.GITHUB_RUN_ATTEMPT
+            ? Number(process.env.GITHUB_RUN_ATTEMPT)
+            : undefined,
+        github_workflow: normalizeValue(process.env.GITHUB_WORKFLOW),
+        github_actor: normalizeValue(process.env.GITHUB_ACTOR),
+        github_head_ref: normalizeValue(process.env.GITHUB_HEAD_REF) || normalizeValue(prHeadRef),
+        github_ref: normalizeValue(githubRef),
+        github_ref_name: normalizeValue(githubRefName),
+        github_event_name: normalizeValue(process.env.GITHUB_EVENT_NAME),
         build_url: process.env.GITHUB_SERVER_URL && process.env.GITHUB_REPOSITORY && process.env.GITHUB_RUN_ID
             ? `${process.env.GITHUB_SERVER_URL}/${process.env.GITHUB_REPOSITORY}/actions/runs/${process.env.GITHUB_RUN_ID}`
             : undefined,
-        build_id: process.env.GITHUB_RUN_ID,
+        build_id: normalizeValue(process.env.GITHUB_RUN_ID),
+    };
+}
+function getLocalGitEnv() {
+    const branch = runGitCommand('rev-parse --abbrev-ref HEAD');
+    const commitSha = runGitCommand('rev-parse HEAD');
+    const remoteOrigin = runGitCommand('config --get remote.origin.url');
+    const repository = parseRepositorySlug(remoteOrigin);
+    return {
+        repository,
+        branch,
+        commit_sha: commitSha,
     };
 }
 /**
@@ -43,7 +166,7 @@ function statusToEventType(status) {
  * @param payload - Event payload
  * @returns Response from the webhook
  */
-export async function notifyCiEvent(config, payload) {
+export async function notifyCiEvent(config, payload, options) {
     const { webhookUrl, webhookSecret } = config;
     if (!webhookUrl) {
         return { success: false, error: 'Missing webhook URL' };
@@ -53,6 +176,7 @@ export async function notifyCiEvent(config, payload) {
     }
     const body = JSON.stringify(payload);
     const signature = signWebhookBody(webhookSecret, body);
+    const deliveryId = options?.deliveryId;
     try {
         const response = await fetch(webhookUrl, {
             method: 'POST',
@@ -60,6 +184,7 @@ export async function notifyCiEvent(config, payload) {
                 'Content-Type': 'application/json',
                 'X-Hub-Signature-256': signature,
                 'X-Fortalece-Event': `ci:${payload.event}`,
+                ...(deliveryId ? { 'X-Webhook-ID': deliveryId } : {}),
             },
             body,
         });
@@ -87,27 +212,56 @@ export async function notifyCiEvent(config, payload) {
  * @returns Response from the webhook
  */
 export async function notifyCi(options) {
-    const { webhookUrl, webhookSecret, status, previewUrl, logsUrl, errorMessage, workItemId, serviceName, } = options;
+    const { webhookUrl, webhookSecret, status, previewUrl, logsUrl, errorMessage, workItemId, serviceName, prUrl, prTitle, prNumber, branch, repository, commitSha, commit_sha: commitShaLegacy, deliveryId, } = options;
     const githubEnv = getGitHubEnv();
+    const localGitEnv = getLocalGitEnv();
+    const resolvedRepository = normalizeValue(repository) ||
+        normalizeValue(githubEnv.repository) ||
+        normalizeValue(localGitEnv.repository) ||
+        'unknown/unknown';
+    const resolvedBranch = normalizeValue(branch) ||
+        normalizeValue(githubEnv.branch) ||
+        normalizeValue(localGitEnv.branch) ||
+        'unknown';
+    const resolvedCommitSha = normalizeValue(commitSha) ||
+        normalizeValue(commitShaLegacy) ||
+        normalizeValue(githubEnv.commit_sha) ||
+        normalizeValue(localGitEnv.commit_sha) ||
+        'unknown';
+    const resolvedPrTitle = normalizeValue(prTitle) || normalizeValue(githubEnv.pr_title);
+    const resolvedWorkItemId = normalizeValue(workItemId) ||
+        extractWorkItemIdFromBranch(resolvedBranch) ||
+        extractWorkItemIdFromPrTitle(resolvedPrTitle);
     const payload = {
         event: statusToEventType(status),
         status,
-        repository: githubEnv.repository || 'unknown/unknown',
-        branch: githubEnv.branch || 'unknown',
-        commit_sha: githubEnv.commit_sha || 'unknown',
-        work_item_id: workItemId,
+        repository: resolvedRepository,
+        branch: resolvedBranch,
+        commit_sha: resolvedCommitSha,
+        work_item_id: resolvedWorkItemId,
+        pr_url: normalizeValue(prUrl) || normalizeValue(githubEnv.pr_url),
+        pr_title: resolvedPrTitle,
+        pr_number: normalizeValue(prNumber) || normalizeValue(githubEnv.pr_number),
         build_id: githubEnv.build_id,
         build_url: githubEnv.build_url,
-        logs_url: logsUrl,
-        preview_url: previewUrl,
-        service_name: serviceName,
-        error_message: errorMessage,
+        logs_url: normalizeValue(logsUrl),
+        preview_url: normalizeValue(previewUrl),
+        service_name: normalizeValue(serviceName),
+        error_message: normalizeValue(errorMessage),
         github_run_id: githubEnv.github_run_id,
         github_run_number: githubEnv.github_run_number,
+        github_run_attempt: githubEnv.github_run_attempt,
         github_workflow: githubEnv.github_workflow,
         github_actor: githubEnv.github_actor,
+        github_head_ref: githubEnv.github_head_ref,
+        github_ref: githubEnv.github_ref,
+        github_ref_name: githubEnv.github_ref_name,
+        github_event_name: githubEnv.github_event_name,
     };
-    return notifyCiEvent({ webhookUrl, webhookSecret }, payload);
+    const resolvedDeliveryId = deliveryId || resolveDeliveryId(payload, status);
+    return notifyCiEvent({ webhookUrl, webhookSecret }, payload, {
+        deliveryId: resolvedDeliveryId,
+    });
 }
 /**
  * Convenience function: Notify build started

package/dist/ci/types.d.ts CHANGED Viewed

@@ -21,6 +21,12 @@ export interface CiEventPayload {
     commit_sha: string;
     /** Optional: Link to a specific work item */
     work_item_id?: string;
+    /** Optional PR URL for direct correlation */
+    pr_url?: string;
+    /** Optional PR title (can contain #<work_item_id>) */
+    pr_title?: string;
+    /** Optional PR number */
+    pr_number?: string;
     /** Build ID */
     build_id?: string;
     /** Build URL (GitHub Actions run) */
@@ -36,8 +42,13 @@ export interface CiEventPayload {
     /** GitHub Actions environment metadata */
     github_run_id?: string;
     github_run_number?: string;
+    github_run_attempt?: number;
     github_workflow?: string;
     github_actor?: string;
+    github_head_ref?: string;
+    github_ref?: string;
+    github_ref_name?: string;
+    github_event_name?: string;
 }
 /**
  * Configuration for CI notifications
@@ -64,6 +75,22 @@ export interface NotifyOptions extends CiNotifyConfig {
     workItemId?: string;
     /** Optional service name */
     serviceName?: string;
+    /** Optional PR URL override */
+    prUrl?: string;
+    /** Optional PR title override */
+    prTitle?: string;
+    /** Optional PR number override */
+    prNumber?: string;
+    /** Optional branch override for manual/local runs */
+    branch?: string;
+    /** Optional repository override for manual/local runs */
+    repository?: string;
+    /** Optional commit SHA override for manual/local runs */
+    commitSha?: string;
+    /** Optional legacy snake_case commit SHA override */
+    commit_sha?: string;
+    /** Optional delivery ID override for idempotency */
+    deliveryId?: string;
 }
 /**
  * Response from Fortalece CI webhook

package/dist/ci/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ci/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,SAAS,CAAC;AACxF,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,mBAAmB;IACnB,MAAM,EAAE,QAAQ,CAAC;IAEjB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IAEnB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;~~CACvB~~;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,mBAAmB;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;~~CACtB~~;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ci/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,SAAS,CAAC;AACxF,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,mBAAmB;IACnB,MAAM,EAAE,QAAQ,CAAC;IAEjB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IAEnB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,mBAAmB;IACnB,MAAM,EAAE,QAAQ,CAAC;IACjB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@walker-di/fortalece-ai-sdk",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "type": "module",
   "description": "Fortalece AI Web Components SDK - Support Chat and Feedback widgets",
   "author": "Fortalece AI",