55 lines
2.6 KiB
TypeScript
55 lines
2.6 KiB
TypeScript
/**
|
|
* Runtime gate — guards entry points that only support the Claude runtime.
|
|
*
|
|
* The autonomous SDK orchestrator (`gsd-sdk auto`) currently drives plan
|
|
* execution through `@anthropic-ai/claude-agent-sdk`. It has no Codex /
|
|
* Gemini / OpenCode dispatcher today, so silently routing a non-Claude
|
|
* project's autonomous run through the Claude path is incorrect: it picks
|
|
* Claude models, hits Claude APIs, and confuses users debugging "why is my
|
|
* Codex run choosing claude-sonnet-4-6?" (issue #2832).
|
|
*
|
|
* Fail fast with an actionable error instead. The fix surfaces the limitation
|
|
* up front and points users at the supported in-session GSD slash commands
|
|
* for non-Claude runtimes.
|
|
*/
|
|
import { detectRuntime, SUPPORTED_RUNTIMES, type Runtime } from './query/helpers.js';
|
|
import { canonicalizeRuntimeName } from './runtime/name-policy.js';
|
|
|
|
/**
|
|
* Throw a clear error when the active runtime is not Claude.
|
|
*
|
|
* Precedence mirrors `detectRuntime`: `GSD_RUNTIME` env var > `config.runtime`
|
|
* > `'claude'`. Unknown / missing runtime values default to Claude (the
|
|
* historical behavior) so existing Claude users are unaffected.
|
|
*
|
|
* @param config Project config (with optional `runtime` field).
|
|
* @throws Error with a runtime-specific actionable message when non-Claude.
|
|
*/
|
|
export function assertRuntimeSupportsAutoMode(config?: Record<string, unknown> | { runtime?: unknown }): void {
|
|
const cfg = (config ?? {}) as Record<string, unknown>;
|
|
const runtime: Runtime = detectRuntime({ runtime: cfg.runtime });
|
|
if (runtime === 'claude') return;
|
|
|
|
// Source attribution must reflect what `detectRuntime()` actually used:
|
|
// a `GSD_RUNTIME` value that isn't in SUPPORTED_RUNTIMES falls through to
|
|
// the config tier, so reporting it as the source would be misleading.
|
|
const env = process.env.GSD_RUNTIME;
|
|
const envCanonical = canonicalizeRuntimeName(env);
|
|
const envIsSupported =
|
|
typeof envCanonical === 'string' && (SUPPORTED_RUNTIMES as readonly string[]).includes(envCanonical);
|
|
const source = envIsSupported
|
|
? `GSD_RUNTIME=${env}`
|
|
: `config.runtime="${String(cfg.runtime ?? '')}"`;
|
|
|
|
throw new Error(
|
|
`gsd-sdk auto currently supports the Claude runtime only ` +
|
|
`(detected runtime=${runtime} via ${source}). ` +
|
|
`Autonomous terminal runs through the Claude Agent SDK; non-Claude ` +
|
|
`runtimes (Codex, Gemini, OpenCode, etc.) must drive GSD via the ` +
|
|
`in-session slash commands (e.g. /gsd-discuss-phase, /gsd-plan-phase, ` +
|
|
`/gsd-execute-phase) until issue #2832 lands a multi-runtime executor. ` +
|
|
`To run on Claude anyway, unset GSD_RUNTIME and set runtime: "claude" ` +
|
|
`in .planning/config.json.`,
|
|
);
|
|
}
|