@aigne/doc-smith 0.9.6-beta.2 → 0.9.7-beta

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.9.7-beta](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.9.6...v0.9.7-beta) (2025-11-25)
+
+
+### Bug Fixes
+
+* documentExecutionStructure might be an object ([#332](https://github.com/AIGNE-io/aigne-doc-smith/issues/332)) ([337b350](https://github.com/AIGNE-io/aigne-doc-smith/commit/337b350d5fa045edb7b2db84f0892151aa8518ab))
+* update default exclusion patterns, keeping only the necessary items ([#334](https://github.com/AIGNE-io/aigne-doc-smith/issues/334)) ([f1431cf](https://github.com/AIGNE-io/aigne-doc-smith/commit/f1431cf3d600c77c05c8e346712f79aa689ffe27))
+
+## [0.9.6](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.9.6-beta.2...v0.9.6) (2025-11-21)
+
 ## [0.9.6-beta.2](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.9.6-beta.1...v0.9.6-beta.2) (2025-11-20)
 
 

package/agents/clear/clear-generated-docs.mjs

@@ -29,12 +29,12 @@ export default async function clearGeneratedDocs(input = {}, options = {}) {
       };
     }
 
-    const documentExecutionStructure = (await loadDocumentStructure(outputDir)) || [];
+    const documentStructure = (await loadDocumentStructure(outputDir)) || [];
     // select documents interactively
     const chooseResult = await chooseDocs(
       {
         docs: [], // Empty to trigger interactive selection
-        documentExecutionStructure,
+        documentStructure,
         docsDir: generatedDocsPath,
         locale: locale || "en",
         isTranslate: false,

package/agents/create/index.yaml

@@ -25,23 +25,6 @@ skills:
       fileName: structure-plan.json
   - ../utils/save-sidebar.mjs
   - ../utils/ensure-document-icons.mjs
-  - type: transform
-    name: transformData
-    task_render_mode: hide
-    jsonata: |
-      $merge([
-        $,
-        {
-          'documentExecutionStructure': $map(documentStructure, function($item) {
-            $merge([
-              $item,
-              {
-                'translates': [$map(translateLanguages, function($lang) { {"language": $lang} })]
-              }
-            ])
-          })
-        }
-      ])
   - ../utils/format-document-structure.mjs
   - ../media/load-media-description.mjs
   - ../update/batch-generate-document.yaml

package/agents/create/user-add-document/add-documents-to-structure.mjs

@@ -1,9 +1,8 @@
 import { getActiveRulesForScope } from "../../../utils/preferences-utils.mjs";
 import { printDocumentStructure } from "../../../utils/docs-finder-utils.mjs";
-import addTranslatesToStructure from "../../utils/add-translates-to-structure.mjs";
 
 export default async function addDocumentsToStructure(input = {}, options = {}) {
-  const { originalDocumentStructure = [], translateLanguages = [] } = input;
+  const { originalDocumentStructure = [] } = input;
   const analyzeIntent = options.context?.agents?.["analyzeStructureFeedbackIntent"];
   const updateDocumentStructure = options.context?.agents?.["updateDocumentStructure"];
   const allFeedback = [];
@@ -76,16 +75,11 @@ export default async function addDocumentsToStructure(input = {}, options = {})
 
   if (currentStructure.length > originalDocumentStructure.length) {
     const originalPaths = new Set(originalDocumentStructure.map((doc) => doc.path));
-    const { documentExecutionStructure } = addTranslatesToStructure({
-      originalDocumentStructure: currentStructure,
-      translateLanguages,
-    });
-    const newDocuments = documentExecutionStructure.filter((doc) => !originalPaths.has(doc.path));
+    const newDocuments = currentStructure.filter((doc) => !originalPaths.has(doc.path));
 
     return {
       originalDocumentStructure: currentStructure,
       documentStructure: JSON.parse(JSON.stringify(currentStructure)),
-      documentExecutionStructure,
       newDocuments,
       allFeedback,
     };

package/agents/create/user-add-document/review-documents-with-new-links.mjs

@@ -8,7 +8,7 @@ import { pathExists } from "../../../utils/file-utils.mjs";
  * Review documentsWithNewLinks and let user select which documents should be updated
  */
 export default async function reviewDocumentsWithNewLinks(
-  { documentsWithNewLinks = [], documentExecutionStructure = [], locale = "en", docsDir },
+  { documentsWithNewLinks = [], documentStructure = [], locale = "en", docsDir },
   options,
 ) {
   // If no documents to review, return empty array
@@ -22,7 +22,7 @@ export default async function reviewDocumentsWithNewLinks(
     documentsWithNewLinks.map((document, index) =>
       limit(async () => {
         // Find corresponding document in documentStructure to get title
-        const structureDoc = documentExecutionStructure.find((item) => item.path === document.path);
+        const structureDoc = documentStructure.find((item) => item.path === document.path);
         const title = structureDoc?.title || document.path;
 
         // Generate filename from document path
@@ -86,7 +86,7 @@ export default async function reviewDocumentsWithNewLinks(
     if (!doc.path) continue;
 
     // Find corresponding document in documentStructure to get additional fields
-    const structureDoc = documentExecutionStructure.find((item) => item.path === doc.path);
+    const structureDoc = documentStructure.find((item) => item.path === doc.path);
 
     // Generate feedback message for adding new links
     const newLinksList = doc.newLinks.join(", ");

package/agents/create/user-remove-document/index.yaml

@@ -15,7 +15,6 @@ skills:
       fileName: structure-plan.json
   - ../../utils/save-sidebar.mjs
   - ./find-documents-with-invalid-links.mjs
-  - ../../utils/add-translates-to-structure.mjs
   - ./review-documents-with-invalid-links.mjs
   - ../../utils/format-document-structure.mjs
   - ../../media/load-media-description.mjs

package/agents/create/user-remove-document/review-documents-with-invalid-links.mjs

@@ -7,11 +7,11 @@ import {
 /**
  * Generate feedback message for fixing invalid links in a document
  */
-function generateInvalidLinksFeedback(invalidLinks, documentPath, documentExecutionStructure) {
+function generateInvalidLinksFeedback(invalidLinks, documentPath, documentStructure) {
   const invalidLinksList = invalidLinks.map((link) => `- ${link}`).join("\n");
 
   // Build allowed links from document structure for replacement suggestions
-  const allowedLinks = buildAllowedLinksFromStructure(documentExecutionStructure);
+  const allowedLinks = buildAllowedLinksFromStructure(documentStructure);
   const allowedLinksArray = Array.from(allowedLinks)
     .filter((link) => link !== documentPath) // Exclude current document path
     .sort();
@@ -48,7 +48,7 @@ ${allowedLinksList}
 }
 
 export default async function reviewDocumentsWithInvalidLinks(input = {}, options = {}) {
-  const { documentsWithInvalidLinks = [], documentExecutionStructure = [], locale = "en" } = input;
+  const { documentsWithInvalidLinks = [], documentStructure = [], locale = "en" } = input;
 
   // If no documents with invalid links, return empty array
   if (!Array.isArray(documentsWithInvalidLinks) || documentsWithInvalidLinks.length === 0) {
@@ -96,14 +96,10 @@ export default async function reviewDocumentsWithInvalidLinks(input = {}, option
     if (!doc.path) continue;
 
     // Find corresponding document in documentStructure to get additional fields
-    const structureDoc = documentExecutionStructure.find((item) => item.path === doc.path);
+    const structureDoc = documentStructure.find((item) => item.path === doc.path);
 
     // Generate feedback message for fixing invalid links
-    const feedback = generateInvalidLinksFeedback(
-      doc.invalidLinks,
-      doc.path,
-      documentExecutionStructure,
-    );
+    const feedback = generateInvalidLinksFeedback(doc.invalidLinks, doc.path, documentStructure);
 
     preparedDocs.push({
       ...structureDoc,

package/agents/init/check.mjs

@@ -1,8 +1,8 @@
 import chalk from "chalk";
 import { getMainLanguageFiles } from "../../utils/docs-finder-utils.mjs";
 
-export default async function checkNeedGenerate({ docsDir, locale, documentExecutionStructure }) {
-  const mainLanguageFiles = await getMainLanguageFiles(docsDir, locale, documentExecutionStructure);
+export default async function checkNeedGenerate({ docsDir, locale, documentStructure }) {
+  const mainLanguageFiles = await getMainLanguageFiles(docsDir, locale, documentStructure);
 
   if (mainLanguageFiles.length === 0) {
     console.log(

package/agents/init/index.mjs

@@ -48,7 +48,14 @@ export default async function init(input, options) {
     options,
   )?.reasoningEffort;
 
-  return config;
+  // for translation agent
+  if (config.translateLanguages) {
+    config.translates = config.translateLanguages.map((lang) => ({ language: lang }));
+  }
+
+  return {
+    ...config,
+  };
 }
 
 async function _init(
@@ -284,7 +291,9 @@ async function _init(
     `  1. Use paths like ${chalk.green("./src")}, ${chalk.green("./README.md")} or ${chalk.green("!./src/private")}.`,
   );
   console.log(
-    `  2. Use globs like ${chalk.green("src/**/*.js")} or ${chalk.green("!private/**/*.js")} for more specific file matching.`,
+    `  2. Use globs like ${chalk.green("src/**/*.js")} or ${chalk.green(
+      "!private/**/*.js",
+    )} for more specific file matching.`,
   );
   console.log(`  3. Use URLs like ${chalk.green("https://example.com/openapi.yaml")}.`);
   console.log("💡 If you leave this empty, we will scan the entire directory.");
@@ -601,7 +610,7 @@ ${modelSection}
 
   // Directory and source path configurations - safely serialize
   const docsDirSection = yamlStringify({ docsDir: config.docsDir }).trim();
-  yaml += `${docsDirSection.replace(/^docsDir:/, "docsDir:")}  # The directory where the generated documentation will be saved.\n`;
+  yaml += `${docsDirSection}  # The directory where the generated documentation will be saved.\n`;
 
   const sourcesPathSection = yamlStringify({ sourcesPath: config.sourcesPath }).trim();
   yaml += `${sourcesPathSection.replace(/^sourcesPath:/, "sourcesPath:  # The source code paths to analyze.")}\n`;

package/agents/localize/choose-language.mjs

@@ -76,16 +76,13 @@ export default async function chooseLanguage({ langs, locale, selectedDocs }, op
     await saveValueToConfig("translateLanguages", updatedTranslateLanguages);
   }
 
-  const newSelectedDocs = selectedDocs.map((doc) => {
-    return {
-      ...doc,
-      translates: selectedLanguages.map((lang) => ({ language: lang })),
-    };
-  });
+  // Convert selectedLanguages to translates format
+  const translates = selectedLanguages.map((lang) => ({ language: lang }));
 
   return {
     selectedLanguages,
-    selectedDocs: newSelectedDocs,
+    selectedDocs,
+    translates,
   };
 }
 

package/agents/localize/index.yaml

@@ -16,15 +16,7 @@ skills:
       $merge([
         $,
         {
-          'documentStructure': originalDocumentStructure,
-          'documentExecutionStructure': $map(originalDocumentStructure, function($item) {
-            $merge([
-              $item,
-              {
-                'translates': [$map(translateLanguages, function($lang) { {"language": $lang} })]
-              }
-            ])
-          })
+          'documentStructure': originalDocumentStructure
         }
       ])
   - url: ../utils/choose-docs.mjs

package/agents/update/batch-generate-document.yaml

@@ -9,11 +9,19 @@ input_schema:
     detailDataSource:
       type: string
       description: Context for documentation structure generation, used to assist generate documentation structure
-    documentExecutionStructure: ../schema/document-execution-structure.yaml
+    documentStructure: ../schema/document-structure.yaml
+    translates:
+      type: array
+      items:
+        type: object
+        properties:
+          language:
+            type: string
+      description: List of languages to translate documents to
     modifiedFiles:
       type: array
       items: { type: string }
       description: Array of modified files since last generation
-iterate_on: documentExecutionStructure
+iterate_on: documentStructure
 concurrency: 5
 mode: sequential

package/agents/update/check-document.mjs

@@ -21,7 +21,7 @@ export default async function checkDocument(
     modifiedFiles,
     forceRegenerate,
     locale,
-    translates,
+    translates = [],
     ...rest
   },
   options,

package/agents/update/index.yaml

@@ -16,15 +16,7 @@ skills:
       $merge([
         $,
         {
-          'documentStructure': originalDocumentStructure,
-          'documentExecutionStructure': $map(originalDocumentStructure, function($item) {
-            $merge([
-              $item,
-              {
-                'translates': [$map(translateLanguages, function($lang) { {"language": $lang} })]
-              }
-            ])
-          })
+          'documentStructure': originalDocumentStructure
         }
       ])
   - url: ../utils/choose-docs.mjs

package/agents/update/save-and-translate-document.mjs

@@ -61,7 +61,6 @@ export default async function saveAndTranslateDocument(input, options) {
         await options.context.invoke(translateAgent, {
           ...input, // context is required
           content: doc.content,
-          translates: doc.translates,
           title: doc.title,
           path: doc.path,
           docsDir,

package/agents/utils/choose-docs.mjs

@@ -18,7 +18,7 @@ function getFeedbackMessage(action) {
 export default async function chooseDocs(
   {
     docs,
-    documentExecutionStructure,
+    documentStructure,
     boardId,
     docsDir,
     isTranslate,
@@ -38,11 +38,7 @@ export default async function chooseDocs(
   if (!docs || docs.length === 0) {
     try {
       // Get all main language .md files in docsDir
-      const mainLanguageFiles = await getMainLanguageFiles(
-        docsDir,
-        locale,
-        documentExecutionStructure,
-      );
+      const mainLanguageFiles = await getMainLanguageFiles(docsDir, locale, documentStructure);
 
       if (mainLanguageFiles.length === 0) {
         throw new Error(
@@ -56,7 +52,7 @@ export default async function chooseDocs(
       const choices = mainLanguageFiles.map((file) => {
         // Convert filename to flat path to find corresponding documentation structure item
         const flatName = file.replace(/\.md$/, "").replace(/\.\w+(-\w+)?$/, "");
-        const docItem = documentExecutionStructure.find((item) => {
+        const docItem = documentStructure.find((item) => {
           const itemFlattenedPath = item.path.replace(/^\//, "").replace(/\//g, "-");
           return itemFlattenedPath === flatName;
         });
@@ -96,7 +92,7 @@ export default async function chooseDocs(
       }
 
       // Process selected files and convert to found items
-      foundItems = await processSelectedFiles(selectedFiles, documentExecutionStructure, docsDir);
+      foundItems = await processSelectedFiles(selectedFiles, documentStructure, docsDir);
     } catch (error) {
       console.log(
         getActionText(`\nFailed to select documents to {action}: ${error.message}`, docAction),
@@ -106,16 +102,10 @@ export default async function chooseDocs(
   } else {
     // Process the provided docs array
     for (const docPath of docs) {
-      const foundItem = await findItemByPath(
-        documentExecutionStructure,
-        docPath,
-        boardId,
-        docsDir,
-        locale,
-      );
+      const foundItem = await findItemByPath(documentStructure, docPath, boardId, docsDir, locale);
 
       if (!foundItem) {
-        console.warn(`⚠️  Item with path "${docPath}" not found in documentExecutionStructure`);
+        console.warn(`⚠️  Item with path "${docPath}" not found in documentStructure`);
         continue;
       }
 
@@ -125,9 +115,7 @@ export default async function chooseDocs(
     }
 
     if (foundItems.length === 0) {
-      throw new Error(
-        "None of the specified document paths were found in documentExecutionStructure",
-      );
+      throw new Error("None of the specified document paths were found in documentStructure");
     }
   }
 

package/agents/utils/find-item-by-path.mjs

@@ -9,7 +9,7 @@ import {
 } from "../../utils/docs-finder-utils.mjs";
 
 export default async function findItemByPath(
-  { doc, documentExecutionStructure, boardId, docsDir, isTranslate, feedback, locale },
+  { doc, documentStructure, boardId, docsDir, isTranslate, feedback, locale },
   options,
 ) {
   let foundItem = null;
@@ -21,11 +21,7 @@ export default async function findItemByPath(
   if (!docPath) {
     try {
       // Get all main language .md files in docsDir
-      const mainLanguageFiles = await getMainLanguageFiles(
-        docsDir,
-        locale,
-        documentExecutionStructure,
-      );
+      const mainLanguageFiles = await getMainLanguageFiles(docsDir, locale, documentStructure);
 
       if (mainLanguageFiles.length === 0) {
         throw new Error("No documents found in the docs directory");
@@ -65,7 +61,7 @@ export default async function findItemByPath(
       const flatName = fileNameToFlatPath(selectedFile);
 
       // Try to find matching item by comparing flattened paths
-      const foundItemByFile = findItemByFlatName(documentExecutionStructure, flatName);
+      const foundItemByFile = findItemByFlatName(documentStructure, flatName);
 
       if (!foundItemByFile) {
         throw new Error("No document found");
@@ -84,16 +80,10 @@ export default async function findItemByPath(
   }
 
   // Use the utility function to find item and read content
-  foundItem = await findItemByPathUtil(
-    documentExecutionStructure,
-    docPath,
-    boardId,
-    docsDir,
-    locale,
-  );
+  foundItem = await findItemByPathUtil(documentStructure, docPath, boardId, docsDir, locale);
 
   if (!foundItem) {
-    throw new Error(`Item with path "${docPath}" not found in documentExecutionStructure`);
+    throw new Error(`Item with path "${docPath}" not found in documentStructure`);
   }
 
   // Prompt for feedback if not provided

package/agents/utils/post-generate.mjs

@@ -11,7 +11,7 @@ import { getCurrentGitHead, saveGitHeadToConfig } from "../../utils/utils.mjs";
  * @returns {Promise<Array<{ path: string, success: boolean, error?: string }>>}
  */
 export default async function postGenerate({
-  documentExecutionStructure: documentStructure,
+  documentStructure,
   docsDir,
   translateLanguages = [],
   locale,

package/aigne.yaml

@@ -68,7 +68,6 @@ agents:
   - ./agents/clear/clear-media-description.mjs
 
   # Utilities
-  - ./agents/utils/add-translates-to-structure.mjs
   - ./agents/utils/load-sources.mjs
   - ./agents/utils/post-generate.mjs
   - ./agents/utils/save-sidebar.mjs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/doc-smith",
-  "version": "0.9.6-beta.2",
+  "version": "0.9.7-beta",
   "description": "AI-driven documentation generation tool built on the AIGNE Framework",
   "publishConfig": {
     "access": "public"

package/utils/constants/index.mjs

@@ -103,39 +103,26 @@ export const DEFAULT_INCLUDE_PATTERNS = [
 ];
 
 export const DEFAULT_EXCLUDE_PATTERNS = [
-  "**/aigne-docs/**",
   "**/doc-smith/**",
   "**/.aigne/**",
-  "**/data/**",
-  "**/public/**",
-  "**/static/**",
   "**/vendor/**",
   "**/temp/**",
-  "**/*docs/**",
-  "**/*doc/**",
   "**/*venv/**",
   "*.venv/**",
-  "*test*",
-  "**/*test/**",
-  "**/*tests/**",
-  "**/*examples/**",
-  "**/playgrounds/**",
-  "v1/**",
   "**/dist/**",
   "**/*build/**",
   "**/*experimental/**",
   "**/*deprecated/**",
-  "**/*misc/**",
-  "**/*legacy/**",
+  "**/misc/**",
+  "**/legacy/**",
   ".git/**",
   ".github/**",
   ".next/**",
   ".vscode/**",
-  "**/*obj/**",
-  "**/*bin/**",
+  "**/obj/**",
+  "**/bin/**",
   "**/*node_modules/**",
   "*.log",
-  "**/*test.*",
   "**/pnpm-lock.yaml",
   "**/yarn.lock",
   "**/package-lock.json",

package/utils/docs-finder-utils.mjs

@@ -36,20 +36,14 @@ export function generateFileName(flatName, locale) {
 
 /**
  * Find a single item by path in documentation structure result and read its content
- * @param {Array} documentExecutionStructure - Array of documentation structure items
+ * @param {Array} documentStructure - Array of documentation structure items
  * @param {string} docPath - Document path to find (supports .md filenames)
  * @param {string} boardId - Board ID for fallback matching
  * @param {string} docsDir - Docs directory path for reading content
  * @param {string} locale - Main language locale (e.g., 'en', 'zh', 'fr')
  * @returns {Promise<Object|null>} Found item with content or null
  */
-export async function findItemByPath(
-  documentExecutionStructure,
-  docPath,
-  boardId,
-  docsDir,
-  locale = "en",
-) {
+export async function findItemByPath(documentStructure, docPath, boardId, docsDir, locale = "en") {
   let foundItem = null;
   let fileName = null;
 
@@ -57,10 +51,10 @@ export async function findItemByPath(
   if (docPath.endsWith(".md")) {
     fileName = docPath;
     const flatName = fileNameToFlatPath(docPath);
-    foundItem = findItemByFlatName(documentExecutionStructure, flatName);
+    foundItem = findItemByFlatName(documentStructure, flatName);
   } else {
     // First try direct path matching
-    foundItem = documentExecutionStructure.find((item) => item.path === docPath);
+    foundItem = documentStructure.find((item) => item.path === docPath);
 
     // If not found and boardId is provided, try boardId-flattenedPath format matching
     if (!foundItem && boardId) {
@@ -70,7 +64,7 @@ export async function findItemByPath(
         const flattenedPath = docPath.substring(boardId.length + 1);
 
         // Find item by comparing flattened paths
-        foundItem = documentExecutionStructure.find((item) => {
+        foundItem = documentStructure.find((item) => {
           // Convert item.path to flattened format (replace / with -)
           const itemFlattenedPath = item.path.replace(/^\//, "").replace(/\//g, "-");
           return itemFlattenedPath === flattenedPath;
@@ -127,10 +121,10 @@ export async function readFileContent(docsDir, fileName) {
  * Get main language markdown files from docs directory
  * @param {string} docsDir - Docs directory path
  * @param {string} locale - Main language locale (e.g., 'en', 'zh', 'fr')
- * @param {Array} documentExecutionStructure - Array of documentation structure items to determine file order
- * @returns {Promise<string[]>} Array of main language .md files ordered by documentExecutionStructure
+ * @param {Array} documentStructure - Array of documentation structure items to determine file order
+ * @returns {Promise<string[]>} Array of main language .md files ordered by documentStructure
  */
-export async function getMainLanguageFiles(docsDir, locale, documentExecutionStructure = null) {
+export async function getMainLanguageFiles(docsDir, locale, documentStructure = null) {
   // Check if docsDir exists
   try {
     await access(docsDir);
@@ -162,17 +156,17 @@ export async function getMainLanguageFiles(docsDir, locale, documentExecutionStr
     }
   });
 
-  // If documentExecutionStructure is provided, sort files according to the order in documentExecutionStructure
-  if (documentExecutionStructure && Array.isArray(documentExecutionStructure)) {
+  // If documentStructure is provided, sort files according to the order in documentStructure
+  if (documentStructure && Array.isArray(documentStructure)) {
     // Create a map from flat file name to documentation structure order
     const orderMap = new Map();
-    documentExecutionStructure.forEach((item, index) => {
+    documentStructure.forEach((item, index) => {
       const itemFlattenedPath = item.path.replace(/^\//, "").replace(/\//g, "-");
       const expectedFileName = generateFileName(itemFlattenedPath, locale);
       orderMap.set(expectedFileName, index);
     });
 
-    // Sort filtered files based on their order in documentExecutionStructure
+    // Sort filtered files based on their order in documentStructure
     return filteredFiles.sort((a, b) => {
       const orderA = orderMap.get(a);
       const orderB = orderMap.get(b);
@@ -191,7 +185,7 @@ export async function getMainLanguageFiles(docsDir, locale, documentExecutionStr
     });
   }
 
-  // If no documentExecutionStructure provided, return files in alphabetical order
+  // If no documentStructure provided, return files in alphabetical order
   return filteredFiles.sort();
 }
 
@@ -212,12 +206,12 @@ export function fileNameToFlatPath(fileName) {
 
 /**
  * Find documentation structure item by flattened file name
- * @param {Array} documentExecutionStructure - Array of documentation structure items
+ * @param {Array} documentStructure - Array of documentation structure items
  * @param {string} flatName - Flattened file name
  * @returns {Object|null} Found item or null
  */
-export function findItemByFlatName(documentExecutionStructure, flatName) {
-  return documentExecutionStructure.find((item) => {
+export function findItemByFlatName(documentStructure, flatName) {
+  return documentStructure.find((item) => {
     const itemFlattenedPath = item.path.replace(/^\//, "").replace(/\//g, "-");
     return itemFlattenedPath === flatName;
   });
@@ -226,11 +220,11 @@ export function findItemByFlatName(documentExecutionStructure, flatName) {
 /**
  * Process selected files and convert to found items with content
  * @param {string[]} selectedFiles - Array of selected file names
- * @param {Array} documentExecutionStructure - Array of documentation structure items
+ * @param {Array} documentStructure - Array of documentation structure items
  * @param {string} docsDir - Docs directory path
  * @returns {Promise<Object[]>} Array of found items with content
  */
-export async function processSelectedFiles(selectedFiles, documentExecutionStructure, docsDir) {
+export async function processSelectedFiles(selectedFiles, documentStructure, docsDir) {
   const foundItems = [];
 
   for (const selectedFile of selectedFiles) {
@@ -241,7 +235,7 @@ export async function processSelectedFiles(selectedFiles, documentExecutionStruc
     const flatName = fileNameToFlatPath(selectedFile);
 
     // Try to find matching item by comparing flattened paths
-    const foundItemByFile = findItemByFlatName(documentExecutionStructure, flatName);
+    const foundItemByFile = findItemByFlatName(documentStructure, flatName);
 
     if (foundItemByFile) {
       const result = {

package/utils/file-utils.mjs

@@ -188,7 +188,7 @@ export async function getFilesWithGlob(dir, includePatterns, excludePatterns, gi
   }
 
   // Add default exclusions if not already present
-  const defaultExclusions = ["node_modules/**", "test/**", "temp/**"];
+  const defaultExclusions = ["node_modules/**", "temp/**"];
   for (const exclusion of defaultExclusions) {
     if (!allIgnorePatterns.includes(exclusion)) {
       allIgnorePatterns.push(exclusion);

package/agents/schema/document-execution-structure.yaml

@@ -1,32 +0,0 @@
-type: array
-items:
-  type: object
-  properties:
-    title:
-      type: string
-    description:
-      type: string
-    path:
-      type: string
-      description: Path in URL format, cannot be empty, must start with /, no need to include language level, e.g., /zh/about should return /about
-    parentId:
-      type:
-        - string
-        - "null"
-    translates:
-      type: array
-      items:
-        type: object
-        properties:
-          language:
-            type: string
-            description: Language code, such as zh, en, ja, etc.
-    sourceIds:
-      type: array
-      items:
-        type: string
-      description: Associated sourceId from `<data_sources>` for subsequent translation and content generation, must come from sourceId in `<data_sources>`, cannot have fake ids, cannot be empty
-  required:
-    - title
-    - description
-    - path

package/agents/utils/add-translates-to-structure.mjs

@@ -1,29 +0,0 @@
-export default function addTranslatesToStructure({
-  originalDocumentStructure = [],
-  translateLanguages = [],
-}) {
-  const documentExecutionStructure = (originalDocumentStructure || []).map((item) => ({
-    ...item,
-    translates: (translateLanguages || []).map((lang) => ({ language: lang })),
-  }));
-
-  return {
-    documentExecutionStructure,
-  };
-}
-
-addTranslatesToStructure.inputSchema = {
-  type: "object",
-  properties: {
-    originalDocumentStructure: { type: "array", items: { type: "object" } },
-    translateLanguages: { type: "array", items: { type: "string" } },
-  },
-  required: ["originalDocumentStructure", "translateLanguages"],
-};
-addTranslatesToStructure.outputSchema = {
-  type: "object",
-  properties: {
-    documentExecutionStructure: { type: "array" },
-  },
-};
-addTranslatesToStructure.task_render_mode = "hide";