crewly 1.20.182 → 1.20.184

package/dist/backend/backend/src/services/open-items/open-item-card.js

@@ -0,0 +1,208 @@
+/**
+ * Turn a question an agent asked the owner in its reply into a decision card
+ * (specs/2026-10-01-reply-open-items.md §4). Pure.
+ *
+ * - A stated fallback decides the default: "不同意的话我就删掉，只留事实" →
+ *   options Yes / No (No = "删掉，只留事实"), default No — what the agent said
+ *   it would do without an answer. "没意见的话我就发" → default Yes.
+ * - "A 还是 B？" / "Should I A or B?" → options A and B, default wait.
+ * - Anything else → Yes / No / Reply in thread, default wait.
+ *
+ * Option labels the harness writes are English; the agent's own words stay
+ * as they are (in an option's label or detail).
+ *
+ * @module services/open-items/open-item-card
+ */
+import { DECISION_CONSTANTS, OPEN_ITEMS_CONSTANTS } from '../../constants.js';
+const KEYS = ['a', 'b', 'c'];
+/** "If not, I'll …" — what happens on a no (Chinese / English). */
+const FALLBACK_NO = [
+    /^(?:如果|要是)?(?:你|您)?(?:觉得)?(?:不同意|不认同|不行|不要|不需要|不用|不合适|不妥|不喜欢|不OK|不ok|不好)的话[，,\s]*(?:那)?(?:我)?(?:就|会|再|先)?(.+)$/iu,
+    /^(?:否则|不然)(?:的话)?[，,\s]*(?:那)?(?:我)?(?:就|会)?(.+)$/u,
+    /^(?:if not|if you don'?t (?:agree|want (?:it|that|this|to)|like (?:it|that))|if you disagree|otherwise),?\s*(?:i'?ll|i will|i'?d|we'?ll)\s+(.+)$/i,
+];
+/** "If no objection, I'll …" — what happens on a yes / by default. */
+const FALLBACK_YES = [
+    /^(?:如果|要是)?(?:你|您)?(?:觉得)?(?:没意见|没问题|同意|可以|OK|ok|没异议|不反对|行)的话[，,\s]*(?:那)?(?:我)?(?:就|会)?(.+)$/iu,
+    /^(?:if (?:i don'?t hear back|there'?s no objection|you don'?t object|no objection|that works|you agree)|unless you object),?\s*(?:i'?ll|i will|we'?ll)\s+(.+)$/i,
+];
+/**
+ * Tidy an action phrase for an option detail.
+ *
+ * @param s - Raw phrase
+ * @returns Phrase without the closing punctuation
+ */
+function tidy(s) {
+    return s.replace(/\s+/g, ' ').replace(/[。.!！;；]+$/u, '').trim();
+}
+/**
+ * Clip to the option detail limit.
+ *
+ * @param s - Text
+ * @returns Clipped text
+ */
+function detail(s) {
+    const max = DECISION_CONSTANTS.OPTION_DETAIL_MAX_CHARS;
+    return s.length > max ? `${s.slice(0, max - 1)}…` : s;
+}
+/**
+ * The two alternatives of a choice question, when each fits on a button.
+ *
+ * @param q - Question sentence
+ * @returns [A, B] or null
+ */
+export function choiceAlternatives(q) {
+    const max = DECISION_CONSTANTS.OPTION_LABEL_MAX_CHARS;
+    const t = q.trim();
+    const en = /^(?:should (?:i|we)|shall (?:i|we)|do you want (?:me|us) to|would you (?:prefer|like (?:me|us) to)|do you prefer)\s+(.+?),?\s+or\s+(.+?)\s*\?$/i.exec(t);
+    if (en) {
+        const a = tidy(en[1]);
+        const b = tidy(en[2]);
+        return a && b && a.length <= max && b.length <= max && a.toLowerCase() !== b.toLowerCase() ? [a, b] : null;
+    }
+    if (!/还是/.test(t))
+        return null;
+    // The clause holding 还是: "…，你想先发 A 还是 B？" → "先发 A" / "B".
+    // "要现在先发文字版，还是等图好了再发？": A may sit in the clause before.
+    const clauses = t.replace(/[？?]\s*$/u, '').split(/[，,：:；;]/).map((c) => c.trim());
+    const i = clauses.findIndex((c) => c.includes('还是'));
+    if (i < 0)
+        return null;
+    let rawA;
+    let rawB;
+    if (clauses[i].startsWith('还是') && i > 0) {
+        rawA = clauses[i - 1];
+        rawB = clauses[i].slice(2);
+    }
+    else {
+        [rawA, rawB] = clauses[i].split('还是');
+    }
+    if (rawA === undefined || rawB === undefined)
+        return null;
+    const a = tidy(rawA.replace(/^(?:那)?(?:你|您)?(?:觉得|想|要|看)?(?:是)?(?:要|用|选|先)?/u, ''));
+    const b = tidy(rawB.replace(/(?:呢|吗|吧|啊|好|比较好|更好)+$/u, ''));
+    if (!a || !b || a === b)
+        return null;
+    return a.length <= max && b.length <= max ? [a, b] : null;
+}
+/**
+ * Which approval boundary a question touches (never auto-applied), if any.
+ *
+ * @param text - Question and fallback
+ * @returns Sensitive kind, or undefined
+ */
+export function sensitiveKindOf(text) {
+    const t = text.toLowerCase();
+    if (/\be-?mail\b|邮件|发信/.test(t))
+        return 'email';
+    if (/\bdeploy|\bproduction\b|\bprod\b|部署|上生产|上线/.test(t))
+        return 'deploy';
+    if (/\bpay\b|\bpurchase\b|\bbuy\b|\bsubscri|\bcharge|付款|付费|花钱|购买|订阅|扣费/.test(t))
+        return 'spend';
+    if (/\bpublish|\bpost (?:it )?publicly\b|\btweet\b|公开发布|发布出去|发出去|发帖/.test(t))
+        return 'publish';
+    return undefined;
+}
+/**
+ * Build the card for a question.
+ *
+ * @param q - The question (and its fallback sentence)
+ * @returns Card fields
+ *
+ * @example
+ * deriveQuestionCard({ type: 'question', text: '这个读法，你同意吗？', fallback: '不同意的话我就删掉，只留事实。' })
+ * // → options Yes / No ("删掉，只留事实"), default b (No), yesKey a
+ */
+export function deriveQuestionCard(q) {
+    const C = OPEN_ITEMS_CONSTANTS;
+    const question = q.text;
+    const sensitive = sensitiveKindOf(`${q.text} ${q.fallback ?? ''}`);
+    const base = { question, ...(sensitive ? { sensitive } : {}) };
+    const fb = q.fallback?.trim();
+    if (fb) {
+        for (const re of FALLBACK_NO) {
+            const m = re.exec(fb);
+            if (m && tidy(m[1])) {
+                return {
+                    ...base,
+                    options: [
+                        { key: 'a', label: C.YES_LABEL },
+                        { key: 'b', label: C.NO_LABEL, detail: detail(tidy(m[1])) },
+                    ],
+                    defaultKey: 'b',
+                    yesKey: 'a',
+                    derivedFrom: 'fallback_no',
+                };
+            }
+        }
+        for (const re of FALLBACK_YES) {
+            const m = re.exec(fb);
+            if (m && tidy(m[1])) {
+                return {
+                    ...base,
+                    options: [
+                        { key: 'a', label: C.YES_LABEL, detail: detail(tidy(m[1])) },
+                        { key: 'b', label: C.NO_LABEL },
+                    ],
+                    defaultKey: 'a',
+                    yesKey: 'a',
+                    derivedFrom: 'fallback_yes',
+                };
+            }
+        }
+    }
+    const alt = choiceAlternatives(q.text);
+    if (alt) {
+        return {
+            ...base,
+            options: alt.map((label, i) => ({ key: KEYS[i], label })),
+            defaultKey: DECISION_CONSTANTS.WAIT_DEFAULT,
+            derivedFrom: 'choice',
+        };
+    }
+    return {
+        ...base,
+        options: [
+            { key: 'a', label: C.YES_LABEL },
+            { key: 'b', label: C.NO_LABEL },
+            { key: 'c', label: C.REPLY_LABEL, detail: "you'll answer in words in this thread" },
+        ],
+        defaultKey: DECISION_CONSTANTS.WAIT_DEFAULT,
+        yesKey: 'a',
+        derivedFrom: 'generic',
+    };
+}
+/**
+ * Character-bigram overlap of two questions (Dice coefficient), ignoring
+ * spaces and punctuation. Used to tell "the agent asked this through
+ * ask-owner already".
+ *
+ * @param a - Question
+ * @param b - Question
+ * @returns 0..1
+ */
+export function questionSimilarity(a, b) {
+    const norm = (s) => s.toLowerCase().replace(/[\s\p{P}\p{S}]+/gu, '');
+    const grams = (s) => {
+        const m = new Map();
+        for (let i = 0; i < s.length - 1; i++) {
+            const g = s.slice(i, i + 2);
+            m.set(g, (m.get(g) ?? 0) + 1);
+        }
+        return m;
+    };
+    const x = norm(a);
+    const y = norm(b);
+    if (!x || !y)
+        return 0;
+    if (x === y)
+        return 1;
+    const gx = grams(x);
+    const gy = grams(y);
+    let overlap = 0;
+    for (const [g, n] of gx)
+        overlap += Math.min(n, gy.get(g) ?? 0);
+    const total = Math.max(1, x.length - 1) + Math.max(1, y.length - 1);
+    return (2 * overlap) / total;
+}
+//# sourceMappingURL=open-item-card.js.map

package/dist/backend/backend/src/services/open-items/open-item-card.js.map

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

package/dist/backend/backend/src/services/open-items/open-item-extractor.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Find the commitments and questions an agent left open in a reply to the
+ * owner (specs/2026-10-01-reply-open-items.md §1). Pure, rules only.
+ *
+ * Tuned to miss rather than invent: a missed promise costs one follow-up the
+ * owner has to ask for himself; an invented question puts a pointless card in
+ * front of him. So a sentence only counts when it clearly says
+ *
+ * - **commitment**: a first-person future deliverable for the owner
+ *   ("明天中午给我，我核过以后挑最有用的几条发你", "I'll send the draft tonight");
+ * - **question**: a direct question that asks the owner to decide or confirm
+ *   ("这个读法，你同意吗？", "Should I keep the appendix?").
+ *
+ * Skipped on purpose: past tense ("已经发你了", "attached below"), conditional
+ * offers ("要的话我再…", "if you want, I'll…"), quoted text, headings,
+ * questions to a colleague (an @-mention or a teammate's name up front) and
+ * rhetorical questions that the agent answers itself.
+ *
+ * @module services/open-items/open-item-extractor
+ */
+/** A commitment found in a reply. */
+export interface ExtractedCommitment {
+    type: 'commitment';
+    /** The sentence (clipped) */
+    text: string;
+    /** When it is due */
+    due: Date;
+    /** `text` = a time was said; `default` = none was, so +24 h */
+    dueSource: 'text' | 'default';
+}
+/** A question to the owner found in a reply. */
+export interface ExtractedQuestion {
+    type: 'question';
+    /** The question sentence (clipped, one line) */
+    text: string;
+    /** The sentence after it, when it states a fallback ("不同意的话我就删掉") */
+    fallback?: string;
+}
+/** Everything found in one reply. */
+export interface ExtractedOpenItems {
+    commitments: ExtractedCommitment[];
+    questions: ExtractedQuestion[];
+}
+/** Options for {@link extractOpenItems}. */
+export interface ExtractOptions {
+    /** When the reply was posted (due times are relative to it) */
+    now: Date;
+    /** Display names of the agent's colleagues (a question addressed to one is not for the owner) */
+    colleagueNames?: readonly string[];
+    /** The owner's Slack user id: an @-mention of anyone else makes a sentence not for the owner */
+    ownerSlackUserId?: string;
+}
+/** One sentence with the line it came from. */
+interface Sentence {
+    text: string;
+    /** Index of the sentence within its line */
+    index: number;
+    /** All sentences of the same line */
+    line: string[];
+}
+/**
+ * Split a reply into sentences, line by line.
+ *
+ * @param text - Reply text
+ * @returns Sentences
+ */
+export declare function splitSentences(text: string): Sentence[];
+/**
+ * Whether a sentence is a commitment to the owner.
+ *
+ * @param s - Sentence
+ * @returns True for a first-person future deliverable
+ */
+export declare function isCommitment(s: string): boolean;
+/**
+ * When a commitment is due.
+ *
+ * Rules (local time): an explicit day/part of day wins ("明天中午" → tomorrow
+ * 12:00, "tonight" → today 21:00, "by Friday" → Friday 12:00); "tomorrow"
+ * alone → tomorrow {@link OPEN_ITEMS_CONSTANTS.DEFAULT_DUE_HOUR_LOCAL}:00;
+ * "in 2 hours" → +2 h; nothing → +{@link OPEN_ITEMS_CONSTANTS.DEFAULT_DUE_MS}.
+ *
+ * @param s - Sentence
+ * @param now - When it was said
+ * @returns Due time and whether the text named it
+ */
+export declare function parseDue(s: string, now: Date): {
+    due: Date;
+    source: 'text' | 'default';
+};
+/**
+ * Whether a sentence (with its neighbours) is a question for the owner.
+ *
+ * @param s - The sentence
+ * @param next - The sentence after it on the same line, if any
+ * @param opts - Extraction options
+ * @returns True for a decision/confirmation question to the owner
+ */
+export declare function isOwnerQuestion(s: string, next: string | undefined, opts: ExtractOptions): boolean;
+/**
+ * Find open items in an agent's reply to the owner.
+ *
+ * @param text - The reply
+ * @param opts - Clock, colleague names, owner id
+ * @returns Commitments and questions (each at most
+ *   {@link OPEN_ITEMS_CONSTANTS.MAX_ITEMS_PER_REPLY})
+ *
+ * @example
+ * extractOpenItems('明天中午给我，我核过以后挑最有用的几条发你。', { now })
+ * // → { commitments: [{ text: '明天中午给我，我核过以后挑最有用的几条发你。', due: <tomorrow 12:00>, … }], questions: [] }
+ */
+export declare function extractOpenItems(text: string, opts: ExtractOptions): ExtractedOpenItems;
+export {};
+//# sourceMappingURL=open-item-extractor.d.ts.map

package/dist/backend/backend/src/services/open-items/open-item-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-item-extractor.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/open-items/open-item-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,GAAG,EAAE,IAAI,CAAC;IACV,+DAA+D;IAC/D,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,GAAG,EAAE,IAAI,CAAC;IACV,iGAAiG;IACjG,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,+CAA+C;AAC/C,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAgDD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAUvD;AAgGD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAa/C;AAuCD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAkDxF;AAuBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAUlG;AAiBD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,kBAAkB,CAqBvF"}