feat: Add documentation scripts for diagram exports and refresh process

scripts/generate-doc-index.mjs

@@ -46,7 +46,17 @@ function build() {
   for (const cat of Object.keys(byCategory).sort()) {
     body += `### ${cat}\n` + byCategory[cat].map(f => `- ${f}`).join('\n') + '\n\n'
   }
-
+  // Append diagram export instructions (persistent section)
+  body += '## Diagram Export\n'
+  body += 'The architecture diagram source is `ArchitectureDiagram.mmd`. Export updated images using:\n\n'
+  body += '```bash\n'
+  body += 'npm run diagram:png\n'
+  body += 'npm run diagram:svg\n'
+  body += '```\n\n'
+  body += 'Refresh docs index and PNG in one step:\n\n'
+  body += '```bash\n'
+  body += 'npm run docs:refresh\n'
+  body += '```\n\n'
   body += '---\nLast regenerated: ' + new Date().toISOString() + '\n'
   writeFileSync(OUTPUT, body)
   console.log('docs/README.md regenerated.')