@playdrop/playdrop-cli 0.10.20 → 0.10.21

package/config/client-meta.json

@@ -1,10 +1,14 @@
 {
-  "version": "0.10.20",
+  "version": "0.10.21",
   "build": 1,
   "runtimeSdkVersion": "0.10.0",
   "clients": {
     "all": {
       "minimumVersion": "0.7.4"
+    },
+    "windows-playdrop": {
+      "minimumVersion": "0.9.6",
+      "minimumBuild": 1
     }
   }
 }

package/dist/apps/build.js

@@ -33,9 +33,10 @@ const projectBuildCache = new Map();
 const typescriptSourceCache = new Map();
 async function runNpmScript(projectDir, script) {
     await (0, promises_1.mkdir)(projectDir, { recursive: true });
-    const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    const npmCommand = process.platform === 'win32' ? process.env.ComSpec || 'cmd.exe' : 'npm';
+    const npmArgs = process.platform === 'win32' ? ['/d', '/s', '/c', `npm run ${script}`] : ['run', script];
     await new Promise((resolveRun, rejectRun) => {
-        const child = (0, node_child_process_1.spawn)(npmCommand, ['run', script], {
+        const child = (0, node_child_process_1.spawn)(npmCommand, npmArgs, {
             cwd: projectDir,
             stdio: 'inherit',
             env: { ...process.env },

package/dist/commands/agents.js

@@ -88,11 +88,16 @@ async function detectCli(command, runShell) {
     if (pathProbe.exitCode !== 0 || pathProbe.output.trim().length === 0) {
         return { installed: false };
     }
+    const path = pathProbe.output.split('\n')[0]?.trim();
     const versionProbe = await runShell(`${command} --version`);
+    const version = versionProbe.output.split('\n')[0]?.trim() || undefined;
+    if (versionProbe.exitCode !== 0 && !/\d+\.\d+\.\d+/.test(versionProbe.output)) {
+        return { installed: false, path };
+    }
     return {
         installed: true,
-        path: pathProbe.output.split('\n')[0]?.trim(),
-        version: versionProbe.exitCode === 0 ? versionProbe.output.split('\n')[0]?.trim() : undefined,
+        path,
+        version,
     };
 }
 function detectApp(appNames, homeDir, appExists) {
@@ -285,6 +290,9 @@ function printAgentsStatus(status) {
     }
 }
 function runCodexPluginAction(action, runCommand) {
+    if (!ensureAgentCliUsable('codex', runCommand)) {
+        return;
+    }
     const marketplaceCommand = action === 'install-plugin'
         ? ['plugin', 'marketplace', 'add', PLAYDROP_PLUGIN_MARKETPLACE]
         : ['plugin', 'marketplace', 'upgrade', 'playdrop'];
@@ -340,6 +348,9 @@ function runCodexPluginAction(action, runCommand) {
     console.log('Open Codex and run /plugins, then install or enable PlayDrop.');
 }
 function runClaudePluginAction(action, runCommand) {
+    if (!ensureAgentCliUsable('claude', runCommand)) {
+        return;
+    }
     if (action === 'install-plugin') {
         const marketplace = runCommand('claude', ['plugin', 'marketplace', 'add', PLAYDROP_PLUGIN_MARKETPLACE]);
         if (marketplace.status !== 0) {
@@ -379,6 +390,21 @@ function runClaudePluginAction(action, runCommand) {
     console.log('Updated the PlayDrop plugin for Claude.');
     console.log('Run /reload-plugins in Claude Code or restart Claude Code to apply it.');
 }
+function ensureAgentCliUsable(command, runCommand) {
+    const result = runCommand(command, ['--version']);
+    const output = commandOutput(result).trim();
+    if (result.status === 0 || /\d+\.\d+\.\d+/.test(output)) {
+        return true;
+    }
+    const label = command === 'codex' ? 'Codex' : 'Claude';
+    console.error(`${label} CLI is missing or not runnable.`);
+    console.error(`${command} --version failed with code ${result.status ?? 'unknown'}.`);
+    if (output) {
+        console.error(`Output: ${output}`);
+    }
+    process.exitCode = 1;
+    return false;
+}
 function readInstalledPlayDropPlugin(command, runCommand) {
     const list = runCommand(command, ['plugin', 'list', '--json']);
     if (list.status !== 0) {
@@ -477,9 +503,10 @@ async function runLoginShell(command) {
 }
 function runCommandSync(command, args) {
     const result = (0, node_child_process_1.spawnSync)(command, args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+    const spawnError = result.error instanceof Error ? result.error.message : '';
     return {
         status: result.status,
         stdout: result.stdout ?? '',
-        stderr: result.stderr ?? '',
+        stderr: [result.stderr ?? '', spawnError].filter(Boolean).join('\n'),
     };
 }

package/dist/commands/clients.js

@@ -17,6 +17,9 @@ const output_1 = require("../output");
 const versionCompare_1 = require("../versionCompare");
 const MAC_APP_PATH = '/Applications/PlayDrop.app';
 const MAC_CLIENT_LATEST_URL = 'https://www.playdrop.ai/api/mac-client/latest';
+const WINDOWS_CLIENT_EXECUTABLE = 'PlayDrop.exe';
+const WINDOWS_CLIENT_INSTALL_HINT = 'Install or update PlayDrop for Windows with the Windows installer or the in-app updater.';
+const WINDOWS_CLIENT_PATH_ENV = 'PLAYDROP_WINDOWS_CLIENT_PATH';
 async function showClientStatus(options = {}) {
     const status = await getClientStatus(options);
     if (options.json) {
@@ -29,6 +32,9 @@ async function showClientStatus(options = {}) {
 }
 async function getClientStatus(options = {}) {
     const platform = options.platform ?? process.platform;
+    if (platform === 'win32') {
+        return getWindowsClientStatus(options);
+    }
     if (platform !== 'darwin') {
         return {
             platform,
@@ -65,6 +71,24 @@ async function updateClient(options = {}) {
 }
 async function launchClient(options = {}) {
     const platform = options.platform ?? process.platform;
+    if (platform === 'win32') {
+        const status = await getWindowsClientStatus(options);
+        if (!status.installed || !status.appPath) {
+            console.error('PlayDrop for Windows is not installed.');
+            console.error(WINDOWS_CLIENT_INSTALL_HINT);
+            process.exitCode = 1;
+            return;
+        }
+        const runCommand = options.runCommand ?? runCommandSync;
+        const result = runCommand(status.appPath, []);
+        if (result.status !== 0) {
+            console.error(`Failed to launch PlayDrop from ${status.appPath}.`);
+            process.exitCode = 1;
+            return;
+        }
+        console.log('Launched PlayDrop.');
+        return;
+    }
     if (platform !== 'darwin') {
         printUnsupportedPlatform(platform);
         return;
@@ -87,6 +111,12 @@ async function launchClient(options = {}) {
 }
 async function installOrUpdateClient(action, options) {
     const platform = options.platform ?? process.platform;
+    if (platform === 'win32') {
+        console.error(`PlayDrop for Windows ${action} is not available through the CLI yet.`);
+        console.error(WINDOWS_CLIENT_INSTALL_HINT);
+        process.exitCode = 1;
+        return;
+    }
     if (platform !== 'darwin') {
         printUnsupportedPlatform(platform);
         return;
@@ -129,7 +159,12 @@ function printClientStatus(status) {
     }
     if (!status.installed) {
         console.log('PlayDrop client: missing');
-        console.log('Run: playdrop clients install');
+        if (status.nextAction) {
+            console.log(`Run: ${status.nextAction}`);
+        }
+        else if (status.reason) {
+            console.log(status.reason);
+        }
         return;
     }
     const version = status.version ? ` ${status.version}` : '';
@@ -141,6 +176,68 @@ function printClientStatus(status) {
         console.log('Run: playdrop clients update');
     }
 }
+async function getWindowsClientStatus(options) {
+    const appPath = resolveWindowsClientPath(options.appPath);
+    if (!appPath) {
+        return {
+            platform: 'win32',
+            supported: true,
+            status: 'missing',
+            installed: false,
+            reason: WINDOWS_CLIENT_INSTALL_HINT,
+        };
+    }
+    const bundle = readWindowsClientInfo(appPath);
+    return {
+        platform: 'win32',
+        supported: true,
+        status: 'installed',
+        installed: true,
+        appPath,
+        version: bundle.version,
+        build: bundle.build,
+        updateAvailable: false,
+    };
+}
+function resolveWindowsClientPath(explicitPath) {
+    const candidates = windowsClientPathCandidates(explicitPath);
+    return candidates.find((candidate) => (0, node_fs_1.existsSync)(candidate));
+}
+function windowsClientPathCandidates(explicitPath) {
+    const candidates = [];
+    const add = (value) => {
+        if (value && value.trim().length > 0) {
+            candidates.push(value.trim());
+        }
+    };
+    add(explicitPath);
+    add(process.env[WINDOWS_CLIENT_PATH_ENV]);
+    const localAppData = process.env.LOCALAPPDATA;
+    if (localAppData) {
+        add((0, node_path_1.join)(localAppData, 'PlayDrop.Windows', 'current', WINDOWS_CLIENT_EXECUTABLE));
+        add((0, node_path_1.join)(localAppData, 'PlayDrop', 'current', WINDOWS_CLIENT_EXECUTABLE));
+    }
+    add(process.env.ProgramFiles ? (0, node_path_1.join)(process.env.ProgramFiles, 'PlayDrop', WINDOWS_CLIENT_EXECUTABLE) : undefined);
+    add(process.env['ProgramFiles(x86)'] ? (0, node_path_1.join)(process.env['ProgramFiles(x86)'], 'PlayDrop', WINDOWS_CLIENT_EXECUTABLE) : undefined);
+    return [...new Set(candidates)];
+}
+function readWindowsClientInfo(appPath) {
+    for (const versionPath of [
+        (0, node_path_1.join)((0, node_path_1.dirname)(appPath), 'sq.version'),
+        (0, node_path_1.join)((0, node_path_1.dirname)((0, node_path_1.dirname)(appPath)), 'sq.version'),
+    ]) {
+        try {
+            const version = (0, node_fs_1.readFileSync)(versionPath, 'utf8').trim();
+            if (version.length > 0) {
+                return { version };
+            }
+        }
+        catch {
+            // Development and portable builds may not have a Velopack version file.
+        }
+    }
+    return {};
+}
 async function fetchLatestMacClientManifest() {
     try {
         const response = await fetch(MAC_CLIENT_LATEST_URL, { headers: { Accept: 'application/json' } });

package/dist/commands/doctor.d.ts

@@ -22,6 +22,14 @@ interface CliHealth {
     updateStatus: 'current' | 'update-available' | 'unknown';
     updateAvailable?: boolean;
     nextAction?: string;
+    command?: CliCommandHealth;
+}
+interface CliCommandHealth {
+    available: boolean;
+    path?: string;
+    npmGlobalBin?: string;
+    npmShimPath?: string;
+    issue?: 'not-on-path' | 'shim-missing';
 }
 export interface DoctorReport {
     cli: CliHealth;

package/dist/commands/doctor.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showDoctor = showDoctor;
 const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
 const clientInfo_1 = require("../clientInfo");
 const config_1 = require("../config");
 const output_1 = require("../output");
@@ -61,11 +62,13 @@ async function getAccountHealth() {
 }
 async function getCliHealth() {
     const currentVersion = (0, clientInfo_1.getCliVersion)();
+    const command = getCliCommandHealth();
     const result = (0, shellProbe_1.runShell)('npm view @playdrop/playdrop-cli version --json');
     if (result.exitCode !== 0 || !result.output.trim()) {
         return {
             version: (0, clientInfo_1.getCliVersionLabel)(),
             updateStatus: 'unknown',
+            command,
         };
     }
     const latestVersion = parseNpmVersion(result.output);
@@ -73,6 +76,7 @@ async function getCliHealth() {
         return {
             version: (0, clientInfo_1.getCliVersionLabel)(),
             updateStatus: 'unknown',
+            command,
         };
     }
     const updateAvailable = (0, versionCompare_1.firstVersionIsNewer)(latestVersion, currentVersion);
@@ -82,8 +86,34 @@ async function getCliHealth() {
         updateStatus: updateAvailable ? 'update-available' : 'current',
         updateAvailable,
         nextAction: updateAvailable ? 'playdrop update' : undefined,
+        command,
     };
 }
+function getCliCommandHealth(platform = process.platform) {
+    const pathProbe = (0, shellProbe_1.runShell)((0, shellProbe_1.buildCommandPathProbe)('playdrop', platform), platform);
+    if (pathProbe.exitCode === 0 && pathProbe.output.trim()) {
+        return {
+            available: true,
+            path: pathProbe.output.split('\n')[0]?.trim(),
+        };
+    }
+    if (platform !== 'win32') {
+        return { available: false, issue: 'not-on-path' };
+    }
+    const npmGlobalBin = resolveNpmGlobalBin(platform);
+    const npmShimPath = npmGlobalBin ? (0, node_path_1.join)(npmGlobalBin, 'playdrop.cmd') : undefined;
+    const shimExists = npmShimPath ? (0, node_fs_1.existsSync)(npmShimPath) : false;
+    return {
+        available: false,
+        npmGlobalBin,
+        npmShimPath: shimExists ? npmShimPath : undefined,
+        issue: shimExists ? 'not-on-path' : 'shim-missing',
+    };
+}
+function resolveNpmGlobalBin(platform) {
+    const prefix = (0, shellProbe_1.runShell)('npm config get prefix', platform).output.split('\n')[0]?.trim();
+    return prefix && prefix.length > 0 ? prefix : undefined;
+}
 function parseNpmVersion(output) {
     const trimmed = output.trim();
     try {
@@ -164,6 +194,7 @@ function printDoctorReport(report) {
             ? ', current'
             : ', update status unknown';
     console.log(`PlayDrop CLI: ${report.cli.version}${cliUpdate}`);
+    printCliCommandDoctorStatus(report.cli.command);
     console.log(`Account: ${report.account.loggedIn ? report.account.identity ?? 'logged in' : 'not logged in'}`);
     console.log(`Node: ${report.tools.node.installed ? report.tools.node.version ?? 'installed' : 'missing'}`);
     console.log(`npm: ${report.tools.npm.installed ? report.tools.npm.version ?? 'installed' : 'missing'}`);
@@ -192,6 +223,22 @@ function printDoctorReport(report) {
         }
     }
 }
+function printCliCommandDoctorStatus(command) {
+    if (!command) {
+        return;
+    }
+    if (command.available) {
+        console.log(`CLI command: ${command.path ?? 'available'}`);
+        return;
+    }
+    console.log('CLI command: not on PATH');
+    if (command.npmShimPath) {
+        console.log(`  Direct npm shim: ${command.npmShimPath}`);
+    }
+    if (command.npmGlobalBin) {
+        console.log(`  Add ${command.npmGlobalBin} to PATH for new PowerShell sessions.`);
+    }
+}
 function printNativeClientDoctorStatus(status) {
     if (!status.supported) {
         console.log(`Native client: unavailable on ${status.platform}`);
@@ -199,6 +246,9 @@ function printNativeClientDoctorStatus(status) {
     }
     if (!status.installed) {
         console.log('Native client: missing');
+        if (status.reason) {
+            console.log(`  ${status.reason}`);
+        }
         return;
     }
     const statusLabel = status.updateAvailable ? 'update available' : 'up to date';

package/dist/commands/generation.js

@@ -419,6 +419,9 @@ function resolveImageAttachment(value, optionName) {
         return undefined;
     }
     const trimmed = value.trim();
+    if ((0, node_path_1.isAbsolute)(trimmed)) {
+        return resolveLocalImageAttachment(optionName, trimmed);
+    }
     try {
         const parsed = new URL(trimmed);
         if (parsed.protocol !== 'https:') {

package/dist/commands/worker/runtime.js

@@ -525,6 +525,12 @@ function normalizeClaudePermissionPath(value) {
     if (!trimmed) {
         return null;
     }
+    if (/^\/[^/]/.test(trimmed)) {
+        return node_path_1.default.posix.resolve(trimmed).replace(/\/+$/, '');
+    }
+    if (/^[A-Za-z]:[\\/]/.test(trimmed) || /^\\\\/.test(trimmed)) {
+        return node_path_1.default.win32.resolve(trimmed).replace(/\\/g, '/').replace(/\/+$/, '');
+    }
     return node_path_1.default.resolve(trimmed).replace(/\\/g, '/').replace(/\/+$/, '');
 }
 function buildClaudePermissionSettings(denyReadRoots = []) {

package/dist/commands/worker.d.ts

@@ -31,6 +31,7 @@ type WorkerLocalStatus = {
     playwright: {
         version?: string;
         chromiumInstalled?: boolean;
+        executablePath?: string;
     } | null;
     plugin: {
         ready: boolean;
@@ -40,6 +41,13 @@ type WorkerLocalStatus = {
     };
     agents: AgentWorkerCapabilities['agents'];
     capabilities: AgentWorkerCapabilities | null;
+    setupActions: WorkerSetupAction[];
+};
+type WorkerSetupAction = {
+    reason: string;
+    label: string;
+    command?: string;
+    message: string;
 };
 type WorkerStatusPayload = {
     schemaVersion: 1;
@@ -205,6 +213,14 @@ export declare function createLocalPlaydropShim(input: {
     attempt: number;
     devPort: number;
 }): Promise<string>;
+export declare function buildWorkerSetupActions(input: {
+    degradedReasons: string[];
+    playwright?: {
+        version?: string;
+        chromiumInstalled?: boolean;
+        executablePath?: string;
+    } | null;
+}): WorkerSetupAction[];
 type WorkerRuntimeState = {
     schemaVersion: 1;
     pid: number;

package/dist/commands/worker.js

@@ -38,6 +38,7 @@ exports.assertWorkerProjectVersionBumped = assertWorkerProjectVersionBumped;
 exports.buildAgentFailureCode = buildAgentFailureCode;
 exports.describeAgentFailureForEvent = describeAgentFailureForEvent;
 exports.createLocalPlaydropShim = createLocalPlaydropShim;
+exports.buildWorkerSetupActions = buildWorkerSetupActions;
 exports.readActivePersonalWorkerRuntimeState = readActivePersonalWorkerRuntimeState;
 exports.parseLaunchAgentProgramArguments = parseLaunchAgentProgramArguments;
 exports.assertLaunchAgentPlistCompatible = assertLaunchAgentPlistCompatible;
@@ -1181,9 +1182,9 @@ function probePlaywrightChromium() {
     const version = typeof packageJson.version === 'string' && packageJson.version.trim() ? packageJson.version.trim() : 'unknown';
     const chromiumInstalled = (0, node_fs_1.existsSync)(executablePath);
     if (!chromiumInstalled) {
-        throw new Error(`worker_preflight_chromium_missing: install Playwright Chromium before starting the worker (${executablePath}).`);
+        return { version, chromiumInstalled: false, executablePath };
     }
-    return { version, chromiumInstalled };
+    return { version, chromiumInstalled: true, executablePath };
 }
 function readWorkerModelList(agent, envName) {
     const raw = node_process_1.default.env[envName];
@@ -1260,7 +1261,10 @@ function buildWorkerCapabilities(input) {
     const cursorVersion = typeof input === 'string' ? null : input.cursorVersion?.trim() || null;
     const cursorAuthenticated = typeof input === 'string' ? false : input.cursorAuthenticated === true;
     const npmVersion = typeof input === 'string' ? null : input.npmVersion?.trim() || null;
-    const playwright = typeof input === 'string' ? null : input.playwright ?? null;
+    const rawPlaywright = typeof input === 'string' ? null : input.playwright ?? null;
+    const playwright = rawPlaywright
+        ? { version: rawPlaywright.version, chromiumInstalled: rawPlaywright.chromiumInstalled }
+        : null;
     const maxParallelTasks = typeof input === 'string'
         ? DEFAULT_WORKER_MAX_PARALLEL_TASKS
         : input.maxParallelTasks ?? DEFAULT_WORKER_MAX_PARALLEL_TASKS;
@@ -1954,6 +1958,9 @@ function probeCodexInstallation() {
     const versionResult = (0, shellProbe_1.runShell)('codex --version');
     const match = /(\d+\.\d+\.\d+\S*)/.exec(versionResult.output);
     if (!match?.[1]) {
+        if (versionResult.exitCode !== 0) {
+            return null;
+        }
         throw new Error(`codex_version_check_failed: "codex --version" exited with code ${versionResult.exitCode} and reported no version. Output: ${versionResult.output.slice(0, 200)}`);
     }
     if (versionResult.exitCode !== 0) {
@@ -1970,7 +1977,13 @@ function probeClaudeInstallation() {
     }
     const versionResult = (0, shellProbe_1.runShell)('claude --version');
     const match = /(\d+\.\d+\.\d+\S*)/.exec(versionResult.output);
-    if (!match?.[1] || versionResult.exitCode !== 0) {
+    if (!match?.[1]) {
+        if (versionResult.exitCode !== 0) {
+            return null;
+        }
+        throw new Error(`claude_version_check_failed: "claude --version" exited with code ${versionResult.exitCode} and reported no version. Output: ${versionResult.output.slice(0, 200)}`);
+    }
+    if (versionResult.exitCode !== 0) {
         throw new Error(`claude_version_check_failed: "claude --version" exited with code ${versionResult.exitCode} and reported no version. Output: ${versionResult.output.slice(0, 200)}`);
     }
     return { claudeVersion: match[1] };
@@ -2076,6 +2089,9 @@ function collectWorkerLocalStatus() {
     }
     try {
         playwright = probePlaywrightChromium();
+        if (!playwright.chromiumInstalled) {
+            degradedReasons.push('worker_preflight_chromium_missing');
+        }
     }
     catch (error) {
         degradedReasons.push(errorCode(error));
@@ -2143,8 +2159,53 @@ function collectWorkerLocalStatus() {
         },
         agents: capabilities?.agents ?? [],
         capabilities,
+        setupActions: buildWorkerSetupActions({
+            degradedReasons: uniqueReasons,
+            playwright,
+        }),
     };
 }
+function buildWorkerSetupActions(input) {
+    const reasons = new Set(input.degradedReasons);
+    const actions = [];
+    if (reasons.has('worker_preflight_chromium_missing')) {
+        const version = input.playwright?.version && input.playwright.version !== 'unknown'
+            ? `@${input.playwright.version}`
+            : '';
+        actions.push({
+            reason: 'worker_preflight_chromium_missing',
+            label: 'Install Playwright Chromium',
+            command: `npx playwright${version} install chromium`,
+            message: input.playwright?.executablePath
+                ? `Chromium is required for PlayDrop launch checks. Expected browser path: ${input.playwright.executablePath}.`
+                : 'Chromium is required for PlayDrop launch checks.',
+        });
+    }
+    if (reasons.has('worker_preflight_playwright_missing')) {
+        actions.push({
+            reason: 'worker_preflight_playwright_missing',
+            label: 'Repair the PlayDrop CLI install',
+            command: 'npm install -g @playdrop/playdrop-cli@latest',
+            message: 'The PlayDrop CLI package could not load playwright-core from its installed dependencies.',
+        });
+    }
+    if (reasons.has('playdrop_plugin_staging_manifest_missing')) {
+        actions.push({
+            reason: 'playdrop_plugin_staging_manifest_missing',
+            label: 'Install or update the PlayDrop agent plugin',
+            command: 'playdrop agents status --json',
+            message: 'Run the CLI-reported nextAction.command for a supported local agent so playdrop-worker-staging.json is available.',
+        });
+    }
+    if (reasons.has('agent_cli_not_found')) {
+        actions.push({
+            reason: 'agent_cli_not_found',
+            label: 'Install a supported agent CLI',
+            message: 'Install and authenticate Codex or Claude Code, then rerun playdrop agents status --json.',
+        });
+    }
+    return actions;
+}
 function getWorkerStateDir() {
     return node_path_1.default.join(node_os_1.default.homedir(), '.playdrop', 'worker');
 }
@@ -2782,6 +2843,13 @@ function printWorkerStatus(payload) {
     if (payload.local.degradedReasons.length > 0) {
         console.log(`  Reasons: ${payload.local.degradedReasons.join(', ')}`);
     }
+    if (payload.local.setupActions.length > 0) {
+        console.log('  Setup actions:');
+        for (const action of payload.local.setupActions) {
+            console.log(`    ${action.label}${action.command ? `: ${action.command}` : ''}`);
+            console.log(`      ${action.message}`);
+        }
+    }
     if (!payload.server.authenticated) {
         console.log('Server worker: not authenticated');
     }

package/dist/commands/workspaces.js

@@ -307,7 +307,8 @@ function isMacProtectedWorkspaceRoot(rootPath, homeDir = node_os_1.default.homed
     return protectedRoots.some((protectedRoot) => absoluteRoot === protectedRoot || isPathInside(absoluteRoot, protectedRoot));
 }
 function isPathInside(candidate, parent) {
-    return candidate.startsWith(`${parent}/`);
+    const relativePath = (0, node_path_1.relative)(parent, candidate);
+    return Boolean(relativePath) && !relativePath.startsWith('..') && !(0, node_path_1.isAbsolute)(relativePath);
 }
 function isAllowedProtectedPath(candidate, allowedProtectedRoots) {
     return allowedProtectedRoots.some((allowedRoot) => candidate === allowedRoot || isPathInside(candidate, allowedRoot));

package/node_modules/@playdrop/config/client-meta.json

@@ -1,10 +1,14 @@
 {
-  "version": "0.10.20",
+  "version": "0.10.21",
   "build": 1,
   "runtimeSdkVersion": "0.10.0",
   "clients": {
     "all": {
       "minimumVersion": "0.7.4"
+    },
+    "windows-playdrop": {
+      "minimumVersion": "0.9.6",
+      "minimumBuild": 1
     }
   }
 }

package/node_modules/@playdrop/config/dist/test/validateClientEnvironment.test.js

@@ -80,6 +80,45 @@ function runtime(overrides = {}) {
     const result = (0, index_1.validateClientEnvironment)(info);
     strict_1.default.equal(result.ok, true);
 });
+(0, node_test_1.default)('accepts windows-playdrop as a first-class Windows client identity', () => {
+    const meta = (0, index_1.loadClientMeta)();
+    const windowsRule = meta.clients['windows-playdrop'];
+    strict_1.default.ok(windowsRule, 'windows-playdrop metadata must be explicit');
+    const requiredVersion = windowsRule.minimumVersion ?? meta.version;
+    const requiredBuild = windowsRule.minimumBuild ?? meta.build;
+    const info = runtime({
+        client: 'windows-playdrop',
+        clientVersion: requiredVersion,
+        clientBuild: requiredBuild,
+        platform: 'windows',
+        platformVersion: '10.0.22631',
+    });
+    const result = (0, index_1.validateClientEnvironment)(info);
+    strict_1.default.equal(result.ok, true);
+});
+(0, node_test_1.default)('enforces the windows-playdrop alpha build floor', () => {
+    const meta = (0, index_1.loadClientMeta)();
+    const windowsRule = meta.clients['windows-playdrop'];
+    strict_1.default.ok(windowsRule?.minimumVersion, 'windows-playdrop requires an explicit minimum version');
+    const requiredBuild = windowsRule.minimumBuild;
+    if (typeof requiredBuild !== 'number') {
+        strict_1.default.fail('windows-playdrop requires an explicit minimum build');
+    }
+    const info = runtime({
+        client: 'windows-playdrop',
+        clientVersion: windowsRule.minimumVersion,
+        clientBuild: Math.max(requiredBuild - 1, 0),
+        platform: 'windows',
+        platformVersion: '10.0.22631',
+    });
+    const result = (0, index_1.validateClientEnvironment)(info);
+    strict_1.default.equal(result.ok, false);
+    if (!result.ok) {
+        strict_1.default.equal(result.code, 'unsupported_client_build');
+        strict_1.default.equal(result.requiredVersion, windowsRule.minimumVersion);
+        strict_1.default.equal(result.requiredBuild, requiredBuild);
+    }
+});
 (0, node_test_1.default)('keeps accepting the legacy Apple client id during rollout', () => {
     const meta = (0, index_1.loadClientMeta)();
     const requiredVersion = meta.clients['all']?.minimumVersion ?? meta.version;