Unknown field(s) in 'operations.${operationId}': ${unknownFi

Error message

Unknown field(s) in 'operations.${operationId}': ${unknownFields.join(', ')}. Supported fields: guidance

What it means

Error "Unknown field(s) in 'operations.${operationId}': ${unknownFields.join(', ')}. Supported fields: guidance" thrown in Fission-AI/OpenSpec.

Source

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

    if (!supported.has(operationId)) {
      console.warn(
        `Unknown operation ID '${operationId}' in config. Supported operation IDs: ${OPERATION_IDS.join(', ')}`
      );
      continue;
    }

    const typedOperationId = operationId as OperationId;
    if (!value || typeof value !== 'object' || Array.isArray(value)) {
      console.warn(
        `Invalid 'operations.${operationId}' field in config (must be object), ignoring this operation`
      );
      continue;
    }

    const operation = value as Record<string, unknown>;
    const unknownFields = Object.keys(operation).filter((field) => field !== 'guidance');
    if (unknownFields.length > 0) {
      console.warn(
        `Unknown field(s) in 'operations.${operationId}': ${unknownFields.join(', ')}. Supported fields: guidance`
      );
    }

    if (operation.guidance === undefined) {
      continue;
    }

    const guidanceResult = z.array(z.string()).safeParse(operation.guidance);
    if (!guidanceResult.success) {
      console.warn(
        `Guidance for operation '${operationId}' must be an array of strings, ignoring this operation's guidance`
      );
      continue;
    }

    const guidance = guidanceResult.data.filter((entry) => entry.length > 0);
    if (guidance.length < guidanceResult.data.length) {

View on GitHub (pinned to 6926ccb18a)

When it happens

Trigger: Thrown at src/core/project-config.ts:152 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/d767a782f4408875. Report an issue: GitHub.