Design Document for AI based effort prediction feature

.devcontainer/devcontainer.json

@@ -5,7 +5,7 @@
   "workspaceFolder": "/site",
   "workspaceMount": "source=${localWorkspaceFolder},target=/site,type=bind",
   "forwardPorts": [4321],
-  "postStartCommand": "npm run dev",
+  "postStartCommand": "npm install -verbose && npm run dev",
   "features": {
     "ghcr.io/devcontainers/features/github-cli:1": {}
   }

.github/workflows/ci.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Set up Node
         uses: actions/setup-node@v1
         with:
-          node-version: 16.14.2
+          node-version: 24.14.0
       - name: Install dependencies
         run: npm install
       - name: Prettier

Dockerfile

@@ -1,4 +1,4 @@
-FROM node:iron-trixie-slim
+FROM node:24-trixie-slim
 
 WORKDIR /site
 
@@ -7,7 +7,7 @@ COPY package*.json /site/
 RUN apt-get update && apt-get upgrade -y
 RUN apt-get install git curl -y
 
-RUN npm install
+# RUN npm install
 
 # Install Vale
 RUN set -eux; \

annotate_vale.cjs

@@ -0,0 +1,39 @@
+const fs = require('fs');
+const path = require('path');
+
+const warningsFile = '/site/.vale/temp/vale-warnings.json';
+
+// Load Vale JSON output
+const data = JSON.parse(fs.readFileSync(warningsFile, 'utf8'));
+
+for (const filePath in data) {
+  const issues = data[filePath];
+
+  // Sort highest to lowest line number so inserts don't shift later lines
+  issues.sort((a, b) => b.Line - a.Line);
+
+  const absPath = path.resolve(filePath);
+
+  if (!fs.existsSync(absPath)) {
+    console.error(`File not found: ${absPath}`);
+    continue;
+  }
+
+  let lines = fs.readFileSync(absPath, 'utf8').split('\n');
+
+  issues.forEach(issue => {
+    const line = issue.Line;
+    const check = issue.Check;
+    const msg = issue.Message;
+
+    const comment = `<!-- Vale(${check}): ${msg} -->`;
+
+    // Insert comment above the offending line (line numbers are 1-based)
+    lines.splice(line - 1, 0, comment);
+  });
+
+  fs.writeFileSync(absPath, lines.join('\n'));
+  console.log(`Annotated: ${filePath}`);
+}
+
+console.log("Done!");

astro.config.mjs

@@ -75,28 +75,28 @@ export default defineConfig({
         starlightLinksValidator({
           errorOnRelativeLinks: true,
         }),
-        
+
       ],
       customCss: ["./src/styles/custom.css"],
-      social: {
-        github: "https://github.com/thoth-tech",
-      },
+      social: [
+        { icon: 'github', label: 'GitHub', href: 'https://github.com/thoth-tech' },
+      ],
       logo: {
         src: "./public/favicon.svg",
       },
-      components: {
-        // MarkdownContent: "starlight-blog/overrides/MarkdownContent.astro",
-        // Sidebar: "starlight-blog/overrides/Sidebar.astro",
-        // ThemeSelect: "starlight-blog/overrides/ThemeSelect.astro",
-      },
+      // components: {
+      //   MarkdownContent: "starlight-blog/overrides/MarkdownContent.astro",
+      //   Sidebar: "starlight-blog/overrides/Sidebar.astro",
+      //   ThemeSelect: "starlight-blog/overrides/ThemeSelect.astro",
+      // },
       sidebar: [
         {
           label: "Resources",
           collapsed: false,
           items: [
             {
               label: "Introduction",
-              link: "/resources/introduction"
+              link: "/resources/introduction/"
             },
             {
               label: "Thoth Tech Technology Stack",
@@ -116,6 +116,14 @@ export default defineConfig({
               collapsed: true,
               autogenerate: { directory: "Resources/Quality Assurance" },
             },
+            {
+              label: "Writing Style Guide",
+              link: "/resources/writing-style-guide"
+            },
+            {
+              label: "Documenting for Thoth Tech",
+              link: "/resources/documenting-for-thoth-tech"
+            },
             {
               label: "Frequently Asked Questions (FAQ)",
               link: "/resources/faq"

netlify.toml

@@ -1,3 +1,6 @@
 [build]
 command = "npm run build"
 publish = "dist/"
+
+[build.environment]
+  NODE_VERSION = "24"