feat(FN-3577): add native shell guide and bridge contract documentation

Adds a native shell integration guide (FN-3577) with fusionShell bridge contract documentation, wired into the docs navigation, plus a regression test; also hardens the dependency graph's task filtering (FN-3085) to include in-review tasks and handle orphan edges, with corresponding test coverage ac

Fusion-Task-Id: FN-3577

packages/dashboard/src/__tests__/native-shell-documentation.test.ts

@@ -0,0 +1,48 @@
+// @vitest-environment node
+
+import { describe, it, expect } from "vitest";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+
+const repoRoot = path.resolve(__dirname, "../../../../");
+
+function readDoc(relativePath: string): string {
+  return readFileSync(path.join(repoRoot, relativePath), "utf8");
+}
+
+describe("native shell documentation contract", () => {
+  it("publishes the canonical native shell guide with required flow sections", () => {
+    const nativeShellGuide = readDoc("docs/native-shell.md");
+
+    expect(nativeShellGuide).toContain("# Native Shell Connection Guide");
+    expect(nativeShellGuide).toContain("## First-run onboarding flow");
+    expect(nativeShellGuide).toContain("## QR scan and manual fallback");
+    expect(nativeShellGuide).toContain("## Saved connection profiles");
+    expect(nativeShellGuide).toContain("## Desktop remote handoff behavior");
+    expect(nativeShellGuide).toContain("window.fusionShell");
+    expect(nativeShellGuide).toContain("Remote Access runbook");
+  });
+
+  it("keeps cross-doc links to the canonical guide and bridge API discoverable", () => {
+    const docsIndex = readDoc("docs/README.md");
+    const dashboardGuide = readDoc("docs/dashboard-guide.md");
+    const mobileGuide = readDoc("MOBILE.md");
+    const architecture = readDoc("docs/architecture.md");
+
+    expect(docsIndex).toContain("[Native Shell Connection Guide](./native-shell.md)");
+    expect(dashboardGuide).toContain("[Native Shell Connection Guide](./native-shell.md)");
+    expect(mobileGuide).toContain("[Native Shell Connection Guide](./docs/native-shell.md)");
+
+    expect(architecture).toContain("window.fusionShell");
+    expect(architecture).toContain("getState()");
+    expect(architecture).toContain("listProfiles()");
+    expect(architecture).toContain("saveProfile(profile)");
+    expect(architecture).toContain("deleteProfile(profileId)");
+    expect(architecture).toContain("setActiveProfile(profileId)");
+    expect(architecture).toContain("setDesktopMode(mode)");
+    expect(architecture).toContain("startQrScan()");
+    expect(architecture).toContain("openConnectionManager()");
+    expect(architecture).toContain("subscribe(listener)");
+    expect(architecture).toContain("getDesktopModeState()");
+  });
+});