@meltstudio/meltctl 4.29.1 → 4.31.0

package/dist/commands/audit.test.js

@@ -3,6 +3,8 @@ vi.mock('fs-extra', () => ({
     default: {
         pathExists: vi.fn(),
         readFile: vi.fn(),
+        ensureDir: vi.fn(),
+        writeFile: vi.fn(),
     },
 }));
 vi.mock('../utils/api.js', () => ({
@@ -19,7 +21,7 @@ vi.mock('../utils/git.js', () => ({
 import fs from 'fs-extra';
 import { getToken, tokenFetch } from '../utils/api.js';
 import { getGitBranch, getGitCommit, getGitRepository, getProjectName, findMdFiles, } from '../utils/git.js';
-import { auditSubmitCommand, auditListCommand } from './audit.js';
+import { auditSubmitCommand, auditListCommand, auditViewCommand } from './audit.js';
 beforeEach(() => {
     vi.clearAllMocks();
     vi.spyOn(console, 'log').mockImplementation(() => { });
@@ -320,3 +322,94 @@ describe('auditListCommand', () => {
         expect(errorCalls.some((msg) => typeof msg === 'string' && msg.includes('No audits found'))).toBe(true);
     });
 });
+describe('auditViewCommand', () => {
+    const sampleAudit = {
+        id: 'audit-abc123',
+        type: 'ux-audit',
+        project: 'my-project',
+        repository: 'Org/Repo',
+        author: 'dev@meltstudio.co',
+        branch: 'main',
+        commit: 'abc1234',
+        content: '# UX Audit\n\nFindings here.',
+        createdAt: '2026-03-25T10:00:00Z',
+    };
+    it('exits with "Access denied" on 403 response', async () => {
+        ;
+        getToken.mockResolvedValue('test-token');
+        tokenFetch.mockResolvedValue({
+            ok: false,
+            status: 403,
+            statusText: 'Forbidden',
+        });
+        await expect(auditViewCommand('audit-abc123', {})).rejects.toThrow('process.exit(1)');
+        const errorCalls = console.error.mock.calls.map((c) => String(c[0]));
+        expect(errorCalls.some((msg) => msg.includes('Access denied'))).toBe(true);
+    });
+    it('exits with "Audit not found" on 404 response', async () => {
+        ;
+        getToken.mockResolvedValue('test-token');
+        tokenFetch.mockResolvedValue({
+            ok: false,
+            status: 404,
+            statusText: 'Not Found',
+        });
+        await expect(auditViewCommand('nonexistent-id', {})).rejects.toThrow('process.exit(1)');
+        const errorCalls = console.error.mock.calls.map((c) => String(c[0]));
+        expect(errorCalls.some((msg) => msg.includes('Audit not found'))).toBe(true);
+    });
+    it('exits with error from body on non-ok response', async () => {
+        ;
+        getToken.mockResolvedValue('test-token');
+        tokenFetch.mockResolvedValue({
+            ok: false,
+            status: 500,
+            statusText: 'Internal Server Error',
+            json: vi.fn().mockResolvedValue({ error: 'Database unavailable' }),
+        });
+        await expect(auditViewCommand('audit-abc123', {})).rejects.toThrow('process.exit(1)');
+        const errorCalls = console.error.mock.calls.map((c) => String(c[0]));
+        expect(errorCalls.some((msg) => msg.includes('Database unavailable'))).toBe(true);
+    });
+    it('prints audit content with header when no --output flag', async () => {
+        ;
+        getToken.mockResolvedValue('test-token');
+        tokenFetch.mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: vi.fn().mockResolvedValue(sampleAudit),
+        });
+        await auditViewCommand('audit-abc123', {});
+        const logCalls = console.log.mock.calls.map((c) => String(c[0]));
+        // Header should contain type label, repo, author, and date
+        expect(logCalls.some((msg) => msg.includes('UX Audit'))).toBe(true);
+        expect(logCalls.some((msg) => msg.includes('Org/Repo'))).toBe(true);
+        expect(logCalls.some((msg) => msg.includes('dev@meltstudio.co'))).toBe(true);
+        // Content should be printed
+        expect(logCalls.some((msg) => msg.includes('# UX Audit'))).toBe(true);
+    });
+    it('writes content to file with --output flag', async () => {
+        ;
+        getToken.mockResolvedValue('test-token');
+        tokenFetch.mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: vi.fn().mockResolvedValue(sampleAudit),
+        });
+        fs.ensureDir.mockResolvedValue(undefined);
+        fs.writeFile.mockResolvedValue(undefined);
+        await auditViewCommand('audit-abc123', { output: 'output/audit.md' });
+        expect(fs.ensureDir).toHaveBeenCalled();
+        expect(fs.writeFile).toHaveBeenCalledWith(expect.stringContaining('audit.md'), '# UX Audit\n\nFindings here.', 'utf-8');
+        const logCalls = console.log.mock.calls.map((c) => String(c[0]));
+        expect(logCalls.some((msg) => msg.includes('Audit saved to'))).toBe(true);
+    });
+    it('exits with error message on network error', async () => {
+        ;
+        getToken.mockResolvedValue('test-token');
+        tokenFetch.mockRejectedValue(new Error('Network error'));
+        await expect(auditViewCommand('audit-abc123', {})).rejects.toThrow('process.exit(1)');
+        const errorCalls = console.error.mock.calls.map((c) => String(c[0]));
+        expect(errorCalls.some((msg) => msg.includes('Network error'))).toBe(true);
+    });
+});

package/dist/index.js

@@ -29,6 +29,20 @@ program
     printBanner();
     return '';
 })
+    .addHelpText('after', `
+${chalk.bold('AI Skills')} ${chalk.dim('(run these in your AI coding tool, not the CLI):')}
+${chalk.dim('  /melt-setup            Analyze the project and customize AGENTS.md')}
+${chalk.dim('  /melt-plan             Design an implementation approach before writing code')}
+${chalk.dim('  /melt-validate         Run the validation plan and verify end-to-end')}
+${chalk.dim('  /melt-review           Review changes against project standards')}
+${chalk.dim('  /melt-pr               Create a well-structured pull request')}
+${chalk.dim('  /melt-debug            Systematically investigate and fix bugs')}
+${chalk.dim('  /melt-audit            Run a project compliance audit')}
+${chalk.dim('  /melt-ux-audit         Review UI against usability heuristics')}
+${chalk.dim('  /melt-security-audit   Run a security posture audit across the platform')}
+${chalk.dim('  /melt-update           Update Melt skills to the latest version')}
+${chalk.dim('  /melt-help             Answer questions about the development playbook')}
+`)
     .hook('preAction', async () => {
     await checkAndEnforceUpdate();
 });
@@ -44,7 +58,14 @@ program
     .action(async () => {
     await logoutCommand();
 });
-const project = program.command('project').description('manage project configuration');
+const project = program
+    .command('project')
+    .description('manage project configuration')
+    .addHelpText('after', `
+${chalk.dim('Related skills (run in your AI coding tool after init):')}
+${chalk.dim('  /melt-setup    Analyze the project and customize AGENTS.md')}
+${chalk.dim('  /melt-update   Update Melt skills to the latest version')}
+`);
 project
     .command('init')
     .description('scaffold Melt development tools into the current directory (AGENTS.md, .claude/, .cursor/, .opencode/, .mcp.json)')
@@ -91,7 +112,15 @@ program
     .action(async (options) => {
     await coinsCommand(options);
 });
-const audit = program.command('audit').description('submit and list audits');
+const audit = program
+    .command('audit')
+    .description('submit and list audits')
+    .addHelpText('after', `
+${chalk.dim('Related skills (run in your AI coding tool):')}
+${chalk.dim('  /melt-audit            Run a project compliance audit')}
+${chalk.dim('  /melt-ux-audit         Review UI against usability heuristics')}
+${chalk.dim('  /melt-security-audit   Run a security posture audit across the platform')}
+`);
 audit
     .command('submit')
     .description('submit an audit report from a markdown file')
@@ -117,7 +146,13 @@ audit
     .action(async (id, options) => {
     await auditViewCommand(id, options);
 });
-const plan = program.command('plan').description('submit and list plans');
+const plan = program
+    .command('plan')
+    .description('submit and list plans')
+    .addHelpText('after', `
+${chalk.dim('Related skill (run in your AI coding tool):')}
+${chalk.dim('  /melt-plan   Design an implementation approach before writing code')}
+`);
 plan
     .command('submit')
     .description('submit or update a plan from a markdown file')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltstudio/meltctl",
-  "version": "4.29.1",
+  "version": "4.31.0",
   "description": "AI-first development tools for teams - set up AGENTS.md, Claude Code, Cursor, and OpenCode standards",
   "main": "dist/index.js",
   "type": "module",