crewly 1.20.394 → 1.20.396

package/dist/backend/backend/src/services/stall/claim-check.d.ts

@@ -30,12 +30,32 @@ export interface TeammateClaim {
  * @returns Patterns that match a claim about that teammate
  */
 export declare function claimPatternsFor(name: string): RegExp[];
+/**
+ * Where a sentence first claims the named teammate, or -1.
+ *
+ * @param sentence - One sentence of the post
+ * @param patterns - The claim patterns for one name
+ * @returns Index of the earliest match, or -1 when none matches
+ */
+export declare function claimIndex(sentence: string, patterns: readonly RegExp[]): number;
+/**
+ * Whether the words before the hand-off make it a plan for later rather than
+ * a claim about now: "你看过说可以，我再交给 Dex", "会随这次一起交给 Dex",
+ * "once you approve, I'll hand it to Dana" (crewly#1427 item 5). Only the
+ * text before the match counts — "交给 Pia 了，你点一下看看" stays a claim.
+ *
+ * @param sentence - One sentence of the post
+ * @param at - Where the claim match starts
+ * @returns True when the sentence announces a future or conditional hand-off
+ */
+export declare function isPlannedHandOff(sentence: string, at: number): boolean;
 /**
  * Claims in an agent's post that a named teammate is doing the work.
  *
  * A member is matched by its display name (not the speaker itself); each
- * member is reported once, with the first sentence that claims it. Questions
- * and negated sentences ("不是 Pia 在做") are skipped.
+ * member is reported once, with the first sentence that claims it. Questions,
+ * negated sentences ("不是 Pia 在做") and planned hand-offs ("你说可以我再交给
+ * Pia") are skipped.
  *
  * @param text - The agent's post
  * @param members - The speaker's teammates (name + session)
@@ -52,6 +72,10 @@ export declare function detectTeammateClaims(text: string, members: readonly Cla
 /**
  * The one line the speaker gets when nothing is assigned to the teammate.
  *
+ * The last clause exists because of 2026-10-23: four false nudges each made
+ * the agent post a "说明一下，现在没有交给 Dex" note in the owner's thread.
+ * A harness check must never produce owner-visible text.
+ *
  * @param memberName - The teammate as named
  * @param sentence - The claiming sentence
  * @returns Nudge text

package/dist/backend/backend/src/services/stall/claim-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claim-check.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/stall/claim-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC/B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC7B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CACjB;AAkBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYvD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAmBxH;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK3E"}
+{"version":3,"file":"claim-check.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/stall/claim-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC/B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC7B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CACjB;AAkBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYvD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAOhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,eAAe,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAqBxH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO3E"}

package/dist/backend/backend/src/services/stall/claim-check.js

@@ -42,12 +42,43 @@ export function claimPatternsFor(name) {
         new RegExp(`\\b${C.CLAIM_EN_BEFORE_NAME}\\s+${n}${b}`, 'iu'),
     ];
 }
+/**
+ * Where a sentence first claims the named teammate, or -1.
+ *
+ * @param sentence - One sentence of the post
+ * @param patterns - The claim patterns for one name
+ * @returns Index of the earliest match, or -1 when none matches
+ */
+export function claimIndex(sentence, patterns) {
+    let at = -1;
+    for (const re of patterns) {
+        const m = re.exec(sentence);
+        if (m && (at === -1 || m.index < at))
+            at = m.index;
+    }
+    return at;
+}
+/**
+ * Whether the words before the hand-off make it a plan for later rather than
+ * a claim about now: "你看过说可以，我再交给 Dex", "会随这次一起交给 Dex",
+ * "once you approve, I'll hand it to Dana" (crewly#1427 item 5). Only the
+ * text before the match counts — "交给 Pia 了，你点一下看看" stays a claim.
+ *
+ * @param sentence - One sentence of the post
+ * @param at - Where the claim match starts
+ * @returns True when the sentence announces a future or conditional hand-off
+ */
+export function isPlannedHandOff(sentence, at) {
+    const before = sentence.slice(0, Math.max(0, at));
+    return C.CLAIM_PLAN_ZH.test(before) || C.CLAIM_PLAN_EN.test(before);
+}
 /**
  * Claims in an agent's post that a named teammate is doing the work.
  *
  * A member is matched by its display name (not the speaker itself); each
- * member is reported once, with the first sentence that claims it. Questions
- * and negated sentences ("不是 Pia 在做") are skipped.
+ * member is reported once, with the first sentence that claims it. Questions,
+ * negated sentences ("不是 Pia 在做") and planned hand-offs ("你说可以我再交给
+ * Pia") are skipped.
  *
  * @param text - The agent's post
  * @param members - The speaker's teammates (name + session)
@@ -75,7 +106,10 @@ export function detectTeammateClaims(text, members, speaker) {
         if (!s || QUESTION_END.test(s) || NEGATED.test(s))
             continue;
         for (const { m, res } of patterns) {
-            if (seen.has(m.session) || !res.some((re) => re.test(s)))
+            if (seen.has(m.session))
+                continue;
+            const at = claimIndex(s, res);
+            if (at === -1 || isPlannedHandOff(s, at))
                 continue;
             seen.add(m.session);
             const one = s.replace(/\s+/g, ' ');
@@ -87,12 +121,18 @@ export function detectTeammateClaims(text, members, speaker) {
 /**
  * The one line the speaker gets when nothing is assigned to the teammate.
  *
+ * The last clause exists because of 2026-10-23: four false nudges each made
+ * the agent post a "说明一下，现在没有交给 Dex" note in the owner's thread.
+ * A harness check must never produce owner-visible text.
+ *
  * @param memberName - The teammate as named
  * @param sentence - The claiming sentence
  * @returns Nudge text
  */
 export function claimNudgeText(memberName, sentence) {
     return (`${C.CLAIM_CHECK_TAG} You told the owner ${memberName} is doing it ("${sentence}"); nothing is assigned to ${memberName} ` +
-        `(no work item or ticket for ${memberName} within ${Math.round(C.CLAIM_CHECK_WINDOW_MS / 60_000)} minutes of that reply). Delegate it now, or correct the thread.`);
+        `(no work item or ticket for ${memberName} within ${Math.round(C.CLAIM_CHECK_WINDOW_MS / 60_000)} minutes of that reply). ` +
+        `Delegate it now, or fix the wording in your next reply if you misspoke. If it was only a plan for later, do nothing — ` +
+        `and never post about this note in the owner's thread.`);
 }
 //# sourceMappingURL=claim-check.js.map

package/dist/backend/backend/src/services/stall/claim-check.js.map

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

package/dist/backend/backend/src/services/wiki/wiki-knowledge-gaps.service.d.ts

@@ -0,0 +1,198 @@
+/**
+ * WikiKnowledgeGapsService — turns the week's zero-hit queries into a page
+ * and one piece of work for the team lead (#914 P1).
+ *
+ * `wiki-query` and `recall` append every query to `llm-curated/usage.jsonl`,
+ * including the ones that found nothing. The bookkeep report listed five of
+ * them, and nobody read the bookkeep report. Once per ISO week, from the
+ * maintenance daily pass, this service:
+ *
+ *   1. reads the window's ledger events and keeps the misses (`miss` or an
+ *      empty hit list);
+ *   2. folds them by normalised query text into distinct gaps — how often,
+ *      who asked, first and last time — and drops a gap the vault answered
+ *      later in the window (the same question later returned hits);
+ *   3. writes `llm-curated/gaps/<week>.md` through the normal ingest path
+ *      (frontmatter, index line, history) — replaced, not appended, when the
+ *      same week is compiled again;
+ *   4. hands the vault's team lead (the orchestrator for the global vault)
+ *      one WorkItem to decide, per gap, whether it deserves a page. Never
+ *      when the lead is dormant: a chore is not worth a wake.
+ *
+ * No LLM. A short query (`QUERY_MIN_CHARS`) is a stray token and ignored; a
+ * long one (`QUERY_MAX_CHARS`) is pasted text, counted but not listed.
+ *
+ * @module services/wiki/wiki-knowledge-gaps.service
+ */
+import { type WorkItem } from '../../types/v2/work-item.types.js';
+import { WikiIngestService } from './wiki-ingest.service.js';
+import { WikiUsageService, type WikiUsageEvent } from './wiki-usage.service.js';
+/** One distinct unanswered question. */
+export interface KnowledgeGap {
+    /** The query as first asked (original casing, whitespace collapsed). */
+    query: string;
+    /** Times it was asked and found nothing in the window. */
+    count: number;
+    /** Agents that asked, most frequent first (capped). */
+    agents: string[];
+    /** Retrieval paths it came through (`recall`, `wiki-query`, …). */
+    via: string[];
+    /** ISO time of the first and last miss. */
+    firstAt: string;
+    lastAt: string;
+}
+/** Outcome of folding a window's events. */
+export interface KnowledgeGapRollup {
+    /** Every ledger event in the window. */
+    queries: number;
+    /** Events that found nothing. */
+    misses: number;
+    /** Distinct gaps, most-asked first (capped at `MAX_GAPS_PER_PAGE`). */
+    gaps: KnowledgeGap[];
+    /** Distinct gaps before the cap. */
+    distinct: number;
+    /** Misses whose query looked like pasted text (longer than `QUERY_MAX_CHARS`). */
+    pastedText: number;
+    /** Distinct questions that missed first and were answered later in the window. */
+    answeredLater: number;
+}
+/** The pool slice this service needs. */
+export interface KnowledgeGapsPool {
+    addToPool(workItem: WorkItem): Promise<void>;
+}
+/** Construction options. */
+export interface WikiKnowledgeGapsOptions {
+    ingest?: WikiIngestService;
+    usage?: WikiUsageService;
+    /** Where the lead's review WorkItem goes. Omit to write the page only. */
+    pool?: KnowledgeGapsPool;
+    /** Team lead for a vault; `null` falls back to `fallbackTarget`. */
+    resolveTarget?: (vaultPath: string) => Promise<string | null>;
+    /** Whether a target may be given work now; default: always. */
+    isTargetAwake?: (sessionName: string) => Promise<boolean>;
+    /** Target when no lead resolves (default: the orchestrator). */
+    fallbackTarget?: string;
+}
+/** Options for {@link WikiKnowledgeGapsService.compile}. */
+export interface WikiKnowledgeGapsCompileOptions {
+    /** Report only; write nothing (page, state or WorkItem). */
+    dryRun?: boolean;
+    /** Clock (tests). */
+    now?: number;
+    /** Window override (tests). */
+    windowDays?: number;
+    /** Compile even when this week was already compiled (the page is replaced; no second WorkItem). */
+    force?: boolean;
+}
+/** Outcome of one vault's compile. */
+export interface WikiKnowledgeGapsResult {
+    vaultPath: string;
+    /** ISO week the page is for. */
+    week: string;
+    /** False when nothing was (or would be) written. */
+    compiled: boolean;
+    reason?: 'not_due' | 'no_queries' | 'no_gaps' | 'ingest_refused';
+    rollup: KnowledgeGapRollup;
+    /** Vault-relative page (planned in a dry run). */
+    pagePath?: string;
+    /** Lead WorkItem created this run. */
+    workItemId?: string;
+    /** Who the WorkItem went to (or would go to). */
+    target?: string;
+    /** Why no WorkItem was created although the page was. */
+    workItemSkipped?: 'no_pool' | 'target_dormant' | 'already_raised' | 'dry_run';
+    dryRun: boolean;
+}
+/**
+ * Normalise a query for grouping: case, whitespace, trailing punctuation.
+ *
+ * @param query - Raw query text
+ * @returns Grouping key
+ */
+export declare function gapKey(query: string): string;
+/**
+ * Fold a window's ledger events into distinct gaps. Pure.
+ *
+ * @param events - Ledger events, any order
+ * @returns Counts and the distinct gaps, most-asked first then most recent
+ *
+ * @example
+ * ```typescript
+ * const r = rollupGaps(events);
+ * // r.gaps[0] === { query: 'refund policy', count: 3, agents: ['kai'], … }
+ * ```
+ */
+export declare function rollupGaps(events: readonly WikiUsageEvent[]): KnowledgeGapRollup;
+/**
+ * Weekly knowledge-gap pages per vault. Singleton apart from the per-vault
+ * state file; tests construct their own.
+ */
+export declare class WikiKnowledgeGapsService {
+    private static instance;
+    private readonly logger;
+    private readonly ingest;
+    private readonly usage;
+    private readonly pool;
+    private readonly resolveTarget;
+    private readonly isTargetAwake;
+    private readonly fallbackTarget;
+    constructor(opts?: WikiKnowledgeGapsOptions);
+    static getInstance(): WikiKnowledgeGapsService;
+    /** Wire the production instance (built with a pool and a lead resolver). */
+    static setInstance(next: WikiKnowledgeGapsService | null): void;
+    /** Test-only reset. */
+    static _resetForTesting(): void;
+    /**
+     * Compile one vault's gap page for the current ISO week, once per week.
+     *
+     * @param vaultPath - Vault root
+     * @param opts - Dry run, clock, window and force
+     * @returns What was (or would be) written
+     *
+     * @example
+     * ```typescript
+     * const r = await WikiKnowledgeGapsService.getInstance().compile(vault);
+     * // r.compiled && r.pagePath === 'llm-curated/gaps/2026-W43.md'
+     * ```
+     */
+    compile(vaultPath: string, opts?: WikiKnowledgeGapsCompileOptions): Promise<WikiKnowledgeGapsResult>;
+    /**
+     * Compile every vault in a list; failures are logged per vault.
+     *
+     * @param vaults - Vault roots
+     * @param opts - Passed to {@link compile}
+     * @returns One result per vault that did not throw
+     */
+    compileAll(vaults: readonly string[], opts?: WikiKnowledgeGapsCompileOptions): Promise<WikiKnowledgeGapsResult[]>;
+    /**
+     * Markdown body: a dated heading with the counts, one bullet per gap
+     * (query, times asked, who, last asked, path), then what the lead does
+     * with it.
+     *
+     * @param rollup - Folded gaps
+     * @param now - Epoch ms of the run
+     * @param windowDays - Window the counts cover
+     * @returns Markdown
+     */
+    renderBody(rollup: KnowledgeGapRollup, now: number, windowDays: number): string;
+    /**
+     * The lead's review WorkItem: title with the vault and the count, the
+     * rendered page as the brief.
+     */
+    private buildWorkItem;
+    /** Who reviews a vault's gaps: its team lead, else the fallback. */
+    private targetFor;
+    /** Errors count as dormant: a chore is never worth risking a wake. */
+    private targetAwake;
+    private statePath;
+    private readState;
+    private writeState;
+}
+/**
+ * Short human label for a vault: the project or team folder it belongs to.
+ *
+ * @param vaultPath - `<project>/.crewly/wiki`, `~/.crewly/teams/<id>/wiki` or `~/.crewly/global-wiki`
+ * @returns `crewly`, `<team-id>` or `global`
+ */
+export declare function vaultLabel(vaultPath: string): string;
+//# sourceMappingURL=wiki-knowledge-gaps.service.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki-knowledge-gaps.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-knowledge-gaps.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-knowledge-gaps.service.ts"],"names":[],"mappings":"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"}