@moda-ai/cli 1.22.1 → 1.23.0

package/dist/tui.js

@@ -1,393 +0,0 @@
-const STATUS_LABELS = {
-    pass: 'ok',
-    warning: 'warn',
-    fail: 'fail',
-    skipped: 'skip',
-    info: 'info',
-    run: 'run',
-};
-const STATUS_COLORS = {
-    pass: 32,
-    warning: 33,
-    fail: 31,
-    skipped: 90,
-    info: 36,
-    run: 35,
-};
-export function renderDoctorHuman(report, options = {}) {
-    const ui = createTerminalUi(options);
-    const lines = [];
-    lines.push(ui.title('Moda doctor'));
-    lines.push(ui.dim(`Profile ${report.profile.active}${report.profile.requested ? ` (requested ${report.profile.requested})` : ''}`));
-    lines.push('');
-    lines.push(renderSummary(ui, report));
-    for (const [group, checks] of groupChecks(report.checks)) {
-        lines.push('');
-        lines.push(ui.section(titleCase(group)));
-        for (const check of checks) {
-            lines.push(renderCheck(ui, check));
-        }
-    }
-    if (report.nextCommands.length > 0) {
-        lines.push('');
-        lines.push(ui.section('Next commands'));
-        for (const command of report.nextCommands.slice(0, 8)) {
-            lines.push(`  ${ui.command(command)}`);
-        }
-    }
-    if (report.fixPlan.length > 0) {
-        lines.push('');
-        lines.push(ui.section('Repair plan'));
-        for (const item of report.fixPlan.slice(0, 8)) {
-            const command = item.command ? ` ${ui.command(item.command)}` : '';
-            lines.push(ui.wrap(`  - ${item.action}${command}`, 4));
-        }
-    }
-    return lines.join('\n');
-}
-export function renderStatusHuman(status, options = {}) {
-    const ui = createTerminalUi(options);
-    const lines = [];
-    lines.push(ui.title('Moda status'));
-    lines.push(`${ui.status(status.status)} ${ui.dim(`profile ${status.activeProfile}`)}`);
-    lines.push('');
-    lines.push(`Auth        ${status.auth.apiKey}`);
-    lines.push(`Tenant      ${status.workspace.tenantId ?? 'missing'}`);
-    lines.push(`Base URL    ${status.workspace.baseUrl}`);
-    lines.push(`Ingest URL  ${status.workspace.ingestUrl}`);
-    lines.push('');
-    lines.push(ui.section('Readiness'));
-    lines.push(`  Data flow       ${ui.status(status.dataFlow)}`);
-    lines.push(`  Harness         ${ui.status(status.harness)}`);
-    lines.push(`  Harness sync    ${ui.status(status.harnessSync)}`);
-    lines.push(`  Harness report  ${ui.status(status.harnessReport)}`);
-    lines.push(`  Shadow Spark    ${ui.status(status.shadowSpark)}`);
-    lines.push(`  Prompts         ${ui.status(status.prompts)}`);
-    lines.push(`  Skills          ${ui.status(status.skills)}`);
-    if (status.topBrokenCheck) {
-        lines.push('');
-        lines.push(ui.section('Attention'));
-        lines.push(`  ${ui.status(status.topBrokenCheck.status)} ${status.topBrokenCheck.id}`);
-        if (status.topBrokenCheck.nextCommand) {
-            lines.push(`  Next: ${ui.command(status.topBrokenCheck.nextCommand)}`);
-        }
-    }
-    if (status.nextCommands.length > 0) {
-        lines.push('');
-        lines.push(ui.section('Next commands'));
-        for (const command of status.nextCommands) {
-            lines.push(`  ${ui.command(command)}`);
-        }
-    }
-    return lines.join('\n');
-}
-export function renderInitBanner() {
-    const ui = createTerminalUi();
-    return [
-        ui.title('Moda init'),
-        ui.dim('LLM observability for agent harnesses'),
-        '',
-        `  ${ui.status('info')} Human-in-the-loop setup. Secrets stay untouched and file changes are shown before completion.`,
-    ].join('\n');
-}
-export function renderInitStep(index, total, title, detail) {
-    const ui = createTerminalUi();
-    return [
-        '',
-        ui.section(`Step ${index}/${total}: ${title}`),
-        ...(detail ? [ui.wrap(`  ${detail}`, 2)] : []),
-    ].join('\n');
-}
-export function renderInitNote(message, status = 'pass') {
-    const ui = createTerminalUi();
-    return `  ${ui.status(status)} ${message}`;
-}
-export function renderInitSetupPlan(actions, options = {}) {
-    const ui = createTerminalUi();
-    const lines = actions.map((action) => {
-        const status = action.approved
-            ? 'pass'
-            : action.status === 'manual'
-                ? 'skipped'
-                : 'warning';
-        const suffix = action.reason ? ` - ${action.reason}` : '';
-        return ui.wrap(`  ${ui.status(status)} ${action.title}${suffix}`, 4);
-    });
-    if (options.snapshotConsent) {
-        lines.push('');
-        lines.push(ui.wrap(`  ${ui.status('info')} Moda will analyze a snapshot of this repo on Moda's servers to map your agent harness. Secrets and .env files are excluded and the snapshot is deleted after the run.`, 4));
-    }
-    return lines.join('\n');
-}
-export function renderInitComplete(options) {
-    const ui = createTerminalUi();
-    const dashboardUrl = options.dashboardUrl ?? 'https://moda.dev';
-    const lines = [];
-    lines.push('');
-    lines.push(ui.title(`Workspace ready: ${options.tenantName}`));
-    lines.push(`Dashboard: ${ui.command(dashboardUrl)}`);
-    lines.push('');
-    if (options.harness?.state === 'pending') {
-        lines.push(ui.wrap(`  ${ui.status('run')} Harness analysis is still running on Moda. Run ${ui.command('moda harness pull --sync')} in a few minutes.`, 4));
-    }
-    else if (options.harness) {
-        lines.push(ui.wrap(`  ${ui.status('pass')} Harness mapped: ${options.harness.agents ?? 0} agent(s), ${options.harness.artifacts ?? 0} artifact(s). View: ${ui.command(dashboardUrl)}`, 4));
-    }
-    lines.push('');
-    lines.push(ui.section('Files changed'));
-    if (options.filesChanged.length === 0) {
-        lines.push(`  ${ui.dim('none')}`);
-    }
-    else {
-        for (const file of options.filesChanged)
-            lines.push(`  ${file}`);
-    }
-    if (options.skipped.length > 0) {
-        lines.push('');
-        lines.push(ui.section('Skipped or manual'));
-        for (const action of options.skipped) {
-            lines.push(ui.wrap(`  - ${action.title}: ${action.reason ?? action.status}`, 4));
-        }
-    }
-    lines.push('');
-    lines.push(ui.section('Next steps'));
-    if (options.telemetrySeen === true) {
-        lines.push(`  Telemetry is flowing. Explore it: ${ui.command('moda overview')}`);
-    }
-    else {
-        lines.push(`  Run your app to send telemetry, then: ${ui.command('moda doctor --online')}`);
-    }
-    lines.push(`  Ask about your agents: ${ui.command('moda ask "what did my agents do today?"')}`);
-    return lines.join('\n');
-}
-export function renderHarnessProgress(message, status = 'run') {
-    const ui = createTerminalUi();
-    return `${ui.status(status)} ${message}`;
-}
-export function renderHarnessAnalystPreflight(options) {
-    const ui = createTerminalUi();
-    const lines = [];
-    lines.push(ui.section('Analyst read plan'));
-    lines.push(`  ${ui.status('info')} Moda Analyst will inspect this project before any sync.`);
-    lines.push(`  Root       ${options.root}`);
-    lines.push(ui.wrap(`  Reads      ${options.willRead.join(', ')}`, 12));
-    lines.push(ui.wrap(`  Skips      ${options.willSkip.join(', ')}`, 12));
-    lines.push(`  Writes     ${ui.dim('none during investigation; Moda writes .moda artifacts after validation')}`);
-    return lines.join('\n');
-}
-export function renderHarnessAnalystLaunch(options) {
-    const ui = createTerminalUi();
-    const lines = [];
-    lines.push(ui.section('Moda Analyst'));
-    lines.push(`  ${ui.status('run')} Launching ${options.adapterName}`);
-    lines.push(`  Command    ${options.command}`);
-    lines.push(`  Mode       read-only repository access`);
-    lines.push(`  Root       ${options.root}`);
-    lines.push(`  Output     ${options.reportPath}`);
-    lines.push(`  Boundary   Agent can inspect files and print a cited report. Moda validates it, then writes .moda artifacts.`);
-    return lines.join('\n');
-}
-export function renderHarnessAnalystChoice(options) {
-    const ui = createTerminalUi();
-    return [
-        ui.section('Detected coding agents'),
-        `  ${ui.status('info')} ${options.detected.join(', ')}`,
-        '  Pick the agent that should investigate this repo in read-only mode.',
-    ].join('\n');
-}
-export function renderHarnessAnalyzeHumanResult(data) {
-    const ui = createTerminalUi();
-    const value = asRecord(data);
-    const summary = asRecord(value?.summary);
-    const validation = asRecord(value?.validation);
-    const written = Array.isArray(value?.written) ? value.written.map(String) : [];
-    const lines = [];
-    lines.push(ui.title('Moda Analyst report'));
-    lines.push(`${ui.status(validation?.status === 'fail' ? 'fail' : 'pass')} validation ${String(validation?.status ?? 'unknown')}`);
-    if (summary) {
-        lines.push('');
-        lines.push(ui.section('Harness summary'));
-        lines.push(`  Runtime agents  ${numberOrZero(summary.runtimeAgentCount)}`);
-        lines.push(`  Agent families  ${numberOrZero(summary.agentFamilyCount)}`);
-        lines.push(`  Artifacts       ${numberOrZero(summary.artifactCount ?? summary.sharedArtifactCount)}`);
-        lines.push(`  Providers       ${numberOrZero(summary.modelProviderCount)}`);
-        lines.push(`  Unknowns        ${numberOrZero(summary.unknownCount)}`);
-    }
-    if (written.length > 0) {
-        lines.push('');
-        lines.push(ui.section('Artifacts'));
-        for (const file of written.slice(0, 12))
-            lines.push(`  ${file}`);
-    }
-    lines.push('');
-    lines.push(ui.section('Next commands'));
-    lines.push(`  ${ui.command('moda harness approve --yes')}`);
-    lines.push(`  ${ui.command('moda harness sync --from-report .moda/harness-report.json --dry-run')}`);
-    return lines.join('\n');
-}
-export function renderOverviewHuman(data) {
-    const ui = createTerminalUi();
-    const record = asRecord(data);
-    const lines = [];
-    lines.push(ui.title('Moda overview'));
-    lines.push(ui.dim('Production health briefing'));
-    lines.push('');
-    lines.push(ui.section('Signals'));
-    const signals = overviewSignals(record);
-    if (signals.length === 0) {
-        lines.push('  No aggregate signal fields found in the response.');
-    }
-    else {
-        for (const [label, value] of signals)
-            lines.push(`  ${label.padEnd(24)} ${value}`);
-    }
-    const recent = recentActivity(record);
-    if (recent.length > 0) {
-        lines.push('');
-        lines.push(ui.section('Recent activity'));
-        for (const item of recent.slice(0, 5))
-            lines.push(ui.wrap(`  - ${item}`, 4));
-    }
-    lines.push('');
-    lines.push(ui.section('Next commands'));
-    lines.push(`  ${ui.command('moda doctor --online')}`);
-    lines.push(`  ${ui.command('moda conversations --limit=10')}`);
-    lines.push(`  ${ui.command('moda tool-failures')}`);
-    return lines.join('\n');
-}
-function renderSummary(ui, report) {
-    return [
-        ui.status(report.summary.status),
-        `pass ${report.summary.pass}`,
-        `warn ${report.summary.warning}`,
-        `fail ${report.summary.fail}`,
-        `skip ${report.summary.skipped}`,
-    ].join('  ');
-}
-function renderCheck(ui, check) {
-    const lines = [];
-    lines.push(`  ${ui.status(check.status)} ${check.title}`);
-    for (const evidence of check.evidence.slice(0, 4)) {
-        lines.push(ui.wrap(`      ${evidence.label}: ${evidence.value}`, 6));
-    }
-    if (check.remediation) {
-        lines.push(ui.wrap(`      fix: ${check.remediation}`, 6));
-    }
-    if (check.nextCommand) {
-        lines.push(`      next: ${ui.command(check.nextCommand)}`);
-    }
-    return lines.join('\n');
-}
-function groupChecks(checks) {
-    const groups = new Map();
-    for (const check of checks) {
-        const existing = groups.get(check.group) ?? [];
-        existing.push(check);
-        groups.set(check.group, existing);
-    }
-    return [...groups.entries()];
-}
-function titleCase(value) {
-    return value
-        .split(/[-_\s]+/)
-        .filter(Boolean)
-        .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)
-        .join(' ');
-}
-function overviewSignals(record) {
-    if (!record)
-        return [];
-    const candidates = [
-        ['Conversations', valueAt(record, ['conversations', 'total']) ?? record.conversations],
-        ['Recent activity', Array.isArray(record.recent_activity) ? record.recent_activity.length : undefined],
-        ['Tool failures', valueAt(record, ['tool_failures', 'total']) ?? valueAt(record, ['toolFailures', 'total']) ?? record.tool_failures],
-        ['Frustrations', valueAt(record, ['frustrations', 'total']) ?? record.frustrations],
-        ['Runs', valueAt(record, ['runs', 'total']) ?? record.runs],
-        ['Workflows', valueAt(record, ['workflows', 'total']) ?? record.workflows],
-    ];
-    return candidates
-        .map(([label, value]) => [label, metricText(value)])
-        .filter((item) => item[1] !== undefined);
-}
-function recentActivity(record) {
-    const activity = Array.isArray(record?.recent_activity) ? record.recent_activity : [];
-    return activity.flatMap((item) => {
-        const value = asRecord(item);
-        if (!value)
-            return [];
-        const id = stringValue(value.conversation_id) ?? stringValue(value.run_id) ?? stringValue(value.id);
-        const timestamp = stringValue(value.timestamp) ?? stringValue(value.created_at);
-        const summary = stringValue(value.summary) ?? stringValue(value.title) ?? stringValue(value.event);
-        return [[summary, id, timestamp].filter(Boolean).join(' - ')];
-    });
-}
-function metricText(value) {
-    if (typeof value === 'number' && Number.isFinite(value))
-        return String(value);
-    if (typeof value === 'string' && value.trim())
-        return value;
-    if (Array.isArray(value))
-        return String(value.length);
-    if (isRecord(value)) {
-        const total = value.total ?? value.count ?? value.active;
-        if (typeof total === 'number' || typeof total === 'string')
-            return String(total);
-    }
-    return undefined;
-}
-function valueAt(record, path) {
-    let cursor = record;
-    for (const key of path) {
-        if (!isRecord(cursor))
-            return undefined;
-        cursor = cursor[key];
-    }
-    return cursor;
-}
-function numberOrZero(value) {
-    return typeof value === 'number' && Number.isFinite(value) ? String(value) : '0';
-}
-function asRecord(value) {
-    return isRecord(value) ? value : undefined;
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function stringValue(value) {
-    return typeof value === 'string' && value.trim() ? value : undefined;
-}
-function createTerminalUi(options = {}) {
-    const width = Math.max(48, Math.min(options.width ?? process.stdout.columns ?? 96, 140));
-    const color = options.color ?? Boolean(process.stdout.isTTY && process.env.NO_COLOR !== '1');
-    const paint = (code, text) => color ? `\u001b[${code}m${text}\u001b[0m` : text;
-    return {
-        title: (text) => paint(1, text),
-        section: (text) => paint(36, text),
-        status: (status) => paint(STATUS_COLORS[status], `[${STATUS_LABELS[status]}]`),
-        command: (text) => paint(36, text),
-        dim: (text) => paint(90, text),
-        wrap: (text, indent) => wrapLine(text, width, indent),
-    };
-}
-function wrapLine(text, width, indent) {
-    if (text.length <= width)
-        return text;
-    const lead = text.match(/^\s*/)?.[0] ?? '';
-    const words = text.trimStart().split(/\s+/);
-    const lines = [];
-    let current = '';
-    for (const word of words) {
-        const next = current ? `${current} ${word}` : `${lead}${word}`;
-        if (next.length > width && current) {
-            lines.push(current);
-            current = `${' '.repeat(indent)}${word}`;
-        }
-        else {
-            current = next;
-        }
-    }
-    if (current)
-        lines.push(current);
-    return lines.join('\n');
-}
-//# sourceMappingURL=tui.js.map

package/dist/update-check.d.ts

@@ -1,31 +0,0 @@
-import { type ProfileIOOptions } from './profiles.js';
-export declare function stripUpdateCheckFlag(flags: Record<string, string>): Record<string, string>;
-export declare function isUpdateCheckDisabled(flags: Record<string, string>, env?: NodeJS.ProcessEnv): boolean;
-/**
- * Numeric semver comparison ignoring prerelease/build suffixes; npm's
- * `latest` dist-tag only carries stable releases, so this is sufficient
- * without pulling in a semver dependency.
- */
-export declare function isNewerVersion(candidate: string, current: string): boolean;
-/**
- * Refresh the cached latest version from the npm registry at most once per
- * 24 hours. Fire-and-forget from the CLI dispatcher. The abort timer is
- * unref'd so it can't keep the process alive after the socket closes (it does
- * not unref the in-flight fetch itself — a fast command may still wait up to
- * REGISTRY_TIMEOUT_MS for the request to resolve, matching the telemetry
- * module's trade-off). Every failure path is swallowed — an update check must
- * never break a command.
- */
-export declare function startUpdateCheck(options?: ProfileIOOptions, now?: number): Promise<void>;
-/**
- * Returns the upgrade notice when the cached registry version is newer than
- * the running build, or undefined. Reads only the local cache — never the
- * network — so it is safe to call synchronously at the end of every command.
- */
-export declare function getUpdateNotice(options?: ProfileIOOptions): string | undefined;
-/**
- * Print the upgrade notice to stderr in interactive terminals only: stdout
- * stays machine-readable, and piped/CI invocations stay noise-free.
- */
-export declare function printUpdateNotice(options?: ProfileIOOptions): void;
-//# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.js

@@ -1,141 +0,0 @@
-// src/update-check.ts — Daily npm-registry version check with an upgrade
-// notice. Mirrors the telemetry contract: fire-and-forget, short abort
-// timeout, never throws, and never touches stdout (notice goes to stderr so
-// JSON/agent output stays machine-readable).
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { VERSION } from './config.js';
-import { getModaDir } from './profiles.js';
-const UPDATE_CHECK_FLAG = 'no-update-check';
-const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
-const REGISTRY_TIMEOUT_MS = 1_500;
-const REGISTRY_LATEST_URL = 'https://registry.npmjs.org/@moda-ai/cli/latest';
-// npm's `latest` dist-tag is always a stable semver. Anchored, no control
-// chars: a registry response intercepted by a proxy can't smuggle ANSI escape
-// sequences into the cache (and thus the terminal notice) this way.
-const SEMVER_RE = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
-export function stripUpdateCheckFlag(flags) {
-    const { [UPDATE_CHECK_FLAG]: _drop, ...rest } = flags;
-    return rest;
-}
-export function isUpdateCheckDisabled(flags, env = process.env) {
-    return (flags[UPDATE_CHECK_FLAG] === 'true' ||
-        env.MODA_CLI_UPDATE_CHECK === '0' ||
-        env.DO_NOT_TRACK === '1' ||
-        // Treat CI as set only when it carries a real truthy value: `CI=false`
-        // and `CI=0` are common ways to simulate a non-CI shell locally.
-        (env.CI !== undefined &&
-            env.CI !== '' &&
-            env.CI !== 'false' &&
-            env.CI !== '0'));
-}
-function cachePath(options = {}) {
-    return join(getModaDir(options), 'update-check.json');
-}
-function readCache(options = {}) {
-    try {
-        const parsed = JSON.parse(readFileSync(cachePath(options), 'utf8'));
-        if (parsed &&
-            typeof parsed === 'object' &&
-            typeof parsed.checked_at === 'number' &&
-            typeof parsed.latest === 'string') {
-            return parsed;
-        }
-    }
-    catch {
-        // Missing or corrupt cache means "never checked".
-    }
-    return undefined;
-}
-function writeCache(cache, options = {}) {
-    try {
-        mkdirSync(getModaDir(options), { recursive: true });
-        writeFileSync(cachePath(options), `${JSON.stringify(cache, null, 2)}\n`, 'utf8');
-    }
-    catch {
-        // Best-effort: an unwritable cache only means we re-check next run.
-    }
-}
-/**
- * Numeric semver comparison ignoring prerelease/build suffixes; npm's
- * `latest` dist-tag only carries stable releases, so this is sufficient
- * without pulling in a semver dependency.
- */
-export function isNewerVersion(candidate, current) {
-    const parse = (v) => v.split(/[-+]/)[0].split('.').map((part) => Number.parseInt(part, 10) || 0);
-    const a = parse(candidate);
-    const b = parse(current);
-    for (let i = 0; i < 3; i++) {
-        if ((a[i] ?? 0) > (b[i] ?? 0))
-            return true;
-        if ((a[i] ?? 0) < (b[i] ?? 0))
-            return false;
-    }
-    return false;
-}
-/**
- * Refresh the cached latest version from the npm registry at most once per
- * 24 hours. Fire-and-forget from the CLI dispatcher. The abort timer is
- * unref'd so it can't keep the process alive after the socket closes (it does
- * not unref the in-flight fetch itself — a fast command may still wait up to
- * REGISTRY_TIMEOUT_MS for the request to resolve, matching the telemetry
- * module's trade-off). Every failure path is swallowed — an update check must
- * never break a command.
- */
-export async function startUpdateCheck(options = {}, now = Date.now()) {
-    const cache = readCache(options);
-    if (cache && now - cache.checked_at < CHECK_INTERVAL_MS) {
-        return;
-    }
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), REGISTRY_TIMEOUT_MS);
-    if (typeof timeout.unref === 'function') {
-        timeout.unref();
-    }
-    try {
-        const res = await fetch(REGISTRY_LATEST_URL, {
-            headers: { Accept: 'application/json' },
-            signal: controller.signal,
-        });
-        if (!res.ok)
-            return;
-        const body = (await res.json());
-        if (typeof body.version !== 'string' || !SEMVER_RE.test(body.version))
-            return;
-        writeCache({ checked_at: now, latest: body.version }, options);
-    }
-    catch {
-        // Network/timeout errors are expected offline; try again next run.
-    }
-    finally {
-        clearTimeout(timeout);
-    }
-}
-/**
- * Returns the upgrade notice when the cached registry version is newer than
- * the running build, or undefined. Reads only the local cache — never the
- * network — so it is safe to call synchronously at the end of every command.
- */
-export function getUpdateNotice(options = {}) {
-    const cache = readCache(options);
-    if (!cache || !isNewerVersion(cache.latest, VERSION)) {
-        return undefined;
-    }
-    return [
-        '',
-        `Update available: moda-cli ${VERSION} → ${cache.latest}`,
-        'Run `npm install -g @moda-ai/cli@latest` to update.',
-    ].join('\n');
-}
-/**
- * Print the upgrade notice to stderr in interactive terminals only: stdout
- * stays machine-readable, and piped/CI invocations stay noise-free.
- */
-export function printUpdateNotice(options = {}) {
-    if (!process.stderr.isTTY)
-        return;
-    const notice = getUpdateNotice(options);
-    if (notice)
-        console.error(notice);
-}
-//# sourceMappingURL=update-check.js.map

package/dist/workspace.d.ts

@@ -1,12 +0,0 @@
-import type { ParsedArgs } from './cli.js';
-import type { CommandContext } from './command-context.js';
-interface WorkspaceOptions {
-    cwd?: string;
-}
-export declare function runWorkspaceCommand(args: ParsedArgs, options?: WorkspaceOptions): Promise<number>;
-export declare function runSparkCommand(context: CommandContext): Promise<{
-    exitCode: number;
-}>;
-export declare function runHooksInstall(args: ParsedArgs): Promise<number>;
-export {};
-//# sourceMappingURL=workspace.d.ts.map