pm-slack-standup 2026.6.2 → 2026.6.4-1

package/CHANGELOG.md

@@ -1,6 +1,35 @@
 # Changelog
 
-## 2026.6.2 - 2026-06-02
+## 2026.6.4-1 - 2026-06-04
+
+### Added
+
+- preflight: fail-fast Slack-credential gate for standup post path ([pm-slack-standup-qnkp](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/features/pm-slack-standup-qnkp.toon))
+
+## 2026.06.04 - 2026-06-04
+
+### Added
+
+- Blocker inference, yesterday/today split, multi-channel, fallback-to-stdout, custom section labels ([pm-slack-standup-8s6b](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/features/pm-slack-standup-8s6b.toon))
+
+## 2026.06.03 - 2026-06-02
+
+### Added
+
+- Deep feature expansion: multi-format output, grouping, sections, date windows ([pm-slack-standup-h64p](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/features/pm-slack-standup-h64p.toon))
+- Add --days relative date window alongside --since ([pm-slack-standup-5sow](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/tasks/pm-slack-standup-5sow.toon))
+- Add --sections selection/ordering with dedicated Blocked section ([pm-slack-standup-jimx](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/tasks/pm-slack-standup-jimx.toon))
+- Add --group-by sprint and type \(extend assignee/status\) ([pm-slack-standup-f4m6](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/tasks/pm-slack-standup-f4m6.toon))
+- Add --format slack\|blockkit\|markdown\|plain unified output ([pm-slack-standup-dgyy](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/tasks/pm-slack-standup-dgyy.toon))
+
+### Other
+
+- Keep slack message text byte-identical; --format governs printed output only \(blockkit JSON no longer always dumped in dry-run\) ([pm-slack-standup-rttw](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/decisions/pm-slack-standup-rttw.toon))
+- Block Kit schema: single header \(150ch\), one mrkdwn section per bucket \(3000ch truncation\), divider + context footer ([pm-slack-standup-rpty](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/decisions/pm-slack-standup-rpty.toon))
+- Export pure helpers + node:test unit suite \(formatters/grouping/window\) ([pm-slack-standup-uf4j](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/tasks/pm-slack-standup-uf4j.toon))
+- Missing-creds real post -\> CommandError \(exit 1\); no network in dry-run ([pm-slack-standup-m9ze](https://github.com/unbraind/pm-slack-standup/blob/main/.agents/pm/tasks/pm-slack-standup-m9ze.toon))
+
+## 2026.06.02 - 2026-06-02
 
 ### Added
 

package/README.md

@@ -5,12 +5,20 @@ A [pm-cli](https://github.com/unbraind/pm-cli) extension that posts your current
 ## Features
 
 - Posts WIP, Blocked, Up Next (and optional Done) items to Slack as a rich **Block Kit** message (header, one section per bucket, context footer) with an automatic plain-text fallback
-- `pm standup export` — write the standup to a file as Markdown or JSON (the JSON form includes the full Block Kit payload for archiving or re-posting)
-- Group section items by `status` (default) or `assignee` (`--group-by`)
+- **Four output formats** (`--format`): `slack` (Slack mrkdwn, the default), `blockkit` (the raw Block Kit `blocks` JSON), `markdown` (GitHub/CommonMark), and `plain` text
+- **`--dry-run`** — build and print the message in the chosen format **without** posting to Slack (no network call is made)
+- Group section items by `status` (default), `assignee`, `sprint`, or `type` (`--group-by`)
+- Choose which sections to render and in what order with `--sections` (`in_progress`, `blocked`, `done`, `up_next`); a dedicated **Blocked** section always surfaces blocked items
+- **Impediment inference** — the Blocked section surfaces not only `status=blocked` items but any open/in-progress item carrying a `blocked_by` dependency (top-level or in `dependencies[]`), so dependency-blocked work is never hidden
+- **Yesterday/Today split** (`--yesterday`) — split the Done section into **Done Yesterday** / **Done Today** by the local-day boundary (implies `--include-done`)
+- **Multi-channel posting** (`--channels #a,#b`) — post the same standup to several channel names and/or webhook URLs in one run, each message labelled with its own channel
+- **`--fallback-to-stdout`** — if a Slack post fails, print the rendered standup to stdout (exit 0) instead of erroring out, so the work isn't lost on a transport failure
+- **Custom section labels** (`--section-labels`) — override any section's title and/or emoji, e.g. `in_progress=Rolling,blocked=🔥 On Fire`
+- Scope the "recently closed / Done" window with `--since <iso>` **or** `--days <n>` (relative)
 - Map pm authors to Slack handles so they get mentioned (`--mention-map`)
-- Restrict the Done section to a recent window (`--since <iso>`, with `--include-done`)
-- Dry-run mode to preview both the rendered message and the Block Kit JSON
-- Webhook URL configurable via flag or environment variable; missing webhook is a graceful no-op (never blocks a workflow)
+- `pm standup export` — write the standup to a file as Markdown or JSON (the JSON form includes the full Block Kit payload for archiving or re-posting)
+- `--channel` override; webhook URL configurable via flag or environment variable
+- **Fail-fast credential preflight** — when you actually request a Slack post (anything other than `--dry-run`) but no webhook is configured, the command aborts **immediately** with a clear, actionable, non-zero error (exit 2) **before** reading any pm data or rendering anything — no half-built message, no crash. The non-posting `--dry-run` preview path is never gated, so previewing without credentials keeps working. See [Credential preflight](#credential-preflight).
 
 ## Installation
 
@@ -58,12 +66,35 @@ pm standup [flags]
 |------|------|---------|-------------|
 | `--webhook <url>` | string | — | Slack incoming webhook URL (overrides `PM_SLACK_WEBHOOK`) |
 | `--channel <name>` | string | — | Channel name shown in the message (e.g. `#team-eng`) |
-| `--dry-run` | boolean | `false` | Print the rendered message and the Block Kit JSON without posting |
+| `--dry-run` | boolean | `false` | Build and print the message in the chosen format **without** posting |
+| `--format <fmt>` | string | `slack` | Output format: `slack` (mrkdwn) \| `blockkit` (JSON) \| `markdown` \| `plain` |
 | `--include-done` | boolean | `false` | Include recently-closed items in a Done section |
-| `--since <iso>` | string | — | ISO date/time window; filters the Done section to items updated since then |
-| `--group-by <status\|assignee>` | string | `status` | Group section items by status (default) or assignee |
+| `--since <iso>` | string | — | ISO date/time window; scopes the Done section to items updated since then |
+| `--days <n>` | number | — | Relative window: scope Done to items updated in the last N days (combines with `--since`, more restrictive bound wins) |
+| `--group-by <field>` | string | `status` | Group section items by `status` \| `assignee` \| `sprint` \| `type` |
+| `--sections <list>` | string | all | Comma list of sections to render/order: `in_progress`, `blocked`, `done`, `up_next` |
 | `--mention-map <map>` | string | — | Map pm authors to Slack handles, e.g. `alice=@alice,bob=@bob` |
-| `--format <slack\|text>` | string | `slack` | Plain-text rendering used for the fallback / preview |
+| `--yesterday` | boolean | `false` | Split Done into **Done Yesterday** / **Done Today** by local day (implies `--include-done`) |
+| `--channels <list>` | string | — | Post the same standup to multiple targets: comma list of `#channel` names and/or full webhook URLs |
+| `--fallback-to-stdout` | boolean | `false` | If the Slack post fails, print the rendered standup to stdout (exit 0) instead of erroring |
+| `--section-labels <map>` | string | — | Override section titles/emoji, e.g. `in_progress=Rolling,blocked=🔥 On Fire` |
+
+> **Note on `text`:** the legacy `--format text` value is still accepted as an alias for `plain`.
+
+### Output formats
+
+`--format` selects what the command prints (in `--dry-run`) and how it renders the Slack message text:
+
+- **`slack`** (default) — Slack mrkdwn (`*bold*`, `_italic_`). The message posted to Slack is unchanged from previous versions.
+- **`blockkit`** — the raw Slack Block Kit `{ "blocks": [...] }` JSON, ready to POST to `chat.postMessage` or paste into Block Kit Builder.
+- **`markdown`** — GitHub/CommonMark with `#`/`##` headings and `-` bullets, for issues, wikis, or PR comments.
+- **`plain`** — emphasis-free plain text for email or terminals.
+
+```bash
+pm standup --dry-run --format blockkit                 # raw Block Kit JSON
+pm standup --dry-run --format markdown --include-done   # CommonMark
+pm standup --dry-run --format plain --days 7            # plain text, last 7 days
+```
 
 ## Export
 
@@ -96,7 +127,33 @@ pm standup --channel '#team-eng' --dry-run
 
 **Include done items and use plain text format:**
 ```bash
-pm standup --include-done --format text
+pm standup --include-done --format plain
+```
+
+**Group by sprint, only In Progress + Blocked:**
+```bash
+pm standup --dry-run --group-by sprint --sections in_progress,blocked
+```
+
+**Split Done by yesterday/today:**
+```bash
+pm standup --dry-run --yesterday --format plain
+```
+
+**Post to multiple channels at once:**
+```bash
+pm standup --channels '#team-eng,#standups'
+pm standup --channels 'https://hooks.slack.com/services/AAA,https://hooks.slack.com/services/BBB'
+```
+
+**Never lose the standup if Slack is down:**
+```bash
+pm standup --fallback-to-stdout   # prints the message to stdout (exit 0) if the post fails
+```
+
+**Rename sections / change emoji:**
+```bash
+pm standup --dry-run --section-labels 'in_progress=Rolling,blocked=🔥 On Fire'
 ```
 
 **Full explicit invocation:**
@@ -132,7 +189,7 @@ pm standup \
 • [Chore] Update dependencies (priority 3)
 ```
 
-### Plain Text (`--format text`)
+### Plain Text (`--format plain`)
 
 ```
 📊 pm standup — 2026-05-09
@@ -150,6 +207,31 @@ pm standup \
 • [Chore] Update dependencies (priority 3)
 ```
 
+## Credential preflight
+
+Before any post is attempted, `pm standup` runs a **fail-fast credential gate**:
+
+- **A post is "requested"** whenever you do *not* pass `--dry-run`. (`--fallback-to-stdout` still counts as a post — it only changes how a *transport* failure is handled; it still needs a webhook to attempt delivery.)
+- **The gate fires only when** a post is requested **and** no usable webhook is configured. A webhook is "configured" if `--webhook` or `PM_SLACK_WEBHOOK` is set, **or** every `--channels` target is a full webhook URL (bare `#name` channels still need the base webhook).
+- **When it fires**, the command aborts **immediately** — before reading any pm items or rendering anything — with a clear, actionable error and a **non-zero exit (2 / usage)**. Nothing is posted.
+- **When it does not fire** (a webhook is present, *or* you used `--dry-run`), the command proceeds exactly as before.
+
+```bash
+# Post requested, no webhook → immediate abort (exit 2), nothing posted:
+pm standup --channel '#team-eng'
+#   Slack post requested but no webhook is configured. Set PM_SLACK_WEBHOOK or
+#   pass --webhook <url> (or provide full webhook URLs via --channels).
+#   To preview without posting, use --dry-run.
+
+# Preview without credentials → always allowed (exit 0):
+pm standup --dry-run
+
+# With a webhook → preflight passes, the post proceeds:
+PM_SLACK_WEBHOOK=https://hooks.slack.com/services/... pm standup --channel '#team-eng'
+```
+
+This is implemented in the `standup` command handler (where a thrown error reliably aborts with a non-zero exit); the package also declares the `preflight` capability and registers a scoped pass-through preflight hook for the standup command.
+
 ## Environment Variables
 
 | Variable | Description |
@@ -173,10 +255,10 @@ npm run dev   # watch mode
 
 ## How It Works
 
-1. Reads every item once via `pm --path <root> list-all --json --include-body` and buckets them locally into In Progress, Blocked, open (Up Next) and optionally Done.
+1. Reads every item once via `pm --path <root> list-all --json --include-body` and buckets them locally into In Progress, Blocked, open (Up Next) and optionally Done. Any open/in-progress item with a `blocked_by` dependency (top-level or in `dependencies[]`) is re-bucketed into Blocked; closed items are never re-surfaced as blocked.
 2. Sorts open items by priority (ascending) and takes the top 3 as "Up Next".
-3. Builds a Slack Block Kit `blocks` array (header + a section per bucket + context footer) plus a plain-text `fallback`, optionally grouped by assignee and annotated with Slack mentions.
-4. Posts `{ text, blocks }` to the configured Slack webhook using Node.js native `https`. A missing webhook or a network failure is a non-blocking no-op (warns and exits 0).
+3. Builds a Slack Block Kit `blocks` array (header + a section per bucket + context footer) plus a plain-text `fallback`, optionally grouped by assignee and annotated with Slack mentions. Section titles/emoji can be overridden with `--section-labels`, and `--yesterday` expands Done into Done Yesterday / Done Today.
+4. In `--dry-run`, prints the message in the chosen `--format` and exits without any network call. Otherwise posts `{ text, blocks }` to each target (the base webhook plus any `--channels`) using Node.js native `https`. A missing webhook (on a real post) raises a structured `CommandError`; a failed post does too **unless** `--fallback-to-stdout` is set, in which case the rendered standup is printed to stdout and the command exits 0.
 
 ## License
 

package/dist/index.d.ts

@@ -1,3 +1,271 @@
+export declare class CommandError extends Error {
+    exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export interface PmDependency {
+    id?: string;
+    kind?: string;
+    [key: string]: unknown;
+}
+export interface PmItem {
+    id: string;
+    title: string;
+    status: string;
+    type?: string;
+    priority?: number;
+    tags?: string[];
+    milestone?: string;
+    release?: string;
+    sprint?: string;
+    assignee?: string;
+    author?: string;
+    body?: string;
+    created_at?: string;
+    updated_at?: string;
+    blocked_by?: string;
+    dependencies?: PmDependency[];
+}
+export type Format = "slack" | "blockkit" | "markdown" | "plain";
+export type GroupBy = "status" | "assignee" | "sprint" | "type";
+export type SectionKey = "in_progress" | "blocked" | "done" | "up_next";
+export declare const ALL_SECTIONS: readonly SectionKey[];
+export interface StandupData {
+    wip: PmItem[];
+    blocked: PmItem[];
+    done: PmItem[];
+    upNext: PmItem[];
+    total: number;
+    doneYesterday?: PmItem[];
+    doneToday?: PmItem[];
+}
+export interface StandupOptions {
+    channel?: string;
+    format: Format;
+    includeDone: boolean;
+    since?: string;
+    groupBy: GroupBy;
+    sections: SectionKey[];
+    mentionMap: Record<string, string>;
+    splitYesterday: boolean;
+    sectionLabels: Partial<Record<SectionKey, SectionLabelOverride>>;
+}
+export interface SectionLabelOverride {
+    emoji?: string;
+    title?: string;
+}
+export declare function readBoolOption(options: Record<string, unknown>, key: string): boolean;
+export declare function readStrOption(options: Record<string, unknown>, key: string): string | undefined;
+/**
+ * Parse a `--mention-map` spec mapping pm authors to Slack handles.
+ * Accepts `author=@handle,other=@h2` (commas) or semicolon separators.
+ * A leading `@` on the handle is optional and normalized on.
+ */
+export declare function parseMentionMap(spec: string | undefined): Record<string, string>;
+/**
+ * Normalize a `--format` value. Accepts the four public formats plus the
+ * legacy `text` alias (== `plain`). Unknown values raise a USAGE CommandError.
+ */
+export declare function parseFormat(raw: string | undefined): Format;
+export declare function parseGroupBy(raw: string | undefined): GroupBy;
+/**
+ * Parse a `--sections` spec (comma/semicolon list) into an ordered, de-duped
+ * list of section keys. Empty spec → all sections in default order. An
+ * unknown token is a USAGE error rather than a silent drop.
+ */
+export declare function parseSections(spec: string | undefined): SectionKey[];
+/**
+ * Parse a `--section-labels` spec overriding section titles (and optionally
+ * an emoji). Accepts `key=Label,other=Label2` (comma/semicolon separated).
+ * The label value may itself lead with an emoji + space, e.g.
+ * `blocked=🔥 On Fire` sets emoji "🔥" and title "On Fire"; a label with no
+ * leading emoji keeps the section's default emoji and only changes the title.
+ * Keys use the same aliases as `--sections` (wip→in_progress, etc.).
+ * Unknown keys are a USAGE error rather than a silent drop.
+ */
+export declare function parseSectionLabels(spec: string | undefined): Partial<Record<SectionKey, SectionLabelOverride>>;
+/**
+ * Parse a `--channels` spec (comma/semicolon list) into an ordered, de-duped
+ * list of channel targets. Each target is either a Slack channel name
+ * (e.g. `#team-eng`) or a full webhook URL — multi-channel posting accepts
+ * both (a name is shown in the message; a URL is POSTed to). Empty → [].
+ */
+export declare function parseChannels(spec: string | undefined): string[];
+/** True when a channel token is a full webhook URL rather than a name. */
+export declare function isWebhookUrl(token: string): boolean;
+/**
+ * Resolve the "recently closed" window start (ms epoch) from `--since` and/or
+ * `--days`. `--since` is an explicit ISO date/time; `--days <n>` is N days
+ * before now. If both are given the *later* (more restrictive) bound wins.
+ * Returns NaN when neither is set (no windowing). Invalid input → USAGE error.
+ */
+export declare function resolveSinceMs(since: string | undefined, days: number | undefined, now?: number): number;
+export declare function parseDays(raw: string | undefined): number | undefined;
+/**
+ * Read every item once via `list-all --json --include-body`, then bucket by
+ * status locally. This is a single pm invocation (vs. four list-by-status
+ * calls) and gives us bodies + assignee + timestamps for grouping/windowing.
+ */
+export declare function fetchAllItems(pmRoot: string): PmItem[];
+/**
+ * True when an item's last activity falls within the [sinceMs, now] window.
+ * NaN sinceMs means "no window" → always true.
+ */
+export declare function withinWindow(item: PmItem, sinceMs: number): boolean;
+/**
+ * True when an item carries a `blocked_by` dependency, regardless of its
+ * status. pm surfaces this either as a top-level `blocked_by` string (item ID
+ * or free-text reason) or as one/more `dependencies` entries with
+ * `kind: "blocked_by"`. Used to surface impediments that are NOT explicitly
+ * status=blocked under the Blocked section.
+ */
+export declare function hasBlockedByDep(item: PmItem): boolean;
+/**
+ * Local-day key (YYYY-MM-DD in the host's local timezone) for an item's last
+ * activity. Used by the `--yesterday` split. Falls back to created_at, then
+ * to the empty string when no timestamp is parseable.
+ */
+export declare function localDayKey(item: PmItem): string;
+/** Local-day key (YYYY-MM-DD) for a given epoch-ms instant. */
+export declare function localDayKeyOf(ms: number): string;
+/**
+ * Bucket items into standup sections.
+ * `sinceMs` (epoch ms, NaN = no window) filters the Done section to items
+ * updated within the window; WIP/blocked/up-next always reflect current state.
+ */
+export declare function buildStandupData(items: PmItem[], opts: StandupOptions, sinceMs?: number, now?: number): StandupData;
+interface SectionDef {
+    key: SectionKey;
+    emoji: string;
+    title: string;
+    items: PmItem[];
+    emptyNote: string | null;
+    withPriority: boolean;
+}
+/**
+ * Resolve the ordered, selected section definitions for the given data.
+ * `in_progress` and `blocked` always render (even empty, with their note);
+ * `done` and `up_next` only render when they hold items — preserving the
+ * historical message shape. `--sections` filters which keys are eligible.
+ *
+ * When `--yesterday` is active and Done has items, the single Done section is
+ * expanded into "Done Yesterday" + "Done Today" (only the non-empty subsets
+ * render), preserving the section's position in the ordering.
+ */
+export declare function resolveSections(data: StandupData, opts: StandupOptions): SectionDef[];
+export declare function itemText(item: PmItem, mentionMap: Record<string, string>, withPriority?: boolean): string;
+/**
+ * Group a list of items by the configured field (assignee, sprint or type).
+ * Items missing the field bucket under a synthetic "_none" key (rendered as a
+ * friendly label). Returns entries sorted by group key for stable output.
+ */
+export declare function groupItems(items: PmItem[], groupBy: GroupBy): Array<[string, PmItem[]]>;
+/**
+ * Render the standup as a single text blob for the chosen non-Block-Kit
+ * format. `slack` is byte-identical to the historical output (mrkdwn);
+ * `plain` drops emphasis punctuation; `markdown` uses `#`/`**`/`-`.
+ */
+export declare function buildTextMessage(data: StandupData, opts: StandupOptions): string;
+export interface SlackBlock {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * Build a Slack Block Kit `blocks` array: a header, a section per selected
+ * standup bucket and a context footer. Returns the blocks plus a plain-text
+ * `fallback` Slack renders in notifications and old clients.
+ *
+ * Block Kit schema choices: a single `header` block (plain_text, capped at
+ * Slack's 150-char limit), one `section`/`mrkdwn` block per bucket (Slack
+ * caps section text at 3000 chars — long buckets are truncated with an
+ * ellipsis to stay valid), a `divider`, then a `context` footer summarizing
+ * counts / window / grouping.
+ */
+export declare function buildBlockKit(data: StandupData, opts: StandupOptions): {
+    blocks: SlackBlock[];
+    fallback: string;
+};
+/**
+ * Render the standup in whichever `--format` was selected, as the string the
+ * command prints (dry-run) or the exporter writes. `blockkit` returns the
+ * pretty-printed `{ blocks }` JSON; everything else returns text.
+ */
+export declare function renderStandup(data: StandupData, opts: StandupOptions): string;
+/** One resolved post target: the webhook URL to POST to + the channel name. */
+export interface PostTarget {
+    webhookUrl: string;
+    /** Channel name shown in the message (may differ per target). */
+    channel?: string;
+}
+export interface PostResultEntry {
+    channel?: string;
+    ok: boolean;
+    error?: string;
+}
+/** A poster sends one payload to one webhook. Injectable for testing. */
+export type Poster = (webhookUrl: string, payload: Record<string, unknown>) => Promise<void>;
+/**
+ * Resolve the ordered list of post targets from `--webhook`/env + `--channel`
+ * + `--channels`. Each `--channels` token is either a `#name` (posted to the
+ * base webhook, just changing the displayed channel) or a full webhook URL
+ * (posted to that URL). When no `--channels` is given, a single target using
+ * the base webhook + `--channel` is returned. De-dupes (webhook,channel) pairs.
+ */
+export declare function resolvePostTargets(baseWebhook: string, baseChannel: string | undefined, channels: string[]): PostTarget[];
+/**
+ * Post the standup to every resolved target, re-rendering per target so each
+ * channel's message shows its own channel name. Returns a per-target result;
+ * never throws — the caller decides how to treat failures (e.g. fallback to
+ * stdout). The `poster` is injectable so this is testable without a network.
+ */
+export declare function postStandupTargets(targets: PostTarget[], data: StandupData, baseOpts: StandupOptions, poster: Poster): Promise<PostResultEntry[]>;
+/**
+ * Decide whether the `standup` invocation is actually going to *post* to Slack.
+ *
+ * The command has two non-posting shapes that must NOT be gated:
+ *   - `--dry-run`           : build + print the message, never touches Slack.
+ * Every other shape is a real post attempt (the default), including
+ * `--fallback-to-stdout` — that flag only means "print instead of erroring *if
+ * the network post fails*", it still REQUIRES a webhook to attempt the post.
+ */
+export declare function isPostRequested(options: Record<string, unknown>): boolean;
+/**
+ * Resolve whether a *base* Slack webhook is required for this post. `--channels`
+ * may carry full webhook URLs that are self-sufficient targets; but if there is
+ * no `--channels` at all, or any `--channels` entry is a bare `#name`, the base
+ * webhook (`--webhook` / `PM_SLACK_WEBHOOK`) is needed to actually deliver.
+ */
+export declare function needsBaseWebhook(channels: string[]): boolean;
+/**
+ * Fail-fast credential preflight for the standup *post* path.
+ *
+ * Fires ONLY when a Slack post is actually requested (not `--dry-run`) AND the
+ * credentials needed to deliver it are missing. In that case it throws a
+ * structured {@link CommandError} (USAGE / exit 2) BEFORE any pm data is read
+ * or any message is rendered — a clean, actionable, non-zero abort.
+ *
+ * It deliberately does NOT block the legitimate non-posting shapes:
+ *   - `--dry-run` (preview to stdout) is never gated.
+ * This keeps the existing stdout-fallback behaviour intact while turning a
+ * "we got all the way to the transport layer and then discovered there's no
+ * webhook" failure into an immediate, obvious one.
+ *
+ * NOTE: this is invoked from the command HANDLER (not from `registerPreflight`)
+ * on purpose. pm's runtime wraps `registerPreflight` overrides in a try/catch
+ * and downgrades any thrown error to a non-fatal warning, so a throw there does
+ * NOT abort the command. Throwing from the handler is the only reliable way to
+ * fail-fast with a non-zero exit. The `registerPreflight` registration below is
+ * a scoped pass-through that exists to surface the `preflight` capability.
+ */
+export declare function preflightSlackCredentials(options: Record<string, unknown>): void;
+/**
+ * Resolve every standup option except the render `format`, which differs
+ * between the command (slack|blockkit|markdown|plain) and the exporter
+ * (md|json file format). Callers supply the format they want.
+ */
+export declare function resolveStandupOptions(options: Record<string, unknown>, format: Format): {
+    opts: StandupOptions;
+    sinceMs: number;
+};
 declare const _default: {
     name: string;
     version: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;AA2aA,wBAuJG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}