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

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.9.7-beta.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.9.7-beta...v0.9.7-beta.1) (2025-11-27)
+
+
+### Bug Fixes
+
+* **ci:** ensure pipeline fails on test failures ([#328](https://github.com/AIGNE-io/aigne-doc-smith/issues/328)) ([56fb4d5](https://github.com/AIGNE-io/aigne-doc-smith/commit/56fb4d5259a21a6cf76f67c6ac5a43a7c1403b99))
+* supports admonition syntax ([#338](https://github.com/AIGNE-io/aigne-doc-smith/issues/338)) ([db19661](https://github.com/AIGNE-io/aigne-doc-smith/commit/db19661e1c2d654181d932e0834e7e011a3ad8a5))
+
+## [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/merge-diagram.yaml

@@ -36,5 +36,4 @@ output_schema:
       type: string
       description: Merged content of the document with D2 diagram
   required:
-    - content
-
+    - content

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,
@@ -87,7 +87,8 @@ export default async function checkDocument(
       contentValidationFailed = true;
     }
   }
-  const languages = translates.map((x) => x.language);
+  const translateList = Array.isArray(translates) ? translates : [];
+  const languages = translateList.map((x) => x.language);
   const lackLanguages = new Set(languages);
   const skills = [];
 
@@ -140,7 +141,7 @@ export default async function checkDocument(
 
   const result = await options.context.invoke(teamAgent, {
     ...rest,
-    translates: translates.filter((x) => lackLanguages.has(x.language)),
+    translates: translateList.filter((x) => lackLanguages.has(x.language)),
     locale,
     docsDir,
     path,

package/agents/update/check-generate-diagram.mjs

@@ -1,4 +1,4 @@
-import { DIAGRAM_PLACEHOLDER } from "../../utils/d2-utils.mjs";
+import { DIAGRAM_PLACEHOLDER, replacePlaceholderWithD2 } from "../../utils/d2-utils.mjs";
 
 const DEFAULT_DIAGRAMMING_EFFORT = 5;
 const MIN_DIAGRAMMING_EFFORT = 0;
@@ -68,7 +68,10 @@ export default async function checkGenerateDiagram(
 
     if (diagramSourceCode && !skipGenerateDiagram) {
       if (content.includes(DIAGRAM_PLACEHOLDER)) {
-        content = content.replace(DIAGRAM_PLACEHOLDER, diagramSourceCode);
+        content = replacePlaceholderWithD2({
+          content,
+          diagramSourceCode,
+        });
       } else {
         const mergeAgent = options.context?.agents?.["mergeDiagramToDocument"];
         ({ content } = await options.context.invoke(mergeAgent, {

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/update/update-single/update-single-document-detail.mjs

@@ -1,7 +1,11 @@
 import { AIAgent } from "@aigne/core";
 import { pick } from "@aigne/core/utils/type-utils.js";
 import z from "zod";
-import { DIAGRAM_PLACEHOLDER, replacePlaceholder } from "../../../utils/d2-utils.mjs";
+import {
+  DIAGRAM_PLACEHOLDER,
+  replaceD2WithPlaceholder,
+  replacePlaceholderWithD2,
+} from "../../../utils/d2-utils.mjs";
 import { userContextAt } from "../../../utils/utils.mjs";
 
 async function getIntentType(input, options) {
@@ -64,7 +68,7 @@ async function addDiagram(input, options) {
 async function updateDiagram(input, options) {
   const contentContext = userContextAt(options, `currentContents.${input.path}`);
   const currentContent = contentContext.get();
-  let [content, previousDiagramContent] = replacePlaceholder({
+  let [content, previousDiagramContent] = replaceD2WithPlaceholder({
     content: currentContent,
   });
   const generateAgent = options.context?.agents?.["generateDiagram"];
@@ -74,7 +78,10 @@ async function updateDiagram(input, options) {
     previousDiagramContent,
     feedback: input.feedback,
   });
-  content = content.replace(DIAGRAM_PLACEHOLDER, diagramSourceCode);
+  content = replacePlaceholderWithD2({
+    content,
+    diagramSourceCode,
+  });
   contentContext.set(content);
   await saveDoc(input, options, { content });
   return { content };
@@ -83,7 +90,7 @@ async function updateDiagram(input, options) {
 async function deleteDiagram(input, options) {
   const contentContext = userContextAt(options, `currentContents.${input.path}`);
   const currentContent = contentContext.get();
-  const [documentContent] = replacePlaceholder({
+  const [documentContent] = replaceD2WithPlaceholder({
     content: currentContent,
   });
   const instructions = `<role>

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",
+  "version": "0.9.7-beta.1",
   "description": "AI-driven documentation generation tool built on the AIGNE Framework",
   "publishConfig": {
     "access": "public"
@@ -24,10 +24,10 @@
   "author": "Arcblock <blocklet@arcblock.io> https://github.com/blocklet",
   "license": "Elastic-2.0",
   "dependencies": {
-    "@aigne/cli": "^1.54.1",
-    "@aigne/core": "^1.67.0",
-    "@aigne/publish-docs": "^0.13.1",
-    "@blocklet/payment-broker-client": "^1.22.12",
+    "@aigne/cli": "^1.56.0",
+    "@aigne/core": "^1.69.0",
+    "@aigne/publish-docs": "^0.14.1",
+    "@blocklet/payment-broker-client": "^1.22.24",
     "@terrastruct/d2": "^0.1.33",
     "chalk": "^5.5.0",
     "debug": "^4.4.1",
@@ -66,10 +66,12 @@
     "@biomejs/biome": "^2.2.4"
   },
   "scripts": {
-    "test": "bun test",
-    "test:coverage2": "bun test --coverage",
-    "test:coverage": "bun test --coverage --coverage-reporter=lcov --coverage-reporter=text",
-    "test:watch": "bun test --watch",
+    "test": "bun test --preload ./tests/setup/mock-process-exit.mjs",
+    "test:coverage2": "bun test --preload ./tests/setup/mock-process-exit.mjs --coverage",
+    "test:coverage": "bun test --preload ./tests/setup/mock-process-exit.mjs --coverage --coverage-reporter=lcov --coverage-reporter=text",
+    "test:deploy": "bun test --preload ./tests/setup/mock-process-exit.mjs tests/utils/deploy.test.mjs --coverage --coverage-reporter=text",
+    "test:user-review": "bun test --preload ./tests/setup/mock-process-exit.mjs tests/agents/update/user-review-document.test.mjs --coverage --coverage-reporter=lcov --coverage-reporter=text",
+    "test:watch": "bun test --preload ./tests/setup/mock-process-exit.mjs --watch",
     "lint": "biome lint && biome format",
     "update:deps": "npx -y taze major -r -w -f -n '/@abtnode|@aigne|@arcblock|@blocklet|@did-connect|@did-pay|@did-space|@nft-store|@nft-studio|@ocap/' && pnpm install && pnpm run deduplicate",
     "deduplicate": "pnpm dedupe",

package/prompts/common/document/markdown-syntax-rules.md

@@ -0,0 +1,65 @@
+<markdown_syntax_rules>
+
+## Markdown Syntax Standard
+
+### Allowed Syntax
+
+**Inline** (used within text):
+
+- Emphasis: `**bold**`, `*italic*`, `~~strikethrough~~`
+- Links: `[text](url)`
+- Images: `![alt](url)`
+- Inline Code: `` `code` ``
+
+**Block** (standalone blocks):
+
+- Headings: `#`, `##`, `###`, etc.
+- Lists: `- item`, `1. item`
+- Task Lists: `- [ ]`, `- [x]`
+- Blockquotes: `> quote`
+- Code Block: ` ```language ... ``` `
+- Tables: `| col | col |` with `|---|---|` separator
+- Horizontal Rule: `---`
+- Admonition: `:::severity ... :::`
+
+### Prohibited Syntax
+
+The following are **strictly forbidden**:
+
+- Footnotes: `[^1]: note text`
+- Math/LaTeX: `$inline$`, `$$ block $$`
+- Highlight: `==highlighted==`
+- Subscript/Superscript: `H~2~O`, `X^2^`
+- Abbreviations: `*[HTML]: Hyper Text Markup Language`
+
+### Link Rules
+
+- Links must reference valid external URLs or paths from the document structure
+- Use absolute paths from the documentation structure for internal links
+
+### Table Formatting Rules
+
+- Separator row (`|---|---|---|`) must match the exact column count of header row
+- Each row must have the same number of columns
+- Use tables for predefined values (e.g., status types, options) or term definitions
+- Validate table structure before output
+
+### Code Block Rules
+
+- Ensure code blocks are properly closed
+- Generate complete, syntactically correct code (JSON, etc.)
+- Perform self-validation to ensure all code blocks, lists, and tables are properly closed without truncation
+
+### Block-Level Elements
+
+Block-level elements are standalone content blocks that must be visually separated from surrounding content.
+
+Block-Level Element List:
+
+- Admonition: `:::severity ... :::`
+- Code Block: ` ```language ... ``` `
+- Custom Components: `<x-cards>`, `<x-card>`, `<x-field-group>`, etc.
+
+**Spacing Rule:** Always insert a blank line before and after any block-level element when it is **adjacent to** other Markdown content (headings, paragraphs, lists, etc.).
+
+</markdown_syntax_rules>

package/prompts/detail/custom/admonition-usage-rules.md

@@ -0,0 +1,94 @@
+<admonition_syntax_rules>
+
+## Admonition Syntax Rules
+
+Admonition is a Markdown block extension used to highlight important information. Use it sparingly.
+
+### Syntax Structure
+
+```
+:::severity
+content
+:::
+```
+
+### Syntax Rules
+
+The `severity` is **required** and must be one of the following:
+
+- `success`: Positive outcome or best practice
+- `info`: General tips
+- `warning`: Cautions or potential issues
+- `error`: Critical risks or breaking operations
+
+The `content` is **required** and MUST strictly comply with the rules below:
+
+- The `content` MUST be plain text only
+- The `content` MUST be a single paragraph (no line breaks).
+- Nesting any blocks or Admonitions is forbidden.
+- Recommended length: within 200 characters.
+
+### Usage Guidelines
+
+- Use sparingly, only for messages that truly require user attention
+- Do not use Admonition if the content needs any Markdown syntax from <markdown_syntax_rules> — use regular paragraphs instead
+- Keep the text short, clear, and actionable
+- Choose the severity level according to the importance of the message
+
+### Good Examples
+
+1. All four severity types:
+
+```md
+:::success
+Your configuration is complete.
+:::
+
+:::info
+Environment variables can override this setting.
+:::
+
+:::warning
+This API will be removed in v3.0.
+:::
+
+:::error
+Never commit API keys to version control.
+:::
+```
+
+### Bad Examples
+1. Contains Markdown Syntax:
+
+```md
+:::info
+No **bold**, *italic*, or `inline code` allowed.
+:::
+
+:::warning
+No [links](https://example.com) allowed.
+:::
+
+:::info
+- No lists
+- Or bullet points
+:::
+
+:::error
+```sh
+npm i
+```
+:::
+```
+
+2. Multi-paragraph:
+
+```md
+:::warning
+No multi-paragraph.
+
+Like this.
+:::
+```
+
+</admonition_syntax_rules>

package/prompts/detail/custom/custom-components/x-card-usage-rules.md

@@ -18,7 +18,7 @@ XCard is individual link display card, suitable for displaying individual links
 ### Children
 
 - Must be written within `<x-card>...</x-card>` children.
-- **Plain Text Only**: All markdown formatting is prohibited, including inline formats like `code`, **bold**, _italic_, [links](), and block-level formats like headers (# ##), lists (- \*), code blocks (```), tables (|), and any other markdown syntax. Only plain text content is allowed.
+- Plain Text Only: Do not use any Markdown syntax (see `<markdown_syntax_rules>` for the full list).
 
 ### Good Examples
 

package/prompts/detail/custom/custom-components/x-field-desc-usage-rules.md

@@ -17,6 +17,11 @@ XFieldDesc is rich field description. Used to provide rich text descriptions for
 ### Usage Rules
 
 - **Parent Requirement**: Must be child of `<x-field>`: `<x-field-desc>` can only appear as a child element of `<x-field>` components
+- **Avoid Redundant Information**: Do not repeat information in `<x-field-desc>` that is already expressed by the parent `<x-field>` attributes. Specifically:
+  - **Required Status**: Do not mention "required" or "optional" in descriptions since `data-required` attribute already indicates this
+  - **Default Values**: Do not repeat default values in descriptions since `data-default` attribute already shows this
+  - **Deprecated Status**: Do not mention "deprecated" in descriptions since `data-deprecated` attribute already indicates this
+  - Focus descriptions on the field's purpose, format, constraints, example values, and usage guidance instead
 
 ### Good Examples
 
@@ -83,4 +88,33 @@ XFieldDesc is rich field description. Used to provide rich text descriptions for
   </x-field-group>
   ```
 
+- Example 7: Redundant required information in description (violates "Avoid Redundant Information" rule)
+  ```md
+  <x-field-group>
+    <x-field data-name="api_key" data-type="string" data-required="true">
+      <x-field-desc markdown>Your **API key** for authentication. **This field is required.**</x-field-desc>
+    </x-field>
+    <x-field data-name="timeout" data-type="number" data-required="false" data-default="5000">
+      <x-field-desc markdown>Request timeout in milliseconds. **Optional**, defaults to `5000`.</x-field-desc>
+    </x-field>
+    <x-field data-name="old_api" data-type="string" data-deprecated="true">
+      <x-field-desc markdown>Old API endpoint. **This field is deprecated.**</x-field-desc>
+    </x-field>
+  </x-field-group>
+  ```
+  **Correct approach:**
+  ```md
+  <x-field-group>
+    <x-field data-name="api_key" data-type="string" data-required="true">
+      <x-field-desc markdown>Your **API key** for authentication. Generate one from the `Settings > API Keys` section.</x-field-desc>
+    </x-field>
+    <x-field data-name="timeout" data-type="number" data-required="false" data-default="5000">
+      <x-field-desc markdown>Request timeout in milliseconds.</x-field-desc>
+    </x-field>
+    <x-field data-name="old_api" data-type="string" data-deprecated="true">
+      <x-field-desc markdown>Old API endpoint. Use the new endpoint instead.</x-field-desc>
+    </x-field>
+  </x-field-group>
+  ```
+
 </x-field-desc-usage-rules>

package/prompts/detail/custom/custom-components/x-field-group-usage-rules.md

@@ -15,7 +15,6 @@ XFieldGroup is `<x-field>` grouping container. Used to group multiple related `<
 
 - **Top-Level Only**: Used only at the top level for grouping related `<x-field>` elements. Cannot be nested inside other `<x-field>` or `<x-field-group>` elements
 - **Structured Data Only**: Use `<x-field-group>` for fields **other than simple types** (`string`, `number`, `boolean`, `symbol`), e.g., Properties, Context, Parameters, Return values. For simple-type fields, use plain Markdown text.
-- **Spacing Around**: Always insert a blank line before and after `<x-field-group>` when it’s adjacent to Markdown content.
 
 ### Good Examples
 
@@ -78,18 +77,4 @@ XFieldGroup is `<x-field>` grouping container. Used to group multiple related `<
   </x-field-group>
   ```
 
-- Example 6: Missing blank line before x-field-group (violates "Spacing Around" rule)
-  ```md
-  **Parameters**
-  <x-field-group>
-    <x-field data-name="initialState" data-type="any" data-required="false">
-      <x-field-desc markdown>The initial state value.</x-field-desc>
-    </x-field>
-  </x-field-group>
-
-  `useReducer` returns an array with two items:
-  <x-field-group>
-    <x-field data-name="dispatch" data-type="function" data-desc="A function that you can call with an action to update the state."></x-field>
-  </x-field-group>
-  ```
 </x-field-group-usage-rules>

package/prompts/detail/custom/custom-components/x-field-usage-rules.md

@@ -10,7 +10,7 @@ XField is structured data field, suitable for displaying API parameters, return
 - `data-default` (optional): Default value for the field
 - `data-required` (optional): Whether the field is required ("true" or "false")
 - `data-deprecated` (optional): Whether the field is deprecated ("true" or "false")
-- `data-desc` (optional): Simple description of the field (plain text only)
+- `data-desc` (optional): Simple description of the field. Do not use any Markdown syntax (see `<markdown_syntax_rules>` for the full list).
 
 ### Children
 

package/prompts/detail/generate/document-rules.md

@@ -1,6 +1,8 @@
 
 <document_rules>
 
+{% include "../../common/document/markdown-syntax-rules.md" %}
+
 Documentation Generation Rules:
 - **Opening Hook Requirement:** The document must begin with a compelling, relaxed, and concise introductory paragraph (The "Hook").
 - **Hook Content:** This paragraph must clearly state the specific outcome, knowledge, or skill the reader will gain upon completing the document (Preferably 50 words or less).
@@ -13,9 +15,6 @@ Documentation Generation Rules:
 - Since API names are already specified in document titles, avoid repeating them in subheadings—use sub-API names directly
 - Include links to related documents in the introduction using Markdown format to help users navigate to relevant content
 - Add links to further reading materials in the summary section using Markdown format
-- **Markdown Syntax Constraint**: Use only GitHub Flavored Markdown (GFM) syntax by default. Prohibited extensions include: custom blocks `:::`, footnotes `[^1]: notes`, math formulas `$$ LaTeX`, highlighted text `==code==`, and other non-GFM syntax unless explicitly defined in custom component rules
-- Use proper Markdown link syntax, for example: [Next Chapter Title](next_chapter_path)
-- **Ensure next_chapter_path references either external URLs or valid paths from the documentation structure**—use absolute paths from the documentation structure
 - When detailDataSource includes third-party links, incorporate them appropriately throughout the document
 - Structure each section with: title, introduction, code examples, response data samples, and explanatory notes. Place explanations directly after code examples without separate "Example Description" subheadings
 - Maintain content completeness and logical flow so users can follow the documentation seamlessly
@@ -23,10 +22,6 @@ Documentation Generation Rules:
 - All interface and method documentation must include **response data examples**
 - **Use `<x-field-group>` for all structured data**: Represent objects with nested `<x-field>` elements, and expand each structure to the **deepest relevant level**.
 - **Enhance field descriptions with example values**: For structured data defined using `<x-field-group>`, extract example values from type definitions, comments, or test cases to make documentation more practical and user-friendly.
-- **Use Markdown tables** for predefined values (e.g., status types, options) or term definitions to improve clarity and allow side-by-side comparison.
-- Validate output Markdown for completeness, ensuring tables are properly formatted
-- **Content Integrity**: Generate complete, syntactically correct code blocks (JSON, etc.). Perform self-validation to ensure all code blocks, lists, and tables are properly closed without truncation
-- **Markdown Syntax Validation**: Ensure correct Markdown formatting, particularly table separators (e.g., `|---|---|---|`) that match column counts
 - Use README files for reference only—extract the most current and comprehensive information directly from source code
 - Omit tag information from document headers as it's processed programmatically
 - Parse `jsx` syntax correctly when present in code samples

package/prompts/detail/generate/system-prompt.md

@@ -42,6 +42,8 @@ Documentation content generation rules:
 
 {% include "../custom/code-block-usage-rules.md" %}
 
+{% include "../custom/admonition-usage-rules.md" %}
+
 {% include "../../common/document/media-file-list-usage-rules.md" %}
 
 {% include "../../common/document/openapi-usage-rules.md" %}

package/prompts/detail/update/system-prompt.md

@@ -68,6 +68,8 @@ Documentation content optimization rules:
 
 {% include "../custom/code-block-usage-rules.md" %}
 
+{% include "../custom/admonition-usage-rules.md" %}
+
 {% include "../../common/document/media-file-list-usage-rules.md" %}
 
 {% include "../../common/document/openapi-usage-rules.md" %}

package/prompts/translate/admonition.md

@@ -0,0 +1,20 @@
+<admonition_rules>
+
+Admonition blocks use the following format:
+
+```
+:::severity
+
+text
+
+:::
+```
+
+Admonition Translation Rules:
+
+- **Translate** the text content only
+- **Do not translate** the severity keyword (success, info, warning, error)
+- **Preserve** the `:::` syntax and block structure
+
+</admonition_rules>
+

package/prompts/translate/translate-document.md

@@ -24,6 +24,8 @@ Translation Requirements:
 - Translate Descriptions Only in <x-field>: All `<x-field>` component attributes must maintain the original format. Only translate the description content within `data-desc` attribute or `<x-field-desc>` elements.
 
 {% include "./code-block.md" %}
+
+{% include "./admonition.md" %}
 </translation_rules>
 
 {% if feedback %}

package/utils/constants/index.mjs

@@ -1,5 +1,5 @@
 // Default file patterns for inclusion and exclusion
-export const DEFAULT_INCLUDE_PATTERNS = [
+export const DEFAULT_INCLUDE_PATTERNS = Object.freeze([
   // Python
   "*.py",
   "*.pyi",
@@ -100,42 +100,29 @@ export const DEFAULT_INCLUDE_PATTERNS = [
   "*.mkv",
   "*.webm",
   "*.m4v",
-];
+]);
 
-export const DEFAULT_EXCLUDE_PATTERNS = [
-  "**/aigne-docs/**",
+export const DEFAULT_EXCLUDE_PATTERNS = Object.freeze([
   "**/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",
@@ -143,7 +130,7 @@ export const DEFAULT_EXCLUDE_PATTERNS = [
   "**/bun.lockb",
   "**/bun.lock",
   "**/bun.lockb",
-];
+]);
 
 // Supported languages for documentation
 export const SUPPORTED_LANGUAGES = [

package/utils/d2-utils.mjs

@@ -206,7 +206,12 @@ export function wrapCode({ content }) {
   return `\`\`\`d2\n${content}\n\`\`\``;
 }
 
-export function replacePlaceholder({ content }) {
+/**
+ * Replaces D2 code block with DIAGRAM_PLACEHOLDER.
+ * @param {string} content - Document content containing D2 code block
+ * @returns {Array} - [contentWithPlaceholder, originalCodeBlock]
+ */
+export function replaceD2WithPlaceholder({ content }) {
   const [firstMatch] = Array.from(content.matchAll(codeBlockRegex));
   if (firstMatch) {
     const matchContent = firstMatch[0];
@@ -216,3 +221,37 @@ export function replacePlaceholder({ content }) {
 
   return [content, ""];
 }
+
+/**
+ * Replaces DIAGRAM_PLACEHOLDER with D2 code block, ensuring proper spacing.
+ * @param {string} content - Document content containing DIAGRAM_PLACEHOLDER
+ * @param {string} diagramSourceCode - D2 diagram source code (without markdown wrapper)
+ * @returns {string} - Content with placeholder replaced by code block
+ */
+export function replacePlaceholderWithD2({ content, diagramSourceCode }) {
+  if (!content || !diagramSourceCode) {
+    return content;
+  }
+
+  const placeholderIndex = content.indexOf(DIAGRAM_PLACEHOLDER);
+  if (placeholderIndex === -1) {
+    return content;
+  }
+
+  // Check if placeholder has newlines around it
+  const beforePlaceholder = content.substring(0, placeholderIndex);
+  const afterPlaceholder = content.substring(placeholderIndex + DIAGRAM_PLACEHOLDER.length);
+
+  const codeBlock = wrapCode({ content: diagramSourceCode });
+
+  // Add newlines if missing
+  let replacement = codeBlock;
+  if (beforePlaceholder && !beforePlaceholder.endsWith("\n")) {
+    replacement = `\n${replacement}`;
+  }
+  if (afterPlaceholder && !afterPlaceholder.startsWith("\n")) {
+    replacement = `${replacement}\n`;
+  }
+
+  return content.replace(DIAGRAM_PLACEHOLDER, replacement);
+}

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";