feat(cli): add internal CLI for documentation automation

- Implemented commands for building, developing, and translating documentation.
- Added support for AI translation of MDX files from English to Chinese.
- Configured environment variables for documentation directories.
- Created a structure for handling multilingual documentation with Next.js.
- Introduced layout and page components for rendering documentation.
- Added utility functions for file handling and translation logic.
- Included SVG assets for documentation architecture and protocol-driven concepts.
- Established a configuration file for TypeScript and Next.js.

Author: hotlong

README.md

@@ -17,7 +17,7 @@ This repository contains the documentation for:
   - Target: Chinese (`content/docs-zh-CN`) - *Auto-translated via AI*
 - 📝 **MDX Content**: Interactive documentation with Type-safe components.
 - 🛠️ **Automated Workflows**: 
-  - AI Translation CLI (`packages/docs-cli`)
+  - AI Translation CLI (`packages/cli`)
   - Broken link checking
   - SEO optimization
 
@@ -56,7 +56,7 @@ We provide a custom CLI for translation tasks:
 
 ```bash
 # Translate all files
-pnpm docs-cli translate --all
+pnpm objectdocs translate --all
 ```
 
 

package.json

@@ -7,11 +7,11 @@
     "build": "next build",
     "start": "next start",
     "lint": "next lint",
-    "translate": "docs-cli translate",
-    "translate:all": "docs-cli translate --all"
+    "translate": "objectdocs translate",
+    "translate:all": "objectdocs translate --all"
   },
   "devDependencies": {
-    "@docs/cli": "workspace:*"
+    "@objectdocs/cli": "workspace:*"
   },
   "dependencies": {
     "@fumadocs/ui": "^16.4.7",

packages/docs-cli/.gitignore packages/cli/.gitignorepackages/docs-cli/.gitignore renamed to packages/cli/.gitignore

@@ -4,3 +4,9 @@ dist
 .DS_Store
 *.log
 coverage
+
+# Next.js
+site/.next
+site/out
+.next
+out

packages/docs-cli/README.md packages/cli/README.mdpackages/docs-cli/README.md renamed to packages/cli/README.md

@@ -1,4 +1,4 @@
-# @docs/cli
+# objectdocs/cli
 
 Internal CLI tool for automating documentation workflows for ObjectStack.
 
@@ -17,6 +17,20 @@ pnpm install
 
 ## Usage
 
+### Site Management
+
+The CLI can also be used to run the documentation site locally with a VitePress-like experience.
+
+```bash
+# Start Dev Server
+# Usage: pnpm objectdocs dev [docs-directory]
+pnpm objectdocs dev ./content/docs
+
+# Build Static Site
+# Usage: pnpm objectdocs build [docs-directory]
+pnpm objectdocs build ./content/docs
+```
+
 ### Translate Documentation
 
 The `translate` command reads English documentation from `content/docs` and generates Chinese translations in `content/docs-zh-CN`.
@@ -33,16 +47,16 @@ OPENAI_BASE_URL=https://api.openai.com/v1 # Optional
 
 ```bash
 # Translate a specific file
-pnpm docs-cli translate content/docs/00-intro/index.mdx
+pnpm objectdocs translate content/docs/00-intro/index.mdx
 
 # Translate multiple files
-pnpm docs-cli translate content/docs/00-intro/index.mdx content/docs/01-quickstart/index.mdx
+pnpm objectdocs translate content/docs/00-intro/index.mdx content/docs/01-quickstart/index.mdx
 
 # Translate all files in content/docs
-pnpm docs-cli translate --all
+pnpm objectdocs translate --all
 
 # Specify a custom model (default: gpt-4o)
-pnpm docs-cli translate --all --model gpt-4-turbo
+pnpm objectdocs translate --all --model gpt-4-turbo
 ```
 
 ### CI/CD Integration
@@ -51,5 +65,5 @@ In CI environments, you can use the `CHANGED_FILES` environment variable to tran
 
 ```bash
 export CHANGED_FILES="content/docs/new-page.mdx"
-pnpm docs-cli translate
+pnpm objectdocs translate
 ```

packages/docs-cli/bin/cli.mjs packages/cli/bin/cli.mjspackages/docs-cli/bin/cli.mjs renamed to packages/cli/bin/cli.mjs

@@ -2,10 +2,14 @@
 import { cac } from 'cac';
 import 'dotenv/config';
 import { registerTranslateCommand } from '../src/commands/translate.mjs';
+import { registerDevCommand } from '../src/commands/dev.mjs';
+import { registerBuildCommand } from '../src/commands/build.mjs';
 
-const cli = cac('docs-cli');
+const cli = cac('objectdocs');
 
 registerTranslateCommand(cli);
+registerDevCommand(cli);
+registerBuildCommand(cli);
 
 cli.help();
 cli.version('0.0.1');

packages/cli/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@objectdocs/cli",
+  "version": "0.0.1",
+  "type": "module",
+  "bin": {
+    "objectdocs": "./bin/cli.mjs"
+  },
+  "scripts": {
+    "dev": "node ./bin/cli.mjs dev ../../content/docs",
+    "build": "node ./bin/cli.mjs build ../../content/docs",
+    "translate": "node ./bin/cli.mjs translate",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {
+    "@fumadocs/ui": "^16.4.7",
+    "@tailwindcss/postcss": "^4.1.18",
+    "@types/mdx": "^2.0.13",
+    "@types/node": "^25.0.8",
+    "@types/react": "^19.2.8",
+    "autoprefixer": "^10.4.23",
+    "cac": "^6.7.14",
+    "dev": "^0.1.3",
+    "dotenv": "^16.4.5",
+    "fumadocs-core": "^16.4.7",
+    "fumadocs-mdx": "^14.2.5",
+    "fumadocs-ui": "^16.4.7",
+    "next": "^16.1.2",
+    "openai": "^4.0.0",
+    "postcss": "^8.5.6",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "tailwindcss": "^4.1.18",
+    "typescript": "^5.9.3"
+  }
+}

packages/cli/site/app/[lang]/docs/[[...slug]]/page.tsx

@@ -0,0 +1,47 @@
+import { source } from '@/lib/source';
+import type { Metadata } from 'next';
+import { DocsPage, DocsBody } from 'fumadocs-ui/page';
+import { notFound } from 'next/navigation';
+
+interface PageProps {
+  params: Promise<{
+    lang: string;
+    slug?: string[];
+  }>;
+}
+
+export default async function Page({ params }: PageProps) {
+  const { lang, slug = [] } = await params;
+  
+  const page = source.getPage(slug, lang);
+  
+  if (!page) {
+    notFound();
+  }
+
+  const MDX = page.data.body as any;
+
+  return (
+    <DocsPage toc={page.data.toc as any} full={page.data.full as any}>
+      <DocsBody>
+        <MDX />
+      </DocsBody>
+    </DocsPage>
+  );
+}
+
+export async function generateStaticParams() {
+  return source.generateParams();
+}
+
+export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
+  const { lang, slug = [] } = await params;
+  const page = source.getPage(slug, lang);
+
+  if (!page) notFound();
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+  };
+}

packages/cli/site/app/[lang]/docs/layout.tsx

@@ -0,0 +1,23 @@
+import { source } from '@/lib/source';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import type { ReactNode } from 'react';
+import { baseOptions } from '@/app/layout.config';
+
+export default async function Layout({
+  params,
+  children,
+}: {
+  params: Promise<{ lang: string }>;
+  children: ReactNode;
+}) {
+  const { lang } = await params;
+  
+  return (
+    <DocsLayout
+      tree={source.getPageTree(lang)}
+      {...baseOptions}
+    >
+      {children}
+    </DocsLayout>
+  );
+}

packages/cli/site/app/[lang]/layout.tsx

@@ -0,0 +1,38 @@
+import { I18nProvider } from 'fumadocs-ui/contexts/i18n';
+import { defineI18nUI } from 'fumadocs-ui/i18n';
+import type { ReactNode } from 'react';
+import { i18n } from '@/lib/i18n';
+import { cn } from '@/lib/i18n-ui';
+
+const translations = {
+  'zh-CN': cn,
+};
+
+const i18nConfig = defineI18nUI(i18n, {
+  translations: {
+    en: {
+      displayName: 'English',
+    },
+    'zh-CN': {
+      ...cn,
+      displayName: '简体中文',
+    },
+  },
+});
+
+export default async function LangLayout({
+  params,
+  children,
+}: {
+  params: Promise<{ lang: string }>;
+  children: ReactNode;
+}) {
+  const { lang } = await params;
+  const providerProps = i18nConfig.provider(lang);
+  
+  return <I18nProvider {...providerProps}>{children}</I18nProvider>;
+}
+
+export async function generateStaticParams() {
+  return i18n.languages.map((lang) => ({ lang }));
+}

packages/cli/site/app/[lang]/page.tsx

@@ -0,0 +1,10 @@
+import { redirect } from 'next/navigation';
+
+export default async function LangPage({
+  params,
+}: {
+  params: Promise<{ lang: string }>;
+}) {
+  const { lang } = await params;
+  redirect(`/${lang}/docs`);
+}