@houwert/conductor 0.2.0 → 0.3.0

package/dist/commands/install.js

@@ -3,25 +3,86 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.installSkills = installSkills;
+exports.installLocalSkills = installLocalSkills;
 exports.installPlugin = installPlugin;
+exports.HELP = `  install                             Install/reinstall Claude Code plugin
+  install --skills                    Copy skills into local .claude/skills/
+  install --check                     Print current install status without modifying anything`;
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const output_js_1 = require("../output.js");
 const pkg_root_js_1 = require("../pkg-root.js");
-async function installSkills(opts) {
+async function installSkills(opts, skillsOnly = false, check = false) {
     try {
-        installPlugin();
-        (0, output_js_1.printSuccess)('Conductor Claude Code plugin installed', opts);
+        if (check) {
+            return checkInstallStatus(opts);
+        }
+        if (skillsOnly) {
+            installLocalSkills();
+            (0, output_js_1.printSuccess)('Conductor skills installed → .claude/skills/conductor/', opts);
+        }
+        else {
+            const version = installPlugin();
+            const pluginCacheDir = path_1.default.join(os_1.default.homedir(), '.claude', 'plugins', 'cache', 'conductor', 'conductor', version);
+            (0, output_js_1.printSuccess)(`Conductor plugin installed (v${version}) → ${pluginCacheDir}`, opts);
+        }
         return 0;
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        (0, output_js_1.printError)(`Plugin install failed: ${message}`, opts);
+        (0, output_js_1.printError)(`Install failed: ${message}`, opts);
         return 1;
     }
 }
+function checkInstallStatus(opts) {
+    const installedPluginsPath = path_1.default.join(os_1.default.homedir(), '.claude', 'plugins', 'installed_plugins.json');
+    const localSkillsPath = path_1.default.join(process.cwd(), '.claude', 'skills', 'conductor', 'SKILL.md');
+    let pluginVersion = null;
+    if (fs_1.default.existsSync(installedPluginsPath)) {
+        const installed = JSON.parse(fs_1.default.readFileSync(installedPluginsPath, 'utf8'));
+        const entry = installed.plugins.find((p) => p.name === 'conductor');
+        if (entry)
+            pluginVersion = entry.version;
+    }
+    const hasLocalSkills = fs_1.default.existsSync(localSkillsPath);
+    if (opts.json) {
+        (0, output_js_1.printData)({
+            globalPlugin: { installed: pluginVersion !== null, version: pluginVersion },
+            localSkills: { installed: hasLocalSkills },
+        }, opts);
+    }
+    else {
+        if (pluginVersion) {
+            console.log(`Global plugin: installed (v${pluginVersion})`);
+        }
+        else {
+            console.log('Global plugin: not installed');
+        }
+        if (hasLocalSkills) {
+            console.log('Local skills: installed → .claude/skills/conductor/');
+        }
+        else {
+            console.log('Local skills: not installed');
+        }
+        if (!pluginVersion && !hasLocalSkills) {
+            console.log('\nRun `conductor install` to install the global plugin.');
+            console.log('Run `conductor install --skills` to copy skills into this project.');
+        }
+    }
+    return 0;
+}
+function installLocalSkills() {
+    const pkgRoot = (0, pkg_root_js_1.findPkgRoot)(__dirname);
+    const skillsSrc = path_1.default.join(pkgRoot, 'skills', 'conductor');
+    if (!fs_1.default.existsSync(skillsSrc)) {
+        throw new Error(`No skills found at ${skillsSrc}`);
+    }
+    const skillsDest = path_1.default.join(process.cwd(), '.claude', 'skills', 'conductor');
+    copyDir(skillsSrc, skillsDest);
+}
 function installPlugin() {
     const pkgRoot = (0, pkg_root_js_1.findPkgRoot)(__dirname);
     const pkgJsonPath = path_1.default.join(pkgRoot, 'package.json');
@@ -43,11 +104,15 @@ function installPlugin() {
     let installed = { plugins: [] };
     if (fs_1.default.existsSync(installedPluginsPath)) {
         installed = JSON.parse(fs_1.default.readFileSync(installedPluginsPath, 'utf8'));
+        if (!Array.isArray(installed.plugins)) {
+            installed.plugins = [];
+        }
     }
     installed.plugins = installed.plugins.filter((p) => p.name !== 'conductor');
     installed.plugins.push({ name: 'conductor', version, path: pluginCacheDir });
     fs_1.default.mkdirSync(path_1.default.dirname(installedPluginsPath), { recursive: true });
     fs_1.default.writeFileSync(installedPluginsPath, JSON.stringify(installed, null, 2));
+    return version;
 }
 function copyDir(src, dest) {
     fs_1.default.mkdirSync(dest, { recursive: true });

package/dist/commands/launch-app.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.launchApp = launchApp;
+exports.HELP = `  launch-app <appId>                  Launch app (saves to session)
+    --clear-state                     Clear app data/state before launching
+    --clear-keychain                  Clear keychain before launching
+    --no-stop-app                     Do not stop the app before launching (resume instead of restart)
+    --argument key=value              Set launch argument (repeatable)`;
 const runner_js_1 = require("../runner.js");
 const session_js_1 = require("../session.js");
 const output_js_1 = require("../output.js");

package/dist/commands/list-apps.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.listApps = listApps;
+exports.HELP = `  list-apps                           List installed app IDs / package names`;
 const runner_js_1 = require("../runner.js");
 const session_js_1 = require("../session.js");
 const output_js_1 = require("../output.js");

package/dist/commands/list-devices.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+exports.discoverBootedDevices = discoverBootedDevices;
+exports.discoverAvailableDevices = discoverAvailableDevices;
 exports.listDevices = listDevices;
+exports.HELP = `  list-devices                        List booted and available devices/simulators`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
-async function listDevices(opts) {
+async function discoverBootedDevices() {
     const devices = [];
     // Try adb devices (Android)
     const adb = await (0, runner_js_1.spawnCommand)('adb', ['devices', '-l']);
@@ -28,13 +32,13 @@ async function listDevices(opts) {
     if (xcrun.success) {
         try {
             const parsed = JSON.parse(xcrun.stdout);
-            for (const [_runtime, sims] of Object.entries(parsed.devices)) {
+            for (const [runtime, sims] of Object.entries(parsed.devices)) {
                 for (const sim of sims) {
                     if (sim.state === 'Booted') {
                         devices.push({
                             id: sim.udid,
                             name: sim.name,
-                            platform: 'ios',
+                            platform: runtime.includes('tvOS') ? 'tvos' : 'ios',
                             status: 'booted',
                         });
                     }
@@ -45,16 +49,75 @@ async function listDevices(opts) {
             // ignore parse errors
         }
     }
-    if (devices.length === 0) {
+    return devices;
+}
+async function discoverAvailableDevices() {
+    const devices = [];
+    // iOS: all available simulators that are not booted
+    const xcrun = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'list', 'devices', '--json']);
+    if (xcrun.success) {
+        try {
+            const parsed = JSON.parse(xcrun.stdout);
+            for (const [runtime, sims] of Object.entries(parsed.devices)) {
+                for (const sim of sims) {
+                    if (sim.isAvailable && sim.state !== 'Booted') {
+                        devices.push({
+                            id: sim.udid,
+                            name: sim.name,
+                            platform: runtime.includes('tvOS') ? 'tvos' : 'ios',
+                            status: sim.state.toLowerCase(),
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // ignore parse errors
+        }
+    }
+    // Android: list available AVDs
+    const emu = await (0, runner_js_1.spawnCommand)('emulator', ['-list-avds']);
+    if (emu.success) {
+        for (const line of emu.stdout.split('\n')) {
+            const name = line.trim();
+            if (name) {
+                devices.push({ id: name, name, platform: 'android', status: 'available' });
+            }
+        }
+    }
+    return devices;
+}
+async function listDevices(opts) {
+    const [devices, availableDevices] = await Promise.all([
+        discoverBootedDevices(),
+        discoverAvailableDevices(),
+    ]);
+    if (devices.length === 0 && availableDevices.length === 0) {
         (0, output_js_1.printError)('No devices found. Start an emulator or simulator first.', opts);
         return 1;
     }
     if (opts.json) {
-        (0, output_js_1.printData)({ status: 'ok', devices }, opts);
+        (0, output_js_1.printData)({ status: 'ok', devices, availableDevices }, opts);
     }
     else {
-        for (const d of devices) {
-            console.log(`${d.platform.padEnd(8)} ${d.status.padEnd(10)} ${d.id}  ${d.name}`);
+        if (devices.length > 0) {
+            console.log('Booted devices:');
+            for (const d of devices) {
+                console.log(`  ${d.platform.padEnd(8)} ${d.status.padEnd(10)} ${d.id}  ${d.name}`);
+            }
+        }
+        else {
+            console.log('No booted devices.');
+        }
+        console.log('');
+        if (availableDevices.length > 0) {
+            console.log('Available devices:');
+            for (const d of availableDevices) {
+                console.log(`  ${d.platform.padEnd(8)} ${d.status.padEnd(10)} ${d.id}  ${d.name}`);
+            }
+        }
+        else {
+            console.log('No available devices.');
         }
     }
     return 0;

package/dist/commands/open-link.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.openLink = openLink;
+exports.HELP = `  open-link <url>                     Open a URL / deep link`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 async function openLink(url, opts = {}, sessionName = 'default') {

package/dist/commands/press-key.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.pressKey = pressKey;
+exports.HELP = `  press-key <key>                     Press a key (Enter, Backspace, Home, ...)`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
@@ -20,6 +22,26 @@ const VALID_KEYS = [
     'Back',
     'Camera',
     'Search',
+    'Remote Dpad Up',
+    'Remote Dpad Down',
+    'Remote Dpad Left',
+    'Remote Dpad Right',
+    'Remote Dpad Center',
+    'Remote Media Play Pause',
+    'Remote Media Stop',
+    'Remote Media Next',
+    'Remote Media Previous',
+    'Remote Media Rewind',
+    'Remote Media Fast Forward',
+    'Remote System Navigation Up',
+    'Remote System Navigation Down',
+    'Remote Button A',
+    'Remote Button B',
+    'Remote Menu',
+    'TV Input',
+    'TV Input HDMI 1',
+    'TV Input HDMI 2',
+    'TV Input HDMI 3',
 ];
 // iOS XCTest pressKey accepts these values (maps to XCUIKeyboardKey)
 const IOS_KEY_MAP = {
@@ -34,6 +56,16 @@ const IOS_BUTTON_MAP = {
     Lock: 'lock',
     Power: 'lock',
 };
+// tvOS remote: map key names to pressButton values
+const TVOS_REMOTE_BUTTONS = {
+    'Remote Dpad Up': 'up',
+    'Remote Dpad Down': 'down',
+    'Remote Dpad Left': 'left',
+    'Remote Dpad Right': 'right',
+    'Remote Dpad Center': 'select',
+    'Remote Menu': 'menu',
+    'Remote Media Play Pause': 'playPause',
+};
 // Android keyevent codes
 const ANDROID_KEYCODE = {
     Home: 3,
@@ -50,6 +82,27 @@ const ANDROID_KEYCODE = {
     Search: 84,
     Escape: 111,
     End: 123,
+    // Android TV remote keys
+    'Remote Dpad Up': 19,
+    'Remote Dpad Down': 20,
+    'Remote Dpad Left': 21,
+    'Remote Dpad Right': 22,
+    'Remote Dpad Center': 23,
+    'Remote Media Play Pause': 85,
+    'Remote Media Stop': 86,
+    'Remote Media Next': 87,
+    'Remote Media Previous': 88,
+    'Remote Media Rewind': 89,
+    'Remote Media Fast Forward': 90,
+    'Remote System Navigation Up': 280,
+    'Remote System Navigation Down': 281,
+    'Remote Button A': 96,
+    'Remote Button B': 97,
+    'Remote Menu': 82,
+    'TV Input': 178,
+    'TV Input HDMI 1': 243,
+    'TV Input HDMI 2': 244,
+    'TV Input HDMI 3': 245,
 };
 async function pressKey(key, opts = {}, sessionName = 'default') {
     if (!key) {
@@ -63,15 +116,28 @@ async function pressKey(key, opts = {}, sessionName = 'default') {
     }
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
         if (driver instanceof ios_js_1.IOSDriver) {
-            const iosKey = IOS_KEY_MAP[matched];
-            const iosButton = IOS_BUTTON_MAP[matched];
-            if (iosKey) {
-                await driver.pressKey(iosKey);
+            if (driver.platform === 'tvos') {
+                const tvosButton = TVOS_REMOTE_BUTTONS[matched];
+                const iosButton = IOS_BUTTON_MAP[matched];
+                if (tvosButton) {
+                    await driver.pressButton(tvosButton);
+                }
+                else if (iosButton) {
+                    await driver.pressButton(iosButton);
+                }
+                // Keys not mapped on tvOS are silently ignored
             }
-            else if (iosButton) {
-                await driver.pressButton(iosButton);
+            else {
+                const iosKey = IOS_KEY_MAP[matched];
+                const iosButton = IOS_BUTTON_MAP[matched];
+                if (iosKey) {
+                    await driver.pressKey(iosKey);
+                }
+                else if (iosButton) {
+                    await driver.pressButton(iosButton);
+                }
+                // Keys not mapped on iOS (e.g. Back, VolumeUp) are silently ignored
             }
-            // Keys not mapped on iOS (e.g. Back, VolumeUp) are silently ignored
         }
         else if (driver instanceof android_js_1.AndroidDriver) {
             const code = ANDROID_KEYCODE[matched];

package/dist/commands/run-flow-inline.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.runFlowInline = runFlowInline;
+exports.HELP = `  run-flow-inline <yaml>              Run inline YAML commands
+    --benchmark                       Print elapsed time for each command and total flow time`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 /** run-flow-inline: Execute inline Maestro YAML commands natively via the flow runner. */

package/dist/commands/run-flow.js

@@ -3,7 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.runFlow = runFlow;
+exports.HELP = `  run-flow <file> [--device <id>]     Run a Maestro YAML flow file
+    --env KEY=VALUE                   Inject env var (repeatable; overrides flow env block)
+    --benchmark                       Print elapsed time for each command and total flow time`;
 const path_1 = __importDefault(require("path"));
 const runner_js_1 = require("../runner.js");
 const flow_runner_js_1 = require("../drivers/flow-runner.js");

package/dist/commands/run-parallel.js

@@ -3,7 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.runParallel = runParallel;
+exports.HELP = `  run-parallel --flows-dir <path>     Run flows in parallel across all devices`;
 /**
  * run-parallel: Run Maestro YAML flows in parallel across all booted simulators.
  *

package/dist/commands/screenshot.js

@@ -3,7 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.screenshot = screenshot;
+exports.HELP = `  screenshot [--output <path>]        Take screenshot`;
 const path_1 = __importDefault(require("path"));
 const promises_1 = __importDefault(require("fs/promises"));
 const runner_js_1 = require("../runner.js");

package/dist/commands/scroll-until-visible.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.scrollUntilVisible = scrollUntilVisible;
+exports.HELP = `  scroll-until-visible <element>      Scroll until element is visible
+    --id <id>                         Match by accessibility id instead of text
+    --text <text>                     Match by text only (not id)
+    --direction <down|up|left|right>  Scroll direction (default: down)
+    --timeout <ms>                    Max time in milliseconds (default: 30000)`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");

package/dist/commands/scroll.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.scroll = scroll;
+exports.HELP = `  scroll [--direction down|up|left|right]`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
@@ -13,6 +15,10 @@ async function scroll(direction = 'down', opts = {}, sessionName = 'default') {
         return 1;
     }
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
+        if (driver instanceof ios_js_1.IOSDriver && driver.platform === 'tvos') {
+            throw new Error('scroll is not supported on tvOS — Apple TV uses focus-based navigation.\n' +
+                'Use press-key to navigate (e.g. conductor press-key down).');
+        }
         const coords = (0, utils_js_1.swipeCoords)(direction);
         if (driver instanceof ios_js_1.IOSDriver) {
             const info = await driver.deviceInfo();

package/dist/commands/session.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.sessionCmd = sessionCmd;
+exports.HELP = `  session [--clear] [--list]          Show, clear, or list device sessions`;
 const session_js_1 = require("../session.js");
 const output_js_1 = require("../output.js");
 async function sessionCmd(clear, list, opts = {}, sessionName = 'default') {

package/dist/commands/set-location.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.setLocation = setLocation;
+exports.HELP = `  set-location --lat <n> --lng <n>    Set GPS coordinates`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 async function setLocation(latitude, longitude, opts = {}, sessionName = 'default') {

package/dist/commands/set-orientation.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.setOrientation = setOrientation;
+exports.HELP = `  set-orientation <portrait|landscape> Set device orientation`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const VALID = ['portrait', 'landscape'];