Skip to content

Commit e15f68b

Browse files
committed
feat(ai-markmap-agent): update output naming and add version history
- Change filename template to neetcode_ontology_agent_evolved_{lang} - Add outputs/versions/ directory for version control (v1, v2, ...) - Auto-increment version numbers on each run - Update DESIGN_V4.md, README.md, README_zh-TW.md with new naming
1 parent 54a746f commit e15f68b

File tree

7 files changed

+904
-20
lines changed

7 files changed

+904
-20
lines changed

tools/ai-markmap-agent/README.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -343,11 +343,48 @@ ai-markmap-agent/
343343
│ ├── config_loader.py # Configuration loading
344344
│ └── ...
345345
├── main.py # Entry point
346+
├── outputs/
347+
│ ├── versions/ # Version history (v1, v2, ...)
348+
│ ├── debug/ # Debug logs per run
349+
│ └── intermediate/ # Intermediate outputs
346350
└── README.md
347351
```
348352

349353
---
350354

355+
## Output
356+
357+
### Output Files
358+
359+
Final Markmaps are saved to:
360+
- **Markdown**: `docs/mindmaps/`
361+
- **HTML**: `docs/pages/mindmaps/`
362+
363+
Filename format: `neetcode_ontology_agent_evolved_{lang}.{ext}`
364+
365+
Examples:
366+
- `neetcode_ontology_agent_evolved_en.md`
367+
- `neetcode_ontology_agent_evolved_zh-TW.html`
368+
369+
### Version History
370+
371+
Each run saves a versioned copy to `outputs/versions/`:
372+
373+
```
374+
outputs/versions/
375+
├── v1/
376+
│ ├── neetcode_ontology_agent_evolved_en.md
377+
│ └── neetcode_ontology_agent_evolved_zh-TW.md
378+
├── v2/
379+
│ └── ...
380+
└── v3/
381+
└── ...
382+
```
383+
384+
Version numbers auto-increment: `v1`, `v2`, `v3`, ...
385+
386+
---
387+
351388
## Module Responsibilities
352389

353390
| Module | Responsibility |

tools/ai-markmap-agent/README_zh-TW.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -343,11 +343,48 @@ ai-markmap-agent/
343343
│ ├── config_loader.py # 配置載入
344344
│ └── ...
345345
├── main.py # 程式入口
346+
├── outputs/
347+
│ ├── versions/ # 版本歷史(v1, v2, ...)
348+
│ ├── debug/ # 每次執行的除錯日誌
349+
│ └── intermediate/ # 中間產出
346350
└── README.md
347351
```
348352

349353
---
350354

355+
## 輸出
356+
357+
### 輸出檔案
358+
359+
最終 Markmap 儲存位置:
360+
- **Markdown**`docs/mindmaps/`
361+
- **HTML**`docs/pages/mindmaps/`
362+
363+
檔名格式:`neetcode_ontology_agent_evolved_{lang}.{ext}`
364+
365+
範例:
366+
- `neetcode_ontology_agent_evolved_en.md`
367+
- `neetcode_ontology_agent_evolved_zh-TW.html`
368+
369+
### 版本歷史
370+
371+
每次執行會在 `outputs/versions/` 儲存版本備份:
372+
373+
```
374+
outputs/versions/
375+
├── v1/
376+
│ ├── neetcode_ontology_agent_evolved_en.md
377+
│ └── neetcode_ontology_agent_evolved_zh-TW.md
378+
├── v2/
379+
│ └── ...
380+
└── v3/
381+
└── ...
382+
```
383+
384+
版本號自動遞增:`v1``v2``v3`...
385+
386+
---
387+
351388
## 模組職責
352389

353390
| 模組 | 職責 |

tools/ai-markmap-agent/config/config.yaml

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -309,6 +309,12 @@ output:
309309
save_intermediate: true
310310
intermediate_dir: "outputs/intermediate"
311311

312+
# Version history for tracking changes
313+
versioning:
314+
enabled: true
315+
directory: "outputs/versions"
316+
# Auto-increment: v1, v2, v3, ...
317+
312318
final_dirs:
313319
markdown: "../../docs/mindmaps"
314320
html: "../../docs/pages/mindmaps"
@@ -327,9 +333,9 @@ output:
327333
source_lang: "en"
328334
translator_model: "gpt-4o"
329335

330-
# Output template: {prefix}_ontology_evolved_{lang}.{ext}
331-
# Example: neetcode_ontology_evolved_en.md
332-
template: "{prefix}_ontology_evolved_{lang}"
336+
# Output template: {prefix}_ontology_agent_evolved_{lang}.{ext}
337+
# Example: neetcode_ontology_agent_evolved_en.md
338+
template: "{prefix}_ontology_agent_evolved_{lang}"
333339

334340
html:
335341
template: "templates/markmap.html"

tools/ai-markmap-agent/docs/DESIGN_V4.md

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,7 @@ Sequential batches: 3(固定,不隨 N 增加)
171171
│ │ 保留原有的優秀結構,只應用清單中的改動。 │ │
172172
│ │ │ │
173173
│ │ 輸出: │ │
174-
│ │ • neetcode_ontology_evolved_en.md │ │
174+
│ │ • neetcode_ontology_agent_evolved_en.md │ │
175175
│ │ │ │
176176
│ └──────────────────────────┬──────────────────────────────────────────┘ │
177177
│ │ │
@@ -495,8 +495,8 @@ input:
495495
output:
496496
# Output filename
497497
naming:
498-
template: "neetcode_ontology_evolved_{lang}"
499-
# Produces: neetcode_ontology_evolved_en.md
498+
template: "neetcode_ontology_agent_evolved_{lang}"
499+
# Produces: neetcode_ontology_agent_evolved_en.md
500500

501501
# -----------------------------------------------------------------------------
502502
# Expert Configuration (Scalable)
@@ -809,15 +809,15 @@ Phase 3: Writing (1 API call)
809809
════════════════════════════════════════════════════════════════
810810
811811
Applying 7 improvements to baseline...
812-
✓ Output: neetcode_ontology_evolved_en.md
812+
✓ Output: neetcode_ontology_agent_evolved_en.md
813813
814814
════════════════════════════════════════════════════════════════
815815
Phase 4: Post-Processing (Code)
816816
════════════════════════════════════════════════════════════════
817817
818818
✓ Link validation: 47/47 valid
819819
✓ Format fixing: 2 replacements
820-
✓ Translation: neetcode_ontology_evolved_zh-TW.md (1 API call)
820+
✓ Translation: neetcode_ontology_agent_evolved_zh-TW.md (1 API call)
821821
✓ HTML generation: 2 files
822822
823823
════════════════════════════════════════════════════════════════
@@ -830,10 +830,14 @@ Summary:
830830
- Improvements applied: 7
831831
832832
Output files:
833-
docs/mindmaps/neetcode_ontology_evolved_en.md
834-
docs/mindmaps/neetcode_ontology_evolved_zh-TW.md
835-
docs/pages/mindmaps/neetcode_ontology_evolved_en.html
836-
docs/pages/mindmaps/neetcode_ontology_evolved_zh-TW.html
833+
docs/mindmaps/neetcode_ontology_agent_evolved_en.md
834+
docs/mindmaps/neetcode_ontology_agent_evolved_zh-TW.md
835+
docs/pages/mindmaps/neetcode_ontology_agent_evolved_en.html
836+
docs/pages/mindmaps/neetcode_ontology_agent_evolved_zh-TW.html
837+
838+
Version history:
839+
outputs/versions/v1/neetcode_ontology_agent_evolved_en.md
840+
outputs/versions/v1/neetcode_ontology_agent_evolved_zh-TW.md
837841
```
838842

839843
---

0 commit comments

Comments
 (0)