pm-slack 2026.6.2 → 2026.6.4-1

package/CHANGELOG.md

@@ -1,6 +1,36 @@
 # Changelog
 
-## 2026.6.2 - 2026-06-02
+## 2026.6.4-1 - 2026-06-04
+
+### Added
+
+- preflight: fail-fast Slack webhook validation gate ([pm-slack-676l](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/features/pm-slack-676l.toon))
+
+## 2026.06.04 - 2026-06-04
+
+### Added
+
+- Lifecycle event taxonomy + assignee mentions + action buttons ([pm-slack-c3q7](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/features/pm-slack-c3q7.toon))
+
+## 2026.06.03 - 2026-06-02
+
+### Added
+
+- Deep feature enhancement 2026-06-03 ([pm-slack-l3ux](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/features/pm-slack-l3ux.toon))
+- Digest reads pm store toon/json files directly \(no new SDK service\) ([pm-slack-06ti](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/decisions/pm-slack-06ti.toon))
+
+### Other
+
+- Best-effort hook policy unchanged; strict creds only in test/digest real-post ([pm-slack-b08f](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/decisions/pm-slack-b08f.toon))
+- Routing model: PM\_SLACK\_ROUTES JSON map + per-event channel override ([pm-slack-i3ir](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/decisions/pm-slack-i3ir.toon))
+- Unit tests + README + functional test + release 2026.6.3 ([pm-slack-ffs4](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/tasks/pm-slack-ffs4.toon))
+- Strict missing-creds CommandError for real posts; keep best-effort hook ([pm-slack-7fk4](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/tasks/pm-slack-7fk4.toon))
+- slack digest command: activity summary over --since/--days ([pm-slack-nga4](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/tasks/pm-slack-nga4.toon))
+- slack test command: offline preview, no network, --json ([pm-slack-36xw](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/tasks/pm-slack-36xw.toon))
+- Event/type routing to multiple webhooks/channels \(PM\_SLACK\_ROUTES\) ([pm-slack-747x](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/tasks/pm-slack-747x.toon))
+- Format toggle: --format text\|blockkit for hook + commands ([pm-slack-1fbz](https://github.com/unbraind/pm-slack/blob/main/.agents/pm/tasks/pm-slack-1fbz.toon))
+
+## 2026.06.02 - 2026-06-02
 
 ### Added
 

package/README.md

@@ -2,7 +2,7 @@
 
 Slack notifications for [pm-cli](https://github.com/unbraind/pm-cli) item lifecycle events.
 
-Fires after `create`, `close`, and `block` operations and posts a formatted message to a Slack incoming webhook.
+Fires after `create`, `close`, `block`, `cancel`, `open`, `start`, `unblock`, and `reopen` lifecycle transitions and posts a formatted message to a Slack incoming webhook. Optionally maps assignees to Slack `@mentions` and adds Block Kit action buttons linking to the item / GitHub URL.
 
 ---
 
@@ -33,10 +33,14 @@ pm install github.com/unbraind/pm-slack --project
 
 | Variable | Required | Default | Description |
 |---|---|---|---|
-| `PM_SLACK_WEBHOOK` | **Yes** | — | Slack incoming webhook URL |
-| `PM_SLACK_CHANNEL` | No | — | Channel hint appended to messages (e.g. `#pm-alerts`) |
+| `PM_SLACK_WEBHOOK` | Usually | — | Slack incoming webhook URL (optional if every routing rule carries its own `webhook`) |
+| `PM_SLACK_CHANNEL` | No | — | Default channel hint appended to messages (e.g. `#pm-alerts`) |
 | `PM_SLACK_MIN_PRIORITY` | No | `1` | Minimum priority to notify (1=critical, 2=high, 3=medium, 4=low) |
-| `PM_SLACK_EVENTS` | No | `create,close,block` | Comma-separated list of events to notify on |
+| `PM_SLACK_EVENTS` | No | all events | Comma-separated list of events to notify on. Status-name aliases (`canceled`, `in_progress`, …) accepted |
+| `PM_SLACK_FORMAT` | No | `blockkit` | Default message format: `blockkit` (rich) or `text` (plain mrkdwn) |
+| `PM_SLACK_ROUTES` | No | — | JSON array of routing rules (see [Routing](#routing-by-event-type-or-status)) |
+| `PM_SLACK_ASSIGNEE_MAP` | No | — | Comma list of `name=slackId` pairs mapping assignees to Slack `@mentions`, e.g. `alice=U123,bob=U456` |
+| `PM_SLACK_MENTION_ASSIGNEE` | No | auto | Set `0`/`false` to disable assignee mentions even when a map is set (auto-enabled when `PM_SLACK_ASSIGNEE_MAP` is non-empty) |
 
 Export them in your shell profile or `.env`:
 
@@ -45,6 +49,7 @@ export PM_SLACK_WEBHOOK="<slack-webhook-url>"
 export PM_SLACK_CHANNEL="#pm-alerts"
 export PM_SLACK_MIN_PRIORITY=2   # only critical + high
 export PM_SLACK_EVENTS="create,close"  # skip block notifications
+export PM_SLACK_FORMAT="text"          # plain text instead of Block Kit
 ```
 
 ---
@@ -55,7 +60,17 @@ export PM_SLACK_EVENTS="create,close"  # skip block notifications
 |---|---|---|
 | `create` | `pm add`, `pm create`, `pm new` | Fires when a new item is created |
 | `close` | `pm close`, `pm done`, `pm complete` | Fires when an item is closed/resolved |
-| `block` | `pm update --status blocked`, `pm set status blocked` | Fires when an item's status changes to blocked |
+| `block` | `pm update --status blocked` | Fires when an item's status changes to blocked |
+| `cancel` | `pm update --status canceled` | Fires when an item is canceled (reason read from `close_reason`) |
+| `open` | `pm update --status open` (e.g. `draft → open`) | Fires when an item is published/opened |
+| `start` | `pm claim`, `pm start-task`, `pm update --status in_progress` | Fires when work begins on an item |
+| `unblock` | `pm update --status open` from a `blocked` state | Distinguished when the result carries the prior status |
+| `reopen` | `pm update --status open` from a `closed`/`canceled` state | Distinguished when the result carries the prior status |
+
+`unblock` / `reopen` are refinements of an `open` transition: when pm's hook
+result exposes the previous status, the more specific event is used; otherwise
+the transition surfaces as `open`. Status-name aliases (`canceled`,
+`in_progress`, `reopened`, …) are accepted anywhere an event name is.
 
 ---
 
@@ -115,12 +130,184 @@ PM_SLACK_EVENTS="create,close"
 
 ---
 
+## Message Formats
+
+Notifications render as rich Slack **Block Kit** by default (header, a fields
+grid with item id / type / event / priority / status / author, an optional
+reason section, and a context footer). Set the format to plain `text` for
+minimal/legacy channels:
+
+```bash
+export PM_SLACK_FORMAT="text"     # plain mrkdwn, no blocks
+```
+
+Per-command, the `--format blockkit|text` flag overrides the env var for
+`slack notify`, `slack test`, and `slack digest`.
+
+---
+
+## Routing (by event, type, or status)
+
+`PM_SLACK_ROUTES` is an optional JSON array of rules that send specific events,
+item types, or statuses to a different webhook and/or channel. Routing is purely
+additive — with no rules configured, behavior is unchanged.
+
+Each rule is `{ "match": "<selector>", "webhook"?: "...", "channel"?: "..." }`.
+Selectors:
+
+| Selector | Matches |
+|---|---|
+| `create` / `close` / `block` | that lifecycle event |
+| `type:<itemType>` | items of that type (case-insensitive) |
+| `status:<status>` | items in that status (case-insensitive) |
+| `*` / `all` | everything (use as a catch-all) |
+
+The **first matching rule wins**; any field a rule omits falls back to the
+default `PM_SLACK_WEBHOOK` / `PM_SLACK_CHANNEL`.
+
+```bash
+export PM_SLACK_ROUTES='[
+  { "match": "block", "channel": "#urgent" },
+  { "match": "type:Bug", "webhook": "https://hooks.slack.com/services/AAA/BBB/CCC" }
+]'
+```
+
+---
+
+## Assignee @mentions
+
+Map a pm item's `assignee` to a Slack user (or group) id so notifications
+@-mention the responsible person. Set `PM_SLACK_ASSIGNEE_MAP` to a comma list of
+`name=id` pairs:
+
+```bash
+export PM_SLACK_ASSIGNEE_MAP="alice=U0123ABC,bob=U0456DEF,team=<!subteam^S0789GHI>"
+```
+
+- A raw id (`U0123ABC`) is wrapped as `<@U0123ABC>`.
+- A pre-wrapped token (e.g. `<!subteam^S0789GHI>` for a group) is used verbatim.
+- Mentions auto-enable in the hook whenever the map is non-empty; set
+  `PM_SLACK_MENTION_ASSIGNEE=0` to force them off.
+- For ad-hoc posts, `pm slack notify --assignee alice --mention-assignee` resolves
+  the mention from the same map. When no mapping exists, the raw assignee name is
+  still shown (blockkit) — output is byte-identical to before when no map is set.
+
+---
+
+## Action buttons (item / GitHub links)
+
+When a pm item carries a URL, the Block Kit notification adds an action button
+linking to it (`View on GitHub` for github.com URLs, otherwise `Open item`). The
+URL is read from the first present of these item fields: `github_url`,
+`html_url`, `url`, `source_url`, `link` (camelCase variants accepted). The
+plain-`text` format is unchanged. For ad-hoc posts:
+
+```bash
+pm slack notify --title 'Deploy' --on close --url 'https://github.com/unbraind/pm-slack/pull/3' --dry-run
+```
+
+---
+
+## Commands
+
+### `pm slack notify`
+
+Manually post a Block Kit (or text) message for an ad-hoc note.
+
+```bash
+pm slack notify --text 'Release shipped :rocket:' --dry-run
+pm slack notify --title 'Deploy done' --on close --format text --channel '#releases'
+```
+
+### `pm slack test`
+
+Build and **print** a sample notification in the chosen format **without
+posting** — fully offline, no webhook required. Great for previewing formatting.
+
+```bash
+pm slack test --format blockkit          # rich preview
+pm slack test --format text --on close   # plain-text preview of a close event
+pm slack test --on block --json          # machine-readable payload (with global --json)
+```
+
+Flags: `--format blockkit|text`, `--on create|close|block`, `--title`,
+`--channel`, `--json`.
+
+### `pm slack digest`
+
+Produce a single summary of recent activity (created / closed / blocked /
+in-progress) over a time window, as Block Kit or text. Reads the pm store
+directly. Use `--dry-run` to preview without posting.
+
+```bash
+pm slack digest --days 7 --dry-run
+pm slack digest --since 2026-06-01 --format text --dry-run
+pm slack digest --days 1 --format blockkit          # real post (needs a webhook)
+```
+
+Flags: `--since <date>`, `--days <n>` (default 7), `--format blockkit|text`,
+`--channel`, `--webhook`, `--dry-run`, `--json`.
+
+A real (non-`--dry-run`) `slack digest` post without a configured webhook fails
+with a clear error (exit 1) rather than crashing.
+
+---
+
+## Webhook preflight gate
+
+The Slack-posting commands (`slack notify`, `slack digest`) run a **fail-fast
+preflight** that validates webhook configuration **before** anything is posted:
+
+- The effective webhook is resolved with precedence `--webhook` flag →
+  `PM_SLACK_WEBHOOK` → a per-rule webhook in `PM_SLACK_ROUTES`.
+- If no webhook is configured, or the configured URL is not a valid `http(s)`
+  URL, the command **aborts immediately** with a clear, actionable error and a
+  **non-zero exit** (`2`, usage error) — nothing is posted, no network call is
+  made.
+- On a valid configuration the gate is a **silent pass-through**.
+
+Validation is **purely syntactic/environment-based — no network call**, so it is
+cheap and offline-safe. It does *not* verify the webhook actually works; a valid
+but dead webhook still passes the gate and surfaces at the network layer.
+
+What is **not** gated:
+
+- `slack test` — an offline preview that never posts and works with no webhook.
+- `--dry-run` on `slack notify` / `slack digest` — also an offline preview.
+
+The gate is registered both as a scoped `registerPreflight` override (for the
+documented `preflight` capability and a visible warning) and — because the pm
+runtime treats errors thrown from a preflight override as non-fatal — enforced in
+the command handlers themselves, which throw a `CommandError` that genuinely
+aborts the command.
+
+```bash
+# no webhook configured:
+pm slack notify --text 'hi'        # → error + exit 2, nothing posted
+pm slack notify --text 'hi' --dry-run   # → offline preview, exit 0
+pm slack test --on close           # → offline preview, exit 0
+```
+
+---
+
 ## Error Handling
 
-- If `PM_SLACK_WEBHOOK` is not set, the extension silently skips all notifications and logs a debug message.
-- If the webhook URL is invalid, the extension logs an error and continues without crashing pm-cli.
-- HTTP errors from Slack (non-2xx responses) are logged but do not fail the pm-cli command.
-- Network timeouts are set to 10 seconds.
+The **lifecycle hook is best-effort** and never breaks your pm command:
+
+- If `PM_SLACK_WEBHOOK` is not set, the hook silently skips all notifications and logs a debug message.
+- If the webhook URL is invalid, the hook logs an error and continues without crashing pm-cli.
+- HTTP errors from Slack (non-2xx responses), network failures, and timeouts (10s) are logged but never fail the underlying `pm` command.
+
+The **`slack notify` and `slack digest` commands fail fast** on misconfiguration
+(see [Webhook preflight gate](#webhook-preflight-gate)):
+
+- A real (non-`--dry-run`) post without a configured webhook, or with an invalid
+  webhook URL, fails with a clear `CommandError` and a non-zero exit **before**
+  any post is attempted.
+- Use `--dry-run` to build and preview with no webhook and no network call.
+- Once past the gate, `slack notify` treats a *network/HTTP* failure as
+  best-effort (warns, exits 0); `slack digest` reports a post failure as an
+  error (exit 1).
 
 ---
 
@@ -141,12 +328,11 @@ The extension uses only Node.js built-ins (`node:https`) — no external runtime
 ```json
 {
   "name": "pm-slack",
-  "version": "0.1.0",
   "description": "Slack notifications for pm item lifecycle events",
   "author": "@unbraind",
-  "entry": "index.js",
+  "entry": "./dist/index.js",
   "priority": 50,
-  "capabilities": ["hooks", "services"]
+  "capabilities": ["commands", "hooks", "schema", "preflight"]
 }
 ```
 

package/dist/index.d.ts

@@ -13,7 +13,20 @@
  *   PM_SLACK_WEBHOOK      (required) Slack incoming webhook URL
  *   PM_SLACK_CHANNEL      (optional) Override channel, e.g. #pm-alerts
  *   PM_SLACK_MIN_PRIORITY (optional) Minimum priority to notify (1=critical … 4=low), default 1 (critical only; set 4 for all)
- *   PM_SLACK_EVENTS       (optional) Comma-separated subset of hook events: create,close,block (default: all)
+ *   PM_SLACK_EVENTS       (optional) Comma-separated subset of hook events:
+ *                                    create,close,block,cancel,open,start,unblock,reopen (default: all).
+ *                                    Status-name aliases (e.g. "canceled","in_progress") are accepted.
+ *   PM_SLACK_FORMAT       (optional) Default notification format: "blockkit" (default) or "text"
+ *   PM_SLACK_ASSIGNEE_MAP (optional) Comma list of "name=slackId" pairs mapping a pm item's
+ *                                    assignee to a Slack @mention, e.g. "alice=U123,bob=U456".
+ *   PM_SLACK_MENTION_ASSIGNEE (optional) Set to 0/false to disable assignee @mentions even when a map is set
+ *                                    (mentions auto-enable in the hook whenever PM_SLACK_ASSIGNEE_MAP is non-empty).
+ *   PM_SLACK_ROUTES       (optional) JSON array of routing rules to send specific
+ *                                    events/types/statuses to different webhooks/channels.
+ *                                    Each rule: { "match": "<selector>", "webhook"?: "...", "channel"?: "..." }
+ *                                    Selector forms: an event ("create"|"close"|"block"),
+ *                                    "type:<itemType>" (case-insensitive), or "status:<status>".
+ *                                    First matching rule wins; unset fields fall back to the defaults.
  */
 import type { AfterCommandHookContext } from "@unbrained/pm-cli/sdk";
 declare class CommandError extends Error {
@@ -31,25 +44,182 @@ interface PmItem {
     blocked_reason?: string;
     closedReason?: string;
     blockedReason?: string;
+    cancel_reason?: string;
+    cancelReason?: string;
     author?: string;
+    assignee?: string;
+    url?: string;
+    github_url?: string;
+    githubUrl?: string;
+    html_url?: string;
+    htmlUrl?: string;
+    source_url?: string;
+    sourceUrl?: string;
+    link?: string;
+}
+type EventKind = "create" | "close" | "block" | "cancel" | "open" | "start" | "unblock" | "reopen";
+type MessageFormat = "blockkit" | "text";
+/** A single routing rule parsed from PM_SLACK_ROUTES. */
+interface RouteRule {
+    /** Raw selector string, e.g. "block", "type:Bug", "status:blocked". */
+    match: string;
+    webhook?: string;
+    channel?: string;
+}
+/** Resolved destination for a notification after applying routing rules. */
+interface RouteTarget {
+    webhookUrl: string;
+    channel?: string;
 }
-type EventKind = "create" | "close" | "block";
 interface SlackBlock {
     type: string;
     [key: string]: unknown;
 }
+interface SlackPayload {
+    text: string;
+    blocks?: SlackBlock[];
+    mrkdwn?: boolean;
+    channel?: string;
+    thread_ts?: string;
+}
+declare function normalizeEvent(token: string): EventKind | null;
 declare function parseEvents(spec: string | undefined): Set<EventKind>;
+/**
+ * Normalize a format spec to a known MessageFormat. Accepts a few friendly
+ * aliases ("block"/"blocks" → blockkit, "plain"/"txt" → text). Falls back to
+ * the supplied default when the spec is empty or unrecognized.
+ */
+declare function parseFormat(spec: string | undefined, fallback?: MessageFormat): MessageFormat;
+declare function parseRoutes(spec: string | undefined): RouteRule[];
+/**
+ * Does a single route rule match this event/item? Selector forms:
+ *   - bare event name: "create" | "close" | "block"
+ *   - "type:<itemType>"   (case-insensitive on item.type)
+ *   - "status:<status>"   (case-insensitive on item.status)
+ *   - "*" / "all"         (matches everything — useful as a catch-all)
+ */
+declare function ruleMatches(rule: RouteRule, event: EventKind, item: PmItem): boolean;
+/**
+ * Resolve the destination (webhook + channel) for an event/item given the
+ * configured routes and the default webhook/channel. First matching rule wins;
+ * any field a rule omits falls back to the default. Returns null only when no
+ * webhook can be resolved at all.
+ */
+declare function selectRoute(event: EventKind, item: PmItem, routes: RouteRule[], defaultWebhook: string, defaultChannel?: string): RouteTarget | null;
+/**
+ * Resolve the effective webhook for a posting command from an explicit
+ * `--webhook` flag (highest precedence) or PM_SLACK_WEBHOOK. PM_SLACK_ROUTES
+ * may also carry per-rule webhooks; a present route webhook is accepted as a
+ * valid source so route-only configurations are not falsely rejected.
+ */
+declare function resolveEffectiveWebhook(webhookFlag: string | undefined): {
+    webhookUrl: string;
+    source: "flag" | "env" | "route" | "none";
+};
+/**
+ * Validate webhook configuration for a Slack-posting command. Throws a
+ * CommandError (exit 2 / USAGE) with an actionable message when no webhook is
+ * configured or the configured webhook URL is syntactically invalid. Returns
+ * silently (pass-through) on a valid config. Performs NO network I/O.
+ *
+ * `commandLabel` is woven into the message (e.g. "slack digest") so the user
+ * sees exactly which command was gated.
+ */
+declare function assertWebhookConfigured(webhookFlag: string | undefined, commandLabel: string): void;
 declare function meetsMinPriority(item: PmItem, minPriority: Priority): boolean;
-declare function buildTextMessage(item: PmItem, event: EventKind, channel?: string): string;
+/** Parse PM_SLACK_ASSIGNEE_MAP into a case-insensitive name→id lookup. */
+declare function parseAssigneeMap(spec: string | undefined): Map<string, string>;
+/**
+ * Resolve an item's assignee to a Slack mention token using the map. Returns a
+ * ready-to-embed mention string (e.g. `<@U123>`) or undefined when there's no
+ * assignee or no mapping. A raw id is wrapped as `<@id>`; a token already
+ * containing `<` is passed through unchanged (supports `<!subteam^S123>` etc).
+ */
+declare function resolveAssigneeMention(item: PmItem, map: Map<string, string>): string | undefined;
+declare function isHttpUrl(value: unknown): value is string;
+/** Resolve a primary URL for the item, plus whether it points at GitHub. */
+declare function resolveItemUrl(item: PmItem, override?: string): {
+    url: string;
+    isGithub: boolean;
+} | undefined;
+declare function buildTextMessage(item: PmItem, event: EventKind, channel?: string, mention?: string): string;
 interface BlockKitOptions {
     channel?: string;
     /** Extra free-form body appended as a section (e.g. from `--text`). */
     note?: string;
+    /** Pre-resolved Slack mention token for the assignee (e.g. `<@U123>`). */
+    mention?: string;
+    /** Resolved item/GitHub URL for an action button. */
+    link?: {
+        url: string;
+        isGithub: boolean;
+    };
 }
 declare function buildItemBlockKit(item: PmItem, event: EventKind, opts?: BlockKitOptions): {
     blocks: SlackBlock[];
     fallback: string;
 };
+/**
+ * Build a ready-to-post SlackPayload for an item event in the requested format.
+ * - "blockkit": rich Block Kit blocks + plain-text fallback in `text`.
+ * - "text":     plain mrkdwn only (no `blocks`), for minimal/legacy channels.
+ */
+declare function buildItemPayload(item: PmItem, event: EventKind, format: MessageFormat, opts?: BlockKitOptions): SlackPayload;
+/** Fields we read off each stored item for digest purposes. */
+interface DigestItem extends PmItem {
+    created_at?: string;
+    updated_at?: string;
+}
+/**
+ * Minimal parser for a stored pm item file. Handles the toon scalar form
+ * (`key: value`, optionally quoted) and JSON. Only top-level scalar fields are
+ * extracted; nested/array sections are ignored. Returns null when no id found.
+ */
+declare function parseStoredItem(content: string, ext: string): DigestItem | null;
+/**
+ * Resolve a `--since <date>` / `--days <n>` window into an epoch-ms cutoff.
+ * `since` (ISO date or datetime) wins when both are given; otherwise `days`
+ * back from `now`. Defaults to 7 days. Returns the cutoff in ms.
+ */
+declare function resolveWindow(since: string | undefined, days: number | undefined, now?: number): {
+    cutoffMs: number;
+    label: string;
+};
+type DigestBucket = "created" | "closed" | "blocked" | "in_progress";
+interface DigestSummary {
+    windowLabel: string;
+    cutoffMs: number;
+    counts: Record<DigestBucket, number>;
+    buckets: Record<DigestBucket, DigestItem[]>;
+    total: number;
+}
+/**
+ * Aggregate store items into digest buckets for the window. An item counts as:
+ *   - created     if created_at >= cutoff
+ *   - closed      if it is in a closed/done status AND updated_at >= cutoff
+ *   - blocked     if status === blocked AND updated_at >= cutoff
+ *   - in_progress if status === in_progress AND updated_at >= cutoff
+ * An item may appear in multiple buckets (e.g. created and blocked).
+ */
+declare function aggregateDigest(items: DigestItem[], cutoffMs: number, windowLabel: string): DigestSummary;
+declare function buildDigestText(summary: DigestSummary, channel?: string): string;
+declare function buildDigestBlockKit(summary: DigestSummary, channel?: string): {
+    blocks: SlackBlock[];
+    fallback: string;
+};
+declare function buildDigestPayload(summary: DigestSummary, format: MessageFormat, channel?: string): SlackPayload;
+/** Map a (normalized) status string to the EventKind for a transition into it. */
+declare function statusToEvent(status: string | undefined): EventKind | null;
+/**
+ * Detect the lifecycle event for a completed command. Strategy:
+ *   1. Create/close commands map directly.
+ *   2. Status-changing commands (update/set/lifecycle aliases) derive the event
+ *      from the *resulting* status (preferring the explicit --status option,
+ *      falling back to the result item's status).
+ *   3. When the result carries the prior status (`previousStatus`), refine
+ *      open→reopen (from a closed/canceled state) and open→unblock (from
+ *      blocked) so terminal-recovery transitions are distinguishable.
+ */
 declare function detectEvent(ctx: AfterCommandHookContext): EventKind | null;
 declare function extractItem(ctx: AfterCommandHookContext): PmItem | null;
 declare const _default: {
@@ -60,11 +230,34 @@ declare const _default: {
 export default _default;
 export declare const __test__: {
     buildItemBlockKit: typeof buildItemBlockKit;
+    buildItemPayload: typeof buildItemPayload;
     buildTextMessage: typeof buildTextMessage;
     parseEvents: typeof parseEvents;
+    normalizeEvent: typeof normalizeEvent;
+    parseFormat: typeof parseFormat;
+    parseRoutes: typeof parseRoutes;
+    ruleMatches: typeof ruleMatches;
+    selectRoute: typeof selectRoute;
     detectEvent: typeof detectEvent;
+    statusToEvent: typeof statusToEvent;
     extractItem: typeof extractItem;
     meetsMinPriority: typeof meetsMinPriority;
+    parseAssigneeMap: typeof parseAssigneeMap;
+    resolveAssigneeMention: typeof resolveAssigneeMention;
+    resolveItemUrl: typeof resolveItemUrl;
+    isHttpUrl: typeof isHttpUrl;
+    EVENT_META: Record<EventKind, {
+        verb: string;
+        emoji: string;
+    }>;
+    parseStoredItem: typeof parseStoredItem;
+    resolveWindow: typeof resolveWindow;
+    aggregateDigest: typeof aggregateDigest;
+    buildDigestText: typeof buildDigestText;
+    buildDigestBlockKit: typeof buildDigestBlockKit;
+    buildDigestPayload: typeof buildDigestPayload;
+    resolveEffectiveWebhook: typeof resolveEffectiveWebhook;
+    assertWebhookConfigured: typeof assertWebhookConfigured;
     EXIT_CODE: {
         readonly GENERIC_FAILURE: 1;
         readonly USAGE: 2;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAEV,uBAAuB,EAExB,MAAM,uBAAuB,CAAC;AAqB/B,cAAM,YAAa,SAAQ,KAAK;IAC9B,QAAQ,EAAE,MAAM,CAAC;gBACL,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAkC;CAK1E;AAMD,KAAK,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE9B,UAAU,MAAM;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9C,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAmDD,iBAAS,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,CAO7D;AAsDD,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAItE;AA0BD,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAalF;AAUD,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iBAAS,iBAAiB,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE,eAAoB,GACzB;IAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CA+C5C;AA+DD,iBAAS,WAAW,CAAC,GAAG,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI,CAkBnE;AAED,iBAAS,WAAW,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,GAAG,IAAI,CAehE;;;;;;AAMD,wBAoLG;AAGH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;CASpB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}