@simplysm/sd-cli 12.16.31 → 12.16.35

package/README.md

@@ -6,348 +6,214 @@ Build, check, publish, and deploy tool for Simplysm monorepo projects. Provides
 
 ```bash
 npm install @simplysm/sd-cli
-# or
-yarn add @simplysm/sd-cli
 ```
 
-## Project Configuration
-
-sd-cli reads a JavaScript config file (default: `simplysm.js`) at the project root. The file must export a default function that returns an `ISdProjectConfig` object.
-
-```js
-// simplysm.js
-export default (isDev, options) => ({
-  packages: {
-    "my-core": {
-      type: "library",
-      publish: "npm",
-    },
-    "my-server": {
-      type: "server",
-      publish: {
-        type: "sftp",
-        host: "example.com",
-        user: "deploy",
-        pass: process.env.DEPLOY_PASS,
-      },
-    },
-    "my-client": {
-      type: "client",
-      server: "my-server",
-      builder: {
-        web: {},
-        electron: {
-          appId: "com.example.myapp",
-        },
-        capacitor: {
-          appId: "com.example.myapp",
-          appName: "My App",
-          platform: { android: {} },
-        },
-      },
-    },
-  },
-  localUpdates: {
-    "@someorg/*": "C:/libs/someorg/*/dist",
-  },
-  postPublish: [
-    { type: "script", cmd: "echo", args: ["done"] },
-  ],
-});
-```
+This is a CLI-only package with no library API exports. All functionality is accessed through the `sd-cli` command.
 
-### ISdProjectConfig
-
-| Property | Type | Description |
-|---|---|---|
-| `packages` | `Record<string, TSdPackageConfig>` | Package name to config mapping. Keys must match workspace directory names. |
-| `localUpdates` | `Record<string, string>` | Glob-to-path mapping for syncing local library builds into `node_modules`. |
-| `postPublish` | `TSdPostPublishConfig[]` | Scripts to run after all packages are published. Supports `%SD_VERSION%` and `%SD_PROJECT_PATH%` placeholders. |
-
-### Package Types
-
-#### Library (`type: "library"`)
-
-| Property | Type | Default | Description |
-|---|---|---|---|
-| `type` | `"library"` | | Package type identifier. |
-| `publish` | `"npm"` | | Publish to npm registry. |
-| `polyfills` | `string[]` | | Modules to include as polyfills. |
-| `index` | `{ excludes?: string[] } \| false` | | Auto-generated `index.ts` config. Set `false` to disable. |
-| `dbContext` | `string` | | Database context class name for auto-generated DB context file. |
-| `forceProductionMode` | `boolean` | | Force production mode regardless of dev/prod flag. |
-
-#### Server (`type: "server"`)
-
-| Property | Type | Default | Description |
-|---|---|---|---|
-| `type` | `"server"` | | Package type identifier. |
-| `publish` | `ISdLocalDirectoryPublishConfig \| ISdFtpPublishConfig` | | Deploy target configuration. |
-| `externals` | `string[]` | | Modules to exclude from the server bundle. |
-| `configs` | `Record<string, any>` | | Arbitrary config values injected at build time. |
-| `env` | `Record<string, string>` | | Environment variables set during build. |
-| `forceProductionMode` | `boolean` | | Force production mode. |
-| `pm2` | `object` | | PM2 process manager settings (`name`, `ignoreWatchPaths`, `noInterpreter`, `noStartScript`). |
-| `iis` | `object` | | IIS hosting settings (`nodeExeFilePath`). |
-
-#### Client (`type: "client"`)
-
-| Property | Type | Default | Description |
-|---|---|---|---|
-| `type` | `"client"` | | Package type identifier. |
-| `server` | `string \| { port: number }` | | Server package name to proxy to, or a fixed port. |
-| `publish` | `ISdLocalDirectoryPublishConfig \| ISdFtpPublishConfig` | | Deploy target configuration. |
-| `env` | `Record<string, string>` | | Environment variables set during build. |
-| `configs` | `Record<string, any>` | | Arbitrary config values injected at build time. |
-| `noLazyRoute` | `boolean` | | Disable automatic lazy route generation. |
-| `forceProductionMode` | `boolean` | | Force production mode. |
-| `builder.web` | `ISdClientBuilderWebConfig` | | Web build options (environment variables). |
-| `builder.electron` | `ISdClientBuilderElectronConfig` | | Electron desktop build options. |
-| `builder.capacitor` | `ISdClientBuilderCapacitorConfig` | | Capacitor mobile build options. |
-| `builder.cordova` | `ISdClientBuilderCordovaConfig` | | **(Deprecated)** Cordova mobile build options. |
-
-### Publish Targets
-
-**Local Directory**
-```js
-{ type: "local-directory", path: "C:/deploy/%SD_VERSION%" }
-```
+## CLI Overview
 
-**FTP / FTPS / SFTP**
-```js
-{ type: "sftp", host: "example.com", port: 22, path: "/var/www", user: "deploy", pass: "secret" }
-```
+| Command | Description |
+|---------|-------------|
+| `local-update` | Performs local library update |
+| `watch` | Watch-builds packages in development mode |
+| `build` | Production build for packages |
+| `check [path]` | Runs typecheck and/or lint |
+| `publish` | Builds and publishes packages to npm |
+| `run-electron <package>` | Launches a watch-built platform as an Electron app |
+| `build-electron-for-dev <package>` | Builds an Electron app for dev testing |
+| `run-cordova <platform> <package> [url]` | Deploys to a Cordova device |
+| `run-capacitor <platform> <package> [url]` | Deploys to a Capacitor device |
+| `commit` | AI-assisted commit message generation, commit, and push |
+| `postinstall` | Runs post-install tasks automatically |
 
-**npm**
-```js
-"npm"
-```
+## Global Options
 
-## CLI Commands
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `--help`, `-h` | boolean | -- | Show help |
+| `--debug` | boolean | `false` | Enable debug-level logging |
 
-All commands support the `--debug` flag for verbose logging and `--config <path>` to specify a config file (default: `simplysm.js`).
+## CLI Reference
 
-### watch
+### `local-update`
 
-Watch-build all configured packages with incremental compilation.
+Performs local library update using linked packages.
 
 ```bash
-sd-cli watch [options]
+sd-cli local-update [--config <path>] [--options <values...>]
 ```
 
 | Option | Type | Default | Description |
-|---|---|---|---|
-| `--config` | `string` | `simplysm.js` | Config file path. |
-| `--options` | `string[]` | | Custom options passed to the config function. |
-| `--packages` | `string[]` | | Filter to specific packages by name. |
-| `--emitOnly` | `boolean` | `false` | Emit output only (skip type checking). |
-| `--noEmit` | `boolean` | `false` | Type check only (skip output emission). |
-
-```bash
-# Watch all packages
-sd-cli watch
+|--------|------|---------|-------------|
+| `--config` | string | `simplysm.js` | Configuration file path |
+| `--options` | string[] | -- | Additional option settings |
 
-# Watch a specific package
-sd-cli watch --packages sd-angular
+### `watch`
 
-# Emit only (faster, no checks)
-sd-cli watch --emitOnly
+Watch-builds all or selected packages for development.
 
-# Check only (no emit)
-sd-cli watch --noEmit
+```bash
+sd-cli watch [--config <path>] [--packages <names...>] [--emitOnly] [--noEmit] [--options <values...>]
 ```
 
-### build
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `--config` | string | `simplysm.js` | Configuration file path |
+| `--packages` | string[] | -- | Specific packages to watch |
+| `--emitOnly` | boolean | `false` | Only emit output (skip checks) |
+| `--noEmit` | boolean | `false` | Only check (skip emit) |
+| `--options` | string[] | -- | Additional option settings |
 
-Production build for all configured packages. Automatically increments the patch version.
+### `build`
+
+Production build for all or selected packages.
 
 ```bash
-sd-cli build [options]
+sd-cli build [--config <path>] [--packages <names...>] [--options <values...>]
 ```
 
 | Option | Type | Default | Description |
-|---|---|---|---|
-| `--config` | `string` | `simplysm.js` | Config file path. |
-| `--options` | `string[]` | | Custom options passed to the config function. |
-| `--packages` | `string[]` | | Filter to specific packages by name. |
+|--------|------|---------|-------------|
+| `--config` | string | `simplysm.js` | Configuration file path |
+| `--packages` | string[] | -- | Specific packages to build |
+| `--options` | string[] | -- | Additional option settings |
 
-### check
+### `check [path]`
 
-Run type checking and/or linting on packages.
+Runs typecheck and/or lint on the project or a specific package path.
 
 ```bash
-sd-cli check [path] [options]
+sd-cli check [path] [--config <path>] [--type <lint|typecheck>] [--options <values...>]
 ```
 
 | Option | Type | Default | Description |
-|---|---|---|---|
-| `[path]` | `string` | | Package directory or file path to check. If omitted, checks all packages. |
-| `--config` | `string` | `simplysm.js` | Config file path. |
-| `--options` | `string[]` | | Custom options passed to the config function. |
-| `--type` | `"lint" \| "typecheck"` | *(both)* | Run only lint or only typecheck. |
-
-```bash
-# Check all packages (typecheck + lint)
-sd-cli check
+|--------|------|---------|-------------|
+| `path` | string | -- | Package path or file path (positional) |
+| `--config` | string | `simplysm.js` | Configuration file path |
+| `--type` | `"lint"` \| `"typecheck"` | -- | Check type (omit for both) |
+| `--options` | string[] | -- | Additional option settings |
 
-# Check a specific package
-sd-cli check packages/sd-core-common
+### `publish`
 
-# Lint only
-sd-cli check --type lint
+Builds and publishes packages to npm.
 
-# Typecheck only
-sd-cli check --type typecheck
+```bash
+sd-cli publish [--noBuild] [--config <path>] [--packages <names...>] [--options <values...>]
 ```
 
-### publish
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `--noBuild` | boolean | `false` | Publish without rebuilding |
+| `--config` | string | `simplysm.js` | Configuration file path |
+| `--packages` | string[] | -- | Specific packages to publish |
+| `--options` | string[] | -- | Additional option settings |
 
-Build and publish all configured packages. Handles version bumping, git tagging, and deployment to npm / FTP / local directory.
+### `run-electron <package>`
+
+Launches a watch-built platform as an Electron desktop application.
 
 ```bash
-sd-cli publish [options]
+sd-cli run-electron <package> [--config <path>] [--options <values...>]
 ```
 
 | Option | Type | Default | Description |
-|---|---|---|---|
-| `--config` | `string` | `simplysm.js` | Config file path. |
-| `--options` | `string[]` | | Custom options passed to the config function. |
-| `--packages` | `string[]` | | Filter to specific packages by name. |
-| `--noBuild` | `boolean` | `false` | Skip building before publishing (dangerous). |
-
-The publish workflow:
-1. Validates npm/yarn authentication tokens (for npm targets).
-2. Checks for uncommitted git changes.
-3. Increments the patch version across all workspace packages.
-4. Builds all packages.
-5. Creates a git commit and tag for the new version.
-6. Pushes to the remote repository.
-7. Publishes each package to its configured target.
-8. Runs `postPublish` scripts if configured.
-
-### local-update
-
-Copy local library builds into `node_modules` based on the `localUpdates` config.
+|--------|------|---------|-------------|
+| `package` | string | -- | Package name (required) |
+| `--config` | string | `simplysm.js` | Configuration file path |
+| `--options` | string[] | -- | Additional option settings |
+
+### `build-electron-for-dev <package>`
+
+Builds an Electron app from a watch-built platform for dev testing.
 
 ```bash
-sd-cli local-update [options]
+sd-cli build-electron-for-dev <package> [--config <path>] [--options <values...>]
 ```
 
 | Option | Type | Default | Description |
-|---|---|---|---|
-| `--config` | `string` | `simplysm.js` | Config file path. |
-| `--options` | `string[]` | | Custom options passed to the config function. |
+|--------|------|---------|-------------|
+| `package` | string | -- | Package name (required) |
+| `--config` | string | `simplysm.js` | Configuration file path |
+| `--options` | string[] | -- | Additional option settings |
 
-### run-electron
+### `run-cordova <platform> <package> [url]`
 
-Launch a watched client package as an Electron desktop app (development mode).
+Deploys a watch-built platform to a Cordova device as a webview app.
 
 ```bash
-sd-cli run-electron <package> [options]
+sd-cli run-cordova <platform> <package> [url]
 ```
 
 | Option | Type | Description |
-|---|---|---|
-| `<package>` | `string` | Package name (required). |
-| `--config` | `string` | Config file path. |
-| `--options` | `string[]` | Custom options passed to the config function. |
+|--------|------|-------------|
+| `platform` | string | Build platform (e.g., `android`) (required) |
+| `package` | string | Package name (required) |
+| `url` | string | URL to open in webview (required) |
 
-### build-electron-for-dev
+### `run-capacitor <platform> <package> [url]`
 
-Build an Electron installer from a watched client package (development build).
+Deploys a watch-built platform to a Capacitor device as a webview app.
 
 ```bash
-sd-cli build-electron-for-dev <package> [options]
+sd-cli run-capacitor <platform> <package> [url]
 ```
 
 | Option | Type | Description |
-|---|---|---|
-| `<package>` | `string` | Package name (required). |
-| `--config` | `string` | Config file path. |
-| `--options` | `string[]` | Custom options passed to the config function. |
+|--------|------|-------------|
+| `platform` | string | Build platform (e.g., `android`) (required) |
+| `package` | string | Package name (required) |
+| `url` | string | URL to open in webview (required) |
 
-### run-cordova *(deprecated)*
+### `commit`
 
-Deploy a watched client package to a Cordova device.
+Uses AI to generate a commit message from current changes, then commits and pushes.
 
 ```bash
-sd-cli run-cordova <platform> <package> [url]
+sd-cli commit
 ```
 
-| Option | Type | Description |
-|---|---|---|
-| `<platform>` | `string` | Target platform (e.g., `android`). |
-| `<package>` | `string` | Package name. |
-| `[url]` | `string` | URL to open in the webview. |
-
-### run-capacitor
+### `postinstall`
 
-Deploy a watched client package to a Capacitor device.
+Runs automated post-install tasks. Typically called from `package.json` scripts.
 
 ```bash
-sd-cli run-capacitor <platform> <package> [url]
+sd-cli postinstall
 ```
 
-| Option | Type | Description |
-|---|---|---|
-| `<platform>` | `string` | Target platform (e.g., `android`). |
-| `<package>` | `string` | Package name. |
-| `[url]` | `string` | URL to open in the webview. |
-
-### commit
+## Usage Examples
 
-Use AI (Claude Haiku) to generate a commit message from staged changes, then commit automatically.
+### Development workflow
 
 ```bash
-sd-cli commit
-```
+# Watch all packages
+sd-cli watch
 
-Requires the `ANTHROPIC_API_KEY` environment variable to be set.
+# Watch a specific package with debug logging
+sd-cli watch --packages sd-angular --debug
 
-### postinstall
+# Check only (no output emit)
+sd-cli watch --noEmit
+```
 
-Run post-install patches on dependencies. This is typically called automatically after `yarn install`.
+### Build and publish
 
 ```bash
-sd-cli postinstall
+# Full production build
+sd-cli build
+
+# Build specific packages
+sd-cli build --packages sd-core-common sd-core-node
+
+# Publish without rebuilding
+sd-cli publish --noBuild
 ```
 
-## Electron Builder Configuration
-
-The `builder.electron` config for client packages supports:
-
-| Property | Type | Description |
-|---|---|---|
-| `appId` | `string` | Application identifier (e.g., `com.example.app`). |
-| `installerIcon` | `string` | Path to the installer icon file (relative to the package). |
-| `portable` | `boolean` | Build a portable `.exe` instead of an NSIS installer. |
-| `postInstallScript` | `string` | Script to run after npm install in the Electron context. |
-| `nsisOptions` | `electronBuilder.NsisOptions` | NSIS installer options (pass-through to electron-builder). |
-| `reinstallDependencies` | `string[]` | Dependencies to reinstall with native rebuild in the Electron context. |
-| `env` | `Record<string, string>` | Environment variables for the Electron build. |
-
-## Capacitor Builder Configuration
-
-The `builder.capacitor` config for client packages supports:
-
-| Property | Type | Description |
-|---|---|---|
-| `appId` | `string` | Application identifier (e.g., `com.example.app`). |
-| `appName` | `string` | Display name of the application. |
-| `plugins` | `Record<string, Record<string, unknown> \| true>` | Capacitor plugins with their configuration. Use `true` for no-config plugins. |
-| `icon` | `string` | Path to the app icon (relative to the package). |
-| `debug` | `boolean` | Build in debug mode. |
-| `platform.android.config` | `Record<string, string>` | Additional Android application manifest attributes. |
-| `platform.android.bundle` | `boolean` | Build an AAB bundle instead of APK. |
-| `platform.android.sign` | `object` | Signing configuration (`keystore`, `storePassword`, `alias`, `password`, `keystoreType`). |
-| `platform.android.sdkVersion` | `number` | Target Android SDK version. |
-| `platform.android.permissions` | `array` | Android permissions (`name`, `maxSdkVersion`, `ignore`). |
-| `platform.android.intentFilters` | `array` | Android intent filters (`action`, `category`). |
-| `env` | `Record<string, string>` | Environment variables. |
-| `browserslist` | `string[]` | Browserslist targets. |
-
-## Process Behavior
-
-- On Windows, sd-cli automatically configures processor affinity (reserves 1 out of every 4 cores for the OS) and sets process priority to BelowNormal to avoid monopolizing system resources.
-- Node.js is launched with `--max-old-space-size=8192` for large project builds.
-- The `local-update` command runs automatically before other commands in production builds.
+### Code quality
+
+```bash
+# Run both typecheck and lint
+sd-cli check
+
+# Lint only on a specific package
+sd-cli check packages/sd-core-common --type lint
+```

package/dist/pkg-builders/client/SdNgBundler.js

@@ -38,7 +38,7 @@ export class SdNgBundler {
         this._mainFilePath = path.resolve(this._opt.pkgPath, "src/main.ts");
         this._tsConfigFilePath = path.resolve(this._opt.pkgPath, "tsconfig.json");
         this._swConfFilePath = path.resolve(this._opt.pkgPath, "ngsw-config.json");
-        this._browserTarget = transformSupportedBrowsersToTargets(browserslist(["Chrome > 78"]));
+        this._browserTarget = transformSupportedBrowsersToTargets(browserslist(["Chrome >= 61"]));
         this._indexHtmlFilePath = path.resolve(this._opt.pkgPath, "src/index.html");
         this._pkgName = path.basename(this._opt.pkgPath);
         this._baseHref =

package/dist/ts-compiler/SdStyleBundler.js

@@ -23,7 +23,7 @@ export class SdStyleBundler {
                 futureDeprecations: undefined,
             },
             externalDependencies: [],
-            target: transformSupportedBrowsersToTargets(browserslist(["Chrome > 78"])),
+            target: transformSupportedBrowsersToTargets(browserslist(["Chrome >= 61"])),
             preserveSymlinks: false,
             tailwindConfiguration: undefined,
             postcssConfiguration: undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-cli",
-  "version": "12.16.31",
+  "version": "12.16.35",
   "description": "심플리즘 패키지 - CLI",
   "author": "김석래",
   "repository": {
@@ -12,15 +12,15 @@
   "bin": "./dist/sd-cli.js",
   "type": "module",
   "dependencies": {
-    "@angular/build": "^20.3.20",
+    "@angular/build": "^20.3.21",
     "@angular/compiler": "^20.3.18",
     "@angular/compiler-cli": "^20.3.18",
     "@anthropic-ai/sdk": "^0.78.0",
     "@electron/rebuild": "^4.0.3",
-    "@simplysm/sd-core-common": "12.16.31",
-    "@simplysm/sd-core-node": "12.16.31",
-    "@simplysm/sd-service-server": "12.16.31",
-    "@simplysm/sd-storage": "12.16.31",
+    "@simplysm/sd-core-common": "12.16.35",
+    "@simplysm/sd-core-node": "12.16.35",
+    "@simplysm/sd-service-server": "12.16.35",
+    "@simplysm/sd-storage": "12.16.35",
     "browserslist": "^4.28.1",
     "cordova": "^13.0.0",
     "electron": "^33.4.11",

package/src/pkg-builders/client/SdNgBundler.ts

@@ -74,7 +74,7 @@ export class SdNgBundler {
     this._mainFilePath = path.resolve(this._opt.pkgPath, "src/main.ts");
     this._tsConfigFilePath = path.resolve(this._opt.pkgPath, "tsconfig.json");
     this._swConfFilePath = path.resolve(this._opt.pkgPath, "ngsw-config.json");
-    this._browserTarget = transformSupportedBrowsersToTargets(browserslist(["Chrome > 78"]));
+    this._browserTarget = transformSupportedBrowsersToTargets(browserslist(["Chrome >= 61"]));
     this._indexHtmlFilePath = path.resolve(this._opt.pkgPath, "src/index.html");
     this._pkgName = path.basename(this._opt.pkgPath);
     this._baseHref =

package/src/ts-compiler/SdStyleBundler.ts

@@ -34,7 +34,7 @@ export class SdStyleBundler {
           futureDeprecations: undefined,
         },
         externalDependencies: [],
-        target: transformSupportedBrowsersToTargets(browserslist(["Chrome > 78"])),
+        target: transformSupportedBrowsersToTargets(browserslist(["Chrome >= 61"])),
         preserveSymlinks: false,
         tailwindConfiguration: undefined,
         postcssConfiguration: undefined,