@devicecloud.dev/dcd 5.0.0-beta.0 → 5.0.0-beta.2

package/dist/utils/progress.js

@@ -1,25 +1,49 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ux = void 0;
 /**
  * Progress adapter that wraps @clack/prompts spinner with a
  * drop-in API for existing services that used oclif's `ux.action` / `ux.info`.
  *
  * Keeps call sites unchanged while migrating away from @oclif/core.
+ *
+ * TTY-awareness: @clack/prompts' spinner animates on a timer and, when stdout
+ * isn't a TTY (CI, pipes, redirects), it can't rewrite a line in place — every
+ * frame becomes a fresh line, flooding logs with hundreds of duplicates. In
+ * non-interactive environments we skip the spinner entirely and instead print a
+ * plain line once per *distinct* status, so CI logs show real progress without
+ * the flood.
  */
-const p = require("@clack/prompts");
+import * as p from '@clack/prompts';
+import { isCI } from './ci.js';
 class Action {
     current = null;
     _status = '';
+    // Last line emitted in non-interactive mode, for de-duplication.
+    _lastPrinted = '';
+    interactive() {
+        return process.stdout.isTTY === true && !isCI();
+    }
     start(title, initialStatus, _opts) {
+        this._status = initialStatus ?? '';
+        const line = initialStatus ? `${title} — ${initialStatus}` : title;
+        if (!this.interactive()) {
+            this.current = null;
+            this.print(line);
+            return;
+        }
         if (this.current) {
             this.current.stop();
         }
         this.current = p.spinner();
-        this._status = initialStatus ?? '';
-        this.current.start(initialStatus ? `${title} — ${initialStatus}` : title);
+        this.current.start(line);
     }
     stop(message) {
+        if (!this.interactive()) {
+            if (message)
+                this.print(message);
+            this.current = null;
+            this._status = '';
+            this._lastPrinted = '';
+            return;
+        }
         if (!this.current) {
             if (message) {
                 // eslint-disable-next-line no-console
@@ -33,15 +57,30 @@ class Action {
     }
     set status(value) {
         this._status = value;
-        if (this.current && value) {
+        if (!value)
+            return;
+        if (!this.interactive()) {
+            this.print(value);
+            return;
+        }
+        if (this.current) {
             this.current.message(value);
         }
     }
     get status() {
         return this._status;
     }
+    // Emit a line only when it differs from the previous one, so repeated polls
+    // with no state change stay quiet.
+    print(line) {
+        if (line === this._lastPrinted)
+            return;
+        this._lastPrinted = line;
+        // eslint-disable-next-line no-console
+        console.log(line);
+    }
 }
-exports.ux = {
+export const ux = {
     action: new Action(),
     info(message) {
         // eslint-disable-next-line no-console

package/dist/utils/styling.d.ts

@@ -1,4 +1,9 @@
-import chalk = require('chalk');
+/**
+ * Centralized styling utilities for CLI output
+ * Provides consistent, developer-friendly visual formatting
+ */
+/** Strip ANSI color escape sequences for visible-width calculations. */
+export declare const stripAnsi: (s: string) => string;
 /**
  * Status symbols with associated colors
  */
@@ -17,50 +22,49 @@ export declare const symbols: {
  * Color utility functions for semantic styling
  */
 export declare const colors: {
-    readonly bold: chalk.Chalk;
-    readonly dim: chalk.Chalk;
-    readonly error: chalk.Chalk;
-    readonly highlight: chalk.Chalk;
-    readonly info: chalk.Chalk;
-    readonly success: chalk.Chalk;
-    readonly url: chalk.Chalk;
-    readonly warning: chalk.Chalk;
+    readonly bold: import("chalk").ChalkInstance;
+    readonly dim: import("chalk").ChalkInstance;
+    readonly error: import("chalk").ChalkInstance;
+    readonly highlight: import("chalk").ChalkInstance;
+    readonly info: import("chalk").ChalkInstance;
+    readonly success: import("chalk").ChalkInstance;
+    readonly url: import("chalk").ChalkInstance;
+    readonly warning: import("chalk").ChalkInstance;
+};
+/**
+ * Structural glyphs that give the CLI its tree-shaped layout. `section` marks a
+ * top-level heading; `branch` opens the group of detail rows beneath it.
+ * See STYLE_GUIDE.md.
+ */
+export declare const glyphs: {
+    readonly branch: "⎿";
+    readonly section: "⏺";
 };
 /**
- * Dividers for visual separation
+ * The single source of truth mapping a run/test status to its colour and
+ * (already-coloured) symbol. Both {@link formatStatus} and the `ui` status
+ * helpers build on this, so every status reads identically everywhere.
+ * @param status - The status string (case-insensitive)
  */
-export declare const dividers: {
-    readonly heavy: string;
-    readonly light: string;
-    readonly short: string;
+export declare function statusPalette(status: string): {
+    color: (s: string) => string;
+    symbol: string;
 };
 /**
- * Format a status with appropriate symbol and color
+ * Format a status as a coloured symbol followed by the lowercased status word,
+ * e.g. `✓ passed`.
  * @param status - The status string to format
  * @returns Formatted status string with color and symbol
  */
 export declare function formatStatus(status: string): string;
 /**
- * Format a section header
+ * Format a top-level section header in the tree style: a `⏺` marker followed by
+ * the bold title, preceded by a blank line for separation. Detail rows belong
+ * underneath in a branch group (see the `ui` helpers).
  * @param title - The title of the section
  * @returns Formatted section header
  */
 export declare function sectionHeader(title: string): string;
-/**
- * Format a key-value pair with optional icon
- * @param icon - Icon to display before the key
- * @param key - The key name
- * @param value - The value to display
- * @returns Formatted key-value string
- */
-export declare function keyValue(icon: string, key: string, value: string): string;
-/**
- * Format a list item
- * @param text - The text of the list item
- * @param prefix - The prefix character (default: '•')
- * @returns Formatted list item
- */
-export declare function listItem(text: string, prefix?: string): string;
 /**
  * Format a URL
  * @param url - The URL to format
@@ -87,12 +91,6 @@ export declare function formatTestSummary(summary: {
     running: number;
     total: number;
 }): string;
-/**
- * Format a box with content
- * @param content - The content to display in the box
- * @returns Formatted box with borders
- */
-export declare function box(content: string): string;
 /**
  * Minimal column table renderer.
  * Columns are defined with a `get(row) => string` accessor and optional header label.

package/dist/utils/styling.js

@@ -1,29 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.dividers = exports.colors = exports.symbols = void 0;
-exports.formatStatus = formatStatus;
-exports.sectionHeader = sectionHeader;
-exports.keyValue = keyValue;
-exports.listItem = listItem;
-exports.formatUrl = formatUrl;
-exports.formatId = formatId;
-exports.formatTestSummary = formatTestSummary;
-exports.box = box;
-exports.table = table;
-exports.getConsoleUrl = getConsoleUrl;
-const chalk = require("chalk");
-const environments_1 = require("../config/environments");
+import chalk from 'chalk';
+import { findEnvByApiUrl } from '../config/environments.js';
 /**
  * Centralized styling utilities for CLI output
  * Provides consistent, developer-friendly visual formatting
  */
 /** Strip ANSI color escape sequences for visible-width calculations. */
 // eslint-disable-next-line no-control-regex -- matches ANSI escape sequences
-const stripAnsi = (s) => s.replace(/\u001B\[[0-9;]*m/g, '');
+export const stripAnsi = (s) => s.replace(/\u001B\[[0-9;]*m/g, '');
 /**
  * Status symbols with associated colors
  */
-exports.symbols = {
+export const symbols = {
     cancelled: chalk.gray('⊘'),
     error: chalk.red('✗'),
     info: chalk.blue('ℹ'),
@@ -37,7 +24,7 @@ exports.symbols = {
 /**
  * Color utility functions for semantic styling
  */
-exports.colors = {
+export const colors = {
     bold: chalk.bold,
     dim: chalk.gray,
     error: chalk.red,
@@ -48,125 +35,104 @@ exports.colors = {
     warning: chalk.yellow,
 };
 /**
- * Dividers for visual separation
+ * Structural glyphs that give the CLI its tree-shaped layout. `section` marks a
+ * top-level heading; `branch` opens the group of detail rows beneath it.
+ * See STYLE_GUIDE.md.
  */
-exports.dividers = {
-    heavy: chalk.gray('═'.repeat(80)),
-    light: chalk.gray('─'.repeat(80)),
-    short: chalk.gray('─'.repeat(40)),
+export const glyphs = {
+    branch: '⎿',
+    section: '⏺',
 };
 /**
- * Format a status with appropriate symbol and color
- * @param status - The status string to format
- * @returns Formatted status string with color and symbol
+ * The single source of truth mapping a run/test status to its colour and
+ * (already-coloured) symbol. Both {@link formatStatus} and the `ui` status
+ * helpers build on this, so every status reads identically everywhere.
+ * @param status - The status string (case-insensitive)
  */
-function formatStatus(status) {
-    const statusUpper = status.toUpperCase();
-    switch (statusUpper) {
+export function statusPalette(status) {
+    switch (status.toUpperCase()) {
         case 'PASSED': {
-            return `${exports.symbols.success} ${exports.colors.success(status)}`;
+            return { color: colors.success, symbol: symbols.success };
         }
+        case 'ERROR':
         case 'FAILED': {
-            return `${exports.symbols.error} ${exports.colors.error(status)}`;
+            return { color: colors.error, symbol: symbols.error };
         }
         case 'RUNNING': {
-            return `${exports.symbols.running} ${exports.colors.info(status)}`;
+            return { color: colors.info, symbol: symbols.running };
         }
         case 'PENDING': {
-            return `${exports.symbols.pending} ${exports.colors.warning(status)}`;
+            return { color: colors.warning, symbol: symbols.pending };
         }
         case 'QUEUED': {
-            return `${exports.symbols.queued} ${exports.colors.dim(status)}`;
+            return { color: colors.dim, symbol: symbols.queued };
         }
         case 'CANCELLED': {
-            return `${exports.symbols.cancelled} ${exports.colors.dim(status)}`;
+            return { color: colors.dim, symbol: symbols.cancelled };
         }
         default: {
-            return `${exports.symbols.unknown} ${exports.colors.dim(status)}`;
+            return { color: colors.dim, symbol: symbols.unknown };
         }
     }
 }
 /**
- * Format a section header
- * @param title - The title of the section
- * @returns Formatted section header
- */
-function sectionHeader(title) {
-    return `\n${exports.colors.bold(title)}\n${exports.dividers.light}`;
-}
-/**
- * Format a key-value pair with optional icon
- * @param icon - Icon to display before the key
- * @param key - The key name
- * @param value - The value to display
- * @returns Formatted key-value string
+ * Format a status as a coloured symbol followed by the lowercased status word,
+ * e.g. `✓ passed`.
+ * @param status - The status string to format
+ * @returns Formatted status string with color and symbol
  */
-function keyValue(icon, key, value) {
-    return `${icon} ${exports.colors.dim(key + ':')} ${exports.colors.highlight(value)}`;
+export function formatStatus(status) {
+    const { color, symbol } = statusPalette(status);
+    return `${symbol} ${color(status.toLowerCase())}`;
 }
 /**
- * Format a list item
- * @param text - The text of the list item
- * @param prefix - The prefix character (default: '•')
- * @returns Formatted list item
+ * Format a top-level section header in the tree style: a `⏺` marker followed by
+ * the bold title, preceded by a blank line for separation. Detail rows belong
+ * underneath in a branch group (see the `ui` helpers).
+ * @param title - The title of the section
+ * @returns Formatted section header
  */
-function listItem(text, prefix = '•') {
-    return `${exports.colors.dim(prefix)} ${text}`;
+export function sectionHeader(title) {
+    return `\n${colors.dim(glyphs.section)} ${colors.bold(title)}`;
 }
 /**
  * Format a URL
  * @param url - The URL to format
  * @returns Formatted URL with styling
  */
-function formatUrl(url) {
-    return exports.colors.url(url);
+export function formatUrl(url) {
+    return colors.url(url);
 }
 /**
  * Format an ID or identifier
  * @param id - The ID to format
  * @returns Formatted ID with highlighting
  */
-function formatId(id) {
-    return exports.colors.highlight(id);
+export function formatId(id) {
+    return colors.highlight(id);
 }
 /**
  * Format a test summary line
  * @param summary - Object containing test counts
  * @returns Formatted summary string
  */
-function formatTestSummary(summary) {
+export function formatTestSummary(summary) {
     const parts = [
         chalk.bold(`${summary.completed}/${summary.total}`),
-        exports.colors.success(`✓ ${summary.passed}`),
-        exports.colors.error(`✗ ${summary.failed}`),
-        exports.colors.info(`▶ ${summary.running}`),
-        exports.colors.warning(`⏸ ${summary.pending}`),
-        exports.colors.dim(`⏳ ${summary.queued}`),
+        colors.success(`✓ ${summary.passed}`),
+        colors.error(`✗ ${summary.failed}`),
+        colors.info(`▶ ${summary.running}`),
+        colors.warning(`⏸ ${summary.pending}`),
+        colors.dim(`⏳ ${summary.queued}`),
     ];
     return parts.join(' │ ');
 }
-/**
- * Format a box with content
- * @param content - The content to display in the box
- * @returns Formatted box with borders
- */
-function box(content) {
-    const lines = content.split('\n');
-    const visibleLen = (s) => stripAnsi(s).length;
-    const maxLength = Math.max(...lines.map((l) => visibleLen(l)));
-    const top = chalk.gray('┌' + '─'.repeat(maxLength + 2) + '┐');
-    const bottom = chalk.gray('└' + '─'.repeat(maxLength + 2) + '┘');
-    const middle = lines
-        .map((line) => chalk.gray('│ ') + line + ' '.repeat(Math.max(0, maxLength - visibleLen(line))) + chalk.gray(' │'))
-        .join('\n');
-    return `${top}\n${middle}\n${bottom}`;
-}
 /**
  * Minimal column table renderer.
  * Columns are defined with a `get(row) => string` accessor and optional header label.
  * Matches the subset of oclif's ux.table used by this CLI.
  */
-function table(rows, columns, options = {}) {
+export function table(rows, columns, options = {}) {
     const printLine = options.printLine ?? ((line) => {
         // eslint-disable-next-line no-console
         console.log(line);
@@ -194,8 +160,8 @@ function table(rows, columns, options = {}) {
  * @param resultId - The result ID
  * @returns The appropriate console URL
  */
-function getConsoleUrl(apiUrl, uploadId, resultId) {
-    const env = (0, environments_1.findEnvByApiUrl)(apiUrl);
+export function getConsoleUrl(apiUrl, uploadId, resultId) {
+    const env = findEnvByApiUrl(apiUrl);
     const base = env?.frontendUrl ?? 'https://dev.console.devicecloud.dev';
     return `${base}/results?upload=${uploadId}&result=${resultId}`;
 }

package/dist/utils/ui.d.ts

@@ -0,0 +1,41 @@
+/** A `[label, value]` detail row; the value is passed through already styled. */
+export type Field = [label: string, value: string];
+export declare const ui: {
+    /**
+     * Render detail rows as a branch group beneath the most recent section:
+     *
+     *   ⎿ row one
+     *     row two
+     *
+     * Embedded newlines in a row are kept aligned. Returns `''` for no rows.
+     */
+    readonly branch: (rows: string[]) => string;
+    /**
+     * Align `[label, value]` pairs into `label   value` rows for use inside a
+     * {@link branch} group. Plain labels are dimmed; labels the caller already
+     * styled (e.g. `colors.bold(name)`) are left as-is. Padding is measured on
+     * visible width so ANSI colours never throw the columns off.
+     */
+    readonly fields: (pairs: Field[]) => string[];
+    /** `ℹ message` — neutral, standalone information. */
+    readonly info: (message: string) => string;
+    /** Dimmed secondary text — hints, tips, "you can close this terminal", etc. */
+    readonly note: (message: string) => string;
+    /** `▶ message` — an action currently in progress. */
+    readonly running: (message: string) => string;
+    /**
+     * A top-level section header — `⏺ Title`, preceded by a blank line. Detail
+     * rows belong underneath via {@link branch}.
+     */
+    readonly section: (title: string) => string;
+    /** A coloured status word + symbol, e.g. `✓ passed`. Delegates to the shared palette. */
+    readonly status: (status: string) => string;
+    /** The coloured status symbol alone, e.g. green `✓`. */
+    readonly statusSymbol: (status: string) => string;
+    /** The lowercased status word in its status colour, e.g. green `passed`. */
+    readonly statusWord: (status: string) => string;
+    /** `✓ message` — a completed action; the message is emphasised. */
+    readonly success: (message: string) => string;
+    /** `⚠ message` — a non-fatal warning. */
+    readonly warn: (message: string) => string;
+};

package/dist/utils/ui.js

@@ -0,0 +1,95 @@
+/**
+ * Unified rendering layer for all CLI command output.
+ *
+ * Every command composes its output from these helpers so the look stays
+ * consistent — a tree of `⏺` section headings with `⎿` branch groups of detail
+ * rows beneath them, inspired by Claude Code. See STYLE_GUIDE.md for the rules
+ * and worked examples.
+ *
+ * Functions RETURN strings (never write to stdout themselves) so callers route
+ * them through their own logger / `--json` gate and they stay unit-testable.
+ */
+import { colors, formatStatus, glyphs, sectionHeader, statusPalette, stripAnsi, symbols, } from './styling.js';
+/**
+ * Indentation under a section. The branch glyph sits two columns in and its
+ * content begins at column four; continuation rows align to the same column.
+ *
+ *   ⏺ Title
+ *     ⎿ first detail row
+ *       continuation row
+ */
+const BRANCH_PREFIX = `  ${colors.dim(glyphs.branch)} `;
+const CONTINUATION_PREFIX = '    ';
+export const ui = {
+    /**
+     * Render detail rows as a branch group beneath the most recent section:
+     *
+     *   ⎿ row one
+     *     row two
+     *
+     * Embedded newlines in a row are kept aligned. Returns `''` for no rows.
+     */
+    branch(rows) {
+        const lines = rows.flatMap((row) => row.split('\n'));
+        if (lines.length === 0) {
+            return '';
+        }
+        return lines
+            .map((line, index) => index === 0 ? `${BRANCH_PREFIX}${line}` : `${CONTINUATION_PREFIX}${line}`)
+            .join('\n');
+    },
+    /**
+     * Align `[label, value]` pairs into `label   value` rows for use inside a
+     * {@link branch} group. Plain labels are dimmed; labels the caller already
+     * styled (e.g. `colors.bold(name)`) are left as-is. Padding is measured on
+     * visible width so ANSI colours never throw the columns off.
+     */
+    fields(pairs) {
+        const width = Math.max(0, ...pairs.map(([label]) => stripAnsi(label).length));
+        return pairs.map(([label, value]) => {
+            const styled = stripAnsi(label) === label ? colors.dim(label) : label;
+            const padding = ' '.repeat(Math.max(0, width - stripAnsi(label).length));
+            return `${styled}${padding}   ${value}`;
+        });
+    },
+    /** `ℹ message` — neutral, standalone information. */
+    info(message) {
+        return `${symbols.info} ${message}`;
+    },
+    /** Dimmed secondary text — hints, tips, "you can close this terminal", etc. */
+    note(message) {
+        return colors.dim(message);
+    },
+    /** `▶ message` — an action currently in progress. */
+    running(message) {
+        return `${symbols.running} ${message}`;
+    },
+    /**
+     * A top-level section header — `⏺ Title`, preceded by a blank line. Detail
+     * rows belong underneath via {@link branch}.
+     */
+    section(title) {
+        return sectionHeader(title);
+    },
+    /** A coloured status word + symbol, e.g. `✓ passed`. Delegates to the shared palette. */
+    status(status) {
+        return formatStatus(status);
+    },
+    /** The coloured status symbol alone, e.g. green `✓`. */
+    statusSymbol(status) {
+        return statusPalette(status).symbol;
+    },
+    /** The lowercased status word in its status colour, e.g. green `passed`. */
+    statusWord(status) {
+        const { color } = statusPalette(status);
+        return color(status.toLowerCase());
+    },
+    /** `✓ message` — a completed action; the message is emphasised. */
+    success(message) {
+        return `${symbols.success} ${colors.bold(message)}`;
+    },
+    /** `⚠ message` — a non-fatal warning. */
+    warn(message) {
+        return `${symbols.warning} ${message}`;
+    },
+};

package/package.json

@@ -1,43 +1,45 @@
 {
   "author": "devicecloud.dev",
   "bin": {
-    "dcd": "dist/index.js"
+    "dcd": "dist/index.js",
+    "dcd-mcp": "dist/mcp/index.js"
   },
   "dependencies": {
-    "@clack/prompts": "^1.2.0",
-    "@supabase/supabase-js": "^2.99.1",
+    "@clack/prompts": "^1.6.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@supabase/supabase-js": "^2.108.2",
     "bplist-parser": "^0.3.2",
-    "chalk": "4.1.2",
-    "citty": "^0.1.6",
-    "js-yaml": "^4.1.1",
+    "chalk": "^5.6.2",
+    "citty": "^0.2.2",
+    "js-yaml": "^5.0.0",
     "node-apk": "^1.2.1",
     "node-stream-zip": "^1.15.0",
-    "plist": "^3.1.0",
-    "tar": "^7.5.11",
+    "plist": "^5.0.0",
+    "tar": "^7.5.16",
     "tus-js-client": "^4.3.1",
-    "yazl": "^3.3.1"
+    "yazl": "^3.3.1",
+    "zod": "^4.4.3"
   },
-  "description": "Better cloud maestro testing",
+  "description": "Run Maestro mobile UI tests in the cloud — upload an iOS/Android build, execute flows across real devices, and stream results. Ships the dcd CLI and a dcd-mcp MCP server.",
   "devDependencies": {
-    "@eslint/js": "^9.39.4",
-    "@types/chai": "^4.3.20",
+    "@eslint/js": "^10.0.1",
+    "@types/chai": "^5.2.3",
     "@types/js-yaml": "^4.0.9",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^25.4.0",
-    "@types/plist": "^3.0.5",
+    "@types/node": "^26.0.0",
     "@types/yazl": "^3.3.1",
-    "chai": "^4.5.0",
-    "eslint": "^9.16.0",
+    "chai": "^6.2.2",
+    "eslint": "^10.5.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-unicorn": "^64.0.0",
+    "eslint-plugin-unicorn": "^68.0.0",
     "husky": "^9.1.7",
-    "mocha": "^11.7.5",
-    "prettier": "^3.3.3",
+    "mocha": "^11.7.6",
+    "prettier": "^3.8.4",
     "shx": "^0.4.0",
-    "tsx": "^4.19.2",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.59.0"
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.61.1"
   },
   "engines": {
     "node": ">=22.0.0"
@@ -50,6 +52,7 @@
   "main": "dist/index.js",
   "name": "@devicecloud.dev/dcd",
   "private": false,
+  "type": "module",
   "publishConfig": {
     "access": "public"
   },
@@ -57,7 +60,7 @@
     "type": "git",
     "url": "https://devicecloud.dev"
   },
-  "version": "5.0.0-beta.0",
+  "version": "5.0.0-beta.2",
   "bugs": {
     "url": "https://discord.gg/gm3mJwcNw8"
   },
@@ -72,7 +75,7 @@
   "types": "dist/index.d.ts",
   "scripts": {
     "dcd": "tsx src/index.ts",
-    "build": "shx rm -rf dist && tsc -b && shx chmod +x dist/index.js",
+    "build": "shx rm -rf dist && tsc -b && shx chmod +x dist/index.js dist/mcp/index.js",
     "build:binaries": "node scripts/build-binaries.mjs",
     "lint": "eslint src test --ext .ts",
     "test": "node scripts/test-runner.mjs",