@mfjjs/ruflo-setup 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.1.7](https://gitlab.mfj.local:8022/mario/ruflo-setup/compare/v0.1.6...v0.1.7) (2026-03-13)
+
+
+### Features
+
+* **setup:** sync global command template and enhance dry-run feedback ([18e8b1d](https://gitlab.mfj.local:8022/mario/ruflo-setup/commit/18e8b1d3111eb2dbe067e0aba6349872bc59a236))
+
+### [0.1.6](https://gitlab.mfj.local:8022/mario/ruflo-setup/compare/v0.1.5...v0.1.6) (2026-03-11)
+
 ### [0.1.5](https://gitlab.mfj.local:8022/mario/ruflo-setup/compare/v0.1.4...v0.1.5) (2026-03-11)
 
 

package/README.md

@@ -4,7 +4,7 @@ Cross-platform npm CLI to bootstrap a project with Ruflo on Windows and Linux.
 
 ## What this project is
 
-`@mfjjs/ruflo-setup` replaces the old PowerShell-only bootstrap script with a Node-based CLI command:
+`@mfjjs/ruflo-setup` implements the setup with a Node-based CLI command:
 
 - Package name: `@mfjjs/ruflo-setup`
 - Command name: `ruflo-setup`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mfjjs/ruflo-setup",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Cross-platform setup CLI for Ruflo + Claude Flow projects",
   "type": "module",
   "bin": {

package/src/setup.js

@@ -1,3 +1,4 @@
+import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import { spawnSync } from 'node:child_process';
@@ -107,17 +108,20 @@ function writeMcpJson({ cwd, dryRun }) {
   logLine('  .mcp.json written for this platform.');
 }
 
-function installGlobalCommand({ packageRoot, dryRun }) {
+function syncGlobalCommandTemplate({ packageRoot, dryRun }) {
   const src = path.join(packageRoot, 'templates', 'ruflo-setup.md');
   const dest = path.join(os.homedir(), '.claude', 'commands', 'ruflo-setup.md');
+  const exists = pathExists(dest);
+  const operation = exists ? 'update' : 'install';
+  const srcContent = fs.readFileSync(src, 'utf8');
+  const changed = !exists || fs.readFileSync(dest, 'utf8') !== srcContent;
 
-  if (dryRun) {
-    logLine(`  [DRY RUN] Would write: ${dest}`);
-    return { dest };
+  if (dryRun || !changed) {
+    return { dest, changed, operation };
   }
 
   copyFileSync(src, dest);
-  return { dest };
+  return { dest, changed, operation };
 }
 
 function isAlreadyConfigured(cwd) {
@@ -142,6 +146,21 @@ export async function runSetup({
   }
   logLine('');
 
+  logLine('Preflight: Syncing global /ruflo-setup command template ...');
+  const preflightCommandResult = syncGlobalCommandTemplate({ packageRoot, dryRun });
+  if (preflightCommandResult.changed) {
+    if (dryRun) {
+      logLine(`  [DRY RUN] Would ${preflightCommandResult.operation}: ${preflightCommandResult.dest}`);
+    } else if (preflightCommandResult.operation === 'install') {
+      logLine(`  Installed command template at: ${preflightCommandResult.dest}`);
+    } else {
+      logLine(`  Updated command template at: ${preflightCommandResult.dest}`);
+    }
+  } else {
+    logLine(`  Command template already up to date: ${preflightCommandResult.dest}`);
+  }
+  logLine('');
+
   if (isAlreadyConfigured(cwd) && !force && !yes) {
     logLine('WARNING: This project already has Ruflo configuration.');
     const shouldOverwrite = await confirm('Overwrite existing configuration? [y/N] ');
@@ -185,9 +204,20 @@ export async function runSetup({
   }
 
   logLine('Step 4: Installing global /ruflo-setup command ...');
-  const commandResult = installGlobalCommand({ packageRoot, dryRun });
-  if (!dryRun) {
-    logLine(`  Command installed at: ${commandResult.dest}`);
+  if (dryRun) {
+    if (preflightCommandResult.changed) {
+      logLine(`  [DRY RUN] Would ${preflightCommandResult.operation}: ${preflightCommandResult.dest}`);
+    } else {
+      logLine(`  [DRY RUN] Command already up to date: ${preflightCommandResult.dest}`);
+    }
+  } else if (preflightCommandResult.changed) {
+    if (preflightCommandResult.operation === 'install') {
+      logLine(`  Command installed at: ${preflightCommandResult.dest}`);
+    } else {
+      logLine(`  Command updated at: ${preflightCommandResult.dest}`);
+    }
+  } else {
+    logLine(`  Command already up to date: ${preflightCommandResult.dest}`);
   }
   logLine('');
 

package/templates/ruflo-setup.md

@@ -39,6 +39,7 @@ Runs `pnpm add -g @mfjjs/ruflo-setup` then `ruflo-setup` which:
    - `.claude/commands/` — slash commands
 2. Writes a platform-aware `.mcp.json` (MCP server registration for claude-flow, ruv-swarm, flow-nexus)
 3. Installs a global `SessionStart` hook in `~/.claude/settings.json` that warns when Ruflo is not configured
+4. May refresh `~/.claude/commands/ruflo-setup.md` from the latest packaged template when differences are detected
 
 ## Instructions for Claude