crewly 1.20.361 → 1.20.363

package/dist/cli/backend/src/constants.js

@@ -3464,6 +3464,35 @@ export const HANDOVER_POINTERS_CONSTANTS = {
     START_MARK: '<!-- handover-pointers -->',
     END_MARK: '<!-- /handover-pointers -->',
 };
+/**
+ * Work a restart cut off inside an agent's conversation (crewly#1361): a
+ * Claude Code transcript whose `tool_use` never received its `tool_result`
+ * before the cutoff. Sub-agents (Task / Agent tool) and background or
+ * long-running shell commands die with the process; the handover says so
+ * instead of carrying the agent's last "still in progress" narration.
+ */
+export const HANDOVER_CONSTANTS = {
+    /** Heading of the section listing the interrupted work */
+    INTERRUPTED_HEADING: '## Interrupted by the restart',
+    /** At most this many interrupted calls are listed */
+    INTERRUPTED_MAX_ITEMS: 5,
+    /** Characters kept of a sub-agent's prompt / a command */
+    INTERRUPTED_TEXT_MAX_CHARS: 200,
+    /** Tool names that start a sub-agent inside the conversation */
+    SUBAGENT_TOOLS: ['Task', 'Agent'],
+    /** Tool names that run shell commands */
+    SHELL_TOOLS: ['Bash'],
+    /**
+     * A shell command that looks long-running (a render, encode, build or a
+     * command sent to the background) even without `run_in_background`
+     */
+    LONG_COMMAND_PATTERN: /\b(?:ffmpeg|remotion|render|encode|transcode|whisper|nohup|caffeinate|npm run build|npx tsc)\b|&\s*$|\bsleep\s+\d{3,}/i,
+    /** Bullet prefixes of the section (also how the pointers header reads it back) */
+    SUBAGENT_LINE_PREFIX: '- A sub-agent was running: ',
+    COMMAND_LINE_PREFIX: '- A background command was running: ',
+    SUBAGENT_LINE_SUFFIX: '. It did not finish and is not running now. Restart it or report that it was lost.',
+    COMMAND_LINE_SUFFIX: '. It is not running now.',
+};
 /**
  * Fresh conversation per new task for Claude Code team members (never the
  * orchestrator): before a work item with a different root than the last one
@@ -5117,6 +5146,12 @@ export const GOOGLE_WORKSPACE_CONSTANTS = {
     PORTAL_CONNECT_PATH: '/portal/integrations/google',
     /** Metadata headers requested on Gmail search hits */
     GMAIL_SEARCH_HEADERS: ['From', 'To', 'Subject', 'Date'],
+    /** How often watched Gmail threads are checked for replies (one history.list per tick); must stay well under the 60 s wake promise */
+    GMAIL_WATCH_POLL_MS: 30_000,
+    /** A thread watch is dropped this long after its last reply (or creation) so the set cannot grow forever */
+    GMAIL_WATCH_EXPIRY_MS: 14 * 24 * 60 * 60 * 1000,
+    /** Consecutive "account not connected" ticks before its watches are removed */
+    GMAIL_WATCH_DISCONNECT_MISSES: 3,
     /** RFC 2045 line width for base64 message bodies */
     MIME_LINE_WIDTH: 76,
     /** Error codes shared between the token service, controller and skills */
@@ -6340,7 +6375,7 @@ export const HARNESS_CONSTANTS = {
         ENTER: '\r',
         /**
          * Pause between typing the user's input and pressing Enter (ms). Ink TUIs
-         * (Claude's `setup-token`) read one write of "code + \r" as a paste and
+         * (Claude's `auth login`) read one write of "code + \r" as a paste and
          * swallow the Enter, leaving the code sitting at the prompt
          * (iriss-air.lan, 2026-10-01).
          */
@@ -6444,6 +6479,18 @@ export const HARNESS_CONSTANTS = {
          * with its own config dir (`CLAUDE_CONFIG_DIR`) and login, used as
          * runtime fallbacks (`claude-code@<name>`). Issue #942.
          */
+        /**
+         * Retiring the Claude sign-in tokens older Crewly versions saved
+         * (claude-token-migration.service.ts).
+         */
+        TOKEN_MIGRATION: {
+            /** Bookkeeping under CREWLY_HOME (no credential in it) */
+            STATE_FILE: 'claude-token-migration.json',
+            /** First run after the backend starts */
+            START_DELAY_MS: 60_000,
+            /** How often saved tokens are re-checked (a login done by hand is noticed) */
+            RUN_INTERVAL_MS: 60 * 60_000,
+        },
         ACCOUNTS: {
             /** Directory under CREWLY_HOME holding one config dir per account */
             DIR: 'claude-accounts',
@@ -7101,6 +7148,23 @@ export const SYSTEM_CONTROL_CONSTANTS = {
         RESTART_IN_PROGRESS: 'Crewly is already shutting down or restarting.',
     },
 };
+/**
+ * Owner-facing wording of decision cards (crewly#1367, crewly#1369 §3): the
+ * question in plain words in the owner's language, internal references only
+ * in a short details line, context on merge cards.
+ */
+export const DECISION_WORDING_CONSTANTS = {
+    /** Max characters of one card context field (who asked, what the owner said, what changes) */
+    CONTEXT_FIELD_MAX_CHARS: 200,
+    /** Max characters of the context link */
+    LINK_MAX_CHARS: 300,
+    /** Max references shown in the card's details line */
+    DETAILS_MAX_REFS: 3,
+    /** Max characters of the question quoted in a one-line reminder */
+    REMINDER_QUESTION_MAX_CHARS: 60,
+    /** Min letters (any script) left in a question once internal references are stripped */
+    QUESTION_MIN_LETTERS: 4,
+};
 /**
  * Decision cards (specs/2026-10-01-decision-cards.md): structured owner
  * questions posted by the responsible agent's own Slack bot as a Block Kit
@@ -7112,7 +7176,7 @@ export const DECISION_CONSTANTS = {
      * (buttons added/removed): open cards drawn with an older revision are
      * redrawn once at startup so they get the new controls (e.g. Skip, 1.20.185).
      */
-    CARD_RENDER_REV: 3,
+    CARD_RENDER_REV: 4,
     /** Delay after startup before stale open cards are redrawn (ms) */
     STALE_CARD_REFRESH_DELAY_MS: 15_000,
     /** Gap between two card redraws, to stay under Slack's chat.update rate limit (ms) */
@@ -7176,7 +7240,7 @@ export const DECISION_CONSTANTS = {
     REACTION_SKIP: ['no_entry_sign', 'black_right_pointing_double_triangle_with_vertical_bar', 'next_track_button', 'track_next'],
     REACTION_REMIND: ['alarm_clock', 'clock9', 'hourglass'],
     /** Option labels that read as "no" (lower-cased, matched on the whole label or its first word) */
-    NO_WORDS: ['no', 'nope', "don't", 'dont', 'not now', 'skip', 'cancel', 'stop', 'reject', 'decline', 'hold', '不', '不行', '不要', '不用', '不可以', '别', '别点', '取消', '算了', '拒绝'],
+    NO_WORDS: ['no', 'nope', "don't", 'dont', 'not now', 'skip', 'cancel', 'stop', 'reject', 'decline', 'hold', '不', '不行', '不要', '不用', '不可以', '别', '别点', '取消', '算了', '拒绝', '先不'],
     /** Free-text replies that accept the default (or first) option */
     YES_WORDS: ['yes', 'y', 'ok', 'okay', 'sure', 'go', 'go ahead', 'do it', 'approved', 'approve', 'lgtm', '好', '好的', '可以', '行', '同意', '批准', '没问题', '👍', '✅'],
     /** Free-text replies that skip a card (checked before NO_WORDS) */
@@ -7244,6 +7308,18 @@ export const OPEN_ITEMS_CONSTANTS = {
     DEFAULT_DUE_HOUR_LOCAL: 12,
     /** A commitment with no time is due this long after it was made (ms) */
     DEFAULT_DUE_MS: 24 * 60 * 60 * 1000,
+    /**
+     * A commitment with no time made live in the owner's conversation (the
+     * owner is waiting for the reply) is due this long after it was made (ms).
+     * Backfilled and gate-opened promises keep DEFAULT_DUE_MS (crewly#1360).
+     */
+    CHAT_PROMISE_DEFAULT_DUE_MS: 4 * 60 * 60 * 1000,
+    /**
+     * An estimate the same agent states in the same thread this long after an
+     * undated promise ("预计一小时左右" a minute after "改完发你") dates that
+     * promise (ms) (crewly#1360)
+     */
+    ESTIMATE_WINDOW_MS: 10 * 60 * 1000,
     /** The same words by the same agent this close together are one item (a reply recorded twice) (ms) */
     DUPLICATE_WINDOW_MS: 10 * 60 * 1000,
     /** The same agent's two promises this close together, about the same deliverable, are one (the newer stands) (ms) */
@@ -7254,6 +7330,13 @@ export const OPEN_ITEMS_CONSTANTS = {
     TEXT_MAX_CHARS: 300,
     /** Max characters of a question (the card's one line) */
     QUESTION_MAX_CHARS: 280,
+    /**
+     * A yes/no decision asked of the owner in prose ("should I close PR #12?",
+     * "要不要合并？") is on file as an owner question due this long after it
+     * was asked; with no answer by then the stall watcher follows up (ms)
+     * (crewly#1369 gap 2).
+     */
+    OWNER_QUESTION_DUE_MS: 24 * 60 * 60 * 1000,
     /** Child WorkItems created this long before the promise still count as what it waits on (ms) */
     CHILD_LOOKBACK_MS: 30 * 60 * 1000,
     /** ...and this long after it — the agent promises, then delegates (ms). Later work is a new topic. */
@@ -7355,6 +7438,15 @@ export const WORK_ITEM_DESTINATION_CONSTANTS = {
     METADATA_KEY: 'origin',
     /** An owner turn origin newer than this (ms) still counts as the current work when no work item is running */
     OWNER_ORIGIN_FRESH_MS: 2 * 60 * 60 * 1000,
+    /**
+     * An owner origin whose request is older than this (ms) is never inherited by
+     * new work, explicit or not (crewly#1357: a delegation carried an owner DM
+     * from nine days earlier). A verbatim `metadata.origin` in the add body is
+     * not an inheritance and is kept as given.
+     */
+    ORIGIN_INHERIT_MAX_AGE_MS: 2 * 60 * 60 * 1000,
+    /** Tag that opens the message a delegating agent gets with a result for work it handed out */
+    AGENT_RESULT_TAG: '[RESULT]',
     /** Max characters of the topic line of a new top-level post */
     TOPIC_MAX_CHARS: 120,
     /** The one line every prompt carries about where to answer */
@@ -7370,8 +7462,11 @@ export const OWNER_COMPLETION_REPORT_CONSTANTS = {
     TICK_MS: 60_000,
     /** A chain must stay finished this long before the report is asked for — the lead may still be handing out the next step (ms) */
     SETTLE_MS: 5 * 60_000,
-    /** Wait for the report after asking (and again after the one reminder) (ms) */
-    REPORT_WAIT_MS: 20 * 60_000,
+    /**
+     * After the one nudge, the agent has this long to post its own report before
+     * the harness posts one line for it (ms) (crewly#1357)
+     */
+    NUDGE_GRACE_MS: 30 * 60_000,
     /** Chains whose first item is older than this are never reported (ms) */
     MAX_CHAIN_AGE_MS: 14 * 24 * 60 * 60_000,
     /** Finished chain records are forgotten after this long (ms) */
@@ -7382,10 +7477,14 @@ export const OWNER_COMPLETION_REPORT_CONSTANTS = {
     MAX_TITLES: 5,
     /** Max characters of one title in a message */
     TITLE_MAX_CHARS: 90,
-    /** Max evidence lines in the fallback post */
-    MAX_EVIDENCE_LINES: 6,
-    /** Max characters of one evidence line */
-    EVIDENCE_LINE_MAX_CHARS: 200,
+    /** Max characters of one deliverable named in the fallback line */
+    DELIVERABLE_MAX_CHARS: 90,
+    /** Share of CJK characters in the owner's text above which the fallback line is written in Chinese */
+    OWNER_LANGUAGE_CJK_MIN_RATIO: 0.2,
+    /** How far back the owner's recent messages are read to pick the fallback line's language (ms) */
+    OWNER_LANGUAGE_LOOKBACK_MS: 7 * 24 * 60 * 60_000,
+    /** How many recent owner messages are read for that */
+    OWNER_LANGUAGE_SAMPLE: 30,
     /** An app comment / relayed owner request stays the agent's current request this long (ms) */
     CONTEXT_FRESH_MS: 2 * 60 * 60 * 1000,
     /** Max sessions the owner-request context registry remembers */
@@ -7399,6 +7498,8 @@ export const OWNER_COMPLETION_REPORT_CONSTANTS = {
 export const TL_DELEGATION_CONSTANTS = {
     /** WorkItem.metadata / add-body field: the owner's Slack thread key a delegation answers */
     OWNER_THREAD_FIELD: 'ownerThread',
+    /** WorkItem.metadata / add-body field: the owner's chat conversation a delegation answers (crewly#1357) */
+    OWNER_CONVERSATION_FIELD: 'ownerConversation',
     /** A done item still lets its agent post in the owner's thread this long (ms) */
     DONE_THREAD_GRACE_MS: 60 * 60 * 1000,
     /** Claude Code tools that count as hands-on file edits */
@@ -7684,6 +7785,94 @@ export const TRACE_CONSTANTS = {
     /** Most ticket labels kept in a trace's tags (specs/2026-10-03-autopilot-experiments.md) */
     MAX_TAG_LABELS: 20,
 };
+/**
+ * Stall watcher (crewly#1363, crewly#1362, specs/2026-10-17-stall-watcher.md):
+ * acts on in-flight work that stopped moving — promises to the owner,
+ * claimed WorkItems, and background runs an agent said it started — with
+ * one ladder: the agent once, then its lead once, then one plain line to the
+ * owner. The owner is never the retry loop.
+ */
+export const STALL_WATCHER_CONSTANTS = {
+    /** `=false` switches the watcher off entirely */
+    ENV_KILL_SWITCH: 'CREWLY_STALL_WATCHER',
+    /** `=true` / `=false` forces dry run on / off (default: dry run until armed for ARM_DELAY_MS) */
+    ENV_DRY_RUN: 'CREWLY_STALL_WATCHER_DRY_RUN',
+    /** State file under CREWLY_HOME: in-flight runs, ladder stamps, pending claim checks, the armed time */
+    STATE_FILE: 'in-flight-runs.json',
+    /** State file format version */
+    STATE_VERSION: 1,
+    /** How often the watcher looks (ms) */
+    INTERVAL_MS: 5 * 60 * 1000,
+    /** First pass this long after boot, after the boot-pressure gate (ms) */
+    BOOT_DELAY_MS: 3 * 60 * 1000,
+    /**
+     * Like the janitor's retention deletes: the first pass records when it ran
+     * and only logs; the watcher sends nothing until this long after that (ms).
+     */
+    ARM_DELAY_MS: 24 * 60 * 60 * 1000,
+    /** The agent is re-briefed at this multiple of its own estimate past the promise / run start */
+    AGENT_STEP_MULTIPLIER: 1.5,
+    /** ... but never sooner than this after the promise (ms) */
+    MIN_AGENT_STEP_MS: 20 * 60 * 1000,
+    /** The lead is told at this multiple of the estimate */
+    LEAD_STEP_MULTIPLIER: 3,
+    /** The owner hears one line when the lead has not answered in the thread this long after being told (ms) */
+    LEAD_GRACE_MS: 30 * 60 * 1000,
+    /** At most one watcher nudge per agent per this long (ms) */
+    NUDGE_COOLDOWN_MS: 30 * 60 * 1000,
+    /** At most one owner line per stalled item per this long (ms) */
+    OWNER_LINE_INTERVAL_MS: 24 * 60 * 60 * 1000,
+    /** A background run with no duration in the text is expected back after this long (ms) */
+    RUN_DEFAULT_ESTIMATE_MS: 60 * 60 * 1000,
+    /** An agent with a run in flight is not idle-stopped or evicted until expectedBy + this (ms) */
+    RUN_PROTECTION_GRACE_MS: 30 * 60 * 1000,
+    /** A run record older than this is dropped whatever happened (ms) */
+    RUN_MAX_AGE_MS: 24 * 60 * 60 * 1000,
+    /** Ladder stamps of an item not seen for this long are forgotten (ms) */
+    LADDER_TTL_MS: 7 * 24 * 60 * 60 * 1000,
+    /** Most in-flight runs kept */
+    MAX_RUNS: 200,
+    /** Characters of a run's sentence kept in its record and in nudges */
+    RUN_HEAD_MAX_CHARS: 160,
+    /** Characters of the context message quoted in a promise re-brief */
+    CONTEXT_MAX_CHARS: 300,
+    /** Characters of a promise / title quoted in a nudge or an owner line */
+    QUOTE_MAX_CHARS: 120,
+    /**
+     * A claimed WorkItem whose trace shows no progress (no tool calls, posts
+     * or worktree changes) for this long is stalled; the same again after the
+     * nudge releases the claim (ms). Shares the autonomy-metrics threshold.
+     */
+    CLAIM_STALL_MS: 30 * 60 * 1000,
+    /** The claim-check window around "X is doing it": a WorkItem / ticket for X created this long before or after (ms) (crewly#1362) */
+    CLAIM_CHECK_WINDOW_MS: 10 * 60 * 1000,
+    /** Most pending claim checks kept */
+    MAX_PENDING_CLAIMS: 200,
+    /** Opens every watcher line to an agent */
+    NUDGE_TAG: '[STALL]',
+    /** Opens a claim-check line to an agent */
+    CLAIM_CHECK_TAG: '[CLAIM-CHECK]',
+    /** Title of the owner's Slack notice */
+    OWNER_ALERT_TITLE: 'Stalled work',
+    /**
+     * An agent saying it started something that runs on its own (a render, a
+     * background process, a sub-agent). Registered only together with a
+     * duration the open-items parser understands ("预计 1 小时左右", "about 40 min").
+     */
+    BACKGROUND_RUN_PATTERN: /开跑|已经在跑|在跑了|跑起来了|在渲染|渲染中|正在渲染|正在生成|生成中|子任务在做|子\s*agent\s*在(?:做|跑)|后台(?:在)?跑|后台(?:在)?(?:做|生成|渲染)|已经启动|启动了(?:渲染|生成|任务|流程)|\bkicked off\b|\bstarted (?:the|a|another) (?:run|render|job|batch|build|export|background|sub-?agent)\b|\bis rendering\b|\brendering now\b|\brunning in the background\b|\brunning now\b|\blaunched (?:a|the|another) (?:run|render|job|batch|build|sub-?agent)\b|\bspun up (?:a|the) (?:sub-?agent|run|job)\b/iu,
+    /** A later post by the same agent in the thread that reports the run finished or failed */
+    RUN_FINISHED_PATTERN: /跑完|渲染完|生成完|做好了|做完了|完成了|搞定|出来了|好了[，,。！!]|失败|挂了|报错|出错|中断|没跑完|跑崩|\bdone\b|\bfinished\b|\bcompleted\b|\bfailed\b|\bcrashed\b|\berrored\b|\baborted\b|\bready\b|\bhere (?:it|they) (?:is|are)\b|\battached\b/iu,
+    /** A link or a file in a post counts as a deliverable */
+    DELIVERABLE_PATTERN: /https?:\/\/\S+|\S+\.(?:mp4|mov|webm|gif|png|jpe?g|pdf|zip|md|csv|xlsx?|pptx?|docx?|wav|mp3)\b/iu,
+    /** Chinese verbs that make "<Name> …" a claim that the named teammate is doing the work (crewly#1362) */
+    CLAIM_ZH_AFTER_NAME: '(?:已经)?(?:在做|在弄|在处理|在搞|在跟|在推进|在准备|在出|在写|在剪|在录|在改|负责|去做|来做|接了|接手|正在)',
+    /** Chinese verbs that make "… <Name>" a hand-off to the named teammate */
+    CLAIM_ZH_BEFORE_NAME: '(?:交给|让|叫|由|派给|丢给|转给|安排)',
+    /** English verbs after the name: "Pia is (already) doing / on / making / working on it" */
+    CLAIM_EN_AFTER_NAME: "(?:is|'s|has been|will be|was|are|'re)\\s+(?:already\\s+)?(?:doing|on|making|working on|handling|building|taking|taking care of|writing|producing|rendering|editing|cutting|preparing|drafting|looking into|picking (?:it|this) up)",
+    /** English hand-off before the name: "handed it to Pia", "assigned this to Pia" */
+    CLAIM_EN_BEFORE_NAME: '(?:handed|gave|passed|assigned|delegated|sent|routed)\\s+(?:it|this|that|the\\s+\\w+(?:\\s+\\w+)?)\\s+(?:over\\s+)?to',
+};
 /**
  * Token usage: the unit, the stats endpoint, and the Codex / Antigravity
  * ledgers (specs/2026-10-02-spend-cap.md).
@@ -9058,4 +9247,23 @@ export const BROWSER_PRIORITY_CONSTANTS = {
         ].join('\n');
     },
 };
+/**
+ * Ticket holds (crewly#1369 gap 1): a ticket the owner put on hold ("do not
+ * merge PR #1138") blocks follow-up work on the same PR / branch / worktree.
+ * Only closing the PR and removing the worktree stays allowed.
+ */
+export const TICKET_HOLD_CONSTANTS = {
+    /** Labels that put a ticket on hold */
+    LABELS: ['hold', 'on-hold', 'on_hold', 'held'],
+    /** Prefix of the Log line written when a hold is set */
+    LOG_PREFIX: 'HOLD:',
+    /** Log line written when a hold is lifted */
+    LIFT_LOG_LINE: 'hold lifted',
+    /** Prefix of the hold reason of a ticket held because it references a held ticket */
+    LINKED_PREFIX: 'held by',
+    /** What may still be done about held work */
+    ALLOWED_ACTIONS: 'close the PR and remove the worktree',
+    /** Max characters of a hold reason quoted in a message */
+    REASON_MAX_CHARS: 240,
+};
 //# sourceMappingURL=constants.js.map