feat: enable generate-api-md by default

Default generate-api-md to true. Silently skip if apiview-stub-generator
is not installed (only warn if it is installed but fails).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: iscai-msft

packages/http-client-python/emitter/src/emitter.ts

@@ -30,6 +30,7 @@ function addDefaultOptions(sdkContext: PythonSdkContext) {
   const defaultOptions = {
     "package-version": "1.0.0b1",
     "generate-packaging-files": true,
+    "generate-api-md": true,
     "validate-versioning": true,
     "clear-output-folder": false,
   };
@@ -355,6 +356,14 @@ async function generateApiMd(
   root: string,
   packageName: string,
 ): Promise<void> {
+  // Check if apiview-stub-generator is installed before attempting
+  try {
+    execFileSync(venvPath, ["-c", "import apistub"], { stdio: "pipe" });
+  } catch {
+    // apiview-stub-generator not installed — silently skip
+    return;
+  }
+
   const apiviewOutDir = path.join(os.tmpdir(), `tsp-apiview-${randomUUID()}`);
   try {
     fs.mkdirSync(apiviewOutDir, { recursive: true });

packages/http-client-python/emitter/src/lib.ts

@@ -122,7 +122,7 @@ export const PythonEmitterOptionsSchema: JSONSchemaType<PythonEmitterOptions> =
       type: "boolean",
       nullable: true,
       description:
-        "Whether to generate an api.md file containing the public API surface. Defaults to `false`. Requires `apiview-stub-generator` to be installed.",
+        "Whether to generate an api.md file containing the public API surface. Defaults to `true`. Requires `apiview-stub-generator` to be installed.",
     },
   },
   required: [],