Merge branch 'main' into copilot/analyze-theming-support

Author: rajbos

.vscode/settings.json

@@ -23,6 +23,7 @@
         "/^node \\.github/skills/load-cache-data/load-cache-data\\.js(?: --last \\d+)?(?: --json)?$/": {
             "approve": true,
             "matchCommandLine": true
-        }
+        },
+        "npx eslint": true
     }
 }

esbuild.js

@@ -47,6 +47,7 @@ async function main() {
 			usage: 'src/webview/usage/main.ts',
 			diagnostics: 'src/webview/diagnostics/main.ts',
 			logviewer: 'src/webview/logviewer/main.ts',
+			maturity: 'src/webview/maturity/main.ts',
 		},
 		bundle: true,
 		format: 'iife',

package.json

@@ -49,6 +49,11 @@
         "title": "Generate Diagnostic Report",
         "category": "Copilot Token Tracker"
       },
+      {
+        "command": "copilot-token-tracker.showMaturity",
+        "title": "Show Copilot Fluency Score",
+        "category": "Copilot Token Tracker"
+      },
       {
         "command": "copilot-token-tracker.configureBackend",
         "title": "Configure Backend",

src/README.md

@@ -77,3 +77,38 @@ Note: These are the current GitHub Copilot supported Gemini models. Pricing from
 - After making changes, run `npm run compile` to rebuild
 - Pricing is for reference only - GitHub Copilot may use different pricing structures
 - Cost estimates assume a 50/50 split between input and output tokens
+
+## customizationPatterns.json
+
+Defines repository file patterns that the extension will scan for to discover Copilot customization files (for example: `copilot-instructions.md`, `skills/` folders, `agents.md`). The extension uses these patterns to produce the "Customization Files" section in the Usage Analysis webview.
+
+Structure:
+
+```json
+{
+  "patterns": [
+    {
+      "id": "copilot-instructions",
+      "label": "copilot-instructions.md",
+      "path": "copilot-instructions.md",
+      "scanMode": "exact",
+      "icon": "📋"
+    }
+  ],
+  "stalenessThresholdDays": 90,
+  "excludeDirs": [".git", "node_modules"]
+}
+```
+
+Notes:
+
+- `scanMode` can be `exact`, `oneLevel`, or `recursive`.
+- `stalenessThresholdDays` controls when a file is marked as stale in the UI.
+- `excludeDirs` lists directories to skip during recursive scans.
+
+To update patterns:
+
+1. Edit `src/customizationPatterns.json` and add or adjust entries.
+2. Run `npm run compile` to rebuild the extension.
+
+The usage webview will surface discovered files per workspace and mark files as stale when their last modification time exceeds `stalenessThresholdDays`.

src/customizationPatterns.json

@@ -0,0 +1,68 @@
+{
+  "description": "Defines Copilot customization file patterns to scan in workspaces",
+  "lastUpdated": "2026-02-11",
+  "stalenessThresholdDays": 90,
+  "excludeDirs": ["node_modules", ".git", "dist", "build", "out", "__pycache__", ".venv", ".next", "coverage"],
+  "patterns": [
+    {
+      "id": "copilot-instructions",
+      "type": "instructions",
+      "icon": "📋",
+      "label": "Instructions",
+      "path": ".github/copilot-instructions.md",
+      "scanMode": "exact"
+    },
+    {
+      "id": "copilot-setup",
+      "type": "coding-agent",
+      "icon": "⚙️",
+      "label": "Coding Agent Setup",
+      "path": ".github/copilot-setup.md",
+      "scanMode": "exact"
+    },
+    {
+      "id": "mcp-config",
+      "type": "mcp-config",
+      "icon": "🔌",
+      "label": "MCP Server Config",
+      "path": ".vscode/mcp.json",
+      "scanMode": "exact"
+    },
+    {
+      "id": "skills",
+      "type": "skill",
+      "icon": "🧠",
+      "label": "Skill Files",
+      "path": ".github/skills/*/SKILL.md",
+      "scanMode": "oneLevel"
+    },
+    {
+      "id": "agents-dir",
+      "type": "agent",
+      "icon": "🤖",
+      "label": "Custom agents",
+      "path": ".github/agents/*.md",
+      "scanMode": "recursive",
+      "maxDepth": 3
+    },
+    {
+      "id": "scoped-instructions",
+      "type": "instructions",
+      "icon": "📋",
+      "label": "Scoped Instructions",
+      "path": "**/*.instructions.md",
+      "scanMode": "recursive",
+      "maxDepth": 5
+    },
+    {
+      "id": "agents-md",
+      "type": "agent",
+      "icon": "🤖",
+      "label": "AGENTS.md",
+      "path": "**/AGENTS.md",
+      "scanMode": "recursive",
+      "maxDepth": 5,
+      "caseInsensitive": true
+    }
+  ]
+}