@meltstudio/meltctl 4.30.0 → 4.32.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/commands/init.js

@@ -117,6 +117,16 @@ description: >-
   This is a reference skill — it explains the process, not executes it.
 ---
 
+`,
+    link: `---
+user-invocable: true
+description: >-
+  Connect and verify required integrations (ticket tracker, browser
+  testing). Use after melt-setup, when tools aren't working, or when
+  a skill reports missing MCP connections. Guides setup, verifies
+  each tool works, and updates AGENTS.md connection status.
+---
+
 `,
 };
 const OPENCODE_COMMAND_FRONTMATTER = {
@@ -174,6 +184,11 @@ description: Update Melt skills and standards to the latest version.
 description: Answer questions about the AI-First Development Playbook and team workflow.
 ---
 
+`,
+    link: `---
+description: Connect and verify required integrations (ticket tracker, browser testing).
+---
+
 `,
 };
 const GITIGNORE_ENTRIES = ['.env.local', '.claude/settings.local.json'];
@@ -321,6 +336,7 @@ export async function initCommand(options) {
         'security-audit',
         'update',
         'help',
+        'link',
     ];
     // Shared files (skip on re-init)
     if (!isReInit) {
@@ -443,7 +459,7 @@ export async function initCommand(options) {
         }
         console.log();
         console.log(chalk.dim('  The setup skill will analyze your project and fill in AGENTS.md.'));
-        console.log(chalk.dim('  Once it finishes, commit the changes to share with your team.'));
+        console.log(chalk.dim('  Then run /melt-link to connect your ticket tracker and browser testing tools.'));
         console.log();
     }
     console.log(chalk.green('Done!'));

package/dist/commands/init.test.js

@@ -36,6 +36,7 @@ const MOCK_TEMPLATES = {
     'workflows/security-audit.md': '# Security Audit Workflow\nSecurity check.',
     'workflows/update.md': '# Update Workflow\nUpdate skills.',
     'workflows/help.md': '# Help Workflow\nAnswer questions.',
+    'workflows/link.md': '# Link Workflow\nConnect tools.',
     'claude-settings.json': '{"permissions":{"allow":["Read"],"deny":["Bash"]}}',
     'mcp-configs/base.json': '{"mcpServers":{"context7":{"command":"npx","args":["context7"]}}}',
 };
@@ -114,13 +115,13 @@ describe('initCommand', () => {
             // Verify ensureDir was called for skill directories
             const ensureDirCalls = fs.ensureDir.mock.calls;
             const skillDirs = ensureDirCalls.filter(c => c[0].includes('.claude/skills/melt-'));
-            expect(skillDirs.length).toBeGreaterThanOrEqual(11);
+            expect(skillDirs.length).toBeGreaterThanOrEqual(12);
         });
         it('creates all 11 Claude skills', async () => {
             await initCommand({ claude: true });
             const writeCalls = fs.writeFile.mock.calls;
             const skillFiles = writeCalls.filter(c => c[0].includes('.claude/skills/melt-') && c[0].endsWith('SKILL.md'));
-            expect(skillFiles.length).toBe(11);
+            expect(skillFiles.length).toBe(12);
             const skillNames = skillFiles.map(c => {
                 const match = c[0].match(/\.claude\/skills\/melt-([^/]+)/);
                 return match ? match[1] : '';
@@ -136,12 +137,13 @@ describe('initCommand', () => {
             expect(skillNames).toContain('security-audit');
             expect(skillNames).toContain('update');
             expect(skillNames).toContain('help');
+            expect(skillNames).toContain('link');
         });
         it('creates Cursor commands without frontmatter', async () => {
             await initCommand({ cursor: true });
             const writeCalls = fs.writeFile.mock.calls;
             const cursorFiles = writeCalls.filter(c => c[0].includes('.cursor/commands/melt-'));
-            expect(cursorFiles.length).toBe(11);
+            expect(cursorFiles.length).toBe(12);
             // Cursor commands should NOT have frontmatter
             const setupCmd = cursorFiles.find(c => c[0].includes('melt-setup.md'));
             expect(setupCmd).toBeDefined();
@@ -152,7 +154,7 @@ describe('initCommand', () => {
             await initCommand({ opencode: true });
             const writeCalls = fs.writeFile.mock.calls;
             const opencodeFiles = writeCalls.filter(c => c[0].includes('.opencode/commands/melt-'));
-            expect(opencodeFiles.length).toBe(11);
+            expect(opencodeFiles.length).toBe(12);
             // OpenCode commands should have shorter frontmatter
             const setupCmd = opencodeFiles.find(c => c[0].includes('melt-setup.md'));
             expect(setupCmd).toBeDefined();

package/dist/index.js

@@ -32,6 +32,7 @@ program
     .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-link             Connect and verify ticket tracker + browser testing')}
 ${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')}
@@ -64,6 +65,7 @@ const project = program
     .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-link     Connect and verify ticket tracker + browser testing')}
 ${chalk.dim('  /melt-update   Update Melt skills to the latest version')}
 `);
 project

package/package.json

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