@bobfrankston/npmglobalize 1.0.88 → 1.0.89

package/.claude/settings.local.json

@@ -23,7 +23,9 @@
       "Bash(wsl ls:*)",
       "Bash(cmd.exe /c \"dir y:\\\\dev\\\\homecontrol\\\\utils\\\\addone /a /b\")",
       "Bash(cmd.exe /c \"dir /a /b y:\\\\dev\\\\homecontrol\\\\utils\\\\addone\")",
-      "Bash(icacls:*)"
+      "Bash(icacls:*)",
+      "Bash(npm install:*)",
+      "Bash(echo:*)"
     ]
   }
 }

package/README.md

@@ -224,78 +224,80 @@ Publishing requires being on a branch so commits and tags can be properly tracke
 
 ## Command Reference
 
-<!-- NOTE: Keep this in sync with the --help output in cli.ts printHelp().
+<!-- NOTE: Keep this in sync with the -help output in cli.ts printHelp().
      The README expands on options with examples and context;
-     cli.ts is the concise quick-reference. Update both when adding/changing flags. -->
+     cli.ts is the concise quick-reference. Update both when adding/changing flags.
+     Both -flag and --flag are accepted; single-dash is shown as primary. -->
 
 ### Release Options
 ```
---patch              Bump patch version (default)
---minor              Bump minor version
---major              Bump major version
---nopublish, -np     Just transform, don't publish
---cleanup            Restore file: dependencies from backup
--m, --message <msg>  Custom commit message (forces release even without changes)
+-patch               Bump patch version (default)
+-minor               Bump minor version
+-major               Bump major version
+-nopublish, -np      Just transform, don't publish (persisted to config)
+-cleanup             Restore file: dependencies from .dependencies backup
+-m, -message <msg>   Custom commit message (forces release even without changes)
 ```
 
 ### Dependency Options
 ```
---update-deps, -ud        Update package.json to latest versions (safe: minor/patch)
---update-major            Allow major version updates (breaking changes)
---no-publish-deps, -npd   Skip auto-publishing file: dependencies
---force-publish           Republish dependencies even if version exists
---fix                     Run npm audit fix after transformation
---no-fix                  Don't run npm audit
+-update-deps, -ud        Update package.json to latest versions (safe: minor/patch)
+-update-major            Allow major version updates (breaking changes)
+-no-publish-deps, -npd   Skip auto-publishing file: dependencies
+-force-publish           Republish dependencies even if version exists
+-fix                     Run npm audit fix after transformation
+-no-fix                  Don't run npm audit
 ```
 
 ### Install Options
 ```
---install, -i   Install globally after publish (from registry)
---link          Install globally via symlink (npm install -g .)
---wsl           Also install in WSL
---once          Don't persist flags to .globalize.json5
+-install, -i    Install globally after publish (from registry)
+-link           Install globally via symlink (npm install -g .)
+-local          Local install only — skip transform/publish, just npm install -g .
+-wsl            Also install in WSL
+-once           Don't persist flags to .globalize.json5
 ```
 
 ### Mode Options
 ```
---files         Keep file: paths after publish (default)
---nofiles       Keep npm versions permanently
+-files          Keep file: paths after publish (default)
+-nofiles        Keep npm versions permanently
 ```
 
 ### Git/npm Visibility
 ```
---git private   Make git repo private (default)
---git public    Make git repo public (requires confirmation)
---npm private   Mark npm package private (skip publish) (default)
---npm public    Publish to npm
+-git private    Make git repo private (default)
+-git public     Make git repo public (requires confirmation)
+-npm private    Mark npm package private (skip publish) (default)
+-npm public     Publish to npm
 ```
 
 ### Workspace Options
 ```
--w, --workspace <pkg>  Filter to specific package (repeatable)
---no-workspace         Disable workspace mode at a workspace root
---continue-on-error    Continue if a package fails in workspace mode
+-w, -workspace <pkg>   Filter to specific package (repeatable)
+-no-workspace          Disable workspace mode at a workspace root
+-continue-on-error     Continue if a package fails in workspace mode
 ```
 
 Workspace mode is auto-detected when run from a root with `"private": true` and a `workspaces` field.
 
 ### Other Options
 ```
---init          Initialize git/npm if needed (creates .gitignore, .npmignore,
+-init           Initialize git/npm if needed (creates .gitignore, .npmignore,
                 .gitattributes, and configures git for LF line endings)
---force         Continue despite git errors
---dry-run       Preview what would happen
---quiet         Suppress npm warnings (default)
---verbose       Show detailed output
---conform       Update .gitignore/.npmignore/.gitattributes to best practices
+-force          Continue despite git errors
+-dry-run        Preview what would happen
+-quiet          Suppress npm warnings (default)
+-verbose        Show detailed output
+-conform        Update .gitignore/.npmignore/.gitattributes to best practices
                 and configure git for LF line endings (fixes existing repos)
---asis          Skip ignore file checks (or set "asis": true in .globalize.json5)
---fix-tags      Automatically fix version/tag mismatches
---rebase        Automatically rebase if local is behind remote
---show          Show package.json dependency changes
---package, -pkg Update package.json scripts to use npmglobalize (see below)
--h, --help      Show help
--v, --version   Show version
+-asis           Skip ignore file checks (or set "asis": true in .globalize.json5)
+-fix-tags       Automatically fix version/tag mismatches
+-rebase         Automatically rebase if local is behind remote
+-show           Show package.json dependency changes
+-package, -pkg  Update package.json scripts to use npmglobalize (see below)
+-h, -help       Show help
+-v, -version    Show version
 ```
 
 ## Using in package.json
@@ -391,6 +393,70 @@ npmglobalize --dry-run     # See what would happen
 11. **Restores** file: references (if `--files`, default)
 12. **Runs audit** (shows security status)
 
+## Operational Details
+
+### The `.dependencies` Backup Mechanism
+
+When `npmglobalize` transforms `file:` references to npm versions, it stores the originals in a `.dependencies` field (and `.devDependencies`, etc.) inside `package.json`. This is the central safety mechanism — it allows recovery from any failure during the publish cycle.
+
+**How it works:**
+- Before transforming, the original `file:` entries are copied to `.dependencies`
+- After a successful publish, the originals are restored from `.dependencies` and the backup is removed
+- If the process crashes, is interrupted, or exits early (e.g., private package, `--nopublish`), `.dependencies` remains in `package.json`
+- On the **next run**, `transformDeps` detects `.dependencies`, restores the originals first, then re-transforms — so data is never lost
+
+**Recovery commands:**
+```bash
+npmglobalize -cleanup    # Manually restore file: deps from .dependencies backup
+```
+
+**Why not just restore immediately on error?** The `.dependencies` approach is deliberately persistent. If the tool crashes hard (killed process, power failure, npm timeout), there's no cleanup code to run. The backup in `package.json` survives because it was written before the risky operations began. The next run self-heals.
+
+### Flag Conventions
+
+Both `-flag` and `--flag` are accepted. Single-dash is the primary convention:
+```bash
+npmglobalize -patch      # same as --patch
+npmglobalize -np         # same as --nopublish
+npmglobalize -local      # same as --local
+```
+
+### Persistent vs One-Shot Flags
+
+Some flags are **persisted** to `.globalize.json5` when set from the CLI:
+- `-install`, `-link`, `-wsl`, `-files`, `-fix` — install/build preferences
+- `-np` (noPublish) — once set, prevents accidental publishes
+- `-local` — remembers "this project is local-only"
+- `-git`/`-npm` visibility
+
+Other flags are **one-shot** (never persisted):
+- `-cleanup`, `-init`, `-dry-run`, `-message` — situational actions
+- `-update-deps`, `-update-major`, `-force-publish` — explicit per-run choices
+- `-conform`, `-asis` — one-time fixes
+
+Use `-once` to prevent any flag from persisting on that run:
+```bash
+npmglobalize -np -once   # No-publish this run only, don't remember it
+```
+
+### Local Install (`-local`)
+
+Skip all transform/publish logic and just run `npm install -g .` with `file:` deps as-is. Use this when you want to install a CLI tool locally for your own use without publishing anything:
+
+```bash
+npmglobalize -local          # Install globally from local directory
+npmglobalize -local -wsl     # Also install in WSL
+```
+
+This is useful for:
+- Development tools you don't publish
+- Testing a CLI before publishing
+- Projects with `file:` deps that should stay as-is
+
+### Private Packages
+
+Packages with `"private": true` in `package.json` skip the npm publish step. Dependencies are still transformed and restored — the publish is the only thing skipped.
+
 ## Version Checking
 
 When publishing file: dependencies, checks if each version exists on npm:
@@ -408,34 +474,37 @@ npmglobalize
 npmglobalize y:\dev\myproject
 
 # Auto-fix tag conflicts and rebase
-npmglobalize --fix-tags --rebase
+npmglobalize -fix-tags -rebase
 
 # Release with updates and security fixes
-npmglobalize --update-deps --fix
+npmglobalize -update-deps -fix
 
 # Just update package.json, don't publish
-npmglobalize -np --update-deps
+npmglobalize -np -update-deps
 
 # Force republish all dependencies
-npmglobalize --force-publish --update-major
+npmglobalize -force-publish -update-major
 
 # Release + install on Windows and WSL (from registry)
-npmglobalize --install --wsl
+npmglobalize -install -wsl
 
 # Release + link on Windows and WSL (symlink)
-npmglobalize --link --wsl
+npmglobalize -link -wsl
+
+# Install locally without publishing (file: deps stay as-is)
+npmglobalize -local
 
 # Restore original file: references
-npmglobalize --cleanup
+npmglobalize -cleanup
 
 # Initialize new git repo + release
-npmglobalize --init
+npmglobalize -init
 
 # Migrate package.json scripts to use npmglobalize
-npmglobalize --package
+npmglobalize -package
 
 # Preview what would happen
-npmglobalize --dry-run --verbose
+npmglobalize -dry-run -verbose
 ```
 
 ## Authentication

package/cli.js

@@ -15,83 +15,88 @@ npmglobalize - Transform file: dependencies to npm versions for publishing
 
 Usage: npmglobalize [path] [options]
 
+Note: Both -flag and --flag are accepted (e.g., -patch and --patch are the same).
+
 Arguments:
   path            Path to the project directory (default: current directory)
 
 Release Options:
-  --patch              Bump patch version (default)
-  --minor              Bump minor version
-  --major              Bump major version
-  --nopublish, -np     Just transform, don't publish
-  --cleanup            Restore from .dependencies
-  -m, --message <msg>  Custom commit message (forces release even without changes)
+  -patch               Bump patch version (default)
+  -minor               Bump minor version
+  -major               Bump major version
+  -nopublish, -np      Just transform, don't publish (persisted to config)
+  -cleanup             Restore from .dependencies
+  -m, -message <msg>   Custom commit message (forces release even without changes)
 
 Dependency Options:
-  --update-deps, -ud        Update package.json to latest (minor/patch only, safe)
-  --update-major            Allow major version updates (breaking changes)
-  --no-publish-deps, -npd   Don't auto-publish file: dependencies (use with caution)
-  --force-publish           Republish dependencies even if version exists
-  --fix                     Run npm audit fix after transformation
+  -update-deps, -ud        Update package.json to latest (minor/patch only, safe)
+  -update-major            Allow major version updates (breaking changes)
+  -no-publish-deps, -npd   Don't auto-publish file: dependencies (use with caution)
+  -force-publish           Republish dependencies even if version exists
+  -fix                     Run npm audit fix after transformation
 
 Install Options:
-  --install, -i    Global install after publish (from registry)
-  --link           Global install via symlink (npm install -g .)
-  --wsl            Also install globally in WSL
-  --once           Don't persist flags to .globalize.json5
+  -install, -i   Global install after publish (from registry)
+  -link          Global install via symlink (npm install -g .)
+  -local         Local install only — skip transform/publish, just npm install -g .
+  -wsl           Also install globally in WSL
+  -once          Don't persist flags to .globalize.json5
 
 Mode Options:
-  --files         Keep file: paths after publish (default)
-  --nofiles       Keep npm versions permanently
+  -files          Keep file: paths after publish (default)
+  -nofiles        Keep npm versions permanently
 
 Git/npm Visibility:
-  --git private   Make git repo private (default)
-  --git public    Make git repo public (requires confirmation)
-  --npm private   Mark npm package private (skip publish) (default)
-  --npm public    Publish to npm
+  -git private    Make git repo private (default)
+  -git public     Make git repo public (requires confirmation)
+  -npm private    Mark npm package private (skip publish) (default)
+  -npm public     Publish to npm
 
 Workspace Options:
-  -w, --workspace <pkg>  Filter to specific package (repeatable)
-  --no-workspace         Disable workspace mode at a workspace root
-  --continue-on-error    Continue if a package fails in workspace mode
+  -w, -workspace <pkg>  Filter to specific package (repeatable)
+  -no-workspace         Disable workspace mode at a workspace root
+  -continue-on-error    Continue if a package fails in workspace mode
 
 Other Options:
-  --init          Initialize git/npm if needed
-  --force         Continue despite git errors
-  --dry-run       Preview what would happen
-  --quiet         Suppress npm warnings (default)
-  --verbose       Show detailed output
-  --conform       Update .gitignore/.npmignore to best practices
-  --asis          Skip ignore file checks (or set "asis": true in .globalize.json5)
-  --rebase        Automatically rebase if local is behind remote
-  --show          Show package.json dependency changes
-  --package, -pkg  Update package.json scripts to use npmglobalize
-  -h, --help      Show this help
-  -v, --version   Show version number
+  -init           Initialize git/npm if needed
+  -force          Continue despite git errors
+  -dry-run        Preview what would happen
+  -quiet          Suppress npm warnings (default)
+  -verbose        Show detailed output
+  -conform        Update .gitignore/.npmignore to best practices
+  -asis           Skip ignore file checks (or set "asis": true in .globalize.json5)
+  -rebase         Automatically rebase if local is behind remote
+  -show           Show package.json dependency changes
+  -package, -pkg  Update package.json scripts to use npmglobalize
+  -h, -help       Show this help
+  -v, -version    Show version number
 
 Examples:
   npmglobalize                       Transform + publish (auto-publishes file: deps)
   npmglobalize y:\\path\\to\\project  Run on a different project directory
-  npmglobalize --minor               Release with minor version bump
-  npmglobalize --fix-tags            Fix version/tag mismatches before running
-  npmglobalize --rebase              Auto-rebase if behind remote
-  npmglobalize --update-deps         Safe updates (minor/patch only)
-  npmglobalize --update-major        Allow breaking changes (major updates)
+  npmglobalize -minor                Release with minor version bump
+  npmglobalize -fix-tags             Fix version/tag mismatches before running
+  npmglobalize -rebase               Auto-rebase if behind remote
+  npmglobalize -update-deps          Safe updates (minor/patch only)
+  npmglobalize -update-major         Allow breaking changes (major updates)
   npmglobalize -npd                  Skip auto-publishing file: deps (use with caution)
-  npmglobalize --force-publish       Force republish all file: dependencies
-  npmglobalize --fix                 Fix security vulnerabilities
-  npmglobalize --install --wsl       Release + install on Windows and WSL (from registry)
-  npmglobalize --link --wsl          Release + link on Windows and WSL (symlink)
-  npmglobalize -np                   Just transform, no publish
-  npmglobalize --cleanup             Restore original dependencies
-  npmglobalize --init                Initialize new git repo + release
-  npmglobalize --dry-run             Preview what would happen
-  npmglobalize --package             Migrate scripts to use npmglobalize
+  npmglobalize -force-publish        Force republish all file: dependencies
+  npmglobalize -fix                  Fix security vulnerabilities
+  npmglobalize -install -wsl         Release + install on Windows and WSL (from registry)
+  npmglobalize -link -wsl            Release + link on Windows and WSL (symlink)
+  npmglobalize -local                Install locally with file: deps as-is (no publish)
+  npmglobalize -local -wsl           Local install on Windows and WSL
+  npmglobalize -np                   Just transform, no publish (remembered in config)
+  npmglobalize -cleanup              Restore original dependencies
+  npmglobalize -init                 Initialize new git repo + release
+  npmglobalize -dry-run              Preview what would happen
+  npmglobalize -package              Migrate scripts to use npmglobalize
 
 Workspace (auto-detected when run from a workspace root):
   npmglobalize                       Publish all workspace packages in dependency order
   npmglobalize -w msgcommon          Publish only msgcommon
-  npmglobalize --no-workspace        Skip workspace detection, run single-package mode
-  npmglobalize --continue-on-error   Keep going if a package fails
+  npmglobalize -no-workspace         Skip workspace detection, run single-package mode
+  npmglobalize -continue-on-error    Keep going if a package fails
 `);
 }
 function parseArgs(args) {
@@ -105,150 +110,157 @@ function parseArgs(args) {
     const positional = [];
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
-        switch (arg) {
-            case '--help':
+        // Normalize --flag to -flag (backward compatible: --patch → -patch)
+        const norm = arg.replace(/^--/, '-');
+        switch (norm) {
+            case '-help':
             case '-h':
                 options.help = true;
                 break;
-            case '--version':
+            case '-version':
             case '-v':
                 options.version = true;
                 break;
-            case '--patch':
+            case '-patch':
                 options.bump = 'patch';
                 break;
-            case '--minor':
+            case '-minor':
                 options.bump = 'minor';
                 break;
-            case '--major':
+            case '-major':
                 options.bump = 'major';
                 break;
-            case '--nopublish':
+            case '-nopublish':
             case '-np':
-            case '--apply': // Keep for backward compatibility
+            case '-apply': // Keep for backward compatibility
                 options.noPublish = true;
+                options.explicitKeys.add('noPublish');
                 break;
-            case '--cleanup':
+            case '-cleanup':
                 options.cleanup = true;
                 break;
-            case '--install':
+            case '-local':
+                options.local = true;
+                options.explicitKeys.add('local');
+                break;
+            case '-install':
             case '-i':
                 options.install = true;
                 options.explicitKeys.add('install');
                 break;
-            case '--noinstall':
+            case '-noinstall':
             case '-ni':
                 options.install = false;
                 options.explicitKeys.add('install');
                 break;
-            case '--link':
+            case '-link':
                 options.link = true;
                 options.explicitKeys.add('link');
                 break;
-            case '--wsl':
+            case '-wsl':
                 options.wsl = true;
                 options.explicitKeys.add('wsl');
                 break;
-            case '--nowsl':
+            case '-nowsl':
                 options.wsl = false;
                 options.explicitKeys.add('wsl');
                 break;
-            case '--force':
+            case '-force':
                 options.force = true;
                 break;
-            case '--files':
+            case '-files':
                 options.files = true;
                 options.explicitKeys.add('files');
                 break;
-            case '--nofiles':
+            case '-nofiles':
                 options.files = false;
                 options.explicitKeys.add('files');
                 break;
-            case '--dry-run':
+            case '-dry-run':
                 options.dryRun = true;
                 break;
-            case '--quiet':
+            case '-quiet':
                 options.quiet = true;
                 break;
-            case '--verbose':
+            case '-verbose':
                 options.verbose = true;
                 options.quiet = false;
                 break;
-            case '--init':
+            case '-init':
                 options.init = true;
                 break;
-            case '--git':
+            case '-git':
                 i++;
                 if (args[i] === 'private' || args[i] === 'public') {
                     options.gitVisibility = args[i];
                     options.explicitKeys.add('gitVisibility');
                 }
                 else {
-                    options.error = `--git requires 'private' or 'public', got: ${args[i]}`;
+                    options.error = `-git requires 'private' or 'public', got: ${args[i]}`;
                 }
                 break;
-            case '--npm':
+            case '-npm':
                 i++;
                 if (args[i] === 'private' || args[i] === 'public') {
                     options.npmVisibility = args[i];
                     options.explicitKeys.add('npmVisibility');
                 }
                 else {
-                    options.error = `--npm requires 'private' or 'public', got: ${args[i]}`;
+                    options.error = `-npm requires 'private' or 'public', got: ${args[i]}`;
                 }
                 break;
-            case '--message':
+            case '-message':
             case '-m':
                 i++;
                 if (args[i]) {
                     options.message = args[i];
                 }
                 else {
-                    options.error = '-m/--message requires a commit message';
+                    options.error = '-m requires a commit message';
                 }
                 break;
-            case '--conform':
+            case '-conform':
                 options.conform = true;
                 break;
-            case '--asis':
+            case '-asis':
                 options.asis = true;
                 break;
-            case '--fix-tags':
+            case '-fix-tags':
                 options.fixTags = true;
                 break;
-            case '--rebase':
+            case '-rebase':
                 options.rebase = true;
                 break;
-            case '--show':
+            case '-show':
                 options.show = true;
                 break;
-            case '--update-deps':
+            case '-update-deps':
             case '-ud':
                 options.updateDeps = true;
                 break;
-            case '--update-major':
+            case '-update-major':
                 options.updateMajor = true;
-                options.updateDeps = true; // Implies --update-deps
+                options.updateDeps = true; // Implies -update-deps
                 break;
-            case '--publish-deps':
+            case '-publish-deps':
                 options.publishDeps = true; // Explicitly enable (though it's default)
                 break;
-            case '--no-publish-deps':
+            case '-no-publish-deps':
             case '-npd':
                 options.publishDeps = false; // Disable auto-publishing
                 break;
-            case '--force-publish':
+            case '-force-publish':
                 options.forcePublish = true;
                 break;
-            case '--fix':
+            case '-fix':
                 options.fix = true;
                 options.explicitKeys.add('fix');
                 break;
-            case '--no-fix':
+            case '-no-fix':
                 options.fix = false;
                 options.explicitKeys.add('fix');
                 break;
-            case '--workspace':
+            case '-workspace':
             case '-w':
                 i++;
                 if (args[i]) {
@@ -257,20 +269,20 @@ function parseArgs(args) {
                     options.workspaceFilter.push(args[i]);
                 }
                 else {
-                    options.error = '-w/--workspace requires a package name';
+                    options.error = '-w requires a package name';
                 }
                 break;
-            case '--no-workspace':
+            case '-no-workspace':
                 options.noWorkspace = true;
                 break;
-            case '--continue-on-error':
+            case '-continue-on-error':
                 options.continueOnError = true;
                 break;
-            case '--package':
+            case '-package':
             case '-pkg':
                 options.package = true;
                 break;
-            case '--once':
+            case '-once':
                 options.once = true;
                 break;
             default:
@@ -311,7 +323,7 @@ export async function main() {
     }
     if (cliOptions.error) {
         console.error(`Error: ${cliOptions.error}`);
-        console.error('Run with --help for usage.');
+        console.error('Run with -help for usage.');
         process.exit(1);
     }
     let cwd = process.cwd();

package/lib.d.ts

@@ -71,6 +71,8 @@ export interface GlobalizeOptions {
     package?: boolean;
     /** Don't persist CLI flags to .globalize.json5 */
     once?: boolean;
+    /** Local install only — skip transform/publish, just npm install -g . */
+    local?: boolean;
     /** Internal: signals this call is from workspace orchestrator */
     _fromWorkspace?: boolean;
     /** Internal: signals this call is from CLI (version already printed) */

package/lib.js

@@ -111,7 +111,7 @@ export function writeConfig(dir, config, explicitKeys) {
     const existing = readConfig(dir);
     // Filter out temporary flags and default values (unless explicitly set)
     const filtered = {};
-    const omitKeys = new Set(['noPublish', 'cleanup', 'init', 'dryRun', 'message', 'conform', 'asis', 'help', 'error', 'updateDeps', 'updateMajor', 'publishDeps', 'forcePublish', 'once']);
+    const omitKeys = new Set(['cleanup', 'init', 'dryRun', 'message', 'conform', 'asis', 'help', 'error', 'updateDeps', 'updateMajor', 'publishDeps', 'forcePublish', 'once']);
     for (const [key, value] of Object.entries(config)) {
         if (omitKeys.has(key))
             continue;
@@ -160,6 +160,10 @@ export function writeConfig(dir, config, explicitKeys) {
                 comment = '  // patch (default), minor, or major';
             else if (key === 'fix')
                 comment = '  // Auto-run npm audit fix';
+            else if (key === 'local')
+                comment = '  // Local install only (skip transform/publish)';
+            else if (key === 'noPublish')
+                comment = '  // Transform but don\'t publish';
             lines.push(`  "${key}": ${jsonValue}${comma}${comment}`);
         });
         lines.push('');
@@ -177,6 +181,8 @@ export function writeConfig(dir, config, explicitKeys) {
     lines.push('  // "gitVisibility": "private"   // Git repo: private or public');
     lines.push('  // "npmVisibility": "private"   // npm package: private or public');
     lines.push('  // "fix": false                 // Auto-run npm audit fix');
+    lines.push('  // "local": false              // Local install only (skip transform/publish)');
+    lines.push('  // "noPublish": false          // Transform but don\'t publish');
     lines.push('}');
     fs.writeFileSync(configPath, lines.join('\n') + '\n');
 }
@@ -1471,7 +1477,7 @@ export function getToolVersion() {
 }
 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
-    forcePublish = false, fix = false, fixTags = false, rebase = false, show = false } = options;
+    forcePublish = false, fix = false, fixTags = false, rebase = false, show = false, local = false } = options;
     // Show tool version only for recursive dep calls (CLI already prints it at startup)
     const toolVersion = getToolVersion();
     if (!options._fromWorkspace && !options._fromCli) {
@@ -1526,11 +1532,51 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
             settings.push('--force-publish');
         if (configOptions.show)
             settings.push('--show');
+        if (configOptions.local)
+            settings.push('-local');
         if (settings.length > 0) {
             console.log(colors.dim(`Settings from .globalize.json5: ${settings.join(', ')}`));
         }
     }
     console.log('');
+    // -local: skip all transform/publish, just install from local directory with file: deps intact
+    if (local) {
+        const pkg = readPackageJson(cwd);
+        const pkgName = pkg.name || path.basename(cwd);
+        const pkgVersion = pkg.version || '0.0.0';
+        console.log(colors.blue(`Local install: ${pkgName}@${pkgVersion}`));
+        console.log(colors.dim('Skipping transform/publish — installing with file: deps as-is'));
+        if (!pkg.bin) {
+            console.log(colors.yellow('Note: No bin field — this is a library, not a CLI tool.'));
+            console.log(colors.yellow('Running npm install -g . anyway (creates global link)...'));
+        }
+        if (dryRun) {
+            console.log('  [dry-run] Would run: npm install -g .');
+            if (wsl)
+                console.log('  [dry-run] Would run: wsl npm install -g .');
+            return true;
+        }
+        const result = runCommand('npm', ['install', '-g', '.'], { cwd, silent: false });
+        if (result.success) {
+            console.log(colors.green(`✓ Installed locally: ${pkgName}@${pkgVersion}`));
+        }
+        else {
+            console.error(colors.red(`✗ Local install failed`));
+            console.error(colors.yellow('  Try running manually: npm install -g .'));
+            return false;
+        }
+        if (wsl) {
+            console.log(`Installing ${pkgName} in WSL (local)...`);
+            const wslResult = runCommand('wsl', ['npm', 'install', '-g', '.'], { cwd, silent: false });
+            if (wslResult.success) {
+                console.log(colors.green(`✓ Installed in WSL: ${pkgName}@${pkgVersion}`));
+            }
+            else {
+                console.error(colors.yellow('✗ WSL install failed (is npm installed in WSL?)'));
+            }
+        }
+        return true;
+    }
     // Check ignore files first (unless cleanup mode)
     if (!cleanup && !asis) {
         const checkResult = checkIgnoreFiles(cwd, { conform, asis, verbose });
@@ -2088,11 +2134,37 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
     }
     if (noPublish) {
         console.log('Transform complete (--nopublish mode).');
+        if (files && transformResult.transformed) {
+            console.log('Restoring file: dependencies...');
+            const finalPkg = readPackageJson(cwd);
+            restoreDeps(finalPkg, verbose);
+            if (!dryRun) {
+                writePackageJson(cwd, finalPkg);
+                runCommand('git', ['add', 'package.json'], { cwd });
+                runCommand('git', ['commit', '-m', 'Restore file: dependencies'], { cwd });
+                if (currentGitStatus.hasRemote) {
+                    runCommand('git', ['push'], { cwd });
+                }
+            }
+        }
         return true;
     }
     // Skip if private
     if (pkg.private) {
         console.log('Package is private - skipping npm publish.');
+        if (files && transformResult.transformed) {
+            console.log('Restoring file: dependencies...');
+            const finalPkg = readPackageJson(cwd);
+            restoreDeps(finalPkg, verbose);
+            if (!dryRun) {
+                writePackageJson(cwd, finalPkg);
+                runCommand('git', ['add', 'package.json'], { cwd });
+                runCommand('git', ['commit', '-m', 'Restore file: dependencies'], { cwd });
+                if (currentGitStatus.hasRemote) {
+                    runCommand('git', ['push'], { cwd });
+                }
+            }
+        }
         return true;
     }
     // Re-check git status after all transformations and potential commits

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/npmglobalize",
-  "version": "1.0.88",
+  "version": "1.0.89",
   "description": "Transform file: dependencies to npm versions for publishing",
   "main": "index.js",
   "type": "module",