mustflow 2.16.0 → 2.17.0

package/README.md

@@ -103,7 +103,7 @@ available as a direct shell command, install mustflow globally:
 npm install -g mustflow
 mf version --check
 
-bun install -g mustflow
+bun add -g mustflow@latest
 mf version --check
 ```
 
@@ -282,10 +282,10 @@ npx mf update --dry-run
 npx mf update --apply
 ```
 
-After updating the mustflow package, `mf upgrade` combines the package freshness check with the safe project-file update step. It does not install packages by itself; update npm, pnpm, or Bun first.
+After updating the mustflow package, `mf upgrade` combines the package freshness check with the safe project-file update step. It does not install packages by itself; refresh mustflow with the package manager you used first. When a newer release exists, `mf version --check` and `mf upgrade` print update commands for npm, Bun, pnpm, Yarn, and Deno.
 
 ```sh
-bun update -g mustflow
+bun add -g mustflow@latest
 mf upgrade --dry-run
 mf upgrade
 ```
@@ -331,7 +331,7 @@ mf run mustflow_update_apply
 | `mf help <topic>` | Show installed mustflow help. |
 | `mf dashboard` | Start a local inspection dashboard for status, verification recommendations, release/version-source status, template update readiness, latest run receipt, skill routes, safe preferences, and documentation review. Use `--export-json <path>` or `--export <path>` for a bounded static report. It does not execute commands or apply fixes. |
 | `mf version` | Print the installed mustflow package version. |
-| `mf version --check` | Compare the installed package version with the latest npm release and print an update command if a newer version exists. |
+| `mf version --check` | Compare the installed package version with the latest npm release and print package-manager update commands if a newer version exists. |
 | `mf version-sources` | Inspect detected package, template, and declared version sources without modifying files. |
 | `mf impact --changed` | Report whether changed paths require a package or template version decision. |
 | `mf verify --reason <event>` | Run configured verification intents selected by `required_after` metadata. |

package/dist/cli/commands/upgrade.js

@@ -26,7 +26,9 @@ function printPackageCheck(check, reporter, lang) {
     if (check.updateAvailable) {
         reporter.stdout('');
         reporter.stdout(t(lang, 'version.check.updateCommand'));
-        reporter.stdout(check.updateCommand);
+        for (const entry of check.updateCommands) {
+            reporter.stdout(`${entry.manager}: ${entry.command}`);
+        }
     }
 }
 export async function runUpgrade(args, reporter, lang = 'en') {

package/dist/cli/commands/version.js

@@ -25,7 +25,7 @@ function renderVersionCheck(check, lang) {
             : t(lang, 'version.check.upToDate', { version: check.latestVersion }),
     ];
     if (check.updateAvailable) {
-        lines.push('', t(lang, 'version.check.updateCommand'), check.updateCommand);
+        lines.push('', t(lang, 'version.check.updateCommand'), ...check.updateCommands.map((entry) => `${entry.manager}: ${entry.command}`));
     }
     return lines.join('\n');
 }

package/dist/cli/i18n/en.js

@@ -697,7 +697,7 @@ Read these files before working:
     "version.help.exit.ok": "Version information was printed",
     "version.check.latestAvailable": "latest {version} available",
     "version.check.upToDate": "latest {version}; already up to date",
-    "version.check.updateCommand": "Update command:",
+    "version.check.updateCommand": "Update commands:",
     "version.error.checkFailed": "Could not check npm for a newer version: {message}",
     "upgrade.help.summary": "Check whether the installed mustflow package is current, then safely apply bundled workflow template updates when possible.",
     "upgrade.help.option.dryRun": "Check package status and print the project update plan without writing files",

package/dist/cli/i18n/es.js

@@ -697,7 +697,7 @@ Lee estos archivos antes de trabajar:
     "version.help.exit.ok": "Se imprimió la información de versión",
     "version.check.latestAvailable": "última versión {version} disponible",
     "version.check.upToDate": "última versión {version}; ya está actualizado",
-    "version.check.updateCommand": "Comando de actualización:",
+    "version.check.updateCommand": "Comandos de actualización:",
     "version.error.checkFailed": "No se pudo consultar npm para una versión nueva: {message}",
     "upgrade.help.summary": "Comprueba si el paquete mustflow instalado está actualizado y luego aplica de forma segura las actualizaciones de la plantilla incluida cuando sea posible.",
     "upgrade.help.option.dryRun": "Comprueba el estado del paquete e imprime el plan de actualización del proyecto sin escribir archivos",

package/dist/cli/i18n/fr.js

@@ -697,7 +697,7 @@ Lisez ces fichiers avant de travailler :
     "version.help.exit.ok": "Les informations de version ont été affichées",
     "version.check.latestAvailable": "dernière version {version} disponible",
     "version.check.upToDate": "dernière version {version}; déjà à jour",
-    "version.check.updateCommand": "Commande de mise à jour :",
+    "version.check.updateCommand": "Commandes de mise à jour :",
     "version.error.checkFailed": "Impossible de vérifier une nouvelle version sur npm : {message}",
     "upgrade.help.summary": "Vérifie si le paquet mustflow installé est à jour, puis applique en sécurité les mises à jour du modèle inclus quand c'est possible.",
     "upgrade.help.option.dryRun": "Vérifie l'état du paquet et affiche le plan de mise à jour du projet sans écrire de fichiers",

package/dist/cli/i18n/hi.js

@@ -697,7 +697,7 @@ export const hiMessages = {
     "version.help.exit.ok": "Version जानकारी प्रिंट की गई",
     "version.check.latestAvailable": "latest {version} उपलब्ध है",
     "version.check.upToDate": "latest {version}; पहले से up to date",
-    "version.check.updateCommand": "Update command:",
+    "version.check.updateCommand": "Update commands:",
     "version.error.checkFailed": "npm पर नया version जाँचा नहीं जा सका: {message}",
     "upgrade.help.summary": "जाँचें कि installed mustflow package current है या नहीं, फिर संभव होने पर current CLI में bundled workflow template updates सुरक्षित रूप से लागू करें.",
     "upgrade.help.option.dryRun": "Package status जाँचें और files लिखे बिना project update plan प्रिंट करें",

package/dist/cli/lib/npm-version-check.js

@@ -1,5 +1,42 @@
 const DEFAULT_NPM_REGISTRY_URL = 'https://registry.npmjs.org';
 const DEFAULT_VERSION_CHECK_TIMEOUT_MS = 3_000;
+const PACKAGE_MANAGER_COMMANDS = [
+    {
+        id: 'npm',
+        label: 'npm',
+        command(packageName) {
+            return `npm install -g ${packageName}@latest`;
+        },
+    },
+    {
+        id: 'bun',
+        label: 'bun',
+        command(packageName) {
+            return `bun add -g ${packageName}@latest`;
+        },
+    },
+    {
+        id: 'pnpm',
+        label: 'pnpm',
+        command(packageName) {
+            return `pnpm add -g ${packageName}@latest`;
+        },
+    },
+    {
+        id: 'yarn',
+        label: 'yarn',
+        command(packageName) {
+            return `yarn global add ${packageName}@latest`;
+        },
+    },
+    {
+        id: 'deno',
+        label: 'deno',
+        command(packageName) {
+            return `deno install -g -A -n mf npm:${packageName}@latest`;
+        },
+    },
+];
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -65,6 +102,37 @@ function getTimeoutMs() {
     const parsed = rawValue ? Number(rawValue) : DEFAULT_VERSION_CHECK_TIMEOUT_MS;
     return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : DEFAULT_VERSION_CHECK_TIMEOUT_MS;
 }
+function detectPackageManagerId() {
+    const signals = [
+        process.env.npm_config_user_agent,
+        process.env.npm_execpath,
+        process.execPath,
+        process.argv[1],
+        import.meta.url,
+    ]
+        .filter((signal) => typeof signal === 'string' && signal.length > 0)
+        .map((signal) => signal.toLowerCase());
+    for (const id of ['bun', 'pnpm', 'yarn', 'deno', 'npm']) {
+        if (signals.some((signal) => signal.includes(id))) {
+            return id;
+        }
+    }
+    return null;
+}
+function getPackageInstallCommands(packageName) {
+    const detectedId = detectPackageManagerId();
+    const commands = [...PACKAGE_MANAGER_COMMANDS];
+    const recommendedIndex = detectedId ? commands.findIndex((entry) => entry.id === detectedId) : -1;
+    if (recommendedIndex > 0) {
+        const [recommended] = commands.splice(recommendedIndex, 1);
+        commands.unshift(recommended);
+    }
+    return commands.map((entry, index) => ({
+        manager: entry.label,
+        command: entry.command(packageName),
+        recommended: index === 0 && detectedId === entry.id,
+    }));
+}
 function buildLatestPackageUrl(registryUrl, packageName) {
     const trimmedRegistryUrl = registryUrl.replace(/\/+$/u, '');
     const encodedPackageName = packageName.startsWith('@')
@@ -86,12 +154,14 @@ export async function checkNpmLatestVersion(metadata) {
     if (!latestVersion) {
         throw new Error('npm registry response did not include a version');
     }
+    const updateCommands = getPackageInstallCommands(metadata.name);
     return {
         packageName: metadata.name,
         currentVersion: metadata.version,
         latestVersion,
         updateAvailable: comparePackageVersions(metadata.version, latestVersion) < 0,
         registryUrl,
-        updateCommand: `npm install -g ${metadata.name}@latest`,
+        updateCommand: updateCommands[0]?.command ?? `npm install -g ${metadata.name}@latest`,
+        updateCommands,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mustflow",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "description": "Agent workflow documents and CLI for mustflow repository roots.",
   "type": "module",
   "license": "MIT-0",

package/templates/default/manifest.toml

@@ -1,6 +1,6 @@
 id = "default"
 name = "default"
-version = "2.16.0"
+version = "2.17.0"
 description = "Minimal workflow for LLM agents to read, edit, and verify their work in a repository."
 common_root = "common"
 locales_root = "locales"