@bobfrankston/npmglobalize 1.0.222 → 1.0.223

package/README.md

@@ -884,7 +884,9 @@ This is useful for:
 deprecation note; it was renamed (2026-09-07) because "local" read as "local mode" rather
 than "install from the local directory".
 
-`-local-install` is persisted to `.globalize.json5` (`"local": true`), so a bare
+`-local-install` is persisted to `.globalize.json5` (`"localInstall": true`; the older
+`"local"` key is still read and is rewritten to the new name the next time the file is
+saved), so a bare
 `npmglobalize` keeps doing local installs until you run `-global` (or edit the
 file). Nothing is committed, bumped, or published, but a `.commitmsg` is still
 consumed: it is appended to `npmchanges.md` under a

package/cli.js

@@ -235,14 +235,15 @@ function parseArgs(args) {
             // from the local directory". Renamed to -local-install (-localinstall also
             // accepted). -local still works but says so, so muscle memory isn't broken
             // and the old spelling is phased out rather than silently kept alive.
-            // The .globalize.json5 key stays "local" so existing configs keep working.
+            // The .globalize.json5 key was renamed "local" → "localInstall" the same day;
+            // readConfig accepts the old name and the next persist rewrites it.
             case '-local':
-                console.log(colors.yellow('!  -local is deprecated — use -local-install (same meaning: npm install -g . from the local directory, no publish)'));
+                console.log(colors.yellow('!  -local is deprecated — use -local-install (or -localinstall). Same meaning: npm install -g . from the local directory, no publish.'));
             // falls through
             case '-local-install':
             case '-localinstall':
-                options.local = true;
-                options.explicitKeys.add('local');
+                options.localInstall = true;
+                options.explicitKeys.add('localInstall');
                 break;
             // 2026-09-01 16:30 EDT — Claude Code (Opus 5), at Bob's direction. -local-install
             // persists to .globalize.json5 but had no counterpart, so leaving local-only
@@ -250,8 +251,8 @@ function parseArgs(args) {
             // 2026-09-01 15:00 EDT — Bob: "-global makes more sense, -nolocal is confusing";
             // -nolocal dropped, -global is the only spelling.
             case '-global':
-                options.local = false;
-                options.explicitKeys.add('local');
+                options.localInstall = false;
+                options.explicitKeys.add('localInstall');
                 break;
             case '-install':
             case '-i':
@@ -663,7 +664,7 @@ export async function main() {
         console.log(`Updated ${path.join(cwd, 'package.json')} scripts:`);
         changes.forEach(c => console.log(`  ${c}`));
         // If no other flags need processing, exit; otherwise fall through
-        if (!cliOptions.install && !cliOptions.link && !cliOptions.local) {
+        if (!cliOptions.install && !cliOptions.link && !cliOptions.localInstall) {
             process.exit(0);
         }
     }

package/lib.d.ts

@@ -132,8 +132,9 @@ export interface GlobalizeOptions {
      *  are absent. Currently declarative (recorded in config and displayed);
      *  the actual conversion path is TODO. */
     usePaths?: boolean;
-    /** Local install only — skip transform/publish, just npm install -g . */
-    local?: boolean;
+    /** Local install only (-local-install) — skip transform/publish, just npm install -g .
+     *  Config key renamed from "local" 2026-09-07; readConfig still accepts the old name. */
+    localInstall?: boolean;
     /** Build every file: dep even when outputs look up to date (skips the freshness check) */
     forceBuild?: boolean;
     /** Freeze node_modules: replace symlinks/junctions with real copies for network share use */

package/lib.js

@@ -312,7 +312,18 @@ export function readConfig(dir) {
     }
     try {
         const content = fs.readFileSync(configPath, 'utf-8');
-        return JSON5.parse(content);
+        const config = JSON5.parse(content);
+        // 2026-09-07 — Claude Code (Fable 5.1), at Bob's direction: the "local" key
+        // was renamed "localInstall" along with the -local → -local-install flag.
+        // Old files keep working: the value is carried over here, and since
+        // writeConfig reads the existing config through this same function, the
+        // next persist writes the new name and drops the old one.
+        if ('local' in config && !('localInstall' in config)) {
+            config.localInstall = config.local;
+            console.log(colors.dim(`  (.globalize.json5: "local" is now "localInstall" — rewritten on the next persist)`));
+        }
+        delete config.local;
+        return config;
     }
     catch (error) {
         console.warn(`Warning: Could not parse .globalize.json5 config: ${error.message}`);
@@ -332,7 +343,7 @@ const BOOL_COMMENTS = {
     quiet: { on: 'Suppress npm warnings', off: 'Show npm warnings' },
     verbose: { on: 'Show detailed output', off: 'Normal output detail' },
     fix: { on: 'Auto-run npm audit fix (default)', off: 'Do NOT run npm audit fix (audit report still runs)' },
-    local: { on: 'Local install only via -local-install (skip transform/publish)', off: 'Normal transform/publish flow' },
+    localInstall: { on: 'Local install only via -local-install (skip transform/publish)', off: 'Normal transform/publish flow' },
     noPublish: { on: 'Transform but don\'t publish', off: 'Publish normally' },
     freeze: { on: 'Freeze node_modules (replace symlinks with real copies)', off: 'Leave node_modules symlinks as-is' },
     usePaths: { on: 'Resolve file: deps from sibling checkouts', off: 'Resolve file: deps from npm, not siblings (standalone package)' },
@@ -444,7 +455,7 @@ export function writeConfig(dir, config, explicitKeys) {
         ['"gitVisibility": "private"', 'Git repo: private or public'],
         ['"npmVisibility": "private"', 'npm package: private or public'],
         ['"fix": true', 'true = auto-run npm audit fix (never --force); false = report only'],
-        ['"local": false', 'true = install from the local directory only, set by -local-install (skip transform/publish); clear with -global'],
+        ['"localInstall": false', 'true = install from the local directory only, set by -local-install (skip transform/publish); clear with -global'],
         ['"noPublish": false', 'true = transform but don\'t publish'],
         ['"freeze": false', 'true = freeze node_modules (replace symlinks with real copies)'],
         ['"usePaths": true', 'true = resolve file: deps from siblings; false = use latest npm version (standalone)'],
@@ -6669,7 +6680,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
     const { bump = 'patch', noPublish = false, cleanup = false, install = false, link = false, wsl = false, force = false, files = true, dryRun = false, quiet = true, verbose = false, init = false, gitVisibility = 'private', npmVisibility = 'private', message, conform = false, asis = false, updateDeps = false, updateMajor = false, publishDeps = true, // Default to publishing deps for safety
     publishDepsYes = false, // -pd: auto-yes to dep-cascade prompts (private only)
     publicDeps = false, // -public-deps: cascade public visibility to all deps
-    noPrescan = false, forcePublish = false, fix = true, fixTags = false, rebase = false, show = false, local = false, freeze = false, usePaths = true, allowTs, adopt = false, importCheck = false } = options;
+    noPrescan = false, forcePublish = false, fix = true, fixTags = false, rebase = false, show = false, localInstall = false, freeze = false, usePaths = true, allowTs, adopt = false, importCheck = false } = options;
     // 2026-09-06 — Claude Code (Fable 5.1), at Bob's direction: a directory marked
     // `.stale` is retired. Refuse to build, publish or install it — and because the
     // dep cascade reaches deps through this same function, refuse to cascade into
@@ -6733,7 +6744,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
             settings.push('--force-publish');
         if (configOptions.show)
             settings.push('--show');
-        if (configOptions.local)
+        if (configOptions.localInstall)
             settings.push('-local-install');
         if (configOptions.freeze)
             settings.push('-freeze');
@@ -6758,7 +6769,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
     // 2026-09-01 16:30 EDT — Claude Code (Opus 5): this was a verbatim copy of
     // doLocalInstall (the 10:55 output-capture note lives there now). One path,
     // so the .commitmsg recording added today lands in both entry points.
-    if (local) {
+    if (localInstall) {
         return doLocalInstall(cwd, options);
     }
     // Prescan the file: dep graph up front — surface all problems before
@@ -6988,7 +6999,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
                     + '  5) Abort\nChoice [1]:', ['1', '2', '3', '4', '5', '']);
                 if (choice === '4') {
                     console.log(colors.dim('Switching to local-only mode...'));
-                    writeConfig(cwd, { ...configOptions, local: true }, new Set(['local']));
+                    writeConfig(cwd, { ...configOptions, localInstall: true }, new Set(['localInstall']));
                     return doLocalInstall(cwd, options);
                 }
                 if (choice === '5') {
@@ -7017,7 +7028,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
                     + '  4) Abort\nChoice [1]:', ['1', '2', '3', '4', '']);
                 if (choice === '3') {
                     console.log(colors.dim('Switching to local-only mode...'));
-                    writeConfig(cwd, { ...configOptions, local: true }, new Set(['local']));
+                    writeConfig(cwd, { ...configOptions, localInstall: true }, new Set(['localInstall']));
                     return doLocalInstall(cwd, options);
                 }
                 if (choice === '4') {
@@ -7060,7 +7071,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
                 + '  4) Abort\nChoice [1]:', ['1', '2', '3', '4', '']);
             if (choice === '3') {
                 console.log(colors.dim('Switching to local-only mode...'));
-                writeConfig(cwd, { ...configOptions, local: true }, new Set(['local']));
+                writeConfig(cwd, { ...configOptions, localInstall: true }, new Set(['localInstall']));
                 return doLocalInstall(cwd, options);
             }
             if (choice === '4') {
@@ -7875,8 +7886,8 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
             surprises.push(`usePaths=false${fromConfig('usePaths')} — file: deps resolved from npm, not siblings`);
         if (configOptions.freeze || freeze)
             surprises.push(`freeze=true${fromConfig('freeze')}`);
-        if (configOptions.local || local)
-            surprises.push(`local=true${fromConfig('local')}`);
+        if (configOptions.localInstall || localInstall)
+            surprises.push(`localInstall=true${fromConfig('localInstall')}`);
         if (configOptions.files === false || files === false)
             surprises.push(`files=false${fromConfig('files')} — npm versions left in package.json`);
         if (configOptions.allowTs === true || allowTs === true)
@@ -9064,8 +9075,8 @@ export async function globalizeWorkspace(rootDir, options = {}, configOptions =
     // user up front avoids the surprise of "I asked for install but most
     // packages didn't install."
     const installSources = [];
-    if (options.local || configOptions.local) {
-        const src = configOptions.local && !options.local ? '.globalize.json5' : 'CLI';
+    if (options.localInstall || configOptions.localInstall) {
+        const src = configOptions.localInstall && !options.localInstall ? '.globalize.json5' : 'CLI';
         installSources.push(`-local-install (${src})`);
     }
     if (options.install || configOptions.install) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/npmglobalize",
-  "version": "1.0.222",
+  "version": "1.0.223",
   "description": "Transform file: dependencies to npm versions for publishing",
   "main": "index.js",
   "type": "module",
@@ -33,7 +33,7 @@
   "dependencies": {
     "@bobfrankston/freezepak": "^0.1.9",
     "@bobfrankston/importgen": "^0.1.43",
-    "@bobfrankston/themecolors": "^0.1.9",
+    "@bobfrankston/themecolors": "^0.1.10",
     "@bobfrankston/userconfig": "^1.0.11",
     "@npmcli/package-json": "^7.0.4",
     "json5": "^2.2.3",
@@ -61,7 +61,7 @@
     "dependencies": {
       "@bobfrankston/freezepak": "^0.1.9",
       "@bobfrankston/importgen": "^0.1.43",
-      "@bobfrankston/themecolors": "^0.1.9",
+      "@bobfrankston/themecolors": "^0.1.10",
       "@bobfrankston/userconfig": "^1.0.11",
       "@npmcli/package-json": "^7.0.4",
       "json5": "^2.2.3",