{"record":{"id":"b20fc5ec5851eff0","repo":"Fission-AI/OpenSpec","slug":"change-must-have-a-what-changes-section","errorCode":null,"errorMessage":"Change must have a What Changes section","messagePattern":"Change must have a What Changes section","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"src/core/parsers/change-parser.ts","lineNumber":32,"sourceCode":"export class ChangeParser extends MarkdownParser {\n  private changeDir: string;\n\n  constructor(content: string, changeDir: string) {\n    super(content);\n    this.changeDir = changeDir;\n  }\n\n  async parseChangeWithDeltas(name: string): Promise<Change> {\n    const sections = this.parseSections();\n    const why = this.findSection(sections, 'Why')?.content || '';\n    const whatChanges = this.findSection(sections, 'What Changes')?.content || '';\n    \n    if (!why) {\n      throw new Error('Change must have a Why section');\n    }\n    \n    if (!whatChanges) {\n      throw new Error('Change must have a What Changes section');\n    }\n\n    // Parse deltas from the What Changes section (simple format)\n    const simpleDeltas = this.parseDeltas(whatChanges);\n    \n    // Check if there are spec files with delta format\n    const specsDir = path.join(this.changeDir, 'specs');\n    const deltaDeltas = await this.parseDeltaSpecs(specsDir);\n    \n    // Combine both types of deltas, preferring delta format if available\n    const deltas = deltaDeltas.length > 0 ? deltaDeltas : simpleDeltas;\n\n    return {\n      name,\n      why: why.trim(),\n      whatChanges: whatChanges.trim(),\n      deltas,\n      metadata: {","sourceCodeStart":14,"sourceCodeEnd":50,"githubUrl":"https://github.com/Fission-AI/OpenSpec/blob/6926ccb18afa4ff621112813e9968334576ee11a/src/core/parsers/change-parser.ts#L14-L50","documentation":"Error \"Change must have a What Changes section\" thrown in Fission-AI/OpenSpec.","triggerScenarios":"Thrown at src/core/parsers/change-parser.ts:32 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"6926ccb18afa4ff621112813e9968334576ee11a","analyzedAt":"2026-08-25T12:29:45.729Z","schemaVersion":2},"datasetVersion":"2026-08-25T16:17:27.014Z"}