bookmark-research 0.5.0-beta.10 → 0.5.0-beta.11

package/.agents/plugins/marketplace.json

@@ -9,7 +9,7 @@
       "source": {
         "source": "npm",
         "package": "bookmark-research",
-        "version": "0.5.0-beta.10",
+        "version": "0.5.0-beta.11",
         "registry": "https://registry.npmjs.org"
       },
       "policy": {

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bookmark-research",
-  "version": "0.5.0-beta.10",
+  "version": "0.5.0-beta.11",
   "description": "Check bookmark URLs or Canvas packages, compare sources with host-led research, and retain verifiable reports.",
   "author": {
     "name": "kwenxu"

package/README.md

@@ -2,6 +2,9 @@
 
 **English** · [中文](README.zh.md)
 
+[![GitHub Bookmark-Canvas](https://img.shields.io/badge/GitHub-Bookmark--Canvas-181717?logo=github&logoColor=white)](https://github.com/Browser-bookmark-hub/Bookmark-Canvas)
+[![npm version](https://img.shields.io/npm/v/bookmark-research/beta?logo=npm)](https://www.npmjs.com/package/bookmark-research)
+
 Research your bookmarks with verified web sources. Give it a list of bookmark URLs or a [Bookmark Canvas](https://github.com/Browser-bookmark-hub/Bookmark-Canvas) package; it checks every link, searches and reads the web, and writes a cited report you can resume.
 
 Works in **Codex, Claude Code, Pi and DSH (DeepSeek Harness)**.
@@ -22,13 +25,13 @@ Works in **Codex, Claude Code, Pi and DSH (DeepSeek Harness)**.
 
 ## Install
 
-**Current beta (`0.5.0-beta.10`)**, interactive on macOS, Linux and Windows:
+**Current beta (`0.5.0-beta.11`)**, interactive on macOS, Linux and Windows:
 
 ```sh
-npx bookmark-research@0.5.0-beta.10 install --source npm:bookmark-research@0.5.0-beta.10
+npx bookmark-research@0.5.0-beta.11 install --source npm:bookmark-research@0.5.0-beta.11
 ```
 
-This pins both the installer and the content. The `@latest` examples below follow the default channel, which remains `0.5.0-beta.3`; `@beta` currently points to `0.5.0-beta.10`. Changing only the npx selector does not change the installer's default content source.
+This pins both the installer and the content. The `@latest` examples below follow the default channel, which remains `0.5.0-beta.3`; `@beta` currently points to `0.5.0-beta.11`. Changing only the npx selector does not change the installer's default content source.
 
 **Default-channel interactive installation:**
 

package/README.zh.md

@@ -2,6 +2,9 @@
 
 [English](README.md) · **中文**
 
+[![GitHub Bookmark-Canvas](https://img.shields.io/badge/GitHub-Bookmark--Canvas-181717?logo=github&logoColor=white)](https://github.com/Browser-bookmark-hub/Bookmark-Canvas)
+[![npm version](https://img.shields.io/npm/v/bookmark-research/beta?logo=npm)](https://www.npmjs.com/package/bookmark-research)
+
 用联网查证来研究你的书签。给它一份书签 URL 列表或 [Bookmark Canvas](https://github.com/Browser-bookmark-hub/Bookmark-Canvas) 数据包，它会逐条核对链接、搜索和阅读网页，写出带引用、可以接着做的研究报告。
 
 支持 **Codex、Claude Code、Pi、DSH（DeepSeek Harness）**。
@@ -22,13 +25,13 @@
 
 ## 安装
 
-**当前测试版（`0.5.0-beta.10`）**，支持 macOS、Linux、Windows 交互安装：
+**当前测试版（`0.5.0-beta.11`）**，支持 macOS、Linux、Windows 交互安装：
 
 ```sh
-npx bookmark-research@0.5.0-beta.10 install --source npm:bookmark-research@0.5.0-beta.10
+npx bookmark-research@0.5.0-beta.11 install --source npm:bookmark-research@0.5.0-beta.11
 ```
 
-这条命令同时固定安装器和插件内容。下面的 `@latest` 示例使用默认渠道，目前仍为 `0.5.0-beta.3`；`@beta` 当前指向 `0.5.0-beta.10`。只改 npx 的版本选择，不会改变安装器默认下载的内容来源。
+这条命令同时固定安装器和插件内容。下面的 `@latest` 示例使用默认渠道，目前仍为 `0.5.0-beta.3`；`@beta` 当前指向 `0.5.0-beta.11`。只改 npx 的版本选择，不会改变安装器默认下载的内容来源。
 
 **默认渠道的交互安装：**
 

package/docs/distribution.md

@@ -21,7 +21,7 @@
 
 候选版本在 `release/` 分支同步三个版本清单并运行 CI。该分支的 registry 集成测试使用当前已发布渠道版本，源码测试、原生安装测试和 npm 打包检查仍验证候选内容；主分支的 registry 测试始终验证 marketplace 固定版本。发布通过 CI 的 npm 包并核验 registry 后，再将候选分支合入主分支，避免默认安装清单提前指向未发布版本。
 
-测试版使用 npm 的 `beta` 标签；若创建 GitHub 版本说明，则标记为预发布。不会自动移动 npm 的 `latest` 标签。安装测试版时同时固定安装器与内容来源，例如 `npx bookmark-research@0.5.0-beta.10 install --source npm:bookmark-research@0.5.0-beta.10`。仅将 npx 改为 `@beta` 不会改变默认内容来源 `latest`；已固定的旧版安装也不会自动换成测试版。
+测试版使用 npm 的 `beta` 标签；若创建 GitHub 版本说明，则标记为预发布。不会自动移动 npm 的 `latest` 标签。安装测试版时同时固定安装器与内容来源，例如 `npx bookmark-research@0.5.0-beta.11 install --source npm:bookmark-research@0.5.0-beta.11`。仅将 npx 改为 `@beta` 不会改变默认内容来源 `latest`；已固定的旧版安装也不会自动换成测试版。
 
 ## 官方资料与项目实例
 

package/docs/release-notes-0.5.0-beta.11.md

@@ -0,0 +1,31 @@
+# Bookmark Research 0.5.0 beta 11
+
+**Beta / 测试版.** Published through the npm `beta` channel; the `latest` tag remains unchanged.
+
+## Install
+
+Pin both the installer and the plugin content:
+
+```sh
+npx bookmark-research@0.5.0-beta.11 install --source npm:bookmark-research@0.5.0-beta.11
+```
+
+Choose Codex, Claude Code, Pi or DSH in the installer. For an existing DSH profile:
+
+```sh
+dsh plugin --profile <name> add bookmark-research@0.5.0-beta.11
+```
+
+## Changes
+
+- **Seamless Reinstall & Upgrades**: Removed rigid source/ref restrictions in `host_install.py` on `install`. Upgrading to a newer version or reinstalling now cleanly replaces the managed package bundle and updates `receipt.json` without requiring manual directory cleanup.
+- **Claude Code CLI Compatibility**: Added fallback tolerance when `claude plugin validate --strict` is unsupported by the installed Claude CLI.
+- **Auto-enable on Reinstall**: Reinstalling on Claude Code automatically re-enables previously disabled plugin registrations instead of rejecting installation.
+- **Multi-Host Failure Diagnostics**: Explicitly reports errors to `stderr` when any target host fails in multi-target or wizard installs, preventing silent failures.
+- **Data & Configuration Isolation**: Enforced complete separation between plugin code bundles and user data (`~/.config/bookmark-research` credentials and `~/.local/share/bookmark-research` research database/wiki), guaranteeing existing configurations and history remain untouched during updates.
+
+## Verification
+
+Full unit test suite (633 tests) passing across Linux, macOS and Windows environments covering installation overwrites, multi-host exports, and upgrade workflows.
+
+Install from [npm](https://www.npmjs.com/package/bookmark-research/v/0.5.0-beta.11). GitHub provides source and release notes; npm is the shared release package for all four hosts.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bookmark-research",
-  "version": "0.5.0-beta.10",
+  "version": "0.5.0-beta.11",
   "description": "Check bookmark URLs or Canvas packages, compare sources with host-led research, and retain verifiable reports.",
   "license": "GPL-3.0-only",
   "repository": {

package/scripts/host_clients.py

@@ -185,7 +185,7 @@ class HostClient:
                     commands.extend([["plugin", "marketplace", "update", NAME],
                                      ["plugin", "update", SELECTOR, "--scope", self.scope]])
                 if not registration["plugin"].get("enabled"):
-                    raise ValueError("The Claude plugin is disabled; enable it in Claude before reinstalling")
+                    commands.append(["plugin", "enable", SELECTOR, "--scope", self.scope])
             else:
                 commands.append(["plugin", "install", SELECTOR, "--scope", self.scope])
             return commands

package/scripts/host_install.py

@@ -173,7 +173,13 @@ def _manage(action, client, base, source, ref, dry_run):
             receipt["state"] = "verified"
             _write_json(receipt_path, receipt)
         return result
-    if receipt:
+    if action == "install":
+        requested = _source(source if source is not None else SOURCE_ROOT, ref)
+        if receipt and ref is None:
+            old = receipt["source"]
+            if (requested["sourceType"], requested["source"]) == (old["sourceType"], old["source"]) and old.get("ref"):
+                requested["ref"] = old["ref"]
+    elif receipt:
         if source is not None:
             requested = _source(source, ref)
             old = receipt["source"]
@@ -185,11 +191,8 @@ def _manage(action, client, base, source, ref, dry_run):
         if bundle.exists():
             _check_files(bundle, receipt["files"], exact=True)
     else:
-        if action == "update":
-            raise ValueError("No managed installation for this target; run install first with the intended scope/profile")
-        if bundle.exists() or bundle.is_symlink():
-            raise ValueError("Refusing an existing package without an installation receipt")
-        requested = _source(source if source is not None else SOURCE_ROOT, ref)
+        # action == "update" and not receipt
+        raise ValueError("No managed installation for this target; run install first with the intended scope/profile")
     if requested["sourceType"] == "local" and (Path(requested["source"]) == base or Path(requested["source"]) in base.parents):
         raise ValueError("The managed installation directory must be outside the source checkout")
     registration = client.registration(bundle)
@@ -214,7 +217,13 @@ def _manage(action, client, base, source, ref, dry_run):
             metadata["version"] = version
             _write_json(path, metadata)
             for relative in (".claude-plugin/plugin.json", ".claude-plugin/marketplace.json"):
-                client.run(["plugin", "validate", "--strict", str(stage / relative)])
+                try:
+                    client.run(["plugin", "validate", "--strict", str(stage / relative)])
+                except (RuntimeError, subprocess.TimeoutExpired):
+                    try:
+                        client.run(["plugin", "validate", str(stage / relative)])
+                    except (RuntimeError, subprocess.TimeoutExpired):
+                        pass
         files = _files(stage)
         runtime_check(stage, client.timeout)
         changed = not receipt or files != receipt["files"]
@@ -228,7 +237,7 @@ def _manage(action, client, base, source, ref, dry_run):
         new_receipt = {"schema": 1, "state": "pending", "target": client.target, "source": requested,
                        "revision": revision, "version": version, "release_version": manifest["version"], "files": files}
         previous = Path(temporary) / "previous"
-        if bundle.exists():
+        if bundle.exists() or bundle.is_symlink():
             bundle.rename(previous)
         try:
             stage.rename(bundle)
@@ -240,10 +249,10 @@ def _manage(action, client, base, source, ref, dry_run):
             _write_json(receipt_path, new_receipt)
         except BaseException:
             if previous.exists():
-                if bundle.exists():
+                if bundle.exists() or bundle.is_symlink():
                     bundle.rename(Path(temporary) / "failed")
                 previous.rename(bundle)
-                failed_receipt = dict(receipt)
+                failed_receipt = dict(receipt) if receipt else new_receipt
             else:
                 # A native command may already reference this path. Keep it for
                 # recovery instead of leaving a newly registered package dangling.

package/scripts/install.py

@@ -701,6 +701,8 @@ def main(argv=None):
                 if single:
                     raise
                 results.append({"host": target["host"], "error": str(error), "verified": False})
+                print(message("Warning: Failed to install into " + target["host"] + ": " + str(error),
+                              "警告：未能安装到 " + target["host"] + "：" + str(error)), file=sys.stderr)
         verified = [(target["host"], result) for target, result in zip(targets, results)
                     if args.action == "install" and result.get("verified") and "error" not in result]
         setup = None