@majordigital/create-acorn 1.7.0 → 1.7.1

package/README.md

@@ -84,11 +84,39 @@ Every Acorn project ships with 10 specialised audit slash commands for Claude Co
 
 ### Adding audit commands to an existing project
 
+The commands are included automatically in every new project. For existing projects:
+
 ```bash
+# Full new project — audit commands included automatically
+npx @majordigital/create-acorn@latest
+
+# Add audit commands to an existing project (also refreshes outdated ones)
 npx @majordigital/create-acorn@latest --add-audit
+
+# Check if installed audit commands are up to date (read-only)
+npx @majordigital/create-acorn@latest --check-audit
+```
+
+The `--add-audit` flag copies all 10 audit commands into the project's `.claude/commands/`. Re-running it refreshes any commands that changed in a newer package version — files that match the latest version are left untouched.
+
+### Checking if audit commands are up to date
+
+Coming back to a project months later? Check whether the installed audit commands still match the latest package before running an audit:
+
+```bash
+npx @majordigital/create-acorn@latest --check-audit
 ```
 
-The `--add-audit` flag copies all 10 audit commands into the project's `.claude/commands/`. It skips if they are already installed.
+This is read-only — it reports each command as missing, outdated, or up to date, and tells you to run `--add-audit` if anything needs updating:
+
+```
+  missing   /audit-performance-metrics
+  outdated  /audit-seo-semantic
+Audit commands: 1 missing, 1 outdated, 8 up to date.
+
+Run the following to update them:
+  npx @majordigital/create-acorn@latest --add-audit
+```
 
 ## Acorn Component Architecture
 

package/bin/create-acorn.mjs

@@ -147,31 +147,72 @@ async function setupPreDeploy() {
   console.log('');
 }
 
-function setupAuditCommands() {
+function compareAuditCommands() {
   const __dirname = dirname(fileURLToPath(import.meta.url));
   const commandsSrc = join(__dirname, '..', 'template', '.claude', 'commands');
   const commandsDest = join(process.cwd(), '.claude', 'commands');
 
   const auditFiles = readdirSync(commandsSrc).filter((f) => f.startsWith('audit-') && f.endsWith('.md'));
-  if (auditFiles.length === 0) {
-    console.log('Warning: No audit commands found in the package — skipping.');
+
+  const missing = [];
+  const outdated = [];
+  const current = [];
+  for (const file of auditFiles) {
+    const srcContent = readFileSync(join(commandsSrc, file), 'utf8');
+    const destPath = join(commandsDest, file);
+    if (!existsSync(destPath)) {
+      missing.push({ file, srcContent });
+    } else if (readFileSync(destPath, 'utf8') !== srcContent) {
+      outdated.push({ file, srcContent });
+    } else {
+      current.push({ file, srcContent });
+    }
+  }
+  return { commandsDest, missing, outdated, current, total: auditFiles.length };
+}
+
+function checkAuditCommands() {
+  const { missing, outdated, current, total } = compareAuditCommands();
+  if (total === 0) {
+    console.log('Warning: No audit commands found in the package.');
     return;
   }
 
-  const alreadyInstalled = auditFiles.every((f) => existsSync(join(commandsDest, f)));
-  if (alreadyInstalled) {
-    console.log('Audit commands already installed — skipping.');
+  for (const { file } of missing) console.log(`  missing   /${file.replace(/\.md$/, '')}`);
+  for (const { file } of outdated) console.log(`  outdated  /${file.replace(/\.md$/, '')}`);
+
+  if (missing.length === 0 && outdated.length === 0) {
+    console.log(`All ${current.length} audit commands are up to date.`);
+  } else {
+    console.log(`Audit commands: ${missing.length} missing, ${outdated.length} outdated, ${current.length} up to date.`);
     console.log('');
+    console.log('Run the following to update them:');
+    console.log('  npx @majordigital/create-acorn@latest --add-audit');
+  }
+  console.log('');
+}
+
+function setupAuditCommands() {
+  const { commandsDest, missing, outdated, current, total } = compareAuditCommands();
+  if (total === 0) {
+    console.log('Warning: No audit commands found in the package — skipping.');
     return;
   }
 
   mkdirSync(commandsDest, { recursive: true });
-  for (const file of auditFiles) {
-    cpSync(join(commandsSrc, file), join(commandsDest, file), { force: true });
+
+  // Refresh behaviour: compare contents and overwrite stale files, so re-running
+  // `--add-audit` against a newer package version updates existing projects.
+  for (const { file, srcContent } of [...missing, ...outdated]) {
+    writeFileSync(join(commandsDest, file), srcContent);
   }
-  console.log(`Copied ${auditFiles.length} audit commands to .claude/commands/:`);
-  for (const file of auditFiles) {
-    console.log(`  /${file.replace(/\.md$/, '')}`);
+
+  if (missing.length === 0 && outdated.length === 0) {
+    console.log(`Audit commands already up to date (${current.length} unchanged).`);
+  } else {
+    for (const { file } of missing) console.log(`  added    /${file.replace(/\.md$/, '')}`);
+    for (const { file } of outdated) console.log(`  updated  /${file.replace(/\.md$/, '')}`);
+    console.log(`Audit commands: ${missing.length} added, ${outdated.length} updated, ${current.length} unchanged.`);
   }
   console.log('');
 }
@@ -1157,6 +1198,14 @@ async function main() {
     return;
   }
 
+  // Read-only check — report whether installed audit commands match this package version
+  if (argv.includes('--check-audit')) {
+    console.log('Checking audit commands in the current project...');
+    console.log('');
+    checkAuditCommands();
+    return;
+  }
+
   // Prompt for project name first
   const nameFromFlag = parseFlag('name');
   let projectDir = nameFromFlag;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@majordigital/create-acorn",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "Interactive starter CLI for Acorn with Storyblok/Prismic/DatoCMS, TypeScript, and Tailwind.",
   "bin": {
     "create-acorn": "bin/create-acorn.mjs",