@moda-ai/cli 1.1.1 → 1.2.0

package/dist/tui.js

@@ -0,0 +1,387 @@
+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) {
+    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);
+    });
+    return lines.join('\n');
+}
+export function renderInitComplete(options) {
+    const ui = createTerminalUi();
+    const lines = [];
+    lines.push('');
+    lines.push(ui.title(`Setup complete for ${options.tenantName}`));
+    lines.push('');
+    lines.push(ui.section('Phases'));
+    for (const phase of options.phases) {
+        lines.push(`  ${ui.status(phase.status === 'warning' ? 'warning' : phase.status === 'skipped' ? 'skipped' : 'pass')} ${phase.title}${phase.details ? ` - ${phase.details}` : ''}`);
+    }
+    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 commands'));
+    lines.push(`  ${ui.command('moda status')}`);
+    lines.push(`  ${ui.command('moda doctor')}`);
+    lines.push(`  ${ui.command('moda harness sync --summary')}`);
+    lines.push('');
+    lines.push(ui.section('Agent handoff'));
+    lines.push('  Integrate the Moda SDK into this project using .moda/SDK_INTEGRATION.md');
+    lines.push('  and .moda/HARNESS.md. Package installs and source edits stay manual.');
+    lines.push('');
+    lines.push('Dashboard: https://moda.dev');
+    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],
+        ['Loops', valueAt(record, ['loops', 'active']) ?? valueAt(record, ['loops', 'total']) ?? record.loops],
+    ];
+    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 words = text.split(/\s+/);
+    const lines = [];
+    let current = '';
+    for (const word of words) {
+        const next = current ? `${current} ${word}` : 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/workspace.d.ts

@@ -0,0 +1,12 @@
+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