opencode-swarm 7.66.2 → 7.67.0

package/dist/commands/pr-monitor-status.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Handle /swarm pr status command.
+ *
+ * Displays all active PR monitoring subscriptions for the current session.
+ * Shows PR URL, repo#number, last checked time (relative), watching status,
+ * and error count per subscription. Also reports the total number of active
+ * subscriptions across all sessions.
+ *
+ * Input contract (no args):
+ *   /swarm pr status                              → show session subscriptions
+ */
+import { listActive } from '../background/pr-subscriptions.js';
+/**
+ * Format an epoch-ms timestamp as a human-friendly relative time string.
+ *
+ * Returns "just now" for timestamps within the last 5 seconds, otherwise
+ * uses the largest whole unit (seconds, minutes, hours, or days).
+ */
+declare function formatRelativeTime(epochMs: number): string;
+/**
+ * Exposed for unit testing via _internals.
+ */
+export declare const _internals: {
+    formatRelativeTime: typeof formatRelativeTime;
+    listActive: typeof listActive;
+};
+/**
+ * Show PR monitor subscription status for the current session.
+ *
+ * Lists all active subscriptions filtered to the current sessionID,
+ * formatted as a numbered table with PR URL, relative last-checked
+ * time, watching status, and error count. Appends a cross-session
+ * total at the end.
+ */
+export declare function handlePrMonitorStatusCommand(directory: string, _args: string[], sessionID: string): Promise<string>;
+export {};

package/dist/commands/pr-subscribe.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Handle /swarm pr subscribe command.
+ *
+ * Subscribes the current session to PR state-change notifications. When
+ * `pr_monitor.enabled` is true, the background polling worker will detect CI
+ * failures, new comments, merge conflicts, review state changes, and
+ * merge/close events. Notifications are delivered as session-scoped advisories
+ * with dedup tokens.
+ *
+ * Input contract (PR reference is required):
+ *   /swarm pr subscribe 155                         → subscribe via bare number
+ *   /swarm pr subscribe owner/repo#155               → shorthand
+ *   /swarm pr subscribe https://github.com/.../pull/155
+ *   /swarm pr subscribe                              → usage (no bare invocation)
+ *
+ * PR-reference parsing is shared with /swarm pr-review and /swarm pr-feedback
+ * via ./pr-ref.ts.
+ */
+import { subscribe } from '../background/pr-subscriptions.js';
+import { loadPluginConfig } from '../config/loader.js';
+/**
+ * Subscribe the current session to PR monitoring notifications.
+ *
+ * Requires a PR reference argument (no bare invocation). The subscription is
+ * idempotent — if an active subscription with the same composite key
+ * (`sessionID::repoFullName::prNumber`) already exists, the existing record
+ * is returned without duplication.
+ */
+export declare function handlePrSubscribeCommand(directory: string, args: string[], sessionID: string): Promise<string>;
+export declare const _internals: {
+    loadPluginConfig: typeof loadPluginConfig;
+    subscribe: typeof subscribe;
+};

package/dist/commands/pr-unsubscribe.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Handle /swarm pr unsubscribe command.
+ *
+ * Unsubscribes the current session from PR state-change notifications.
+ * Removes the active subscription record so the background polling
+ * worker will no longer watch this PR for the current session.
+ *
+ * Input contract (PR reference is required):
+ *   /swarm pr unsubscribe 155                       → unsubscribe via bare number
+ *   /swarm pr unsubscribe owner/repo#155             → shorthand
+ *   /swarm pr unsubscribe https://github.com/.../pull/155
+ *   /swarm pr unsubscribe                            → usage (no bare invocation)
+ *
+ * PR-reference parsing is shared with /swarm pr-review, /swarm pr-feedback,
+ * and /swarm pr subscribe via ./pr-ref.ts.
+ */
+import { buildCorrelationId, unsubscribe } from '../background/pr-subscriptions.js';
+import { looksLikePrRef, parsePrRef } from './pr-ref.js';
+/**
+ * Unsubscribe the current session from PR monitoring notifications.
+ *
+ * Requires a PR reference argument (no bare invocation). Looks up the active
+ * subscription for the current session and PR; if none is found, returns an
+ * informational message. If found, marks the subscription as removed.
+ */
+export declare function handlePrUnsubscribeCommand(directory: string, args: string[], sessionID: string): Promise<string>;
+export declare const _internals: {
+    unsubscribe: typeof unsubscribe;
+    buildCorrelationId: typeof buildCorrelationId;
+    parsePrRef: typeof parsePrRef;
+    looksLikePrRef: typeof looksLikePrRef;
+};

package/dist/commands/registry.d.ts

@@ -344,6 +344,27 @@ export declare const COMMAND_REGISTRY: {
         readonly details: "Triggers MODE: PR_FEEDBACK — ingests existing pull-request feedback (review threads, requested changes, CI/check failures, merge conflicts, stale branch state, pasted notes), verifies every claim against source, clusters related problems, fixes confirmed items, validates the branch, and reports closure status for every ledger item. Distinct from /swarm pr-review, which discovers new findings. The PR reference is optional: with none, the architect builds the ledger from the current PR/branch; text after the reference is forwarded as extra instructions. Supports full GitHub URL, owner/repo#N shorthand, or bare PR number (resolved against origin).";
         readonly category: "agent";
     };
+    readonly 'pr subscribe': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Subscribe the current session to PR state-change notifications";
+        readonly args: "<pr-url|owner/repo#N|N>";
+        readonly details: "Subscribes the current session to receive advisory notifications for the specified PR. When pr_monitor.enabled is true, the background polling worker will detect CI failures, new comments, merge conflicts, review state changes, and merge/close events. Notifications are delivered as session-scoped advisories with dedup tokens. Supports full GitHub URL, owner/repo#N shorthand, or bare PR number (resolved against origin). Requires pr_monitor.enabled: true in config.";
+        readonly category: "agent";
+    };
+    readonly 'pr unsubscribe': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Unsubscribe the current session from PR state-change notifications";
+        readonly args: "<pr-url|owner/repo#N|N>";
+        readonly details: "Unsubscribes the current session from receiving advisory notifications for the specified PR. Removes the active subscription record. Supports full GitHub URL, owner/repo#N shorthand, or bare PR number (resolved against origin).";
+        readonly category: "agent";
+    };
+    readonly 'pr status': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Show PR monitor subscription status for the current session";
+        readonly args: "";
+        readonly details: "Displays all active PR subscriptions for the current session. Shows PR URL, last checked time, watching status, and error count per subscription. Also shows total active subscriptions across all sessions.";
+        readonly category: "agent";
+    };
     readonly 'deep-dive': {
         readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Launch deep codebase audit with parallel explorer waves, dual reviewers, and critic challenge [scope]";

package/dist/config/schema.d.ts

@@ -823,6 +823,25 @@ export declare const CouncilConfigSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type CouncilConfig = z.infer<typeof CouncilConfigSchema>;
+export declare const PrMonitorConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    poll_interval_seconds: z.ZodDefault<z.ZodNumber>;
+    max_subscriptions: z.ZodDefault<z.ZodNumber>;
+    max_prs_per_cycle: z.ZodDefault<z.ZodNumber>;
+    max_concurrent_pr_polls: z.ZodDefault<z.ZodNumber>;
+    poll_timeout_ms: z.ZodDefault<z.ZodNumber>;
+    failure_threshold: z.ZodDefault<z.ZodNumber>;
+    cooldown_seconds: z.ZodDefault<z.ZodNumber>;
+    max_cooldown_seconds: z.ZodDefault<z.ZodNumber>;
+    cleanup_ttl_days: z.ZodDefault<z.ZodNumber>;
+    auto_unsubscribe_on_merge: z.ZodDefault<z.ZodBoolean>;
+    auto_unsubscribe_on_close: z.ZodDefault<z.ZodBoolean>;
+    notify_ci_failure: z.ZodDefault<z.ZodBoolean>;
+    notify_new_comments: z.ZodDefault<z.ZodBoolean>;
+    notify_merge_conflict: z.ZodDefault<z.ZodBoolean>;
+    auto_pr_feedback: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export type PrMonitorConfig = z.infer<typeof PrMonitorConfigSchema>;
 export declare const ParallelizationConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     maxConcurrentTasks: z.ZodDefault<z.ZodNumber>;
@@ -1782,6 +1801,24 @@ export declare const PluginConfigSchema: z.ZodObject<{
             every_minutes: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    pr_monitor: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        poll_interval_seconds: z.ZodDefault<z.ZodNumber>;
+        max_subscriptions: z.ZodDefault<z.ZodNumber>;
+        max_prs_per_cycle: z.ZodDefault<z.ZodNumber>;
+        max_concurrent_pr_polls: z.ZodDefault<z.ZodNumber>;
+        poll_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        failure_threshold: z.ZodDefault<z.ZodNumber>;
+        cooldown_seconds: z.ZodDefault<z.ZodNumber>;
+        max_cooldown_seconds: z.ZodDefault<z.ZodNumber>;
+        cleanup_ttl_days: z.ZodDefault<z.ZodNumber>;
+        auto_unsubscribe_on_merge: z.ZodDefault<z.ZodBoolean>;
+        auto_unsubscribe_on_close: z.ZodDefault<z.ZodBoolean>;
+        notify_ci_failure: z.ZodDefault<z.ZodBoolean>;
+        notify_new_comments: z.ZodDefault<z.ZodBoolean>;
+        notify_merge_conflict: z.ZodDefault<z.ZodBoolean>;
+        auto_pr_feedback: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     external_skills: z.ZodOptional<z.ZodObject<{
         curation_enabled: z.ZodDefault<z.ZodBoolean>;
         max_candidates: z.ZodDefault<z.ZodNumber>;

package/dist/git/pr.d.ts

@@ -1,8 +1,29 @@
+export declare const GIT_TIMEOUT_MS = 30000;
 /**
  * Sanitize input string to prevent command injection
  * Removes or escapes shell metacharacters
  */
 export declare function sanitizeInput(input: string): string;
+/**
+ * Execute gh CLI command
+ */
+export declare function ghExec(args: string[], cwd: string): string;
+/**
+ * Execute gh CLI command asynchronously (non-blocking).
+ * Used by background workers that must not block the event loop.
+ * Follows AGENTS.md Invariant 3: array-form spawn, explicit cwd,
+ * stdin: 'ignore', timeout, bounded stdout/stderr, proc.kill() in finally.
+ */
+export declare function ghExecAsync(args: string[], cwd: string): Promise<string>;
+/**
+ * Test-only dependency-injection seam — see `gitignore-warning.ts:_internals`.
+ * Production code calls `_internals.ghExec(...)` so tests can replace the
+ * function on this object without touching the real `child_process.spawnSync`.
+ */
+export declare const _internals: {
+    ghExec: typeof ghExec;
+    ghExecAsync: typeof ghExecAsync;
+};
 /**
  * Check if gh CLI is available
  */
@@ -26,3 +47,62 @@ export declare function createPullRequest(cwd: string, title: string, body?: str
  * Commit and push current changes
  */
 export declare function commitAndPush(cwd: string, message: string): void;
+export interface PRStatusResult {
+    number: number;
+    state: 'OPEN' | 'CLOSED' | 'MERGED';
+    mergeable: 'MERGEABLE' | 'CONFLICTING' | 'UNKNOWN';
+    mergeStateStatus: string;
+    headRefOid: string;
+    statusCheckRollup: Array<{
+        name: string;
+        status: string;
+        conclusion: string | null;
+    }>;
+}
+export interface PRCheckResult {
+    name: string;
+    bucket: string;
+    state: string;
+    startedAt: string | null;
+    completedAt: string | null;
+}
+export interface PRCommentResult {
+    id: string;
+    author: string;
+    body: string;
+    createdAt: string;
+    isReviewComment: boolean;
+}
+export interface MergeStateResult {
+    mergeable: 'MERGEABLE' | 'CONFLICTING' | 'UNKNOWN';
+    mergeStateStatus: string;
+    headRefOid: string;
+}
+export interface ReviewStateResult {
+    /** Current review decision: APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED, or empty string. */
+    reviewDecision: string;
+    /** Number of requesting reviewers (non-zero means reviews are still pending). */
+    reviewRequestCount: number;
+}
+/**
+ * Fetch PR status via gh pr view --json
+ */
+export declare function getPRStatus(prNumber: number, repoFullName: string, cwd: string): Promise<PRStatusResult>;
+/**
+ * Fetch CI check results via gh pr checks --json
+ */
+export declare function getPRChecks(prNumber: number, repoFullName: string, cwd: string): Promise<PRCheckResult[]>;
+/**
+ * Fetch PR comments since a given timestamp via gh api
+ * Returns both issue comments and pull request review comments, merged together
+ */
+export declare function getPRComments(prNumber: number, repoFullName: string, cwd: string, since?: string): Promise<PRCommentResult[]>;
+/**
+ * Fetch merge state (mergeable + mergeStateStatus) via gh pr view --json
+ */
+export declare function getMergeState(prNumber: number, repoFullName: string, cwd: string): Promise<MergeStateResult>;
+/**
+ * Fetch the current review state for a PR using `gh pr view --json reviewDecision,reviewRequests`.
+ * Uses async ghExecAsync to avoid blocking the event loop.
+ */
+export declare function getPRReviewState(prNumber: number, repoFullName: string, cwd: string): Promise<ReviewStateResult>;

package/dist/hooks/guardrails.d.ts

@@ -7,10 +7,11 @@
  * - Layer 2 (Hard Block @ 100%): Throws error in toolBefore to block further calls, injects STOP message
  */
 import * as path from 'node:path';
-import { getSwarmAgents, resolveFallbackModel } from '../agents/index';
+import { extractSwarmIdFromAgentName, getSwarmAgents, resolveFallbackModel } from '../agents/index';
 import { type AuthorityConfig, type GuardrailsConfig } from '../config/schema';
 import { type FileZone } from '../context/zone-classifier';
 export declare const _internals: {
+    extractSwarmIdFromAgentName: typeof extractSwarmIdFromAgentName;
     getSwarmAgents: typeof getSwarmAgents;
     getMostRecentAssistantText: typeof getMostRecentAssistantText;
     getProviderFailureFingerprint: typeof getProviderFailureFingerprint;