scaffold-doc-cli 1.0.5 → 1.0.7

package/index.js

@@ -220,11 +220,17 @@ async function main() {
   // 1. Detect Changed Files
   let changedFiles = [];
   try {
-    const output = execSync('git diff --name-only HEAD~1 HEAD').toString();
+    const output = execSync('git diff --name-only HEAD~1 HEAD 2>/dev/null').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;
+    console.warn("HEAD~1 not found (likely first commit). Syncing all tracked files...");
+    try {
+      const output = execSync('git ls-tree -r HEAD --name-only').toString();
+      changedFiles = output.split('\\n').filter(f => f && !f.startsWith('.docs') && !f.startsWith('.github'));
+    } catch (err) {
+      console.error("Failed to list files:", err.message);
+      return;
+    }
   }
 
   if (changedFiles.length === 0) {
@@ -244,8 +250,10 @@ async function main() {
   }
 
   // 3. Prompt Gemini
-  const model = genAI.getGenerativeModel({ model: "gemini-2.5-flash" });
-  
+  // 3. Prompt Gemini (using @google/genai SDK)
+  // No need to get model instance first in this SDK version based on user snippet
+
+
   const prompt = \`
     You are a technical documentation assistant. 
     Analyze the following code changes and update the documentation in the .docs/ directory.
@@ -262,9 +270,12 @@ async function main() {
   \`;
 
   try {
-    const result = await model.generateContent(prompt);
-    const text = result.response.text();
-    
+    const result = await genAI.models.generateContent({
+      model: "gemini-2.5-flash",
+      contents: prompt
+    });
+    const text = result.text;
+
     // Simple cleanup if model adds code blocks
     const jsonStr = text.replace(/\\\`\\\`\\\`json/g, '').replace(/\\\`\\\`\\\`/g, '').trim();
     const updates = JSON.parse(jsonStr);
@@ -273,11 +284,11 @@ async function main() {
     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}\`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scaffold-doc-cli",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "CLI tool to scaffold standardized documentation structure for projects.",
   "main": "index.js",
   "type": "module",

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

@@ -1,88 +0,0 @@
-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.warn("Could not compare with HEAD~1 (likely first commit or shallow fetch). Falling back to listing all files.");
-    try {
-      const output = execSync('git ls-tree -r --name-only HEAD').toString();
-      changedFiles = output.split('\n').filter(f => f && !f.startsWith('.docs') && !f.startsWith('.github'));
-    } catch (fallbackError) {
-      console.error("Failed to list files:", fallbackError.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

@@ -1,47 +0,0 @@
-name: AI Doc Sync
-
-on:
-  push:
-    paths-ignore:
-      - '.docs/**'
-  workflow_dispatch:
-
-permissions:
-  contents: write
-  pull-requests: 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: '22'
-
-      - name: Install Dependencies
-        run: npm install @google/genai --no-save
-
-      - name: Run AI Doc Sync
-        env:
-          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
-        run: node .github/scripts/doc-sync.mjs
-
-      - name: Create Pull Request
-        uses: peter-evans/create-pull-request@v5
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          commit-message: "docs: auto-generated documentation updates"
-          title: "docs: AI-generated documentation updates"
-          body: |
-            Automatic documentation updates generated by AI based on recent code changes.
-            
-            Please review and merge if accurate.
-          branch: ai-docs/${{ github.ref_name }}
-          base: ${{ github.head_ref || github.ref_name }}
-          delete-branch: true
-          add-paths: .docs

package/mkdocs.yml

@@ -1,12 +0,0 @@
-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