@1tool/js-boost 1.3.0 → 1.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1tool/js-boost",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Laravel Boost-inspired CLI for JavaScript projects — generates agent files from your .ai/ folder",
   "main": "src/index.js",
   "type": "module",

package/src/generators/agents.js

@@ -1,27 +1,13 @@
 import { buildMcpMarkdownSection } from '../utils/mcp.js';
 
-/**
- * Generate AGENTS.md — the universal standard read by Codex, Cursor,
- * GitHub Copilot, Gemini CLI, and most other agents.
- *
- * This is the single source of truth. All other agent files reference this.
- */
-export function generateAgentsMd(guidelines, skills, mcpServers, config = {}) {
-  const projectName = config.projectName || 'this project';
-  const projectDescription = config.projectDescription || '';
+export function generateAgentsMd(guidelines, skills, mcpServers) {
   const sections = [];
 
-  // Header
-  sections.push(`# AGENTS.md`);
-  sections.push(`> Agent instructions for ${projectName}. Generated by [js-boost](https://github.com/your-org/js-boost) — do not edit manually.`);
-  if (projectDescription) sections.push(`\n${projectDescription}`);
+  sections.push('# Project Guidelines');
   sections.push('');
-
-  // Table of contents hint
   sections.push('---');
   sections.push('');
 
-  // Guidelines — inline all content from .ai/guidelines/
   if (guidelines.length > 0) {
     sections.push('## Guidelines');
     sections.push('');
@@ -29,13 +15,11 @@ export function generateAgentsMd(guidelines, skills, mcpServers, config = {}) {
     sections.push('');
 
     for (const g of guidelines) {
-      // Include the full content of each guideline file
       sections.push(g.content);
       sections.push('');
     }
   }
 
-  // Skills — reference section with name + description
   if (skills.length > 0) {
     sections.push('## Agent Skills');
     sections.push('');
@@ -50,15 +34,9 @@ export function generateAgentsMd(guidelines, skills, mcpServers, config = {}) {
     }
   }
 
-  // MCP section
   if (Object.keys(mcpServers).length > 0) {
     sections.push(buildMcpMarkdownSection(mcpServers));
   }
 
-  // Footer
-  sections.push('---');
-  sections.push('');
-  sections.push('*This file is auto-generated by `js-boost`. Run `npx js-boost generate` to regenerate.*');
-
   return sections.join('\n');
 }

package/src/generators/claude.js

@@ -7,13 +7,10 @@ import { buildMcpMarkdownSection } from '../utils/mcp.js';
  * guidelines content here (Claude benefits from having everything upfront),
  * plus Claude-specific directives for loading skills.
  */
-export function generateClaudeMd(guidelines, skills, mcpServers, config = {}) {
-  const projectName = config.projectName || 'this project';
+export function generateClaudeMd(guidelines, skills, mcpServers) {
   const sections = [];
 
-  sections.push(`# CLAUDE.md — ${projectName}`);
-  sections.push('');
-  sections.push('> Generated by [js-boost](https://github.com/your-org/js-boost). Do not edit manually — edit `.ai/guidelines/` and `.ai/skills/` instead, then run `npx js-boost generate`.');
+  sections.push('# Project Guidelines');
   sections.push('');
   sections.push('---');
   sections.push('');
@@ -33,10 +30,7 @@ export function generateClaudeMd(guidelines, skills, mcpServers, config = {}) {
     sections.push('');
   }
 
-  // Include all guidelines inline
   if (guidelines.length > 0) {
-    sections.push('## Project Guidelines');
-    sections.push('');
     for (const g of guidelines) {
       sections.push(g.content);
       sections.push('');
@@ -45,7 +39,6 @@ export function generateClaudeMd(guidelines, skills, mcpServers, config = {}) {
     sections.push('');
   }
 
-  // MCP section
   if (Object.keys(mcpServers).length > 0) {
     sections.push(buildMcpMarkdownSection(mcpServers));
     sections.push('');
@@ -53,8 +46,5 @@ export function generateClaudeMd(guidelines, skills, mcpServers, config = {}) {
     sections.push('');
   }
 
-  sections.push('---');
-  sections.push('*Auto-generated by `js-boost`. Source: `.ai/`*');
-
   return sections.join('\n');
 }

package/src/generators/cursor.js

@@ -1,11 +1,4 @@
-/**
- * Generate .cursor/rules/js-boost.mdc for Cursor.
- *
- * Cursor reads .cursorrules (legacy) or .cursor/rules/*.mdc (v0.43+).
- * We generate the modern .cursor/rules/ format.
- * Each guideline becomes its own rule file for better organization.
- */
-export function generateCursorRules(guidelines, skills, config = {}) {
+export function generateCursorRules(guidelines, skills) {
   const sections = [];
 
   sections.push('---');
@@ -14,8 +7,9 @@ export function generateCursorRules(guidelines, skills, config = {}) {
   sections.push('alwaysApply: true');
   sections.push('---');
   sections.push('');
+  sections.push('# Project Guidelines');
+  sections.push('');
 
-  // Inline all guidelines
   if (guidelines.length > 0) {
     for (const g of guidelines) {
       sections.push(g.content);
@@ -23,7 +17,6 @@ export function generateCursorRules(guidelines, skills, config = {}) {
     }
   }
 
-  // Skills reference
   if (skills.length > 0) {
     sections.push('## Available Skills');
     sections.push('');
@@ -34,25 +27,17 @@ export function generateCursorRules(guidelines, skills, config = {}) {
     sections.push('');
   }
 
-  sections.push('---');
-  sections.push('*Auto-generated by `js-boost`*');
-
   return sections.join('\n');
 }
 
-/**
- * Also generate legacy .cursorrules for older Cursor versions
- */
-export function generateCursorRulesLegacy(guidelines, skills, config = {}) {
+export function generateCursorRulesLegacy(guidelines, skills) {
   const sections = [];
 
-  sections.push('# Cursor Rules');
-  sections.push('# Generated by js-boost — edit .ai/guidelines/ instead');
+  sections.push('# Project Guidelines');
   sections.push('');
 
   if (guidelines.length > 0) {
     for (const g of guidelines) {
-      // Strip markdown headings for legacy format compatibility
       sections.push(g.content);
       sections.push('');
     }
@@ -60,8 +45,10 @@ export function generateCursorRulesLegacy(guidelines, skills, config = {}) {
 
   if (skills.length > 0) {
     sections.push('## Skills');
+    sections.push('');
     for (const skill of skills) {
-      sections.push(`- ${skill.name}: .ai/skills/${skill.dir}/SKILL.md`);
+      sections.push(`- **${skill.name}**: .ai/skills/${skill.dir}/SKILL.md`);
+      if (skill.description) sections.push(`  ${skill.description}`);
     }
   }
 

package/src/generators/junie.js

@@ -1,20 +1,9 @@
-/**
- * Generate .junie/guidelines.md for JetBrains Junie.
- *
- * Junie reads .junie/guidelines.md and uses it as persistent context
- * for every task. Skills need to be referenced explicitly since Junie
- * doesn't auto-load them from directories.
- */
-export function generateJunieGuidelines(guidelines, skills, config = {}) {
-  const projectName = config.projectName || 'this project';
+export function generateJunieGuidelines(guidelines, skills) {
   const sections = [];
 
-  sections.push(`# Junie Guidelines — ${projectName}`);
-  sections.push('');
-  sections.push('> Generated by [js-boost](https://github.com/your-org/js-boost). Do not edit manually.');
+  sections.push('# Project Guidelines');
   sections.push('');
 
-  // Inline all guidelines
   if (guidelines.length > 0) {
     for (const g of guidelines) {
       sections.push(g.content);
@@ -22,7 +11,6 @@ export function generateJunieGuidelines(guidelines, skills, config = {}) {
     }
   }
 
-  // Skills reference
   if (skills.length > 0) {
     sections.push('## Available Skills');
     sections.push('');
@@ -35,8 +23,5 @@ export function generateJunieGuidelines(guidelines, skills, config = {}) {
     sections.push('');
   }
 
-  sections.push('---');
-  sections.push('*Auto-generated by `js-boost`. Source: `.ai/`*');
-
   return sections.join('\n');
 }

package/src/generators/kiro.js

@@ -1,16 +1,11 @@
-/**
- * Generate .kiro/steering/guidelines.md
- * Kiro uses steering documents in .kiro/steering/ for project context.
- */
-export function generateKiroSteering(guidelines, skills, config) {
-  const projectName = config.projectName || 'This project';
+export function generateKiroSteering(guidelines, skills) {
   const lines = [];
 
   lines.push('---');
   lines.push('inclusion: always');
   lines.push('---');
   lines.push('');
-  lines.push(`# ${projectName} — AI Guidelines`);
+  lines.push('# Project Guidelines');
   lines.push('');
 
   if (guidelines.length > 0) {
@@ -21,15 +16,16 @@ export function generateKiroSteering(guidelines, skills, config) {
   }
 
   if (skills.length > 0) {
-    lines.push('## Skills');
+    lines.push('## Available Skills');
     lines.push('');
-    lines.push('The following skills are available for this project:');
+    lines.push('The following skill files contain detailed patterns. Read the relevant SKILL.md before working on tasks in that domain:');
     lines.push('');
     for (const skill of skills) {
-      lines.push(`- **${skill.name}**: ${skill.description || skill.dir}`);
+      lines.push(`- **${skill.name}**: \`.ai/skills/${skill.dir}/SKILL.md\``);
+      if (skill.description) lines.push(`  ${skill.description}`);
     }
     lines.push('');
   }
 
   return lines.join('\n');
-}
+}

package/src/utils/mcp.js

@@ -34,18 +34,17 @@ export function generateMcpJson(servers) {
 
   for (const [key, server] of Object.entries(servers)) {
     if (server.type === 'http') {
-      const args = ['-y', 'mcp-remote', server.url];
-      if (server.headers) {
-        for (const [k, v] of Object.entries(server.headers)) {
-          args.push('--header', `${k}: ${v}`);
-        }
-      }
-      mcpServers[key] = { command: 'npx', args };
+      mcpServers[key] = {
+        type: 'http',
+        url: server.url,
+        ...(server.headers ? { headers: server.headers } : {}),
+      };
     } else if (server.command) {
       mcpServers[key] = {
+        type: 'stdio',
         command: server.command,
         args: server.args || [],
-        ...(server.env ? { env: server.env } : {}),
+        env: server.env || {},
       };
     }
   }