feedbackbasket-cli 0.3.0

package/dist/src/commands/projects.js

@@ -0,0 +1,218 @@
+import { Command } from 'commander';
+import { FeedbackBasketClient } from '../client.js';
+import { AuthManager } from '../auth/manager.js';
+import { loadConfig } from '../config/config.js';
+import { errAuth, errUsage } from '../output/errors.js';
+import { brand, divider } from '../output/theme.js';
+import { confirm } from '../prompt.js';
+import { resolveProject } from '../resolve.js';
+export function createProjectsCommand(getWriter) {
+    const projects = new Command('projects')
+        .alias('project')
+        .description('Manage projects');
+    // --- projects list ---
+    projects
+        .command('list')
+        .description('List all accessible projects')
+        .action(async () => {
+        const writer = getWriter();
+        const client = requireClient();
+        const result = await client.listProjects();
+        const data = result.projects;
+        if (!writer.isMachineOutput()) {
+            renderProjectsTable(data);
+        }
+        writer.ok(data, {
+            summary: `${result.totalProjects} project${result.totalProjects === 1 ? '' : 's'}`,
+            breadcrumbs: data.length > 0
+                ? [
+                    { action: 'Show project', cmd: `feedbackbasket projects show ${data[0].id}` },
+                    { action: 'View feedback', cmd: `feedbackbasket feedback list --project ${data[0].id}` },
+                    { action: 'Create project', cmd: 'feedbackbasket projects create "My Project" --url https://example.com' },
+                ]
+                : [{ action: 'Create project', cmd: 'feedbackbasket projects create "My Project" --url https://example.com' }],
+        });
+    });
+    // --- projects show ---
+    projects
+        .command('show <id-or-name>')
+        .description('Show project details (accepts ID or name)')
+        .action(async (idOrName) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const project = await resolveProject(client, idOrName);
+        if (!writer.isMachineOutput()) {
+            renderProjectDetail(project);
+        }
+        writer.ok(project, {
+            summary: project.name,
+            breadcrumbs: [
+                { action: 'View feedback', cmd: `feedbackbasket feedback list --project ${project.id}` },
+                { action: 'View bugs', cmd: `feedbackbasket bugs list --project ${project.id}` },
+                { action: 'Update project', cmd: `feedbackbasket projects update ${project.id} --name "New Name"` },
+            ],
+        });
+    });
+    // --- projects create ---
+    projects
+        .command('create <name>')
+        .description('Create a new project')
+        .requiredOption('--url <url>', 'Project URL')
+        .option('--description <text>', 'Project description')
+        .action(async (name, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const result = await client.createProject({
+            name,
+            url: opts.url,
+            description: opts.description,
+        });
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('✓')} Project created: ${brand.bold(result.project.name)}`);
+            console.log(`    ${brand.muted('ID:')} ${result.project.id}`);
+            console.log();
+        }
+        writer.ok(result.project, {
+            summary: `Created project "${result.project.name}"`,
+            breadcrumbs: [
+                { action: 'View project', cmd: `feedbackbasket projects show ${result.project.id}` },
+                { action: 'Get widget script', cmd: `feedbackbasket widget script ${result.project.id}` },
+                { action: 'List all projects', cmd: 'feedbackbasket projects list' },
+            ],
+        });
+    });
+    // --- projects update ---
+    projects
+        .command('update <id-or-name>')
+        .description('Update a project (accepts ID or name)')
+        .option('--name <name>', 'New project name')
+        .option('--url <url>', 'New project URL')
+        .option('--description <text>', 'New project description')
+        .action(async (idOrName, opts) => {
+        const writer = getWriter();
+        if (!opts.name && !opts.url && opts.description === undefined) {
+            throw errUsage('At least one of --name, --url, or --description is required', 'Example: feedbackbasket projects update <id> --name "New Name"');
+        }
+        const client = requireClient();
+        const resolved = await resolveProject(client, idOrName);
+        const id = resolved.id;
+        const data = {};
+        if (opts.name)
+            data['name'] = opts.name;
+        if (opts.url)
+            data['url'] = opts.url;
+        if (opts.description !== undefined)
+            data['description'] = opts.description;
+        const updated = await client.updateProject(id, data);
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('✓')} Project updated: ${brand.bold(updated.name)}`);
+            console.log();
+        }
+        writer.ok(updated, {
+            summary: `Updated project "${updated.name}"`,
+            breadcrumbs: [
+                { action: 'View project', cmd: `feedbackbasket projects show ${id}` },
+                { action: 'List all projects', cmd: 'feedbackbasket projects list' },
+            ],
+        });
+    });
+    // --- projects delete ---
+    projects
+        .command('delete <id-or-name>')
+        .description('Delete a project (accepts ID or name)')
+        .option('--yes', 'Skip confirmation prompt')
+        .action(async (idOrName, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const resolved = await resolveProject(client, idOrName);
+        const id = resolved.id;
+        const projectName = resolved.name;
+        // Confirmation (skip in agent mode or --yes)
+        if (!opts.yes && !writer.isMachineOutput() && process.stdin.isTTY) {
+            console.log(`  ${brand.warning('Warning:')} This will permanently delete project "${brand.bold(projectName)}"`);
+            console.log(`  ${brand.muted('All feedback, notes, and settings will be lost.')}`);
+            console.log();
+            const confirmed = await confirm(`  Delete "${projectName}"?`, false);
+            if (!confirmed) {
+                console.log(brand.muted('  Cancelled.'));
+                return;
+            }
+        }
+        const result = await client.deleteProject(id);
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('✓')} Deleted project "${brand.bold(result.name)}"`);
+            console.log();
+        }
+        writer.ok(result, {
+            summary: `Deleted project "${result.name}"`,
+            breadcrumbs: [
+                { action: 'List remaining projects', cmd: 'feedbackbasket projects list' },
+                { action: 'Create new project', cmd: 'feedbackbasket projects create "Name" --url https://...' },
+            ],
+        });
+    });
+    return projects;
+}
+function requireClient() {
+    const manager = new AuthManager();
+    const token = manager.resolveToken();
+    if (!token)
+        throw errAuth();
+    const config = loadConfig();
+    return new FeedbackBasketClient(token, config.baseUrl);
+}
+function renderProjectsTable(projects) {
+    if (projects.length === 0)
+        return;
+    const nameW = Math.max(4, ...projects.map(p => p.name.length));
+    const header = [
+        brand.bold('Name'.padEnd(nameW)),
+        brand.bold('ID'.padEnd(26)),
+        brand.bold('Total'.padStart(6)),
+        brand.bold('Open'.padStart(6)),
+        brand.bold('Bugs'.padStart(6)),
+    ].join('  ');
+    console.log(header);
+    console.log(divider(header.length));
+    for (const p of projects) {
+        const open = p.byStatus['OPEN'] ?? 0;
+        const bugs = p.byCategory['BUG'] ?? 0;
+        const row = [
+            p.name.padEnd(nameW),
+            brand.muted(p.id.padEnd(26)),
+            String(p.totalFeedback).padStart(6),
+            open > 0 ? brand.warning(String(open).padStart(6)) : brand.muted(String(open).padStart(6)),
+            bugs > 0 ? brand.error(String(bugs).padStart(6)) : brand.muted(String(bugs).padStart(6)),
+        ].join('  ');
+        console.log(row);
+    }
+}
+function renderProjectDetail(project) {
+    console.log(brand.bold(project.name));
+    console.log(divider(40));
+    console.log();
+    console.log(`  ${brand.label('ID'.padEnd(14))} ${project.id}`);
+    console.log(`  ${brand.label('URL'.padEnd(14))} ${project.url}`);
+    if (project.description) {
+        console.log(`  ${brand.label('Description'.padEnd(14))} ${project.description}`);
+    }
+    console.log(`  ${brand.label('Created'.padEnd(14))} ${project.createdAt}`);
+    console.log(`  ${brand.label('Feedback'.padEnd(14))} ${project.totalFeedback}`);
+    const statusEntries = Object.entries(project.byStatus);
+    if (statusEntries.length > 0) {
+        console.log();
+        console.log(brand.bold('By Status'));
+        for (const [status, count] of statusEntries) {
+            console.log(`  ${status.padEnd(14)} ${count}`);
+        }
+    }
+    const catEntries = Object.entries(project.byCategory);
+    if (catEntries.length > 0) {
+        console.log();
+        console.log(brand.bold('By Category'));
+        for (const [cat, count] of catEntries) {
+            console.log(`  ${cat.padEnd(18)} ${count}`);
+        }
+    }
+    console.log();
+}

package/dist/src/commands/setup.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import type { OutputWriter } from '../output/writer.js';
+export declare function createSetupCommand(getWriter: () => OutputWriter): Command;

package/dist/src/commands/setup.js

@@ -0,0 +1,90 @@
+import { Command } from 'commander';
+import { existsSync, mkdirSync, copyFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { brand } from '../output/theme.js';
+export function createSetupCommand(getWriter) {
+    const setup = new Command('setup')
+        .description('Set up agent integrations');
+    setup
+        .command('claude')
+        .description('Install FeedbackBasket skill for Claude Code')
+        .action(() => {
+        const writer = getWriter();
+        const results = [];
+        const claudeDir = join(homedir(), '.claude');
+        const claudeExists = existsSync(claudeDir);
+        if (!claudeExists) {
+            results.push({
+                step: 'Detect Claude Code',
+                status: 'fail',
+                message: `~/.claude/ not found. Is Claude Code installed?`,
+            });
+            if (!writer.isMachineOutput()) {
+                console.log(brand.error('Claude Code not detected'));
+                console.log(brand.muted('  ~/.claude/ directory not found'));
+                console.log(brand.muted('  Install Claude Code first: https://claude.ai/code'));
+            }
+            writer.ok({ installed: false, results }, {
+                summary: 'Claude Code not detected',
+            });
+            return;
+        }
+        const skillDir = join(claudeDir, 'skills', 'feedbackbasket');
+        const skillDest = join(skillDir, 'SKILL.md');
+        try {
+            const thisDir = dirname(fileURLToPath(import.meta.url));
+            const projectRoot = join(thisDir, '..', '..', '..');
+            const skillSrc = join(projectRoot, 'skills', 'feedbackbasket', 'SKILL.md');
+            if (!existsSync(skillSrc)) {
+                const altSrc = join(thisDir, '..', '..', 'skills', 'feedbackbasket', 'SKILL.md');
+                if (!existsSync(altSrc)) {
+                    results.push({
+                        step: 'Copy skill file',
+                        status: 'fail',
+                        message: 'SKILL.md source not found in package',
+                    });
+                    writer.ok({ installed: false, results }, {
+                        summary: 'Skill file not found',
+                    });
+                    return;
+                }
+                mkdirSync(skillDir, { recursive: true });
+                copyFileSync(altSrc, skillDest);
+            }
+            else {
+                mkdirSync(skillDir, { recursive: true });
+                copyFileSync(skillSrc, skillDest);
+            }
+            results.push({
+                step: 'Install skill',
+                status: 'ok',
+                message: skillDest,
+            });
+        }
+        catch (error) {
+            results.push({
+                step: 'Install skill',
+                status: 'fail',
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+        if (!writer.isMachineOutput()) {
+            for (const r of results) {
+                const icon = r.status === 'ok' ? brand.success('✓') : r.status === 'skip' ? brand.warning('-') : brand.error('✗');
+                console.log(`  ${icon} ${r.step}: ${r.message}`);
+            }
+            console.log();
+        }
+        const allOk = results.every(r => r.status !== 'fail');
+        writer.ok({ installed: allOk, results }, {
+            summary: allOk ? 'FeedbackBasket skill installed for Claude Code' : 'Setup completed with errors',
+            breadcrumbs: [
+                { action: 'Start a new Claude Code session to use FeedbackBasket commands', cmd: 'claude' },
+                { action: 'Run diagnostics', cmd: 'feedbackbasket doctor' },
+            ],
+        });
+    });
+    return setup;
+}

package/dist/src/commands/team.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import type { OutputWriter } from '../output/writer.js';
+export declare function createTeamCommand(getWriter: () => OutputWriter): Command;

package/dist/src/commands/team.js

@@ -0,0 +1,112 @@
+import { Command } from 'commander';
+import { FeedbackBasketClient } from '../client.js';
+import { AuthManager } from '../auth/manager.js';
+import { loadConfig } from '../config/config.js';
+import { errAuth, errUsage } from '../output/errors.js';
+import { brand, divider } from '../output/theme.js';
+import { confirm } from '../prompt.js';
+export function createTeamCommand(getWriter) {
+    const team = new Command('team')
+        .description('Manage organization members');
+    // --- team list ---
+    team
+        .command('list')
+        .description('List organization members')
+        .action(async () => {
+        const writer = getWriter();
+        const client = requireClient();
+        const result = await client.listTeam();
+        if (!writer.isMachineOutput()) {
+            renderTeamTable(result.members);
+        }
+        writer.ok(result.members, {
+            summary: `${result.totalMembers} member${result.totalMembers === 1 ? '' : 's'}`,
+            breadcrumbs: [
+                { action: 'Update role', cmd: 'feedbackbasket team role <memberId> --role admin' },
+            ],
+        });
+    });
+    // --- team role ---
+    team
+        .command('role <memberId>')
+        .description('Update a member\'s role')
+        .requiredOption('--role <role>', 'New role: admin or member')
+        .action(async (memberId, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        if (!['admin', 'member'].includes(opts.role)) {
+            throw errUsage('Role must be "admin" or "member"');
+        }
+        const result = await client.updateMemberRole(memberId, opts.role);
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('✓')} Updated ${brand.bold(result.name)} to ${brand.bold(result.role)}`);
+            console.log();
+        }
+        writer.ok(result, {
+            summary: `Updated ${result.name} to ${result.role}`,
+            breadcrumbs: [
+                { action: 'List team', cmd: 'feedbackbasket team list' },
+            ],
+        });
+    });
+    // --- team remove ---
+    team
+        .command('remove <memberId>')
+        .description('Remove a member from the organization')
+        .option('--yes', 'Skip confirmation')
+        .action(async (memberId, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        if (!opts.yes && !writer.isMachineOutput() && process.stdin.isTTY) {
+            const confirmed = await confirm(`  Remove member ${memberId}?`, false);
+            if (!confirmed) {
+                console.log(brand.muted('  Cancelled.'));
+                return;
+            }
+        }
+        const result = await client.removeMember(memberId);
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('✓')} Removed ${brand.bold(result.name)} (${result.email})`);
+            console.log();
+        }
+        writer.ok(result, {
+            summary: `Removed ${result.name}`,
+            breadcrumbs: [
+                { action: 'List team', cmd: 'feedbackbasket team list' },
+            ],
+        });
+    });
+    return team;
+}
+function requireClient() {
+    const manager = new AuthManager();
+    const token = manager.resolveToken();
+    if (!token)
+        throw errAuth();
+    const config = loadConfig();
+    return new FeedbackBasketClient(token, config.baseUrl);
+}
+function renderTeamTable(members) {
+    if (members.length === 0)
+        return;
+    const nameW = Math.max(4, ...members.map(m => m.name.length));
+    const emailW = Math.max(5, ...members.map(m => m.email.length));
+    const header = [
+        brand.bold('Name'.padEnd(nameW)),
+        brand.bold('Email'.padEnd(emailW)),
+        brand.bold('Role'.padEnd(8)),
+        brand.bold('Member ID'),
+    ].join('  ');
+    console.log(header);
+    console.log(divider(header.length));
+    for (const m of members) {
+        const roleColor = m.role === 'owner' ? brand.primary : m.role === 'admin' ? brand.warning : brand.muted;
+        const row = [
+            m.name.padEnd(nameW),
+            brand.muted(m.email.padEnd(emailW)),
+            roleColor(m.role.padEnd(8)),
+            brand.muted(m.memberId),
+        ].join('  ');
+        console.log(row);
+    }
+}

package/dist/src/commands/widget.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import type { OutputWriter } from '../output/writer.js';
+export declare function createWidgetCommand(getWriter: () => OutputWriter): Command;

package/dist/src/commands/widget.js

@@ -0,0 +1,153 @@
+import { Command } from 'commander';
+import { FeedbackBasketClient } from '../client.js';
+import { AuthManager } from '../auth/manager.js';
+import { loadConfig } from '../config/config.js';
+import { errAuth, errUsage } from '../output/errors.js';
+import { brand, divider } from '../output/theme.js';
+import { resolveProject } from '../resolve.js';
+export function createWidgetCommand(getWriter) {
+    const widget = new Command('widget')
+        .description('Manage feedback widget');
+    // --- widget settings ---
+    widget
+        .command('settings [project]')
+        .description('View or update widget settings')
+        .option('--color <hex>', 'Button color (e.g. #22c55e)')
+        .option('--label <text>', 'Button label')
+        .option('--position <pos>', 'Widget position (bottom-right, bottom-left, top-right, top-left)')
+        .option('--intro <text>', 'Intro message shown in the widget')
+        .option('--success <text>', 'Success message after submission')
+        .option('--trigger <mode>', 'Trigger mode (floating, manual)')
+        .option('--display <mode>', 'Display mode (modal, popover)')
+        .option('--email-required', 'Require email from submitters')
+        .option('--no-email-required', 'Make email optional')
+        .option('--icon-only', 'Show only the icon, no label')
+        .option('--no-icon-only', 'Show both icon and label')
+        .action(async (projectArg, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        const hasUpdates = opts.color || opts.label || opts.position || opts.intro ||
+            opts.success || opts.trigger || opts.display ||
+            opts.emailRequired !== undefined || opts.iconOnly !== undefined;
+        if (hasUpdates) {
+            // Update mode
+            const settings = {};
+            if (opts.color)
+                settings.buttonColor = opts.color;
+            if (opts.label)
+                settings.buttonLabel = opts.label;
+            if (opts.position)
+                settings.position = opts.position;
+            if (opts.intro)
+                settings.introMessage = opts.intro;
+            if (opts.success)
+                settings.successMessage = opts.success;
+            if (opts.trigger)
+                settings.triggerMode = opts.trigger;
+            if (opts.display)
+                settings.displayMode = opts.display;
+            if (opts.emailRequired !== undefined)
+                settings.emailRequired = opts.emailRequired;
+            if (opts.iconOnly !== undefined)
+                settings.iconOnly = opts.iconOnly;
+            const result = await client.updateWidgetSettings(projectId, settings);
+            if (!writer.isMachineOutput()) {
+                console.log(`  ${brand.success('✓')} Widget settings updated for ${brand.bold(result.projectName)}`);
+                console.log();
+            }
+            writer.ok(result.settings, {
+                summary: `Updated widget for "${result.projectName}"`,
+                breadcrumbs: [
+                    { action: 'Get embed code', cmd: `feedbackbasket widget script ${projectId}` },
+                    { action: 'View settings', cmd: `feedbackbasket widget settings ${projectId}` },
+                ],
+            });
+        }
+        else {
+            // View mode
+            const result = await client.getWidgetSettings(projectId);
+            if (!writer.isMachineOutput()) {
+                renderWidgetSettings(result.projectName, result.settings);
+            }
+            writer.ok(result.settings, {
+                summary: `Widget settings for "${result.projectName}"`,
+                breadcrumbs: [
+                    { action: 'Update color', cmd: `feedbackbasket widget settings ${projectId} --color "#22c55e"` },
+                    { action: 'Get embed code', cmd: `feedbackbasket widget script ${projectId}` },
+                ],
+            });
+        }
+    });
+    // --- widget script ---
+    widget
+        .command('script [project]')
+        .description('Get the embed script for your website')
+        .action(async (projectArg) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        const result = await client.getWidgetScript(projectId);
+        if (!writer.isMachineOutput()) {
+            console.log(brand.bold(`Widget embed code for ${result.projectName}`));
+            console.log(divider(50));
+            console.log();
+            console.log(brand.muted('  Add this to your HTML, before </body>:'));
+            console.log();
+            console.log(`  ${brand.primary(result.embedCode)}`);
+            console.log();
+            console.log(brand.muted(`  Script URL: ${result.scriptUrl}`));
+            console.log();
+        }
+        writer.ok(result, {
+            summary: `Embed code for "${result.projectName}"`,
+            breadcrumbs: [
+                { action: 'Customize widget', cmd: `feedbackbasket widget settings ${projectId}` },
+                { action: 'View project', cmd: `feedbackbasket projects show ${projectId}` },
+            ],
+        });
+    });
+    return widget;
+}
+function requireClient() {
+    const manager = new AuthManager();
+    const token = manager.resolveToken();
+    if (!token)
+        throw errAuth();
+    const config = loadConfig();
+    return new FeedbackBasketClient(token, config.baseUrl);
+}
+async function resolveProjectId(client, projectArg) {
+    if (projectArg) {
+        const project = await resolveProject(client, projectArg);
+        return project.id;
+    }
+    const config = loadConfig();
+    if (config.defaultProject)
+        return config.defaultProject;
+    throw errUsage('Project is required. Pass a project name/ID or set a default.', 'feedbackbasket widget settings <project> or feedbackbasket config set defaultProject <id>');
+}
+function renderWidgetSettings(projectName, settings) {
+    console.log(brand.bold(`Widget settings — ${projectName}`));
+    console.log(divider(40));
+    console.log();
+    const display = [
+        ['Button Color', String(settings.buttonColor ?? '')],
+        ['Button Label', String(settings.buttonLabel ?? '')],
+        ['Button Radius', String(settings.buttonRadius ?? '')],
+        ['Icon Only', String(settings.iconOnly ?? false)],
+        ['Show Icon', String(settings.showIcon ?? true)],
+        ['Position', String(settings.position ?? '')],
+        ['Trigger Mode', String(settings.triggerMode ?? '')],
+        ['Display Mode', String(settings.displayMode ?? '')],
+        ['Email Required', String(settings.emailRequired ?? false)],
+        ['Intro Message', String(settings.introMessage ?? '')],
+        ['Success Message', String(settings.successMessage ?? '')],
+        ['Z-Index', String(settings.zIndex ?? '')],
+        ['Show Branding', String(settings.showBranding ?? true)],
+    ];
+    for (const [label, value] of display) {
+        console.log(`  ${brand.label(label.padEnd(18))} ${value}`);
+    }
+    console.log();
+}

package/dist/src/config/config.d.ts

@@ -0,0 +1,10 @@
+export interface Config {
+    baseUrl: string;
+    defaultProject?: string;
+}
+export declare function setBaseUrlOverride(url: string): void;
+export declare function configDir(): string;
+export declare function ensureConfigDir(): void;
+export declare function configPath(): string;
+export declare function loadConfig(): Config;
+export declare function saveConfig(config: Config): void;

package/dist/src/config/config.js

@@ -0,0 +1,41 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const DEFAULT_BASE_URL = 'https://feedbackbasket.com';
+// Runtime override from --base-url flag
+let baseUrlOverride;
+export function setBaseUrlOverride(url) {
+    baseUrlOverride = url;
+}
+export function configDir() {
+    return join(homedir(), '.config', 'feedbackbasket');
+}
+export function ensureConfigDir() {
+    const dir = configDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+export function configPath() {
+    return join(configDir(), 'config.json');
+}
+export function loadConfig() {
+    const envUrl = process.env['FEEDBACKBASKET_BASE_URL'];
+    try {
+        const raw = readFileSync(configPath(), 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            baseUrl: baseUrlOverride ?? envUrl ?? parsed.baseUrl ?? DEFAULT_BASE_URL,
+            defaultProject: parsed.defaultProject,
+        };
+    }
+    catch {
+        return {
+            baseUrl: baseUrlOverride ?? envUrl ?? DEFAULT_BASE_URL,
+        };
+    }
+}
+export function saveConfig(config) {
+    ensureConfigDir();
+    writeFileSync(configPath(), JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
+}

package/dist/src/config/credentials.d.ts

@@ -0,0 +1,12 @@
+export interface Credentials {
+    token: string;
+    scope: 'read' | 'full';
+    userId?: string;
+    email?: string;
+    organizationId?: string;
+    createdAt: string;
+}
+export declare function loadCredentials(): Credentials | null;
+export declare function saveCredentials(creds: Credentials): void;
+export declare function clearCredentials(): void;
+export declare function maskToken(token: string): string;