@urateam/core 0.1.31 → 0.1.32

package/dist/pm/actions/triage.js

@@ -1,10 +1,31 @@
 import { parseJsonObject } from "../../executor/agent-stream.js";
 import { resolveWorkflowStates } from "../linear-helpers.js";
+import { resolveIssueRelations } from "../../util/linear.js";
 import { createLogger } from "../../logger.js";
 import { logAuditEventUnchecked, pmTriageClassifiedEvent } from "../../audit/index.js";
 const log = createLogger({ component: "PmAgent:triage" });
 const MAX_ISSUES_PER_TICK = 10;
 const DEFAULT_BATCH_SIZE = 3;
+/**
+ * Marker embedded in the body of every GitHub issue filed by the urateam
+ * quality-observer. `gh-linear-sync` copies the GitHub body verbatim into the
+ * Linear ticket description, so the marker survives the sync and is the
+ * authoritative way to detect observer-origin tickets on the Linear side
+ * (labels are not propagated by gh-linear-sync).
+ *
+ * Source of truth: urateam-quality-observer/src/github-issue-writer.ts.
+ */
+const OBSERVER_BODY_MARKER = "<!-- urateam-qo-observer:";
+/**
+ * Pipeline label assigned to observer-origin tickets. `needs-design` includes
+ * an `await-approval` stage that blocks until a human approves, so these
+ * findings surface without burning implement-stage tokens on a non-actionable
+ * diagnostic. See CLAUDE.md "Quality Observer" for the rationale.
+ */
+const OBSERVER_PIPELINE_LABEL = "needs-design";
+function isObserverOriginIssue(description) {
+    return typeof description === "string" && description.includes(OBSERVER_BODY_MARKER);
+}
 /**
  * Process an array of items in batches of `size`, awaiting each batch before
  * starting the next. Returns a flat array of results (preserving order).
@@ -38,6 +59,49 @@ export async function triageNewIssues(input) {
     }
     const results = (await runInBatches(issues.slice(0, MAX_ISSUES_PER_TICK), batchSize, async (issue) => {
         try {
+            if (isObserverOriginIssue(issue.description)) {
+                const team = await issue.team;
+                const teamId = team?.id;
+                const backlogStateId = teamId ? stateMap.get(`${teamId}:Backlog`) : undefined;
+                const issueLabels = [OBSERVER_PIPELINE_LABEL];
+                const labelIds = issueLabels
+                    .map((l) => labelMap.get(l.toLowerCase()))
+                    .filter(Boolean);
+                if (labelIds.length === 0) {
+                    log.warn({ issueId: issue.identifier, label: OBSERVER_PIPELINE_LABEL }, "observer-origin gate: '" + OBSERVER_PIPELINE_LABEL +
+                        "' label not found in Linear — issue will move to Backlog without pipeline label and won't be routed by promote");
+                }
+                const rationale = "Observer-origin finding (body marker detected) — routed to needs-design so the await-approval stage gates a human before any implement-stage work runs.";
+                const updatePayload = { priority: 3 };
+                if (labelIds.length > 0)
+                    updatePayload.labelIds = labelIds;
+                if (backlogStateId)
+                    updatePayload.stateId = backlogStateId;
+                await linearClient.updateIssue(issue.id, updatePayload);
+                await linearClient.createComment({
+                    issueId: issue.id,
+                    body: `🤖 **PM Agent — Triaged (Quality Observer finding)**\n\n` +
+                        `**Pipeline:** ${OBSERVER_PIPELINE_LABEL}\n` +
+                        `**Rationale:** ${rationale}`,
+                });
+                const result = {
+                    issueId: issue.identifier,
+                    priority: 3,
+                    labels: issueLabels,
+                    complexity: "medium",
+                    rationale,
+                    acceptanceCriteria: [],
+                };
+                if (input.db) {
+                    void logAuditEventUnchecked(input.db, pmTriageClassifiedEvent({
+                        issueId: issue.identifier,
+                        label: OBSERVER_PIPELINE_LABEL,
+                        rationale,
+                    }));
+                }
+                log.info({ issueId: issue.identifier, pipelineLabel: OBSERVER_PIPELINE_LABEL }, "triaged observer-origin issue (skipped Claude classification)");
+                return result;
+            }
             const sanitizedDesc = sanitize(issue.description ?? "");
             const prompt = `Classify this software issue and generate acceptance criteria. Respond with ONLY a JSON object, no other text.\n\n` +
                 `Issue: ${issue.identifier}\n` +
@@ -67,7 +131,9 @@ export async function triageNewIssues(input) {
             const labelIds = issueLabels
                 .map((l) => labelMap.get(l.toLowerCase()))
                 .filter(Boolean);
-            const team = await issue.team;
+            // Resolve the issue's team relation (parallelised with state/labels via
+            // resolveIssueRelations for consistency; only team is needed here).
+            const { team } = await resolveIssueRelations(issue);
             const teamId = team?.id;
             const backlogStateId = teamId ? stateMap.get(`${teamId}:Backlog`) : undefined;
             const acceptanceCriteria = Array.isArray(parsed.acceptanceCriteria)

package/dist/pm/actions/triage.js.map

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

package/dist/pm/linear-helpers.d.ts

@@ -8,9 +8,19 @@
  *   const linear = await getClient(); // null if apiKey is undefined
  *
  * @param apiKey Linear API key. When undefined/empty, `getClient()` returns null.
+ *
+ * @deprecated Prefer `getLinearClient(apiKey)` from `util/linear.ts` directly.
+ *   This wrapper is retained for backwards compatibility with existing callers.
  */
 export declare function createLazyLinearClient(apiKey: string | undefined): {
     getClient: () => Promise<any>;
 };
+/**
+ * Fetches workflow states for the given teams and builds a
+ * `${teamId}:${stateName}` → stateId map.
+ *
+ * Delegates to `resolveWorkflowStatesByTeam` from `util/linear.ts`, which
+ * parallelizes all `state.team` relation fetches via Promise.all.
+ */
 export declare function resolveWorkflowStates(linearClient: any, teamIds: string[]): Promise<Map<string, string>>;
 //# sourceMappingURL=linear-helpers.d.ts.map

package/dist/pm/linear-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linear-helpers.d.ts","sourceRoot":"","sources":["../../src/pm/linear-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG;IAClE,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;CAC/B,CAWA;AAED,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,GAAG,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAa9B"}
+{"version":3,"file":"linear-helpers.d.ts","sourceRoot":"","sources":["../../src/pm/linear-helpers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG;IAClE,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;CAC/B,CAIA;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,GAAG,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE9B"}

package/dist/pm/linear-helpers.js

@@ -1,3 +1,4 @@
+import { getLinearClient, resolveWorkflowStatesByTeam } from "../util/linear.js";
 /**
  * Creates a lazy-initialized Linear client singleton.
  * The client is instantiated on the first call to `getClient()` and reused
@@ -8,32 +9,23 @@
  *   const linear = await getClient(); // null if apiKey is undefined
  *
  * @param apiKey Linear API key. When undefined/empty, `getClient()` returns null.
+ *
+ * @deprecated Prefer `getLinearClient(apiKey)` from `util/linear.ts` directly.
+ *   This wrapper is retained for backwards compatibility with existing callers.
  */
 export function createLazyLinearClient(apiKey) {
-    let _client = null;
     return {
-        async getClient() {
-            if (!_client && apiKey) {
-                const { LinearClient } = await import("@linear/sdk");
-                _client = new LinearClient({ apiKey });
-            }
-            return _client;
-        },
+        getClient: () => getLinearClient(apiKey),
     };
 }
+/**
+ * Fetches workflow states for the given teams and builds a
+ * `${teamId}:${stateName}` → stateId map.
+ *
+ * Delegates to `resolveWorkflowStatesByTeam` from `util/linear.ts`, which
+ * parallelizes all `state.team` relation fetches via Promise.all.
+ */
 export async function resolveWorkflowStates(linearClient, teamIds) {
-    const allStates = await linearClient.workflowStates({
-        filter: { team: { id: { in: teamIds } } },
-        first: 100,
-    });
-    const stateMap = new Map();
-    for (const state of allStates.nodes ?? []) {
-        // state.team is a lazy relation in the Linear SDK — must await to resolve
-        const team = await state.team;
-        const teamId = team?.id;
-        if (teamId)
-            stateMap.set(`${teamId}:${state.name}`, state.id);
-    }
-    return stateMap;
+    return resolveWorkflowStatesByTeam(linearClient, teamIds);
 }
 //# sourceMappingURL=linear-helpers.js.map

package/dist/pm/linear-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"linear-helpers.js","sourceRoot":"","sources":["../../src/pm/linear-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA0B;IAG/D,IAAI,OAAO,GAAQ,IAAI,CAAC;IACxB,OAAO;QACL,KAAK,CAAC,SAAS;YACb,IAAI,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;gBACrD,OAAO,GAAG,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAAiB,EACjB,OAAiB;IAEjB,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,cAAc,CAAC;QAClD,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACzC,KAAK,EAAE,GAAG;KACX,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QAC1C,0EAA0E;QAC1E,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,EAAE,EAAE,CAAC;QACxB,IAAI,MAAM;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"linear-helpers.js","sourceRoot":"","sources":["../../src/pm/linear-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAEjF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA0B;IAG/D,OAAO;QACL,SAAS,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC;KACzC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAAiB,EACjB,OAAiB;IAEjB,OAAO,2BAA2B,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC"}

package/dist/pm/pause-state.d.ts

@@ -0,0 +1,29 @@
+/**
+ * PM Agent pause state — single-process shared mutable state for the pause/resume
+ * Slack commands. Extracted to a micro-module so that `slack-commands.ts` can read
+ * and write the flag without importing from `slack-interface.ts`, which would create
+ * a circular dependency (slack-interface imports slack-commands; slack-commands must
+ * not import back from slack-interface).
+ *
+ * Note: single-process only. For multi-process deploys, replace with a Redis-backed
+ * implementation.
+ */
+/**
+ * Returns `true` if the PM Agent is currently paused.
+ *
+ * Pause is active when EITHER of the following is true (OR logic):
+ * - `process.env.PM_AGENT_PAUSED === "true"` — env-var path for no-Slack incident
+ *   response. Toggling requires a container restart (env vars are read at each
+ *   tick invocation, not at module load time).
+ * - `setPmPaused(true)` has been called via the Slack `/pm pause` command.
+ *
+ * The env-var takes priority: setting `PM_AGENT_PAUSED=true` keeps the agent
+ * paused even if `setPmPaused(false)` is subsequently called via Slack.
+ */
+export declare function isPmPaused(): boolean;
+/**
+ * Sets the Slack-driven pause flag. Use `setPmPaused(true)` when the user
+ * sends `/pm pause` and `setPmPaused(false)` for `/pm resume`.
+ */
+export declare function setPmPaused(value: boolean): void;
+//# sourceMappingURL=pause-state.d.ts.map

package/dist/pm/pause-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pause-state.d.ts","sourceRoot":"","sources":["../../src/pm/pause-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEhD"}

package/dist/pm/pause-state.js

@@ -0,0 +1,34 @@
+/**
+ * PM Agent pause state — single-process shared mutable state for the pause/resume
+ * Slack commands. Extracted to a micro-module so that `slack-commands.ts` can read
+ * and write the flag without importing from `slack-interface.ts`, which would create
+ * a circular dependency (slack-interface imports slack-commands; slack-commands must
+ * not import back from slack-interface).
+ *
+ * Note: single-process only. For multi-process deploys, replace with a Redis-backed
+ * implementation.
+ */
+let paused = false;
+/**
+ * Returns `true` if the PM Agent is currently paused.
+ *
+ * Pause is active when EITHER of the following is true (OR logic):
+ * - `process.env.PM_AGENT_PAUSED === "true"` — env-var path for no-Slack incident
+ *   response. Toggling requires a container restart (env vars are read at each
+ *   tick invocation, not at module load time).
+ * - `setPmPaused(true)` has been called via the Slack `/pm pause` command.
+ *
+ * The env-var takes priority: setting `PM_AGENT_PAUSED=true` keeps the agent
+ * paused even if `setPmPaused(false)` is subsequently called via Slack.
+ */
+export function isPmPaused() {
+    return process.env.PM_AGENT_PAUSED === "true" || paused;
+}
+/**
+ * Sets the Slack-driven pause flag. Use `setPmPaused(true)` when the user
+ * sends `/pm pause` and `setPmPaused(false)` for `/pm resume`.
+ */
+export function setPmPaused(value) {
+    paused = value;
+}
+//# sourceMappingURL=pause-state.js.map

package/dist/pm/pause-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pause-state.js","sourceRoot":"","sources":["../../src/pm/pause-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,IAAI,MAAM,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC"}

package/dist/pm/slack-bulk.d.ts

@@ -0,0 +1,34 @@
+/**
+ * PM Agent — bulk issue creation via Claude analysis.
+ *
+ * Responsibility: given a free-text request from a Slack user, ask Claude Sonnet
+ * to produce a structured list of issue specifications that can be bulk-created
+ * in Linear.
+ *
+ * Extracted from `slack-interface.ts` (BEC-195) so that this single concern has
+ * its own file and can be unit-tested independently.
+ */
+/**
+ * A single issue specification produced by `analyzeBulkCreateRequest`.
+ * Each field maps directly to a Linear issue field; `acceptanceCriteria` are
+ * appended to the issue description as a checklist.
+ */
+export interface BulkIssueSpec {
+    title: string;
+    description: string;
+    priority: number;
+    acceptanceCriteria: string[];
+}
+/**
+ * Uses a capable Claude model (Sonnet) to analyze a bulk create request and
+ * produce a structured list of issue specifications ready for Linear creation.
+ *
+ * @param request - Free-text user request describing what issues to create
+ *   (e.g. "find all gaps in error handling and create tickets for them").
+ * @param callClaudeSonnet - Callable that sends a prompt to Claude Sonnet and
+ *   returns the raw text response.
+ * @returns Array of up to 10 `BulkIssueSpec` objects, or an empty array when
+ *   the request cannot be analyzed or Claude returns malformed JSON.
+ */
+export declare function analyzeBulkCreateRequest(request: string, callClaudeSonnet: (prompt: string) => Promise<string>): Promise<BulkIssueSpec[]>;
+//# sourceMappingURL=slack-bulk.d.ts.map

package/dist/pm/slack-bulk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-bulk.d.ts","sourceRoot":"","sources":["../../src/pm/slack-bulk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiCH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACpD,OAAO,CAAC,aAAa,EAAE,CAAC,CAkE1B"}

package/dist/pm/slack-bulk.js

@@ -0,0 +1,110 @@
+/**
+ * PM Agent — bulk issue creation via Claude analysis.
+ *
+ * Responsibility: given a free-text request from a Slack user, ask Claude Sonnet
+ * to produce a structured list of issue specifications that can be bulk-created
+ * in Linear.
+ *
+ * Extracted from `slack-interface.ts` (BEC-195) so that this single concern has
+ * its own file and can be unit-tested independently.
+ */
+import { createLogger } from "../logger.js";
+import { sanitize } from "../executor/prompt/sanitizer.js";
+const log = createLogger({ component: "PmAgent:slack-bulk" });
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Valid numeric priority values accepted by Linear (1=Urgent … 4=Low). */
+const VALID_PRIORITIES = [1, 2, 3, 4];
+/** Default priority used when a generated issue omits or has an invalid value. */
+const DEFAULT_PRIORITY = 3;
+/** Maximum allowed character length for an issue title. */
+const MAX_ISSUE_TITLE_LENGTH = 200;
+/** Maximum allowed character length for an issue description. */
+const MAX_ISSUE_DESCRIPTION_LENGTH = 5000;
+/** Maximum number of acceptance criteria strings per issue. */
+const MAX_ACCEPTANCE_CRITERIA_COUNT = 10;
+/** Maximum number of issue specs returned by a single bulk create request. */
+const MAX_BULK_ISSUE_SPECS = 10;
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Uses a capable Claude model (Sonnet) to analyze a bulk create request and
+ * produce a structured list of issue specifications ready for Linear creation.
+ *
+ * @param request - Free-text user request describing what issues to create
+ *   (e.g. "find all gaps in error handling and create tickets for them").
+ * @param callClaudeSonnet - Callable that sends a prompt to Claude Sonnet and
+ *   returns the raw text response.
+ * @returns Array of up to 10 `BulkIssueSpec` objects, or an empty array when
+ *   the request cannot be analyzed or Claude returns malformed JSON.
+ */
+export async function analyzeBulkCreateRequest(request, callClaudeSonnet) {
+    const safe = sanitize(request);
+    const prompt = `You are a software PM Agent. A user asked: "${safe}"\n\n` +
+        `Analyze this request and generate a list of concrete, actionable software issues to create.\n` +
+        `Each issue must have a clear title, description, priority (1=urgent, 2=high, 3=medium, 4=low), and acceptance criteria.\n\n` +
+        `Respond ONLY with a JSON array (no other text), e.g.:\n` +
+        `[\n` +
+        `  {\n` +
+        `    "title": "Issue title",\n` +
+        `    "description": "Clear description of what needs to be done",\n` +
+        `    "priority": 2,\n` +
+        `    "acceptanceCriteria": ["Criterion 1", "Criterion 2"]\n` +
+        `  }\n` +
+        `]\n\n` +
+        `Rules:\n` +
+        `- Generate between 1 and 10 issues\n` +
+        `- Each issue must be specific and actionable\n` +
+        `- Priority must be 1, 2, 3, or 4\n` +
+        `- acceptanceCriteria must be a non-empty array of strings\n` +
+        `- Respond ONLY with the JSON array, no markdown fences or explanation`;
+    try {
+        const raw = await callClaudeSonnet(prompt);
+        // Parse the array — look for a JSON array in the response
+        const arrayMatch = raw.match(/\[[\s\S]*\]/);
+        if (!arrayMatch) {
+            log.warn({ responsePreview: raw.slice(0, 200) }, "bulk create: no JSON array in Claude response");
+            return [];
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(arrayMatch[0]);
+        }
+        catch {
+            log.warn({ responsePreview: raw.slice(0, 200) }, "bulk create: failed to parse JSON array");
+            return [];
+        }
+        if (!Array.isArray(parsed))
+            return [];
+        const specs = [];
+        for (const item of parsed) {
+            if (typeof item !== "object" || item === null)
+                continue;
+            const title = typeof item.title === "string" ? item.title.trim() : "";
+            const description = typeof item.description === "string" ? item.description.trim() : "";
+            const priority = typeof item.priority === "number" && VALID_PRIORITIES.includes(item.priority)
+                ? item.priority
+                : DEFAULT_PRIORITY;
+            const acceptanceCriteria = Array.isArray(item.acceptanceCriteria)
+                ? item.acceptanceCriteria.filter((c) => typeof c === "string" && c.trim().length > 0)
+                : [];
+            if (!title)
+                continue;
+            // Cap field lengths to prevent excessively large Linear issues.
+            specs.push({
+                title: title.slice(0, MAX_ISSUE_TITLE_LENGTH),
+                description: description.slice(0, MAX_ISSUE_DESCRIPTION_LENGTH),
+                priority,
+                acceptanceCriteria: acceptanceCriteria.slice(0, MAX_ACCEPTANCE_CRITERIA_COUNT),
+            });
+        }
+        return specs.slice(0, MAX_BULK_ISSUE_SPECS);
+    }
+    catch (err) {
+        log.warn({ err }, "bulk create: failed to analyze request");
+        return [];
+    }
+}
+//# sourceMappingURL=slack-bulk.js.map

package/dist/pm/slack-bulk.js.map

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

package/dist/pm/slack-commands.d.ts

@@ -0,0 +1,101 @@
+/**
+ * PM Agent — Slack command execution.
+ *
+ * Responsibility: execute a parsed `PmCommand` against the Linear API and return
+ * a human-readable response string suitable for posting back to Slack.
+ *
+ * Extracted from `slack-interface.ts` (BEC-195). The previous implementation
+ * accessed `isPmPaused` / `setPmPaused` as module-level closures within
+ * `slack-interface.ts`. After the split those functions live in `pause-state.ts`
+ * and are imported explicitly here, making the dependency transparent and
+ * avoiding a circular import (slack-interface → slack-commands → slack-interface).
+ */
+/**
+ * Structured representation of a PM command parsed from Slack text.
+ * This type lives here (rather than in `slack-interface.ts`) so that
+ * `executePmCommand` owns the shape of the data it operates on, and
+ * `slack-interface.ts` can import it without creating a circular dependency.
+ */
+export type PmCommand = {
+    type: "prioritize";
+    issueId: string;
+} | {
+    type: "create";
+    title: string;
+    description: string;
+} | {
+    type: "bulk_create";
+    request: string;
+} | {
+    type: "status";
+} | {
+    type: "pause";
+} | {
+    type: "resume";
+} | {
+    type: "assign";
+    issueId: string;
+}
+/** Operator-initiated stop. `runId` is a pipeline_runs row id (nanoid). */
+ | {
+    type: "cancel";
+    runId: string;
+} | {
+    type: "stop";
+    runId: string;
+} | {
+    type: "halt";
+} | {
+    type: "unknown";
+    original: string;
+};
+/**
+ * External dependencies injected into `executePmCommand`.
+ * All fields are optional so callers can pass a partial object during testing.
+ */
+export interface CommandExecutorDeps {
+    /** Linear API key (needed for create / prioritize / assign commands). */
+    linearApiKey?: string;
+    /** Team IDs for issue creation commands. */
+    teamIds?: string[];
+    /** Sonnet-model callable required for the `bulk_create` command. */
+    callClaudeSonnet?: (prompt: string) => Promise<string>;
+    /**
+     * Reference to the live pipeline runner. Required for `cancel`/`stop`/`halt`
+     * commands; if absent, those commands report a clear configuration error
+     * rather than silently succeeding.
+     */
+    runner?: {
+        requestStop?: (runId: string, mode: "cancel" | "graceful") => {
+            issueId: string | null;
+            mode: "cancel" | "graceful";
+        };
+        haltAll?: () => {
+            cancelledRunIds: string[];
+        };
+    };
+    /** DB handle for audit-event writes. */
+    db?: any;
+    /** Slack user id (e.g. "U123") for audit attribution. */
+    slackUserId?: string;
+}
+/**
+ * Executes a parsed `PmCommand` against Linear and returns a human-readable
+ * response string suitable for posting back to Slack.
+ *
+ * Design note — implicit state access: the `pause` / `resume` / `status`
+ * command cases call `isPmPaused()` and `setPmPaused()` from `pause-state.ts`.
+ * These functions are now explicit imports rather than closures over outer module
+ * state (as they were when this logic lived in `slack-interface.ts`). The
+ * dependency is intentional and transparent — the pause flag is process-scoped
+ * shared state that must be the same instance for both command execution and the
+ * scheduler's `isPmPaused()` check.
+ *
+ * @param cmd - A structured `PmCommand` (output of `parsePmCommand` or
+ *   `interpretNaturalLanguage`).
+ * @param deps - External service dependencies (Linear API key, team IDs,
+ *   optional Sonnet callable for bulk create).
+ * @returns A Slack-formatted response string (may contain mrkdwn markup).
+ */
+export declare function executePmCommand(cmd: PmCommand, deps: CommandExecutorDeps): Promise<string>;
+//# sourceMappingURL=slack-commands.d.ts.map

package/dist/pm/slack-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-commands.d.ts","sourceRoot":"","sources":["../../src/pm/slack-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwBH;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACrC,2EAA2E;GACzE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAe1C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD;;;;OAIG;IACH,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,KAAK;YAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAA;SAAE,CAAC;QACtH,OAAO,CAAC,EAAE,MAAM;YAAE,eAAe,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KAC/C,CAAC;IACF,wCAAwC;IACxC,EAAE,CAAC,EAAE,GAAG,CAAC;IACT,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA+BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CA2PjB"}