@aigne/doc-smith 0.8.12-beta.6 → 0.8.12-beta.8

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

@@ -67,8 +67,8 @@ sourcesPath:  # Source code paths to analyze
   - ./CHANGELOG.md
   - ./aigne.yaml
   - ./agents
-  - ./media.md
   - ./.aigne/doc-smith/config.yaml
+  - ./assets/screenshots
 lastGitHead: f0db74dffd0876dab4cc3ad628523abd359c9430
 # ⚠️ Warning: boardId is auto-generated by system, please do not edit manually
 boardId: "docsmith"

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

@@ -0,0 +1,37 @@
+entries:
+  - timestamp: 2025-10-11T13:21:51.992Z
+    operation: translation_update
+    feedback: Do not translate the Target column in the Cleanup Targets table.
+    documentPath: /guides/cleaning-up
+  - timestamp: 2025-10-11T13:20:30.314Z
+    operation: document_update
+    feedback: The targets in Cleanup Targets are incomplete and need to be supplemented. The corresponding descriptions also require updating. Additionally, the target values should use the original enumeration values, such as 'generatedDocs'.
+    documentPath: /guides/cleaning-up
+  - timestamp: 2025-10-11T13:03:20.327Z
+    operation: document_update
+    feedback: The two aliases for the 'history' command in Viewing Update History can be combined into a single code block. The Short Hash in Understanding the History Output now consists of 8 characters. Additionally, operation types are separated by underscores, such as 'document_update'.
+    documentPath: /guides/managing-history
+  - timestamp: 2025-10-11T12:56:23.107Z
+    operation: document_update
+    feedback: In interactive mode, translated files are saved with a suffix appended to their original filenames within the same directory, rather than in dedicated language directories.
+    documentPath: /guides/translating-documentation
+  - timestamp: 2025-10-11T12:50:25.563Z
+    operation: document_update
+    feedback: The value of the 'docs' parameter in the demo should be a path separated by '-' rather than '/', and '.md' should be preserved.
+    documentPath: /guides/updating-documentation
+  - timestamp: 2025-10-11T12:46:37.507Z
+    operation: document_update
+    feedback: The value of the 'docs' parameter in the demo should be a path separated by '-' rather than '/'.
+    documentPath: /guides/updating-documentation
+  - timestamp: 2025-10-11T12:39:53.222Z
+    operation: document_update
+    feedback: The prompts in Review the Documentation Structure are outdated and need updating. Command Parameters also require updating.
+    documentPath: /guides/generating-documentation
+  - timestamp: 2025-10-11T12:26:24.598Z
+    operation: translation_update
+    feedback: AIGNE Framework is a proper noun and has its own link; no translation is required.
+    documentPath: /overview
+  - timestamp: 2025-10-11T12:24:05.477Z
+    operation: document_update
+    feedback: Add a link to the AIGNE Framework 'https://www.aigne.io/framework'.
+    documentPath: /overview

package/.aigne/doc-smith/media-description.yaml

@@ -0,0 +1,91 @@
+descriptions:
+  5838723847ec201191b002ef7d44937d92386a82755ca7a66374acff6b91325e:
+    path: ../assets/screenshots/doc-translate.png
+    description: This screenshot illustrates a user interface for document
+      translation. It displays options for selecting the source and target
+      languages, along with an area for document input or upload. The image
+      demonstrates the initial steps for translating a document within a
+      software application or web service.
+    generatedAt: 2025-10-13T10:16:56.300Z
+  ac51399fcd5ba2e36d7c84264dd28624acd10c57aa82f7d006da6f8434cb24de:
+    path: ../assets/screenshots/doc-regenerate.png
+    description: This screenshot displays a user interface element for a
+      'Regenerate' function, likely within an application or content management
+      system. It visually demonstrates how users can trigger the re-rendering or
+      updating of content, often showing a button or control and potentially the
+      immediate output or status of the regeneration process.
+    generatedAt: 2025-10-13T10:16:56.301Z
+  9871bff567cc5f1b73e99b84c03781bffc7f531635b9bd40f23a2aee5f9885e5:
+    path: ../assets/screenshots/doc-update.png
+    description: This image is a screenshot depicting a user interface for updating
+      documentation content. It showcases a main text editing area, likely with
+      rich text formatting capabilities, accompanied by buttons for actions such
+      as saving, previewing, or publishing changes. The layout suggests a
+      content management system or a wiki-style editing environment.
+    generatedAt: 2025-10-13T10:16:56.301Z
+  31353781ba6d1572359823faa399af9f5deca7b994f24939cb5f5143fcc96b14:
+    path: ../assets/screenshots/doc-translate-langs.png
+    description: This screenshot depicts a user interface element focused on
+      language selection for documentation translation. It displays a list or
+      menu of languages, allowing users to choose or configure the target
+      languages for translating documentation content. The image highlights the
+      functionality for managing multilingual documentation.
+    generatedAt: 2025-10-13T10:16:56.301Z
+  a42903e87ae020dcb81991e672b2a2990b94eb0e92d6c1cc87f3bf6223355344:
+    path: ../assets/screenshots/doc-publish.png
+    description: This is a screenshot of a "Publish Documentation" dialog box from a
+      user interface. It presents options for selecting documentation to publish
+      and configuring various publication settings, including checkboxes for
+      search indexing and versioning. The dialog features "Cancel" and "Publish"
+      action buttons at the bottom right.
+    generatedAt: 2025-10-13T10:16:56.301Z
+  c055a80de6c1120765757fd3ef91ef05718f77beb7d6dfdac41d8e234361a68a:
+    path: ../assets/screenshots/doc-generated-successfully.png
+    description: This is a screenshot of a success notification banner,
+      characterized by its wide and short dimensions. It displays a positive
+      message such as "Document generated successfully," likely accompanied by a
+      green checkmark or other visual cues indicating a successful operation.
+      This image is suitable for illustrating UI feedback when a document
+      generation process is completed.
+    generatedAt: 2025-10-13T10:16:56.301Z
+  f786c36289e0e5bfea866c9384edc7d44996c42adfad0cb6f613f46e27f0f2be:
+    path: ../assets/screenshots/doc-generate.png
+    description: This screenshot displays a "Generate Documentation" dialog,
+      presenting various options for outputting documentation files. Users can
+      specify an output path, choose to include example content, overwrite
+      existing files, and generate the documentation in dark mode, before
+      confirming with "Generate" or "Cancel."
+    generatedAt: 2025-10-13T10:16:56.301Z
+  2b41c70c6a61942727984b2d99010cbe7e1d9b4c75686f65af8b5a245e9b800d:
+    path: ../assets/screenshots/doc-generate-docs.png
+    description: This image is a screenshot illustrating a user interface for a
+      documentation generation process. It depicts a dialog or panel with
+      various configuration options and controls, likely including output format
+      selections and a prominent "Generate" button to initiate the creation of
+      documentation.
+    generatedAt: 2025-10-13T10:16:56.301Z
+  44cb2fc222a3dd15fa82f1088d9113b0bb1bfc8b29a0e568a2273d80e8f50a7d:
+    path: ../assets/screenshots/doc-complete-setup.png
+    description: This screenshot depicts the "Setup Complete" screen from a user
+      interface, indicating the successful conclusion of an installation or
+      configuration process. It features a prominent confirmation message, such
+      as "Setup Complete!", often accompanied by a success icon and an
+      actionable button like "Continue" or "Go to Dashboard" to proceed.
+    generatedAt: 2025-10-13T10:16:56.301Z
+  13a9073d16762909e189af4e53ceb004abe1c55681d12726fceb262205fbf180:
+    path: ../assets/screenshots/doc-generate.png
+    description: This screenshot displays a user interface for generating
+      documentation. It features various input fields and controls, likely for
+      configuring options such as output format, target location, and content
+      selection. The image serves to illustrate the steps or settings involved
+      in the documentation generation process.
+    generatedAt: 2025-10-13T14:07:35.096Z
+  90c0daa8347df01c8154b6a5b30879b691c4a94b49c970b0480435591603bf55:
+    path: ../assets/screenshots/doc-complete-setup.png
+    description: This image is a screenshot displaying a "Setup Complete" success
+      message within a user interface. It shows a clear green checkmark icon, a
+      bold headline confirming the setup is finished, and additional descriptive
+      text below. A prominent "Done" button is visible at the bottom of the
+      interface, indicating the next action for the user.
+    generatedAt: 2025-10-13T14:07:35.097Z
+lastUpdated: 2025-10-13T14:07:35.098Z

package/.aigne/doc-smith/preferences.yml

@@ -1,4 +1,16 @@
 rules:
+  - id: pref_cbc8005011c08ca0
+    active: true
+    scope: translation
+    rule: In the table titled 'Cleanup Targets', the 'Target' column must retain the original text and should not be translated.
+    feedback: Do not translate the Target column in the Cleanup Targets table.
+    createdAt: 2025-10-11T13:22:06.529Z
+  - id: pref_545cabc521ecd4a5
+    active: true
+    scope: translation
+    rule: The proprietary term 'AIGNE Framework' must not be translated and must be retained in its original form.
+    feedback: AIGNE Framework is a proper noun and has its own link; no translation is required.
+    createdAt: 2025-10-11T12:26:37.517Z
   - id: pref_6e612d7ca8b7f3b6
     active: true
     scope: document

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

@@ -4,18 +4,12 @@ f1faeee67ce652ecbabb1dfd8f58bed4dd5edbb89b929bc84763c278a140df94:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/f1faeee67ce652ec.svg
       upload_time: 2025-09-07T02:41:04.292Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/f1faeee67ce652ec.svg
-      upload_time: 2025-09-08T03:55:58.504Z
 eae90551d172b74a8a52e95590da49dafda4a3301a7b367d48cb23b4afcbc45c:
   local_path: .aigne/doc-smith/.tmp/assets/d2/fb4c5fd8c2eb3dcc875bbcaf1b88723c1e5c9554d9f31d3b468edce69189c594.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/eae90551d172b74a.svg
       upload_time: 2025-09-07T02:41:04.799Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/eae90551d172b74a.svg
-      upload_time: 2025-09-08T03:55:59.449Z
     https://staging.docsmith.aigne.io:
       url: https://staging.docsmith.aigne.io/image-bin/uploads/eae90551d172b74a.svg
       upload_time: 2025-09-08T11:10:19.607Z
@@ -25,9 +19,6 @@ eae90551d172b74a8a52e95590da49dafda4a3301a7b367d48cb23b4afcbc45c:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/6deb3db3a9e53857.svg
       upload_time: 2025-09-07T02:41:06.038Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/6deb3db3a9e53857.svg
-      upload_time: 2025-09-08T03:56:00.513Z
     https://staging.docsmith.aigne.io:
       url: https://staging.docsmith.aigne.io/image-bin/uploads/6deb3db3a9e53857.svg
       upload_time: 2025-09-08T11:10:20.788Z
@@ -37,63 +28,42 @@ eae90551d172b74a8a52e95590da49dafda4a3301a7b367d48cb23b4afcbc45c:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/72c701cdaedfcaa8.svg
       upload_time: 2025-09-07T02:41:06.112Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/72c701cdaedfcaa8.svg
-      upload_time: 2025-09-08T03:55:59.067Z
 3f5fa2cedee9fd6129f8d7e9312eaa2018c11842c3f36156a641d8c24571d813:
   local_path: .aigne/doc-smith/.tmp/assets/d2/6cbfe7ab77c5caee47b7e77eb66f71573ac8befaf561080dda4c929b850b10e2.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/3f5fa2cedee9fd61.svg
       upload_time: 2025-09-07T02:41:06.225Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/3f5fa2cedee9fd61.svg
-      upload_time: 2025-09-08T03:56:00.535Z
 8738c2d2ccb63652b5a815e90096defb9d3bacf37a3c29e8350d5ad0f56d6141:
   local_path: .aigne/doc-smith/.tmp/assets/d2/b00ba2c7147bb27e092e2c2b2d9634131c73d751c3971b6380375a81efec4450.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/8738c2d2ccb63652.svg
       upload_time: 2025-09-07T02:41:07.628Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/8738c2d2ccb63652.svg
-      upload_time: 2025-09-08T03:56:01.100Z
 6dd581bc815d3b87b3a5b7e0706b7e46670d0609cddaf7f6276d22ba923198f6:
   local_path: .aigne/doc-smith/.tmp/assets/d2/dad5224fdc7ba3ab76738a333a0f443dc6a51e4ed10e0242f44e17a9c93266c6.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/6dd581bc815d3b87.svg
       upload_time: 2025-09-07T02:41:07.704Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/6dd581bc815d3b87.svg
-      upload_time: 2025-09-08T03:55:59.692Z
 dcae1350b6f914c7b62b61fd0b303e704bffe6cdfb5575473f2251cab5290750:
   local_path: .aigne/doc-smith/.tmp/assets/d2/d5a31b70ed89f445a4fe500e9290620304c21536b05db7e0a205000778ff60d3.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/dcae1350b6f914c7.svg
       upload_time: 2025-09-07T02:41:07.709Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/dcae1350b6f914c7.svg
-      upload_time: 2025-09-08T03:55:59.696Z
 4fca09589d9bfa0b43629cc773f07e1826b0b32f60693f58d5df315b0c17bda3:
   local_path: .aigne/doc-smith/.tmp/assets/d2/c476e5911e80af0317a8bdb81e58b2e860044ea1a8df6ebd5a9fe17af95aee1d.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/4fca09589d9bfa0b.svg
       upload_time: 2025-09-07T02:41:07.918Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/4fca09589d9bfa0b.svg
-      upload_time: 2025-09-08T03:56:00.157Z
 c6babdcdfee3317a8bacef57d538f549460057ed789d16996365a9bf17365111:
   local_path: .aigne/doc-smith/.tmp/assets/d2/c1cf0d4d14083306579111cd0309f28df04f16f44749a8528d901de3effba32f.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/c6babdcdfee3317a.svg
       upload_time: 2025-09-07T02:41:07.948Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/c6babdcdfee3317a.svg
-      upload_time: 2025-09-08T03:55:59.660Z
     https://staging.docsmith.aigne.io:
       url: https://staging.docsmith.aigne.io/image-bin/uploads/c6babdcdfee3317a.svg
       upload_time: 2025-09-08T11:10:28.287Z
@@ -103,18 +73,12 @@ d69b740fc5768eea571fb53bae9c074a4e405b317a74f6b5539c4c9a90eacbdc:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/d69b740fc5768eea.svg
       upload_time: 2025-09-07T02:41:07.983Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/d69b740fc5768eea.svg
-      upload_time: 2025-09-08T03:56:01.112Z
 93e8843c9ce8b8bcebb364026ea4170edb6dde0860c87913ddc821fcd74e6686:
   local_path: .aigne/doc-smith/.tmp/assets/d2/1818a01695c2396616a74572e4c85d712fab1c714ae52c2cb1084e751168173d.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/93e8843c9ce8b8bc.svg
       upload_time: 2025-09-07T02:41:09.091Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/93e8843c9ce8b8bc.svg
-      upload_time: 2025-09-08T03:55:59.694Z
     https://staging.docsmith.aigne.io:
       url: https://staging.docsmith.aigne.io/image-bin/uploads/93e8843c9ce8b8bc.svg
       upload_time: 2025-09-08T11:10:30.044Z
@@ -124,72 +88,48 @@ d69b740fc5768eea571fb53bae9c074a4e405b317a74f6b5539c4c9a90eacbdc:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/7820ba0126b7ffe9.svg
       upload_time: 2025-09-07T02:41:09.288Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/7820ba0126b7ffe9.svg
-      upload_time: 2025-09-08T03:56:00.334Z
 b51eefd7ac6ba3c1536f66ee064b251aaae80569cc641c4fef7197596ded9f09:
   local_path: .aigne/doc-smith/.tmp/assets/d2/be4a5ff64f7a27cc04b17bbc4e65d5e2105b2cb02c24b40597ae12d5bb3a5bc1.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/b51eefd7ac6ba3c1.svg
       upload_time: 2025-09-07T02:41:09.389Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/b51eefd7ac6ba3c1.svg
-      upload_time: 2025-09-08T03:56:00.306Z
 8045a0dc2db88042666b71947f84f999979df3d22ebc1ce36c6d982baea512e8:
   local_path: .aigne/doc-smith/.tmp/assets/d2/09537edb3659c17ca6f1ddbc30b85bd423571119a6fd5c4befcc5d48ca5d6aea.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/8045a0dc2db88042.svg
       upload_time: 2025-09-07T02:41:09.409Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/8045a0dc2db88042.svg
-      upload_time: 2025-09-08T03:56:00.343Z
 d009775dff4f0355d16098d276d84e20d84ed9b64429c3ca2ac0bc82de4ebabb:
   local_path: .aigne/doc-smith/.tmp/assets/d2/d04fb2e90c0d87aedf17736967cdd3c4cd43d9647dc4215d28376beb2ded28c6.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/d009775dff4f0355.svg
       upload_time: 2025-09-07T02:41:09.746Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/d009775dff4f0355.svg
-      upload_time: 2025-09-08T03:56:00.710Z
 a69a16add73521702d150a6b437503e52e38ad468e3c77f2e56ed1ba3d05b6ab:
   local_path: .aigne/doc-smith/.tmp/assets/d2/24e09cc77c5902ad7c2db82c9e1343a8e29b6452a5a9de26a9acf07563b1e64a.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/a69a16add7352170.svg
       upload_time: 2025-09-07T02:41:10.676Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/a69a16add7352170.svg
-      upload_time: 2025-09-08T03:56:00.345Z
 c0010149ea258847e16334eb14aeffcba56b9240c2d120535aabbbe5a00fc680:
   local_path: .aigne/doc-smith/.tmp/assets/d2/478862a2e05b0b6dcfc4388ebd3e1bf15385d25e76ccdc75689a658c063a2416.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/c0010149ea258847.svg
       upload_time: 2025-09-07T02:41:11.199Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/c0010149ea258847.svg
-      upload_time: 2025-09-08T03:56:01.260Z
 232b7ba47e7986c7e208f1ab22360d3c71e38122842d9e9bf97dbe4ce94ffc61:
   local_path: .aigne/doc-smith/.tmp/assets/d2/c2a0ff290b2fedb9112b2d6ddf437acf505222cff9360688fca8cb73512e5a40.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/232b7ba47e7986c7.svg
       upload_time: 2025-09-07T02:41:12.719Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/232b7ba47e7986c7.svg
-      upload_time: 2025-09-08T03:56:01.866Z
 c30a114f4b9d34e027a318e956d032c88e9c5a78b719b7e4384454e5c5a5cc70:
   local_path: .aigne/doc-smith/.tmp/assets/d2/a718b6e368f34b2a8b54e3e4048c6c4fdba06a7937f00dca6c8a9402b464c907.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/c30a114f4b9d34e0.svg
       upload_time: 2025-09-07T02:41:12.725Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/c30a114f4b9d34e0.svg
-      upload_time: 2025-09-08T03:56:01.863Z
     https://staging.docsmith.aigne.io:
       url: https://staging.docsmith.aigne.io/image-bin/uploads/c30a114f4b9d34e0.svg
       upload_time: 2025-09-08T11:10:31.820Z
@@ -199,18 +139,12 @@ c30a114f4b9d34e027a318e956d032c88e9c5a78b719b7e4384454e5c5a5cc70:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/519fc512d2b35a31.svg
       upload_time: 2025-09-07T02:41:14.202Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/519fc512d2b35a31.svg
-      upload_time: 2025-09-08T03:56:02.458Z
 fe5562041c64e27213ef41a7eec1ca1d36fea811437af938671adc0b6eb5378f:
   local_path: .aigne/doc-smith/.tmp/assets/d2/fd473e7982aac4f9ef8cffeeda302fb0283ad6c147be0f2c95bdac43f1e777dc.svg
   sites:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/fe5562041c64e272.svg
       upload_time: 2025-09-07T02:41:14.211Z
-    https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io:
-      url: https://bbqawfllzdt3pahkdsrsone6p3wpxcwp62vlabtawfu.did.abtnet.io/image-bin/uploads/fe5562041c64e272.svg
-      upload_time: 2025-09-08T03:56:02.461Z
 f140351d07c690160e5c174fb95460508fd430941336682f79459277958459d5:
   local_path: .aigne/doc-smith/.tmp/assets/d2/ff6bb4f62e57bbdebe120f9230301b951d9cd5b0ea11177b6ab05b456063ccc9.svg
   sites:
@@ -1444,9 +1378,6 @@ c055a80de6c1120765757fd3ef91ef05718f77beb7d6dfdac41d8e234361a68a:
     https://bbqa6bbb4lvb4oirkwbmqtjtr37unqcpfbc73xrpxoa-192-168-1-38.ip.abtnet.io:
       url: https://bbqa6bbb4lvb4oirkwbmqtjtr37unqcpfbc73xrpxoa.did.abtnet.io/image-bin/uploads/c055a80de6c11207.png
       upload_time: 2025-10-03T12:42:57.172Z
-    https://docsmith.aigne.io:
-      url: https://docsmith.aigne.io/image-bin/uploads/c055a80de6c11207.png
-      upload_time: 2025-10-03T12:46:49.377Z
 37c8b00ba66a78037147959b615de449f2a33ef55948a208b3b840837db9a058:
   local_path: .aigne/doc-smith/.tmp/assets/d2/d633c85283b25e45932b16ef48a95bb2f663bac92cffa0d081809c87d92c97eb.svg
   sites:
@@ -1861,3 +1792,39 @@ e87fcba2227e472141f99b92eb0247965db132079459ce8c83454dde7fc9a6ae:
     https://docsmith.aigne.io:
       url: https://docsmith.aigne.io/image-bin/uploads/3b189fa893cc2120.svg
       upload_time: 2025-10-10T07:40:22.634Z
+7b946c226f73c4c222b37ea23b94b3152932e1712f9d99b78f64c0b93e12bdd9:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/97b496a8d3d5b12b9c8d4d0729110db999a2be33359a1cb70b3f858997ba91a3.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/7b946c226f73c4c2.svg
+      upload_time: 2025-10-11T16:43:05.278Z
+c2a826d21a6eeb8664b88a864e1d5ae3ff68bd9e7dad3c46742f855898441747:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/44d2c5dc7e7fcf4ada941e8c4e444b19d5870dd02d44046dea585bbd77b03e0d.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/c2a826d21a6eeb86.svg
+      upload_time: 2025-10-11T16:43:06.895Z
+605705e827c243bb5402f14ed3b7750f2e6564214a81880df12b857c41935917:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/8ff7639517a76840aaf851b1345b8dae330d4df6f5788b70d2c41febf86e63ab.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/605705e827c243bb.svg
+      upload_time: 2025-10-11T16:43:06.968Z
+71ec3af141d2bcda728a2f7e7a47ca2e2e76a86f54d648832d11f4193d9975f4:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/db5b4787a2dc7655434d00ecf3eb9a25fbf73f93cda2b3f10d4022fd9c2bd16b.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/71ec3af141d2bcda.svg
+      upload_time: 2025-10-11T16:43:08.753Z
+c61907da62788c6ad5b8d89b0fde7f235046b9a6aed309c43be9b0d5b3abb670:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/8f38985e99e81e8edf973a328862e8ec33cc6de1e1382ebbe55c56f64edbd2ad.svg
+  sites:
+    https://docsmith.aigne.io:
+      url: https://docsmith.aigne.io/image-bin/uploads/c61907da62788c6a.svg
+      upload_time: 2025-10-11T16:43:10.182Z
+90c0daa8347df01c8154b6a5b30879b691c4a94b49c970b0480435591603bf55:
+  local_path: assets/screenshots/doc-complete-setup.png
+  sites:
+2ecca52715c0775e59a7bb42ccd3295b2e9484924e36240b4080aca70d8892fe:
+  local_path: .aigne/doc-smith/.tmp/assets/d2/9617241af383811cf6e0e07497abf2d2ba35ac5a69d2f74d655f2716f0da6d44.svg
+  sites:

package/.release-please-manifest.json

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

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.8.12-beta.8](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.12-beta.7...v0.8.12-beta.8) (2025-10-14)
+
+
+### Features
+
+* **media:** support filter and describe and use media files with AI ([#185](https://github.com/AIGNE-io/aigne-doc-smith/issues/185)) ([230271d](https://github.com/AIGNE-io/aigne-doc-smith/commit/230271d70ce2e701be8d6c6e3bdc27f5fadc6cf7))
+
+
+### Bug Fixes
+
+* update evaluate page template ([#182](https://github.com/AIGNE-io/aigne-doc-smith/issues/182)) ([aef2104](https://github.com/AIGNE-io/aigne-doc-smith/commit/aef21049ded2f1ddfe9309dac67d6db1a026d3f6))
+
+## [0.8.12-beta.7](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.12-beta.6...v0.8.12-beta.7) (2025-10-12)
+
+
+### Features
+
+* support retrieve context from repo by AFS ([#175](https://github.com/AIGNE-io/aigne-doc-smith/issues/175)) ([352ce75](https://github.com/AIGNE-io/aigne-doc-smith/commit/352ce751ae9b51a71581793ead7952fb49cda7c4))
+
+
+### Bug Fixes
+
+* disable git based update history within git repo ([#180](https://github.com/AIGNE-io/aigne-doc-smith/issues/180)) ([826b4bd](https://github.com/AIGNE-io/aigne-doc-smith/commit/826b4bdeb5042b2dcd14ce1da975965ad7805347))
+
 ## [0.8.12-beta.6](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.12-beta.5...v0.8.12-beta.6) (2025-10-11)
 
 

package/agents/clear/choose-contents.mjs

@@ -1,5 +1,10 @@
 import { getDocSmithEnvFilePath } from "../../utils/auth-utils.mjs";
-import { getConfigFilePath, getStructurePlanPath, toDisplayPath } from "../../utils/file-utils.mjs";
+import {
+  getConfigFilePath,
+  getMediaDescriptionCachePath,
+  getStructurePlanPath,
+  toDisplayPath,
+} from "../../utils/file-utils.mjs";
 
 const TARGET_METADATA = {
   generatedDocs: {
@@ -36,6 +41,14 @@ const TARGET_METADATA = {
       `Delete appUrl from './${toDisplayPath(getConfigFilePath(workDir))}'.`,
     agent: "clearDeploymentConfig",
   },
+  mediaDescription: {
+    label: "media file descriptions",
+    description: () =>
+      `Delete AI-generated descriptions in './${toDisplayPath(
+        getMediaDescriptionCachePath(),
+      )}' (will regenerate on next generation).`,
+    agent: "clearMediaDescription",
+  },
 };
 
 const TARGET_KEYS = Object.keys(TARGET_METADATA);

package/agents/clear/clear-media-description.mjs

@@ -0,0 +1,129 @@
+import { existsSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import chalk from "chalk";
+import { parse, stringify } from "yaml";
+import { getMediaDescriptionCachePath } from "../../utils/file-utils.mjs";
+
+export default async function clearMediaDescription(_input = {}, options = {}) {
+  const cacheFilePath = getMediaDescriptionCachePath();
+
+  // Check if the cache file exists
+  if (!existsSync(cacheFilePath)) {
+    return {
+      message: "No media descriptions found to clear",
+    };
+  }
+
+  try {
+    // Read existing cache
+    const cacheContent = await readFile(cacheFilePath, "utf8");
+    const parsedCache = parse(cacheContent);
+    const cache = parsedCache?.descriptions || {};
+
+    // Get all media files from cache
+    const mediaHashes = Object.keys(cache);
+
+    if (mediaHashes.length === 0) {
+      return {
+        message: "No media descriptions found to clear",
+      };
+    }
+
+    // Build choices from cache - extract filename from path
+    const choices = mediaHashes.map((hash) => {
+      const mediaPath = cache[hash]?.path || "unknown";
+      const filename = path.basename(mediaPath);
+      const description = cache[hash]?.description || "";
+      const truncatedDesc =
+        description.length > 80 ? `${description.slice(0, 80)}...` : description;
+
+      return {
+        name: filename,
+        description: truncatedDesc,
+        value: hash,
+        checked: false,
+      };
+    });
+
+    // Add an option to clear all media descriptions
+    choices.push({
+      name: chalk.red("🗑️  Clear ALL media descriptions"),
+      value: "__ALL__",
+      checked: false,
+    });
+
+    let selectedHashes = [];
+
+    if (options?.prompts?.checkbox) {
+      selectedHashes = await options.prompts.checkbox({
+        message: "Select media files to clear descriptions:",
+        choices,
+        validate: (answer) => (answer.length > 0 ? true : "Please select at least one item."),
+      });
+    } else {
+      // If no prompts available, clear all
+      selectedHashes = ["__ALL__"];
+    }
+
+    if (selectedHashes.length === 0) {
+      return {
+        message: "No media files selected for clearing descriptions",
+      };
+    }
+
+    const results = [];
+    let clearedCount = 0;
+
+    if (selectedHashes.includes("__ALL__")) {
+      // Clear all media descriptions
+      await writeFile(
+        cacheFilePath,
+        stringify({
+          descriptions: {},
+          lastUpdated: new Date().toISOString(),
+        }),
+      );
+      results.push(`Cleared descriptions for all media files (${mediaHashes.length} files)`);
+      clearedCount = mediaHashes.length;
+    } else {
+      // Clear descriptions for selected files
+      const updatedCache = { ...cache };
+
+      for (const hash of selectedHashes) {
+        if (updatedCache[hash]) {
+          const filename = path.basename(updatedCache[hash].path);
+          delete updatedCache[hash];
+          results.push(`Cleared description for ${chalk.cyan(filename)}`);
+          clearedCount++;
+        }
+      }
+
+      await writeFile(
+        cacheFilePath,
+        stringify({
+          descriptions: updatedCache,
+          lastUpdated: new Date().toISOString(),
+        }),
+      );
+    }
+
+    const header = `✨ Successfully cleared media descriptions`;
+    const detailLines = results.join("\n");
+
+    const message = [header, "", detailLines, ""].filter(Boolean).join("\n");
+
+    return {
+      message,
+      clearedCount,
+    };
+  } catch (error) {
+    return {
+      message: `Error clearing media descriptions: ${error.message}`,
+      error: true,
+    };
+  }
+}
+
+clearMediaDescription.taskTitle = "Clear media file descriptions";
+clearMediaDescription.description = "Clear AI-generated descriptions for media files";

package/agents/clear/index.yaml

@@ -21,4 +21,6 @@ input_schema:
           - documentStructure
           - generatedDocs
           - documentConfig
-          - authTokens
+          - authTokens
+          - deploymentConfig
+          - mediaDescription