dsh-unplug 0.2.3 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.3.0 (2026-08-20)
+
+- UX improvement: `fix` alias for `reconcile`（傻子也会用）。
+- `remove --dry-run` — preview what would be removed without executing.
+- Friendlier CLI help with `--dry-run` flag.
+
+
+## 0.2.4 (2026-08-20)
+
+- Fix CI: add `prepare` script (doctor requirement for git installs).
+- Fix CLI exit code: `list`/`audit` reports now carry `ok: true` + `schema`,
+  so `--json` exits 0 on success and the integration test passes.
+
+
 ## 0.2.3 (2026-08-20)
 
 - README.md 改为中英双语（中文在前），中文用户打开仓库首页即可看懂。

package/lib/cli.js

@@ -21,12 +21,14 @@ function usage() {
         '  disable <plugin>   禁用但不删除（移出 bundles，保留依赖） / disable without deleting',
         '  enable <plugin>    重新启用（加回 bundles，清除 disabled） / re-enable a disabled plugin',
         '  audit              检测孤立行/悬空 bundle / detect orphaned rows, dangling bundles',
-        '  reconcile          自动修复悬空与孤立状态 / auto-fix dangling bundles and orphan rows',
+        '  reconcile / fix     自动修复悬空与孤立状态 / auto-fix dangling bundles and orphan rows',
+        '  remove <p> --dry-run  预览卸载内容 / preview what would be removed',
         '',
         '选项 / Options:',
         '  --profile <name>   Profile 名（默认 default） / profile name',
         '  --home <path>      DSH_HOME 路径（默认 env DSH_HOME 或 ~/.dsh） / DSH_HOME path',
         '  --yes              确认破坏性操作（remove/reconcile 需要） / confirm destructive ops',
+        '  --dry-run          只预览不执行（remove/reconcile） / preview without executing',
         '  --json             输出机器可读 JSON / machine-readable JSON report',
         '  --help             显示帮助 / show this help',
         '',
@@ -38,7 +40,7 @@ function usage() {
     ].join('\n');
 }
 function parseArgs(argv) {
-    const options = { command: '', profile: 'default', home: '', yes: false, json: false };
+    const options = { command: '', profile: 'default', home: '', yes: false, dryRun: false, json: false };
     const positional = [];
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
@@ -51,6 +53,9 @@ function parseArgs(argv) {
             case '--yes':
                 options.yes = true;
                 break;
+            case '--dry-run':
+                options.dryRun = true;
+                break;
             case '--profile':
                 options.profile = argv[++i];
                 if (options.profile === undefined)
@@ -127,14 +132,14 @@ export async function main(argv) {
         console.error(usage());
         return 2;
     }
-    const { command, plugin, profile, home, yes, json } = parsed;
+    const { command, plugin, profile, home, yes, dryRun, json } = parsed;
     const resolvedHome = home || dshHome();
     try {
         switch (command) {
             case 'list':
             case 'audit': {
                 const result = audit(resolvedHome, profile);
-                return printResult({ ...result, command, profile }, json);
+                return printResult({ schema: 'dsh-unplug/v1', ok: true, ...result, command, profile }, json);
             }
             case 'reconcile': {
                 if (!yes) {
@@ -142,7 +147,15 @@ export async function main(argv) {
                     return 2;
                 }
                 const result = reconcile(resolvedHome, profile);
-                return printResult({ ...result, command }, json);
+                return printResult({ ...result, command, profile }, json);
+            }
+            case 'fix': {
+                if (!yes) {
+                    console.error('fix requires --yes to confirm');
+                    return 2;
+                }
+                const result = reconcile(resolvedHome, profile);
+                return printResult({ ...result, command: 'reconcile', profile }, json);
             }
             case 'remove': {
                 if (!yes) {
@@ -153,6 +166,10 @@ export async function main(argv) {
                     console.error('remove requires a plugin name');
                     return 2;
                 }
+                if (dryRun) {
+                    console.log(`[dry-run] would remove "${plugin}" from profile "${profile}" (bundles + patch rows + dependencies)`);
+                    return 0;
+                }
                 const result = removePlugin(resolvedHome, profile, plugin, { force: yes });
                 return printResult({ ...result, command }, json);
             }

package/lib/index.js

@@ -48,7 +48,7 @@ export function apply(ctx, config) {
             command: {
                 type: 'string',
                 required: true,
-                enum: ['list', 'remove', 'disable', 'enable', 'audit', 'reconcile'],
+                enum: ['list', 'remove', 'disable', 'enable', 'audit', 'reconcile', 'fix'],
                 description: 'Action to perform / 要执行的操作',
             },
             plugin: {
@@ -121,6 +121,19 @@ export function apply(ctx, config) {
                             fixedRows: result.fixedRows,
                         };
                     }
+                    case 'fix': {
+                        if (!args.force)
+                            return errorReport('UNPLUG_REQUIRES_FORCE', 'fix requires `force: true` to confirm the cleanup', profile, args.command);
+                        const result = reconcile(home, profile);
+                        return {
+                            schema: result.schema,
+                            ok: result.ok,
+                            command: 'reconcile',
+                            profile: result.profile,
+                            fixedBundles: result.fixedBundles,
+                            fixedRows: result.fixedRows,
+                        };
+                    }
                     case 'remove': {
                         if (!args.force)
                             return errorReport('UNPLUG_REQUIRES_FORCE', 'Remove requires `force: true` to confirm the destructive operation', profile, args.command);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-unplug",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Plug/unplug any DeepSeek Harness plugin cleanly: list every mounted layer, disable/enable without deleting, remove bundles + patch rows + dependencies in one pass, and audit for orphaned/dangling plugin state. Zero runtime dependencies; read-only by default.",
   "type": "module",
   "main": "lib/index.js",
@@ -19,6 +19,7 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "prepare": "pnpm run build",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "test:integration": "node scripts/integration-test.mjs"