added known-issues docs site

src/Agent/AutopilotMonitor.Agent/buildcounter.txt

@@ -1 +1 @@
-838
+839

src/Web/autopilot-monitor-web/app/docs/DocsSidebar.tsx

@@ -18,6 +18,7 @@ import {
   CodeBracketIcon,
   QuestionMarkCircleIcon,
   CommandLineIcon,
+  BellIcon,
 } from "../../lib/sidebarIcons";
 
 const SECTION_ICONS: Record<string, React.ReactNode> = {
@@ -32,6 +33,7 @@ const SECTION_ICONS: Record<string, React.ReactNode> = {
   "analyze-rules": <SparklesIcon />,
   "ime-log-patterns": <CodeBracketIcon />,
   "faq": <QuestionMarkCircleIcon />,
+  "known-issues": <BellIcon />,
   "mcp-integration": <CommandLineIcon />,
 };
 

src/Web/autopilot-monitor-web/app/docs/[section]/page.tsx

@@ -14,6 +14,7 @@ import { SectionAnalyzeRules } from "../sections/SectionAnalyzeRules";
 import { SectionImeLogPatterns } from "../sections/SectionImeLogPatterns";
 import { SectionFaq } from "../sections/SectionFaq";
 import { SectionAgentChangelog } from "../sections/SectionAgentChangelog";
+import { SectionKnownIssues } from "../sections/SectionKnownIssues";
 
 const SECTION_COMPONENTS: Record<string, React.ComponentType> = {
   "private-preview": SectionPrivatePreview,
@@ -27,6 +28,7 @@ const SECTION_COMPONENTS: Record<string, React.ComponentType> = {
   "analyze-rules":   SectionAnalyzeRules,
   "ime-log-patterns": SectionImeLogPatterns,
   "faq":              SectionFaq,
+  "known-issues":     SectionKnownIssues,
   "agent-changelog":  SectionAgentChangelog,
 };
 

src/Web/autopilot-monitor-web/app/docs/docsNavSections.ts

@@ -18,6 +18,7 @@ export const NAV_SECTIONS: readonly NavSection[] = [
   { id: "analyze-rules",   label: "Analyze Rules",     description: "Set up analyze rules to automatically evaluate Windows Autopilot enrollments. Define conditions, severity levels, and custom logic to detect issues in real time." },
   { id: "ime-log-patterns", label: "IME Log Patterns", description: "Define regex patterns for parsing the Intune Management Extension (IME) log into structured events. Customize how Autopilot Monitor extracts log entries." },
   { id: "faq",              label: "FAQ",              description: "Frequently asked questions about Autopilot Monitor — covering setup, agent behavior, troubleshooting common issues, and tips for getting the most out of the platform." },
+  { id: "known-issues",    label: "Known Issues",     description: "Documented issues caused by external changes that affect Autopilot Monitor — breaking changes, known limitations, workarounds, and current status." },
   { id: "mcp-integration", label: "MCP Integration",  description: "Connect AI assistants to Autopilot Monitor via Model Context Protocol. Configure MCP clients, explore available tools, and learn how to query enrollment data with natural language.", requiresMcpAccess: true },
   { id: "agent-changelog", label: "Agent Changelog",  description: "Changelog of user-facing changes to the Autopilot Monitor agent — new features, behavior changes, and improvements over time.", hidden: true },
 ] as const;

src/Web/autopilot-monitor-web/app/docs/sections/SectionKnownIssues.tsx

@@ -0,0 +1,111 @@
+export function SectionKnownIssues() {
+  return (
+    <section className="bg-white rounded-lg shadow-md p-8">
+      <div className="flex items-center space-x-3 mb-4">
+        <svg className="w-8 h-8 text-blue-600 shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24" strokeWidth={1.5}>
+          <path strokeLinecap="round" strokeLinejoin="round" d="M14.857 17.082a23.848 23.848 0 005.454-1.31A8.967 8.967 0 0118 9.75v-.7V9A6 6 0 006 9v.75a8.967 8.967 0 01-2.312 6.022c1.733.64 3.56 1.085 5.455 1.31m5.714 0a24.255 24.255 0 01-5.714 0m5.714 0a3 3 0 11-5.714 0" />
+        </svg>
+        <h2 className="text-2xl font-bold text-gray-900">Known Issues</h2>
+      </div>
+      <p className="text-gray-600 mb-8">
+        Documented issues caused by external changes (e.g.&nbsp;Microsoft updates) that affect Autopilot Monitor.
+        Each entry describes the impact, what still works, and whether a workaround exists.
+      </p>
+
+      <AnnouncementCard
+        date="2026-04-05"
+        title="IME 1.101.x Removes Delivery Optimization Telemetry from Logs"
+        type="breaking"
+      >
+        <p>
+          Starting with IME version <strong>1.101.x</strong>, Microsoft no longer writes Delivery Optimization (DO)
+          telemetry data to the IME log. This is a Microsoft-side change, not an Autopilot Monitor bug.
+        </p>
+
+        <h4 className="font-semibold text-gray-900 mt-3">What changed</h4>
+        <ul className="list-disc list-inside space-y-1">
+          <li>
+            <strong>Old IME (1.99.x)</strong>: Wrote{" "}
+            <code className="text-xs bg-gray-100 px-1 py-0.5 rounded">[DO TEL] = {"{"}JSON with all DO stats{"}"}</code>{" "}
+            after every download &mdash; full peer caching metrics were available.
+          </li>
+          <li>
+            <strong>New IME (1.101.x)</strong>: Only writes{" "}
+            <code className="text-xs bg-gray-100 px-1 py-0.5 rounded">[Win32App DO] DO download and decryption is successfully done</code>{" "}
+            &mdash; no DO telemetry JSON at all.
+          </li>
+        </ul>
+
+        <h4 className="font-semibold text-gray-900 mt-3">What the new IME still logs</h4>
+        <ul className="list-disc list-inside space-y-1">
+          <li>
+            <code className="text-xs bg-gray-100 px-1 py-0.5 rounded">[Win32App] Downloaded file size 37,187,491.00</code>{" "}
+            &mdash; file size only
+          </li>
+          <li>
+            <code className="text-xs bg-gray-100 px-1 py-0.5 rounded">[Win32App DO] start creating a new download job, FileId = ...</code>{" "}
+            &mdash; OriginalSize in ContentInfo JSON
+          </li>
+          <li>
+            <code className="text-xs bg-gray-100 px-1 py-0.5 rounded">[Win32App DO] DO Job set priority is BG_JOB_PRIORITY_FOREGROUND</code>{" "}
+            &mdash; download mode only
+          </li>
+        </ul>
+
+        <h4 className="font-semibold text-gray-900 mt-3">What is lost</h4>
+        <p>
+          The detailed DO stats &mdash; <strong>BytesFromPeers</strong>, <strong>PeerCaching %</strong>,{" "}
+          <strong>LanPeers</strong>, <strong>GroupPeers</strong>, and all other DO telemetry fields &mdash;{" "}
+          are no longer present in the IME logs. For IME &ge; 1.101 there is currently no way to extract
+          DO telemetry from the logs because the data is simply not written anymore.
+        </p>
+
+        <h4 className="font-semibold text-gray-900 mt-3">Impact on Autopilot Monitor</h4>
+        <p>
+          Sessions from devices running IME &ge; 1.101 will not show Delivery Optimization metrics
+          in the timeline. Older IME versions continue to work as before. We are monitoring whether
+          Microsoft re-introduces this data in a future IME release.
+        </p>
+      </AnnouncementCard>
+    </section>
+  );
+}
+
+/* ── Helpers ──────────────────────────────────────────── */
+
+type BadgeType = "breaking" | "known-issue" | "info" | "resolved";
+
+const BADGE_STYLES: Record<BadgeType, { bg: string; label: string }> = {
+  breaking:      { bg: "bg-red-100 text-red-800",     label: "Breaking Change" },
+  "known-issue": { bg: "bg-amber-100 text-amber-800", label: "Known Issue" },
+  info:          { bg: "bg-blue-100 text-blue-800",    label: "Info" },
+  resolved:      { bg: "bg-green-100 text-green-800",  label: "Resolved" },
+};
+
+function Badge({ type }: { type: BadgeType }) {
+  const { bg, label } = BADGE_STYLES[type];
+  return <span className={`inline-block text-xs font-medium px-2 py-0.5 rounded-full ${bg}`}>{label}</span>;
+}
+
+function AnnouncementCard({
+  date,
+  title,
+  type,
+  children,
+}: {
+  date: string;
+  title: string;
+  type: BadgeType;
+  children: React.ReactNode;
+}) {
+  return (
+    <div className="mb-6 border border-gray-200 rounded-lg p-5">
+      <div className="flex items-center gap-3 mb-1">
+        <span className="text-sm text-gray-500">{date}</span>
+        <Badge type={type} />
+      </div>
+      <h3 className="text-base font-semibold text-gray-900 mb-2">{title}</h3>
+      <div className="text-sm text-gray-700 leading-relaxed space-y-2">{children}</div>
+    </div>
+  );
+}