ai-forge-cli 3.0.2__tar.gz → 3.0.4__tar.gz

{ai_forge_cli-3.0.2/src/ai_forge_cli.egg-info → ai_forge_cli-3.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-forge-cli
-Version: 3.0.2
+Version: 3.0.4
 Summary: Forge V4 architecture context CLI
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -36,6 +36,8 @@ scoped context, validation, and audit artifacts to the active skill.
 - `forge crawl`: extract the merged V4 model from central files and code annotations
 - `forge context`: render scoped context for a system, flow, container, entity,
   component, operation, or data shape
+- `forge knowledge`: list supporting Markdown knowledge docs attached to Forge
+  refs such as containers, flows, entities, components, and operations
 - `forge audit`: generate a self-contained architecture audit dashboard
 
 ## What Forge Is
@@ -44,6 +46,8 @@ scoped context, validation, and audit artifacts to the active skill.
 - a skills-first workflow for moving from business discovery to one thin build slice
 - a scoped context generator for build, review, and security tasks
 - an audit artifact generator for human review
+- a lightweight index for repo-native delivery knowledge such as runbooks,
+  testing notes, security notes, operations notes, and domain glossaries
 
 ## What Forge Is Not
 

{ai_forge_cli-3.0.2 → ai_forge_cli-3.0.4}/README.md

@@ -21,6 +21,8 @@ scoped context, validation, and audit artifacts to the active skill.
 - `forge crawl`: extract the merged V4 model from central files and code annotations
 - `forge context`: render scoped context for a system, flow, container, entity,
   component, operation, or data shape
+- `forge knowledge`: list supporting Markdown knowledge docs attached to Forge
+  refs such as containers, flows, entities, components, and operations
 - `forge audit`: generate a self-contained architecture audit dashboard
 
 ## What Forge Is
@@ -29,6 +31,8 @@ scoped context, validation, and audit artifacts to the active skill.
 - a skills-first workflow for moving from business discovery to one thin build slice
 - a scoped context generator for build, review, and security tasks
 - an audit artifact generator for human review
+- a lightweight index for repo-native delivery knowledge such as runbooks,
+  testing notes, security notes, operations notes, and domain glossaries
 
 ## What Forge Is Not
 

{ai_forge_cli-3.0.2 → ai_forge_cli-3.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-forge-cli"
-version = "3.0.2"
+version = "3.0.4"
 description = "Forge V4 architecture context CLI"
 readme = "README.md"
 requires-python = ">=3.11"

{ai_forge_cli-3.0.2 → ai_forge_cli-3.0.4/src/ai_forge_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-forge-cli
-Version: 3.0.2
+Version: 3.0.4
 Summary: Forge V4 architecture context CLI
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -36,6 +36,8 @@ scoped context, validation, and audit artifacts to the active skill.
 - `forge crawl`: extract the merged V4 model from central files and code annotations
 - `forge context`: render scoped context for a system, flow, container, entity,
   component, operation, or data shape
+- `forge knowledge`: list supporting Markdown knowledge docs attached to Forge
+  refs such as containers, flows, entities, components, and operations
 - `forge audit`: generate a self-contained architecture audit dashboard
 
 ## What Forge Is
@@ -44,6 +46,8 @@ scoped context, validation, and audit artifacts to the active skill.
 - a skills-first workflow for moving from business discovery to one thin build slice
 - a scoped context generator for build, review, and security tasks
 - an audit artifact generator for human review
+- a lightweight index for repo-native delivery knowledge such as runbooks,
+  testing notes, security notes, operations notes, and domain glossaries
 
 ## What Forge Is Not
 

{ai_forge_cli-3.0.2 → ai_forge_cli-3.0.4}/src/ai_forge_cli.egg-info/SOURCES.txt

@@ -23,6 +23,7 @@ src/cli/commands/base.py
 src/cli/commands/context.py
 src/cli/commands/crawl.py
 src/cli/commands/init.py
+src/cli/commands/knowledge.py
 src/cli/resources/FRAMEWORK_V4.md
 src/cli/resources/SCHEMA_REFERENCE_V4.md
 src/cli/resources/skills/forge-build/SKILL.md
@@ -31,8 +32,11 @@ src/cli/resources/skills/forge-business/SKILL.md
 src/cli/resources/skills/forge-business/agents/openai.yaml
 src/cli/resources/skills/forge-hydrate/SKILL.md
 src/cli/resources/skills/forge-hydrate/agents/openai.yaml
+src/cli/resources/skills/forge-orchestrator/SKILL.md
+src/cli/resources/skills/forge-orchestrator/agents/openai.yaml
 src/cli/resources/skills/forge-review/SKILL.md
 src/cli/resources/skills/forge-review/agents/openai.yaml
+src/cli/resources/skills/forge-schema/FRAMEWORK_REUSE_DRAFT.md
 src/cli/resources/skills/forge-schema/SKILL.md
 src/cli/resources/skills/forge-schema/agents/openai.yaml
 src/cli/resources/skills/forge-security/SKILL.md

{ai_forge_cli-3.0.2 → ai_forge_cli-3.0.4}/src/cli/assets/audit_template.html

@@ -598,6 +598,247 @@
     .decision-field li + li {
       margin-top: 2px;
     }
+    .knowledge-type-grid {
+      display: grid;
+      grid-auto-flow: column;
+      grid-auto-columns: minmax(86px, 1fr);
+      gap: 8px;
+      margin-bottom: 18px;
+      overflow-x: auto;
+      padding-bottom: 2px;
+    }
+    .knowledge-type-grid .card {
+      min-width: 0;
+      padding: 10px 12px;
+      border-radius: 8px;
+    }
+    .knowledge-type-grid .card h3 {
+      margin: 0 0 6px;
+      font-size: 13px;
+      line-height: 1.15;
+      overflow-wrap: anywhere;
+    }
+    .knowledge-type-grid .card p {
+      margin: 0;
+      font-size: 12px;
+      line-height: 1.15;
+    }
+    .related-knowledge-block {
+      display: grid;
+      gap: 14px;
+    }
+    .knowledge-doc-grid {
+      display: grid;
+      gap: 14px;
+    }
+    .knowledge-type-group {
+      display: grid;
+      gap: 10px;
+      min-width: 0;
+    }
+    .knowledge-type-group-summary {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) auto 18px;
+      gap: 10px;
+      align-items: center;
+      padding: 8px 12px;
+      border: 1px solid var(--border);
+      border-radius: 8px;
+      background: var(--panel-alt);
+      cursor: pointer;
+      list-style: none;
+    }
+    .knowledge-type-group-summary::-webkit-details-marker {
+      display: none;
+    }
+    .knowledge-type-group-summary::marker {
+      content: "";
+    }
+    .knowledge-type-group-summary span:first-child {
+      color: var(--text);
+      font-size: 13px;
+      font-weight: 700;
+    }
+    .knowledge-type-group-summary strong {
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      min-width: 24px;
+      min-height: 20px;
+      padding: 0 7px;
+      border: 1px solid var(--border);
+      border-radius: 999px;
+      background: var(--panel);
+      color: var(--muted);
+      font-size: 12px;
+      line-height: 1;
+    }
+    .knowledge-type-group-docs {
+      display: grid;
+      gap: 10px;
+    }
+    .related-knowledge-block {
+      margin-top: 18px;
+    }
+    .knowledge-inline-header {
+      margin-bottom: 0;
+    }
+    .knowledge-doc-card {
+      padding: 0;
+      overflow: hidden;
+      min-width: 0;
+    }
+    .knowledge-doc-summary {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) minmax(260px, auto) 18px;
+      gap: 4px 14px;
+      align-items: start;
+      padding: 12px 14px;
+      background: var(--panel);
+      cursor: pointer;
+      list-style: none;
+      min-width: 0;
+    }
+    .knowledge-doc-summary::-webkit-details-marker {
+      display: none;
+    }
+    .knowledge-doc-summary::marker {
+      content: "";
+    }
+    .knowledge-doc-summary:hover {
+      background: var(--hover);
+    }
+    .knowledge-doc-identity,
+    .knowledge-doc-meta {
+      min-width: 0;
+    }
+    .knowledge-doc-identity {
+      display: contents;
+    }
+    .knowledge-doc-summary h4 {
+      grid-column: 1;
+      grid-row: 1;
+      margin: 0;
+      font-size: 14px;
+      line-height: 1.15;
+    }
+    .knowledge-doc-summary span {
+      color: var(--muted);
+      font-size: 12px;
+      line-height: 1.15;
+    }
+    .knowledge-doc-meta {
+      display: grid;
+      grid-template-columns: auto auto;
+      align-items: start;
+      justify-content: end;
+      gap: 4px 6px;
+      grid-column: 2;
+      grid-row: 1;
+      color: var(--muted);
+      font-size: 12px;
+      text-align: left;
+    }
+    .knowledge-doc-meta strong,
+    .knowledge-doc-meta em {
+      display: inline-flex;
+      align-items: center;
+      min-height: 20px;
+      padding: 0 7px;
+      border: 1px solid var(--border);
+      border-radius: 999px;
+      background: var(--panel-alt);
+      font-style: normal;
+      font-weight: 600;
+    }
+    .knowledge-doc-meta-row {
+      grid-column: 1;
+      display: grid;
+      grid-template-columns: 42px minmax(0, 1fr);
+      gap: 8px;
+      align-items: baseline;
+      min-width: 0;
+      text-align: left;
+    }
+    .knowledge-doc-identity .knowledge-doc-meta-row:nth-of-type(1) {
+      grid-row: 2;
+    }
+    .knowledge-doc-identity .knowledge-doc-meta-row:nth-of-type(2) {
+      grid-row: 3;
+    }
+    .knowledge-doc-meta-row span {
+      color: var(--subtle);
+      font-size: 11px;
+      font-weight: 700;
+      line-height: 1.15;
+      text-transform: uppercase;
+    }
+    .knowledge-doc-meta-row p {
+      margin: 0;
+      color: var(--muted);
+      font-size: 12px;
+      line-height: 1.15;
+    }
+    .knowledge-doc-file {
+      grid-column: 2;
+      grid-row: 3;
+      justify-self: end;
+      align-self: baseline;
+      color: var(--muted);
+      font-size: 12px;
+      line-height: 1.15;
+      max-width: 420px;
+      overflow-wrap: anywhere;
+      text-align: right;
+    }
+    .knowledge-doc-summary .entity-shape-chevron {
+      grid-column: 3;
+      grid-row: 1;
+      margin-top: 2px;
+    }
+    .knowledge-doc-summary .entity-shape-chevron::before,
+    .knowledge-type-group-summary .entity-shape-chevron::before {
+      content: "▶";
+    }
+    .knowledge-doc-card[open] > .knowledge-doc-summary .entity-shape-chevron::before,
+    .knowledge-type-group[open] > .knowledge-type-group-summary .entity-shape-chevron::before {
+      content: "▼";
+    }
+    .knowledge-doc-body {
+      padding: 0 18px 16px;
+      color: var(--text);
+      border-top: 1px solid var(--border);
+    }
+    .knowledge-doc-body h1,
+    .knowledge-doc-body h2,
+    .knowledge-doc-body h3,
+    .knowledge-doc-body h4 {
+      margin: 16px 0 8px;
+      font-size: 15px;
+      line-height: 1.25;
+    }
+    .knowledge-doc-body p,
+    .knowledge-doc-body li {
+      color: var(--muted);
+      font-size: 13px;
+      line-height: 1.5;
+    }
+    .knowledge-doc-body p {
+      margin: 8px 0 0;
+    }
+    .knowledge-doc-body ul {
+      margin: 8px 0 0;
+      padding-left: 20px;
+    }
+    .knowledge-doc-body pre {
+      margin: 10px 0 0;
+      padding: 12px;
+      border: 1px solid var(--border);
+      border-radius: 6px;
+      background: var(--panel-alt);
+      overflow-x: auto;
+      font-size: 12px;
+    }
     .annotation-filter {
       display: flex;
       flex-wrap: wrap;
@@ -2314,6 +2555,24 @@
       .record-meta {
         text-align: left;
       }
+      .knowledge-doc-summary {
+        grid-template-columns: minmax(0, 1fr) 18px;
+      }
+      .knowledge-doc-meta {
+        grid-column: 1 / -1;
+        justify-content: start;
+        margin-top: 6px;
+      }
+      .knowledge-doc-file {
+        grid-column: 1 / -1;
+        grid-row: auto;
+        justify-self: start;
+        max-width: none;
+        text-align: left;
+      }
+      .knowledge-doc-summary .entity-shape-chevron {
+        grid-column: 2;
+      }
       .runtime-container-header {
         grid-template-columns: minmax(0, 1fr);
       }
@@ -2346,6 +2605,7 @@
     <button class="tab" data-group="Flows">Flows</button>
     <button class="tab" data-group="Runtime">Runtime</button>
     <button class="tab" data-group="Data">Data</button>
+    <button class="tab" data-group="Knowledge">Knowledge</button>
     <button class="tab" data-group="Validation">Validation</button>
     <button class="tab" data-group="Quality Assurance">Quality Assurance</button>
   </nav>
@@ -2369,6 +2629,9 @@
           </div>
           <div data-slot="data-body">__DATA_BODY__</div>
         </section>
+        <section class="section" id="knowledge-overview" data-group="Knowledge">
+          <div data-slot="knowledge-body">__KNOWLEDGE_BODY__</div>
+        </section>
         <section class="section" id="verticals-overview" data-group="Validation">
           <div data-slot="verticals-body">__VERTICALS_BODY__</div>
         </section>
@@ -2422,6 +2685,7 @@
       System: 'system-overview',
       Runtime: 'runtime-overview',
       Data: 'data-overview',
+      Knowledge: 'knowledge-overview',
       Validation: 'verticals-overview',
       'Quality Assurance': 'quality-assurance-overview',
     };

{ai_forge_cli-3.0.2 → ai_forge_cli-3.0.4}/src/cli/commands/__init__.py

@@ -2,5 +2,6 @@ from cli.commands.audit import register_audit
 from cli.commands.context import register_context
 from cli.commands.crawl import register_crawl
 from cli.commands.init import register_init
+from cli.commands.knowledge import register_knowledge
 
-__all__ = ["register_context", "register_init", "register_audit", "register_crawl"]
+__all__ = ["register_context", "register_init", "register_audit", "register_crawl", "register_knowledge"]

{ai_forge_cli-3.0.2 → ai_forge_cli-3.0.4}/src/cli/commands/audit.py

@@ -5,6 +5,7 @@ import errno
 import hashlib
 import json
 import platform
+import re
 import subprocess
 from argparse import Namespace
 from html import escape
@@ -134,6 +135,7 @@ def render_v4_audit_html(result: ForgeCrawlResult) -> str:
         {"id": "system-overview", "group": "System", "label": "System"},
         {"id": "runtime-overview", "group": "Runtime", "label": "Runtime Overview"},
         {"id": "data-overview", "group": "Data", "label": "Entities & Data"},
+        {"id": "knowledge-overview", "group": "Knowledge", "label": "Knowledge"},
         {"id": "verticals-overview", "group": "Validation", "label": "Findings"},
         {"id": "quality-assurance-overview", "group": "Quality Assurance", "label": "Quality Assurance"},
     ]
@@ -147,7 +149,7 @@ def render_v4_audit_html(result: ForgeCrawlResult) -> str:
                 "Flows",
                 f"Flow: {flow['id']}",
                 "Container-level flow across runtime boundaries.",
-                _render_v4_flow_section(flow, model),
+                _render_v4_flow_section(flow, model) + _render_related_knowledge(model, [f"flow:{flow['id']}"]),
                 str(system.get("id", "forge")),
                 with_header=False,
             )
@@ -161,7 +163,7 @@ def render_v4_audit_html(result: ForgeCrawlResult) -> str:
                 "Runtime",
                 f"Container: {container['id']}",
                 "Source-root components, data shapes, and extracted operations.",
-                _render_v4_container_section(container),
+                _render_v4_container_section(container) + _render_related_knowledge(model, [f"container:{container['id']}"]),
                 str(system.get("id", "forge")),
                 with_header=False,
             )
@@ -175,7 +177,7 @@ def render_v4_audit_html(result: ForgeCrawlResult) -> str:
                 "Data",
                 f"Entity: {entity['id']}",
                 "Business state, canonical shape, ownership, and persistence.",
-                _render_v4_entity_section(entity, model),
+                _render_v4_entity_section(entity, model) + _render_related_knowledge(model, [f"entity:{entity['id']}"]),
                 str(system.get("id", "forge")),
                 with_header=False,
             )
@@ -215,6 +217,7 @@ def render_v4_audit_html(result: ForgeCrawlResult) -> str:
         "__SYSTEM_BODY__": _render_v4_system_section(model),
         "__RUNTIME_BODY__": _render_v4_runtime_section(model),
         "__DATA_BODY__": _render_v4_data_section(model),
+        "__KNOWLEDGE_BODY__": _render_v4_knowledge_section(model),
         "__VERTICALS_BODY__": _render_v4_findings_overview(model),
         "__QUALITY_ASSURANCE_BODY__": _render_quality_assurance_overview(str(system.get("id", "forge"))),
         "__DEPLOYMENT_BODY__": "",
@@ -238,6 +241,7 @@ def _render_v4_overview_section(model: dict[str, object]) -> str:
         ("System", str(system.get("id", "forge")), "system-overview"),
         ("Containers", str(summary.get("containers", 0)), "runtime-overview"),
         ("Flows", str(summary.get("container_flows", 0)), "flow-" + str(model["container_flows"][0]["id"]) if model["container_flows"] else "runtime-overview"),
+        ("Knowledge", str(summary.get("knowledge", 0)), "knowledge-overview"),
         ("Findings", str(summary.get("validation_findings", 0)), "verticals-overview"),
     ]
     summary_html = "".join(
@@ -336,6 +340,217 @@ def _render_v4_data_section(model: dict[str, object]) -> str:
     return '<div class="record-list">' + "".join(rows) + "</div>"
 
 
+def _render_v4_knowledge_section(model: dict[str, object]) -> str:
+    knowledge = [doc for doc in model.get("knowledge", []) if isinstance(doc, dict)]
+    if not knowledge:
+        return (
+            _section_header(
+                "knowledge-overview",
+                f"{model['system'].get('id', 'forge')} / Knowledge",
+                "Knowledge",
+                "Supporting Markdown docs attached to Forge objects.",
+            )
+            + '<div class="card"><p>No knowledge docs found under <code>forge/knowledge</code>.</p></div>'
+        )
+    types = sorted({str(doc.get("type", "unknown") or "unknown") for doc in knowledge})
+    summary_cards = "".join(
+        '<div class="card card-defined">'
+        f'<h3>{escape(type_)}</h3>'
+        f'<p>{sum(1 for doc in knowledge if str(doc.get("type", "unknown") or "unknown") == type_)}</p>'
+        '</div>'
+        for type_ in types
+    )
+    docs = _knowledge_doc_groups(knowledge, expanded=True)
+    return (
+        _section_header(
+            "knowledge-overview",
+            f"{model['system'].get('id', 'forge')} / Knowledge",
+            "Knowledge",
+            "Runbooks, test suites, security notes, operations notes, glossaries, and guides attached to Forge refs.",
+        )
+        + f'<div class="knowledge-type-grid">{summary_cards}</div>'
+        + f'<div class="knowledge-doc-grid">{docs}</div>'
+    )
+
+
+def _render_related_knowledge(model: dict[str, object], refs: list[str]) -> str:
+    knowledge = _knowledge_for_refs(model, refs)
+    if not knowledge:
+        return ""
+    return (
+        '<section class="related-knowledge-block">'
+        '<div class="section-header knowledge-inline-header">'
+        '<h3 class="section-title">Related Knowledge</h3>'
+        '<p class="section-description">Supporting docs attached to this Forge object.</p>'
+        '</div>'
+        f'{_knowledge_cards(knowledge, expanded=False)}'
+        '</section>'
+    )
+
+
+def _knowledge_for_refs(model: dict[str, object], refs: list[str]) -> list[dict[str, object]]:
+    wanted = set(refs)
+    return [
+        doc
+        for doc in model.get("knowledge", [])
+        if isinstance(doc, dict) and wanted.intersection(doc.get("refs", []))
+    ]
+
+
+def _knowledge_doc_groups(knowledge: list[dict[str, object]], *, expanded: bool) -> str:
+    grouped: dict[str, list[dict[str, object]]] = {}
+    for doc in knowledge:
+        type_ = str(doc.get("type", "unknown") or "unknown")
+        grouped.setdefault(type_, []).append(doc)
+
+    blocks: list[str] = []
+    for type_ in sorted(grouped):
+        docs = grouped[type_]
+        if len(docs) == 1:
+            blocks.append(_knowledge_cards(docs, expanded=expanded))
+            continue
+        open_attr = " open" if expanded else ""
+        blocks.append(
+            f'<details class="knowledge-type-group"{open_attr}>'
+            '<summary class="knowledge-type-group-summary">'
+            f'<span>{escape(type_)}</span>'
+            f'<strong>{len(docs)}</strong>'
+            '<span class="entity-shape-chevron" aria-hidden="true"></span>'
+            '</summary>'
+            '<div class="knowledge-type-group-docs">'
+            f'{_knowledge_cards(docs, expanded=expanded)}'
+            '</div>'
+            '</details>'
+        )
+    return "".join(blocks)
+
+
+def _knowledge_cards(knowledge: list[dict[str, object]], *, expanded: bool) -> str:
+    if not knowledge:
+        return "<p>No related knowledge docs.</p>"
+    cards: list[str] = []
+    for doc in sorted(knowledge, key=lambda item: str(item.get("title") or item.get("path", "")).casefold()):
+        type_ = str(doc.get("type", "") or "unknown")
+        status = str(doc.get("status", "") or "")
+        refs = doc.get("refs", [])
+        tags = doc.get("tags", [])
+        body = str(doc.get("body") or doc.get("excerpt") or "").strip()
+        body_html = _markdown_to_html(body)
+        summary = (
+            '<div class="knowledge-doc-identity">'
+            f'<h4>{escape(str(doc.get("title") or doc.get("path", "")))}</h4>'
+            f'{_knowledge_doc_meta_row("Refs", refs)}'
+            f'{_knowledge_doc_meta_row("Tags", tags)}'
+            '</div>'
+            '<div class="knowledge-doc-meta">'
+            f'<strong>{escape(type_)}</strong>'
+            f'{f"<em>{escape(status)}</em>" if status else ""}'
+            '</div>'
+            f'<span class="knowledge-doc-file">{escape(str(doc.get("path", "")))}</span>'
+            '<span class="entity-shape-chevron" aria-hidden="true"></span>'
+        )
+        open_attr = " open" if expanded else ""
+        cards.append(
+            f'<details class="card knowledge-doc-card"{open_attr}>'
+            '<summary class="knowledge-doc-summary">'
+            f'{summary}'
+            '</summary>'
+            f'<article class="knowledge-doc-body">{body_html}</article>'
+            '</details>'
+        )
+    return "".join(cards)
+
+
+def _knowledge_doc_meta_row(label: str, values: object) -> str:
+    if not isinstance(values, list):
+        return ""
+    value_text = ", ".join(
+        str(value)
+        for value in values
+        if str(value).strip()
+    )
+    if not value_text:
+        return ""
+    return (
+        '<div class="knowledge-doc-meta-row">'
+        f'<span>{escape(label)}</span>'
+        f'<p>{escape(value_text)}</p>'
+        '</div>'
+    )
+
+
+def _markdown_to_html(markdown: str) -> str:
+    lines = markdown.splitlines()
+    html: list[str] = []
+    paragraph: list[str] = []
+    list_items: list[str] = []
+    list_tag = "ul"
+    code_lines: list[str] = []
+    in_code = False
+
+    def flush_paragraph() -> None:
+        if paragraph:
+            html.append(f"<p>{escape(' '.join(paragraph))}</p>")
+            paragraph.clear()
+
+    def flush_list() -> None:
+        if list_items:
+            html.append(f"<{list_tag}>" + "".join(f"<li>{escape(item)}</li>" for item in list_items) + f"</{list_tag}>")
+            list_items.clear()
+
+    for line in lines:
+        stripped = line.strip()
+        ordered_match = re.match(r"^(\d+)\.\s+(.*)$", stripped)
+        if stripped.startswith("```"):
+            flush_paragraph()
+            flush_list()
+            if in_code:
+                html.append(f"<pre><code>{escape(chr(10).join(code_lines))}</code></pre>")
+                code_lines.clear()
+                in_code = False
+            else:
+                in_code = True
+            continue
+        if in_code:
+            code_lines.append(line)
+            continue
+        if not stripped:
+            flush_paragraph()
+            flush_list()
+            continue
+        if list_items and (line.startswith("  ") or line.startswith("\t")) and not stripped.startswith(("- ", "* ")) and not ordered_match:
+            list_items[-1] = f"{list_items[-1]} {stripped}"
+            continue
+        if stripped.startswith("#"):
+            flush_paragraph()
+            flush_list()
+            level = min(len(stripped) - len(stripped.lstrip("#")), 4)
+            title = stripped[level:].strip()
+            html.append(f"<h{level}>{escape(title)}</h{level}>")
+            continue
+        if stripped.startswith(("- ", "* ")):
+            flush_paragraph()
+            if list_items and list_tag != "ul":
+                flush_list()
+            list_tag = "ul"
+            list_items.append(stripped[2:].strip())
+            continue
+        if ordered_match:
+            flush_paragraph()
+            if list_items and list_tag != "ol":
+                flush_list()
+            list_tag = "ol"
+            list_items.append(ordered_match.group(2).strip())
+            continue
+        flush_list()
+        paragraph.append(stripped)
+    flush_paragraph()
+    flush_list()
+    if in_code:
+        html.append(f"<pre><code>{escape(chr(10).join(code_lines))}</code></pre>")
+    return "".join(html) if html else "<p>No content.</p>"
+
+
 def _v4_data_overview_chips(entity: dict[str, object], persistence: dict[str, object] | None) -> str:
     chip_specs = [("chip-persistent", str(entity.get("category", "")))]
     if persistence:
@@ -2153,6 +2368,7 @@ def _toolbar_sections(sections: list[dict[str, str]]) -> list[dict[str, str]]:
         "system-overview",
         "runtime-overview",
         "data-overview",
+        "knowledge-overview",
         "verticals-overview",
         "quality-assurance-overview",
         "deployment-overview",