qmd: replace paths array with pattern string and add ignore for excluded patterns

.github/workflows/dev.md

@@ -21,9 +21,7 @@ tools:
     gpu: true
     checkouts:
       - name: docs
-        paths:
-          - docs/src/**/*.md
-          - docs/src/**/*.mdx
+        pattern: "docs/src/**"
         context: "gh-aw project documentation"
     searches:
       - name: issues

.github/workflows/shared/mcp/qmd-docs.md

@@ -14,10 +14,7 @@ tools:
     gpu: true
     checkouts:
       - name: gh-aw
-        paths:
-          - docs/src/content/docs/**
-          - .github/agents/**
-          - .github/aw/**
+        pattern: "**"
         context: "gh-aw project documentation, agent definitions, and workflow authoring instructions"
 
 ---

.github/workflows/shared/mcp/qmd.md

@@ -14,10 +14,7 @@ tools:
     gpu: true
     checkouts:
       - name: gh-aw
-        paths:
-          - docs/src/content/docs/**
-          - .github/agents/**
-          - .github/aw/**
+        pattern: "**"
         context: "gh-aw project documentation, agent definitions, and workflow authoring instructions"
 
 ---

.github/workflows/smoke-codex.md

@@ -37,9 +37,7 @@ tools:
   qmd:
     checkouts:
       - name: docs
-        paths:
-          - docs/src/**/*.md
-          - docs/src/**/*.mdx
+        pattern: "docs/src/**"
         context: "gh-aw project documentation"
     searches:
       - name: issues

actions/setup/js/qmd_index.cjs

@@ -8,7 +8,7 @@ const { pathToFileURL } = require("url");
 const { ERR_CONFIG, ERR_VALIDATION } = require("./error_codes.cjs");
 
 /**
- * @typedef {{ name: string, path: string, patterns?: string[], context?: string }} QmdCheckout
+ * @typedef {{ name: string, path: string, pattern?: string, context?: string }} QmdCheckout
  * @typedef {{ name?: string, type?: string, query?: string, repo?: string, min?: number, max?: number, tokenEnvVar?: string }} QmdSearch
  * @typedef {{ dbPath: string, checkouts?: QmdCheckout[], searches?: QmdSearch[] }} QmdConfig
  */
@@ -48,12 +48,12 @@ async function writeSummary(config, updateResult, embedResult) {
     const checkouts = config.checkouts ?? [];
     if (checkouts.length > 0) {
       md += "### Collections\n\n";
-      md += "| Name | Patterns | Context |\n";
+      md += "| Name | Pattern | Context |\n";
       md += "| --- | --- | --- |\n";
       for (const col of checkouts) {
-        const patterns = (col.patterns || ["**/*.md"]).join(", ");
+        const pattern = col.pattern || "**/*.md";
         const ctx = col.context || "-";
-        md += `| ${col.name} | ${patterns} | ${ctx} |\n`;
+        md += `| ${col.name} | ${pattern} | ${ctx} |\n`;
       }
       md += "\n";
     }
@@ -138,8 +138,7 @@ async function main() {
   for (const checkout of config.checkouts || []) {
     const rawPath = checkout.path;
     const resolvedPath = resolveEnvVars(rawPath);
-    const patterns = checkout.patterns || ["**/*.md"];
-    const pattern = patterns.join(",");
+    const pattern = checkout.pattern || "**/*.md";
 
     core.info(`Collection "${checkout.name}": path="${rawPath}" -> "${resolvedPath}" pattern="${pattern}"`);
 
@@ -274,8 +273,7 @@ async function main() {
       core.warning(
         "No files were indexed. Possible causes:\n" +
           "  - The checkout path does not exist or was not checked out\n" +
-          "  - The glob patterns do not match any files (check for dotfile exclusions in patterns starting with '.')\n" +
-          "  - The pattern uses a comma-separated list that the qmd SDK does not support\n" +
+          "  - The glob pattern does not match any files (check for dotfile exclusions in patterns starting with '.')\n" +
           "  - The checkout path resolves to an empty string (check ${ENV_VAR} placeholders in 'path')\n" +
           "Review the collection log lines above for the resolved path and pattern."
       );

actions/setup/js/qmd_index.test.cjs

@@ -182,7 +182,7 @@ describe("qmd_index.cjs", () => {
 
     await runMain({
       dbPath: path.join(tmpDir, "index"),
-      checkouts: [{ name: "docs", path: docsDir, patterns: ["**/*.md"], context: "Project docs" }],
+      checkouts: [{ name: "docs", path: docsDir, pattern: "**/*.md", context: "Project docs" }],
     });
 
     expect(mockCore.setFailed).not.toHaveBeenCalled();
@@ -199,7 +199,7 @@ describe("qmd_index.cjs", () => {
 
     await runMain({
       dbPath: path.join(tmpDir, "index"),
-      checkouts: [{ name: "docs", path: "${GITHUB_WORKSPACE}", patterns: ["**/*.md"] }],
+      checkouts: [{ name: "docs", path: "${GITHUB_WORKSPACE}", pattern: "**/*.md" }],
     });
 
     expect(mockCore.setFailed).not.toHaveBeenCalled();
@@ -393,7 +393,7 @@ describe("qmd_index.cjs", () => {
 
     await runMain({
       dbPath: path.join(tmpDir, "index"),
-      checkouts: [{ name: "docs", path: docsDir, patterns: ["**/*.md"] }],
+      checkouts: [{ name: "docs", path: docsDir, pattern: "**/*.md" }],
       searches: [{ name: "issues", type: "issues", max: 50 }],
     });
 
@@ -426,15 +426,15 @@ describe("qmd_index.cjs", () => {
 
     await runMain({
       dbPath: path.join(tmpDir, "index"),
-      checkouts: [{ name: "docs", path: docsDir, patterns: ["**/*.md", "**/*.mdx"], context: "Project docs" }],
+      checkouts: [{ name: "docs", path: docsDir, pattern: "**/*.md", context: "Project docs" }],
     });
 
     const summaryText = mockCore.summary.addRaw.mock.calls.flat().join("\n");
     expect(summaryText).toContain("<details open>");
     expect(summaryText).toContain("<summary>qmd documentation index</summary>");
     expect(summaryText).toContain("</details>");
     expect(summaryText).toContain("### Collections");
-    expect(summaryText).toContain("| docs | **/*.md, **/*.mdx | Project docs |");
+    expect(summaryText).toContain("| docs | **/*.md | Project docs |");
     expect(mockCore.summary.write).toHaveBeenCalledOnce();
   });