lorenz 0.1.0

package/extensions/slack-tracker/dist/operations.d.ts

@@ -0,0 +1,41 @@
+import type { Settings } from "@lorenz/domain";
+import type { SlackMessage, SlackTransport } from "./transport.js";
+/**
+ * The configured bot user id, or a clear configuration error. Every agent-facing read and
+ * write requires it: without one the mention matcher would fall back to matching ANY user
+ * mention, so the tools fail closed instead of operating on (or revealing) untracked messages.
+ */
+export declare function requireBotUserId(settings: Settings): string;
+/**
+ * Enforce the agent trust boundary: the issueId must reference a configured (watched) channel
+ * and an existing message that is tracked - the root mentions the bot, the bot has marked it
+ * (its own reaction), or a thread reply mentions the bot. Throws with a caller-facing message
+ * otherwise.
+ */
+export declare function requireTrackedMessage(settings: Settings, transport: SlackTransport, channel: string, ts: string): Promise<SlackMessage>;
+/** Outcome of a status transition; `root` is the tracked root fetched for the trust check. */
+export type SlackStatusUpdateOutcome = {
+    ok: true;
+    status: string;
+    root: SlackMessage;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Set a Slack issue's status by posting the bot's authoritative `status: <Name>` thread reply.
+ *
+ * The thread is the source of truth (see threadState.ts): the posted reply is ts-ordered
+ * against human commands and is acknowledged by Slack, so there is nothing to roll back or
+ * verify. The bot then mirrors the state onto its OWN reactions best-effort for glanceability -
+ * reactions are per-author in Slack, so the mirror never touches (and never depends on
+ * removing) anyone else's reactions, and mirror failures never fail the transition.
+ */
+export declare function updateSlackStatus(settings: Settings, transport: SlackTransport, channel: string, ts: string, status: string): Promise<SlackStatusUpdateOutcome>;
+/**
+ * Best-effort visibility mirror: add the bot's reaction for the new state (when one is mapped)
+ * and drop the bot's own other managed reactions. `reactions.remove` only removes the caller's
+ * own reaction, so human-authored reactions are untouched by construction.
+ */
+export declare function mirrorStatusReaction(settings: Settings, transport: SlackTransport, channel: string, ts: string, state: string): Promise<void>;
+//# sourceMappingURL=operations.d.ts.map

package/extensions/slack-tracker/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAQ3D;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,YAAY,CAAC,CAoBvB;AAED,8FAA8F;AAC9F,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAChD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC,CAgBnC;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/extensions/slack-tracker/dist/operations.js

@@ -0,0 +1,97 @@
+import { emojiForState, isBotMention, statusEmojiMap } from "./mapping.js";
+import { slackTrackerOptions } from "./options.js";
+import { BOT_STATUS_PREFIX, resolveStateName } from "./threadState.js";
+/**
+ * The configured bot user id, or a clear configuration error. Every agent-facing read and
+ * write requires it: without one the mention matcher would fall back to matching ANY user
+ * mention, so the tools fail closed instead of operating on (or revealing) untracked messages.
+ */
+export function requireBotUserId(settings) {
+    const { botUserId } = slackTrackerOptions(settings);
+    if (!botUserId || botUserId.trim() === "") {
+        throw new Error("slack tools are unavailable: tracker.bot_user_id (or SLACK_BOT_USER_ID) is not configured");
+    }
+    return botUserId;
+}
+/**
+ * Enforce the agent trust boundary: the issueId must reference a configured (watched) channel
+ * and an existing message that is tracked - the root mentions the bot, the bot has marked it
+ * (its own reaction), or a thread reply mentions the bot. Throws with a caller-facing message
+ * otherwise.
+ */
+export async function requireTrackedMessage(settings, transport, channel, ts) {
+    const { channels } = slackTrackerOptions(settings);
+    const botUserId = requireBotUserId(settings);
+    if (!channels.includes(channel)) {
+        throw new Error(`channel '${channel}' is not a configured tracker channel`);
+    }
+    const message = await transport.getMessage(channel, ts);
+    if (!message) {
+        throw new Error(`no tracked issue at ${channel}:${ts}`);
+    }
+    if (isBotMention(message.text, botUserId) || message.botReacted === true) {
+        return message;
+    }
+    // Reply-tracked thread: the request lives in a reply rather than the root. Last resort
+    // because it costs a conversations.replies fetch.
+    if ((message.replyCount ?? 0) > 0) {
+        const replies = await transport.getThread(channel, ts);
+        if (replies.some((reply) => isBotMention(reply.text, botUserId)))
+            return message;
+    }
+    throw new Error("message is not a tracked bot-mention issue");
+}
+/**
+ * Set a Slack issue's status by posting the bot's authoritative `status: <Name>` thread reply.
+ *
+ * The thread is the source of truth (see threadState.ts): the posted reply is ts-ordered
+ * against human commands and is acknowledged by Slack, so there is nothing to roll back or
+ * verify. The bot then mirrors the state onto its OWN reactions best-effort for glanceability -
+ * reactions are per-author in Slack, so the mirror never touches (and never depends on
+ * removing) anyone else's reactions, and mirror failures never fail the transition.
+ */
+export async function updateSlackStatus(settings, transport, channel, ts, status) {
+    const canonical = resolveStateName(status, settings);
+    if (canonical === null) {
+        return {
+            ok: false,
+            message: `unknown status '${status}': use one of the workflow's active/terminal states ` +
+                `(${[...settings.tracker.activeStates, ...settings.tracker.terminalStates].join(", ")})`,
+        };
+    }
+    // Trust-boundary check: the agent-supplied issueId must point at a watched channel and a
+    // tracked message before we write into its thread.
+    const root = await requireTrackedMessage(settings, transport, channel, ts);
+    await transport.postReply(channel, ts, `${BOT_STATUS_PREFIX} ${canonical}`);
+    await mirrorStatusReaction(settings, transport, channel, ts, canonical);
+    return { ok: true, status: canonical, root };
+}
+/**
+ * Best-effort visibility mirror: add the bot's reaction for the new state (when one is mapped)
+ * and drop the bot's own other managed reactions. `reactions.remove` only removes the caller's
+ * own reaction, so human-authored reactions are untouched by construction.
+ */
+export async function mirrorStatusReaction(settings, transport, channel, ts, state) {
+    const map = statusEmojiMap(settings);
+    const target = emojiForState(state, map);
+    const managed = Object.keys(map);
+    for (const emoji of managed) {
+        if (emoji === target)
+            continue;
+        try {
+            await transport.removeReaction(channel, ts, emoji);
+        }
+        catch {
+            // Mirror only; the thread reply already carries the authoritative state.
+        }
+    }
+    if (target) {
+        try {
+            await transport.addReaction(channel, ts, target);
+        }
+        catch {
+            // Mirror only; the thread reply already carries the authoritative state.
+        }
+    }
+}
+//# sourceMappingURL=operations.js.map

package/extensions/slack-tracker/dist/operations.js.map

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

package/extensions/slack-tracker/dist/options.d.ts

@@ -0,0 +1,30 @@
+import type { Settings } from "@lorenz/domain";
+export declare const SLACK_DEFAULT_ENDPOINT = "https://slack.com/api";
+/** Slack-specific keys of the selected tracker bundle, validated by the provider. */
+export interface SlackTrackerOptions {
+    /** Slack channel IDs to watch for mentions. */
+    channels: string[];
+    /**
+     * Slack user id of the bot/worker identity (e.g. `"U0123ABCD"`). Only messages that
+     * mention this user become candidate issues; the production transport fails closed
+     * (matches nothing) when it is unset.
+     */
+    botUserId?: string | undefined;
+    /** Slack emoji-name → workflow-state overrides (merged over the defaults). */
+    emojiStates?: Record<string, string> | undefined;
+    /** Emoji the bot reacts with to mark a reply-tracked thread root (default `robot_face`). */
+    markerEmoji?: string | undefined;
+    /**
+     * How far back (days) untracked threads are inspected for new reply-mention requests
+     * (default 2). Already-tracked threads are recognized by the marker regardless of age.
+     */
+    replyLookbackDays?: number | undefined;
+}
+/** Typed view over `settings.tracker.options` for the Slack provider. */
+export declare function slackTrackerOptions(settings: Settings): SlackTrackerOptions;
+/** Read an optional non-negative number option; throws when present but malformed. */
+export declare function numberOption(options: Record<string, unknown>, key: string): number | undefined;
+/** The Slack Web API base URL for the configured tracker (trailing slashes stripped). */
+export declare function slackEndpoint(settings: Settings): string;
+export declare function emojiStatesValue(value: unknown): Record<string, string> | undefined;
+//# sourceMappingURL=options.d.ts.map

package/extensions/slack-tracker/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAE9D,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,mBAAmB,CAa3E;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9F;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAExD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAcnF"}

package/extensions/slack-tracker/dist/options.js

@@ -0,0 +1,49 @@
+import { isRecord } from "@lorenz/domain";
+import { stringListOption, stringOption } from "@lorenz/tracker-sdk";
+export const SLACK_DEFAULT_ENDPOINT = "https://slack.com/api";
+/** Typed view over `settings.tracker.options` for the Slack provider. */
+export function slackTrackerOptions(settings) {
+    const options = settings.tracker.options;
+    const botUserId = stringOption(options, "botUserId");
+    const emojiStates = emojiStatesValue(options.emojiStates);
+    const markerEmoji = stringOption(options, "markerEmoji");
+    const replyLookbackDays = numberOption(options, "replyLookbackDays");
+    return {
+        channels: stringListOption(options, "channels") ?? [],
+        ...(botUserId !== undefined ? { botUserId } : {}),
+        ...(emojiStates !== undefined ? { emojiStates } : {}),
+        ...(markerEmoji !== undefined ? { markerEmoji } : {}),
+        ...(replyLookbackDays !== undefined ? { replyLookbackDays } : {}),
+    };
+}
+/** Read an optional non-negative number option; throws when present but malformed. */
+export function numberOption(options, key) {
+    const value = options[key];
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        throw new Error(`tracker.${key} must be a non-negative number`);
+    }
+    return value;
+}
+/** The Slack Web API base URL for the configured tracker (trailing slashes stripped). */
+export function slackEndpoint(settings) {
+    return (settings.tracker.endpoint || SLACK_DEFAULT_ENDPOINT).replace(/\/+$/, "");
+}
+export function emojiStatesValue(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (!isRecord(value)) {
+        throw new Error("tracker.emoji_states must be a mapping of emoji name to state name");
+    }
+    const out = {};
+    // Sorted keys: nested option records are hashed in insertion order by the MCP auth scope, so
+    // a semantically identical YAML reorder must not change the parsed identity.
+    for (const [emoji, state] of Object.entries(value).sort(([a], [b]) => (a < b ? -1 : 1))) {
+        if (typeof state !== "string")
+            throw new Error(`tracker.emoji_states.${emoji} must be a string`);
+        out[emoji] = state;
+    }
+    return out;
+}
+//# sourceMappingURL=options.js.map

package/extensions/slack-tracker/dist/options.js.map

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

package/extensions/slack-tracker/dist/provider.d.ts

@@ -0,0 +1,9 @@
+import type { TrackerProvider } from "@lorenz/tracker-sdk";
+/**
+ * Slack tracker: an @-mention of the bot is an issue, the message's thread carries the status
+ * (human `@bot` commands and bot `status:` replies, latest wins; reactions are a bot-owned
+ * visibility mirror) and the progress discussion. Issues are polled from the watched channels
+ * over the Slack Web API.
+ */
+export declare const slackTrackerProvider: TrackerProvider;
+//# sourceMappingURL=provider.d.ts.map

package/extensions/slack-tracker/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkB3D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAwElC,CAAC"}

package/extensions/slack-tracker/dist/provider.js

@@ -0,0 +1,74 @@
+import { rejectUnknownOptions, resolveEnvReference, stringListOption, stringOption, } from "@lorenz/tracker-sdk";
+import { SlackTrackerClient } from "./client.js";
+import { emojiStatesValue, numberOption, SLACK_DEFAULT_ENDPOINT, slackTrackerOptions, } from "./options.js";
+import { slackToolOps } from "./toolOps.js";
+import { SlackWebTransport } from "./webTransport.js";
+/**
+ * Slack tracker: an @-mention of the bot is an issue, the message's thread carries the status
+ * (human `@bot` commands and bot `status:` replies, latest wins; reactions are a bot-owned
+ * visibility mirror) and the progress discussion. Issues are polled from the watched channels
+ * over the Slack Web API.
+ */
+export const slackTrackerProvider = {
+    kind: "slack",
+    configAliases: {
+        bot_user_id: "botUserId",
+        emoji_states: "emojiStates",
+        marker_emoji: "markerEmoji",
+        reply_lookback_days: "replyLookbackDays",
+    },
+    envFallbacks: { apiKey: "SLACK_BOT_TOKEN" },
+    defaultEndpoint: SLACK_DEFAULT_ENDPOINT,
+    parseOptions(options, context) {
+        rejectUnknownOptions(options, ["channels", "botUserId", "emojiStates", "markerEmoji", "replyLookbackDays"], "slack");
+        // Channel entries resolve `$VAR` references like the documented bot_user_id one line below
+        // them; an unresolved reference collapses to empty and is dropped, so an all-empty list
+        // fails dispatch validation instead of polling a literal "$SLACK_CHANNEL_ID" forever.
+        const channels = stringListOption(options, "channels")
+            ?.map((channel) => resolveEnvReference(channel, context.env))
+            .filter((channel) => channel !== "");
+        const botUserId = context.resolveSecret?.(stringOption(options, "botUserId"), "SLACK_BOT_USER_ID");
+        const emojiStates = emojiStatesValue(options.emojiStates);
+        const markerEmoji = stringOption(options, "markerEmoji");
+        const replyLookbackDays = numberOption(options, "replyLookbackDays");
+        return {
+            ...(channels !== undefined && channels.length > 0 ? { channels } : {}),
+            ...(botUserId !== undefined ? { botUserId } : {}),
+            ...(emojiStates !== undefined ? { emojiStates } : {}),
+            ...(markerEmoji !== undefined ? { markerEmoji } : {}),
+            ...(replyLookbackDays !== undefined ? { replyLookbackDays } : {}),
+        };
+    },
+    validateDispatch(settings) {
+        if (!settings.tracker.apiKey) {
+            throw new Error("tracker.api_key (or SLACK_BOT_TOKEN) is required for the slack tracker");
+        }
+        if (settings.tracker.assignee) {
+            // Fail fast rather than silently dispatch everything: slack messages carry no assignee
+            // concept, so an assignee-partitioned deployment would double-dispatch every mention.
+            throw new Error("tracker.assignee is not supported by the slack tracker; remove it (slack issues have " +
+                "no assignee to filter on)");
+        }
+        const { channels, botUserId } = slackTrackerOptions(settings);
+        if (channels.length === 0) {
+            throw new Error("tracker.channels is required for the slack tracker");
+        }
+        if (!botUserId || botUserId.trim() === "") {
+            throw new Error("tracker.bot_user_id (or SLACK_BOT_USER_ID) is required for the slack tracker so issue " +
+                "creation is scoped to the bot's own mentions; without it any human-to-human mention " +
+                "in a watched channel would spawn an agent");
+        }
+    },
+    createClient: (settings) => new SlackTrackerClient(settings, new SlackWebTransport(settings)),
+    createToolOps: (settings, context) => slackToolOps(settings, context),
+    defaultToolPacks: () => ["slack"],
+    projectUrl(settings) {
+        // slack.com/app_redirect opens the channel in whichever workspace the operator is signed
+        // into - the only deterministic deep link available without an API round-trip.
+        const channel = slackTrackerOptions(settings).channels[0];
+        return channel
+            ? `https://slack.com/app_redirect?channel=${encodeURIComponent(channel)}`
+            : undefined;
+    },
+};
+//# sourceMappingURL=provider.js.map

package/extensions/slack-tracker/dist/provider.js.map

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

package/extensions/slack-tracker/dist/register.d.ts

@@ -0,0 +1,11 @@
+import { type ToolRegistry } from "@lorenz/tool-sdk";
+import { type TrackerRegistry } from "@lorenz/tracker-sdk";
+/**
+ * Register this extension's tracker provider and tool pack. Idempotent; called by the
+ * composition root (or a test) against its registries, defaulting to the process-wide ones.
+ */
+export declare function registerSlackTracker(registries?: {
+    trackers?: TrackerRegistry;
+    tools?: ToolRegistry;
+}): void;
+//# sourceMappingURL=register.d.ts.map

package/extensions/slack-tracker/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAKnF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,GAAE;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAAO,GACpE,IAAI,CASN"}

package/extensions/slack-tracker/dist/register.js

@@ -0,0 +1,19 @@
+import { defaultToolRegistry } from "@lorenz/tool-sdk";
+import { defaultTrackerRegistry } from "@lorenz/tracker-sdk";
+import { slackTrackerProvider } from "./provider.js";
+import { slackToolProvider } from "./tools.js";
+/**
+ * Register this extension's tracker provider and tool pack. Idempotent; called by the
+ * composition root (or a test) against its registries, defaulting to the process-wide ones.
+ */
+export function registerSlackTracker(registries = {}) {
+    const trackers = registries.trackers ?? defaultTrackerRegistry;
+    const tools = registries.tools ?? defaultToolRegistry;
+    if (trackers.get(slackTrackerProvider.kind) === undefined) {
+        trackers.register(slackTrackerProvider);
+    }
+    if (tools.get(slackToolProvider.name) === undefined) {
+        tools.register(slackToolProvider);
+    }
+}
+//# sourceMappingURL=register.js.map

package/extensions/slack-tracker/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAqB,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAwB,MAAM,qBAAqB,CAAC;AAEnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,aAAmE,EAAE;IAErE,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,sBAAsB,CAAC;IAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,mBAAmB,CAAC;IACtD,IAAI,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QAC1D,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACpD,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/extensions/slack-tracker/dist/threadState.d.ts

@@ -0,0 +1,52 @@
+import type { Settings } from "@lorenz/domain";
+import type { SlackMessage, SlackThreadReply, SlackTransport } from "./transport.js";
+/**
+ * Thread-command state model. Slack reactions are per-author (the bot cannot remove a human's
+ * reaction and vice versa), so reactions cannot carry a jointly-edited status. The thread is the
+ * shared, ts-ordered medium both sides can write to, so STATUS LIVES IN THE THREAD:
+ *
+ * - Humans transition status by mentioning the bot with a `!`-prefixed command reply:
+ *   `@bot !done`, `@bot !cancel`, `@bot !reopen`, `@bot !status <Name>`. The bang keeps
+ *   transitions unmistakable next to ordinary prompts addressed to the bot.
+ * - The bot (agent/runtime) transitions status by posting a `status: <Name>` reply.
+ * - A bot-mention reply with NO command re-opens a terminal issue to the default
+ *   non-terminal state: mentioning the bot again always means "this needs attention".
+ * - The latest event by ts wins. Reactions remain a bot-owned visibility mirror and the
+ *   back-compat source for threads that have never seen a command or bot status reply.
+ */
+/** Recognized prefix of the bot's own authoritative status replies. */
+export declare const BOT_STATUS_PREFIX = "status:";
+/**
+ * Resolve a state name case-insensitively against the configured states (config casing wins)
+ * and the standard names; `null` when unknown.
+ */
+export declare function resolveStateName(name: string, settings: Settings): string | null;
+/**
+ * Parse a human status command: a reply that STARTS with the bot mention, followed by a
+ * `!`-prefixed keyword or `!status <Name>` as the remaining first line. The explicit `!`
+ * separates transitions from ordinary prompts: `@bot !done` transitions, while `@bot done`
+ * (or any other phrasing) is a bare mention. Anything without the bang is a bare mention.
+ */
+export declare function parseStatusCommand(text: string, botUserId: string | undefined, settings: Settings): {
+    state: string;
+} | null;
+/** Derived status of one tracked thread plus, for reply-tracked threads, the request reply. */
+export interface ThreadState {
+    state: string;
+    /** First bot-mention reply when the ROOT does not mention the bot (the actual request). */
+    request?: {
+        ts: string;
+        text: string;
+        user?: string | undefined;
+    } | undefined;
+}
+/**
+ * Fold a thread into its current state. Events (bot `status:` replies and human command
+ * mentions) are applied in ts order and the latest wins; with no events at all the state falls
+ * back to the reaction-derived reading (back-compat for reaction-managed threads). A trailing
+ * bare bot-mention re-opens a terminal state.
+ */
+export declare function stateFromThread(root: SlackMessage, replies: SlackThreadReply[], settings: Settings): ThreadState;
+/** Resolve a tracked root's thread state, fetching replies only when the thread changed. */
+export declare function resolveThreadState(settings: Settings, transport: SlackTransport, root: SlackMessage): Promise<ThreadState>;
+//# sourceMappingURL=threadState.d.ts.map

package/extensions/slack-tracker/dist/threadState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threadState.d.ts","sourceRoot":"","sources":["../src/threadState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAU/C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErF;;;;;;;;;;;;;GAaG;AAEH,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,YAAY,CAAC;AA4B3C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAShF;AAeD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,QAAQ,GACjB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoB1B;AAED,+FAA+F;AAC/F,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;CAC/E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,QAAQ,EAAE,QAAQ,GACjB,WAAW,CAiDb;AAuBD,4FAA4F;AAC5F,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,cAAc,EACzB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAsBtB"}

package/extensions/slack-tracker/dist/threadState.js

@@ -0,0 +1,192 @@
+import { defaultStateType } from "@lorenz/issue";
+import { isBotMention, stateFromReactions, statusEmojiMap, stripLeadingMention, } from "./mapping.js";
+import { slackTrackerOptions } from "./options.js";
+/**
+ * Thread-command state model. Slack reactions are per-author (the bot cannot remove a human's
+ * reaction and vice versa), so reactions cannot carry a jointly-edited status. The thread is the
+ * shared, ts-ordered medium both sides can write to, so STATUS LIVES IN THE THREAD:
+ *
+ * - Humans transition status by mentioning the bot with a `!`-prefixed command reply:
+ *   `@bot !done`, `@bot !cancel`, `@bot !reopen`, `@bot !status <Name>`. The bang keeps
+ *   transitions unmistakable next to ordinary prompts addressed to the bot.
+ * - The bot (agent/runtime) transitions status by posting a `status: <Name>` reply.
+ * - A bot-mention reply with NO command re-opens a terminal issue to the default
+ *   non-terminal state: mentioning the bot again always means "this needs attention".
+ * - The latest event by ts wins. Reactions remain a bot-owned visibility mirror and the
+ *   back-compat source for threads that have never seen a command or bot status reply.
+ */
+/** Recognized prefix of the bot's own authoritative status replies. */
+export const BOT_STATUS_PREFIX = "status:";
+const BOT_STATUS_RE = /^status:\s*(.+?)\s*$/i;
+/** Standard state names recognized even when a workflow does not list them explicitly. */
+const STANDARD_STATES = ["Todo", "In Progress", "Done", "Cancelled"];
+/** Command keywords (the `!`-prefixed reply body after the mention, punctuation-insensitive). */
+const COMMAND_STATES = [
+    {
+        keywords: ["done", "complete", "completed", "finished"],
+        state: (settings) => resolveStateName("Done", settings) ?? "Done",
+    },
+    {
+        keywords: ["cancel", "cancelled", "canceled", "stop"],
+        state: (settings) => resolveStateName("Cancelled", settings) ?? "Cancelled",
+    },
+    { keywords: ["reopen", "rework", "retry"], state: (settings) => reopenState(settings) },
+    {
+        keywords: ["in progress", "start", "started", "wip"],
+        state: (settings) => resolveStateName("In Progress", settings) ?? "In Progress",
+    },
+    {
+        keywords: ["todo", "backlog"],
+        state: (settings) => resolveStateName("Todo", settings) ?? "Todo",
+    },
+];
+/**
+ * Resolve a state name case-insensitively against the configured states (config casing wins)
+ * and the standard names; `null` when unknown.
+ */
+export function resolveStateName(name, settings) {
+    const target = name.trim().toLowerCase();
+    if (target === "")
+        return null;
+    const pool = [
+        ...settings.tracker.activeStates,
+        ...settings.tracker.terminalStates,
+        ...STANDARD_STATES,
+    ];
+    return pool.find((state) => state.trim().toLowerCase() === target) ?? null;
+}
+/** The state a bare re-mention re-opens to: the first configured active state. */
+function reopenState(settings) {
+    return settings.tracker.activeStates[0] ?? "Todo";
+}
+/** Terminal by configuration, or by the standard category when the name is a standard one. */
+function isTerminalState(state, settings) {
+    const target = state.trim().toLowerCase();
+    if (settings.tracker.terminalStates.some((s) => s.trim().toLowerCase() === target))
+        return true;
+    const category = defaultStateType(state);
+    return category === "completed" || category === "canceled";
+}
+/**
+ * Parse a human status command: a reply that STARTS with the bot mention, followed by a
+ * `!`-prefixed keyword or `!status <Name>` as the remaining first line. The explicit `!`
+ * separates transitions from ordinary prompts: `@bot !done` transitions, while `@bot done`
+ * (or any other phrasing) is a bare mention. Anything without the bang is a bare mention.
+ */
+export function parseStatusCommand(text, botUserId, settings) {
+    const trimmed = text.trim();
+    const stripped = stripLeadingMention(trimmed, botUserId);
+    if (stripped === trimmed)
+        return null; // the mention is not leading: not a command form
+    const firstLine = (stripped.split("\n")[0] ?? "").trim();
+    if (!firstLine.startsWith("!"))
+        return null; // no bang: an ordinary prompt, not a transition
+    const body = firstLine
+        .slice(1)
+        .trim()
+        .replace(/[.!?]+$/, "");
+    const explicit = /^status:?\s+(.+)$/i.exec(body);
+    if (explicit) {
+        const state = resolveStateName(explicit[1], settings);
+        return state ? { state } : null;
+    }
+    const lower = body.toLowerCase();
+    for (const command of COMMAND_STATES) {
+        if (command.keywords.includes(lower))
+            return { state: command.state(settings) };
+    }
+    return null;
+}
+/**
+ * Fold a thread into its current state. Events (bot `status:` replies and human command
+ * mentions) are applied in ts order and the latest wins; with no events at all the state falls
+ * back to the reaction-derived reading (back-compat for reaction-managed threads). A trailing
+ * bare bot-mention re-opens a terminal state.
+ */
+export function stateFromThread(root, replies, settings) {
+    const { botUserId } = slackTrackerOptions(settings);
+    const ordered = [...replies].sort((a, b) => tsValue(a.ts) - tsValue(b.ts));
+    const rootIsMention = isBotMention(root.text, botUserId);
+    const events = [];
+    const bareMentionTs = [];
+    let request;
+    for (const reply of ordered) {
+        if (botUserId !== undefined && reply.user === botUserId) {
+            const status = BOT_STATUS_RE.exec(reply.text.trim());
+            if (status) {
+                const state = resolveStateName(status[1], settings);
+                if (state)
+                    events.push({ ts: reply.ts, state });
+            }
+            continue;
+        }
+        if (!isBotMention(reply.text, botUserId))
+            continue;
+        if (!rootIsMention && request === undefined) {
+            // The first mention in a non-mention thread is the request itself, not a transition.
+            request = { ts: reply.ts, text: reply.text, user: reply.user };
+            continue;
+        }
+        const command = parseStatusCommand(reply.text, botUserId, settings);
+        if (command)
+            events.push({ ts: reply.ts, state: command.state });
+        else
+            bareMentionTs.push(reply.ts);
+    }
+    let state;
+    let lastEventTs;
+    const lastEvent = events[events.length - 1];
+    if (lastEvent) {
+        state = lastEvent.state;
+        lastEventTs = tsValue(lastEvent.ts);
+    }
+    else if (rootIsMention) {
+        state = stateFromReactions(root.reactions, statusEmojiMap(settings), settings);
+        // Reactions carry no ordering, so any later bare mention may re-open a terminal reading.
+        lastEventTs = Number.NEGATIVE_INFINITY;
+    }
+    else {
+        state = "Todo";
+        lastEventTs = Number.NEGATIVE_INFINITY;
+    }
+    if (isTerminalState(state, settings) && bareMentionTs.some((ts) => tsValue(ts) > lastEventTs)) {
+        state = reopenState(settings);
+    }
+    return { state, ...(request !== undefined ? { request } : {}) };
+}
+function tsValue(ts) {
+    const value = Number.parseFloat(ts);
+    return Number.isFinite(value) ? value : 0;
+}
+/**
+ * Cross-call cache: thread state only changes when the thread (or the root's reactions)
+ * changes, and `conversations.history` reports `latest_reply`/`reply_count` on every scan, so
+ * unchanged threads never pay a `conversations.replies` fetch. Module-level because the tool
+ * packs construct a fresh transport per call.
+ */
+const threadStateCache = new Map();
+const THREAD_STATE_CACHE_MAX = 5_000;
+/** Resolve a tracked root's thread state, fetching replies only when the thread changed. */
+export async function resolveThreadState(settings, transport, root) {
+    const replyCount = root.replyCount ?? 0;
+    if (replyCount === 0) {
+        return stateFromThread(root, [], settings);
+    }
+    const key = `${root.channel}:${root.ts}`;
+    const latestReply = root.latestReply ?? "";
+    const reactionsKey = [...root.reactions].sort().join(",");
+    const cached = threadStateCache.get(key);
+    if (cached &&
+        cached.latestReply === latestReply &&
+        cached.replyCount === replyCount &&
+        cached.reactionsKey === reactionsKey) {
+        return cached.resolved;
+    }
+    const replies = await transport.getThread(root.channel, root.ts);
+    const resolved = stateFromThread(root, replies, settings);
+    if (threadStateCache.size >= THREAD_STATE_CACHE_MAX)
+        threadStateCache.clear();
+    threadStateCache.set(key, { latestReply, replyCount, reactionsKey, resolved });
+    return resolved;
+}
+//# sourceMappingURL=threadState.js.map