@dotsetlabs/bellwether 0.10.0

package/dist/cli/commands/cloud/badge.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const badgeCommand: Command;
+//# sourceMappingURL=badge.d.ts.map

package/dist/cli/commands/cloud/badge.js

@@ -0,0 +1,74 @@
+import { Command } from 'commander';
+import { createCloudClient } from '../../../cloud/client.js';
+import { getLinkedProject } from '../../../cloud/auth.js';
+import { EXIT_CODES } from '../../../constants.js';
+import * as output from '../../output.js';
+export const badgeCommand = new Command('badge')
+    .description('Get embeddable badge for your project')
+    .option('-p, --project <id>', 'Project ID (uses linked project if not specified)')
+    .option('--json', 'Output as JSON')
+    .option('--markdown', 'Output markdown only')
+    .option('--url', 'Output badge URL only')
+    .action(async (options) => {
+    // Get project ID
+    let projectId = options.project;
+    if (!projectId) {
+        const link = getLinkedProject();
+        if (!link) {
+            output.error('No project specified and no linked project found.');
+            output.error('Run `bellwether link <project>` first or use --project <id>');
+            process.exit(EXIT_CODES.ERROR);
+        }
+        projectId = link.projectId;
+    }
+    // Create cloud client
+    const client = createCloudClient();
+    try {
+        const badge = await client.getBadgeInfo(projectId);
+        if (!badge) {
+            output.error(`Project not found: ${projectId}`);
+            process.exit(EXIT_CODES.ERROR);
+        }
+        if (options.json) {
+            output.info(JSON.stringify(badge, null, 2));
+            return;
+        }
+        if (options.markdown) {
+            output.info(badge.markdown);
+            return;
+        }
+        if (options.url) {
+            output.info(badge.badgeUrl);
+            return;
+        }
+        // Default: formatted output
+        output.info('');
+        output.info(`Project: ${badge.projectName}`);
+        output.info(`Status:  ${badge.statusText}`);
+        if (badge.lastVerified) {
+            output.info(`Verified: ${new Date(badge.lastVerified).toLocaleString()}`);
+        }
+        if (badge.latestVersion) {
+            output.info(`Version: v${badge.latestVersion}`);
+        }
+        output.info('');
+        output.info('Badge URL:');
+        output.info(`  ${badge.badgeUrl}`);
+        output.info('');
+        output.info('Add to your README.md:');
+        output.info('');
+        output.info(`  ${badge.markdown}`);
+        output.info('');
+        output.info('Or with HTML:');
+        output.info('');
+        // Extract base URL from badge URL for consistency
+        const baseUrl = badge.badgeUrl.replace(/\/badge\/.*$/, '');
+        output.info(`  <a href="${baseUrl}/projects/${projectId}"><img src="${badge.badgeUrl}" alt="Bellwether"></a>`);
+        output.info('');
+    }
+    catch (error) {
+        output.error('Failed to get badge info: ' + (error instanceof Error ? error.message : String(error)));
+        process.exit(EXIT_CODES.ERROR);
+    }
+});
+//# sourceMappingURL=badge.js.map

package/dist/cli/commands/cloud/diff.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Diff command for comparing specific versions.
+ */
+import { Command } from 'commander';
+export declare const diffCommand: Command;
+//# sourceMappingURL=diff.d.ts.map

package/dist/cli/commands/cloud/diff.js

@@ -0,0 +1,79 @@
+/**
+ * Diff command for comparing specific versions.
+ */
+import { Command } from 'commander';
+import { EXIT_CODES } from '../../../constants.js';
+import { loadConfigOrExit, getSessionTokenOrExit, createAuthenticatedClient, resolveProjectId } from './shared.js';
+import * as output from '../../output.js';
+export const diffCommand = new Command('diff')
+    .description('Compare two baseline versions')
+    .argument('<from>', 'From version number')
+    .argument('<to>', 'To version number')
+    .option('-c, --config <path>', 'Path to config file')
+    .option('-p, --project <id>', 'Project ID (uses linked project if not specified)')
+    .option('--json', 'Output as JSON')
+    .option('--session <session>', 'Session token (overrides stored/env session)')
+    .action(async (fromArg, toArg, options) => {
+    const config = loadConfigOrExit(options.config);
+    // Get session
+    const sessionToken = getSessionTokenOrExit(options.session);
+    // Determine project ID
+    const projectId = resolveProjectId(undefined, options.project);
+    if (!projectId) {
+        output.error('No project specified. Use --project <id> or run `bellwether link`.');
+        process.exit(EXIT_CODES.ERROR);
+    }
+    // Parse versions
+    const fromVersion = parseInt(fromArg, 10);
+    const toVersion = parseInt(toArg, 10);
+    if (isNaN(fromVersion) || isNaN(toVersion)) {
+        output.error('Invalid version numbers. Provide integers (e.g., `bellwether diff 1 2`).');
+        process.exit(EXIT_CODES.ERROR);
+    }
+    // Create client and fetch diff
+    const client = createAuthenticatedClient(sessionToken);
+    try {
+        const diff = await client.getDiff(projectId, fromVersion, toVersion);
+        const outputJson = options.json ? true : config.history.json;
+        if (outputJson) {
+            output.info(JSON.stringify(diff, null, 2));
+            return;
+        }
+        output.info(`Comparing v${fromVersion} → v${toVersion}\n`);
+        const severityIcon = {
+            none: '✓',
+            info: 'ℹ',
+            warning: '⚠',
+            breaking: '✗',
+        };
+        output.info(`Severity: ${severityIcon[diff.severity] ?? '?'} ${diff.severity.toUpperCase()}`);
+        output.info('');
+        if (diff.toolsAdded > 0) {
+            output.info(`Tools added:     +${diff.toolsAdded}`);
+        }
+        if (diff.toolsRemoved > 0) {
+            output.info(`Tools removed:   -${diff.toolsRemoved}`);
+        }
+        if (diff.toolsModified > 0) {
+            output.info(`Tools modified:  ~${diff.toolsModified}`);
+        }
+        if (diff.behaviorChanges > 0) {
+            output.info(`Behavior changes: ${diff.behaviorChanges}`);
+        }
+        if (diff.toolsAdded === 0 &&
+            diff.toolsRemoved === 0 &&
+            diff.toolsModified === 0 &&
+            diff.behaviorChanges === 0) {
+            output.info('No changes detected between these versions.');
+        }
+        if (diff.severity === 'breaking') {
+            output.info('\n⚠️  Breaking changes detected!');
+            output.info('   Tools were removed or modified in incompatible ways.');
+        }
+    }
+    catch (error) {
+        output.error('Failed to fetch diff: ' + (error instanceof Error ? error.message : String(error)));
+        process.exit(EXIT_CODES.ERROR);
+    }
+});
+//# sourceMappingURL=diff.js.map

package/dist/cli/commands/cloud/history.d.ts

@@ -0,0 +1,6 @@
+/**
+ * History command for viewing baseline history in Bellwether Cloud.
+ */
+import { Command } from 'commander';
+export declare const historyCommand: Command;
+//# sourceMappingURL=history.d.ts.map

package/dist/cli/commands/cloud/history.js

@@ -0,0 +1,102 @@
+/**
+ * History command for viewing baseline history in Bellwether Cloud.
+ */
+import { Command } from 'commander';
+import { formatDateLocale } from '../../../utils/index.js';
+import { EXIT_CODES } from '../../../constants.js';
+import { getSeverityIcon } from '../../output.js';
+import { loadConfigOrExit, getSessionTokenOrExit, createAuthenticatedClient, resolveProjectId } from './shared.js';
+import * as output from '../../output.js';
+export const historyCommand = new Command('history')
+    .description('View baseline history for a project')
+    .argument('[project-id]', 'Project ID (uses linked project if not specified)')
+    .option('-c, --config <path>', 'Path to config file')
+    .option('-n, --limit <n>', 'Number of versions to show')
+    .option('--json', 'Output as JSON')
+    .option('--session <session>', 'Session token (overrides stored/env session)')
+    .action(async (projectIdArg, options) => {
+    const config = loadConfigOrExit(options.config);
+    // Get session
+    const sessionToken = getSessionTokenOrExit(options.session);
+    // Determine project ID
+    const projectId = resolveProjectId(projectIdArg);
+    if (!projectId) {
+        output.error('No project specified.');
+        output.error('\nEither:');
+        output.error('  - Provide a project ID as argument');
+        output.error('  - Run `bellwether link` to link this directory to a project');
+        process.exit(EXIT_CODES.ERROR);
+    }
+    // Create client and fetch history
+    const client = createAuthenticatedClient(sessionToken);
+    const limit = parseInt(options.limit ?? String(config.history.limit), 10);
+    try {
+        const history = await client.getHistory(projectId, limit);
+        const outputJson = options.json ? true : config.history.json;
+        if (outputJson) {
+            output.info(JSON.stringify(history, null, 2));
+            return;
+        }
+        if (history.length === 0) {
+            output.info('No baselines uploaded yet.');
+            output.info('\nRun `bellwether check <server> --save-baseline` then `bellwether upload`.');
+            return;
+        }
+        // Get project info for display
+        const project = await client.getProject(projectId);
+        const projectName = project?.name ?? projectId;
+        output.info(`Baseline History: ${projectName}`);
+        output.info(`Showing ${history.length} version(s)\n`);
+        output.info('Ver  Uploaded                 CLI Version  Hash');
+        output.info('───  ───────────────────────  ───────────  ────────────────');
+        for (const baseline of history) {
+            const date = formatDateLocale(baseline.uploadedAt);
+            const cliVersion = baseline.cliVersion.padEnd(11);
+            const hash = baseline.hash.slice(0, 16);
+            output.info(`${baseline.version.toString().padStart(3)}  ` +
+                `${date.padEnd(23)}  ` +
+                `${cliVersion}  ` +
+                hash);
+        }
+        // Show diff summary if multiple versions
+        if (history.length >= 2) {
+            output.info('\nLatest changes:');
+            try {
+                const diff = await client.getLatestDiff(projectId);
+                if (diff) {
+                    printDiffSummary(diff);
+                }
+            }
+            catch {
+                // Diff failed, just skip
+            }
+        }
+    }
+    catch (error) {
+        output.error('Failed to fetch history: ' + (error instanceof Error ? error.message : String(error)));
+        process.exit(EXIT_CODES.ERROR);
+    }
+});
+function printDiffSummary(diff) {
+    const parts = [];
+    if (diff.toolsAdded > 0) {
+        parts.push(`+${diff.toolsAdded} tools`);
+    }
+    if (diff.toolsRemoved > 0) {
+        parts.push(`-${diff.toolsRemoved} tools`);
+    }
+    if (diff.toolsModified > 0) {
+        parts.push(`~${diff.toolsModified} modified`);
+    }
+    if (diff.behaviorChanges > 0) {
+        parts.push(`${diff.behaviorChanges} behavior changes`);
+    }
+    if (parts.length === 0) {
+        output.info('  No changes from previous version');
+    }
+    else {
+        const icon = getSeverityIcon(diff.severity);
+        output.info(`  ${icon} ${diff.severity}: ${parts.join(', ')}`);
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/cli/commands/cloud/link.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Link command for connecting current directory to a Bellwether Cloud project.
+ */
+import { Command } from 'commander';
+export declare const linkCommand: Command;
+/**
+ * Projects command for listing projects.
+ */
+//# sourceMappingURL=link.d.ts.map

package/dist/cli/commands/cloud/link.js

@@ -0,0 +1,119 @@
+/**
+ * Link command for connecting current directory to a Bellwether Cloud project.
+ */
+import { Command } from 'commander';
+import { basename } from 'path';
+import { getLinkedProject, saveProjectLink, removeProjectLink, getActiveTeam, getTeamId, } from '../../../cloud/auth.js';
+import { EXIT_CODES } from '../../../constants.js';
+import { loadConfigOrExit, getSessionTokenOrExit, createAuthenticatedClient } from './shared.js';
+import * as output from '../../output.js';
+export const linkCommand = new Command('link')
+    .description('Link current directory to a Bellwether Cloud project')
+    .argument('[project-id]', 'Project ID to link to (creates new if not specified)')
+    .option('-n, --name <name>', 'Project name (for new projects)')
+    .option('-c, --command <cmd>', 'Server command (for new projects)')
+    .option('--config <path>', 'Path to config file')
+    .option('--unlink', 'Remove the project link from current directory')
+    .option('--status', 'Show current link status')
+    .action(async (projectIdArg, options) => {
+    const config = loadConfigOrExit(options.config);
+    // Handle --status
+    if (options.status) {
+        showLinkStatus();
+        return;
+    }
+    // Handle --unlink
+    if (options.unlink) {
+        if (removeProjectLink()) {
+            output.info('Project link removed.');
+        }
+        else {
+            output.info('No project link to remove.');
+        }
+        return;
+    }
+    // Check authentication
+    const sessionToken = getSessionTokenOrExit();
+    const client = createAuthenticatedClient(sessionToken);
+    let project;
+    if (projectIdArg) {
+        // Link to existing project
+        output.info(`Looking up project ${projectIdArg}...`);
+        project = await client.getProject(projectIdArg);
+        if (!project) {
+            output.error(`Project not found: ${projectIdArg}`);
+            output.error('\nUse `bellwether link` without an ID to create a new project.');
+            process.exit(EXIT_CODES.ERROR);
+        }
+        output.info(`Found project: ${project.name}`);
+    }
+    else {
+        // Create new project
+        const projectName = options.name ?? inferProjectName();
+        const serverCommand = options.command ?? config.link.defaultServerCommand;
+        output.info(`Creating project "${projectName}"...`);
+        try {
+            project = await client.createProject(projectName, serverCommand);
+            output.info(`Project created: ${project.id}`);
+        }
+        catch (error) {
+            output.error('Failed to create project: ' + (error instanceof Error ? error.message : String(error)));
+            process.exit(EXIT_CODES.ERROR);
+        }
+    }
+    // Get active team for the link
+    const activeTeam = getActiveTeam();
+    const teamId = getTeamId();
+    // Save link with team context
+    const link = {
+        projectId: project.id,
+        projectName: project.name,
+        linkedAt: new Date().toISOString(),
+        teamId,
+        teamName: activeTeam?.name,
+    };
+    saveProjectLink(link);
+    output.info(`\nLinked to project: ${project.name}`);
+    output.info(`Project ID: ${project.id}`);
+    if (activeTeam) {
+        output.info(`Team: ${activeTeam.name}`);
+    }
+    output.info(`Server command: ${project.serverCommand}`);
+    output.info('\nSaved to .bellwether/link.json');
+    output.info('\nYou can now run:');
+    output.info('  bellwether check <server> --save-baseline');
+    output.info('  bellwether upload');
+});
+/**
+ * Infer project name from current directory.
+ */
+function inferProjectName() {
+    return basename(process.cwd());
+}
+/**
+ * Show current link status.
+ */
+function showLinkStatus() {
+    const link = getLinkedProject();
+    if (!link) {
+        output.info('Not linked to any project.');
+        output.info('\nRun `bellwether link` to create or link to a project.');
+        return;
+    }
+    output.info('Project Link Status');
+    output.info('───────────────────');
+    output.info(`Project: ${link.projectName}`);
+    output.info(`ID:      ${link.projectId}`);
+    if (link.teamName) {
+        output.info(`Team:    ${link.teamName}`);
+    }
+    if (link.teamId) {
+        output.info(`Team ID: ${link.teamId}`);
+    }
+    output.info(`Linked:  ${new Date(link.linkedAt).toLocaleString()}`);
+    output.info(`Config:  .bellwether/link.json`);
+}
+/**
+ * Projects command for listing projects.
+ */
+//# sourceMappingURL=link.js.map

package/dist/cli/commands/cloud/login.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Login command for Bellwether Cloud authentication using OAuth.
+ * Supports GitHub and Google as authentication providers.
+ */
+import { Command } from 'commander';
+export declare const loginCommand: Command;
+//# sourceMappingURL=login.d.ts.map