run-and-notify 0.1.0

package/examples/apps/daily-digest-failure.mjs

@@ -0,0 +1,17 @@
+console.log('# Daily digest');
+console.error(
+  JSON.stringify({
+    level: 50,
+    timestamp: '2026-01-02T12:34:56Z',
+    msg: 'report failed because *input* contained <tags>',
+  }),
+);
+console.error(
+  JSON.stringify({
+    level: 40,
+    timestamp: '2026-01-02T12:35:20Z',
+    code: 'DIGEST_RETRY',
+  }),
+);
+console.error('not-json stderr fallback');
+process.exit(2);

package/examples/apps/daily-digest-html-success.mjs

@@ -0,0 +1,14 @@
+console.log('<h1>Daily digest</h1>');
+console.log('<ul><li>agenda generated</li><li>report mailed</li></ul>');
+console.log('<table><thead><tr><th>Job</th><th>Status</th></tr></thead>');
+console.log(
+  '<tbody><tr><td>Agenda</td><td>Ready</td></tr><tr><td>Report</td><td>Sent</td></tr></tbody></table>',
+);
+console.log('<pre><code>daily-report --send</code></pre>');
+console.error(
+  JSON.stringify({
+    level: 30,
+    timestamp: '2026-01-02T12:34:56Z',
+    msg: 'success stderr should be omitted',
+  }),
+);

package/examples/apps/daily-digest-success.mjs

@@ -0,0 +1,16 @@
+console.log('# Daily digest');
+console.log('');
+console.log('- agenda generated');
+console.log('- report mailed');
+console.log('');
+console.log('| Job | Status |');
+console.log('| --- | --- |');
+console.log('| Agenda | Ready |');
+console.log('| Report | Sent |');
+console.error(
+  JSON.stringify({
+    level: 30,
+    timestamp: '2026-01-02T12:34:56Z',
+    msg: 'success stderr should be omitted',
+  }),
+);

package/examples/apps/full-html.mjs

@@ -0,0 +1,14 @@
+console.log('<h1>Backup report</h1>');
+console.log('<ul>');
+console.log('<li>copied <code>/var/data</code></li>');
+console.log('<li>verified checksum</li>');
+console.log('</ul>');
+console.log('<table><thead><tr><th>Step</th><th>Result</th></tr></thead>');
+console.log(
+  '<tbody><tr><td>Copy</td><td>OK</td></tr><tr><td>Verify</td><td>OK</td></tr></tbody></table>',
+);
+console.log(
+  '<pre><code>rsync -a /var/data /backup/data\nsha256sum /backup/data/archive.tar</code></pre>',
+);
+console.error('<p><strong>warning:</strong> slow disk</p>');
+console.error('<pre><code>iostat: await &gt; 50ms</code></pre>');

package/examples/apps/full-markdown.mjs

@@ -0,0 +1,19 @@
+console.log('# Backup report');
+console.log('');
+console.log('- copied `/var/data`');
+console.log('- verified checksum');
+console.log('');
+console.log('| Step | Result |');
+console.log('| --- | --- |');
+console.log('| Copy | OK |');
+console.log('| Verify | OK |');
+console.log('');
+console.log('```sh');
+console.log('rsync -a /var/data /backup/data');
+console.log('sha256sum /backup/data/archive.tar');
+console.log('```');
+console.error('**warning:** slow disk');
+console.error('');
+console.error('```text');
+console.error('iostat: await > 50ms');
+console.error('```');

package/examples/apps/full-raw.mjs

@@ -0,0 +1,4 @@
+console.log('backup started');
+console.log('copied /var/data <important>');
+console.error('stderr line one');
+console.error('stderr line two & details');

package/examples/apps/structured-jsonl-success.mjs

@@ -0,0 +1,23 @@
+console.log(
+  JSON.stringify({
+    title: 'Structured report',
+    items: ['item 1', 'item 2'],
+    table: [
+      ['col-1-row-1', 'col-2-row-1'],
+      ['col-1-row-2', 'col-2-row-2'],
+    ],
+    date: '2026-01-02T12:34:56Z',
+    time: '2026-01-02T12:34:56Z',
+    datetime: '2026-01-02T12:34:56Z',
+    childHtml: '<p>some html</p>',
+    childMarkdown: '**some markdown**',
+    childRaw: 'raw text escapes <tags>',
+  }),
+);
+console.error(
+  JSON.stringify({
+    level: 30,
+    timestamp: '2026-01-02T12:34:56Z',
+    msg: 'structured report completed',
+  }),
+);

package/examples/config-html.json

@@ -0,0 +1,8 @@
+{
+  "stdout": {
+    "format": "html"
+  },
+  "stderr": {
+    "format": "html"
+  }
+}

package/examples/config-jsonl.json

@@ -0,0 +1,8 @@
+{
+  "stdout": {
+    "format": "jsonl"
+  },
+  "stderr": {
+    "format": "jsonl"
+  }
+}

package/examples/config-markdown.json

@@ -0,0 +1,8 @@
+{
+  "stdout": {
+    "format": "markdown"
+  },
+  "stderr": {
+    "format": "markdown"
+  }
+}

package/examples/config-raw.json

@@ -0,0 +1,8 @@
+{
+  "stdout": {
+    "format": "raw"
+  },
+  "stderr": {
+    "format": "raw"
+  }
+}

package/examples/daily-digest-html/config.json

@@ -0,0 +1,46 @@
+{
+  "locale": "en-US",
+  "timeoutSeconds": 0,
+  "showStderrIfSuccess": false,
+  "templatesDir": "examples/daily-digest-html/templates",
+  "stdout": {
+    "format": "html"
+  },
+  "stderr": {
+    "format": "jsonl"
+  },
+  "transports": {
+    "smtp": {
+      "enabled": true,
+      "host": "smtp.example.com",
+      "port": 587,
+      "from": "run-and-notify@example.com",
+      "to": ["digest@example.com"]
+    },
+    "slack": {
+      "enabled": true,
+      "tokenEnvVar": "SLACK_BOT_TOKEN",
+      "defaultChannel": "#daily-digest"
+    }
+  },
+  "success": {
+    "email": {
+      "subject": "success.subject.hbs",
+      "html": "success.email.html.hbs",
+      "text": "success.text.hbs"
+    },
+    "slack": {
+      "blocks": "success.slack.blocks.json.hbs"
+    }
+  },
+  "error": {
+    "email": {
+      "subject": "error.subject.hbs",
+      "html": "error.email.html.hbs",
+      "text": "error.text.hbs"
+    },
+    "slack": {
+      "blocks": "error.slack.blocks.json.hbs"
+    }
+  }
+}

package/examples/daily-digest-html/templates/error.email.html.hbs

@@ -0,0 +1,9 @@
+<h1>Daily digest failed</h1>
+<p><strong>CWD:</strong> {{shellToken cwd}}</p>
+<p><strong>Command:</strong> {{shellCommand command}}</p>
+<p><strong>Status:</strong> {{status}}</p>
+<ul>
+{{#each stderr.lines}}
+  <li>{{#if timestamp}}{{datetimeFromISO8601 timestamp}} {{{escapeHtml msg}}}{{else}}{{{escapeHtml raw}}}{{/if}}</li>
+{{/each}}
+</ul>

package/examples/daily-digest-html/templates/error.slack.blocks.json.hbs

@@ -0,0 +1,9 @@
+[
+  {
+    "type": "section",
+    "text": {
+      "type": "mrkdwn",
+      "text": {{{jsonString (concat "*Daily digest failed*" (nl) "*CWD:* `" (shellToken cwd) "`" (nl) "*Command:* `" (shellCommand command) "`" (nl) "*Status:* " status)}}}
+    }
+  }
+]

package/examples/daily-digest-html/templates/error.subject.hbs

@@ -0,0 +1 @@
+Daily digest failed with status {{status}}

package/examples/daily-digest-html/templates/error.text.hbs

@@ -0,0 +1,7 @@
+Daily digest failed
+CWD: {{shellToken cwd}}
+Command: {{shellCommand command}}
+Status: {{status}}
+{{#each stderr.lines}}
+{{#if timestamp}}{{datetimeFromISO8601 timestamp}} {{msg}}{{else}}{{raw}}{{/if}}
+{{/each}}

package/examples/daily-digest-html/templates/success.email.html.hbs

@@ -0,0 +1 @@
+{{{stdout.html}}}

package/examples/daily-digest-html/templates/success.slack.blocks.json.hbs

@@ -0,0 +1,9 @@
+[
+  {
+    "type": "section",
+    "text": {
+      "type": "mrkdwn",
+      "text": {{{jsonString (slackCodeBlock (htmlToMarkdown stdout.html))}}}
+    }
+  }
+]

package/examples/daily-digest-html/templates/success.subject.hbs

@@ -0,0 +1 @@
+Daily digest

package/examples/daily-digest-html/templates/success.text.hbs

@@ -0,0 +1 @@
+{{htmlToMarkdown stdout.html}}

package/examples/daily-digest-markdown/config.json

@@ -0,0 +1,46 @@
+{
+  "locale": "en-US",
+  "timeoutSeconds": 0,
+  "showStderrIfSuccess": false,
+  "templatesDir": "examples/daily-digest-markdown/templates",
+  "stdout": {
+    "format": "markdown"
+  },
+  "stderr": {
+    "format": "jsonl"
+  },
+  "transports": {
+    "smtp": {
+      "enabled": true,
+      "host": "smtp.example.com",
+      "port": 587,
+      "from": "run-and-notify@example.com",
+      "to": ["digest@example.com"]
+    },
+    "slack": {
+      "enabled": true,
+      "tokenEnvVar": "SLACK_BOT_TOKEN",
+      "defaultChannel": "#daily-digest"
+    }
+  },
+  "success": {
+    "email": {
+      "subject": "success.subject.hbs",
+      "html": "success.email.html.hbs",
+      "text": "success.text.hbs"
+    },
+    "slack": {
+      "blocks": "success.slack.blocks.json.hbs"
+    }
+  },
+  "error": {
+    "email": {
+      "subject": "error.subject.hbs",
+      "html": "error.email.html.hbs",
+      "text": "error.text.hbs"
+    },
+    "slack": {
+      "blocks": "error.slack.blocks.json.hbs"
+    }
+  }
+}

package/examples/daily-digest-markdown/templates/error.email.html.hbs

@@ -0,0 +1,9 @@
+<h1>Daily digest failed</h1>
+<p><strong>CWD:</strong> {{shellToken cwd}}</p>
+<p><strong>Command:</strong> {{shellCommand command}}</p>
+<p><strong>Status:</strong> {{status}}</p>
+<ul>
+{{#each stderr.lines}}
+  <li>{{#if timestamp}}{{datetimeFromISO8601 timestamp}} {{{escapeHtml msg}}}{{else}}{{{escapeHtml raw}}}{{/if}}</li>
+{{/each}}
+</ul>

package/examples/daily-digest-markdown/templates/error.slack.blocks.json.hbs

@@ -0,0 +1,16 @@
+[
+  {
+    "type": "section",
+    "text": {
+      "type": "mrkdwn",
+      "text": {{{jsonString (concat "*Daily digest failed*" (nl) "*CWD:* `" (shellToken cwd) "`" (nl) "*Command:* `" (shellCommand command) "`" (nl) "*Status:* " status)}}}
+    }
+  },
+  {
+    "type": "section",
+    "text": {
+      "type": "mrkdwn",
+      "text": {{{jsonString (slackCodeBlock (concat (datetimeFromISO8601 stderr.lines.[0].timestamp) " " (escapeMarkdown stderr.lines.[0].msg)))}}}
+    }
+  }
+]

package/examples/daily-digest-markdown/templates/error.subject.hbs

@@ -0,0 +1 @@
+Daily digest failed with status {{status}}

package/examples/daily-digest-markdown/templates/error.text.hbs

@@ -0,0 +1,9 @@
+Daily digest failed
+
+- CWD: `{{shellToken cwd}}`
+- Command: `{{shellCommand command}}`
+- Status: `{{status}}`
+
+{{#each stderr.lines}}
+- {{#if timestamp}}{{datetimeFromISO8601 timestamp}} {{{escapeMarkdown msg}}}{{else}}{{{escapeMarkdown raw}}}{{/if}}
+{{/each}}

package/examples/daily-digest-markdown/templates/success.email.html.hbs

@@ -0,0 +1 @@
+{{{markdownToHtml stdout.markdown}}}

package/examples/daily-digest-markdown/templates/success.slack.blocks.json.hbs

@@ -0,0 +1,9 @@
+[
+  {
+    "type": "section",
+    "text": {
+      "type": "mrkdwn",
+      "text": {{{jsonString (slackCodeBlock stdout)}}}
+    }
+  }
+]

package/examples/daily-digest-markdown/templates/success.subject.hbs

@@ -0,0 +1 @@
+Daily digest

package/examples/daily-digest-markdown/templates/success.text.hbs

@@ -0,0 +1 @@
+{{stdout.markdown}}

package/examples/full-html/config.json

@@ -0,0 +1,46 @@
+{
+  "locale": "en-US",
+  "timeoutSeconds": 0,
+  "showStderrIfSuccess": true,
+  "templatesDir": "examples/full-html/templates",
+  "stdout": {
+    "format": "html"
+  },
+  "stderr": {
+    "format": "html"
+  },
+  "transports": {
+    "smtp": {
+      "enabled": true,
+      "host": "smtp.example.com",
+      "port": 587,
+      "from": "run-and-notify@example.com",
+      "to": ["ops@example.com"]
+    },
+    "slack": {
+      "enabled": true,
+      "tokenEnvVar": "SLACK_BOT_TOKEN",
+      "defaultChannel": "#critical-ops"
+    }
+  },
+  "success": {
+    "email": {
+      "subject": "subject.hbs",
+      "html": "email.html.hbs",
+      "text": "text.hbs"
+    },
+    "slack": {
+      "blocks": "slack.blocks.json.hbs"
+    }
+  },
+  "error": {
+    "email": {
+      "subject": "subject.hbs",
+      "html": "email.html.hbs",
+      "text": "text.hbs"
+    },
+    "slack": {
+      "blocks": "slack.blocks.json.hbs"
+    }
+  }
+}

package/examples/full-html/templates/email.html.hbs

@@ -0,0 +1,22 @@
+<main style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; color: #18212f; line-height: 1.5;">
+  <section style="border: 1px solid #d9e2ec; border-radius: 16px; overflow: hidden;">
+    <header style="background: {{#if status}}#7f1d1d{{else}}#0f766e{{/if}}; color: #f0fdfa; padding: 20px 24px;">
+      <p style="margin: 0 0 6px; text-transform: uppercase; letter-spacing: .08em; font-size: 12px;">HTML output</p>
+      <h1 style="margin: 0; font-size: 22px;">Command result</h1>
+    </header>
+    <section style="padding: 18px 24px; background: #f8fafc;">
+      <p><strong>Executed:</strong> {{datetimeFromISO8601 executedAt}}</p>
+      <p><strong>Command:</strong> <code>{{shellCommand command}}</code></p>
+      <p><strong>CWD:</strong> <code>{{shellToken cwd}}</code></p>
+      <p><strong>Status:</strong> <code>{{status}}</code></p>
+    </section>
+    <section style="padding: 20px 24px;">
+      <h2>Output</h2>
+      {{{stdout.html}}}
+    </section>
+    <section style="padding: 20px 24px; border-top: 1px solid #e5e7eb;">
+      <h2>Errors</h2>
+      {{{stderr.html}}}
+    </section>
+  </section>
+</main>

package/examples/full-html/templates/slack.blocks.json.hbs

@@ -0,0 +1,9 @@
+[
+  {
+    "type": "section",
+    "text": {
+      "type": "mrkdwn",
+      "text": {{{jsonString (concat "*HTML command result*" (nl) "*Command:* `" (shellCommand command) "`" (nl) "*Status:* " status (nl) "*Executed:* " (datetimeFromISO8601 executedAt) (nl) "*CWD:* `" (shellToken cwd) "`" (nl) (nl) "*Output*" (nl) (slackCodeBlock (htmlToMarkdown stdout.html)) (nl) (nl) "*Errors*" (nl) (slackCodeBlock (htmlToMarkdown stderr.html)))}}}
+    }
+  }
+]

package/examples/full-html/templates/slack.text.hbs

@@ -0,0 +1 @@
+html {{shellCommand command}} exited {{status}}

package/examples/full-html/templates/subject.hbs

@@ -0,0 +1 @@
+[html] {{shellToken command.[0]}} exited {{status}}

package/examples/full-html/templates/text.hbs

@@ -0,0 +1,12 @@
+# HTML Command Result
+
+- Executed: {{datetimeFromISO8601 executedAt}}
+- Command: `{{shellCommand command}}`
+- CWD: `{{shellToken cwd}}`
+- Status: `{{status}}`
+
+## Output
+{{htmlToMarkdown stdout.html}}
+
+## Errors
+{{htmlToMarkdown stderr.html}}

package/examples/full-markdown/config.json

@@ -0,0 +1,46 @@
+{
+  "locale": "en-US",
+  "timeoutSeconds": 0,
+  "showStderrIfSuccess": true,
+  "templatesDir": "examples/full-markdown/templates",
+  "stdout": {
+    "format": "markdown"
+  },
+  "stderr": {
+    "format": "markdown"
+  },
+  "transports": {
+    "smtp": {
+      "enabled": true,
+      "host": "smtp.example.com",
+      "port": 587,
+      "from": "run-and-notify@example.com",
+      "to": ["ops@example.com"]
+    },
+    "slack": {
+      "enabled": true,
+      "tokenEnvVar": "SLACK_BOT_TOKEN",
+      "defaultChannel": "#critical-ops"
+    }
+  },
+  "success": {
+    "email": {
+      "subject": "subject.hbs",
+      "html": "email.html.hbs",
+      "text": "text.hbs"
+    },
+    "slack": {
+      "blocks": "slack.blocks.json.hbs"
+    }
+  },
+  "error": {
+    "email": {
+      "subject": "subject.hbs",
+      "html": "email.html.hbs",
+      "text": "text.hbs"
+    },
+    "slack": {
+      "blocks": "slack.blocks.json.hbs"
+    }
+  }
+}

package/examples/full-markdown/templates/email.html.hbs

@@ -0,0 +1 @@
+{{{markdownToHtml (concat "# Markdown Command Result" (nl) (nl) "- Executed: " (datetimeFromISO8601 executedAt) (nl) "- Command: `" (shellCommand command) "`" (nl) "- CWD: `" (shellToken cwd) "`" (nl) "- Status: `" status "`" (nl) (nl) "## Output" (nl) (nl) "```markdown" (nl) stdout.markdown (nl) "```" (nl) (nl) "## Errors" (nl) (nl) "```markdown" (nl) stderr.markdown (nl) "```")}}}

package/examples/full-markdown/templates/slack.blocks.json.hbs

@@ -0,0 +1,9 @@
+[
+  {
+    "type": "section",
+    "text": {
+      "type": "mrkdwn",
+      "text": {{{jsonString (concat "*Markdown command result*" (nl) "*Command:* `" (shellCommand command) "`" (nl) "*Status:* " status (nl) "*Executed:* " (datetimeFromISO8601 executedAt) (nl) "*CWD:* `" (shellToken cwd) "`" (nl) (nl) "*Output*" (nl) (slackCodeBlock stdout) (nl) (nl) "*Errors*" (nl) (slackCodeBlock stderr))}}}
+    }
+  }
+]

package/examples/full-markdown/templates/slack.text.hbs

@@ -0,0 +1 @@
+markdown {{shellCommand command}} exited {{status}}

package/examples/full-markdown/templates/subject.hbs

@@ -0,0 +1 @@
+[markdown] {{shellToken command.[0]}} exited {{status}}

package/examples/full-markdown/templates/text.hbs

@@ -0,0 +1,18 @@
+# Markdown Command Result
+
+- Executed: {{datetimeFromISO8601 executedAt}}
+- Command: `{{shellCommand command}}`
+- CWD: `{{shellToken cwd}}`
+- Status: `{{status}}`
+
+## Output
+
+```markdown
+{{stdout.markdown}}
+```
+
+## Errors
+
+```markdown
+{{stderr.markdown}}
+```

package/examples/full-raw/config.json

@@ -0,0 +1,46 @@
+{
+  "locale": "en-US",
+  "timeoutSeconds": 0,
+  "showStderrIfSuccess": true,
+  "templatesDir": "examples/full-raw/templates",
+  "stdout": {
+    "format": "raw"
+  },
+  "stderr": {
+    "format": "raw"
+  },
+  "transports": {
+    "smtp": {
+      "enabled": true,
+      "host": "smtp.example.com",
+      "port": 587,
+      "from": "run-and-notify@example.com",
+      "to": ["ops@example.com"]
+    },
+    "slack": {
+      "enabled": true,
+      "tokenEnvVar": "SLACK_BOT_TOKEN",
+      "defaultChannel": "#critical-ops"
+    }
+  },
+  "success": {
+    "email": {
+      "subject": "subject.hbs",
+      "html": "email.html.hbs",
+      "text": "text.hbs"
+    },
+    "slack": {
+      "blocks": "slack.blocks.json.hbs"
+    }
+  },
+  "error": {
+    "email": {
+      "subject": "subject.hbs",
+      "html": "email.html.hbs",
+      "text": "text.hbs"
+    },
+    "slack": {
+      "blocks": "slack.blocks.json.hbs"
+    }
+  }
+}

package/examples/full-raw/templates/email.html.hbs

@@ -0,0 +1,22 @@
+<main style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; color: #18212f; line-height: 1.5;">
+  <section style="border: 1px solid #d9e2ec; border-radius: 16px; overflow: hidden;">
+    <header style="background: {{#if status}}#7f1d1d{{else}}#111827{{/if}}; color: #f9fafb; padding: 20px 24px;">
+      <p style="margin: 0 0 6px; text-transform: uppercase; letter-spacing: .08em; font-size: 12px;">Critical automation</p>
+      <h1 style="margin: 0; font-size: 22px;">Raw command result</h1>
+    </header>
+    <section style="padding: 18px 24px; background: #f8fafc;">
+      <p><strong>Executed:</strong> {{datetimeFromISO8601 executedAt}}</p>
+      <p><strong>Command:</strong> <code>{{shellCommand command}}</code></p>
+      <p><strong>CWD:</strong> <code>{{shellToken cwd}}</code></p>
+      <p><strong>Status:</strong> <code>{{status}}</code></p>
+    </section>
+    <section style="padding: 20px 24px;">
+      <h2>Output</h2>
+      <pre style="white-space: pre-wrap;">{{{rawToHtml stdout.raw}}}</pre>
+    </section>
+    <section style="padding: 20px 24px; border-top: 1px solid #e5e7eb;">
+      <h2>Errors</h2>
+      <pre style="white-space: pre-wrap;">{{{rawToHtml stderr.raw}}}</pre>
+    </section>
+  </section>
+</main>

package/examples/full-raw/templates/slack.blocks.json.hbs

@@ -0,0 +1,16 @@
+[
+  {
+    "type": "section",
+    "text": {
+      "type": "mrkdwn",
+      "text": {{{jsonString (concat "*Raw command result*" (nl) "*Command:* `" (shellCommand command) "`" (nl) "*Status:* " status (nl) "*Executed:* " (datetimeFromISO8601 executedAt) (nl) "*CWD:* `" (shellToken cwd) "`")}}}
+    }
+  },
+  {
+    "type": "section",
+    "text": {
+      "type": "mrkdwn",
+      "text": {{{jsonString (concat "*Output*" (nl) (slackCodeBlock stdout) (nl) (nl) "*Errors*" (nl) (slackCodeBlock stderr))}}}
+    }
+  }
+]

package/examples/full-raw/templates/slack.text.hbs

@@ -0,0 +1 @@
+raw {{shellCommand command}} exited {{status}} at {{datetimeFromISO8601 executedAt}}

package/examples/full-raw/templates/subject.hbs

@@ -0,0 +1 @@
+[raw] {{shellToken command.[0]}} exited {{status}}