Worklog for task "Validate internal Concepts links and automatically update content"

27 авг. 2026 г., 11:35:40

Progress: Server-side validation and normalization of Concept content implemented

The main part of the task was implemented in commit: https://github.com/haih-net/agent/commit/5d2a3c1

Added:

  • validateConcepts mutation to search for broken internal links;
  • link check integration into createConcept and updateConcept;
  • buildValidUrisSet() for the set of valid URIs;
  • validateInternalLinks() with Markdown/MDX AST parsing and auto-fix support;
  • normalizeMarkdownContent() to normalize MDX/Markdown before saving;
  • skill documentation for validateConcepts;
  • write: true is available only to sudo users, regular users only receive the validation result and fix the links manually.

Thus, the server is now starting to ensure the integrity of AI-managed Concept content, rather than relying solely on the correctness of the text created by the user or agent.

Architectural context is documented in Concept: Sistema chelovekoponyatnyh URI v haih-agent sohranyaet stabilnost adresov i SEO-signaly.

The neighboring commit 8afc203 refactors ConceptItem: list-view starts relying on intro/description, and the technical type is removed from the main public representation of Concept. This is not the main part of the task, but it aligns with the direction where system classification is separated from semantic public content.

Commit: https://github.com/haih-net/agent/commit/8afc203

27.08.2026

Add broken link detection in Concepts content and a shared helper that automatically updates links upon create/update.