@aigne/doc-smith 0.8.12-beta.3 → 0.8.12-beta.4

package/.aigne/doc-smith/config.yaml

@@ -16,8 +16,8 @@ projectLogo: https://docsmith.aigne.io/image-bin/uploads/9645caf64b4232699982c4d
 #   solveProblems    - Solve problems: Help users troubleshoot and fix issues
 #   mixedPurpose     - Mix of above: Comprehensive documentation covering multiple needs
 documentPurpose:
+  - getStarted
   - completeTasks
-  - findAnswers
 
 # Target Audience: Who will be reading this most often?
 # Available options (uncomment and modify as needed):
@@ -29,7 +29,6 @@ documentPurpose:
 #   mixedTechnical   - Mixed technical audience: Developers, DevOps, and technical users
 targetAudienceTypes:
   - endUsers
-  - developers
 
 # Reader Knowledge Level: What do readers typically know when they arrive?
 # Available options (uncomment and modify as needed):
@@ -52,11 +51,10 @@ documentationDepth: comprehensive
 rules: |
   Avoid using vague or empty words that don't provide measurable or specific details, such as 'intelligently', 'seamlessly', 'comprehensive', or 'high-quality'. Focus on concrete, verifiable facts and information.
   Focus on concrete, verifiable facts and information.
-  
+  Must cover all subcommands of DocSmith
 
 # Target Audience: Describe your specific target audience and their characteristics
 targetAudience: |
-  
 
 locale: en
 translateLanguages:
@@ -65,8 +63,13 @@ translateLanguages:
   - ja
 docsDir: ./docs  # Directory to save generated documentation
 sourcesPath:  # Source code paths to analyze
-  - ./
-lastGitHead: 6fc5d715e778663896ae179975ec72d9e5ff97ed
+  - ./README.md
+  - ./CHANGELOG.md
+  - ./aigne.yaml
+  - ./agents
+  - ./media.md
+  - ./.aigne/doc-smith/config.yaml
+lastGitHead: f0db74dffd0876dab4cc3ad628523abd359c9430
 # ⚠️ Warning: boardId is auto-generated by system, please do not edit manually
 boardId: "docsmith"
 appUrl: https://docsmith.aigne.io

package/.aigne/doc-smith/output/structure-plan.json

@@ -1,148 +1,162 @@
 [
   {
     "title": "Overview",
-    "description": "Get a quick introduction to AIGNE DocSmith, what it does, its main features, and how it fits into the larger AIGNE ecosystem.",
+    "description": "Explains what AIGNE DocSmith does, the problems it solves, and its main capabilities based on your project's code.",
     "path": "/overview",
-    "parentId": null,
-    "sourceIds": ["README.md", "package.json", "aigne.yaml"]
+    "sourceIds": ["README.md", "aigne.yaml", ".aigne/doc-smith/config.yaml"],
+    "parentId": ""
   },
   {
     "title": "Getting Started",
-    "description": "Follow this simple, step-by-step guide to install the tool, configure your project, and generate your first set of documents in minutes.",
+    "description": "Provides a step-by-step guide to installing the tool and generating your first set of documents.",
     "path": "/getting-started",
-    "parentId": null,
-    "sourceIds": ["README.md", "media.md", "agents/input-generator.mjs"]
+    "sourceIds": ["README.md", "agents/init/index.mjs", "media.md"],
+    "parentId": ""
   },
   {
-    "title": "Core Features",
-    "description": "Explore the main commands and capabilities of DocSmith, from creating new documentation to publishing it online.",
-    "path": "/features",
-    "parentId": null,
-    "sourceIds": ["README.md"]
-  },
-  {
-    "title": "Generate Documentation",
-    "description": "Learn how to use a single command to automatically create a complete set of documentation from your source code.",
-    "path": "/features/generate-documentation",
-    "parentId": "/features",
-    "sourceIds": ["README.md", "media.md", "agents/docs-generator.yaml"]
-  },
-  {
-    "title": "Update and Refine",
-    "description": "Discover how to intelligently update your documents when your code changes, or make specific improvements using feedback.",
-    "path": "/features/update-and-refine",
-    "parentId": "/features",
-    "sourceIds": ["README.md", "media.md", "agents/detail-regenerator.yaml"]
+    "title": "Guides",
+    "description": "Contains step-by-step instructions for performing common documentation tasks.",
+    "path": "/guides",
+    "sourceIds": [
+      "aigne.yaml",
+      "README.md",
+      "agents/generate/index.yaml",
+      "agents/update/index.yaml",
+      "agents/translate/index.yaml",
+      "agents/publish/index.yaml",
+      "agents/clear/index.yaml",
+      "agents/evaluate/index.yaml",
+      "agents/history/index.yaml",
+      "agents/chat/index.yaml"
+    ],
+    "parentId": ""
+  },
+  {
+    "title": "Configuration",
+    "description": "Details how to set up the tool and manage personal preferences for document generation.",
+    "path": "/configuration",
+    "sourceIds": [
+      "aigne.yaml",
+      "agents/init/index.mjs",
+      "agents/prefs/index.mjs",
+      ".aigne/doc-smith/config.yaml"
+    ],
+    "parentId": ""
   },
   {
-    "title": "Translate Documentation",
-    "description": "Learn how to automatically translate your documentation into multiple languages to reach a global audience.",
-    "path": "/features/translate-documentation",
-    "parentId": "/features",
-    "sourceIds": ["README.md", "media.md", "agents/translate.yaml", "agents/retranslate.yaml"]
+    "title": "Release Notes",
+    "description": "Lists new features, improvements, and bug fixes for each version of the tool.",
+    "path": "/release-notes",
+    "sourceIds": ["CHANGELOG.md"],
+    "parentId": ""
   },
   {
-    "title": "Publish Your Docs",
-    "description": "A guide on how to easily publish your documentation to a public platform or your own private website.",
-    "path": "/features/publish-your-docs",
-    "parentId": "/features",
+    "title": "Generating Documentation",
+    "description": "Walks through the process of creating a new set of documents from your source files from start to finish.",
+    "path": "/guides/generating-documentation",
     "sourceIds": [
+      "agents/generate/index.yaml",
+      "agents/generate/generate-structure.yaml",
+      "agents/generate/user-review-document-structure.mjs",
+      "agents/update/batch-generate-document.yaml",
       "README.md",
-      "media.md",
-      "agents/publish-docs.mjs",
-      "utils/auth-utils.mjs",
-      "utils/blocklet.mjs"
-    ]
+      "agents/generate/check-need-generate-structure.mjs",
+      "agents/generate/refine-document-structure.yaml",
+      "agents/generate/check-document-structure.yaml"
+    ],
+    "parentId": "/guides"
   },
   {
-    "title": "CLI Command Reference",
-    "description": "A comprehensive reference for all available `aigne doc` commands, their arguments, and options.",
-    "path": "/cli-reference",
-    "parentId": null,
+    "title": "Updating Documentation",
+    "description": "Explains how to modify existing documents based on code changes or new feedback.",
+    "path": "/guides/updating-documentation",
     "sourceIds": [
+      "agents/update/index.yaml",
+      "agents/update/update-single-document.yaml",
+      "agents/update/batch-update-document.yaml",
+      "agents/update/user-review-document.mjs",
       "README.md",
-      "aigne.yaml",
-      "agents/docs-generator.yaml",
-      "agents/detail-regenerator.yaml",
-      "agents/retranslate.yaml",
-      "agents/team-publish-docs.yaml",
-      "agents/prefs/index.mjs"
-    ]
+      "agents/update/check-update-is-single.mjs",
+      "agents/update/handle-document-update.yaml",
+      "agents/update/generate-document.yaml"
+    ],
+    "parentId": "/guides"
   },
   {
-    "title": "Configuration Guide",
-    "description": "A detailed look at all the available settings to customize the style, audience, and languages of your documentation.",
-    "path": "/configuration",
-    "parentId": null,
-    "sourceIds": ["README.md", "agents/input-generator.mjs", "utils/constants/index.mjs"]
+    "title": "Translating Documentation",
+    "description": "Details the steps to translate your documents into multiple supported languages.",
+    "path": "/guides/translating-documentation",
+    "sourceIds": [
+      "agents/translate/index.yaml",
+      "agents/translate/translate-multilingual.yaml",
+      "agents/translate/choose-language.mjs",
+      "README.md",
+      "agents/translate/translate-document.yaml",
+      "agents/translate/record-translation-history.mjs"
+    ],
+    "parentId": "/guides"
   },
   {
-    "title": "LLM Setup",
-    "description": "Learn how to set up DocSmith to use different AI models, including using AIGNE Hub without needing your own API keys.",
-    "path": "/configuration/llm-setup",
-    "parentId": "/configuration",
-    "sourceIds": ["README.md", "aigne.yaml"]
+    "title": "Publishing Your Docs",
+    "description": "Shows how to make your generated documentation live and accessible online.",
+    "path": "/guides/publishing-your-docs",
+    "sourceIds": ["agents/publish/index.yaml", "agents/publish/publish-docs.mjs", "README.md"],
+    "parentId": "/guides"
   },
   {
-    "title": "Language Support",
-    "description": "See the full list of languages that DocSmith supports for automatic translation and learn how to enable them.",
-    "path": "/configuration/language-support",
-    "parentId": "/configuration",
-    "sourceIds": ["README.md", "utils/constants/index.mjs"]
+    "title": "Initial Setup",
+    "description": "Guides you through the interactive setup process to create your initial configuration file.",
+    "path": "/configuration/initial-setup",
+    "sourceIds": ["agents/init/index.mjs", "README.md", ".aigne/doc-smith/config.yaml"],
+    "parentId": "/configuration"
   },
   {
     "title": "Managing Preferences",
-    "description": "Understand how DocSmith learns from your feedback to create persistent rules and how to manage them via the CLI.",
-    "path": "/configuration/preferences",
-    "parentId": "/configuration",
-    "sourceIds": [
-      "utils/preferences-utils.mjs",
-      "agents/prefs/index.mjs",
-      "prompts/feedback-refiner.md"
-    ]
-  },
-  {
-    "title": "Interactive Setup",
-    "description": "Learn about the guided setup wizard that helps you configure your documentation project, including intelligent conflict detection for your settings.",
-    "path": "/configuration/interactive-setup",
-    "parentId": "/configuration",
-    "sourceIds": [
-      "agents/input-generator.mjs",
-      "utils/conflict-detector.mjs",
-      "utils/constants/index.mjs"
-    ]
+    "description": "Explains how to view, remove, and toggle your saved preferences for documentation generation.",
+    "path": "/configuration/managing-preferences",
+    "sourceIds": ["agents/prefs/index.mjs", "README.md"],
+    "parentId": "/configuration"
   },
   {
-    "title": "Advanced Topics",
-    "description": "Dive deeper into the architecture of DocSmith, learn how it works, and explore its internal mechanisms.",
-    "path": "/advanced",
-    "parentId": null,
-    "sourceIds": ["README.md"]
+    "title": "Managing History",
+    "description": "Shows how to view the history of updates made to your documentation.",
+    "path": "/guides/managing-history",
+    "sourceIds": ["agents/history/view.mjs", "aigne.yaml", "agents/history/index.yaml"],
+    "parentId": "/guides"
   },
   {
-    "title": "How It Works",
-    "description": "An architectural overview of DocSmith, explaining the role of AI agents in the documentation generation pipeline.",
-    "path": "/advanced/how-it-works",
-    "parentId": "/advanced",
+    "title": "Evaluating Documents",
+    "description": "Details how to use the evaluation command to assess the quality and completeness of your generated documentation.",
+    "path": "/guides/evaluating-documents",
     "sourceIds": [
-      "README.md",
+      "agents/evaluate/index.yaml",
       "aigne.yaml",
-      "agents/structure-planning.yaml",
-      "agents/content-detail-generator.yaml"
-    ]
-  },
-  {
-    "title": "Quality Assurance",
-    "description": "Understand the built-in checks DocSmith performs to ensure high-quality, well-formatted, and error-free documentation, including link checking and diagram validation.",
-    "path": "/advanced/quality-assurance",
-    "parentId": "/advanced",
-    "sourceIds": ["utils/markdown-checker.mjs", "utils/mermaid-validator.mjs", "utils/d2-utils.mjs"]
+      "agents/evaluate/document-structure.yaml",
+      "agents/evaluate/document.yaml",
+      "agents/evaluate/generate-report.mjs"
+    ],
+    "parentId": "/guides"
   },
   {
-    "title": "Changelog",
-    "description": "A detailed log of all notable changes, features, and bug fixes for each version of the project.",
-    "path": "/changelog",
-    "parentId": null,
-    "sourceIds": ["CHANGELOG.md"]
+    "title": "Cleaning Up",
+    "description": "Provides instructions on how to use the clear command to remove generated files, configurations, and cached data.",
+    "path": "/guides/cleaning-up",
+    "sourceIds": [
+      "agents/clear/index.yaml",
+      "aigne.yaml",
+      "agents/clear/choose-contents.mjs",
+      "agents/clear/clear-generated-docs.mjs",
+      "agents/clear/clear-document-structure.mjs",
+      "agents/clear/clear-document-config.mjs",
+      "agents/clear/clear-auth-tokens.mjs"
+    ],
+    "parentId": "/guides"
+  },
+  {
+    "title": "Interactive Chat",
+    "description": "Explains how to use the interactive chat assistant to generate, modify, and manage your documentation.",
+    "path": "/guides/interactive-chat",
+    "sourceIds": ["agents/chat/index.yaml", "aigne.yaml"],
+    "parentId": "/guides"
   }
 ]

package/.aigne/doc-smith/upload-cache.yaml

@@ -1813,3 +1813,51 @@ cf8ceb314728f377f2d87d920e41b9fba87659e4b312805ae9e348871a6241aa:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/44cb2fc222a3dd15.png
       upload_time: 2025-10-03T13:04:00.403Z
+da70db1ce27d40dc18c793f37d3e08b8b7826e096434b90a98fde6cd7411ea30:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/78b8e8153c6fb98784d2efcc1d56b1ed9726a07aba6fbcc9e6a751a312444d9d.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/da70db1ce27d40dc.svg
+      upload_time: 2025-10-10T07:40:16.274Z
+5f1096a6b7d2fc044d4b322f111ea4cfe2c5e7b75fe462c4ffb4661777176e47:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/4d36e9d7f2ab21ca6ce28faa613c09d19117e1c85a0652e05857c9fede449edd.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/5f1096a6b7d2fc04.svg
+      upload_time: 2025-10-10T07:40:17.648Z
+9754353921ef1661023cbdac23905ff918883755c8c7b70fc08e35fd5766039f:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/fd8d9cc57a8adccb46b65506f80f1034921b7745f9258bef2ab2d23e68c01c74.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/9754353921ef1661.svg
+      upload_time: 2025-10-10T07:40:18.307Z
+6adb3cd3c2afb37bb58a8176a7bd5f3fe44becf3a5ff7eb5d4b191e593df4a7f:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/4f6fc8759f5273a3af89b83c3d8b28f78ccc21de3a0763076bc7ba96c98de7a7.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/6adb3cd3c2afb37b.svg
+      upload_time: 2025-10-10T07:40:18.891Z
+5994caf6eadad709c08b1f77751db6498ee575c194226cce1f366e3bfef10748:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/133ad4c2b1c4a820cd9214b4647dec84041fcf1a1cac313c0cb18be9105734bb.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/5994caf6eadad709.svg
+      upload_time: 2025-10-10T07:40:20.141Z
+e87fcba2227e472141f99b92eb0247965db132079459ce8c83454dde7fc9a6ae:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/f693373b7427d1eca678dc30eaaf04379baf34a1788398465e04a08fec51c5f4.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/e87fcba2227e4721.svg
+      upload_time: 2025-10-10T07:40:20.164Z
+5948cfe4d2c9816e0b81ef93bd215d42eca8bad0cf763ba23067ba6d7618ba38:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/a76bd1e831a3ec5bb069ae090e3f0a562a2fbe34af65a578a72098c33adfb312.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/5948cfe4d2c9816e.svg
+      upload_time: 2025-10-10T07:40:21.401Z
+3b189fa893cc2120abd34e977063fd7ca631df529106542f9ef16579877ec86a:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/a167a6cd2dcac3d0bcc105d6e0ac6a344b634c089d38547bf91ad831ebffd187.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/3b189fa893cc2120.svg
+      upload_time: 2025-10-10T07:40:22.634Z

package/.github/workflows/publish-docs.yml

@@ -1,8 +1,7 @@
 name: publish docs
 
 env:
-  GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
-  OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+  AIGNE_HUB_API_KEY: ${{ secrets.AIGNE_HUB_API_KEY }}
 
 permissions:
   contents: write
@@ -10,7 +9,6 @@ permissions:
 on:
   push:
     branches:
-      - master
       - main
 
 jobs:
@@ -33,11 +31,10 @@ jobs:
       - uses: oven-sh/setup-bun@v2
         with:
           bun-version: latest
-          cache: true
 
       - name: Install @aigne/cli
         run: |
-          bun install -g @aigne/cli
+          bun install -g @aigne/cli@beta
 
       - name: Publish docs to arcblock.io
         env:
@@ -46,7 +43,7 @@ jobs:
           set -e
           aigne doc publish --appUrl https://www.arcblock.io
 
-      - name: Publish docs to prod docsmith
+      - name: Publish docs to docsmith
         env:
           DOC_DISCUSS_KIT_ACCESS_TOKEN: ${{ secrets.DOC_PUBLISH_API_KEY_DOCSMITH }}
         run: |
@@ -60,7 +57,7 @@ jobs:
           if [ -n "$(git status --porcelain)" ]; then
             echo "Changes detected. Committing and pushing..."
             git add -A
-            git commit -m "chore(docs): push doc smith cache [skip ci]"
+            git commit -m "chore(docs): push doc publish cache [skip ci]"
             BRANCH="${{ github.head_ref || github.ref_name }}"
             git push origin HEAD:refs/heads/"${BRANCH}"
           else

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.8.12-beta.3"
+  ".": "0.8.12-beta.4"
 }

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.8.12-beta.4](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.12-beta.3...v0.8.12-beta.4) (2025-10-11)
+
+
+### Features
+
+* implement large context handling and optimize document generation ([#172](https://github.com/AIGNE-io/aigne-doc-smith/issues/172)) ([de09f7c](https://github.com/AIGNE-io/aigne-doc-smith/commit/de09f7c7f9d1ecbf620a6a4684be84f13f4fb644))
+
+
+### Bug Fixes
+
+* add heading level constraint for doc generating ([#170](https://github.com/AIGNE-io/aigne-doc-smith/issues/170)) ([f4c7163](https://github.com/AIGNE-io/aigne-doc-smith/commit/f4c71631cc89524abf945ae5f829f8111317a5bf))
+* tune update tips and support clear deployment config  ([#174](https://github.com/AIGNE-io/aigne-doc-smith/issues/174)) ([71c19e0](https://github.com/AIGNE-io/aigne-doc-smith/commit/71c19e06730111f8b757e523abebaed57bbaea95))
+
 ## [0.8.12-beta.3](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.12-beta.2...v0.8.12-beta.3) (2025-10-09)
 
 

package/agents/clear/choose-contents.mjs

@@ -1,24 +1,41 @@
+import { getDocSmithEnvFilePath } from "../../utils/auth-utils.mjs";
+import { getConfigFilePath, getStructurePlanPath, toDisplayPath } from "../../utils/file-utils.mjs";
+
 const TARGET_METADATA = {
   generatedDocs: {
     label: "generated documents",
-    description: "Delete all generated documents.",
+    description: ({ docsDir }) =>
+      `Delete all generated documents in './${toDisplayPath(docsDir)}' (documentation structure stays).`,
     agent: "clearGeneratedDocs",
   },
   documentStructure: {
     label: "documentation structure",
-    description: "Delete the documentation structure and all generated documents.",
+    description: ({ docsDir, workDir }) =>
+      `Delete all generated documents in './${toDisplayPath(docsDir)}' and the documentation structure './${toDisplayPath(
+        getStructurePlanPath(workDir),
+      )}' .`,
     agent: "clearDocumentStructure",
   },
   documentConfig: {
     label: "document configuration",
-    description: "Delete the document configuration.",
+    description: ({ workDir }) =>
+      `Delete the configuration file './${toDisplayPath(
+        getConfigFilePath(workDir),
+      )}' (requires 'aigne doc init' to regenerate).`,
     agent: "clearDocumentConfig",
   },
   authTokens: {
     label: "authorizations",
-    description: "Clear published site authorizations.",
+    description: () =>
+      `Delete authorization information in '${getDocSmithEnvFilePath()}' (requires re-authorization after clearing).`,
     agent: "clearAuthTokens",
   },
+  deploymentConfig: {
+    label: "deployment config",
+    description: ({ workDir }) =>
+      `Delete appUrl from './${toDisplayPath(getConfigFilePath(workDir))}'.`,
+    agent: "clearDeploymentConfig",
+  },
 };
 
 const TARGET_KEYS = Object.keys(TARGET_METADATA);
@@ -46,7 +63,7 @@ export default async function chooseContents(input = {}, options = {}) {
       const choices = Object.entries(TARGET_METADATA).map(([value, def]) => ({
         name: def.label,
         value,
-        description: def.description,
+        description: def.description({ docsDir: input.docsDir, workDir: input.workDir }),
       }));
 
       selectedTargets = await options.prompts.checkbox({

package/agents/clear/clear-auth-tokens.mjs

@@ -1,13 +1,11 @@
 import { existsSync } from "node:fs";
 import { readFile, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join } from "node:path";
 import chalk from "chalk";
 import { parse, stringify } from "yaml";
+import { getDocSmithEnvFilePath } from "../../utils/auth-utils.mjs";
 
 export default async function clearAuthTokens(_input = {}, options = {}) {
-  const DOC_SMITH_ENV_FILE = join(homedir(), ".aigne", "doc-smith-connected.yaml");
-
+  const DOC_SMITH_ENV_FILE = getDocSmithEnvFilePath();
   // Check if the file exists
   if (!existsSync(DOC_SMITH_ENV_FILE)) {
     return {

package/agents/clear/clear-deployment-config.mjs

@@ -0,0 +1,49 @@
+import { readFile, writeFile } from "node:fs/promises";
+import yaml from "yaml";
+import { pathExists, toDisplayPath, getConfigFilePath } from "../../utils/file-utils.mjs";
+
+export default async function clearDeploymentConfig(input = {}) {
+  const { workDir } = input;
+
+  const configFilePath = getConfigFilePath(workDir);
+  const displayPath = toDisplayPath(configFilePath);
+
+  try {
+    // Check if config file exists
+    const exists = await pathExists(configFilePath);
+    if (!exists) {
+      return {
+        message: `📦 Config file not found (${displayPath}). No need to clear appUrl.`,
+      };
+    }
+
+    // Remove appUrl field while preserving comments
+    const configContent = await readFile(configFilePath, "utf-8");
+    const doc = yaml.parseDocument(configContent);
+
+    if (doc.has("appUrl")) {
+      doc.delete("appUrl");
+      await writeFile(
+        configFilePath,
+        doc.toString({
+          keepSourceTokens: true,
+          indent: 2,
+          lineWidth: 0,
+          minContentWidth: 0,
+        }),
+        "utf-8",
+      );
+    }
+
+    return {
+      message: `🧹 Cleared appUrl from config file (${displayPath})`,
+    };
+  } catch (error) {
+    return {
+      error: true,
+      message: `❌ Failed to clear deployment config: ${error.message}`,
+    };
+  }
+}
+
+clearDeploymentConfig.taskTitle = "Clear deployment configuration";

package/agents/clear/clear-document-config.mjs

@@ -1,11 +1,8 @@
 import { rm } from "node:fs/promises";
-import { join } from "node:path";
-import { pathExists, toDisplayPath } from "../../utils/file-utils.mjs";
+import { pathExists, toDisplayPath, getConfigFilePath } from "../../utils/file-utils.mjs";
 
 export default async function clearDocumentConfig({ workDir }) {
-  // Fixed path where config.yaml is saved by init command
-  const cwd = workDir || process.cwd();
-  const documentConfigPath = join(cwd, ".aigne", "doc-smith", "config.yaml");
+  const documentConfigPath = getConfigFilePath(workDir);
   const displayPath = toDisplayPath(documentConfigPath);
 
   try {

package/agents/clear/clear-document-structure.mjs

@@ -1,14 +1,10 @@
 import { rm } from "node:fs/promises";
-import { join } from "node:path";
-import { pathExists, toDisplayPath } from "../../utils/file-utils.mjs";
+import { pathExists, toDisplayPath, getStructurePlanPath } from "../../utils/file-utils.mjs";
 
 export default async function clearDocumentStructure(input = {}, _options = {}) {
   const { docsDir, workDir } = input;
-  const cwd = workDir || process.cwd();
 
-  // Fixed path where structure-plan.json is saved
-  const outputDir = join(cwd, ".aigne", "doc-smith", "output");
-  const structurePlanPath = join(outputDir, "structure-plan.json");
+  const structurePlanPath = getStructurePlanPath(workDir);
 
   const results = [];
   let hasError = false;

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

@@ -11,7 +11,6 @@ export default async function clearGeneratedDocs(input = {}, _options = {}) {
   }
 
   const generatedDocsPath = resolveToAbsolute(docsDir);
-
   const displayPath = toDisplayPath(generatedDocsPath);
 
   try {