crewly 1.20.178 → 1.20.180

package/dist/backend/backend/src/services/decisions/decision-card.js

@@ -0,0 +1,311 @@
+/**
+ * Decision cards — Block Kit rendering and answer parsing
+ * (specs/2026-10-01-decision-cards.md §3). Pure.
+ *
+ * @module services/decisions/decision-card
+ */
+import { DECISION_CONSTANTS } from '../../constants.js';
+import { matchOption } from './decision-contract.js';
+const DAYS = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+/**
+ * Short local time for the card: "14:05" today, "tomorrow 12:00", else "Thu Oct 2 12:00".
+ *
+ * @param at - Moment
+ * @param now - Clock
+ * @returns Text
+ */
+export function formatWhen(at, now = new Date()) {
+    const hm = `${String(at.getHours()).padStart(2, '0')}:${String(at.getMinutes()).padStart(2, '0')}`;
+    const day = (d) => `${d.getFullYear()}-${d.getMonth()}-${d.getDate()}`;
+    if (day(at) === day(now))
+        return hm;
+    const tomorrow = new Date(now.getTime());
+    tomorrow.setDate(tomorrow.getDate() + 1);
+    if (day(at) === day(tomorrow))
+        return `tomorrow ${hm}`;
+    return `${DAYS[at.getDay()]} ${MONTHS[at.getMonth()]} ${at.getDate()} ${hm}`;
+}
+/**
+ * The label of the default, as the card says it ("wait" for none).
+ *
+ * @param d - Decision
+ * @returns Option label, or "wait"
+ */
+export function defaultLabel(d) {
+    return d.options.find((o) => o.key === d.defaultKey)?.label ?? DECISION_CONSTANTS.WAIT_DEFAULT;
+}
+/**
+ * The label of an option key.
+ *
+ * @param d - Decision
+ * @param key - Option key
+ * @returns Label (the key itself when unknown)
+ */
+export function optionLabel(d, key) {
+    return d.options.find((o) => o.key === key)?.label ?? String(key ?? '');
+}
+/**
+ * The card header: ticket id + title, else the asker's topic.
+ *
+ * @param d - Decision
+ * @returns Header text (≤ 150 characters, Slack's header limit)
+ */
+export function cardHeader(d) {
+    const text = d.ticket ? `${d.ticket.id} · ${d.ticket.title}` : `Decision ${d.id}`;
+    return text.length > 150 ? `${text.slice(0, 149)}…` : text;
+}
+/**
+ * The thread root for a ticket that has no thread yet.
+ *
+ * @param ticket - Ticket id + title
+ * @returns mrkdwn line
+ */
+export function ticketThreadRootText(ticket) {
+    return `*${ticket.id} · ${ticket.title}*`;
+}
+/**
+ * Button value JSON.
+ *
+ * @param decisionId - Decision id
+ * @param option - Option key or `remind`
+ * @param instanceId - This instance (Cloud routes the click by it)
+ * @returns JSON string
+ */
+export function buttonValue(decisionId, option, instanceId) {
+    const v = { d: decisionId, o: option, i: instanceId };
+    return JSON.stringify(v);
+}
+/**
+ * Parse a button value.
+ *
+ * @param raw - `value` of the clicked button
+ * @returns The value, or null when it is not a decision button
+ */
+export function parseButtonValue(raw) {
+    if (typeof raw !== 'string' || !raw.startsWith('{'))
+        return null;
+    try {
+        const v = JSON.parse(raw);
+        if (typeof v.d !== 'string' || typeof v.o !== 'string')
+            return null;
+        return { d: v.d, o: v.o, i: typeof v.i === 'string' ? v.i : '' };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The context line of a pending card.
+ *
+ * @param d - Decision
+ * @param now - Clock
+ * @returns mrkdwn text
+ */
+export function pendingContextLine(d, now = new Date()) {
+    const when = formatWhen(new Date(d.deadline), now);
+    const parts = [];
+    if (d.remindAt && Date.parse(d.remindAt) > now.getTime()) {
+        parts.push(`⏰ Reminding you ${formatWhen(new Date(d.remindAt), now)}.`);
+    }
+    if (d.sensitive) {
+        parts.push(`This needs your OK (${d.sensitive}); I won't go ahead without an answer.`);
+    }
+    else if (d.defaultKey === DECISION_CONSTANTS.WAIT_DEFAULT) {
+        parts.push(`If no answer by ${when}, I'll keep waiting.`);
+    }
+    else {
+        parts.push(`If no answer by ${when}, I'll go with ${defaultLabel(d)}.`);
+    }
+    parts.push(d.id);
+    return parts.join(' · ');
+}
+/**
+ * The option lines under the question (only when some option has a detail).
+ *
+ * @param options - Options
+ * @returns mrkdwn, or null
+ */
+function optionDetails(options) {
+    if (!options.some((o) => o.detail))
+        return null;
+    return options.map((o) => `• *${o.label}*${o.detail ? ` — ${o.detail}` : ''}`).join('\n');
+}
+/**
+ * Blocks of an open card.
+ *
+ * @param d - Decision
+ * @param instanceId - This instance id (button values)
+ * @param now - Clock
+ * @returns Blocks
+ */
+export function renderOpenCard(d, instanceId, now = new Date()) {
+    const blocks = [
+        { type: 'header', text: { type: 'plain_text', text: cardHeader(d), emoji: true } },
+        { type: 'section', text: { type: 'mrkdwn', text: d.question } },
+    ];
+    const details = optionDetails(d.options);
+    if (details)
+        blocks.push({ type: 'section', text: { type: 'mrkdwn', text: details } });
+    blocks.push({
+        type: 'actions',
+        block_id: `decision:${d.id}`,
+        elements: [
+            ...d.options.map((o) => ({
+                type: 'button',
+                action_id: `${DECISION_CONSTANTS.ACTION_PREFIX}${o.key}`,
+                text: { type: 'plain_text', text: o.label, emoji: true },
+                value: buttonValue(d.id, o.key, instanceId),
+                ...(o.key === d.defaultKey && !d.sensitive ? { style: 'primary' } : {}),
+            })),
+            {
+                type: 'button',
+                action_id: DECISION_CONSTANTS.REMIND_ACTION_ID,
+                text: { type: 'plain_text', text: 'Remind me tomorrow', emoji: true },
+                value: buttonValue(d.id, 'remind', instanceId),
+            },
+        ],
+    });
+    blocks.push({ type: 'context', elements: [{ type: 'mrkdwn', text: pendingContextLine(d, now) }] });
+    return blocks;
+}
+/**
+ * Blocks of a settled card (no buttons).
+ *
+ * @param d - Decision (resolved / defaulted / parked / cancelled)
+ * @param ownerName - How to name the owner ("Steve"), when known
+ * @param now - Clock
+ * @returns Blocks
+ */
+export function renderSettledCard(d, ownerName, now = new Date()) {
+    return [
+        { type: 'header', text: { type: 'plain_text', text: cardHeader(d), emoji: true } },
+        { type: 'section', text: { type: 'mrkdwn', text: d.question } },
+        { type: 'context', elements: [{ type: 'mrkdwn', text: settledLine(d, ownerName, now) }] },
+    ];
+}
+/**
+ * The one line a settled card shows.
+ *
+ * @param d - Decision
+ * @param ownerName - Owner display name
+ * @param now - Clock
+ * @returns Text
+ */
+export function settledLine(d, ownerName, now = new Date()) {
+    const at = formatWhen(new Date(d.resolvedAt ?? d.updatedAt), now);
+    const who = ownerName || (d.answeredBy ? `<@${d.answeredBy}>` : 'The owner');
+    switch (d.status) {
+        case 'resolved':
+            return d.chosenKey
+                ? `✔ ${who} chose *${optionLabel(d, d.chosenKey)}* · ${at}`
+                : `✔ ${who} answered: “${(d.answerText ?? '').slice(0, 200)}” · ${at}`;
+        case 'defaulted':
+            return deadlineDefaultLine(d, now);
+        case 'parked':
+            return `⏸ Parked — no answer, so I'm not going ahead. Answer from "Waiting on you" to reopen it. · ${d.id}`;
+        case 'cancelled':
+            return `Withdrawn · ${at}`;
+        default:
+            return pendingContextLine(d, now);
+    }
+}
+/**
+ * "No answer by <deadline> — going with <default>." (or "— still waiting." for `wait`).
+ *
+ * @param d - Decision
+ * @param now - Clock
+ * @returns Text
+ */
+export function deadlineDefaultLine(d, now = new Date()) {
+    const when = formatWhen(new Date(d.deadline), now);
+    return d.defaultKey === DECISION_CONSTANTS.WAIT_DEFAULT
+        ? `No answer by ${when} — I'll keep waiting.`
+        : `No answer by ${when} — going with ${defaultLabel(d)}.`;
+}
+/**
+ * The plain-text fallback of a card (notifications, screen readers).
+ *
+ * @param d - Decision
+ * @returns Text
+ */
+export function cardFallbackText(d) {
+    return `${cardHeader(d)}: ${d.question} (${d.options.map((o) => o.label).join(' / ')})`;
+}
+/**
+ * The option that reads as "no", when one does.
+ *
+ * @param options - Options
+ * @returns Option, or null
+ */
+export function noOption(options) {
+    const words = DECISION_CONSTANTS.NO_WORDS;
+    return (options.find((o) => {
+        const l = o.label.toLowerCase().trim();
+        return words.includes(l) || words.includes(l.split(/[\s,—–-]+/)[0]) || words.some((w) => /[^\x00-\x7F]/.test(w) && l.startsWith(w));
+    }) ?? null);
+}
+/**
+ * The option ✅ / "yes" means: the default, else the first option.
+ *
+ * @param d - Decision
+ * @returns Option key
+ */
+export function acceptKey(d) {
+    return d.options.some((o) => o.key === d.defaultKey) ? d.defaultKey : d.options[0].key;
+}
+/**
+ * Map a reaction on a card to a choice.
+ *
+ * @param d - Decision
+ * @param reaction - Emoji name (no colons; skin tone suffix allowed)
+ * @returns Choice, or null when the reaction means nothing
+ */
+export function choiceFromReaction(d, reaction) {
+    const name = reaction.replace(/::skin-tone-\d$/, '');
+    if (DECISION_CONSTANTS.REACTION_ACCEPT.includes(name))
+        return { kind: 'option', key: acceptKey(d) };
+    if (DECISION_CONSTANTS.REACTION_REMIND.includes(name))
+        return { kind: 'remind' };
+    if (DECISION_CONSTANTS.REACTION_REJECT.includes(name)) {
+        const no = noOption(d.options);
+        return no ? { kind: 'option', key: no.key } : null;
+    }
+    return null;
+}
+/**
+ * Map a free-text thread reply to a choice: an option (label, key, number),
+ * a yes word (the default / first option), a no word (the "no" option), a
+ * remind word — else the text itself, for the asker to read.
+ *
+ * @param d - Decision
+ * @param text - The owner's reply
+ * @returns Choice, or null for an empty reply
+ */
+export function choiceFromText(d, text) {
+    const clean = text.replace(/<@[A-Z0-9]+>/g, '').replace(/\s+/g, ' ').trim();
+    if (!clean)
+        return null;
+    const opt = matchOption(clean, d.options);
+    if (opt)
+        return { kind: 'option', key: opt.key };
+    const norm = clean.toLowerCase().replace(/[\s.。!！,，]+$/u, '');
+    if (DECISION_CONSTANTS.REMIND_WORDS.includes(norm))
+        return { kind: 'remind' };
+    if (DECISION_CONSTANTS.YES_WORDS.includes(norm))
+        return { kind: 'option', key: acceptKey(d) };
+    if (DECISION_CONSTANTS.NO_WORDS.includes(norm)) {
+        const no = noOption(d.options);
+        if (no)
+            return { kind: 'option', key: no.key };
+    }
+    // "go with Hold", "option 2", "let's do B"
+    const tail = /^(?:go with|option|choose|pick|let'?s do|do|选)\s*(.+)$/i.exec(norm);
+    if (tail) {
+        const o = matchOption(tail[1], d.options);
+        if (o)
+            return { kind: 'option', key: o.key };
+    }
+    return { kind: 'text', text: clean };
+}
+//# sourceMappingURL=decision-card.js.map

package/dist/backend/backend/src/services/decisions/decision-card.js.map

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

package/dist/backend/backend/src/services/decisions/decision-contract.d.ts

@@ -0,0 +1,83 @@
+/**
+ * The ask-owner contract (specs/2026-10-01-decision-cards.md §1): validate a
+ * structured owner question and turn it into a {@link ValidatedAsk}. Pure.
+ *
+ * Every rejection says what to fix and shows a correct ask, because the
+ * reader is an agent that will retry with whatever the error tells it.
+ *
+ * @module services/decisions/decision-contract
+ */
+import type { AskOwnerInput, DecisionOption, DecisionSensitiveKind, ValidatedAsk } from '../../types/decision.types.js';
+/** A rejected ask. */
+export declare class DecisionContractError extends Error {
+    constructor(message: string);
+}
+/** The example appended to every contract error. */
+export declare const ASK_OWNER_EXAMPLE = "Example: ask-owner --question \"Send the partner email on Monday?\" --option \"Send Monday \u2014 after the review call\" --option \"Hold \u2014 wait for legal\" --default \"Hold\" [--deadline 2026-10-02T12:00] [--ticket APP-12 --project P] [--sensitive email]";
+/**
+ * The next day at {@link DECISION_CONSTANTS.DEFAULT_DEADLINE_HOUR_LOCAL}:00 local.
+ *
+ * @param now - Clock
+ * @returns Default deadline
+ */
+export declare function defaultDeadline(now: Date): Date;
+/**
+ * Whether a question is too vague to put in front of the owner.
+ *
+ * @param question - One-line question
+ * @returns True for "thoughts?", "OK?", "可以吗" and the like
+ */
+export declare function isVagueQuestion(question: string): boolean;
+/**
+ * Parse the options: an array of `{label, detail?}` objects or of strings
+ * (`"Label"` / `"Label — detail"`).
+ *
+ * @param raw - Input
+ * @returns Options with keys a/b/c
+ * @throws DecisionContractError
+ */
+export declare function parseOptions(raw: unknown): DecisionOption[];
+/**
+ * Resolve the default to an option key or `wait`.
+ *
+ * @param raw - Label, key (a/b/c), number (1–3) or `wait`
+ * @param options - Parsed options
+ * @returns Option key or `wait`
+ * @throws DecisionContractError
+ */
+export declare function resolveDefault(raw: unknown, options: DecisionOption[]): string;
+/**
+ * Find the option a label, key (a/b/c) or number (1–3) names.
+ *
+ * @param text - What was given
+ * @param options - Options
+ * @returns The option, or null
+ */
+export declare function matchOption(text: string, options: DecisionOption[]): DecisionOption | null;
+/**
+ * Parse the deadline.
+ *
+ * @param raw - ISO / date-time string, or empty for the default
+ * @param now - Clock
+ * @returns The deadline
+ * @throws DecisionContractError when unreadable or not in the future
+ */
+export declare function parseDeadline(raw: unknown, now: Date): Date;
+/**
+ * Parse the sensitive kind.
+ *
+ * @param raw - `email` | `publish` | `deploy` | `spend`, or empty
+ * @returns The kind, or undefined
+ * @throws DecisionContractError on anything else
+ */
+export declare function parseSensitive(raw: unknown): DecisionSensitiveKind | undefined;
+/**
+ * Validate a whole ask.
+ *
+ * @param input - Raw input (skill / API body)
+ * @param now - Clock
+ * @returns The validated ask
+ * @throws DecisionContractError with a fix-it message
+ */
+export declare function validateAskOwner(input: AskOwnerInput, now?: Date): ValidatedAsk;
+//# sourceMappingURL=decision-contract.d.ts.map

package/dist/backend/backend/src/services/decisions/decision-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-contract.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/decisions/decision-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAExH,sBAAsB;AACtB,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,yQACwN,CAAC;AAiBvP;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAK/C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,EAAE,CA8C3D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAa9E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,GAAG,IAAI,CAa1F;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAQ3D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAO9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,GAAE,IAAiB,GAAG,YAAY,CA+B3F"}

package/dist/backend/backend/src/services/decisions/decision-contract.js

@@ -0,0 +1,226 @@
+/**
+ * The ask-owner contract (specs/2026-10-01-decision-cards.md §1): validate a
+ * structured owner question and turn it into a {@link ValidatedAsk}. Pure.
+ *
+ * Every rejection says what to fix and shows a correct ask, because the
+ * reader is an agent that will retry with whatever the error tells it.
+ *
+ * @module services/decisions/decision-contract
+ */
+import { DECISION_CONSTANTS } from '../../constants.js';
+/** A rejected ask. */
+export class DecisionContractError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DecisionContractError';
+    }
+}
+/** The example appended to every contract error. */
+export const ASK_OWNER_EXAMPLE = 'Example: ask-owner --question "Send the partner email on Monday?" --option "Send Monday — after the review call" --option "Hold — wait for legal" --default "Hold" [--deadline 2026-10-02T12:00] [--ticket APP-12 --project P] [--sensitive email]';
+const OPTION_KEYS = ['a', 'b', 'c'];
+/** Separators accepted between an option's label and its detail in a string form. */
+const DETAIL_SEPARATOR = /\s+(?:—|–|--|-|:)\s+/;
+/**
+ * Collapse whitespace.
+ *
+ * @param s - Text
+ * @returns One trimmed line
+ */
+function oneLine(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+/**
+ * The next day at {@link DECISION_CONSTANTS.DEFAULT_DEADLINE_HOUR_LOCAL}:00 local.
+ *
+ * @param now - Clock
+ * @returns Default deadline
+ */
+export function defaultDeadline(now) {
+    const d = new Date(now.getTime());
+    d.setDate(d.getDate() + 1);
+    d.setHours(DECISION_CONSTANTS.DEFAULT_DEADLINE_HOUR_LOCAL, 0, 0, 0);
+    return d;
+}
+/**
+ * Whether a question is too vague to put in front of the owner.
+ *
+ * @param question - One-line question
+ * @returns True for "thoughts?", "OK?", "可以吗" and the like
+ */
+export function isVagueQuestion(question) {
+    const core = question.toLowerCase().replace(/[\s?？!！.。…]+$/u, '').trim();
+    return DECISION_CONSTANTS.VAGUE_QUESTIONS.includes(core);
+}
+/**
+ * Parse the options: an array of `{label, detail?}` objects or of strings
+ * (`"Label"` / `"Label — detail"`).
+ *
+ * @param raw - Input
+ * @returns Options with keys a/b/c
+ * @throws DecisionContractError
+ */
+export function parseOptions(raw) {
+    if (!Array.isArray(raw) || raw.length === 0) {
+        throw new DecisionContractError(`options are required: give the owner ${DECISION_CONSTANTS.MIN_OPTIONS}–${DECISION_CONSTANTS.MAX_OPTIONS} concrete choices they can tap. ${ASK_OWNER_EXAMPLE}`);
+    }
+    if (raw.length < DECISION_CONSTANTS.MIN_OPTIONS || raw.length > DECISION_CONSTANTS.MAX_OPTIONS) {
+        throw new DecisionContractError(`give ${DECISION_CONSTANTS.MIN_OPTIONS}–${DECISION_CONSTANTS.MAX_OPTIONS} options (got ${raw.length}). Pick the real alternatives; leave out "other". ${ASK_OWNER_EXAMPLE}`);
+    }
+    const options = raw.map((item, i) => {
+        let label = '';
+        let detail;
+        if (typeof item === 'string') {
+            const text = oneLine(item);
+            const m = DETAIL_SEPARATOR.exec(text);
+            if (m && m.index > 0) {
+                label = text.slice(0, m.index).trim();
+                detail = text.slice(m.index + m[0].length).trim() || undefined;
+            }
+            else {
+                label = text;
+            }
+        }
+        else if (item && typeof item === 'object') {
+            const o = item;
+            label = typeof o.label === 'string' ? oneLine(o.label) : '';
+            detail = typeof o.detail === 'string' && oneLine(o.detail) ? oneLine(o.detail) : undefined;
+        }
+        if (!label)
+            throw new DecisionContractError(`option ${i + 1} has no label. ${ASK_OWNER_EXAMPLE}`);
+        if (label.length > DECISION_CONSTANTS.OPTION_LABEL_MAX_CHARS) {
+            throw new DecisionContractError(`option "${label.slice(0, 30)}…" is too long for a button (max ${DECISION_CONSTANTS.OPTION_LABEL_MAX_CHARS} characters): put the short choice first and the explanation after " — ".`);
+        }
+        if (detail && detail.length > DECISION_CONSTANTS.OPTION_DETAIL_MAX_CHARS) {
+            throw new DecisionContractError(`the detail of option "${label}" is too long (max ${DECISION_CONSTANTS.OPTION_DETAIL_MAX_CHARS} characters).`);
+        }
+        return { key: OPTION_KEYS[i], label, ...(detail ? { detail } : {}) };
+    });
+    const seen = new Set();
+    for (const o of options) {
+        const k = o.label.toLowerCase();
+        if (seen.has(k))
+            throw new DecisionContractError(`two options are both "${o.label}": each option must be a different choice.`);
+        seen.add(k);
+    }
+    return options;
+}
+/**
+ * Resolve the default to an option key or `wait`.
+ *
+ * @param raw - Label, key (a/b/c), number (1–3) or `wait`
+ * @param options - Parsed options
+ * @returns Option key or `wait`
+ * @throws DecisionContractError
+ */
+export function resolveDefault(raw, options) {
+    const text = typeof raw === 'string' ? oneLine(raw) : typeof raw === 'number' ? String(raw) : '';
+    if (!text) {
+        throw new DecisionContractError(`default is required: the option you will take if the owner does not answer by the deadline, or "wait" to do nothing until they answer. ${ASK_OWNER_EXAMPLE}`);
+    }
+    const found = matchOption(text, options);
+    if (found)
+        return found.key;
+    if (text.toLowerCase() === DECISION_CONSTANTS.WAIT_DEFAULT)
+        return DECISION_CONSTANTS.WAIT_DEFAULT;
+    throw new DecisionContractError(`default "${text}" is not one of the options (${options.map((o) => `"${o.label}"`).join(', ')}) and not "wait".`);
+}
+/**
+ * Find the option a label, key (a/b/c) or number (1–3) names.
+ *
+ * @param text - What was given
+ * @param options - Options
+ * @returns The option, or null
+ */
+export function matchOption(text, options) {
+    const t = oneLine(text).toLowerCase().replace(/[.。!！]+$/u, '');
+    if (!t)
+        return null;
+    const byLabel = options.find((o) => o.label.toLowerCase() === t);
+    if (byLabel)
+        return byLabel;
+    const byKey = options.find((o) => o.key === t);
+    if (byKey)
+        return byKey;
+    const n = /^#?(\d)$/.exec(t);
+    if (n) {
+        const idx = Number(n[1]) - 1;
+        if (idx >= 0 && idx < options.length)
+            return options[idx];
+    }
+    return null;
+}
+/**
+ * Parse the deadline.
+ *
+ * @param raw - ISO / date-time string, or empty for the default
+ * @param now - Clock
+ * @returns The deadline
+ * @throws DecisionContractError when unreadable or not in the future
+ */
+export function parseDeadline(raw, now) {
+    if (raw === undefined || raw === null || (typeof raw === 'string' && raw.trim() === ''))
+        return defaultDeadline(now);
+    const ms = typeof raw === 'number' ? raw : Date.parse(String(raw).trim());
+    if (!Number.isFinite(ms)) {
+        throw new DecisionContractError(`deadline "${String(raw)}" is not a date-time. Use ISO, e.g. 2026-10-02T12:00, or leave it out (default: tomorrow 12:00).`);
+    }
+    if (ms <= now.getTime())
+        throw new DecisionContractError(`deadline ${new Date(ms).toISOString()} is in the past.`);
+    return new Date(ms);
+}
+/**
+ * Parse the sensitive kind.
+ *
+ * @param raw - `email` | `publish` | `deploy` | `spend`, or empty
+ * @returns The kind, or undefined
+ * @throws DecisionContractError on anything else
+ */
+export function parseSensitive(raw) {
+    if (raw === undefined || raw === null || raw === '' || raw === false)
+        return undefined;
+    const v = String(raw).trim().toLowerCase();
+    if (DECISION_CONSTANTS.SENSITIVE_KINDS.includes(v))
+        return v;
+    throw new DecisionContractError(`sensitive must be one of ${DECISION_CONSTANTS.SENSITIVE_KINDS.join(' | ')} (outside email/messages, public publishing, prod deploys, spending money).`);
+}
+/**
+ * Validate a whole ask.
+ *
+ * @param input - Raw input (skill / API body)
+ * @param now - Clock
+ * @returns The validated ask
+ * @throws DecisionContractError with a fix-it message
+ */
+export function validateAskOwner(input, now = new Date()) {
+    const rawQ = typeof input.question === 'string' ? input.question : '';
+    if (/\n\s*\S/.test(rawQ.trim())) {
+        throw new DecisionContractError('question must be ONE line. Put the context in the ticket, the choices in --option. ' + ASK_OWNER_EXAMPLE);
+    }
+    const question = oneLine(rawQ);
+    if (!question)
+        throw new DecisionContractError(`question is required. ${ASK_OWNER_EXAMPLE}`);
+    if (question.length > DECISION_CONSTANTS.QUESTION_MAX_CHARS) {
+        throw new DecisionContractError(`question is too long (max ${DECISION_CONSTANTS.QUESTION_MAX_CHARS} characters) — one line the owner can answer with a tap.`);
+    }
+    if (question.length < DECISION_CONSTANTS.QUESTION_MIN_CHARS || isVagueQuestion(question)) {
+        throw new DecisionContractError(`"${question}" is too vague to answer from a phone. Name the concrete decision (what, and when), e.g. "Send the partner email on Monday?". ${ASK_OWNER_EXAMPLE}`);
+    }
+    const options = parseOptions(input.options);
+    const defaultKey = resolveDefault(input.default, options);
+    const deadline = parseDeadline(input.deadline, now);
+    const sensitive = parseSensitive(input.sensitive);
+    const ticketId = typeof input.ticket === 'string' && input.ticket.trim() ? input.ticket.trim() : undefined;
+    const project = typeof input.project === 'string' && input.project.trim() ? input.project.trim() : undefined;
+    if (ticketId && !project)
+        throw new DecisionContractError('ticket needs --project too (the project the ticket belongs to).');
+    return {
+        question,
+        options,
+        defaultKey,
+        deadline,
+        ...(sensitive ? { sensitive } : {}),
+        ...(ticketId ? { ticketId } : {}),
+        ...(project ? { project } : {}),
+    };
+}
+//# sourceMappingURL=decision-contract.js.map

package/dist/backend/backend/src/services/decisions/decision-contract.js.map

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