Merge PR #224: Unify glob matcher to doublestar across all surfaces

Author: merge-queue-bot

.claude/skills/proto.md

@@ -11,4 +11,5 @@ description: 'string & != ""'
 ---
 
 ## ...
+
 <?allow-empty-section?>

.mdsmith.yml

@@ -78,7 +78,7 @@ rules:
   git-hook-sync: true
 
 overrides:
-  - files: ["CLAUDE.md"]
+  - glob: ["CLAUDE.md"]
     rules:
       line-length:
         max: 200
@@ -87,20 +87,20 @@ overrides:
           - tables
           - urls
       blank-line-around-lists: false
-  - files: [".claude/skills/*/SKILL.md",
+  - glob: [".claude/skills/*/SKILL.md",
             ".github/copilot-pr-fixup.md",
             ".github/AGENTS-PR-FIXUP.md"]
     rules:
       max-file-length:
         max: 600
-  - files: [".claude/skills/*/SKILL.md"]
+  - glob: [".claude/skills/*/SKILL.md"]
     rules:
       # required-structure.schema for SKILL.md files comes
       # from the `skill` kind; this override only carries
       # the SKILL-specific heading-rule tweaks.
       first-line-heading: false
       heading-increment: false
-  - files: ["AGENTS.md", ".github/copilot-instructions.md"]
+  - glob: ["AGENTS.md", ".github/copilot-instructions.md"]
     rules:
       line-length:
         max: 200
@@ -116,15 +116,15 @@ overrides:
         level: 1
       cross-file-reference-integrity: true
       catalog: false
-  - files: ["docs/development/index.md"]
+  - glob: ["docs/development/index.md"]
     rules:
       first-line-heading: false
       heading-increment: false
-  - files: ["internal/rules/index.md"]
+  - glob: ["internal/rules/index.md"]
     rules:
       table-readability:
         max-rows: 45
-  - files: ["README.md"]
+  - glob: ["README.md"]
     rules:
       line-length:
         max: 100
@@ -138,24 +138,24 @@ overrides:
         max-rows: 40
       paragraph-structure:
         max-sentences: 30
-  - files: ["PLAN.md"]
+  - glob: ["PLAN.md"]
     rules:
       table-readability:
         max-rows: 80
         max-column-width-ratio: 65
-  - files: ["internal/rules/MDS002-heading-style/good/setext.md"]
+  - glob: ["internal/rules/MDS002-heading-style/good/setext.md"]
     rules:
       heading-style:
         style: setext
-  - files: ["internal/rules/MDS010-fenced-code-style/good/tilde.md"]
+  - glob: ["internal/rules/MDS010-fenced-code-style/good/tilde.md"]
     rules:
       fenced-code-style:
         style: tilde
-  - files: ["internal/rules/MDS016-list-indent/good/spaces-4.md"]
+  - glob: ["internal/rules/MDS016-list-indent/good/spaces-4.md"]
     rules:
       list-indent:
         spaces: 4
-  - files: ["docs/background/*.md"]
+  - glob: ["docs/background/**/*.md"]
     rules:
       line-length:
         stern: true
@@ -167,13 +167,13 @@ overrides:
         tokens-per-word: 1.33
         tokenizer: builtin
         encoding: cl100k_base
-  - files: ["docs/development/pr-fixup-workflow.md"]
+  - glob: ["docs/development/pr-fixup-workflow.md"]
     rules:
       first-line-heading: false
       heading-increment: false
       max-file-length:
         max: 330
-  - files: ["docs/guides/*.md"]
+  - glob: ["docs/guides/**/*.md"]
     rules:
       line-length:
         max: 600
@@ -195,7 +195,7 @@ overrides:
       paragraph-structure:
         max-sentences: 12
         max-words-per-sentence: 120
-  - files: ["docs/security/*.md", "!docs/security/proto.md"]
+  - glob: ["docs/security/*.md", "!docs/security/proto.md"]
     rules:
       line-length:
         max: 600
@@ -214,7 +214,7 @@ overrides:
         tokens-per-word: 1.33
         tokenizer: builtin
         encoding: cl100k_base
-  - files: ["docs/research/**"]
+  - glob: ["docs/research/**"]
     rules:
       first-line-heading: false
       heading-increment: false
@@ -285,13 +285,13 @@ kinds:
 # would strip the schema from proto.md, so it is not used
 # here.
 kind-assignment:
-  - files: ["**/proto.md"]
+  - glob: ["**/proto.md"]
     kinds: [proto]
-  - files: ["plan/*.md"]
+  - glob: ["plan/*.md"]
     kinds: [plan]
-  - files: ["internal/rules/proto.md", "internal/rules/MDS*/README.md"]
+  - glob: ["internal/rules/proto.md", "internal/rules/MDS*/README.md"]
     kinds: [rule-readme]
-  - files: [".claude/skills/proto.md", ".claude/skills/*/SKILL.md"]
+  - glob: [".claude/skills/proto.md", ".claude/skills/*/SKILL.md"]
     kinds: [skill]
-  - files: ["docs/security/*.md"]
+  - glob: ["docs/security/*.md"]
     kinds: [security-note]

PLAN.md

@@ -31,7 +31,7 @@ footer: |
 | 112 | ✅     | opus   | [Markdown convention bundles for MDS034](plan/112_flavor-profiles.md)                                |
 | 113 | 🔲     | sonnet | [User-defined Markdown conventions](plan/113_user-defined-profiles.md)                               |
 | 114 | ✅     | sonnet | [MDS034 message clarity and flavor-vs-rule docs](plan/114_mds034-message-and-flavor-vs-rule-docs.md) |
-| 120 | 🔲     | sonnet | [Unify glob matcher and field naming across mdsmith](plan/120_glob-unification.md)                   |
+| 120 | ✅     | sonnet | [Unify glob matcher and field naming across mdsmith](plan/120_glob-unification.md)                   |
 | 121 | 🔲     | opus   | [Expose mdsmith to VS Code via Language Server Protocol](plan/121_vscode-integration.md)             |
 | 121 | ✅     | sonnet | [Review and centralize YAML handling](plan/121_yaml-handling-review.md)                              |
 | 122 | 🔲     | sonnet | [VS Code hover help and palette commands](plan/122_vscode-hover-and-palette.md)                      |

README.md

@@ -150,7 +150,7 @@ ignore:
   - "vendor/**"
 
 overrides:
-  - files: ["CHANGELOG.md"]
+  - glob: ["CHANGELOG.md"]
     rules:
       no-duplicate-headings: false
 ```

cmd/mdsmith/explain_e2e_test.go

@@ -19,7 +19,7 @@ const explainCfg = `kinds:
       line-length:
         max: 30
 kind-assignment:
-  - files: ["short.md"]
+  - glob: ["short.md"]
     kinds: [short]
 rules:
   line-length:

cmd/mdsmith/main.go

@@ -1080,7 +1080,7 @@ purpose (schema, template, fragment, prompt, …) without repeating overrides.
 DECLARATION
 
 Declare kinds under the kinds: key. The body has the same shape as an
-override entry (rules:, categories:) — minus files:, since files are bound
+override entry (rules:, categories:) — minus glob:, since files are bound
 to kinds separately:
 
   kinds:
@@ -1109,9 +1109,9 @@ Duplicate names are dropped after their first occurrence. Referencing an
 undeclared kind is a config error.
 
   kind-assignment:
-    - files: ["plan/[0-9]*_*.md"]
+    - glob: ["plan/[0-9]*_*.md"]
       kinds: [plan]
-    - files: ["**/proto.md"]
+    - glob: ["**/proto.md"]
       kinds: [proto]
 
 MERGE ORDER

demo/kinds/.mdsmith.yml

@@ -12,7 +12,7 @@ kinds:
         max: 100
 
 kind-assignment:
-  - files: ["plan/*.md"]
+  - glob: ["plan/*.md"]
     kinds: [plan]
-  - files: ["prompt/*.md"]
+  - glob: ["prompt/*.md"]
     kinds: [prompt]

demo/structure/.mdsmith.yml

@@ -2,7 +2,7 @@ rules:
   required-structure: true
 
 overrides:
-  - files: ["plan.md"]
+  - glob: ["plan.md"]
     rules:
       required-structure:
         schema: schema.md

docs/guides/directives/enforcing-structure.md

@@ -55,7 +55,7 @@ overrides:
 
 ```yaml
 overrides:
-  - files: ["internal/rules/*/README.md"]
+  - glob: ["internal/rules/*/README.md"]
     rules:
       required-structure:
         schema: internal/rules/proto.md

docs/guides/file-kinds.md

@@ -20,7 +20,7 @@ names that fit its repository.
 
 Kinds live under the `kinds:` key in `.mdsmith.yml`. Each
 kind body has the same shape as an entry under
-`overrides:`, minus `files:` — files are bound to kinds
+`overrides:`, minus `glob:` — files are bound to kinds
 separately.
 
 ```yaml
@@ -78,17 +78,17 @@ order.
 ### Glob assignment
 
 `kind-assignment:` is a list of entries. Each entry has
-`files:` (the same glob shape as `overrides:` and
-`ignore:`) and `kinds:` (the names to apply).
+`glob:` (the same doublestar pattern syntax as `overrides:`
+and `ignore:`) and `kinds:` (the names to apply).
 
 ```yaml
 kind-assignment:
-  - files: ["**/proto.md"]
+  - glob: ["**/proto.md"]
     kinds: [proto]
-  - files: ["plan/*.md"]
+  - glob: ["plan/*.md"]
     kinds: [plan]
-  - files: ["internal/rules/proto.md",
-            "internal/rules/MDS*/README.md"]
+  - glob: ["internal/rules/proto.md",
+           "internal/rules/MDS*/README.md"]
     kinds: [rule-readme]
 ```
 
@@ -133,7 +133,7 @@ order from lowest to highest precedence:
 1. The rule's built-in defaults.
 2. Top-level `rules:` defaults.
 3. Each kind in the file's effective kind list, in order.
-4. Each `overrides:` entry whose `files:` glob matches,
+4. Each `overrides:` entry whose `glob:` matches,
    in config order.
 
 Across all four layers the config is **deep-merged**
@@ -204,7 +204,7 @@ against the merge rules above:
 
 1. Read the file's front matter for any `kinds:` field.
 2. Walk `kind-assignment:` top to bottom and collect
-   every entry whose `files:` glob matches the file.
+   every entry whose `glob:` matches the file.
 3. Concatenate the two lists, dropping duplicates after
    first occurrence — that's the effective kind list.
 4. Apply built-in defaults, then the top-level `rules:`