@principles/pd-cli 1.108.0 → 1.108.1

package/dist/services/resolve-runtime-from-pd-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-runtime-from-pd-config.d.ts","sourceRoot":"","sources":["../../src/services/resolve-runtime-from-pd-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EAEd,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,WAAW,2BAA2B;IAC1C,8CAA8C;IAC9C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,+EAA+E;IAC/E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0EAA0E;IAC1E,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAuC,GAC5E,2BAA2B,CA6C7B;AAGD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,EACD,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAuC,GAC5E,2BAA2B,GAAG;IAAE,YAAY,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,CAoBtE"}
+{"version":3,"file":"resolve-runtime-from-pd-config.d.ts","sourceRoot":"","sources":["../../src/services/resolve-runtime-from-pd-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EAEd,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,WAAW,2BAA2B;IAC1C,8CAA8C;IAC9C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,+EAA+E;IAC/E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0EAA0E;IAC1E,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAkBD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAuC,GAC5E,2BAA2B,CA0D7B;AAGD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,EACD,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAuC,GAC5E,2BAA2B,GAAG;IAAE,YAAY,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,CAoBtE"}

package/dist/services/resolve-runtime-from-pd-config.js

@@ -12,8 +12,26 @@
  * - ERR-002: fail loud with reason + nextAction
  * - EP-07: runtime state source alignment
  */
-import { resolveRuntimeConfigFromPdConfig, isRuntimeConfigError, } from '@principles/core/runtime-v2';
+import { resolveRuntimeConfigFromPdConfig, isRuntimeConfigError, resolveAgentRuntimeBinding, } from '@principles/core/runtime-v2';
 import { loadPdConfig } from './pd-config-loader.js';
+/**
+ * Build a profile label matching the format used by `pd config doctor`.
+ * Mirrors `buildProfileLabel` in `pd-config-redaction.ts` (core).
+ */
+function buildProfileLabel(profileId, profile) {
+    if (profile.type === 'openclaw') {
+        const parts = ['openclaw'];
+        if (profile.provider)
+            parts.push(profile.provider);
+        if (profile.model)
+            parts.push(profile.model);
+        if (profile.source && !profile.provider && !profile.model)
+            parts.push(profile.source);
+        return parts.join(': ');
+    }
+    // pi-ai
+    return `pi-ai: ${profile.provider ?? 'unknown'}/${profile.model ?? 'unknown'}`;
+}
 /**
  * Resolve runtime configuration exclusively from .pd/config.yaml.
  *
@@ -49,9 +67,19 @@ export function resolveRuntimeFromPdConfig(workspaceDir, getEnvVar = (name) => p
             legacyWarnings,
             configLoadResult,
             configSource: '.pd/config.yaml',
+            runtimeProfileId: null,
+            runtimeProfileLabel: null,
         };
     }
     const result = resolveRuntimeConfigFromPdConfig(configLoadResult.effective, getEnvVar);
+    // PRI-402: Extract profile ID and label for probe output alignment with doctor
+    let runtimeProfileId = null;
+    let runtimeProfileLabel = null;
+    const bindingResult = resolveAgentRuntimeBinding(configLoadResult.effective, 'diagnostician');
+    if (bindingResult.ok) {
+        runtimeProfileId = bindingResult.profileId;
+        runtimeProfileLabel = buildProfileLabel(bindingResult.profileId, bindingResult.profile);
+    }
     const legacyWarnings = configLoadResult.legacyFilesDetected.length > 0
         ? [
             `Legacy config files detected: ${configLoadResult.legacyFilesDetected.join(', ')}. ` +
@@ -63,6 +91,8 @@ export function resolveRuntimeFromPdConfig(workspaceDir, getEnvVar = (name) => p
         legacyWarnings,
         configLoadResult,
         configSource: '.pd/config.yaml',
+        runtimeProfileId,
+        runtimeProfileLabel,
     };
 }
 /**

package/dist/services/resolve-runtime-from-pd-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-runtime-from-pd-config.js","sourceRoot":"","sources":["../../src/services/resolve-runtime-from-pd-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve-runtime-from-pd-config.js","sourceRoot":"","sources":["../../src/services/resolve-runtime-from-pd-config.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/pd-cli",
-  "version": "1.108.0",
+  "version": "1.108.1",
   "description": "PD CLI — Pain recording, sample management, and evolution tasks",
   "type": "module",
   "bin": {

package/src/commands/__tests__/runtime-probe-config.test.ts

@@ -0,0 +1,431 @@
+/**
+ * PRI-402: pd runtime probe reads .pd/config.yaml for pi-ai config.
+ *
+ * Tests cover:
+ *   - probe reads config from .pd/config.yaml when --workspace is provided
+ *   - JSON output includes configSource, runtimeProfileId, runtimeProfileLabel
+ *   - explicit --provider overrides config.yaml
+ *   - fail-loud JSON when config.yaml is missing or incomplete
+ *   - program.parseAsync against real Commander registration (EP-04)
+ *
+ * ERR refs:
+ *   - EP-04 (CLI gate): --json stdout single object, process.exit(1) + return
+ *   - EP-03 (fail loud): structured JSON with reason + nextAction on failure
+ *   - EP-07 (source alignment): probe and doctor read same config source
+ *   - ERR-004 (source alignment): profileId/label must match doctor output
+ *   - ERR-021 (handler-only tests): add program.parseAsync tests
+ *   - ERR-029 (fail-loud JSON): config missing → structured JSON, not bare error
+ */
+
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+
+// ─── Mocks ─────────────────────────────────────────────────────────────────
+
+// Mock only probeRuntime so we don't need a real LLM provider.
+// All other core functions (validatePdConfig, computeEffectivePdConfig,
+// resolveAgentRuntimeBinding, etc.) use their real implementations.
+const mockProbeRuntime = vi.fn();
+vi.mock('@principles/core/runtime-v2', async (importOriginal) => {
+  const actual = await importOriginal<Record<string, unknown>>();
+  return {
+    ...actual,
+    probeRuntime: mockProbeRuntime,
+  };
+});
+
+const { handleRuntimeProbe } = await import('../runtime.js');
+
+// ─── Test Setup ─────────────────────────────────────────────────────────────
+
+const capturedStdout: string[] = [];
+const capturedStderr: string[] = [];
+let capturedExitCode: number | null = null;
+
+const originalExit = process.exit;
+const originalLog = console.log;
+const originalError = console.error;
+const originalWarn = console.warn;
+const originalEnv = { ...process.env };
+
+beforeEach(() => {
+  capturedExitCode = null;
+  capturedStdout.length = 0;
+  capturedStderr.length = 0;
+  process.exit = vi.fn(((code?: number) => {
+    capturedExitCode = code ?? 0;
+  }) as typeof process.exit);
+  console.log = vi.fn((...args: unknown[]) => { capturedStdout.push(args.join(' ')); });
+  console.error = vi.fn((...args: unknown[]) => { capturedStderr.push(args.join(' ')); });
+  console.warn = vi.fn(() => { /* capture warnings */ });
+  mockProbeRuntime.mockReset();
+  process.env = { ...originalEnv, LMSTUDIO_API_KEY: 'test-key-for-pri-402' };
+});
+
+afterEach(() => {
+  process.exit = originalExit;
+  console.log = originalLog;
+  console.error = originalError;
+  console.warn = originalWarn;
+  process.env = originalEnv;
+});
+
+// ─── Helper: create temp workspace with .pd/config.yaml ────────────────────
+
+function createTempWorkspace(configYaml: string): string {
+  const tmpDir = path.join(os.tmpdir(), `pd-probe-test-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
+  const pdDir = path.join(tmpDir, '.pd');
+  fs.mkdirSync(pdDir, { recursive: true });
+  // Replace __WORKSPACE_DIR__ placeholder with actual path
+  const resolvedYaml = configYaml.replace(/__WORKSPACE_DIR__/g, tmpDir.replace(/\\/g, '/'));
+  fs.writeFileSync(path.join(pdDir, 'config.yaml'), resolvedYaml, 'utf-8');
+  return tmpDir;
+}
+
+function cleanupWorkspace(dir: string): void {
+  try {
+    fs.rmSync(dir, { recursive: true, force: true });
+  } catch {
+    // best effort
+  }
+}
+
+const PI_AI_CONFIG_YAML = `
+version: 1
+features:
+  prompt: { category: core, enabled: true }
+  code_tool_hook: { category: core, enabled: true }
+  defer_archive: { category: core, enabled: true }
+workspace:
+  default: __WORKSPACE_DIR__
+internalAgents:
+  defaultRuntime: pi-ai.lmstudio
+  agents:
+    diagnostician:
+      enabled: true
+      runtimeProfile: pi-ai.lmstudio
+    dreamer:
+      enabled: true
+    philosopher:
+      enabled: true
+    scribe:
+      enabled: true
+    artificer:
+      enabled: true
+runtimeProfiles:
+  pi-ai.lmstudio:
+    type: pi-ai
+    provider: lmstudio
+    model: qwen3.6-27b-mtp
+    apiKeyEnv: LMSTUDIO_API_KEY
+    baseUrl: http://localhost:1234/v1
+`;
+
+// ─── Tests: probe reads config from .pd/config.yaml ────────────────────────
+
+describe('PRI-402: probe reads .pd/config.yaml for pi-ai config', () => {
+  it('reads provider/model from config.yaml when --workspace provided without --provider', async () => {
+    const workspace = createTempWorkspace(PI_AI_CONFIG_YAML);
+    try {
+      mockProbeRuntime.mockResolvedValue({
+        runtimeKind: 'pi-ai',
+        provider: 'lmstudio',
+        model: 'qwen3.6-27b-mtp',
+        health: { healthy: true, degraded: false, warnings: [], lastCheckedAt: '2026-01-01T00:00:00Z' },
+        capabilities: { streaming: true },
+      });
+
+      await handleRuntimeProbe({
+        runtime: 'pi-ai',
+        workspace,
+        json: true,
+      });
+
+      // probeRuntime should be called with config.yaml values
+      expect(mockProbeRuntime).toHaveBeenCalled();
+      const callArgs = mockProbeRuntime.mock.calls[0]?.[0];
+      expect(callArgs?.provider).toBe('lmstudio');
+      expect(callArgs?.model).toBe('qwen3.6-27b-mtp');
+      expect(callArgs?.apiKeyEnv).toBe('LMSTUDIO_API_KEY');
+
+      // JSON output should contain configSource, runtimeProfileId, runtimeProfileLabel
+      const output = JSON.parse(capturedStdout.join(''));
+      expect(output.configSource).toBe('.pd/config.yaml');
+      expect(output.runtimeProfileId).toBe('pi-ai.lmstudio');
+      expect(output.runtimeProfileLabel).toBe('pi-ai: lmstudio/qwen3.6-27b-mtp');
+      expect(output.ok).toBe(true);
+    } finally {
+      cleanupWorkspace(workspace);
+    }
+  });
+
+  it('explicit --provider overrides config.yaml value', async () => {
+    const workspace = createTempWorkspace(PI_AI_CONFIG_YAML);
+    try {
+      mockProbeRuntime.mockResolvedValue({
+        runtimeKind: 'pi-ai',
+        provider: 'openrouter',
+        model: 'qwen3.6-27b-mtp',
+        health: { healthy: true, degraded: false, warnings: [], lastCheckedAt: '2026-01-01T00:00:00Z' },
+        capabilities: { streaming: true },
+      });
+
+      await handleRuntimeProbe({
+        runtime: 'pi-ai',
+        workspace,
+        provider: 'openrouter',
+        model: 'anthropic/claude-sonnet-4',
+        apiKeyEnv: 'OPENROUTER_API_KEY',
+        json: true,
+      });
+
+      const callArgs = mockProbeRuntime.mock.calls[0]?.[0];
+      // CLI flags override config.yaml
+      expect(callArgs?.provider).toBe('openrouter');
+      expect(callArgs?.model).toBe('anthropic/claude-sonnet-4');
+      expect(callArgs?.apiKeyEnv).toBe('OPENROUTER_API_KEY');
+
+      // Profile info still comes from config.yaml (EP-07: source alignment)
+      const output = JSON.parse(capturedStdout.join(''));
+      expect(output.configSource).toBe('.pd/config.yaml');
+      expect(output.runtimeProfileId).toBe('pi-ai.lmstudio');
+    } finally {
+      cleanupWorkspace(workspace);
+    }
+  });
+
+  it('fail-loud JSON when config.yaml is missing and no --provider', async () => {
+    const workspace = path.join(os.tmpdir(), `pd-probe-test-missing-${Date.now()}`);
+    fs.mkdirSync(workspace, { recursive: true });
+    // No .pd/config.yaml created
+    try {
+      await handleRuntimeProbe({
+        runtime: 'pi-ai',
+        workspace,
+        json: true,
+      });
+
+      expect(capturedExitCode).toBe(1);
+      const output = JSON.parse(capturedStdout.join(''));
+      expect(output.ok).toBe(false);
+      expect(output.status).toBe('failed');
+      expect(typeof output.reason).toBe('string');
+      expect(typeof output.nextAction).toBe('string');
+      // Single parseable JSON object (EP-04 Rule 1)
+      expect(Array.isArray(output)).toBe(false);
+    } finally {
+      cleanupWorkspace(workspace);
+    }
+  });
+
+  it('fail-loud JSON when provider missing from config.yaml', async () => {
+    const workspace = createTempWorkspace(`
+version: 1
+features:
+  prompt: { category: core, enabled: true }
+  code_tool_hook: { category: core, enabled: true }
+  defer_archive: { category: core, enabled: true }
+workspace:
+  default: __WORKSPACE_DIR__
+internalAgents:
+  defaultRuntime: pi-ai.broken
+  agents:
+    diagnostician:
+      enabled: true
+      runtimeProfile: pi-ai.broken
+runtimeProfiles:
+  pi-ai.broken:
+    type: pi-ai
+    # Missing provider, model, apiKeyEnv
+`);
+    try {
+      await handleRuntimeProbe({
+        runtime: 'pi-ai',
+        workspace,
+        json: true,
+      });
+
+      expect(capturedExitCode).toBe(1);
+      const output = JSON.parse(capturedStdout.join(''));
+      expect(output.ok).toBe(false);
+      expect(output.status).toBe('failed');
+      expect(typeof output.reason).toBe('string');
+      expect(typeof output.nextAction).toBe('string');
+    } finally {
+      cleanupWorkspace(workspace);
+    }
+  });
+
+  it('fail-loud JSON when apiKeyEnv env var is not set', async () => {
+    const workspace = createTempWorkspace(PI_AI_CONFIG_YAML);
+    try {
+      // Remove the API key env var
+      delete process.env.LMSTUDIO_API_KEY;
+
+      await handleRuntimeProbe({
+        runtime: 'pi-ai',
+        workspace,
+        json: true,
+      });
+
+      expect(capturedExitCode).toBe(1);
+      const output = JSON.parse(capturedStdout.join(''));
+      expect(output.ok).toBe(false);
+      // When apiKeyEnv is not set, resolveRuntimeConfigFromPdConfig returns
+      // a config error (not_ready), so the error comes from the config resolution path
+      expect(typeof output.reason).toBe('string');
+      expect(typeof output.nextAction).toBe('string');
+    } finally {
+      cleanupWorkspace(workspace);
+    }
+  });
+
+  it('human-readable output includes Profile and Config lines', async () => {
+    const workspace = createTempWorkspace(PI_AI_CONFIG_YAML);
+    try {
+      mockProbeRuntime.mockResolvedValue({
+        runtimeKind: 'pi-ai',
+        provider: 'lmstudio',
+        model: 'qwen3.6-27b-mtp',
+        health: { healthy: true, degraded: false, warnings: [], lastCheckedAt: '2026-01-01T00:00:00Z' },
+        capabilities: { streaming: true },
+      });
+
+      await handleRuntimeProbe({
+        runtime: 'pi-ai',
+        workspace,
+        json: false,
+      });
+
+      const output = capturedStdout.join('\n');
+      expect(output).toContain('Profile:');
+      expect(output).toContain('pi-ai: lmstudio/qwen3.6-27b-mtp');
+      expect(output).toContain('Config:');
+      expect(output).toContain('.pd/config.yaml');
+    } finally {
+      cleanupWorkspace(workspace);
+    }
+  });
+});
+
+// ─── Tests: program.parseAsync against real Commander registration (EP-04) ──
+
+// Import the real command registration function to test actual production wiring
+const { registerRuntimeProbeCommand } = await import('../runtime.js');
+
+interface CapturedAction {
+  opts: Record<string, unknown> | null;
+}
+
+function attachCapture(cmd: Command, state: CapturedAction): void {
+  // Override the action handler to capture opts without calling the real handler
+  cmd.action((...args: unknown[]) => {
+    // Find the opts object (last non-Command, non-null object arg)
+    let optsArg: Record<string, unknown> | null = null;
+    for (let i = args.length - 1; i >= 0; i--) {
+      const arg: unknown = args[i];
+      if (arg !== null && typeof arg === 'object' && !(arg instanceof Command)) {
+        optsArg = arg as Record<string, unknown>;
+        break;
+      }
+    }
+    state.opts = optsArg ?? {};
+    // Do NOT call original action (would call handleRuntimeProbe which needs real runtime)
+  });
+}
+
+function freshProgram(): Command {
+  const program = new Command();
+  program.name('pd').exitOverride();
+  return program;
+}
+
+describe('PRI-402: probe command flag wiring (EP-04 real registration)', () => {
+  it('registers --runtime as required option via real registration', () => {
+    const program = freshProgram();
+    const runtimeCmd = program.command('runtime');
+    const probeCmd = registerRuntimeProbeCommand(runtimeCmd);
+
+    const runtimeOpt = probeCmd.options.find((o) => o.long === '--runtime');
+    expect(runtimeOpt).toBeDefined();
+    expect(runtimeOpt?.required).toBe(true);
+  });
+
+  it('registers --workspace with -w shorthand via real registration', () => {
+    const program = freshProgram();
+    const runtimeCmd = program.command('runtime');
+    const probeCmd = registerRuntimeProbeCommand(runtimeCmd);
+
+    const wsOpt = probeCmd.options.find((o) => o.short === '-w');
+    expect(wsOpt).toBeDefined();
+    expect(wsOpt?.long).toBe('--workspace');
+  });
+
+  it('parses --runtime pi-ai --workspace <dir> --json correctly via real registration', async () => {
+    const program = freshProgram();
+    const runtimeCmd = program.command('runtime');
+    const probeCmd = registerRuntimeProbeCommand(runtimeCmd);
+    const captured: CapturedAction = { opts: null };
+    attachCapture(probeCmd, captured);
+
+    await program.parseAsync(['node', 'pd', 'runtime', 'probe', '--runtime', 'pi-ai', '--workspace', '/tmp/test', '--json']);
+
+    expect(captured.opts).not.toBeNull();
+    if (!captured.opts) throw new Error('captured.opts is null');
+    expect(captured.opts.runtime).toBe('pi-ai');
+    expect(captured.opts.workspace).toBe('/tmp/test');
+    expect(captured.opts.json).toBe(true);
+  });
+
+  it('parses --runtime config --workspace <dir> correctly via real registration', async () => {
+    const program = freshProgram();
+    const runtimeCmd = program.command('runtime');
+    const probeCmd = registerRuntimeProbeCommand(runtimeCmd);
+    const captured: CapturedAction = { opts: null };
+    attachCapture(probeCmd, captured);
+
+    await program.parseAsync(['node', 'pd', 'runtime', 'probe', '--runtime', 'config', '--workspace', '/tmp/test']);
+
+    expect(captured.opts).not.toBeNull();
+    if (!captured.opts) throw new Error('captured.opts is null');
+    expect(captured.opts.runtime).toBe('config');
+    expect(captured.opts.workspace).toBe('/tmp/test');
+  });
+});
+
+// ─── Tests: resolve-runtime-from-pd-config profile extraction ───────────────
+
+describe('PRI-402: resolveRuntimeWithOverrides returns profile info', () => {
+  it('returns runtimeProfileId and runtimeProfileLabel from config.yaml', async () => {
+    const workspace = createTempWorkspace(PI_AI_CONFIG_YAML);
+    try {
+      const { resolveRuntimeWithOverrides } = await import('../../services/resolve-runtime-from-pd-config.js');
+      const result = resolveRuntimeWithOverrides(workspace, {});
+
+      expect(result.configSource).toBe('.pd/config.yaml');
+      expect(result.runtimeProfileId).toBe('pi-ai.lmstudio');
+      expect(result.runtimeProfileLabel).toBe('pi-ai: lmstudio/qwen3.6-27b-mtp');
+    } finally {
+      cleanupWorkspace(workspace);
+    }
+  });
+
+  it('returns default profile when config.yaml is missing', async () => {
+    const workspace = path.join(os.tmpdir(), `pd-probe-test-noprofile-${Date.now()}`);
+    fs.mkdirSync(workspace, { recursive: true });
+    try {
+      const { resolveRuntimeWithOverrides } = await import('../../services/resolve-runtime-from-pd-config.js');
+      const result = resolveRuntimeWithOverrides(workspace, {});
+
+      // Missing config → defaults, which use openclaw.default as defaultRuntime
+      expect(result.configSource).toBe('.pd/config.yaml');
+      expect(result.runtimeProfileId).toBe('openclaw.default');
+      expect(typeof result.runtimeProfileLabel).toBe('string');
+    } finally {
+      cleanupWorkspace(workspace);
+    }
+  });
+});