Invalid 'githubCopilot.cloudAgent' field in config (must be

Error message

Invalid 'githubCopilot.cloudAgent' field in config (must be a boolean)

What it means

Error "Invalid 'githubCopilot.cloudAgent' field in config (must be a boolean)" thrown in Fission-AI/OpenSpec.

Source

Thrown at src/core/project-config.ts:390

      } else {
        console.warn(
          `Warning: ignoring invalid store: field in ${configPathForWarnings(projectRoot)} (must be a single store id string).`
        );
      }
    }

    // Parse githubCopilot preferences (only cloudAgent is recognized today).
    if (raw.githubCopilot !== undefined) {
      if (
        typeof raw.githubCopilot === 'object' &&
        raw.githubCopilot !== null &&
        !Array.isArray(raw.githubCopilot)
      ) {
        const cloudAgent = (raw.githubCopilot as Record<string, unknown>).cloudAgent;
        if (typeof cloudAgent === 'boolean') {
          config.githubCopilot = { cloudAgent };
        } else if (cloudAgent !== undefined) {
          console.warn(`Invalid 'githubCopilot.cloudAgent' field in config (must be a boolean)`);
        }
      } else {
        console.warn(`Invalid 'githubCopilot' field in config (must be an object)`);
      }
    }

    // Return partial config even if some fields failed
    return Object.keys(config).length > 0 ? (config as ProjectConfig) : null;
  } catch (error) {
    console.warn(
      `Warning: could not parse ${configPathForWarnings(projectRoot)} (${error instanceof Error ? error.message.split('\n')[0] : String(error)}); ignoring it.`
    );
    return null;
  }
}

function configPathForWarnings(projectRoot: string): string {
  return resolveConfigFilePath(projectRoot) ?? path.join(projectRoot, 'openspec', 'config.yaml');

View on GitHub (pinned to 6926ccb18a)

When it happens

Trigger: Thrown at src/core/project-config.ts:390 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Fission-AI/OpenSpec@6926ccb18a (2026-08-25). Data as JSON: /api/errors/2ff1940f0009ad52. Report an issue: GitHub.