Skip to content

Financial-Modeling's .markdownlint-cli2.jsonc is modified against the canonical and carries no divergence entry #1487

Closed

Description

@ptr727

Surfaced while fixing #1466, which asked whether that repository's ignores block was the fix to promote. It is not, so its state needs its own disposition.

What it holds

ptr727/Financial-Modeling's copy adds three keys the canonical did not have when it was written:

  • "globs": ["**/*.md"]
  • "ignores": ["data/**", "notes/forms-decisions.md"]
  • the comments explaining both

data/** is a committed document archive and notes/forms-decisions.md is the owner's freeform working notes, excluded from the fleet prose gate too via that repository's .github/prose-gate-excludes. Both are repository-specific by construction, so neither belongs in the canonical.

Why it needs a decision

spec/files.json declares .markdownlint-cli2.jsonc verbatim, whole. The copy matches no hub revision, so it audits as modified: the repository changed fixed content. spec/divergences.json already carries an entry for this path covering aiopurpleair, PhotoCleaner, and AudioCleaner at disposition re-vendor, and Financial-Modeling is not in that list, so nothing records that this one is deliberate.

The dispositions are not equivalent:

  • accept, recording a governed divergence for a repository that carries content the fleet does not, which leaves it permanently off the canonical and needing a hand merge on every hub change to this file.
  • re-vendor, which erases the two exclusions and puts that repository's archive and notes back under the linter.
  • A seam, if the fleet decides an exclusion list is per-repository content that a verbatim file should not own, which is the same argument markdown-exclude-globs already settled for the CI side.

What changed under it

e7cb1cf (#1474) added globs and an ignores entry to the canonical, so the two files now differ by the entries rather than by the keys. Whichever disposition is chosen, the fix has to originate in the hub to reach that repository cleanly, per #1466.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions