@common-stack/common-tools 8.2.4-alpha.11

package/LICENSE

@@ -0,0 +1,34 @@
+PROPRIETARY LICENSE
+
+Copyright (c) 2017-2025 CDMBase LLC. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are the 
+proprietary and confidential information of CDMBase LLC ("Confidential Information").
+
+NOTICE: All information contained herein is, and remains the property of 
+CDMBase LLC. The intellectual and technical concepts contained herein are 
+proprietary to CDMBase LLC and may be covered by U.S. and Foreign Patents, 
+patents in process, and are protected by trade secret or copyright law.
+
+Dissemination of this information or reproduction of this material is strictly 
+forbidden unless prior written permission is obtained from CDMBase LLC.
+
+NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL 
+PROPERTY RIGHTS ARE GRANTED BY THIS DOCUMENT.
+
+RESTRICTIONS:
+1. You may NOT use, copy, modify, merge, publish, distribute, sublicense, 
+   and/or sell copies of the Software without explicit written permission 
+   from CDMBase LLC.
+2. You may NOT reverse engineer, decompile, or disassemble the Software.
+3. You may NOT remove or alter any proprietary notices or labels on the Software.
+4. The Software is licensed, not sold.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+CDMBASE LLC BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN 
+AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For licensing inquiries, please contact: legal@cdmbase.com

package/README.md

@@ -0,0 +1,186 @@
+# @common-stack/common-tools
+
+Common CLI tools for monorepo management. All tools read their configuration from `cdecode-config.json` in your repository root.
+
+## Installation
+
+```bash
+yarn add -D @common-stack/common-tools
+```
+
+## Available Commands
+
+### generate-resolutions
+
+Generate yarn resolutions for servers to prevent version conflicts in monorepo setups.
+
+```bash
+# Process backend servers (default)
+npx generate-resolutions
+
+# Process all server categories
+npx generate-resolutions --category all
+
+# Preview without writing
+npx generate-resolutions --dry-run
+
+# Add additional packages to track
+npx generate-resolutions --packages "@aws-sdk/client-dynamodb,lodash"
+```
+
+**Configuration in `cdecode-config.json`:**
+
+```json
+{
+    "updateDependencies": {
+        "packagePaths": {
+            "backend": ["servers/backend-server/package.json"],
+            "frontend": ["servers/frontend-server/package.json"],
+            "mobile": ["portable-devices/mobile/package.json"]
+        }
+    }
+}
+```
+
+### update-dependencies
+
+Update dependencies from @common-stack packages across your servers.
+
+```bash
+# Run full update workflow
+npx update-dependencies
+
+# Skip ncu step
+npx update-dependencies --skip-ncu
+
+# Custom packages to check
+npx update-dependencies --packages "@common-stack/server-stack"
+```
+
+**Configuration in `cdecode-config.json`:**
+
+```json
+{
+    "updateDependencies": {
+        "packagesToCheck": ["@common-stack/server-stack", "@common-stack/frontend-stack-react"],
+        "packagePaths": {
+            "backend": ["servers/backend-server/package.json"],
+            "frontend": ["servers/frontend-server/package.json"]
+        }
+    }
+}
+```
+
+### sort-package-json
+
+Sort all package.json files in the monorepo for consistent formatting.
+
+```bash
+# Sort all package.json files
+npx sort-package-json
+
+# Preview changes
+npx sort-package-json --dry-run
+
+# Custom directories
+npx sort-package-json --directories "packages,servers"
+```
+
+**Configuration in `cdecode-config.json`:**
+
+```json
+{
+    "sortPackageJson": {
+        "directories": [".", "packages", "packages-modules", "servers"],
+        "skipNodeModules": true
+    }
+}
+```
+
+### update-dependency-version
+
+Update internal monorepo package versions and resolve `link:` references.
+
+```bash
+# Update all versions
+npx update-dependency-version
+
+# Preview changes
+npx update-dependency-version --dry-run
+
+# Show commit command after update
+npx update-dependency-version --commit
+```
+
+**Configuration in `cdecode-config.json`:**
+
+```json
+{
+    "updateDependencyVersion": {
+        "roots": ["servers", "portable-devices", "packages", "packages-modules"],
+        "ignorePattern": "**/node_modules/**",
+        "jsonSpacing": 4,
+        "addEndNewLine": true,
+        "commitMessage": "Updated packages to use correct versions"
+    }
+}
+```
+
+## Using the Main CLI
+
+You can also use all commands through the main `common-tools` CLI:
+
+```bash
+npx common-tools generate-resolutions --help
+npx common-tools update-dependencies --help
+npx common-tools sort-package-json --help
+npx common-tools update-dependency-version --help
+```
+
+## Adding to package.json Scripts
+
+```json
+{
+    "scripts": {
+        "generate-resolutions": "generate-resolutions",
+        "generate-resolutions:all": "generate-resolutions --category all",
+        "generate-resolutions:dry": "generate-resolutions --dry-run",
+        "update-deps": "update-dependencies",
+        "sort-packages": "sort-package-json",
+        "update-versions": "update-dependency-version"
+    }
+}
+```
+
+## Programmatic Usage
+
+```typescript
+import {
+    generateResolutionsFromCDecodeConfig,
+    loadConfigWithDefaults,
+    updateDependencyVersions,
+    sortPackageJsonFile,
+} from '@common-stack/common-tools';
+
+// Load config from cdecode-config.json
+const { config, repoRoot } = loadConfigWithDefaults();
+
+// Generate resolutions
+const results = generateResolutionsFromCDecodeConfig(repoRoot, {
+    category: 'backend',
+    dryRun: false,
+});
+
+// Update versions
+const modifiedFiles = await updateDependencyVersions(repoRoot, {
+    dryRun: false,
+    config: config.updateDependencyVersion,
+});
+
+// Sort a single package.json
+await sortPackageJsonFile('/path/to/package.json');
+```
+
+## License
+
+UNLICENSED - CDMBase LLC

package/bin/common-tools.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * Main CLI entry point for common-tools
+ *
+ * Provides access to all tools in a single command:
+ *   common-tools <command> [options]
+ */
+
+import { Command } from 'commander';
+import { createGenerateResolutionsCommand } from '../lib/cli/generateResolutions.js';
+import { createUpdateDependenciesCommand } from '../lib/cli/updateDependencies.js';
+import { createSortPackageJsonCommand } from '../lib/cli/sortPackageJson.js';
+import { createUpdateDependencyVersionCommand } from '../lib/cli/updateDependencyVersion.js';
+
+const program = new Command();
+
+program.name('common-tools').description('Common CLI tools for monorepo management').version('8.2.4-alpha.5');
+
+// Add all subcommands
+program.addCommand(createGenerateResolutionsCommand());
+program.addCommand(createUpdateDependenciesCommand());
+program.addCommand(createSortPackageJsonCommand());
+program.addCommand(createUpdateDependencyVersionCommand());
+
+// Parse and execute
+program.parse();

package/bin/generate-resolutions.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * Standalone CLI for generate-resolutions
+ *
+ * Generate yarn resolutions for servers based on cdecode-config.json
+ *
+ * Usage:
+ *   generate-resolutions [options]
+ *
+ * Options:
+ *   -c, --category <type>  Category: backend, frontend, mobile, all (default: backend)
+ *   --dry-run              Preview changes without writing
+ *   -p, --packages <list>  Additional packages to track (comma-separated)
+ *   -r, --root <path>      Repository root path (auto-detected)
+ */
+
+import { runGenerateResolutionsCLI } from '../lib/cli/generateResolutions.js';
+
+runGenerateResolutionsCLI().catch((error) => {
+    console.error('Error:', error.message);
+    process.exit(1);
+});

package/bin/sort-package-json.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * Standalone CLI for sort-package-json
+ *
+ * Sort package.json files in the monorepo
+ * Reads configuration from cdecode-config.json
+ *
+ * Usage:
+ *   sort-package-json [options]
+ *
+ * Options:
+ *   -r, --root <path>         Repository root path (auto-detected)
+ *   -d, --directories <list>  Directories to process (comma-separated)
+ *   --no-recursive            Do not process subdirectories
+ *   --dry-run                 Preview changes without writing
+ */
+
+import { runSortPackageJsonCLI } from '../lib/cli/sortPackageJson.js';
+
+runSortPackageJsonCLI().catch((error) => {
+    console.error('Error:', error.message);
+    process.exit(1);
+});

package/bin/update-dependencies.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * Standalone CLI for update-dependencies
+ *
+ * Update dependencies from @common-stack packages
+ * Reads configuration from cdecode-config.json
+ *
+ * Usage:
+ *   update-dependencies [options]
+ *
+ * Options:
+ *   -r, --root <path>      Repository root path (auto-detected)
+ *   -p, --packages <list>  Packages to check (comma-separated)
+ *   --skip-ncu             Skip npm-check-updates step
+ *   --skip-yarn            Skip yarn install step
+ */
+
+import { runUpdateDependenciesCLI } from '../lib/cli/updateDependencies.js';
+
+runUpdateDependenciesCLI().catch((error) => {
+    console.error('Error:', error.message);
+    process.exit(1);
+});

package/bin/update-dependency-version.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * Standalone CLI for update-dependency-version
+ *
+ * Update dependency versions across monorepo packages
+ * Reads configuration from cdecode-config.json
+ *
+ * Usage:
+ *   update-dependency-version [options]
+ *
+ * Options:
+ *   -r, --root <path>  Repository root path (auto-detected)
+ *   --commit           Commit changes after updating
+ *   --dry-run          Preview changes without writing
+ */
+
+import { runUpdateDependencyVersionCLI } from '../lib/cli/updateDependencyVersion.js';
+
+runUpdateDependencyVersionCLI().catch((error) => {
+    console.error('Error:', error.message);
+    process.exit(1);
+});

package/lib/cli/generateResolutions.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CLI for generating package resolutions
+ *
+ * Reads configuration from cdecode-config.json:
+ * - updateDependencies.packagePaths: Server package.json paths by category
+ */
+import { Command } from 'commander';
+export interface GenerateResolutionsOptions {
+    category: 'backend' | 'frontend' | 'mobile' | 'all';
+    dryRun: boolean;
+    packages: string[];
+}
+/**
+ * Creates the generate-resolutions command
+ */
+export declare function createGenerateResolutionsCommand(): Command;
+/**
+ * Runs the resolution generation process
+ */
+export declare function runGenerateResolutions(repoRoot: string, options: GenerateResolutionsOptions): Promise<void>;
+/**
+ * Standalone CLI entry point
+ */
+export declare function runGenerateResolutionsCLI(args?: string[]): Promise<void>;
+//# sourceMappingURL=generateResolutions.d.ts.map

package/lib/cli/generateResolutions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateResolutions.d.ts","sourceRoot":"","sources":["../../src/cli/generateResolutions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,MAAM,WAAW,0BAA0B;IACvC,QAAQ,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpD,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,OAAO,CAgC1D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBjH;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5F"}

package/lib/cli/generateResolutions.js

@@ -0,0 +1,75 @@
+import { Command } from 'commander';
+import { generateResolutionsFromCDecodeConfig } from '@common-stack/rollup-vite-utils';
+import { loadConfigWithDefaults } from '../config/loader.js';
+
+/**
+ * CLI for generating package resolutions
+ *
+ * Reads configuration from cdecode-config.json:
+ * - updateDependencies.packagePaths: Server package.json paths by category
+ */
+/**
+ * Creates the generate-resolutions command
+ */
+function createGenerateResolutionsCommand() {
+    const command = new Command('generate-resolutions')
+        .description('Generate yarn resolutions for servers based on cdecode-config.json')
+        .option('-c, --category <type>', 'Category to process: backend, frontend, mobile, all', 'backend')
+        .option('--dry-run', 'Preview changes without writing', false)
+        .option('-p, --packages <list>', 'Additional packages to track (comma-separated)', (val) => val.split(',').map((p) => p.trim()), [])
+        .option('-r, --root <path>', 'Repository root path (auto-detected from cdecode-config.json)')
+        .action(async (options) => {
+        // Auto-detect repo root from cdecode-config.json if not specified
+        let repoRoot = options.root;
+        if (!repoRoot) {
+            try {
+                const { repoRoot: detectedRoot } = loadConfigWithDefaults();
+                repoRoot = detectedRoot;
+            }
+            catch {
+                repoRoot = process.cwd();
+            }
+        }
+        await runGenerateResolutions(repoRoot, {
+            category: options.category,
+            dryRun: options.dryRun,
+            packages: options.packages,
+        });
+    });
+    return command;
+}
+/**
+ * Runs the resolution generation process
+ */
+async function runGenerateResolutions(repoRoot, options) {
+    const { category, dryRun, packages: additionalPackages } = options;
+    console.log(`\n📁 Repo root: ${repoRoot}`);
+    console.log(`📋 Processing ${category} servers from cdecode-config.json`);
+    if (dryRun) {
+        console.log('🔍 Dry run mode - no files will be modified\n');
+    }
+    try {
+        const results = generateResolutionsFromCDecodeConfig(repoRoot, {
+            category,
+            dryRun,
+            additionalConflictPackages: additionalPackages,
+        });
+        if (results.size === 0) {
+            console.log('\n⚠️  No servers were processed. Check your cdecode-config.json');
+        }
+    }
+    catch (error) {
+        console.error('❌ Error:', error.message);
+        process.exit(1);
+    }
+}
+/**
+ * Standalone CLI entry point
+ */
+async function runGenerateResolutionsCLI(args = process.argv) {
+    const program = createGenerateResolutionsCommand();
+    await program.parseAsync(args);
+}
+
+export { createGenerateResolutionsCommand, runGenerateResolutions, runGenerateResolutionsCLI };
+//# sourceMappingURL=generateResolutions.js.map

package/lib/cli/generateResolutions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateResolutions.js","sources":["../../src/cli/generateResolutions.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAAA;;;;;AAKG;AAaH;;AAEG;SACa,gCAAgC,GAAA;AAC5C,IAAA,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,sBAAsB;SAC7C,WAAW,CAAC,oEAAoE;AAChF,SAAA,MAAM,CAAC,uBAAuB,EAAE,qDAAqD,EAAE,SAAS;AAChG,SAAA,MAAM,CAAC,WAAW,EAAE,iCAAiC,EAAE,KAAK;AAC5D,SAAA,MAAM,CACH,uBAAuB,EACvB,gDAAgD,EAChD,CAAC,GAAW,KAAK,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EACpD,EAAE;AAEL,SAAA,MAAM,CAAC,mBAAmB,EAAE,+DAA+D;AAC3F,SAAA,MAAM,CAAC,OAAO,OAAO,KAAI;;AAEtB,QAAA,IAAI,QAAQ,GAAG,OAAO,CAAC,IAAI;QAC3B,IAAI,CAAC,QAAQ,EAAE;AACX,YAAA,IAAI;gBACA,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,sBAAsB,EAAE;gBAC3D,QAAQ,GAAG,YAAY;YAC3B;AAAE,YAAA,MAAM;AACJ,gBAAA,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;YAC5B;QACJ;QAEA,MAAM,sBAAsB,CAAC,QAAQ,EAAE;YACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;AAC7B,SAAA,CAAC;AACN,IAAA,CAAC,CAAC;AAEN,IAAA,OAAO,OAAO;AAClB;AAEA;;AAEG;AACI,eAAe,sBAAsB,CAAC,QAAgB,EAAE,OAAmC,EAAA;IAC9F,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO;AAElE,IAAA,OAAO,CAAC,GAAG,CAAC,mBAAmB,QAAQ,CAAA,CAAE,CAAC;AAC1C,IAAA,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAA,iCAAA,CAAmC,CAAC;IAEzE,IAAI,MAAM,EAAE;AACR,QAAA,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC;IAChE;AAEA,IAAA,IAAI;AACA,QAAA,MAAM,OAAO,GAAG,oCAAoC,CAAC,QAAQ,EAAE;YAC3D,QAAQ;YACR,MAAM;AACN,YAAA,0BAA0B,EAAE,kBAAkB;AACjD,SAAA,CAAC;AAEF,QAAA,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE;AACpB,YAAA,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC;QAClF;IACJ;IAAE,OAAO,KAAK,EAAE;QACZ,OAAO,CAAC,KAAK,CAAC,UAAU,EAAG,KAAe,CAAC,OAAO,CAAC;AACnD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACnB;AACJ;AAEA;;AAEG;AACI,eAAe,yBAAyB,CAAC,IAAA,GAAiB,OAAO,CAAC,IAAI,EAAA;AACzE,IAAA,MAAM,OAAO,GAAG,gCAAgC,EAAE;AAClD,IAAA,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;AAClC;;;;"}

package/lib/cli/sortPackageJson.d.ts

@@ -0,0 +1,42 @@
+/**
+ * CLI for sorting package.json files
+ *
+ * Reads configuration from cdecode-config.json:
+ * - sortPackageJson.directories: Directories to process
+ * - sortPackageJson.skipNodeModules: Skip node_modules directories
+ */
+import { Command } from 'commander';
+export interface SortPackageJsonOptions {
+    directories?: string[];
+    recursive?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * Creates the sort-package-json command
+ */
+export declare function createSortPackageJsonCommand(): Command;
+/**
+ * Sorts a single package.json file
+ */
+export declare function sortPackageJsonFile(filePath: string, options?: {
+    dryRun?: boolean;
+}): Promise<boolean>;
+/**
+ * Recursively sorts all package.json files in a directory
+ */
+export declare function sortAllPackageJsonFiles(dir: string, options?: {
+    dryRun?: boolean;
+}): Promise<{
+    sorted: string[];
+    unchanged: string[];
+    errors: string[];
+}>;
+/**
+ * Runs the sort package.json process
+ */
+export declare function runSortPackageJson(rootDir: string, options: SortPackageJsonOptions): Promise<void>;
+/**
+ * Standalone CLI entry point
+ */
+export declare function runSortPackageJsonCLI(args?: string[]): Promise<void>;
+//# sourceMappingURL=sortPackageJson.d.ts.map

package/lib/cli/sortPackageJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortPackageJson.d.ts","sourceRoot":"","sources":["../../src/cli/sortPackageJson.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,MAAM,WAAW,sBAAsB;IACnC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,OAAO,CAqCtD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBhH;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiCtE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDxG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxF"}

package/lib/cli/sortPackageJson.js

@@ -0,0 +1,163 @@
+import { Command } from 'commander';
+import { promises } from 'fs';
+import path from 'path';
+import sortPackageJsonLib from 'sort-package-json';
+import { loadConfigWithDefaults, resolveConfigPaths } from '../config/loader.js';
+
+/**
+ * CLI for sorting package.json files
+ *
+ * Reads configuration from cdecode-config.json:
+ * - sortPackageJson.directories: Directories to process
+ * - sortPackageJson.skipNodeModules: Skip node_modules directories
+ */
+/**
+ * Creates the sort-package-json command
+ */
+function createSortPackageJsonCommand() {
+    const command = new Command('sort-package-json')
+        .description('Sort package.json files in the monorepo (reads from cdecode-config.json)')
+        .option('-r, --root <path>', 'Repository root path (auto-detected from cdecode-config.json)')
+        .option('-d, --directories <list>', 'Directories to process (comma-separated, overrides cdecode-config.json)', (val) => val.split(',').map((p) => p.trim()))
+        .option('--no-recursive', 'Do not process subdirectories', true)
+        .option('--dry-run', 'Preview changes without writing', false)
+        .action(async (options) => {
+        // Load config from cdecode-config.json
+        let repoRoot = options.root;
+        let configDirectories;
+        try {
+            const { config, repoRoot: detectedRoot } = loadConfigWithDefaults(options.root);
+            const resolvedConfig = resolveConfigPaths(config, detectedRoot);
+            repoRoot = detectedRoot;
+            configDirectories = resolvedConfig.sortPackageJson?.directories;
+            console.log(`📄 Loaded configuration from cdecode-config.json`);
+        }
+        catch (error) {
+            if (!options.root) {
+                console.warn('⚠️  Could not find cdecode-config.json, using defaults');
+                repoRoot = process.cwd();
+            }
+        }
+        await runSortPackageJson(repoRoot, {
+            directories: options.directories || configDirectories,
+            recursive: options.recursive !== false,
+            dryRun: options.dryRun,
+        });
+    });
+    return command;
+}
+/**
+ * Sorts a single package.json file
+ */
+async function sortPackageJsonFile(filePath, options = {}) {
+    try {
+        const content = await promises.readFile(filePath, 'utf8');
+        const packageJson = JSON.parse(content);
+        const sortedPackageJson = sortPackageJsonLib(packageJson);
+        const sortedContent = JSON.stringify(sortedPackageJson, null, 2) + '\n';
+        if (content !== sortedContent) {
+            if (!options.dryRun) {
+                await promises.writeFile(filePath, sortedContent);
+            }
+            return true;
+        }
+        return false;
+    }
+    catch (error) {
+        console.error(`Error sorting ${filePath}:`, error);
+        return false;
+    }
+}
+/**
+ * Recursively sorts all package.json files in a directory
+ */
+async function sortAllPackageJsonFiles(dir, options = {}) {
+    const result = { sorted: [], unchanged: [], errors: [] };
+    async function walk(currentDir) {
+        try {
+            const files = await promises.readdir(currentDir);
+            for (const file of files) {
+                const fullPath = path.join(currentDir, file);
+                const stat = await promises.lstat(fullPath);
+                if (stat.isDirectory() && file !== 'node_modules') {
+                    await walk(fullPath);
+                }
+                else if (file === 'package.json') {
+                    try {
+                        const changed = await sortPackageJsonFile(fullPath, options);
+                        if (changed) {
+                            result.sorted.push(fullPath);
+                        }
+                        else {
+                            result.unchanged.push(fullPath);
+                        }
+                    }
+                    catch {
+                        result.errors.push(fullPath);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.warn(`Error walking directory ${currentDir}:`, error);
+        }
+    }
+    await walk(dir);
+    return result;
+}
+/**
+ * Runs the sort package.json process
+ */
+async function runSortPackageJson(rootDir, options) {
+    const { dryRun = false } = options;
+    console.log(`\n📁 Repo root: ${rootDir}`);
+    if (dryRun) {
+        console.log('🔍 Dry run mode - no files will be modified\n');
+    }
+    // Default directories if not specified
+    const directories = options.directories || [
+        rootDir,
+        path.join(rootDir, 'packages'),
+        path.join(rootDir, 'packages-modules'),
+        path.join(rootDir, 'servers'),
+        path.join(rootDir, 'portable-devices'),
+    ];
+    const totalResult = { sorted: [], unchanged: [], errors: [] };
+    for (const dir of directories) {
+        try {
+            await promises.access(dir);
+            console.log(`📂 Processing ${dir}...`);
+            const result = await sortAllPackageJsonFiles(dir, { dryRun });
+            totalResult.sorted.push(...result.sorted);
+            totalResult.unchanged.push(...result.unchanged);
+            totalResult.errors.push(...result.errors);
+        }
+        catch {
+            console.log(`⚠️  Directory not found: ${dir}`);
+        }
+    }
+    // Report results
+    console.log('\n📊 Results:');
+    if (totalResult.sorted.length > 0) {
+        console.log(`\n✅ ${dryRun ? 'Would sort' : 'Sorted'} ${totalResult.sorted.length} file(s):`);
+        totalResult.sorted.forEach((f) => console.log(`   - ${path.relative(rootDir, f)}`));
+    }
+    if (totalResult.unchanged.length > 0) {
+        console.log(`\n📄 ${totalResult.unchanged.length} file(s) already sorted`);
+    }
+    if (totalResult.errors.length > 0) {
+        console.log(`\n❌ ${totalResult.errors.length} error(s):`);
+        totalResult.errors.forEach((f) => console.log(`   - ${path.relative(rootDir, f)}`));
+    }
+    console.log('');
+}
+/**
+ * Standalone CLI entry point
+ */
+async function runSortPackageJsonCLI(args = process.argv) {
+    const program = createSortPackageJsonCommand();
+    await program.parseAsync(args);
+}
+
+export { createSortPackageJsonCommand, runSortPackageJson, runSortPackageJsonCLI, sortAllPackageJsonFiles, sortPackageJsonFile };
+//# sourceMappingURL=sortPackageJson.js.map

package/lib/cli/sortPackageJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortPackageJson.js","sources":["../../src/cli/sortPackageJson.ts"],"sourcesContent":[null],"names":["fsPromises"],"mappings":"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"}