opencode-swarm 7.192.2 → 7.192.4

package/dist/services/pr-workflow-gh-readiness.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Issue #3099 R2-14 — workflow-scoped `gh` readiness.
+ *
+ * `gh` availability is otherwise only ever resolved lazily: the moment a tool
+ * that needs it runs (`src/tools/gh-evidence.ts` degrades with a typed
+ * `gh-not-found` payload, `src/tools/pr-review-submission.ts` fails its
+ * transport). Nothing checks at PR-workflow ACTIVATION, which is the last point
+ * where an operator can still act — and because the workflow is fail-open, a
+ * lane that cannot reach `gh` produces degraded output that then flows into
+ * reviewer and critic inputs instead of failing loudly.
+ *
+ * The generic missing-binary advisory cannot cover this: its checklist
+ * (`src/services/tool-doctor.ts`) is PATH-presence-only and deliberately
+ * excludes `gh`, whereas `resolveGhBinary` performs a behavioural
+ * `gh version` probe.
+ *
+ * Fail-open by contract: this module returns a string or null and NEVER throws.
+ * A resolver failure yields no advisory rather than blocking activation.
+ */
+/** Prefixed so the entry is self-identifying inside the shared advisory array. */
+export declare const GH_READINESS_ADVISORY_PREFIX = "gh-readiness:";
+export declare const _internals: {
+    resolveGhBinary: () => string | null;
+    emit: (message: string) => void;
+};
+/**
+ * Returns a workflow-scoped readiness advisory when `gh` cannot be resolved,
+ * or null when it can (or when detection itself fails). Never throws.
+ */
+export declare function collectPrWorkflowGhReadinessAdvisory(resolve: (() => string | null) | undefined): string | null;

package/dist/tools/gh-evidence.d.ts

@@ -28,6 +28,20 @@ export declare function resolveGhBinary(): string | null;
  * `__seedGitExecutableForTests` in `src/utils/git-executable.ts`.
  */
 export declare function __seedGhBinaryForTests(value: string | null): void;
+/**
+ * Actionable guidance emitted when the gh CLI is not on PATH.
+ *
+ * There is DELIBERATELY no hidden REST fallback wired in. Two reasons make a
+ * silent transport swap unsafe: (1) the in-repo web_fetch tool pins a public IP,
+ * blocks loopback, and ignores HTTPS_PROXY, so it cannot be a general REST
+ * client from inside the plugin; (2) field-shape divergence — `gh --json`
+ * returns camelCase keys plus gh-only synthesized fields (statusCheckRollup,
+ * reviewDecision, mergeStateStatus) absent from the snake_case api.github.com
+ * REST payload, so auto-swapping transports would return a differently-shaped
+ * object under the same contract and mislead readers. Instead we hand the caller
+ * the exact REST URL and the gate-allowed degraded read path.
+ */
+export declare function ghNotFoundGuidance(target: 'pr' | 'issue' | 'run', number: number, repo: string | undefined, logFailed: boolean): string;
 export declare const gh_evidence: ToolDefinition;
 export declare const _internals: {
     resolveGhBinaryCandidates: typeof resolveGhBinaryCandidates;

package/dist/turbo/lean/runner.d.ts

@@ -69,6 +69,8 @@ interface SessionClient {
         signal?: AbortSignal;
     }): Promise<{
         data: {
+            /** Assistant message; carries a provider refusal as `info.error`. */
+            info?: unknown;
             parts: Array<{
                 type: string;
                 text?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.192.2",
+	"version": "7.192.4",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",