discord-ops 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # discord-ops
 
+## 0.7.0
+
+### Minor Changes
+
+- c24d139: Cutting-edge template system upgrade — 23 templates with native Discord features
+  - **6 new templates**: dashboard (multi-embed status board), progress (visual bar), oncall (shift handoff), standup (daily summary), retro (sprint retrospective), alert (configurable levels)
+  - **Native Discord polls**: `poll` template now uses Discord's poll API with progress bars, vote tracking, multiselect, and duration (replaces emoji-based fallback)
+  - **Link buttons**: deploy (View Deployment + View Logs), incident (Status Page), review (Open PR), release (Release Notes + npm + Docs), oncall (Runbook), and more
+  - **Author branding**: every template supports `author_name` + `author_icon` for consistent identity at the top of embeds
+  - **Discord timestamps**: maintenance start/end, incident started_at, announcement deadlines, welcome start_date — all auto-convert to user's timezone with live countdowns
+  - **Footer status icons**: deploy, ci_build, incident, status_update show green/red indicator icons
+  - **Clickable titles**: release, deploy, review, changelog titles link directly to URLs
+  - **Multi-embed dashboards**: up to 10 embeds per message for service status boards
+  - **Syntax-highlighted code**: tip template supports `language` var for code block highlighting
+  - **Visual progress bars**: Unicode block progress indicator with percentage
+  - **Severity-based colors**: incident template colors vary by severity (critical/high/medium/low)
+  - **Webhook schema fix**: `execute_webhook` now supports thumbnail, image, author, footer.icon_url (was missing)
+  - **Changelog expansion**: deprecated and performance sections added
+  - 45 new template tests (255 total)
+
+## 0.6.0
+
+### Minor Changes
+
+- 5a05546: Message template system with 17 built-in Discord embed templates
+  - `send_template` tool — send styled embeds using project routing (45 tools total)
+  - `list_templates` tool — discover templates with required/optional variables
+  - DevOps templates: release, deploy, ci_build, incident, incident_resolved, maintenance, status_update, review
+  - Team templates: celebration, welcome, shoutout, quote, announcement, changelog, milestone, tip, poll
+  - Curated color palette (success green, error red, celebration pink, premium gold, etc.)
+  - All templates support project routing, notification routing, and direct channel targeting
+  - 25 new template tests (235 total)
+
 ## 0.5.0
 
 ### Minor Changes

package/README.md

@@ -8,7 +8,7 @@ Agency-grade Discord MCP server with multi-guild project routing.
 
 ## Features
 
-- **43 MCP tools** — messaging, channels, moderation, roles, webhooks, audit log, threads, guilds, invites, permissions, search, project introspection
+- **45 MCP tools** — messaging, channels, moderation, roles, webhooks, audit log, threads, guilds, invites, permissions, search, 23 templates, project introspection
 - **Multi-guild project routing** — `send_message({ project: "my-app", channel: "builds" })` instead of raw channel IDs
 - **Notification routing** — map notification types (ci_build, deploy, error) to channels per project
 - **Multi-bot support** — manage multiple Discord bots from a single MCP server with per-project tokens
@@ -180,7 +180,7 @@ send_message({ channel_id: "123456789", content: "Hello" })
 
 ## Tools
 
-### Messaging (8 tools)
+### Messaging (10 tools)
 
 | Tool              | Description                                       |
 | ----------------- | ------------------------------------------------- |
@@ -192,6 +192,8 @@ send_message({ channel_id: "123456789", content: "Hello" })
 | `pin_message`     | Pin a message in a channel                        |
 | `unpin_message`   | Unpin a message                                   |
 | `search_messages` | Search messages by content, author, or date range |
+| `send_template`   | Send a styled embed using a built-in template     |
+| `list_templates`  | List available templates with required variables  |
 
 ### Channels (8 tools)
 
@@ -317,6 +319,109 @@ DRY_RUN=true discord-ops
 
 In dry-run mode, destructive tools return a simulated success response showing what would have happened.
 
+## Message Templates
+
+23 built-in templates with cutting-edge Discord features. Use `send_template` with project routing.
+
+**Features across all templates:**
+
+- **Author branding** — every template has a configurable `author_name` + `author_icon` at the top
+- **Link buttons** — clickable buttons below embeds (View Logs, Open PR, Runbook, etc.)
+- **Discord timestamps** — dates auto-convert to each user's timezone with live countdowns
+- **Native polls** — real Discord polls with progress bars and vote tracking
+- **Multi-embed dashboards** — up to 10 embeds per message for service status boards
+- **Footer icons** — status indicator icons (green/red) next to footer text
+- **Clickable titles** — embed titles link directly to URLs
+- **Syntax-highlighted code** — code examples with language-specific highlighting
+- **Progress bars** — visual Unicode block progress indicators
+
+### DevOps Templates (10)
+
+| Template            | Description                                    | Key Features                                 |
+| ------------------- | ---------------------------------------------- | -------------------------------------------- |
+| `release`           | Version release with install + link buttons    | Author, link buttons, clickable title        |
+| `deploy`            | Deploy success/failure with logs button        | Footer icon, view/logs buttons               |
+| `ci_build`          | CI result with build link button               | Footer icon, clickable title                 |
+| `incident`          | Incident alert with severity colors            | Discord timestamps, status page button       |
+| `incident_resolved` | Resolution with postmortem button              | Discord timestamps, postmortem link          |
+| `maintenance`       | Maintenance with live timezone countdowns      | Discord timestamps, countdown, status button |
+| `status_update`     | Service status (operational/degraded/outage)   | Footer icon, dashboard button                |
+| `review`            | PR review with diff stats + PR button          | Clickable title, additions/deletions         |
+| `dashboard`         | Multi-embed service status board (up to 9 svc) | Multi-embed, per-service color cards         |
+| `oncall`            | On-call handoff with shift timestamps          | Discord timestamps, runbook button           |
+| `alert`             | Configurable alert (info/warn/error/critical)  | Level-based colors, metric thresholds        |
+
+### Team & Community Templates (12)
+
+| Template       | Description                             | Key Features                                  |
+| -------------- | --------------------------------------- | --------------------------------------------- |
+| `celebration`  | Celebrate wins with images              | Author, thumbnail, image                      |
+| `welcome`      | Welcome members with onboarding buttons | Discord timestamps, handbook/onboarding links |
+| `shoutout`     | Recognize work with avatar thumbnail    | Thumbnail, nomination attribution             |
+| `quote`        | Block-quoted inspirational text         | Block quote formatting, author avatar         |
+| `announcement` | Announcement with deadline countdown    | Discord timestamps, countdown, link button    |
+| `changelog`    | Changelog with 7 section types          | Deprecated, performance, security sections    |
+| `milestone`    | Milestone with target date countdown    | Discord timestamps, progress tracking         |
+| `tip`          | Pro tip with syntax-highlighted code    | Language-specific code blocks, doc button     |
+| `poll`         | Native Discord poll with vote tracking  | Native poll API, multiselect, duration        |
+| `progress`     | Visual progress bar with deadline       | Unicode progress bar, countdown               |
+| `standup`      | Daily standup summary                   | Yesterday/today/blockers sections             |
+| `retro`        | Sprint retrospective                    | Went-well/improve/actions, velocity           |
+
+### Example
+
+```
+send_template({
+  template: "release",
+  vars: {
+    version: "0.7.0",
+    name: "discord-ops",
+    notes: "Cutting-edge template system with native Discord features",
+    highlights: "23 templates, native polls, link buttons, Discord timestamps",
+    npm: "discord-ops@0.7.0",
+    link: "https://github.com/bookedsolidtech/discord-ops/releases",
+    author_name: "Clarity CI",
+    author_icon: "https://example.com/logo.png"
+  },
+  project: "my-app",
+  channel: "releases"
+})
+```
+
+### Native Discord Poll
+
+```
+send_template({
+  template: "poll",
+  vars: {
+    question: "Best language for MCP servers?",
+    options: "TypeScript|Rust|Go|Python",
+    duration: "48",
+    multiselect: "true"
+  },
+  project: "my-app",
+  channel: "dev"
+})
+```
+
+### Multi-Embed Dashboard
+
+```
+send_template({
+  template: "dashboard",
+  vars: {
+    services: "API|Database|CDN|Auth|Queue",
+    statuses: "operational|operational|degraded|operational|outage",
+    title: "Production Status",
+    url: "https://status.example.com"
+  },
+  project: "my-app",
+  channel: "alerts"
+})
+```
+
+All templates support project routing (`project`, `channel`, `notification_type`, `channel_id`) and author branding (`author_name`, `author_icon`).
+
 ## Multi-Organization Troubleshooting
 
 ### Validating your config

package/dist/templates/registry.d.ts

@@ -0,0 +1,15 @@
+import type { TemplateRenderer, RenderedTemplate } from "./types.js";
+export interface TemplateInfo {
+    name: string;
+    category: string;
+    description: string;
+    requiredVars: string[];
+    optionalVars: string[];
+    render: TemplateRenderer;
+    features?: string[];
+}
+export declare const templates: Record<string, TemplateInfo>;
+export declare function getTemplate(name: string): TemplateInfo | undefined;
+export declare function listTemplates(): TemplateInfo[];
+export declare function renderTemplate(name: string, vars: Record<string, string>): RenderedTemplate;
+//# sourceMappingURL=registry.d.ts.map

package/dist/templates/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/templates/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAi2BpB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA8dlD,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAElE;AAED,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAE9C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,gBAAgB,CAa3F"}