fix(packaging): Include schemas in portable installs

Package structured output schemas with portable macOS distributions so MCP clients can load tool schemas from installed builds.

Add verification coverage to catch missing schema files in portable install roots.

Author: cameroncooke

scripts/package-macos-portable.sh

@@ -316,6 +316,7 @@ if [[ "$UNIVERSAL" == "true" ]]; then
   mkdir -p "$UNIVERSAL_ROOT/bin" "$UNIVERSAL_ROOT/libexec"
   cp -R "$ARM64_ROOT/libexec/build" "$UNIVERSAL_ROOT/libexec/"
   cp -R "$ARM64_ROOT/libexec/manifests" "$UNIVERSAL_ROOT/libexec/"
+  cp -R "$ARM64_ROOT/libexec/schemas" "$UNIVERSAL_ROOT/libexec/"
   cp -R "$ARM64_ROOT/libexec/bundled" "$UNIVERSAL_ROOT/libexec/"
   cp -R "$ARM64_ROOT/libexec/skills" "$UNIVERSAL_ROOT/libexec/"
   cp -R "$ARM64_ROOT/libexec/node_modules" "$UNIVERSAL_ROOT/libexec/"
@@ -364,6 +365,7 @@ install_node_runtime_for_arch "$ARCH" "$PORTABLE_ROOT/libexec/node-runtime"
 
 cp -R "$PROJECT_ROOT/build" "$PORTABLE_ROOT/libexec/"
 cp -R "$PROJECT_ROOT/manifests" "$PORTABLE_ROOT/libexec/"
+cp -R "$PROJECT_ROOT/schemas" "$PORTABLE_ROOT/libexec/"
 cp -R "$PROJECT_ROOT/bundled" "$PORTABLE_ROOT/libexec/"
 cp -R "$PROJECT_ROOT/skills" "$PORTABLE_ROOT/libexec/"
 cp "$PROJECT_ROOT/package.json" "$PORTABLE_ROOT/libexec/package.json"

scripts/verify-portable-install.sh

@@ -79,6 +79,14 @@ if [[ ! -d "$PORTABLE_ROOT/libexec/manifests" ]]; then
   echo "Missing manifests directory under libexec"
   exit 1
 fi
+if [[ ! -f "$PORTABLE_ROOT/libexec/schemas/structured-output/_defs/common.schema.json" ]]; then
+  echo "Missing structured output common schema under libexec"
+  exit 1
+fi
+if [[ ! -f "$PORTABLE_ROOT/libexec/schemas/structured-output/xcodebuildmcp.output.session-defaults/1.schema.json" ]]; then
+  echo "Missing session defaults structured output schema under libexec"
+  exit 1
+fi
 if [[ ! -x "$PORTABLE_ROOT/libexec/bundled/axe" ]]; then
   echo "Missing bundled axe binary under libexec"
   exit 1

src/core/__tests__/portable-install-script.test.ts

@@ -0,0 +1,85 @@
+import { execFileSync } from 'node:child_process';
+import type { ExecFileSyncOptionsWithStringEncoding } from 'node:child_process';
+import { chmodSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+
+const verifyScriptPath = join(process.cwd(), 'scripts', 'verify-portable-install.sh');
+const execOptions = {
+  encoding: 'utf8',
+  stdio: 'pipe',
+} satisfies ExecFileSyncOptionsWithStringEncoding;
+
+function createExecutable(path: string) {
+  writeFileSync(path, '#!/usr/bin/env bash\nexit 0\n');
+  chmodSync(path, 0o755);
+}
+
+function createPortableRoot(root: string) {
+  mkdirSync(join(root, 'bin'), { recursive: true });
+  mkdirSync(join(root, 'libexec', 'manifests'), { recursive: true });
+  mkdirSync(join(root, 'libexec', 'bundled', 'Frameworks'), { recursive: true });
+  mkdirSync(join(root, 'libexec', 'skills'), { recursive: true });
+  mkdirSync(join(root, 'libexec', 'schemas', 'structured-output', '_defs'), { recursive: true });
+  mkdirSync(
+    join(root, 'libexec', 'schemas', 'structured-output', 'xcodebuildmcp.output.session-defaults'),
+    { recursive: true },
+  );
+
+  createExecutable(join(root, 'bin', 'xcodebuildmcp'));
+  createExecutable(join(root, 'bin', 'xcodebuildmcp-doctor'));
+  createExecutable(join(root, 'libexec', 'xcodebuildmcp'));
+  createExecutable(join(root, 'libexec', 'node-runtime'));
+  createExecutable(join(root, 'libexec', 'bundled', 'axe'));
+  writeFileSync(
+    join(root, 'libexec', 'schemas', 'structured-output', '_defs', 'common.schema.json'),
+    '{}',
+  );
+  writeFileSync(
+    join(
+      root,
+      'libexec',
+      'schemas',
+      'structured-output',
+      'xcodebuildmcp.output.session-defaults',
+      '1.schema.json',
+    ),
+    '{}',
+  );
+}
+
+describe('verify-portable-install.sh', () => {
+  let tempDir: string;
+
+  beforeEach(() => {
+    tempDir = join(tmpdir(), `xbmcp-portable-verify-${process.pid}-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+  });
+
+  afterEach(() => {
+    rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  it('accepts a portable root containing structured output schemas', () => {
+    const root = join(tempDir, 'portable-root');
+    createPortableRoot(root);
+
+    expect(() => execFileSync(verifyScriptPath, ['--root', root], execOptions)).not.toThrow();
+  });
+
+  it('rejects a portable root missing structured output schemas', () => {
+    const root = join(tempDir, 'portable-root');
+    createPortableRoot(root);
+    rmSync(join(root, 'libexec', 'schemas'), { recursive: true, force: true });
+
+    try {
+      execFileSync(verifyScriptPath, ['--root', root], execOptions);
+      throw new Error('Expected verify-portable-install.sh to fail');
+    } catch (error) {
+      expect(error).toMatchObject({
+        stdout: expect.stringContaining('Missing structured output common schema'),
+      });
+    }
+  });
+});