agentic-team-templates 0.6.1 → 0.8.0

package/README.md

@@ -1,6 +1,6 @@
 # agentic-team-templates
 
-[![npm version](https://img.shields.io/npm/v/cursor-templates.svg)](https://www.npmjs.com/package/cursor-templates)
+[![npm version](https://img.shields.io/npm/v/agentic-team-templates.svg)](https://www.npmjs.com/package/agentic-team-templates)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 **Compatible with:**
@@ -23,14 +23,14 @@ AI coding assistant templates for Cursor IDE, Claude Code, and GitHub Copilot. P
 No installation required. Run directly with `npx`:
 
 ```bash
-npx cursor-templates <template-name>
+npx agentic-team-templates <template-name>
 ```
 
 Or install globally:
 
 ```bash
-npm install -g cursor-templates
-cursor-templates <template-name>
+npm install -g agentic-team-templates
+agentic-team-templates <template-name>
 ```
 
 ## How to Use
@@ -40,7 +40,7 @@ cursor-templates <template-name>
 Navigate to your project directory and run:
 
 ```bash
-npx cursor-templates web-frontend
+npx agentic-team-templates web-frontend
 ```
 
 This installs the template rules in your project directory.
@@ -50,13 +50,13 @@ This installs the template rules in your project directory.
 Combine templates for projects that span multiple domains:
 
 ```bash
-npx cursor-templates web-frontend web-backend
+npx agentic-team-templates web-frontend web-backend
 ```
 
 ### List All Available Templates
 
 ```bash
-npx cursor-templates --list
+npx agentic-team-templates --list
 ```
 
 ### Preview Before Installing (Dry Run)
@@ -64,7 +64,7 @@ npx cursor-templates --list
 See what files will be created without making changes:
 
 ```bash
-npx cursor-templates web-frontend --dry-run
+npx agentic-team-templates web-frontend --dry-run
 ```
 
 ### Update to Latest Rules
@@ -72,7 +72,7 @@ npx cursor-templates web-frontend --dry-run
 Re-run with `@latest` to get updated templates:
 
 ```bash
-npx cursor-templates@latest web-frontend
+npx agentic-team-templates@latest web-frontend
 ```
 
 ### Install for Specific IDE
@@ -81,16 +81,16 @@ By default, templates install for all supported IDEs (Cursor, Claude, Copilot).
 
 ```bash
 # Install only for Cursor IDE
-npx cursor-templates web-frontend --ide=cursor
+npx agentic-team-templates web-frontend --ide=cursor
 
 # Install only for Claude Code
-npx cursor-templates web-frontend --ide=claude
+npx agentic-team-templates web-frontend --ide=claude
 
 # Install only for GitHub Copilot
-npx cursor-templates web-frontend --ide=codex
+npx agentic-team-templates web-frontend --ide=codex
 
 # Install for multiple IDEs
-npx cursor-templates web-frontend --ide=cursor --ide=codex
+npx agentic-team-templates web-frontend --ide=cursor --ide=codex
 ```
 
 ### Remove Specific Templates
@@ -99,16 +99,16 @@ Remove templates you no longer need while keeping shared rules and other templat
 
 ```bash
 # Remove a single template
-npx cursor-templates --remove web-frontend
+npx agentic-team-templates --remove web-frontend
 
 # Remove multiple templates
-npx cursor-templates --remove web-frontend web-backend
+npx agentic-team-templates --remove web-frontend web-backend
 
 # Remove from specific IDE only
-npx cursor-templates --remove web-frontend --ide=cursor
+npx agentic-team-templates --remove web-frontend --ide=cursor
 
 # Skip confirmation prompt
-npx cursor-templates --remove web-frontend --yes
+npx agentic-team-templates --remove web-frontend --yes
 ```
 
 ### Reset (Remove Everything)
@@ -117,16 +117,16 @@ Remove all installed content (shared rules, templates, generated files):
 
 ```bash
 # Reset all installed content
-npx cursor-templates --reset
+npx agentic-team-templates --reset
 
 # Reset for specific IDE only
-npx cursor-templates --reset --ide=cursor
+npx agentic-team-templates --reset --ide=cursor
 
 # Skip confirmation prompt
-npx cursor-templates --reset --yes
+npx agentic-team-templates --reset --yes
 
 # Force remove modified files
-npx cursor-templates --reset --force
+npx agentic-team-templates --reset --force
 ```
 
 ### CLI Options
@@ -186,27 +186,26 @@ Each template adds domain-specific rules. For example, `web-frontend` includes:
 
 ## File Structure
 
-After running `npx cursor-templates web-frontend`:
+After running `npx agentic-team-templates web-frontend`:
 
 ```
 your-project/
 ├── CLAUDE.md                              # Development guide (Claude Code, Cursor)
 ├── .cursorrules/                          # Rule files (Cursor IDE)
-│   └── ...
+│   ├── core-principles.md                 # Shared
+│   ├── code-quality.md                    # Shared
+│   ├── security-fundamentals.md           # Shared
+│   ├── git-workflow.md                    # Shared
+│   ├── communication.md                   # Shared
+│   ├── web-frontend-overview.md           # Template-specific
+│   ├── web-frontend-accessibility.md      # Template-specific
+│   ├── web-frontend-component-patterns.md # Template-specific
+│   ├── web-frontend-performance.md        # Template-specific
+│   ├── web-frontend-state-management.md   # Template-specific
+│   ├── web-frontend-styling.md            # Template-specific
+│   └── web-frontend-testing.md            # Template-specific
 └── .github/
     └── copilot-instructions.md            # Instructions (GitHub Copilot)
-    ├── core-principles.md                 # Shared
-    ├── code-quality.md                    # Shared
-    ├── security-fundamentals.md           # Shared
-    ├── git-workflow.md                    # Shared
-    ├── communication.md                   # Shared
-    ├── web-frontend-overview.md           # Template-specific
-    ├── web-frontend-accessibility.md      # Template-specific
-    ├── web-frontend-component-patterns.md # Template-specific
-    ├── web-frontend-performance.md        # Template-specific
-    ├── web-frontend-state-management.md   # Template-specific
-    ├── web-frontend-styling.md            # Template-specific
-    └── web-frontend-testing.md            # Template-specific
 ```
 
 ## Customization
@@ -238,7 +237,7 @@ Templates merge with your existing `.cursorrules/` directory. Existing files are
 ```bash
 mkdir my-react-app && cd my-react-app
 npm create vite@latest . -- --template react-ts
-npx cursor-templates web-frontend
+npx agentic-team-templates web-frontend
 ```
 
 ### Full-Stack Next.js Project
@@ -246,21 +245,21 @@ npx cursor-templates web-frontend
 ```bash
 npx create-next-app@latest my-app
 cd my-app
-npx cursor-templates fullstack
+npx agentic-team-templates fullstack
 ```
 
 ### Microservices Backend
 
 ```bash
 cd my-api-service
-npx cursor-templates web-backend devops-sre
+npx agentic-team-templates web-backend devops-sre
 ```
 
 ### ML/AI Project
 
 ```bash
 cd my-ml-project
-npx cursor-templates ml-ai data-engineering
+npx agentic-team-templates ml-ai data-engineering
 ```
 
 ## Requirements
@@ -271,6 +270,53 @@ npx cursor-templates ml-ai data-engineering
   - Claude Code (reads `CLAUDE.md` automatically)
   - GitHub Copilot (reads `.github/copilot-instructions.md`)
 
+## Troubleshooting
+
+### "Unknown option" or Missing Features
+
+If you're getting errors for options that should exist (like `--reset`), you may have a cached old version:
+
+```bash
+# Force latest version (recommended)
+npx agentic-team-templates@latest <command>
+
+# Clear npx cache
+npx clear-npx-cache
+
+# Or manually clear npm cache
+npm cache clean --force
+```
+
+### Verify Your Version
+
+Check which version you're running:
+
+```bash
+npx agentic-team-templates --version
+```
+
+Output:
+```
+agentic-team-templates v0.7.0
+Changelog: https://github.com/djm204/agentic-team-templates/releases/tag/agentic-team-templates-v0.7.0
+```
+
+Or use `--help` which also checks for updates:
+
+```bash
+npx agentic-team-templates@latest --help
+```
+
+The CLI will notify you if a newer version is available.
+
+### Update Global Installation
+
+If installed globally:
+
+```bash
+npm update -g agentic-team-templates
+```
+
 ## How to Contribute
 
 We welcome contributions! Here's how to add new templates or improve existing ones.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-team-templates",
-  "version": "0.6.1",
+  "version": "0.8.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

@@ -1,11 +1,23 @@
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+
+const execAsync = promisify(exec);
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
 
+// Read package.json for version info
+const packageJsonPath = path.join(__dirname, '..', 'package.json');
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+const PACKAGE_NAME = packageJson.name;
+const CURRENT_VERSION = packageJson.version;
+const REPO_URL = 'https://github.com/djm204/agentic-team-templates';
+const CHANGELOG_URL = `${REPO_URL}/releases/tag/${PACKAGE_NAME}-v${CURRENT_VERSION}`;
+
 // Available templates
 const TEMPLATES = {
   'blockchain': {
@@ -61,8 +73,50 @@ const colors = {
   yellow: (s) => `\x1b[33m${s}\x1b[0m`,
   blue: (s) => `\x1b[34m${s}\x1b[0m`,
   dim: (s) => `\x1b[2m${s}\x1b[0m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
 };
 
+/**
+ * Compare two semver version strings
+ * @returns {number} -1 if a < b, 0 if a === b, 1 if a > b
+ */
+function compareVersions(a, b) {
+  const partsA = a.split('.').map(Number);
+  const partsB = b.split('.').map(Number);
+  
+  for (let i = 0; i < 3; i++) {
+    const numA = partsA[i] || 0;
+    const numB = partsB[i] || 0;
+    if (numA < numB) return -1;
+    if (numA > numB) return 1;
+  }
+  return 0;
+}
+
+/**
+ * Check npm for the latest version and notify if update available
+ * Fails silently on network errors
+ */
+async function checkForUpdates() {
+  try {
+    const { stdout } = await execAsync(`npm view ${PACKAGE_NAME} version`, {
+      timeout: 5000, // 5 second timeout
+    });
+    const latestVersion = stdout.trim();
+    
+    if (compareVersions(CURRENT_VERSION, latestVersion) < 0) {
+      console.log(colors.cyan(`
+┌────────────────────────────────────────────────────────────┐
+│  Update available: ${CURRENT_VERSION} → ${latestVersion}                              │
+│  Run: npx ${PACKAGE_NAME}@latest                │
+└────────────────────────────────────────────────────────────┘
+`));
+    }
+  } catch {
+    // Silently ignore network errors or timeouts
+  }
+}
+
 function printBanner() {
   console.log(colors.blue(`
 ╔═══════════════════════════════════════════════════════════╗
@@ -83,6 +137,7 @@ ${colors.yellow('Options:')}
                  Default: all (cursor, claude, codex)
   --list, -l     List available templates
   --help, -h     Show this help message
+  --version, -v  Show version number
   --dry-run      Show what would be changed
   --force, -f    Overwrite/remove even if files were modified
   --yes, -y      Skip confirmation prompt (for --remove and --reset)
@@ -1225,6 +1280,10 @@ export async function run(args) {
       printBanner();
       printHelp();
       process.exit(0);
+    } else if (arg === '--version' || arg === '-v') {
+      console.log(`${PACKAGE_NAME} v${CURRENT_VERSION}`);
+      console.log(`${colors.dim('Changelog:')} ${CHANGELOG_URL}`);
+      process.exit(0);
     } else if (arg === '--dry-run') {
       dryRun = true;
     } else if (arg === '--force' || arg === '-f') {
@@ -1255,6 +1314,9 @@ export async function run(args) {
   }
 
   printBanner();
+  
+  // Check for updates (non-blocking, fails silently)
+  await checkForUpdates();
 
   // Use default IDEs if none specified
   const targetIdes = ides.length > 0 ? ides : DEFAULT_IDES;
@@ -1339,10 +1401,16 @@ export async function run(args) {
 
 // Export internals for testing
 export const _internals = {
+  PACKAGE_NAME,
+  CURRENT_VERSION,
+  REPO_URL,
+  CHANGELOG_URL,
   TEMPLATES,
   SHARED_RULES,
   SUPPORTED_IDES,
   DEFAULT_IDES,
+  compareVersions,
+  checkForUpdates,
   filesMatch,
   parseMarkdownSections,
   generateSectionSignature,

package/src/index.test.js

@@ -5,10 +5,13 @@ import os from 'os';
 import { run, _internals } from './index.js';
 
 const {
+  PACKAGE_NAME,
+  CURRENT_VERSION,
   TEMPLATES,
   SHARED_RULES,
   SUPPORTED_IDES,
   DEFAULT_IDES,
+  compareVersions,
   filesMatch,
   parseMarkdownSections,
   generateSectionSignature,
@@ -28,6 +31,44 @@ const {
 // Constants & Configuration Tests
 // ============================================================================
 
+describe('Package Info', () => {
+  it('should have a valid package name', () => {
+    expect(PACKAGE_NAME).toBe('agentic-team-templates');
+  });
+
+  it('should have a valid semver version', () => {
+    expect(CURRENT_VERSION).toMatch(/^\d+\.\d+\.\d+/);
+  });
+});
+
+describe('Version Comparison', () => {
+  describe('compareVersions', () => {
+    it('should return 0 for equal versions', () => {
+      expect(compareVersions('1.0.0', '1.0.0')).toBe(0);
+      expect(compareVersions('2.5.3', '2.5.3')).toBe(0);
+    });
+
+    it('should return -1 when first version is lower', () => {
+      expect(compareVersions('1.0.0', '1.0.1')).toBe(-1);
+      expect(compareVersions('1.0.0', '1.1.0')).toBe(-1);
+      expect(compareVersions('1.0.0', '2.0.0')).toBe(-1);
+      expect(compareVersions('0.6.1', '0.7.0')).toBe(-1);
+    });
+
+    it('should return 1 when first version is higher', () => {
+      expect(compareVersions('1.0.1', '1.0.0')).toBe(1);
+      expect(compareVersions('1.1.0', '1.0.0')).toBe(1);
+      expect(compareVersions('2.0.0', '1.0.0')).toBe(1);
+      expect(compareVersions('0.7.0', '0.6.1')).toBe(1);
+    });
+
+    it('should handle missing patch versions', () => {
+      expect(compareVersions('1.0', '1.0.0')).toBe(0);
+      expect(compareVersions('1.0.0', '1.0')).toBe(0);
+    });
+  });
+});
+
 describe('Constants', () => {
   describe('TEMPLATES', () => {
     it('should have all expected templates', () => {
@@ -842,6 +883,27 @@ describe('CLI Argument Parsing', () => {
     expect(exitSpy).toHaveBeenCalledWith(0);
   });
 
+  it('should show version with --version', async () => {
+    await expect(run(['--version'])).rejects.toThrow('process.exit');
+    
+    expect(exitSpy).toHaveBeenCalledWith(0);
+    expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('agentic-team-templates'));
+  });
+
+  it('should show version with -v', async () => {
+    await expect(run(['-v'])).rejects.toThrow('process.exit');
+    
+    expect(exitSpy).toHaveBeenCalledWith(0);
+    expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('agentic-team-templates'));
+  });
+
+  it('should show changelog link with --version', async () => {
+    await expect(run(['--version'])).rejects.toThrow('process.exit');
+    
+    expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('github.com'));
+    expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('releases/tag'));
+  });
+
   it('should error on unknown option', async () => {
     await expect(run(['--unknown-option'])).rejects.toThrow('process.exit');