Fission-AI/OpenSpec · error · ChangeMetadataError

Unknown schema '${parseResult.data.schema}'. Available: ${av

Error message

Unknown schema '${parseResult.data.schema}'. Available: ${availableSchemas.join(', ')}

What it means

Error "Unknown schema '${parseResult.data.schema}'. Available: ${availableSchemas.join(', ')}" thrown in Fission-AI/OpenSpec.

Source

Thrown at src/utils/change-metadata.ts:140

      `Invalid YAML in metadata file: ${parseError.message}`,
      metaPath,
      parseError
    );
  }

  // Validate with Zod
  const parseResult = ChangeMetadataSchema.safeParse(parsed);
  if (!parseResult.success) {
    throw new ChangeMetadataError(
      `Invalid metadata: ${parseResult.error.message}`,
      metaPath
    );
  }

  // Validate that the schema exists
  const availableSchemas = listSchemas(projectRoot);
  if (!availableSchemas.includes(parseResult.data.schema)) {
    throw new ChangeMetadataError(
      `Unknown schema '${parseResult.data.schema}'. Available: ${availableSchemas.join(', ')}`,
      metaPath
    );
  }

  return parseResult.data;
}

export interface ResolveSchemaForChangeOptions {
  metadata?: ChangeMetadata | null;
  /** Pre-read project config; suppresses the fallback config read when provided. */
  projectConfig?: ProjectConfig | null;
}

/**
 * Resolves the schema for a change, with explicit override taking precedence.
 *
 * Resolution order:

View on GitHub (pinned to 6926ccb18a)

When it happens

Trigger: Thrown at src/utils/change-metadata.ts:140 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/342747aaec88c571. Report an issue: GitHub.