refactor(build): improve type safety in manifest generation

Enhance the manifest index generation script to include proper TypeScript type imports and assertions for all generated files. Refactor manifesto module to use generated exports.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: ericyangpan

scripts/generate-manifest-indexes.js

@@ -91,17 +91,30 @@ function generateIndexFile(typeName) {
   const firstFile = files[0].replace('.json', '');
   const firstVarName = toPascalCase(firstFile);
 
+  // Add appropriate type import based on manifest type
+  const typeImportMap = {
+    'ides': 'ManifestIDE',
+    'clis': 'ManifestCLI',
+    'models': 'ManifestModel',
+    'providers': 'ManifestProvider',
+    'extensions': 'ManifestExtension',
+    'vendors': 'ManifestVendor'
+  };
+
+  const manifestType = typeImportMap[typeName];
+  const typeImport = manifestType ? `import type { ${manifestType} } from '../../types/manifests';\n\n` : '';
+
   const content = `/**
  * Auto-generated manifest index for ${typeName}
  * Generated by scripts/generate-manifest-indexes.js
  * Do not edit manually - run the script to regenerate
  */
 
-${imports}
+${typeImport}${imports}
 
 export const ${typeName}Data = [
   ${arrayItems}
-];
+]${manifestType ? ` as unknown as ${manifestType}[]` : ''};
 
 export type ${TypeName} = typeof ${firstVarName};
 

src/lib/generated/clis.ts

@@ -4,6 +4,8 @@
  * Do not edit manually - run the script to regenerate
  */
 
+import type { ManifestCLI } from '../../types/manifests';
+
 import AmazonQDeveloperCli from '../../../manifests/clis/amazon-q-developer-cli.json';
 import AmpCli from '../../../manifests/clis/amp-cli.json';
 import AugmentCodeCli from '../../../manifests/clis/augment-code-cli.json';
@@ -40,7 +42,7 @@ export const clisData = [
   NeovateCode,
   Opencode,
   QoderCli
-];
+] as unknown as ManifestCLI[];
 
 export type Cli = typeof AmazonQDeveloperCli;
 

src/lib/generated/extensions.ts

@@ -4,6 +4,8 @@
  * Do not edit manually - run the script to regenerate
  */
 
+import type { ManifestExtension } from '../../types/manifests';
+
 import Amp from '../../../manifests/extensions/amp.json';
 import AugmentCode from '../../../manifests/extensions/augment-code.json';
 import ClaudeCode from '../../../manifests/extensions/claude-code.json';
@@ -26,7 +28,7 @@ export const extensionsData = [
   KiloCode,
   RooCode,
   Tabnine
-];
+] as unknown as ManifestExtension[];
 
 export type Extension = typeof Amp;
 

src/lib/generated/ides.ts

@@ -4,6 +4,8 @@
  * Do not edit manually - run the script to regenerate
  */
 
+import type { ManifestIDE } from '../../types/manifests';
+
 import Codebuddy from '../../../manifests/ides/codebuddy.json';
 import Codeflicker from '../../../manifests/ides/codeflicker.json';
 import Cursor from '../../../manifests/ides/cursor.json';
@@ -28,7 +30,7 @@ export const idesData = [
   Vscode,
   Windsurf,
   Zed
-];
+] as unknown as ManifestIDE[];
 
 export type Ide = typeof Codebuddy;
 

src/lib/generated/manifesto.ts

@@ -0,0 +1,16 @@
+// This file is auto-generated by scripts/generate-metadata.mjs
+// DO NOT EDIT MANUALLY
+
+/**
+ * Return the Manifesto MDX React component for a given locale.
+ * Falls back to the default locale ('en') when the requested locale is missing.
+ */
+export function getManifestoComponent(locale: string = 'en'): React.ComponentType {
+  const components: Record<string, React.ComponentType> = {
+    'en': require('@content/manifesto/en/index.mdx').default,
+    'zh-Hans': require('@content/manifesto/zh-Hans/index.mdx').default,
+    'de': require('@content/manifesto/de/index.mdx').default,
+  };
+
+  return components[locale] || components['en'];
+}

src/lib/generated/metadata.ts

@@ -455,7 +455,7 @@ export const faqMetadata: Record<string, FaqItem[]> = {
     },
     {
       "title": "Is AI Coding Stack open source? Can I contribute?",
-      "content": "Yes, AI Coding Stack is fully open source and released under the Apache 2.0 license. The project welcomes contributions from the community! You can contribute by:\n\n- Adding or updating tool metadata in the manifests directory (ides.json, clis.json, models.json, providers.json)\n- Reporting inaccuracies or outdated information\n- Suggesting new tools to be added\n- Improving documentation and guides\n- Submitting pull requests\n\nVisit the [GitHub repository](https://github.com/ericyangpan/aicodingstack) to get started with contributing to the AI coding ecosystem."
+      "content": "Yes, AI Coding Stack is fully open source and released under the Apache 2.0 license. The project welcomes contributions from the community! You can contribute by:\n\n- Adding or updating tool metadata in the manifests directory (ides.json, clis.json, models.json, providers.json)\n- Reporting inaccuracies or outdated information\n- Suggesting new tools to be added\n- Improving documentation and guides\n- Submitting pull requests\n\nVisit the [GitHub repository](https://github.com/aicodingstack/aicodingstack) to get started with contributing to the AI coding ecosystem."
     },
     {
       "title": "How does AI Coding Stack help me choose the right tools?",
@@ -477,7 +477,7 @@ export const faqMetadata: Record<string, FaqItem[]> = {
     },
     {
       "title": "AI Coding Stack 是开源的吗? 我可以贡献吗?",
-      "content": "是的，AI Coding Stack 完全开源，采用 MIT 许可证发布。项目欢迎社区贡献！你可以通过以下方式贡献：\n\n- 在 manifests 目录中添加或更新工具元数据 (ides.json, clis.json, models.json, providers.json)\n- 报告不准确或过时的信息\n- 建议添加新工具\n- 改进文档和指南\n- 提交 pull request\n\n访问 [GitHub 仓库](https://github.com/ericyangpan/aicodingstack) 开始为 AI 编码生态系统做贡献。"
+      "content": "是的，AI Coding Stack 完全开源，采用 MIT 许可证发布。项目欢迎社区贡献！你可以通过以下方式贡献：\n\n- 在 manifests 目录中添加或更新工具元数据 (ides.json, clis.json, models.json, providers.json)\n- 报告不准确或过时的信息\n- 建议添加新工具\n- 改进文档和指南\n- 提交 pull request\n\n访问 [GitHub 仓库](https://github.com/aicodingstack/aicodingstack) 开始为 AI 编码生态系统做贡献。"
     },
     {
       "title": "AI Coding Stack 如何帮助我选择合适的工具?",
@@ -499,7 +499,7 @@ export const faqMetadata: Record<string, FaqItem[]> = {
     },
     {
       "title": "Ist AI Coding Stack Open Source? Kann ich beitragen?",
-      "content": "Ja, AI Coding Stack ist vollständig Open Source und unter der Apache 2.0 Lizenz veröffentlicht. Das Projekt begrüßt Beiträge aus der Community! Sie können beitragen, indem Sie:\n\n- Tool-Metadaten im Manifests-Verzeichnis hinzufügen oder aktualisieren (ides.json, clis.json, models.json, providers.json)\n- Ungenauigkeiten oder veraltete Informationen melden\n- Neue Tools vorschlagen, die hinzugefügt werden sollen\n- Dokumentation und Leitfäden verbessern\n- Pull-Requests einreichen\n\nBesuchen Sie das [GitHub-Repository](https://github.com/ericyangpan/aicodingstack), um mit dem Beitragen zum KI-Coding-Ökosystem zu beginnen."
+      "content": "Ja, AI Coding Stack ist vollständig Open Source und unter der Apache 2.0 Lizenz veröffentlicht. Das Projekt begrüßt Beiträge aus der Community! Sie können beitragen, indem Sie:\n\n- Tool-Metadaten im Manifests-Verzeichnis hinzufügen oder aktualisieren (ides.json, clis.json, models.json, providers.json)\n- Ungenauigkeiten oder veraltete Informationen melden\n- Neue Tools vorschlagen, die hinzugefügt werden sollen\n- Dokumentation und Leitfäden verbessern\n- Pull-Requests einreichen\n\nBesuchen Sie das [GitHub-Repository](https://github.com/aicodingstack/aicodingstack), um mit dem Beitragen zum KI-Coding-Ökosystem zu beginnen."
     },
     {
       "title": "Wie hilft mir AI Coding Stack bei der Auswahl der richtigen Tools?",
@@ -512,7 +512,7 @@ export const stackCounts: Record<string, number> = {
   "ides": 11,
   "clis": 17,
   "extensions": 10,
-  "models": 11,
+  "models": 23,
   "model-providers": 6,
   "vendors": 12
 };

src/lib/generated/models.ts

@@ -4,31 +4,57 @@
  * Do not edit manually - run the script to regenerate
  */
 
+import type { ManifestModel } from '../../types/manifests';
+
 import Claude37Sonnet from '../../../manifests/models/claude-3-7-sonnet.json';
+import ClaudeHaiku45 from '../../../manifests/models/claude-haiku-4-5.json';
 import ClaudeOpus41 from '../../../manifests/models/claude-opus-4-1.json';
+import ClaudeSonnet45 from '../../../manifests/models/claude-sonnet-4-5.json';
+import ClaudeSonnet4 from '../../../manifests/models/claude-sonnet-4.json';
 import DeepseekV3Terminus from '../../../manifests/models/deepseek-v3-terminus.json';
+import Gemini25Flash from '../../../manifests/models/gemini-2-5-flash.json';
+import Gemini25Pro from '../../../manifests/models/gemini-2-5-pro.json';
 import Glm46 from '../../../manifests/models/glm-4-6.json';
 import Gpt41 from '../../../manifests/models/gpt-4-1.json';
 import Gpt45 from '../../../manifests/models/gpt-4-5.json';
 import Gpt4o from '../../../manifests/models/gpt-4o.json';
+import Gpt51Codex from '../../../manifests/models/gpt-5-1-codex.json';
+import Gpt51 from '../../../manifests/models/gpt-5-1.json';
+import Gpt5Codex from '../../../manifests/models/gpt-5-codex.json';
+import Gpt5 from '../../../manifests/models/gpt-5.json';
+import GrokCodeFast1 from '../../../manifests/models/grok-code-fast-1.json';
 import KimiK20905 from '../../../manifests/models/kimi-k2-0905.json';
+import Llama4Maverick from '../../../manifests/models/llama-4-maverick.json';
 import MinimaxM2 from '../../../manifests/models/minimax-m2.json';
 import Qwen3Coder30bA3b from '../../../manifests/models/qwen3-coder-30b-a3b.json';
 import Qwen3Coder480bA35b from '../../../manifests/models/qwen3-coder-480b-a35b.json';
+import Qwen3CoderPlus from '../../../manifests/models/qwen3-coder-plus.json';
 
 export const modelsData = [
   Claude37Sonnet,
+  ClaudeHaiku45,
   ClaudeOpus41,
+  ClaudeSonnet45,
+  ClaudeSonnet4,
   DeepseekV3Terminus,
+  Gemini25Flash,
+  Gemini25Pro,
   Glm46,
   Gpt41,
   Gpt45,
   Gpt4o,
+  Gpt51Codex,
+  Gpt51,
+  Gpt5Codex,
+  Gpt5,
+  GrokCodeFast1,
   KimiK20905,
+  Llama4Maverick,
   MinimaxM2,
   Qwen3Coder30bA3b,
-  Qwen3Coder480bA35b
-];
+  Qwen3Coder480bA35b,
+  Qwen3CoderPlus
+] as unknown as ManifestModel[];
 
 export type Model = typeof Claude37Sonnet;
 

src/lib/generated/providers.ts

@@ -4,6 +4,8 @@
  * Do not edit manually - run the script to regenerate
  */
 
+import type { ManifestProvider } from '../../types/manifests';
+
 import Deepseek from '../../../manifests/providers/deepseek.json';
 import Minimax from '../../../manifests/providers/minimax.json';
 import Moonshot from '../../../manifests/providers/moonshot.json';
@@ -18,7 +20,7 @@ export const providersData = [
   Openrouter,
   Siliconflow,
   ZAi
-];
+] as unknown as ManifestProvider[];
 
 export type Provider = typeof Deepseek;
 

src/lib/generated/vendors.ts

@@ -4,6 +4,8 @@
  * Do not edit manually - run the script to regenerate
  */
 
+import type { ManifestVendor } from '../../types/manifests';
+
 import Anthropic from '../../../manifests/vendors/anthropic.json';
 import Augment from '../../../manifests/vendors/augment.json';
 import Deepseek from '../../../manifests/vendors/deepseek.json';
@@ -30,7 +32,7 @@ export const vendorsData = [
   Siliconflow,
   Sourcegraph,
   ZAi
-];
+] as unknown as ManifestVendor[];
 
 export type Vendor = typeof Anthropic;
 

src/lib/manifesto.ts

@@ -1,12 +1 @@
-import React from 'react';
-
-// MDX components mapping for manifesto content by locale
-const manifestoComponents: Record<string, React.ComponentType> = {
-  'en': require('@content/manifesto/en/index.mdx').default,
-  'zh-Hans': require('@content/manifesto/zh-Hans/index.mdx').default,
-};
-
-// Get manifesto component for a specific locale with fallback to English
-export function getManifestoComponent(locale: string = 'en'): React.ComponentType {
-  return manifestoComponents[locale] || manifestoComponents['en'];
-}
+export { getManifestoComponent } from '@/lib/generated/manifesto';