@luxkit/cli 1.1.0 → 1.1.2

package/dist/skills/lux/references/custom-preset-setting.md

@@ -0,0 +1,67 @@
+# Custom Preset Configuration
+
+> ⚠️ **Always use `lux init --preset` to initialize presets.** Running `lux fmt` / `lux vscode` directly generates config files in cwd and requires `package.json` — only use in real project directories.
+
+## Quick Start
+
+```bash
+lux init --preset                # materialize all built-in presets to ~/.lux/preset/
+```
+
+After materialization, edit files under `~/.lux/preset/<type>/<preset-name>/` to customize. Changes take effect on the next `lux fmt` / `lux vscode` run.
+
+`lux init --preset` can be run repeatedly — each run overwrites with built-in defaults. To reset a single preset, use `lux fmt <name> --reset` or `lux vscode <name> --reset` (deletes local preset dir only; re-generated from built-in on next run).
+
+## Storage Location
+
+`~/.lux/preset/` (i.e. `os.homedir()/.lux/preset/`). Override with `LUX_HOME` env var.
+
+```
+~/.lux/preset/
+├── fmt/                  # fmt presets (web-vue, web-react, electron-vue, uniapp, node, nest)
+└── vscode/               # vscode presets (same + go)
+```
+
+## File Reference
+
+### fmt preset
+
+| File                   | Description                                    |
+| :--------------------- | :--------------------------------------------- |
+| `eslint.config.mjs`    | ESLint flat config                             |
+| `.prettierrc`          | Prettier JSON config                           |
+| `.prettierignore`      | Prettier ignore rules                          |
+| `stylelint.config.mjs` | Stylelint config                               |
+| `.stylelintignore`     | Stylelint ignore rules                         |
+| `cspell.json`          | CSpell dictionary config                       |
+| `.editorconfig`        | EditorConfig config                            |
+| `package.json`         | Template with `devDependencies` and `scripts`  |
+
+### vscode preset
+
+| File              | Description                 |
+| :---------------- | :-------------------------- |
+| `settings.json`   | VSCode workspace settings   |
+| `extensions.json` | VSCode extension recommendations |
+
+## Template Placeholders (fmt preset)
+
+| Placeholder | Replaced with |
+| :---------- | :------------ |
+| `<pm>`      | Package manager prefix (`bun run` / `pnpm run` / `npm run`) |
+| `<lockfile>` | Project lockfile name (`bun.lock` / `pnpm-lock.yaml` etc.) |
+| `"<latest>"` | Resolved to latest version at install time, or pin like `"3.3.0"` |
+
+## Workflow
+
+```
+lux init --preset
+  → materialize all built-in presets to ~/.lux/preset/ (no cwd writes)
+
+lux fmt web-vue (in target project)
+  → local preset exists → use local version (with custom edits)
+  → local preset missing → generate from built-in + materialize (also writes to cwd)
+
+lux vscode web-vue (in target project)
+  → same as above
+```

package/dist/skills/lux/skill.md

@@ -13,6 +13,7 @@ lux fmt list
 - `--force` — overwrite existing config files (default: skip)
 - `--dry-run` — preview what would be generated, write nothing
 - `--no-install` — write deps to package.json but skip install
+- `--reset` — reset local preset, re-materialize from built-in defaults
 
 Presets: `web-vue` `web-react` `electron-vue` `uniapp` `node` `nest`
 
@@ -23,12 +24,17 @@ lux vscode <preset> [--dry-run]
 lux vscode list
 ```
 
+- `--force` — overwrite existing settings (default: skip)
+- `--dry-run` — preview what would be generated, write nothing
+- `--reset` — reset local preset, re-materialize from built-in defaults
+
 Presets: `web-vue` `web-react` `electron-vue` `uniapp` `node` `nest` `go`
 
-## init — lux skill（human interaction）
+## init — initialize skills or presets
 
 ```bash
-lux init
+lux init                  # interactively select AI tool, copy skill files to project
+lux init --preset         # materialize all built-in presets to ~/.lux/preset/ (no cwd writes, no package.json required)
 ```
 
 ## vpn — proxy clipboard helper
@@ -53,3 +59,7 @@ lux show env      # show stored proxy env
 lux update        # update to latest
 lux update --check
 ```
+
+## Custom presets
+
+To customize preset rules, see `references/custom-preset-setting.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "@luxkit/cli",
-   "version": "1.1.0",
+   "version": "1.1.2",
    "description": "One-click project formatting & VSCode config CLI",
    "type": "module",
    "bin": {
@@ -15,16 +15,9 @@
    "scripts": {
       "build": "tsup && node scripts/copy-assets.mjs",
       "dev": "tsup --watch",
-      "lint": "eslint .",
+      "lint": "eslint . --cache --cache-location node_modules/.cache/eslint && cspell --cache --cache-location node_modules/.cache/cspell --gitignore \"src/**/*\" && tsc --noEmit",
+      "lint:fix": "eslint . --cache --cache-location node_modules/.cache/eslint --fix",
       "format": "prettier --write \"src/**/*.{ts,js,json}\"",
-      "cspell": "cspell --gitignore \"src/**/*\"",
-      "format:check": "prettier --check \"src/**/*.{ts,js,json}\"",
-      "type:check": "tsc --noEmit",
-      "code:check": "bun run lint && bun run format:check",
-      "code:check:all": "bun run lint && bun run format:check && bun run cspell",
-      "lint:fix": "eslint \"src/**/*.{js,ts}\" --fix",
-      "code:fix": "bun run lint:fix && bun run format",
-      "code:fix:all": "bun run lint:fix && bun run format",
       "prepublishOnly": "cross-env NODE_ENV=production bun run build",
       "test": "vitest run",
       "test:watch": "vitest",