{"record":{"id":"0189848cdf3f0ef1","repo":"github/spec-kit","slug":"requires-tools-must-be-a-list","errorCode":null,"errorMessage":"requires.tools must be a list","messagePattern":"requires\\.tools must be a list","errorType":"validation","errorClass":"IntegrationDescriptorError","httpStatus":null,"severity":"error","filePath":"src/specify_cli/integrations/catalog.py","lineNumber":751,"sourceCode":"            )\n\n        requires = self.data[\"requires\"]\n        if not isinstance(requires, dict):\n            raise IntegrationDescriptorError(\n                \"'requires' must be a mapping\"\n            )\n        if \"speckit_version\" not in requires:\n            raise IntegrationDescriptorError(\n                \"Missing requires.speckit_version\"\n            )\n        if not isinstance(requires[\"speckit_version\"], str) or not requires[\"speckit_version\"].strip():\n            raise IntegrationDescriptorError(\n                \"requires.speckit_version must be a non-empty string\"\n            )\n        tools = requires.get(\"tools\")\n        if tools is not None:\n            if not isinstance(tools, list):\n                raise IntegrationDescriptorError(\n                    \"requires.tools must be a list\"\n                )\n            for tool in tools:\n                if not isinstance(tool, dict):\n                    raise IntegrationDescriptorError(\n                        \"Each requires.tools entry must be a mapping\"\n                    )\n                tool_name = tool.get(\"name\")\n                if not isinstance(tool_name, str) or not tool_name.strip():\n                    raise IntegrationDescriptorError(\n                        \"requires.tools entry 'name' must be a non-empty string\"\n                    )\n\n        provides = self.data[\"provides\"]\n        if not isinstance(provides, dict):\n            raise IntegrationDescriptorError(\n                \"'provides' must be a mapping\"\n            )","sourceCodeStart":733,"sourceCodeEnd":769,"githubUrl":"https://github.com/github/spec-kit/blob/bf88c9f9a82fa370c7a7257aa2b3cf10b457b65c/src/specify_cli/integrations/catalog.py#L733-L769","documentation":"Error \"requires.tools must be a list\" thrown in github/spec-kit.","triggerScenarios":"Thrown at src/specify_cli/integrations/catalog.py:751 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Make requires.tools a list in the descriptor."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"bf88c9f9a82fa370c7a7257aa2b3cf10b457b65c","analyzedAt":"2026-08-14T19:43:37.150Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}