Website audit

Author: MelbourneDeveloper

website/eleventy.config.js

@@ -36,19 +36,20 @@ export default function(eleventyConfig) {
     {% endif %}
   </article>`;
 
-  const blogIndexOverride = `---
+const blogIndexOverride = `---
 layout: layouts/base.njk
-title: Blog
+title: CommandTree Blog - VS Code Command Runner Guide Updates
+description: CommandTree release notes and practical VS Code task runner guides for command discovery, AI summaries, mise tasks, monorepo workflows, and workspace automation.
 permalink: /blog/
 ---
 <div class="blog-container">
   <header class="blog-header">
     <h1>Blog</h1>
-    <p class="blog-subtitle">Latest posts and updates</p>
+    <p class="blog-subtitle">Release notes and practical guides for VS Code task discovery.</p>
   </header>
   <nav class="blog-nav">
     <a href="/blog/tags/" class="blog-nav-link">Tags</a>
-    <a href="/blog/categories/" class="blog-nav-link">Categories</a>
+    {% if collections.categoryList | length > 0 %}<a href="/blog/categories/" class="blog-nav-link">Categories</a>{% endif %}
   </nav>
   <div class="post-list">
   {% for post in collections.posts | sortByDateDesc %}
@@ -62,19 +63,20 @@ permalink: /blog/
   </div>
 </div>`;
 
-  const tagsIndexOverride = `---
+const tagsIndexOverride = `---
 layout: layouts/base.njk
-title: Tags
+title: CommandTree Blog Tags - VS Code Task Runner Topics
+description: Browse CommandTree blog tags for VS Code command runner topics including AI summaries, task discovery, mise tasks, monorepos, and workspace automation.
 permalink: /blog/tags/
 ---
 <div class="blog-container">
   <header class="blog-header">
     <h1>Tags</h1>
-    <p class="blog-subtitle">Browse blog posts by tag</p>
+    <p class="blog-subtitle">Browse CommandTree posts by VS Code task runner topic.</p>
   </header>
   <nav class="blog-nav">
     <a href="/blog/" class="blog-nav-link">All posts</a>
-    <a href="/blog/categories/" class="blog-nav-link">Categories</a>
+    {% if collections.categoryList | length > 0 %}<a href="/blog/categories/" class="blog-nav-link">Categories</a>{% endif %}
   </nav>
   <ul class="taxonomy-grid">
   {% for tag in collections.tagList %}
@@ -87,15 +89,16 @@ permalink: /blog/tags/
   </ul>
 </div>`;
 
-  const categoriesIndexOverride = `---
+const categoriesIndexOverride = `---
 layout: layouts/base.njk
-title: Categories
+title: CommandTree Blog Categories - VS Code Task Runner Guides
+description: Browse CommandTree blog categories for VS Code command runner guides covering task discovery, AI summaries, mise tasks, and workspace automation.
 permalink: /blog/categories/
 ---
 <div class="blog-container">
   <header class="blog-header">
     <h1>Categories</h1>
-    <p class="blog-subtitle">Browse blog posts by category</p>
+    <p class="blog-subtitle">Browse CommandTree posts by guide category.</p>
   </header>
   <nav class="blog-nav">
     <a href="/blog/" class="blog-nav-link">All posts</a>
@@ -123,8 +126,8 @@ pagination:
 permalink: /blog/tags/{{ tag | slugify }}/
 layout: layouts/base.njk
 eleventyComputed:
-  title: "Posts tagged '{{ tag | capitalize }}'"
-  description: "All blog posts tagged with {{ tag | capitalize }}."
+  title: "{{ tag | capitalize }} Articles - CommandTree VS Code Task Runner Blog"
+  description: "CommandTree articles tagged with {{ tag | capitalize }} for VS Code developers who need task discovery, command running, AI summaries, and workspace automation tips."
 ---
 <div class="blog-container">
   <header class="blog-header">
@@ -151,8 +154,8 @@ pagination:
 permalink: /blog/categories/{{ category | slugify }}/
 layout: layouts/base.njk
 eleventyComputed:
-  title: "{{ category | capitalize }}"
-  description: "All blog posts in the {{ category }} category."
+  title: "{{ category | capitalize }} Guides - CommandTree VS Code Task Runner Blog"
+  description: "CommandTree posts in the {{ category }} category for VS Code developers covering command runners, task discovery, AI summaries, and workspace automation."
 ---
 <div class="blog-container">
   <header class="blog-header">
@@ -171,12 +174,46 @@ eleventyComputed:
   </div>
 </div>`;
 
+  const sitemapOverride = `---json
+{
+  "permalink": "sitemap.xml",
+  "eleventyExcludeFromCollections": true
+}
+---
+<?xml version="1.0" encoding="utf-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  {%- for page in collections.all %}
+  {%- set isTagPage = page.url.startsWith('/blog/tags/') %}
+  {%- set isCategoryPage = page.url.startsWith('/blog/categories/') %}
+  {%- if not page.data.eleventyExcludeFromCollections and not isTagPage and not isCategoryPage %}
+  <url>
+    <loc>{{ site.url }}{{ page.url }}</loc>
+    <lastmod>{{ page.date | isoDate }}</lastmod>
+    {%- if page.url == "/" or page.url == "/index.html" %}
+    <priority>1.0</priority>
+    <changefreq>weekly</changefreq>
+    {%- elif "/docs/" in page.url %}
+    <priority>0.8</priority>
+    <changefreq>monthly</changefreq>
+    {%- elif "/blog/" in page.url %}
+    <priority>0.7</priority>
+    <changefreq>monthly</changefreq>
+    {%- else %}
+    <priority>0.5</priority>
+    <changefreq>monthly</changefreq>
+    {%- endif %}
+  </url>
+  {%- endif %}
+  {%- endfor %}
+</urlset>`;
+
   const blogOverrides = {
     "blog/index.njk": blogIndexOverride,
     "blog/tags.njk": tagsIndexOverride,
     "blog/categories.njk": categoriesIndexOverride,
     "blog/tags-pages.njk": tagsPagesOverride,
     "blog/categories-pages.njk": categoriesPagesOverride,
+    "sitemap.njk": sitemapOverride,
   };
   // Register as an inline plugin so it runs AFTER the techdoc plugin
   // (plugins are processed in addPlugin order, after the user config callback).
@@ -296,6 +333,50 @@ eleventyComputed:
     return false;
   };
 
+  const isTaxonomyUrl = (url) => {
+    if (!url) { return false; }
+    return url.startsWith("/blog/tags/") || url.startsWith("/blog/categories/");
+  };
+
+  const findJsonLdBlock = (content) => {
+    const open = '<script type="application/ld+json">';
+    const close = "</script>";
+    const openStart = content.indexOf(open);
+    if (openStart < 0) { return null; }
+    const jsonStart = openStart + open.length;
+    const closeStart = content.indexOf(close, jsonStart);
+    if (closeStart < 0) { return null; }
+    return { jsonStart, closeStart };
+  };
+
+  const asCollectionPage = (item) => {
+    if (item["@type"] !== "BlogPosting") { return item; }
+    const collectionPage = { ...item, "@type": "CollectionPage" };
+    delete collectionPage.author;
+    delete collectionPage.datePublished;
+    return collectionPage;
+  };
+
+  const renderJsonLd = (data) => JSON.stringify(data, null, 2).split("\n").join("\n  ");
+
+  const rewriteTaxonomyJsonLd = (content) => {
+    const block = findJsonLdBlock(content);
+    if (!block) { return content; }
+    try {
+      const data = JSON.parse(content.slice(block.jsonStart, block.closeStart).trim());
+      if (Array.isArray(data["@graph"])) {
+        data["@graph"] = data["@graph"].map(asCollectionPage);
+      }
+      return content.slice(0, block.jsonStart) + "\n  " + renderJsonLd(data) + "\n  " + content.slice(block.closeStart);
+    } catch {
+      return content;
+    }
+  };
+
+  const updateTaxonomySeo = (content) => rewriteTaxonomyJsonLd(content
+    .replace('<meta name="robots" content="index, follow">', '<meta name="robots" content="noindex, follow">')
+    .replace('<meta property="og:type" content="article">', '<meta property="og:type" content="website">'));
+
   eleventyConfig.addTransform("blogHero", function(content) {
     if (!this.page.outputPath?.endsWith(".html")) {
       return content;
@@ -315,6 +396,13 @@ eleventyComputed:
     );
   });
 
+  eleventyConfig.addTransform("taxonomySeo", function(content) {
+    if (!this.page.outputPath?.endsWith(".html") || !isTaxonomyUrl(this.page.url)) {
+      return content;
+    }
+    return updateTaxonomySeo(content);
+  });
+
   eleventyConfig.addTransform("llmsTxt", function(content) {
     if (!this.page.outputPath?.endsWith("llms.txt")) {
       return content;

website/package.json

@@ -4,8 +4,9 @@
   "main": "index.js",
   "scripts": {
     "test": "npx playwright test",
-    "dev": "npx @11ty/eleventy --serve",
-    "build": "npx @11ty/eleventy"
+    "clean": "node -e \"require('node:fs').rmSync('_site',{recursive:true,force:true})\"",
+    "dev": "npm run clean && npx @11ty/eleventy --serve",
+    "build": "npm run clean && npx @11ty/eleventy"
   },
   "keywords": [],
   "author": "",

website/playwright.config.js

@@ -11,7 +11,7 @@ export default defineConfig({
     trace: "on-first-retry",
   },
   webServer: {
-    command: "npx @11ty/eleventy --serve --port=8080",
+    command: "npm run dev -- --port=8080",
     port: 8080,
     reuseExistingServer: !process.env.CI,
     timeout: 30000,

website/playwright.config.ts

@@ -18,7 +18,7 @@ export default defineConfig({
     },
   ],
   webServer: {
-    command: 'npx @11ty/eleventy --serve --port=8080',
+    command: 'npm run dev -- --port=8080',
     url: 'http://localhost:8080',
     reuseExistingServer: !process.env['CI'],
     timeout: 30000,

website/src/blog/ai-summaries-hover.md

@@ -36,7 +36,7 @@ Copilot also flags dangerous operations. If a script runs `rm -rf`, force-pushes
 
 ## Stored Locally, Updated Automatically
 
-Summaries are cached in a local SQLite database at `.commandtree/commandtree.sqlite3` in your workspace. They persist across sessions and only regenerate when the underlying script content changes, so there is no repeated API overhead.
+Summaries are cached in a local SQLite database at `.commandtree/commandtree.sqlite3` in your workspace. They persist across sessions and only regenerate when the underlying script content changes, reducing repeated summary generation.
 
 ## Works Without Copilot
 

website/src/blog/mise-tasks-vscode.md

@@ -1,7 +1,7 @@
 ---
 layout: layouts/blog.njk
 title: Run Mise Tasks From the VS Code Sidebar - CommandTree 0.9.0
-description: CommandTree 0.9.0 auto-discovers every mise task in your workspace - mise.toml, .mise.toml, mise.yaml - and runs them from the VS Code sidebar alongside npm, Make, Just, and 18 other command types.
+description: CommandTree 0.9.0 discovers mise tasks from mise.toml, .mise.toml, and mise.yaml, then runs them from the VS Code sidebar beside npm, Make, and Just.
 date: 2026-04-06
 author: Christian Findlay
 tags:
@@ -36,17 +36,17 @@ Both TOML tasks (`[tasks.build]` sections) and YAML task maps work. Descriptions
 
 ## One Click to Run
 
-Click any mise task and CommandTree opens a new terminal in the same directory as the `mise.toml` file and runs `mise run <task>`. Tool versions, environment variables, and dependencies all resolve normally — *it is exactly the same command you would type yourself*. Tasks with parameters get prompted for input before they run.
+Click any mise task and CommandTree opens a new terminal in the same directory as the `mise.toml` file and runs `mise run <task>`, matching the command format in the [mise task runner documentation](https://mise.jdx.dev/tasks/). Tasks with parameters get prompted for input before they run.
 
 ## Mise *And* Everything Else
 
-This is the part the mise-only extensions can't do. Most real projects are not pure mise. There is a `Makefile` from before the migration, an `npm run lint` script in `package.json`, a couple of shell scripts in `scripts/`, maybe a `Justfile` for the deploy step.
+Projects often keep more than one task system around: a `Makefile` from before the migration, an `npm run lint` script in `package.json`, shell scripts in `scripts/`, or a `Justfile` for the deploy step.
 
 CommandTree discovers **22 command types** and shows them in one tree:
 
 mise tasks, npm scripts, Makefile targets, Just recipes, Taskfile, shell scripts, Python scripts, PowerShell, Cargo, Gradle, Maven, Ant, Deno, Rake, Composer, Docker Compose services, .NET projects, C# scripts, F# scripts, VS Code tasks, launch configs, and Markdown files.
 
-**One extension instead of three.** Filter by tag, pin favourites, search by text — it all works across every command type at once.
+Filter by tag, pin favourites, and search by text across every command type at once.
 
 ## Hover to See What a Task Does
 

website/src/docs/ai-summaries.md

@@ -41,7 +41,7 @@ Each summary is a one-to-two sentence plain-language description of what the com
 
 ### Are summaries stored locally?
 
-Yes. All summaries are stored in a SQLite database at `.commandtree/commandtree.sqlite3` in your workspace root. No data is sent to external servers beyond the GitHub Copilot API that runs locally in VS Code.
+Yes. Summaries are stored in a SQLite database at `.commandtree/commandtree.sqlite3` in your workspace root. When AI summaries are enabled, CommandTree uses the installed [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) extension to generate the text.
 
 ### How are security warnings triggered?
 

website/tests/seo.spec.ts

@@ -8,8 +8,33 @@ const ALL_PAGES = [
   '/docs/execution/',
   '/docs/configuration/',
   '/blog/',
+  '/blog/introducing-commandtree/',
+  '/blog/ai-summaries-hover/',
+  '/blog/mise-tasks-vscode/',
 ];
 
+const TAXONOMY_PAGES = [
+  '/blog/tags/',
+  '/blog/tags/mise/',
+  '/blog/categories/',
+];
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null;
+}
+
+function getGraph(value: unknown): Record<string, unknown>[] {
+  if (!isRecord(value)) {
+    return [];
+  }
+  const graph = value['@graph'];
+  return Array.isArray(graph) ? graph.filter(isRecord) : [];
+}
+
+function getString(value: unknown): string {
+  return typeof value === 'string' ? value : '';
+}
+
 test.describe('SEO and Meta', () => {
   test('homepage has meta description', async ({ page }) => {
     await page.goto('/');
@@ -36,8 +61,12 @@ test.describe('SEO and Meta', () => {
       await page.goto(url);
       const content = await page.locator('meta[name="description"]').getAttribute('content');
       expect(content, `${url} should have a meta description`).toBeTruthy();
-      expect(content!.length, `${url} description should be at least 50 chars`).toBeGreaterThanOrEqual(50);
-      descriptions.push(content!);
+      if (!content) {
+        continue;
+      }
+      expect(content.length, `${url} description should be at least 120 chars`).toBeGreaterThanOrEqual(120);
+      expect(content.length, `${url} description should be at most 170 chars`).toBeLessThanOrEqual(170);
+      descriptions.push(content);
     }
     const unique = new Set(descriptions);
     expect(unique.size, 'All pages should have unique meta descriptions').toBe(descriptions.length);
@@ -49,6 +78,8 @@ test.describe('SEO and Meta', () => {
       await page.goto(url);
       const title = await page.title();
       expect(title, `${url} should have a title`).toBeTruthy();
+      expect(title.length, `${url} title should be at least 30 chars`).toBeGreaterThanOrEqual(30);
+      expect(title.length, `${url} title should be at most 70 chars`).toBeLessThanOrEqual(70);
       titles.push(title);
     }
     const unique = new Set(titles);
@@ -84,11 +115,32 @@ test.describe('SEO and Meta', () => {
       expect(count, `${url} should have JSON-LD`).toBeGreaterThanOrEqual(1);
       for (let i = 0; i < count; i++) {
         const text = await scripts.nth(i).textContent();
-        expect(() => JSON.parse(text!), `${url} JSON-LD should be valid JSON`).not.toThrow();
+        expect(text, `${url} JSON-LD should not be empty`).toBeTruthy();
+        if (!text) {
+          continue;
+        }
+        expect(() => JSON.parse(text), `${url} JSON-LD should be valid JSON`).not.toThrow();
       }
     }
   });
 
+  test('taxonomy pages are noindex collection pages', async ({ page }) => {
+    for (const url of TAXONOMY_PAGES) {
+      await page.goto(url);
+      await expect(page.locator('meta[name="robots"]')).toHaveAttribute('content', 'noindex, follow');
+      await expect(page.locator('meta[property="og:type"]')).toHaveAttribute('content', 'website');
+      const text = await page.locator('script[type="application/ld+json"]').first().textContent();
+      expect(text, `${url} should have JSON-LD`).toBeTruthy();
+      if (!text) {
+        continue;
+      }
+      const graph = getGraph(JSON.parse(text));
+      const pageNode = graph.find((item) => getString(item['url']).endsWith(url));
+      expect(getString(pageNode?.['@type']), `${url} should use CollectionPage schema`).toBe('CollectionPage');
+      expect(pageNode?.['datePublished'], `${url} should not use article dates`).toBeUndefined();
+    }
+  });
+
   test('homepage has og:image', async ({ page }) => {
     await page.goto('/');
     const ogImage = await page.locator('meta[property="og:image"]').getAttribute('content');
@@ -111,7 +163,10 @@ test.describe('SEO and Meta', () => {
     for (let i = 0; i < count; i++) {
       const alt = await images.nth(i).getAttribute('alt');
       expect(alt, `Image ${i} should have alt text`).toBeTruthy();
-      expect(alt!.length, `Image ${i} alt text should be descriptive`).toBeGreaterThan(3);
+      if (!alt) {
+        continue;
+      }
+      expect(alt.length, `Image ${i} alt text should be descriptive`).toBeGreaterThan(3);
     }
   });