scaffold-doc-cli 1.0.0

package/.docs/architecture.md

@@ -0,0 +1,9 @@
+# Architecture
+
+<!-- 
+  INSTRUCTION: Document the high-level system architecture, data flow, and key design decisions.
+-->
+
+## specificities
+<!-- AI_CONTENT_START -->
+<!-- AI_CONTENT_END -->

package/.docs/getting-started.md

@@ -0,0 +1,13 @@
+# Getting Started
+
+<!-- 
+  INSTRUCTION: Document the installation and setup steps.
+-->
+
+## Prerequisites
+<!-- AI_CONTENT_START -->
+<!-- AI_CONTENT_END -->
+
+## Installation
+<!-- AI_CONTENT_START -->
+<!-- AI_CONTENT_END -->

package/.docs/index.md

@@ -0,0 +1,15 @@
+<!-- 
+  AI_DOC_START
+  CONTEXT: This is the entry point for the project documentation.
+  INSTRUCTION: Analyze the project structure and update the "Overview" section.
+-->
+# test Documentation
+
+## Overview
+<!-- AI_CONTENT_START -->
+Documentation initialized.
+<!-- AI_CONTENT_END -->
+
+## Quick Links
+- [Getting Started](./getting-started.md)
+- [Architecture](./architecture.md)

package/.docs/reference/components.md

@@ -0,0 +1,12 @@
+<!-- 
+  AI_DOC_START
+  STACK: Nuxt
+  TYPE: Components
+-->
+# Components
+
+<!-- INSTRUCTION: Document Vue components in /components -->
+
+## List
+<!-- AI_CONTENT_START -->
+<!-- AI_CONTENT_END -->

package/.docs/reference/composables.md

@@ -0,0 +1,12 @@
+<!-- 
+  AI_DOC_START
+  STACK: Nuxt
+  TYPE: Composables
+-->
+# Composables
+
+<!-- INSTRUCTION: Document auto-imported composables in /composables -->
+
+## List
+<!-- AI_CONTENT_START -->
+<!-- AI_CONTENT_END -->

package/.docs/reference/server-routes.md

@@ -0,0 +1,12 @@
+<!-- 
+  AI_DOC_START
+  STACK: Nuxt
+  TYPE: Server Routes
+-->
+# Server Routes
+
+<!-- INSTRUCTION: Document Nitro server routes in /server/api -->
+
+## List
+<!-- AI_CONTENT_START -->
+<!-- AI_CONTENT_END -->

package/.github/scripts/doc-sync.mjs

@@ -0,0 +1,82 @@
+import { GoogleGenAI } from "@google/genai";
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+
+const genAI = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
+
+async function main() {
+  console.log("Starting AI Doc Sync...");
+
+  // 1. Detect Changed Files
+  let changedFiles = [];
+  try {
+    const output = execSync('git diff --name-only HEAD~1 HEAD').toString();
+    changedFiles = output.split('\n').filter(f => f && !f.startsWith('.docs') && !f.startsWith('.github'));
+  } catch (e) {
+    console.error("Failed to detect changes:", e.message);
+    return;
+  }
+
+  if (changedFiles.length === 0) {
+    console.log("No relevant code changes detected.");
+    return;
+  }
+
+  console.log("Processing changed files:", changedFiles);
+
+  // 2. Prepare Context for Gemini
+  let context = "";
+  for (const file of changedFiles) {
+    if (fs.existsSync(file)) {
+      context += `\n--- File: ${file} ---\n`;
+      context += fs.readFileSync(file, 'utf-8').slice(0, 10000); // Limit size
+    }
+  }
+
+  // 3. Prompt Gemini
+  const model = genAI.getGenerativeModel({ model: "gemini-2.5-flash" });
+  
+  const prompt = `
+    You are a technical documentation assistant. 
+    Analyze the following code changes and update the documentation in the .docs/ directory.
+    
+    Rules:
+    1. Output MUST be a valid JSON object where keys are file paths (relative to .docs/, e.g., "reference/controllers.md") and values are the NEW content of that file.
+    2. You can create new files if necessary. 
+    3. You can update existing files (e.g., getting-started.md, architecture.md).
+    4. Focus on accuracy and clarity.
+    5. Do not include markdown code fence blocks in your response, just the raw JSON string.
+
+    Code Context:
+    ${context}
+  `;
+
+  try {
+    const result = await model.generateContent(prompt);
+    const text = result.response.text();
+    
+    // Simple cleanup if model adds code blocks
+    const jsonStr = text.replace(/\`\`\`json/g, '').replace(/\`\`\`/g, '').trim();
+    const updates = JSON.parse(jsonStr);
+
+    // 4. Write Updates
+    for (const [relativePath, content] of Object.entries(updates)) {
+      const fullPath = path.join(process.cwd(), '.docs', relativePath);
+      const dir = path.dirname(fullPath);
+      
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+      
+      fs.writeFileSync(fullPath, content);
+      console.log(`Updated: .docs/${relativePath}`);
+    }
+
+  } catch (error) {
+    console.error("AI Generation failed:", error);
+    process.exit(1);
+  }
+}
+
+main();

package/.github/workflows/ai-doc-sync.yml

@@ -0,0 +1,37 @@
+name: AI Doc Sync
+
+on:
+  push:
+    paths-ignore:
+      - '.docs/**'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  doc-completion:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 2
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+
+      - name: Install Dependencies
+        run: npm install @google/genai
+
+      - name: Run AI Doc Sync
+        env:
+          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+        run: node .github/scripts/doc-sync.mjs
+
+      - name: Commit Changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "docs: auto-generated documentation updates"
+          file_pattern: .docs/** mkdocs.yml

package/README.md

@@ -0,0 +1,54 @@
+# Motin Doc CLI
+
+A CLI tool to scaffold standardized documentation structure for Motin projects, ready for AI completion.
+
+## Features
+
+- 🚀 Initializes `.docs/` directory with standardized structure.
+- 🔧 Supports multiple stacks (Nuxt, Node, Python, etc.).
+- 🤖 Embeds AI-friendly context and instructions in Markdown comments.
+- 📦 Optional GitHub Workflow for automated AI documentation updates.
+
+## Installation & Usage (Local Development)
+
+1.  Clone the repository.
+2.  Install dependencies:
+    ```bash
+    npm install
+    ```
+3.  Link the package globally:
+    ```bash
+    npm link
+    ```
+4.  Navigate to your target project folder:
+    ```bash
+    cd ../my-project
+    ```
+5.  Run the initialization command:
+    ```bash
+    init-doc
+    ```
+
+## Publishing to NPM
+
+1.  Login to NPM:
+    ```bash
+    npm login
+    ```
+2.  Publish the package:
+    ```bash
+    npm publish
+    ```
+    *Note: Ensure the `name` in `package.json` is unique on NPM or scoped (e.g., `@motin/doc-cli`).*
+
+## Generated Structure
+
+```
+my-project/
+├── .docs/
+│   ├── index.md        # Entry point with AI context
+│   └── components.md   # Stack-specific (e.g., for Nuxt)
+└── .github/
+    └── workflows/
+        └── ai-doc-sync.yml # (Optional) Workflow file
+```

package/index.js

@@ -0,0 +1,382 @@
+#!/usr/bin/env node
+
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+async function init() {
+    console.log(chalk.green.bold('Welcome to the Motin Documentation Initializer! 🚀'));
+
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'projectName',
+            message: 'What is the name of your project?',
+            default: path.basename(process.cwd()),
+        },
+        {
+            type: 'list',
+            name: 'stack',
+            message: 'Which technical stack are you using?',
+            choices: [
+                new inquirer.Separator('--- JavaScript/TypeScript ---'),
+                'Nuxt', 'Next.js', 'Vue', 'React', 'Angular', 'Svelte', 'Node (Express/NestJS)',
+                new inquirer.Separator('--- PHP ---'),
+                'Laravel', 'Symfony', 'Generic PHP',
+                new inquirer.Separator('--- Python ---'),
+                'Django', 'FastAPI', 'Flask', 'Generic Python',
+                new inquirer.Separator('--- Other ---'),
+                'Java (Spring)', 'Ruby (Rails)', 'Go', 'Rust', 'Other'
+            ],
+        },
+        {
+            type: 'confirm',
+            name: 'includeWorkflow',
+            message: 'Do you want to include a GitHub Workflow for AI doc completion?',
+            default: true,
+        },
+    ]);
+
+    const docsDir = path.join(process.cwd(), '.docs');
+    const referenceDir = path.join(docsDir, 'reference');
+
+    try {
+        const relativeDocsDir = path.relative(process.cwd(), docsDir);
+        console.log(chalk.blue(`\nCreating documentation directory at ./${relativeDocsDir}...`));
+        await fs.ensureDir(docsDir);
+        await fs.ensureDir(referenceDir);
+
+        // 1. Create Standard Files
+        // ------------------------
+
+        // index.md
+        const indexContent = `<!-- 
+  AI_DOC_START
+  CONTEXT: This is the entry point for the project documentation.
+  INSTRUCTION: Analyze the project structure and update the "Overview" section.
+-->
+# ${answers.projectName} Documentation
+
+## Overview
+<!-- AI_CONTENT_START -->
+Documentation initialized.
+<!-- AI_CONTENT_END -->
+
+## Quick Links
+- [Getting Started](./getting-started.md)
+- [Architecture](./architecture.md)
+`;
+        await fs.writeFile(path.join(docsDir, 'index.md'), indexContent);
+
+        // getting-started.md
+        const gettingStartedContent = `# Getting Started
+
+<!-- 
+  INSTRUCTION: Document the installation and setup steps.
+-->
+
+## Prerequisites
+<!-- AI_CONTENT_START -->
+<!-- AI_CONTENT_END -->
+
+## Installation
+<!-- AI_CONTENT_START -->
+<!-- AI_CONTENT_END -->
+`;
+        await fs.writeFile(path.join(docsDir, 'getting-started.md'), gettingStartedContent);
+
+        // architecture.md
+        const architectureContent = `# Architecture
+
+<!-- 
+  INSTRUCTION: Document the high-level system architecture, data flow, and key design decisions.
+-->
+
+## specificities
+<!-- AI_CONTENT_START -->
+<!-- AI_CONTENT_END -->
+`;
+        await fs.writeFile(path.join(docsDir, 'architecture.md'), architectureContent);
+
+        // 2. Create Stack Specific Files (Granular)
+        // ----------------------------------------
+        const stackConfig = getStackConfig(answers.stack);
+
+        // Generate each reference file defined in the config
+        for (const [filename, contentGenerator] of Object.entries(stackConfig.files)) {
+            await fs.writeFile(path.join(referenceDir, filename), contentGenerator());
+        }
+
+        console.log(chalk.green('✔ Standard documentation files created'));
+        console.log(chalk.green(`✔ ${Object.keys(stackConfig.files).length} reference doc(s) created`));
+
+        // 3. Create MkDocs Config
+        // -----------------------
+
+        // Construct navigation for Reference section
+        const referenceNav = Object.keys(stackConfig.files).map(filename => {
+            // Convert 'controllers.md' -> 'Controllers'
+            const title = filename.replace('.md', '').charAt(0).toUpperCase() + filename.replace('.md', '').slice(1);
+            return `    - ${title}: reference/${filename}`;
+        }).join('\n');
+
+        const mkdocsContent = `site_name: ${answers.projectName} Documentation
+docs_dir: .docs
+theme: readthedocs
+
+nav:
+  - Home: index.md
+  - Getting Started: getting-started.md
+  - Architecture: architecture.md
+  - Reference:
+${referenceNav}
+`;
+        await fs.writeFile(path.join(process.cwd(), 'mkdocs.yml'), mkdocsContent);
+        console.log(chalk.green('✔ mkdocs.yml created'));
+
+        // 4. Create GitHub Workflow & AI Script
+        // -------------------------
+        if (answers.includeWorkflow) {
+            const workflowDir = path.join(process.cwd(), '.github', 'workflows');
+            const scriptsDir = path.join(process.cwd(), '.github', 'scripts');
+            await fs.ensureDir(workflowDir);
+            await fs.ensureDir(scriptsDir);
+
+            // Workflow File
+            const workflowContent = `name: AI Doc Sync
+
+on:
+  push:
+    paths-ignore:
+      - '.docs/**'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  doc-completion:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 2
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+
+      - name: Install Dependencies
+        run: npm install @google/genai
+
+      - name: Run AI Doc Sync
+        env:
+          GEMINI_API_KEY: \${{ secrets.GEMINI_API_KEY }}
+        run: node .github/scripts/doc-sync.mjs
+
+      - name: Commit Changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "docs: auto-generated documentation updates"
+          file_pattern: .docs/** mkdocs.yml
+`;
+            await fs.writeFile(path.join(workflowDir, 'ai-doc-sync.yml'), workflowContent);
+            console.log(chalk.green('✔ .github/workflows/ai-doc-sync.yml created'));
+
+            // AI Sync Script
+            const scriptContent = `import { GoogleGenAI } from "@google/genai";
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+
+const genAI = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
+
+async function main() {
+  console.log("Starting AI Doc Sync...");
+
+  // 1. Detect Changed Files
+  let changedFiles = [];
+  try {
+    const output = execSync('git diff --name-only HEAD~1 HEAD').toString();
+    changedFiles = output.split('\\n').filter(f => f && !f.startsWith('.docs') && !f.startsWith('.github'));
+  } catch (e) {
+    console.error("Failed to detect changes:", e.message);
+    return;
+  }
+
+  if (changedFiles.length === 0) {
+    console.log("No relevant code changes detected.");
+    return;
+  }
+
+  console.log("Processing changed files:", changedFiles);
+
+  // 2. Prepare Context for Gemini
+  let context = "";
+  for (const file of changedFiles) {
+    if (fs.existsSync(file)) {
+      context += \`\\n--- File: \${file} ---\\n\`;
+      context += fs.readFileSync(file, 'utf-8').slice(0, 10000); // Limit size
+    }
+  }
+
+  // 3. Prompt Gemini
+  const model = genAI.getGenerativeModel({ model: "gemini-2.5-flash" });
+  
+  const prompt = \`
+    You are a technical documentation assistant. 
+    Analyze the following code changes and update the documentation in the .docs/ directory.
+    
+    Rules:
+    1. Output MUST be a valid JSON object where keys are file paths (relative to .docs/, e.g., "reference/controllers.md") and values are the NEW content of that file.
+    2. You can create new files if necessary. 
+    3. You can update existing files (e.g., getting-started.md, architecture.md).
+    4. Focus on accuracy and clarity.
+    5. Do not include markdown code fence blocks in your response, just the raw JSON string.
+
+    Code Context:
+    \${context}
+  \`;
+
+  try {
+    const result = await model.generateContent(prompt);
+    const text = result.response.text();
+    
+    // Simple cleanup if model adds code blocks
+    const jsonStr = text.replace(/\\\`\\\`\\\`json/g, '').replace(/\\\`\\\`\\\`/g, '').trim();
+    const updates = JSON.parse(jsonStr);
+
+    // 4. Write Updates
+    for (const [relativePath, content] of Object.entries(updates)) {
+      const fullPath = path.join(process.cwd(), '.docs', relativePath);
+      const dir = path.dirname(fullPath);
+      
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+      
+      fs.writeFileSync(fullPath, content);
+      console.log(\`Updated: .docs/\${relativePath}\`);
+    }
+
+  } catch (error) {
+    console.error("AI Generation failed:", error);
+    process.exit(1);
+  }
+}
+
+main();`;
+            await fs.writeFile(path.join(scriptsDir, 'doc-sync.mjs'), scriptContent);
+            console.log(chalk.green('✔ .github/scripts/doc-sync.mjs created'));
+        }
+
+        console.log(chalk.green.bold('\nDocumentation scaffolding complete! 🎉'));
+        console.log(chalk.yellow('Next steps:'));
+        console.log(`1. Review the generated files in ./${relativeDocsDir}`);
+        console.log('2. Run "mkdocs serve" to preview your documentation');
+        console.log('3. Commit the changes');
+
+    } catch (err) {
+        console.error(chalk.red('Error creating documentation files:'), err);
+    }
+}
+
+// Config Factory
+function getStackConfig(stack) {
+    const commonHeader = (type) => `<!-- 
+  AI_DOC_START
+  STACK: ${stack}
+  TYPE: ${type}
+-->\n`;
+
+    // --- PHP: Symfony ---
+    if (stack.includes('Symfony')) {
+        return {
+            files: {
+                'controllers.md': () => `${commonHeader('Controllers')}# Controllers\n\n<!-- INSTRUCTION: Document all Symfony Controllers found in /src/Controller -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'entities.md': () => `${commonHeader('Entities')}# Entities\n\n<!-- INSTRUCTION: Document all Doctrine Entities found in /src/Entity -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'services.md': () => `${commonHeader('Services')}# Services\n\n<!-- INSTRUCTION: Document core application services found in /src/Service -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+            }
+        };
+    }
+
+    // --- PHP: Laravel ---
+    if (stack.includes('Laravel')) {
+        return {
+            files: {
+                'controllers.md': () => `${commonHeader('Controllers')}# Controllers\n\n<!-- INSTRUCTION: Document Http Controllers found in /app/Http/Controllers -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'models.md': () => `${commonHeader('Models')}# Models\n\n<!-- INSTRUCTION: Document Eloquent Models found in /app/Models -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'routes.md': () => `${commonHeader('Routes')}# Routes\n\n<!-- INSTRUCTION: Document application routes found in /routes -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+            }
+        };
+    }
+
+    // --- JS: Nuxt ---
+    if (stack.includes('Nuxt')) {
+        return {
+            files: {
+                'components.md': () => `${commonHeader('Components')}# Components\n\n<!-- INSTRUCTION: Document Vue components in /components -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'composables.md': () => `${commonHeader('Composables')}# Composables\n\n<!-- INSTRUCTION: Document auto-imported composables in /composables -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'server-routes.md': () => `${commonHeader('Server Routes')}# Server Routes\n\n<!-- INSTRUCTION: Document Nitro server routes in /server/api -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+            }
+        };
+    }
+
+    // --- JS: General (React, Next, Vue) ---
+    if (stack.includes('React') || stack.includes('Next') || stack.includes('Vue') || stack.includes('Angular') || stack.includes('Svelte')) {
+        return {
+            files: {
+                'components.md': () => `${commonHeader('Components')}# Components\n\n<!-- INSTRUCTION: Document UI components -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'hooks.md': () => `${commonHeader('Hooks')}# Hooks\n\n<!-- INSTRUCTION: Document custom hooks/composables -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'api.md': () => `${commonHeader('API')}# API Integration\n\n<!-- INSTRUCTION: Document API clients or fetch wrappers -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+            }
+        };
+    }
+
+    // --- Python: Django ---
+    if (stack.includes('Django')) {
+        return {
+            files: {
+                'models.md': () => `${commonHeader('Models')}# Models\n\n<!-- INSTRUCTION: Document Django Models -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'views.md': () => `${commonHeader('Views')}# Views\n\n<!-- INSTRUCTION: Document Django Views/ViewSets -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'admin.md': () => `${commonHeader('Admin')}# Admin Customization\n\n<!-- INSTRUCTION: Document Admin classes -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+            }
+        };
+    }
+
+    // --- Python: FastAPI ---
+    if (stack.includes('FastAPI')) {
+        return {
+            files: {
+                'endpoints.md': () => `${commonHeader('Endpoints')}# Endpoints\n\n<!-- INSTRUCTION: Document FastAPI routes and decorators -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'models.md': () => `${commonHeader('Models')}# Pydantic Models\n\n<!-- INSTRUCTION: Document Pydantic models -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+            }
+        };
+    }
+
+    // --- Java/Spring ---
+    if (stack.includes('Spring') || stack.includes('Java')) {
+        return {
+            files: {
+                'controllers.md': () => `${commonHeader('Controllers')}# Controllers\n\n<!-- INSTRUCTION: Document REST Controllers -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'services.md': () => `${commonHeader('Services')}# Services\n\n<!-- INSTRUCTION: Document Service beans -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+                'domain.md': () => `${commonHeader('Domain')}# Domain Models\n\n<!-- INSTRUCTION: Document Entity classes -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+            }
+        };
+    }
+
+    // --- Default Fallback ---
+    return {
+        files: {
+            'api.md': () => `${commonHeader('API')}# API Reference\n\n<!-- INSTRUCTION: Document public API endpoints -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+            'modules.md': () => `${commonHeader('Modules')}# Core Modules\n\n<!-- INSTRUCTION: Document core logical modules -->\n\n## List\n<!-- AI_CONTENT_START -->\n<!-- AI_CONTENT_END -->`,
+        }
+    };
+}
+
+init();

package/mkdocs.yml

@@ -0,0 +1,12 @@
+site_name: test Documentation
+docs_dir: .docs
+theme: readthedocs
+
+nav:
+  - Home: index.md
+  - Getting Started: getting-started.md
+  - Architecture: architecture.md
+  - Reference:
+    - Components: reference/components.md
+    - Composables: reference/composables.md
+    - Server-routes: reference/server-routes.md

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "scaffold-doc-cli",
+  "version": "1.0.0",
+  "description": "CLI tool to scaffold standardized documentation structure for projects.",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "init-doc": "./index.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cli",
+    "documentation",
+    "scaffolding",
+    "ai"
+  ],
+  "author": "mael50",
+  "license": "ISC",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.12"
+  }
+}