agentic-team-templates 0.14.0 → 0.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-team-templates",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "AI coding assistant templates for Cursor IDE. Pre-configured rules and guidelines that help AI assistants write better code. - use at your own risk",
   "keywords": [
     "cursor",

package/src/index.js

@@ -118,6 +118,36 @@ const TEMPLATES = {
   }
 };
 
+// Shorthand aliases for language expert templates
+const TEMPLATE_ALIASES = {
+  'js': 'javascript-expert',
+  'javascript': 'javascript-expert',
+  'ts': 'javascript-expert',
+  'typescript': 'javascript-expert',
+  'go': 'golang-expert',
+  'golang': 'golang-expert',
+  'py': 'python-expert',
+  'python': 'python-expert',
+  'rs': 'rust-expert',
+  'rust': 'rust-expert',
+  'swift': 'swift-expert',
+  'kotlin': 'kotlin-expert',
+  'kt': 'kotlin-expert',
+  'java': 'java-expert',
+  'cpp': 'cpp-expert',
+  'csharp': 'csharp-expert',
+  'cs': 'csharp-expert',
+};
+
+/**
+ * Resolve a template alias to its canonical name
+ * @param {string} name - Template name or alias
+ * @returns {string} Canonical template name
+ */
+function resolveTemplateAlias(name) {
+  return TEMPLATE_ALIASES[name] || name;
+}
+
 const SHARED_RULES = [
   'code-quality.md',
   'communication.md', 
@@ -215,7 +245,19 @@ ${colors.yellow('IDE Targets:')}
   claude         CLAUDE.md file (Claude Code, Cursor with Claude)
   codex          .github/copilot-instructions.md (GitHub Copilot)
 
+${colors.yellow('Shorthand Aliases:')}
+  js, ts, javascript, typescript → javascript-expert
+  go, golang                     → golang-expert
+  py, python                     → python-expert
+  rs, rust                       → rust-expert
+  swift                          → swift-expert
+  kotlin, kt                     → kotlin-expert
+  java                           → java-expert
+  cpp                            → cpp-expert
+  csharp, cs                     → csharp-expert
+
 ${colors.yellow('Examples:')}
+  npx cursor-templates js
   npx cursor-templates web-frontend
   npx cursor-templates web-frontend --ide=cursor
   npx cursor-templates web-frontend --ide=claude --ide=codex
@@ -237,13 +279,24 @@ ${colors.dim('CLAUDE.md: missing sections are intelligently merged (not overwrit
 }
 
 function printTemplates() {
+  // Build reverse map: canonical name -> list of aliases
+  const aliasesByTemplate = {};
+  for (const [alias, canonical] of Object.entries(TEMPLATE_ALIASES)) {
+    if (!aliasesByTemplate[canonical]) {
+      aliasesByTemplate[canonical] = [];
+    }
+    aliasesByTemplate[canonical].push(alias);
+  }
+
   console.log(colors.yellow('Available Templates:\n'));
-  
+
   for (const [name, info] of Object.entries(TEMPLATES)) {
-    console.log(`  ${colors.green(name)}`);
+    const aliases = aliasesByTemplate[name];
+    const aliasSuffix = aliases ? ` ${colors.dim(`(aliases: ${aliases.join(', ')})`)}` : '';
+    console.log(`  ${colors.green(name)}${aliasSuffix}`);
     console.log(`    ${info.description}\n`);
   }
-  
+
   console.log(colors.blue('Shared rules (always included):'));
   for (const rule of SHARED_RULES) {
     console.log(`  - ${rule.replace('.md', '')}`);
@@ -1378,10 +1431,13 @@ export async function run(args) {
   }
 
   printBanner();
-  
+
   // Check for updates (non-blocking, fails silently)
   await checkForUpdates();
 
+  // Resolve template aliases to canonical names
+  const resolvedTemplates = templates.map(resolveTemplateAlias);
+
   // Use default IDEs if none specified
   const targetIdes = ides.length > 0 ? ides : DEFAULT_IDES;
 
@@ -1391,7 +1447,7 @@ export async function run(args) {
       console.error(colors.red('Error: Cannot use --remove and --reset together\n'));
       process.exit(1);
     }
-    if (templates.length > 0) {
+    if (resolvedTemplates.length > 0) {
       console.error(colors.red('Error: --reset does not accept template arguments\n'));
       console.error(colors.dim('Use --remove <templates...> to remove specific templates.\n'));
       process.exit(1);
@@ -1410,14 +1466,14 @@ export async function run(args) {
 
   // Handle remove mode
   if (removeMode) {
-    if (templates.length === 0) {
+    if (resolvedTemplates.length === 0) {
       console.error(colors.red('Error: No templates specified for removal\n'));
       console.error(colors.dim('Usage: npx cursor-templates --remove <templates...>\n'));
       printTemplates();
       process.exit(1);
     }
 
-    for (const template of templates) {
+    for (const template of resolvedTemplates) {
       if (!TEMPLATES[template]) {
         console.error(colors.red(`Error: Unknown template '${template}'\n`));
         printTemplates();
@@ -1432,18 +1488,18 @@ export async function run(args) {
       console.log(colors.yellow('FORCE MODE - Modified files will be removed\n'));
     }
 
-    await remove(process.cwd(), templates, dryRun, force, skipConfirm, targetIdes);
+    await remove(process.cwd(), resolvedTemplates, dryRun, force, skipConfirm, targetIdes);
     return;
   }
 
   // Install mode (default)
-  if (templates.length === 0) {
+  if (resolvedTemplates.length === 0) {
     console.error(colors.red('Error: No templates specified\n'));
     printHelp();
     process.exit(1);
   }
 
-  for (const template of templates) {
+  for (const template of resolvedTemplates) {
     if (!TEMPLATES[template]) {
       console.error(colors.red(`Error: Unknown template '${template}'\n`));
       printTemplates();
@@ -1460,7 +1516,7 @@ export async function run(args) {
   }
 
   // Install to current directory
-  install(process.cwd(), templates, dryRun, force, targetIdes);
+  install(process.cwd(), resolvedTemplates, dryRun, force, targetIdes);
 }
 
 // Export internals for testing
@@ -1470,11 +1526,13 @@ export const _internals = {
   REPO_URL,
   CHANGELOG_URL,
   TEMPLATES,
+  TEMPLATE_ALIASES,
   SHARED_RULES,
   SUPPORTED_IDES,
   DEFAULT_IDES,
   compareVersions,
   checkForUpdates,
+  resolveTemplateAlias,
   filesMatch,
   parseMarkdownSections,
   generateSectionSignature,

package/src/index.test.js

@@ -8,10 +8,12 @@ const {
   PACKAGE_NAME,
   CURRENT_VERSION,
   TEMPLATES,
+  TEMPLATE_ALIASES,
   SHARED_RULES,
   SUPPORTED_IDES,
   DEFAULT_IDES,
   compareVersions,
+  resolveTemplateAlias,
   filesMatch,
   parseMarkdownSections,
   generateSectionSignature,
@@ -150,6 +152,50 @@ describe('Constants', () => {
       expect(DEFAULT_IDES).toEqual(SUPPORTED_IDES);
     });
   });
+
+  describe('TEMPLATE_ALIASES', () => {
+    it('all alias values should be valid TEMPLATES keys', () => {
+      for (const [alias, canonical] of Object.entries(TEMPLATE_ALIASES)) {
+        expect(TEMPLATES).toHaveProperty(canonical,
+          expect.anything(),
+        );
+      }
+    });
+
+    it('should include expected shorthand aliases', () => {
+      expect(TEMPLATE_ALIASES['js']).toBe('javascript-expert');
+      expect(TEMPLATE_ALIASES['ts']).toBe('javascript-expert');
+      expect(TEMPLATE_ALIASES['go']).toBe('golang-expert');
+      expect(TEMPLATE_ALIASES['py']).toBe('python-expert');
+      expect(TEMPLATE_ALIASES['rs']).toBe('rust-expert');
+      expect(TEMPLATE_ALIASES['kt']).toBe('kotlin-expert');
+    });
+  });
+
+  describe('resolveTemplateAlias', () => {
+    it('should resolve known aliases to canonical names', () => {
+      expect(resolveTemplateAlias('js')).toBe('javascript-expert');
+      expect(resolveTemplateAlias('typescript')).toBe('javascript-expert');
+      expect(resolveTemplateAlias('go')).toBe('golang-expert');
+      expect(resolveTemplateAlias('golang')).toBe('golang-expert');
+      expect(resolveTemplateAlias('py')).toBe('python-expert');
+      expect(resolveTemplateAlias('rs')).toBe('rust-expert');
+      expect(resolveTemplateAlias('kotlin')).toBe('kotlin-expert');
+      expect(resolveTemplateAlias('kt')).toBe('kotlin-expert');
+    });
+
+    it('should pass through unknown names unchanged', () => {
+      expect(resolveTemplateAlias('web-frontend')).toBe('web-frontend');
+      expect(resolveTemplateAlias('blockchain')).toBe('blockchain');
+      expect(resolveTemplateAlias('nonexistent')).toBe('nonexistent');
+    });
+
+    it('should pass through canonical template names unchanged', () => {
+      expect(resolveTemplateAlias('javascript-expert')).toBe('javascript-expert');
+      expect(resolveTemplateAlias('golang-expert')).toBe('golang-expert');
+      expect(resolveTemplateAlias('python-expert')).toBe('python-expert');
+    });
+  });
 });
 
 // ============================================================================
@@ -1019,7 +1065,50 @@ describe('CLI Argument Parsing', () => {
   it('should accept -y shorthand for yes', async () => {
     await run(['web-frontend']);
     await run(['--reset', '-y']);
-    
+
+    expect(exitSpy).not.toHaveBeenCalled();
+  });
+
+  it('should resolve shorthand alias "js" to javascript-expert', async () => {
+    await run(['js', '--dry-run']);
+
+    expect(exitSpy).not.toHaveBeenCalled();
+  });
+
+  it('should resolve shorthand alias "go" to golang-expert', async () => {
+    await run(['go', '--dry-run']);
+
+    expect(exitSpy).not.toHaveBeenCalled();
+  });
+
+  it('should resolve shorthand alias "py" to python-expert', async () => {
+    await run(['py', '--dry-run']);
+
+    expect(exitSpy).not.toHaveBeenCalled();
+  });
+
+  it('should resolve shorthand alias "rs" to rust-expert', async () => {
+    await run(['rs', '--dry-run']);
+
+    expect(exitSpy).not.toHaveBeenCalled();
+  });
+
+  it('should resolve shorthand alias "kt" to kotlin-expert', async () => {
+    await run(['kt', '--dry-run']);
+
+    expect(exitSpy).not.toHaveBeenCalled();
+  });
+
+  it('should resolve aliases in --remove mode', async () => {
+    await run(['go']);
+    await run(['--remove', 'go', '--yes']);
+
+    expect(exitSpy).not.toHaveBeenCalled();
+  });
+
+  it('should still accept canonical template names', async () => {
+    await run(['javascript-expert', '--dry-run']);
+
     expect(exitSpy).not.toHaveBeenCalled();
   });
 });