Some guidance for operation '${operationId}' are empty strin

Error message

Some guidance for operation '${operationId}' are empty strings, ignoring them

What it means

Error "Some guidance for operation '${operationId}' are empty strings, ignoring them" thrown in Fission-AI/OpenSpec.

Source

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

        `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;
}

/**
 * Parser for `references:` declarations: string entries or
 * {id, remote} maps, normalized to DeclarationEntry[]. Dedup keys on
 * id and keeps the first position; the first entry carrying a remote
 * supplies it (a later duplicate fills a missing remote, never
 * overrides). Invalid entries drop with a warning like other resilient
 * fields; returns undefined when the field is absent or normalizes to

View on GitHub (pinned to 6926ccb18a)

When it happens

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