@meltstudio/meltctl 4.7.4 → 4.9.0

package/README.md

@@ -25,6 +25,9 @@ meltctl project init --claude --cursor # Both
 # Re-initialize
 meltctl project init --force
 
+# Fetch latest templates (used by /melt-update)
+meltctl project templates
+
 # Other commands
 meltctl logout
 meltctl version --check
@@ -34,8 +37,8 @@ meltctl version --check
 
 - `AGENTS.md` — AI agent instructions and project standards
 - `.claude/settings.json` — Claude Code permissions
-- `.claude/skills/melt-{setup,plan,review,pr,debug,audit}/SKILL.md` — Claude Code workflow skills
-- `.cursor/commands/melt-{setup,plan,review,pr,debug,audit}.md` — Cursor workflow commands
+- `.claude/skills/melt-{setup,plan,...,update}/SKILL.md` — Claude Code workflow skills
+- `.cursor/commands/melt-{setup,plan,...,update}.md` — Cursor workflow commands
 - `.mcp.json` — MCP server configuration (Chrome DevTools)
 
 ## Requirements

package/dist/commands/init.js

@@ -2,7 +2,8 @@ import chalk from 'chalk';
 import { checkbox, confirm } from '@inquirer/prompts';
 import fs from 'fs-extra';
 import path from 'path';
-import { authenticatedFetch, isAuthenticated } from '../utils/auth.js';
+import { isAuthenticated } from '../utils/auth.js';
+import { fetchTemplates } from '../utils/templates.js';
 const SKILL_FRONTMATTER = {
     setup: `---
 user-invocable: true
@@ -39,17 +40,15 @@ user-invocable: true
 description: Run a project compliance audit against team standards
 ---
 
+`,
+    update: `---
+user-invocable: true
+description: Update Melt skills and standards to the latest version
+---
+
 `,
 };
 const GITIGNORE_ENTRIES = ['.env.local', '.claude/settings.local.json'];
-async function fetchTemplates() {
-    const response = await authenticatedFetch('/templates');
-    if (!response.ok) {
-        throw new Error(`Failed to fetch templates: ${response.statusText}`);
-    }
-    const data = (await response.json());
-    return data.files;
-}
 function detectExistingTools(cwd) {
     return {
         claude: fs.pathExistsSync(path.join(cwd, '.claude/settings.json')),
@@ -147,7 +146,7 @@ export async function initCommand(options) {
     console.log(chalk.bold('Initializing Melt development tools...'));
     console.log();
     const createdFiles = [];
-    const workflows = ['setup', 'plan', 'review', 'pr', 'debug', 'audit'];
+    const workflows = ['setup', 'plan', 'review', 'pr', 'debug', 'audit', 'update'];
     // Shared files (skip on re-init)
     if (!isReInit) {
         const agentsMd = templates['agents-md.md'];
@@ -179,7 +178,7 @@ export async function initCommand(options) {
                 await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillContent, 'utf-8');
             }
         }
-        createdFiles.push('.claude/skills/melt-{setup,plan,review,pr,debug,audit}/SKILL.md');
+        createdFiles.push('.claude/skills/melt-{setup,plan,review,pr,debug,audit,update}/SKILL.md');
     }
     // Cursor files
     if (tools.cursor) {
@@ -190,7 +189,7 @@ export async function initCommand(options) {
                 await fs.writeFile(path.join(cwd, `.cursor/commands/melt-${name}.md`), workflowContent, 'utf-8');
             }
         }
-        createdFiles.push('.cursor/commands/melt-{setup,plan,review,pr,debug,audit}.md');
+        createdFiles.push('.cursor/commands/melt-{setup,plan,review,pr,debug,audit,update}.md');
     }
     // Print summary
     console.log(chalk.green('Created files:'));
@@ -203,11 +202,11 @@ export async function initCommand(options) {
         console.log();
     }
     if (tools.claude) {
-        const skills = '/melt-setup, /melt-plan, /melt-review, /melt-pr, /melt-debug, /melt-audit';
+        const skills = '/melt-setup, /melt-plan, /melt-review, /melt-pr, /melt-debug, /melt-audit, /melt-update';
         console.log(chalk.dim(`Available skills: ${skills}`));
     }
     if (tools.cursor) {
-        console.log(chalk.dim('Available commands: melt-setup, melt-plan, melt-review, melt-pr, melt-debug, melt-audit'));
+        console.log(chalk.dim('Available commands: melt-setup, melt-plan, melt-review, melt-pr, melt-debug, melt-audit, melt-update'));
     }
     if (tools.claude || tools.cursor) {
         console.log();

package/dist/commands/templates.d.ts

@@ -0,0 +1 @@
+export declare function templatesCommand(): Promise<void>;

package/dist/commands/templates.js

@@ -0,0 +1,37 @@
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { isAuthenticated } from '../utils/auth.js';
+import { fetchTemplates } from '../utils/templates.js';
+export async function templatesCommand() {
+    if (!(await isAuthenticated())) {
+        console.error(chalk.red('Not authenticated. Run `npx @meltstudio/meltctl@latest login` first.'));
+        process.exit(1);
+    }
+    let templates;
+    try {
+        templates = await fetchTemplates();
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('expired')) {
+            console.error(chalk.red('Session expired. Run `npx @meltstudio/meltctl@latest login` to re-authenticate.'));
+        }
+        else if (error instanceof Error && error.message.includes('fetch')) {
+            console.error(chalk.red('Could not reach Melt API. Check your connection.'));
+        }
+        else {
+            console.error(chalk.red(`Failed to fetch templates: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        }
+        process.exit(1);
+    }
+    const tmpDir = path.join(os.tmpdir(), `melt-templates-${Date.now()}`);
+    await fs.ensureDir(tmpDir);
+    for (const [filePath, content] of Object.entries(templates)) {
+        const fullPath = path.join(tmpDir, filePath);
+        await fs.ensureDir(path.dirname(fullPath));
+        await fs.writeFile(fullPath, content, 'utf-8');
+    }
+    // Print only the temp dir path to stdout (agent parses this)
+    console.log(tmpDir);
+}

package/dist/index.js

@@ -5,6 +5,7 @@ import { readFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { initCommand } from './commands/init.js';
+import { templatesCommand } from './commands/templates.js';
 import { loginCommand } from './commands/login.js';
 import { logoutCommand } from './commands/logout.js';
 import { printBanner } from './utils/banner.js';
@@ -48,6 +49,12 @@ project
     .action(options => {
     return initCommand({ force: options.force, claude: options.claude, cursor: options.cursor });
 });
+project
+    .command('templates')
+    .description('fetch latest templates to a temp directory (for /melt-update)')
+    .action(async () => {
+    await templatesCommand();
+});
 program
     .command('version')
     .description('show current version')

package/dist/utils/templates.d.ts

@@ -0,0 +1,4 @@
+export interface TemplateFiles {
+    [key: string]: string;
+}
+export declare function fetchTemplates(): Promise<TemplateFiles>;

package/dist/utils/templates.js

@@ -0,0 +1,9 @@
+import { authenticatedFetch } from './auth.js';
+export async function fetchTemplates() {
+    const response = await authenticatedFetch('/templates');
+    if (!response.ok) {
+        throw new Error(`Failed to fetch templates: ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data.files;
+}

package/package.json

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