Skip to content
CAI
Software that uses CAICheck a score

symfony/yaml

45.7

Weak · 17 November 2026

4k

lines of production code

PHP

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add TaggedValue class for YAML tag support

A new TaggedValue class has been added to the Symfony Yaml component to represent tagged values. This class stores a tag string and its associated value, providing a structured way to handle YAML tags within the library.

Tag · high confidence

Introduce lint:yaml command with JSON Schema validation and CI formats

Adds the \lint:yaml\ command to validate YAML file syntax, supporting multiple files and directories. Users can now validate content against a JSON Schema using the \--check-schema\ option, parse custom tags with \--parse-tags\, and exclude specific paths with \--exclude\. The command also supports CI-friendly output formats (including GitHub Actions and GitLab CI) via the \--format\ option and displays line numbers in JSON output.

Command · high confidence

New yaml-lint binary for validating YAML files

A new executable script, Resources/bin/yaml-lint, has been added to allow users to validate YAML files directly from the command line. This standalone binary bootstraps the Symfony Console application and registers the Yaml Lint command, ensuring it only runs in CLI contexts and providing clear error messages if dependencies are missing.

Resources · high confidence

Symfony Yaml Component v8.2: New tags, JSON Schema validation, and GitLab linting

The Yaml component introduces support for explicit type tags \!!null\, \!!bool\, and \!!int\, along with accepting quoted values for these and \!!float\ tags. It now throws a \ParseException\ if a \!!float\ tag contains an invalid value, rather than silently casting it to \0.0\. The \lint:yaml\ command gains a \--check-schema\ option (and file header support) to validate YAML against JSON Schema, and a new \gitlab\ output format for GitLab Code Quality reports. Additionally, the component now supports parsing a block scalar as the root node of a document and requires the \PARSE\_CUSTOM\_TAGS\ flag for custom tags on block scalars.

(repo-wide) · high confidence

YAML linting now supports JSON Schema validation

The YAML component now includes a new Schema subsystem that allows YAML documents to be validated against a JSON Schema. This is enabled by adding a $schema declaration (e.g., \# yaml-language-server: $schema=...) in the file header. The new FileHeaderSchemaResolver detects this declaration, and the SchemaValidator uses the opis/json-schema library to validate the parsed data, providing structure-aware error reporting that maps JSON Schema validation errors back to specific lines in the YAML file. Also in this area: 1 commit (0 fixes) modifying Schema.

Schema · medium confidence · unverified

Behavioural changes

Yaml component exceptions moved to a dedicated sub-namespace

The exception classes for the Yaml component have been reorganized into a new \Symfony\\Component\\Yaml\\Exception\ sub-namespace. The previous monolithic \Exception\ class has been split into specific types: \ParseException\ (handling parse errors with detailed context like line number and snippet), \DumpException\ (for dumping errors), and \LogicException\ (for programming errors). The base \ExceptionInterface\ now extends \\\Throwable\ directly. This change updates the fully qualified class names for all Yaml-related exceptions, requiring users to update their \use\ statements or \catch\ blocks to reference the new \Symfony\\Component\\Yaml\\Exception/\*\ paths instead of \Symfony\\Component\\Yaml\\Exception\.

Exception · high confidence

Test coverage

Added YAML parser test fixtures and PHP enum fixtures; Added comprehensive test suite for the YAML component; Added tests for YAML schema validation and file header resolution; Added tests for the YAML Lint command.

Dependencies

Symfony Yaml component requires PHP 8.4+ and adds yaml-lint binary

The Symfony Yaml component now requires PHP 8.4.1 or higher and includes a new command-line binary (yaml-lint) for validating YAML files. It also introduces a conflict with symfony/console versions prior to 7.4 and adds the yaml/yaml-test-suite as a development dependency to support comprehensive testing.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 46.6 → 45.7 (-0.9)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 57.9 → 57.6 (-0.3)
  • Architecture 99.9 → 97.3 (-2.6)
  • Maturity 39.7 → 37.3 (-2.4)
  • Readiness 33.3 → 33.3 (0.0)
  • Security 100.0 → 100.0 (0.0)

Resolved (3)

  • Duplicated block (5 lines × 2) (Inline.php)
  • No ADRs found
  • Off-boarding risk: anonymized user #1

New (9)

  • No ADRs found (composer.json)
  • Off the main sequence: Exception
  • Off the main sequence: Tag
  • Off-boarding risk: anonymized user #1
  • Orphaned file (Exception/ParseException.php)
  • Orphaned file (Unescaper.php)
  • Orphaned files with no living knowledge
  • Skipped (documented): testLintFileWithInvalidUtf8NameWithJsonFormat (Tests/Command/LintCommandTest.php)
  • Skipped (documented): testLintFilesWithMarkupInTheirName (Tests/Command/LintCommandTest.php)

Changes since last survey

  • 24 commits — 20 feature/other, 4 fixes

By area

  • (repo) — 17 commits
  • (root) — 3 commits
  • Command/LintCommand.php — 2 commits
  • Schema/SchemaValidator.php — 1 commit
  • Tests/ParserTest.php — 1 commit

Notable commits

  • fix: [Yaml] Fix anchors, aliases and unsupported entries in flow mapping keys
  • fix: [Yaml] Fix block scalars losing their trailing newline after leading comments
  • fix: bug #67881 [Yaml] Don't copy long nested blocks at each nesting level (nicolas-grekas)
  • fix: bug #68210 [Yaml] Escape the schema path in the text output of lint:yaml (nicolas-grekas)
  • change: Merge branch '5.4' into 6.4
  • change: Merge branch '6.4' into 7.4
  • change: Merge branch '6.4' into 7.4
  • change: Merge branch '6.4' into 7.4
  • change: Merge branch '6.4' into 7.4
  • change: Merge branch '7.4' into 8.1
  • change: Merge branch '7.4' into 8.1
  • change: Merge branch '7.4' into 8.1
  • change: Merge branch '7.4' into 8.1
  • change: Merge branch '7.4' into 8.1
  • change: Merge branch '8.1' into 8.2
  • change: Merge branch '8.1' into 8.2
  • change: Merge branch '8.1' into 8.2
  • change: Merge branch '8.1' into 8.2
  • change: Merge branch '8.1' into 8.2
  • change: [Console][Form][FrameworkBundle][HttpKernel][Ldap][Messenger][Yaml] Drop the remaining assertions that cannot run after the expected exception
  • …and 4 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

symfony/yaml was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 17 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 0e55b93637526aad19aca822d6c867b59ad1101a — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.85+preprod-eba6548ac50f.