Guidance for operation '${operationId}' must be an array of

Error message

Guidance for operation '${operationId}' must be an array of strings, ignoring this operation's guidance

What it means

Error "Guidance for operation '${operationId}' must be an array of strings, ignoring this operation's guidance" thrown in Fission-AI/OpenSpec.

Source

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

      );
      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) {
      console.warn(
        `Some guidance for operation '${operationId}' are empty strings, ignoring them`
      );
    }
    if (guidance.length > 0) {
      operations[typedOperationId] = { guidance };
    }
  }

  return Object.keys(operations).length > 0 ? operations : undefined;
}

View on GitHub (pinned to 6926ccb18a)

When it happens

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