@mfjjs/ruflo-setup 0.1.6 → 0.1.8

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.8](https://gitlab.mfj.local:8022/mario/ruflo-setup/compare/v0.1.7...v0.1.8) (2026-03-13)
+
+### [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

@@ -9,8 +9,9 @@ Cross-platform npm CLI to bootstrap a project with Ruflo on Windows and Linux.
 - Package name: `@mfjjs/ruflo-setup`
 - Command name: `ruflo-setup`
 - Platform support: Windows and Linux (plus macOS by default)
-
 ## Requirements
+<details>
+  <summary>Click to toggle visibility</summary>
 
 - Node.js 20+
 - pnpm available on PATH
@@ -34,6 +35,47 @@ Alternative (all platforms with recent Node.js):
 corepack enable
 corepack prepare pnpm@latest --activate
 ```
+</details>
+
+## Installation
+
+```powershell
+pnpm -i -g @mfjjs/ruflo-setup
+```
+
+## Usage
+
+### Bootstrap
+Use this once if you want Claude Code to expose the `/ruflo-setup` command globally.
+
+```bash
+ruflo-setup hooks init
+```
+
+After that, when you open Claude Code in a project that does not already have Ruflo configured, you can run [**/ruflo-setup**](noop:) to start the setup flow.
+
+### Setup
+Use these commands when you want to run the setup directly from a shell.
+
+From the target project directory, run one of the following:
+
+```bash
+# full setup
+ruflo-setup
+
+# non-interactive
+ruflo-setup --yes
+
+# preview only
+ruflo-setup --dry-run --skip-init
+
+# skip global hook install
+ruflo-setup --no-hooks
+
+# hook operations
+ruflo-setup hooks install
+ruflo-setup hooks status
+```
 
 ## Project structure
 
@@ -75,26 +117,6 @@ Flow:
 	 - copies `templates/CLAUDE.md`
 	 - installs global SessionStart hook (unless skipped)
 
-## Usage
-
-```bash
-# full setup
-ruflo-setup
-
-# non-interactive
-ruflo-setup --yes
-
-# preview only
-ruflo-setup --dry-run --skip-init
-
-# skip global hook install
-ruflo-setup --no-hooks
-
-# hook operations
-ruflo-setup hooks install
-ruflo-setup hooks status
-```
-
 ## Local development with pnpm
 
 From this repository root (`setup-ruflo/`):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mfjjs/ruflo-setup",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "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