Description
The AI knowledge base currently sources its information from JSDoc comments and the learning guides defined in learn/tree.json. This provides a strong foundation but omits a valuable, often more current, source of information: the blog posts located in learn/blog.
This ticket proposes enhancing the knowledge base by including these blog posts in the AI's searchable content.
The Plan
Update learn/tree.json:
- Dynamically read the contents of the
learn/blog directory.
- For each blog post, add a corresponding entry to the
learn/tree.json file.
- These new entries should be flagged with
"hidden": true to prevent them from appearing in the main navigation UI of the learning center, while still making them available for parsing.
Verify Knowledge Base Integration:
- Ensure the
createKnowledgeBase.mjs script correctly parses these new, hidden entries from the updated tree.json.
- After rebuilding the knowledge base (
npm run ai:build-kb), confirm that blog content is being embedded and can be retrieved via queries.
Acceptance Criteria
- A script or manual process is in place to add blog posts from
learn/blog to learn/tree.json with the "hidden": true flag.
- The
createKnowledgeBase.mjs script successfully processes the hidden blog entries.
- Queries made via
npm run ai:query can return blog posts as relevant source files.
Description
The AI knowledge base currently sources its information from JSDoc comments and the learning guides defined in
learn/tree.json. This provides a strong foundation but omits a valuable, often more current, source of information: the blog posts located inlearn/blog.This ticket proposes enhancing the knowledge base by including these blog posts in the AI's searchable content.
The Plan
Update
learn/tree.json:learn/blogdirectory.learn/tree.jsonfile."hidden": trueto prevent them from appearing in the main navigation UI of the learning center, while still making them available for parsing.Verify Knowledge Base Integration:
createKnowledgeBase.mjsscript correctly parses these new, hidden entries from the updatedtree.json.npm run ai:build-kb), confirm that blog content is being embedded and can be retrieved via queries.Acceptance Criteria
learn/blogtolearn/tree.jsonwith the"hidden": trueflag.createKnowledgeBase.mjsscript successfully processes the hidden blog entries.npm run ai:querycan return blog posts as relevant source files.