@simplysf/simply-cicd-core 0.2.2 → 0.4.0

package/lib/notify/projectNotification.js

@@ -0,0 +1,167 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { promises as fs } from 'node:fs';
+import { execa } from 'execa';
+import { getDefaultPackageDirectory, isSubscriberPackageVersionId, readSfdxProject } from '@simplysf/simply-core';
+import { createAlmProvider } from '../alm/index.js';
+import { logger } from '../logger.js';
+import { getPackageVersionReport, listInstalledPackages } from '../sfPackages.js';
+import { appendToEnvFile } from '../env.js';
+import { getCommitStories } from './getCommitStories.js';
+import { renderNotifyTemplate } from './renderTemplate.js';
+import { sendNotification } from './sendNotification.js';
+/** Queries the target org's installed package version. The org must already be authenticated. */
+export async function resolvePrevInstalledPackageVersion(params) {
+    const { alias, debug } = params;
+    if (!alias) {
+        logger.warn('No --alias given. Skipping installed package version check.');
+        return 'N/A';
+    }
+    try {
+        const packageName = getDefaultPackageDirectory(await readSfdxProject())?.package;
+        logger.info(`Get installed package version from alias ${alias} for package ${packageName ?? 'unknown'}...`);
+        const installed = await listInstalledPackages(alias);
+        const pkg = installed.find((p) => p.SubscriberPackageName === packageName);
+        return pkg?.SubscriberPackageVersionNumber ? `v${pkg.SubscriberPackageVersionNumber}` : 'N/A';
+    }
+    catch (error) {
+        logger.warn(`Could not query installed package version: ${error.message}`);
+        if (debug) {
+            logger.error(String(error));
+        }
+        return 'N/A';
+    }
+}
+/** Resolves the released package's version from the packaging DevHub. Returns `undefined` on any failure. */
+export async function resolveTargetPackageVersionFromDevHub(params) {
+    const { packagingDevhub, subscriberPackageVersionId, debug } = params;
+    if (!packagingDevhub) {
+        logger.warn('No --packaging-devhub given. Skipping target package version check from DevHub.');
+        return undefined;
+    }
+    if (!subscriberPackageVersionId || !isSubscriberPackageVersionId(subscriberPackageVersionId)) {
+        return undefined;
+    }
+    try {
+        logger.info(`Get latest package version for package version ID ${subscriberPackageVersionId}...`);
+        const versionReport = await getPackageVersionReport(subscriberPackageVersionId, packagingDevhub);
+        return versionReport.Version ? `v${versionReport.Version}` : undefined;
+    }
+    catch (error) {
+        logger.warn(`Could not get target package version from DevHub: ${error.message}`);
+        if (debug) {
+            logger.error(String(error));
+        }
+        return undefined;
+    }
+}
+/** Falls back to the git tag pointing at HEAD when the DevHub can't resolve a target version. */
+export async function resolveTargetPackageVersionFromGitTag(debug) {
+    logger.info('Falling back to git tag for target version...');
+    try {
+        const { stdout } = await execa('git', ['tag', '--points-at', 'HEAD']);
+        if (stdout) {
+            return stdout.trim().split('\n')[0];
+        }
+        logger.warn('No git tag found at HEAD.');
+    }
+    catch (error) {
+        logger.warn(`Could not get git tag: ${error.message}`);
+        if (debug) {
+            logger.error(String(error));
+        }
+    }
+    return 'N/A';
+}
+export async function resolveTargetPackageVersion(params) {
+    const fromDevHub = await resolveTargetPackageVersionFromDevHub(params);
+    return fromDevHub ?? resolveTargetPackageVersionFromGitTag(params.debug);
+}
+/** Resolves and records the previously installed and target package versions for later stages. */
+export async function projectNotifyBeforeScript(options) {
+    logger.info('Initializing before-script for project notification...');
+    if (options.ciJobStage !== 'pre-destructive' || options.ciJobStatus === 'canceled') {
+        logger.info(`No notify before-script logic for job stage: ${options.ciJobStage ?? 'unknown'}, status: ${options.ciJobStatus ?? 'unknown'}`);
+        return;
+    }
+    logger.info('Running before_script for project notification...');
+    await fs.writeFile('project-build.env', `CREATED_BY_JOB_NAME=${options.ciJobName ?? ''}\n`);
+    const prevInstalledPackageVersion = await resolvePrevInstalledPackageVersion({
+        alias: options.alias,
+        debug: options.debug,
+    });
+    const targetPackageVersion = await resolveTargetPackageVersion({
+        packagingDevhub: options.packagingDevhub,
+        subscriberPackageVersionId: options.subscriberPackageVersionId,
+        debug: options.debug,
+    });
+    appendToEnvFile('project-build.env', { PREV_INSTALLED_PACKAGE_VERSION: prevInstalledPackageVersion, TARGET_PACKAGE_VERSION: targetPackageVersion }, logger);
+    logger.success('before_script for project notification finished.');
+    logger.log(`PREV_INSTALLED_PACKAGE_VERSION=${prevInstalledPackageVersion}`);
+    logger.log(`TARGET_PACKAGE_VERSION=${targetPackageVersion}`);
+}
+/** Posts the deployment result card (with Jira stories on success) to Teams. */
+export async function projectNotifyAfterScript(options) {
+    const { ciJobStage, ciJobStatus } = options;
+    const templateData = {
+        environmentName: options.ciEnvironmentName,
+        refName: options.ciCommitRefName,
+        pipelineUrl: options.ciPipelineUrl,
+        pipelineId: options.ciPipelineId,
+        projectTitle: options.ciProjectTitle,
+        storiesLinked: 'N/A',
+        stage: ciJobStage,
+    };
+    let notifyCommitStories = 'N/A';
+    let templateName;
+    if (ciJobStage === 'post-destructive' && ciJobStatus === 'success') {
+        templateName = 'project-success-notification';
+        logger.info('Gathering stories for successful deployment...');
+        const { stories, storiesWithUrl } = await getCommitStories(options.prevInstalledPackageVersion, options.targetPackageVersion, options.almProjectKey, {
+            debug: options.debug,
+            almBaseUrl: options.almBaseUrl,
+            almProvider: createAlmProvider(options.almProvider ?? 'jira'),
+        });
+        notifyCommitStories = stories;
+        templateData.storiesLinked = storiesWithUrl;
+    }
+    else if (ciJobStatus === 'failed') {
+        templateName = 'project-failure-notification';
+    }
+    else {
+        logger.info(`No notification logic for job status: ${ciJobStatus ?? 'unknown'}`);
+        return { sent: false };
+    }
+    const notifyMessage = renderNotifyTemplate(templateName, templateData);
+    const payload = {
+        content: notifyMessage,
+        environmentName: options.ciEnvironmentName,
+        refName: options.ciCommitRefName,
+        pipelineId: options.ciPipelineId,
+        pipelineUrl: options.ciPipelineUrl,
+        projectTitle: options.ciProjectTitle,
+        jobName: options.ciJobName,
+        jobStage: ciJobStage,
+        jobStatus: ciJobStatus,
+        stories: notifyCommitStories,
+        storiesLinked: templateData.storiesLinked,
+        packageVersionPrevious: options.prevInstalledPackageVersion,
+        packageVersion: options.targetPackageVersion,
+    };
+    await sendNotification(options.teamsWebhookUrl, payload);
+    return { sent: true };
+}
+//# sourceMappingURL=projectNotification.js.map

package/lib/notify/projectNotification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectNotification.js","sourceRoot":"","sources":["../../src/notify/projectNotification.ts"],"names":[],"mappings":"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"}

package/lib/notify/renderTemplate.d.ts

@@ -0,0 +1,3 @@
+import { type NotifyTemplateName } from './templates.js';
+/** Renders one of the built-in Teams notification card templates with the given data. */
+export declare function renderNotifyTemplate(templateName: NotifyTemplateName, data: Record<string, unknown>): string;

package/lib/notify/renderTemplate.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import Handlebars from 'handlebars';
+import { NOTIFY_TEMPLATES } from './templates.js';
+const handlebars = Handlebars.create();
+/** Renders one of the built-in Teams notification card templates with the given data. */
+export function renderNotifyTemplate(templateName, data) {
+    const template = handlebars.compile(NOTIFY_TEMPLATES[templateName]);
+    return template(data);
+}
+//# sourceMappingURL=renderTemplate.js.map

package/lib/notify/renderTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderTemplate.js","sourceRoot":"","sources":["../../src/notify/renderTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAA2B,MAAM,gBAAgB,CAAC;AAE3E,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;AAEvC,yFAAyF;AACzF,MAAM,UAAU,oBAAoB,CAAC,YAAgC,EAAE,IAA6B;IAClG,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/lib/notify/sendNotification.d.ts

@@ -0,0 +1,2 @@
+/** Sends a notification payload to one or more Microsoft Teams incoming webhooks. */
+export declare function sendNotification(teamsWebhookUrl: string | string[] | undefined, payload: unknown): Promise<void>;

package/lib/notify/sendNotification.js

@@ -0,0 +1,50 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { logger } from '../logger.js';
+/** Sends a notification payload to one or more Microsoft Teams incoming webhooks. */
+export async function sendNotification(teamsWebhookUrl, payload) {
+    const urls = Array.isArray(teamsWebhookUrl) ? teamsWebhookUrl : [teamsWebhookUrl];
+    const nonEmptyUrls = urls.filter((u) => Boolean(u));
+    if (nonEmptyUrls.length === 0) {
+        logger.warn('No webhook URLs provided. Skipping notification.');
+        return;
+    }
+    const notificationPromises = nonEmptyUrls.map(async (url) => {
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: typeof payload === 'string' ? payload : JSON.stringify(payload ?? {}),
+            });
+            if (!response.ok) {
+                throw new Error(`Response not OK. Status: ${response.status} ${response.statusText}`);
+            }
+            logger.success(`Successfully sent notification to ${url}`);
+            return { url, status: 'success' };
+        }
+        catch (error) {
+            logger.error(`Failed to send notification to ${url}: ${error.message}`);
+            return { url, status: 'failure', error };
+        }
+    });
+    const results = await Promise.all(notificationPromises);
+    const failures = results.filter((r) => r.status === 'failure');
+    if (failures.length > 0) {
+        const failedUrls = failures.map((f) => f.url).join(', ');
+        throw new Error(`Failed to send ${failures.length} notification(s) to: ${failedUrls}`);
+    }
+}
+//# sourceMappingURL=sendNotification.js.map

package/lib/notify/sendNotification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendNotification.js","sourceRoot":"","sources":["../../src/notify/sendNotification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAItC,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,eAA8C,EAC9C,OAAgB;IAEhB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAClF,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IAED,MAAM,oBAAoB,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAA+B,EAAE;QACvF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;aAC5E,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACxF,CAAC;YAED,MAAM,CAAC,OAAO,CAAC,qCAAqC,GAAG,EAAE,CAAC,CAAC;YAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,GAAG,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YACnF,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAE/D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,CAAC,MAAM,wBAAwB,UAAU,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC"}

package/lib/notify/templates.d.ts

@@ -0,0 +1,13 @@
+/** Teams notification card templates, keyed the same as the original `.hbs` file names. */
+export declare const NOTIFY_TEMPLATES: {
+    readonly 'build-failure-notification': "<table>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: darkred;\">{{projectTitle}}: Failed Build</th></tr>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: grey;\">Job: {{jobName}} (Stage:\n      {{stage}})</th></tr>\n  <tr><td>Branch</td><td colspan=\"2\">Pipeline</td></tr>\n  <tr><td>{{refName}}</td><td colspan=\"2\"><a\n        href=\"{{pipelineUrl}}\"\n      >{{pipelineId}}</a></td></tr>\n</table>\n";
+    readonly 'build-package-version-notification': "<table>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: darkgreen;\">{{projectTitle}}: Package Version\n      Created</th></tr>\n  <tr><td>Version</td><td>Branch</td><td>Pipeline</td></tr>\n  <tr><td>{{packageVersion}}<br />{{subscriberPackageVersionId}}</td><td>{{refName}}</td><td><a\n        href=\"{{pipelineUrl}}\"\n      >{{pipelineId}}</a></td></tr>\n  <tr><td colspan=\"3\">Stories since {{packageVersionPrevious}}</td></tr>\n  <tr><td colspan=\"3\">{{{storiesLinked}}}</td></tr>\n</table>\n";
+    readonly 'happy-soup-failure-notification': "<table>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: darkred;\">Failed Stage:\n      {{stage}}</th></tr>\n  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>\n  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a\n        href=\"{{pipelineUrl}}\"\n      >{{pipelineId}}</a></td></tr>\n</table>\n";
+    readonly 'happy-soup-final-failure-notification': "<table>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: darkred;\">Happy Soup Deployment Failed</th></tr>\n  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>\n  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a\n        href=\"{{pipelineUrl}}\"\n      >{{pipelineId}}</a></td></tr>\n</table>\n";
+    readonly 'happy-soup-final-success-notification': "<table>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: darkgreen;\">Happy Soup Deployment\n      Completed</th></tr>\n  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>\n  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a\n        href=\"{{pipelineUrl}}\"\n      >{{pipelineId}}</a></td></tr>\n{{#if upgradedPackages.length}}\n  <tr><td colspan=\"3\">Upgraded Packages</td></tr>\n{{#each upgradedPackages}}\n  <tr><td colspan=\"1\">{{packageName}}</td><td colspan=\"2\">{{{storiesLinked}}}</td></tr>\n{{/each}}\n{{/if}}\n</table>\n";
+    readonly 'happy-soup-starting-stage-notification': "<table>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: #007acc;\">Starting Stage:\n      {{stage}}</th></tr>\n  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>\n  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a\n        href=\"{{pipelineUrl}}\"\n      >{{pipelineId}}</a></td></tr>\n</table>\n";
+    readonly 'happy-soup-success-notification': "<table>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: darkgreen;\">Completed Stage:\n      {{stage}}</th></tr>\n  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>\n  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a\n        href=\"{{pipelineUrl}}\"\n      >{{pipelineId}}</a></td></tr>\n{{#if upgradedPackages.length}}\n  <tr><td colspan=\"3\">Upgraded Packages</td></tr>\n{{#each upgradedPackages}}\n  <tr><td colspan=\"1\">{{packageName}}</td><td colspan=\"2\">{{{storiesLinked}}}</td></tr>\n{{/each}}\n{{/if}}\n</table>\n";
+    readonly 'project-failure-notification': "<table>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: darkred;\">{{projectTitle}}: Failed\n      Deployment</th></tr>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: grey;\">Stage:\n      {{stage}}</th></tr>\n  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>\n  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a\n        href=\"{{pipelineUrl}}\"\n      >{{pipelineId}}</a></td></tr>\n</table>\n";
+    readonly 'project-success-notification': "<table>\n  <tr><th colspan=\"3\" style=\"color: white; background-color: darkgreen;\">{{projectTitle}}: Completed\n      Deployment</th></tr>\n  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>\n  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a\n        href=\"{{pipelineUrl}}\"\n      >{{pipelineId}}</a></td></tr>\n  <tr><td colspan=\"3\">Stories</td></tr>\n  <tr><td colspan=\"3\">{{{storiesLinked}}}</td></tr>\n</table>\n";
+};
+export type NotifyTemplateName = keyof typeof NOTIFY_TEMPLATES;

package/lib/notify/templates.js

@@ -0,0 +1,118 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/** Teams notification card templates, keyed the same as the original `.hbs` file names. */
+export const NOTIFY_TEMPLATES = {
+    'build-failure-notification': `<table>
+  <tr><th colspan="3" style="color: white; background-color: darkred;">{{projectTitle}}: Failed Build</th></tr>
+  <tr><th colspan="3" style="color: white; background-color: grey;">Job: {{jobName}} (Stage:
+      {{stage}})</th></tr>
+  <tr><td>Branch</td><td colspan="2">Pipeline</td></tr>
+  <tr><td>{{refName}}</td><td colspan="2"><a
+        href="{{pipelineUrl}}"
+      >{{pipelineId}}</a></td></tr>
+</table>
+`,
+    'build-package-version-notification': `<table>
+  <tr><th colspan="3" style="color: white; background-color: darkgreen;">{{projectTitle}}: Package Version
+      Created</th></tr>
+  <tr><td>Version</td><td>Branch</td><td>Pipeline</td></tr>
+  <tr><td>{{packageVersion}}<br />{{subscriberPackageVersionId}}</td><td>{{refName}}</td><td><a
+        href="{{pipelineUrl}}"
+      >{{pipelineId}}</a></td></tr>
+  <tr><td colspan="3">Stories since {{packageVersionPrevious}}</td></tr>
+  <tr><td colspan="3">{{{storiesLinked}}}</td></tr>
+</table>
+`,
+    'happy-soup-failure-notification': `<table>
+  <tr><th colspan="3" style="color: white; background-color: darkred;">Failed Stage:
+      {{stage}}</th></tr>
+  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>
+  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a
+        href="{{pipelineUrl}}"
+      >{{pipelineId}}</a></td></tr>
+</table>
+`,
+    'happy-soup-final-failure-notification': `<table>
+  <tr><th colspan="3" style="color: white; background-color: darkred;">Happy Soup Deployment Failed</th></tr>
+  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>
+  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a
+        href="{{pipelineUrl}}"
+      >{{pipelineId}}</a></td></tr>
+</table>
+`,
+    'happy-soup-final-success-notification': `<table>
+  <tr><th colspan="3" style="color: white; background-color: darkgreen;">Happy Soup Deployment
+      Completed</th></tr>
+  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>
+  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a
+        href="{{pipelineUrl}}"
+      >{{pipelineId}}</a></td></tr>
+{{#if upgradedPackages.length}}
+  <tr><td colspan="3">Upgraded Packages</td></tr>
+{{#each upgradedPackages}}
+  <tr><td colspan="1">{{packageName}}</td><td colspan="2">{{{storiesLinked}}}</td></tr>
+{{/each}}
+{{/if}}
+</table>
+`,
+    'happy-soup-starting-stage-notification': `<table>
+  <tr><th colspan="3" style="color: white; background-color: #007acc;">Starting Stage:
+      {{stage}}</th></tr>
+  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>
+  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a
+        href="{{pipelineUrl}}"
+      >{{pipelineId}}</a></td></tr>
+</table>
+`,
+    'happy-soup-success-notification': `<table>
+  <tr><th colspan="3" style="color: white; background-color: darkgreen;">Completed Stage:
+      {{stage}}</th></tr>
+  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>
+  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a
+        href="{{pipelineUrl}}"
+      >{{pipelineId}}</a></td></tr>
+{{#if upgradedPackages.length}}
+  <tr><td colspan="3">Upgraded Packages</td></tr>
+{{#each upgradedPackages}}
+  <tr><td colspan="1">{{packageName}}</td><td colspan="2">{{{storiesLinked}}}</td></tr>
+{{/each}}
+{{/if}}
+</table>
+`,
+    'project-failure-notification': `<table>
+  <tr><th colspan="3" style="color: white; background-color: darkred;">{{projectTitle}}: Failed
+      Deployment</th></tr>
+  <tr><th colspan="3" style="color: white; background-color: grey;">Stage:
+      {{stage}}</th></tr>
+  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>
+  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a
+        href="{{pipelineUrl}}"
+      >{{pipelineId}}</a></td></tr>
+</table>
+`,
+    'project-success-notification': `<table>
+  <tr><th colspan="3" style="color: white; background-color: darkgreen;">{{projectTitle}}: Completed
+      Deployment</th></tr>
+  <tr><td>Environment</td><td>Branch</td><td>Pipeline</td></tr>
+  <tr><td>{{environmentName}}</td><td>{{refName}}</td><td><a
+        href="{{pipelineUrl}}"
+      >{{pipelineId}}</a></td></tr>
+  <tr><td colspan="3">Stories</td></tr>
+  <tr><td colspan="3">{{{storiesLinked}}}</td></tr>
+</table>
+`,
+};
+//# sourceMappingURL=templates.js.map

package/lib/notify/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/notify/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,4BAA4B,EAAE;;;;;;;;;CAS/B;IACC,oCAAoC,EAAE;;;;;;;;;;CAUvC;IACC,iCAAiC,EAAE;;;;;;;;CAQpC;IACC,uCAAuC,EAAE;;;;;;;CAO1C;IACC,uCAAuC,EAAE;;;;;;;;;;;;;;CAc1C;IACC,wCAAwC,EAAE;;;;;;;;CAQ3C;IACC,iCAAiC,EAAE;;;;;;;;;;;;;;CAcpC;IACC,8BAA8B,EAAE;;;;;;;;;;CAUjC;IACC,8BAA8B,EAAE;;;;;;;;;;CAUjC;CACS,CAAC"}

package/lib/schemas/deployConfig.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+declare const deploymentSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
+    unpackagedDeploy: z.ZodOptional<z.ZodBoolean>;
+    postDeploy: z.ZodOptional<z.ZodBoolean>;
+    preDestructive: z.ZodOptional<z.ZodBoolean>;
+    postDestructive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/** Zod equivalent of the original `deploy.schema.json`. */
+export declare const deployConfigSchema: z.ZodObject<{
+    deployments: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+        unpackagedDeploy: z.ZodOptional<z.ZodBoolean>;
+        postDeploy: z.ZodOptional<z.ZodBoolean>;
+        preDestructive: z.ZodOptional<z.ZodBoolean>;
+        postDestructive: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DeploymentConfig = z.infer<typeof deploymentSchema>;
+export type DeployConfig = z.infer<typeof deployConfigSchema>;
+export {};

package/lib/schemas/deployConfig.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { z } from 'zod';
+const LOCAL_NAMES = new Set(['local', 'Local', 'LOCAL']);
+const deploymentSchema = z
+    .object({
+    name: z.string(),
+    slug: z.string().optional(),
+    ref: z.string().optional(),
+    unpackagedDeploy: z.boolean().optional(),
+    postDeploy: z.boolean().optional(),
+    preDestructive: z.boolean().optional(),
+    postDestructive: z.boolean().optional(),
+})
+    .strict()
+    .superRefine((deployment, ctx) => {
+    if (!LOCAL_NAMES.has(deployment.name) && deployment.slug === undefined) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `Deployment "${deployment.name}" must have a "slug" unless its name is one of: ${[...LOCAL_NAMES].join(', ')}.`,
+            path: ['slug'],
+        });
+    }
+    const hasStage = deployment.unpackagedDeploy !== undefined ||
+        deployment.postDeploy !== undefined ||
+        deployment.preDestructive !== undefined ||
+        deployment.postDestructive !== undefined;
+    if (!hasStage) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `Deployment "${deployment.name}" must specify at least one of: unpackagedDeploy, postDeploy, preDestructive, postDestructive.`,
+            path: [],
+        });
+    }
+});
+/** Zod equivalent of the original `deploy.schema.json`. */
+export const deployConfigSchema = z
+    .object({
+    deployments: z.array(deploymentSchema),
+})
+    .strict();
+//# sourceMappingURL=deployConfig.js.map

package/lib/schemas/deployConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployConfig.js","sourceRoot":"","sources":["../../src/schemas/deployConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEzD,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACtC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,MAAM,EAAE;KACR,WAAW,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE;IAC/B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACvE,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,eAAe,UAAU,CAAC,IAAI,mDAAmD,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACxH,IAAI,EAAE,CAAC,MAAM,CAAC;SACf,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GACZ,UAAU,CAAC,gBAAgB,KAAK,SAAS;QACzC,UAAU,CAAC,UAAU,KAAK,SAAS;QACnC,UAAU,CAAC,cAAc,KAAK,SAAS;QACvC,UAAU,CAAC,eAAe,KAAK,SAAS,CAAC;IAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,eAAe,UAAU,CAAC,IAAI,gGAAgG;YACvI,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;CACvC,CAAC;KACD,MAAM,EAAE,CAAC"}

package/lib/schemas/deployProgress.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+/** A single packaged dependency upgraded by `deploy happy-soup install-packaged`. */
+declare const upgradedPackageSchema: z.ZodObject<{
+    packageName: z.ZodString;
+    prevVersionId: z.ZodString;
+    prevVersionNumber: z.ZodOptional<z.ZodString>;
+    prevTag: z.ZodOptional<z.ZodString>;
+    targetVersionId: z.ZodString;
+    targetVersionNumber: z.ZodOptional<z.ZodString>;
+    targetTag: z.ZodOptional<z.ZodString>;
+    targetDescription: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Zod equivalent of the original `deploy_progress.schema.json`. */
+export declare const deployProgressSchema: z.ZodObject<{
+    preDestructive: z.ZodOptional<z.ZodString>;
+    unpackagedDeploy: z.ZodOptional<z.ZodString>;
+    postDeploy: z.ZodOptional<z.ZodString>;
+    postDestructive: z.ZodOptional<z.ZodString>;
+    durations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodNumber>>>;
+    upgradedPackages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        prevVersionId: z.ZodString;
+        prevVersionNumber: z.ZodOptional<z.ZodString>;
+        prevTag: z.ZodOptional<z.ZodString>;
+        targetVersionId: z.ZodString;
+        targetVersionNumber: z.ZodOptional<z.ZodString>;
+        targetTag: z.ZodOptional<z.ZodString>;
+        targetDescription: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strict>;
+export type DeployProgress = z.infer<typeof deployProgressSchema>;
+export type UpgradedPackage = z.infer<typeof upgradedPackageSchema>;
+export {};

package/lib/schemas/deployProgress.js

@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2026, SimplySF.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { z } from 'zod';
+/** A single packaged dependency upgraded by `deploy happy-soup install-packaged`. */
+const upgradedPackageSchema = z.object({
+    packageName: z.string(),
+    prevVersionId: z.string(),
+    prevVersionNumber: z.string().optional(),
+    /** The origin git commit SHA for the previous version, from that version's `report.Tag`. */
+    prevTag: z.string().optional(),
+    targetVersionId: z.string(),
+    targetVersionNumber: z.string().optional(),
+    /** The origin git commit SHA for the target version, from that version's `report.Tag`. */
+    targetTag: z.string().optional(),
+    /**
+     * The target version's `report.Description` (the origin CI pipeline URL). Used at notify time
+     * to resolve which VCS project the package's source lives in; the origin repo is assumed stable
+     * between a package's previous and target version, so only the target's URL is kept.
+     */
+    targetDescription: z.string().optional(),
+});
+/** Zod equivalent of the original `deploy_progress.schema.json`. */
+export const deployProgressSchema = z
+    .object({
+    preDestructive: z.string().optional(),
+    unpackagedDeploy: z.string().optional(),
+    postDeploy: z.string().optional(),
+    postDestructive: z.string().optional(),
+    durations: z.record(z.string(), z.record(z.string(), z.number())).optional(),
+    upgradedPackages: z.array(upgradedPackageSchema).optional(),
+})
+    .strict();
+//# sourceMappingURL=deployProgress.js.map

package/lib/schemas/deployProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployProgress.js","sourceRoot":"","sources":["../../src/schemas/deployProgress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qFAAqF;AACrF,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,4FAA4F;IAC5F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,0FAA0F;IAC1F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5E,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;CAC5D,CAAC;KACD,MAAM,EAAE,CAAC"}

package/lib/schemas/deployRules.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const deployStageSchema: z.ZodEnum<{
+    preDestructive: "preDestructive";
+    unpackagedDeploy: "unpackagedDeploy";
+    postDeploy: "postDeploy";
+    postDestructive: "postDestructive";
+}>;
+declare const deployRuleSchema: z.ZodObject<{
+    deploymentName: z.ZodOptional<z.ZodString>;
+    deploymentSlug: z.ZodOptional<z.ZodString>;
+    requireStages: z.ZodArray<z.ZodEnum<{
+        preDestructive: "preDestructive";
+        unpackagedDeploy: "unpackagedDeploy";
+        postDeploy: "postDeploy";
+        postDestructive: "postDestructive";
+    }>>;
+}, z.core.$strict>;
+/** Zod equivalent of the original `deploy-rules.schema.json`. */
+export declare const deployRulesSchema: z.ZodObject<{
+    rules: z.ZodArray<z.ZodObject<{
+        deploymentName: z.ZodOptional<z.ZodString>;
+        deploymentSlug: z.ZodOptional<z.ZodString>;
+        requireStages: z.ZodArray<z.ZodEnum<{
+            preDestructive: "preDestructive";
+            unpackagedDeploy: "unpackagedDeploy";
+            postDeploy: "postDeploy";
+            postDestructive: "postDestructive";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DeployStage = z.infer<typeof deployStageSchema>;
+export type DeployRule = z.infer<typeof deployRuleSchema>;
+export type DeployRules = z.infer<typeof deployRulesSchema>;
+export {};