harveyz-skill 0.14.1 → 0.14.2

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.14.2] - 2026-06-15
+
+### Changed
+- `project-release`：description 字段改为英文，符合 skill-publish F3 格式规范
+- `project-release`：移除 `npm-release` skill，以 `.hskill/release-profile.md` 替代，消除重复
+
 ## [0.14.1] - 2026-06-14
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
@@ -38,8 +38,8 @@
     "skills/meta/git-cleanup/",
     "skills/meta/contribute-skill/",
     "skills/meta/skill-publish/",
-    "skills/meta/npm-release/",
     "skills/meta/opencode-runner/",
+    "skills/meta/project-release/",
     "tools/p-launch/",
     "tools/todo-tool/",
     "tools/hub/",

package/skills/meta/project-release/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: project-release
+description: "Universal project release skill. Triggers on: release, bump version, publish, new version, cut release. Two phases: Init (first run — scans project and generates .hskill/release-profile.md); Execute (daily use — reads profile and runs full release flow). Works with npm, Python, Rust, Java, or any versioned project."
+user_invocable: true
+version: "1.1.0"
+---
+
+# project-release
+
+通用项目发布 skill，两个阶段：
+
+- **Init** — 扫描项目，和用户确认，生成 `.hskill/release-profile.md`（每个项目做一次）
+- **Execute** — 读取 profile，完全按照它走发布流程
+
+---
+
+## 入口判断
+
+检查 `.hskill/release-profile.md` 是否存在：
+
+```bash
+ls .hskill/release-profile.md 2>/dev/null && echo "EXISTS" || echo "NOT_FOUND"
+```
+
+- **NOT_FOUND** → 执行 Init 阶段
+- **EXISTS** → 执行 Execute 阶段
+- 用户明确说「重新初始化」→ 执行 Init 阶段（覆盖旧 profile）
+
+---
+
+## Init 阶段
+
+目标：把这个项目的发布规则搞清楚，写进 profile，之后每次发版直接读。**宁可问多几个问题，也不要猜错。**
+
+### Step I-1 — 扫描分支拓扑
+
+依次从以下来源收集信息：
+
+1. 项目配置文件：`workflow-config.yml`、`CLAUDE.md`、`AGENTS.md`、`CONTRIBUTING.md`
+2. git 历史和现有分支：
+
+```bash
+git branch -a
+git log --merges --oneline -20
+```
+
+整理出：**发版起点分支**（从哪个分支开始操作）、**合并流向**（依次合并到哪些分支）、**保护分支**（不能直接提交的分支）。
+
+不确定时直接问用户，用自然语言描述即可，不需要套用固定模型名。
+
+### Step I-2 — 扫描版本文件
+
+```bash
+# 扫描常见版本文件
+for f in package.json pyproject.toml Cargo.toml setup.cfg setup.py \
+          build.gradle build.gradle.kts pom.xml pubspec.yaml \
+          VERSION version.txt CHANGELOG.md CHANGELOG.rst; do
+  [ -f "$f" ] && echo "FOUND: $f"
+done
+
+# 补充搜索其他可能含版本号的文件
+grep -rl '"version":\|^version\s*[=:]\|<version>' \
+  --include="*.json" --include="*.toml" --include="*.yaml" \
+  --include="*.yml" --include="*.xml" \
+  --exclude-dir=node_modules --exclude-dir=.git \
+  --exclude-dir=target --exclude-dir=dist . 2>/dev/null | head -20
+```
+
+对找到的每个文件，确认：
+- 这个文件需要在发版时更新吗？（有些是 lockfile，由工具自动更新）
+- 怎么更新？（工具命令 vs 直接编辑）
+
+有不确定的就问用户。最终形成一个**有序清单**：哪些文件、按什么顺序、用什么方式更新。
+
+### Step I-3 — 检测发布方式
+
+```bash
+# CI/CD 配置
+ls .github/workflows/ .gitlab-ci.yml .circleci/ 2>/dev/null
+
+# 包管理器信息
+[ -f package.json ] && cat package.json | grep -E '"private"|"publishConfig"'
+```
+
+询问用户：
+- 产物发往哪里（npm / PyPI / crates.io / 内部仓库 / 只打 tag / CI 自动处理）？
+- 发布命令是什么？
+- 谁来执行（用户手动 / CI 触发）？
+
+### Step I-4 — 询问其他项目惯例
+
+了解这个项目是否有：
+- release 分支命名规范（`release/x.y.z` / `release-x.y.z` / 其他）
+- commit message 格式要求
+- tag 格式（`vX.Y.Z` / `X.Y.Z` / 其他）、是否要求 annotated tag
+- 发版前必须通过的检查（测试、lint、构建）
+- CHANGELOG 有无、格式如何（Keep a Changelog / 自定义 / 无）
+
+### Step I-5 — 生成 profile
+
+读取 `references/release-profile-template.md` 作为骨架，把 I-1 到 I-4 收集到的信息填进去。
+
+```bash
+mkdir -p .hskill
+```
+
+模板只提供四个顶级节（分支模型、版本文件、发布方式、特殊规则），每节的具体内容完全由项目决定，用最能清楚表达意图的方式写——几行文字、表格、命令示例均可。没有特殊规则就删掉那节。
+
+写完后给用户看，确认无误再保存。告诉用户：**`.hskill/release-profile.md` 可以随时手动编辑**，是下次发版的唯一依据。
+
+---
+
+## Execute 阶段
+
+**读取 `.hskill/release-profile.md`，完全按照它执行。** profile 是唯一依据，不在 profile 里的事不要自己发明。
+
+### Step E-0 — 读取 profile + 前置检查
+
+先完整读取 profile，理解：发版起点分支是什么、版本文件清单是什么、合并流向是什么、发布命令是什么。
+
+然后按 profile 要求做前置检查，通常包括：
+
+```bash
+# 当前分支是否是发版起点
+git branch --show-current
+
+# 是否有未提交的改动
+git status --porcelain
+
+# 是否与远端同步
+git fetch origin
+git rev-list --count HEAD..origin/$(git branch --show-current)
+```
+
+profile 中有「发版前检查」（如跑测试）就一并执行。有问题立即停下告知用户。
+
+### Step E-1 — 确定新版本号
+
+从 profile 的版本文件清单中第一个「主版本声明文件」读取当前版本。
+
+如果项目有 CHANGELOG，展示其中 Unreleased 部分的内容；没有则询问用户本次改动摘要。
+
+根据改动建议 semver 升级类型，等用户确认后确定 NEW_VERSION：
+
+| 类型 | 适用情况 |
+|------|---------|
+| patch | 只有 bugfix / docs / chore |
+| minor | 新功能，向后兼容 |
+| major | Breaking Change |
+
+### Step E-2 — 更新 CHANGELOG（如适用）
+
+如果 profile 中记录了 CHANGELOG 文件，按该文件的**现有格式**更新——把本次版本从 Unreleased 区域移动到有版本号的区段，保留一个空的 Unreleased 区域供下次使用。
+
+不同项目格式不同，关键是保持和现有格式一致，不要改变风格。
+
+```bash
+TODAY=$(date +%Y-%m-%d)
+```
+
+### Step E-3 — 更新版本文件
+
+按 profile 中版本文件清单的顺序，用 profile 里说明的方式逐一更新每个文件。
+
+更新完后用 `git diff` 确认所有文件已正确改动，没有遗漏或多余修改。
+
+### Step E-4 — 执行 profile 中的发版前脚本（如有）
+
+profile「特殊规则」里列出的、需要在提交前执行的脚本或命令，在这里执行。
+
+### Step E-5 — 创建 release 分支并提交
+
+按 profile 中的分支命名规范创建 release 分支，提交所有版本文件改动：
+
+```bash
+git checkout -b <profile 中的 release 分支格式，如 release/NEW_VERSION>
+git add <profile 中列出的所有版本文件>
+git commit -m "<profile 中的 commit message 格式>"
+```
+
+### Step E-6 — 按合并流向执行本地合并 + 打 tag
+
+读取 profile 中的合并流向，逐步执行本地合并。在最终目标分支（通常是 main/master）上打 tag：
+
+```bash
+git tag <profile 中的 tag 格式，如 vNEW_VERSION 或 NEW_VERSION> -m "<tag message>"
+# 若 profile 要求 annotated tag，加 -a 参数
+```
+
+所有操作只在本地做，不推送。
+
+### Step E-7 — 输出待执行清单
+
+本地操作完成后，整理出推送和发布指令供用户手动执行：
+
+```
+== 本地已完成，待执行 ==
+
+# 推送（按 profile 中的合并流向列出所有需要推送的分支）
+git push origin <branch1>
+git push origin <branch2>
+git push origin <tag>
+
+# 发布
+<profile 中的发布命令>
+```
+
+### Step E-8 — 收尾
+
+用户确认成功后输出摘要，列出：版本变更（旧 → 新）、CHANGELOG 更新情况、tag、已推送分支、发布目标。
+
+可选：询问是否清理 release 分支（本地 + 远端）。
+
+---
+
+## 常见问题
+
+**profile 信息有误** — 直接编辑 `.hskill/release-profile.md` 后重新触发 Execute。
+
+**发版前检查失败** — 按失败信息修复后，重新从 E-0 开始。
+
+**版本文件漏更新** — E-3 后用 `git diff` 检查，发现遗漏立即补上。
+
+**CHANGELOG 为空或不存在** — 询问用户本次改动内容，或确认跳过 CHANGELOG 更新。

package/skills/meta/project-release/references/release-profile-template.md

@@ -0,0 +1,19 @@
+# Release Profile
+<!-- 由 project-release skill Init 阶段生成，可随时手动编辑 -->
+<!-- 生成时间：{YYYY-MM-DD} -->
+
+## 分支模型
+
+<!-- 描述这个项目的分支结构和发版流向，用自然语言或图示均可 -->
+
+## 版本文件
+
+<!-- 列出发版时需要更新哪些文件、怎么更新。具体到命令或操作步骤 -->
+
+## 发布方式
+
+<!-- 怎么把产物发出去：命令、工具、谁来执行 -->
+
+## 特殊规则
+
+<!-- 这个项目发版时有哪些需要注意的事情，没有就删掉这节 -->

package/skills-index.json

@@ -24,7 +24,7 @@
     "coding":    "程序工具（git-workflow-init + full-stack-debug-env + pm-task-dispatch + task-close）",
     "writing":   "写作工具（doc-forge + diagram + diataxis-docs + dir-manage + migrate-specs）",
     "design":    "设计工具（brand-scout + style-build + sync-design-html）",
-    "meta":      "元操作工具（skill-analyzer + git-cleanup + contribute-skill + skill-publish + npm-release）"
+    "meta":      "元操作工具（skill-analyzer + git-cleanup + contribute-skill + skill-publish + project-release）"
   },
   "skills": [
     { "path": "research/article-fetcher",       "bundle": "research" },
@@ -49,8 +49,8 @@
     { "path": "meta/git-cleanup",               "bundle": "meta" },
     { "path": "meta/contribute-skill",          "bundle": "meta" },
     { "path": "meta/skill-publish",             "bundle": "meta" },
-    { "path": "meta/npm-release",               "bundle": "meta" },
-    { "path": "meta/opencode-runner",           "bundle": "meta" }
+    { "path": "meta/opencode-runner",           "bundle": "meta" },
+    { "path": "meta/project-release",          "bundle": "meta" }
   ],
   "hooks": [
     {

package/tools/hub/hub/cli/projects.py

@@ -8,6 +8,7 @@ import typer
 
 from hub.core.db import HubDB
 from hub.core import projects as proj
+from hub.core.projects import scan_projects
 
 app = typer.Typer(no_args_is_help=True)
 
@@ -98,3 +99,24 @@ def projects_sync(json_out: bool = typer.Option(False, "--json")):
             typer.echo(f"✓ Scanned {len(repos)} repos")
     except ImportError:
         _err("p-launch not installed; cannot auto-scan", json_out)
+
+
+@app.command("scan")
+def projects_scan(
+    dirs: list[str] = typer.Argument(..., help="Directories to scan for git repos"),
+    json_out: bool = typer.Option(False, "--json"),
+):
+    """Scan directories for git repos and register them as projects."""
+    db = HubDB()
+    result = scan_projects(dirs, db, _md_path())
+    if json_out:
+        _out(result, json_out)
+        return
+    for p in result["added"]:
+        typer.echo(f"✓ added   {p['name']:<24} {p['path']}")
+    for name in result["skipped"]:
+        typer.echo(f"· skipped {name:<24} (already registered)")
+    for f in result["failed"]:
+        typer.echo(f"✗ failed  {f['path']}  ({f['reason']})")
+    a, s, f = len(result["added"]), len(result["skipped"]), len(result["failed"])
+    typer.echo(f"\nScanned: {a} added, {s} skipped, {f} failed")

package/tools/hub/hub/core/projects.py

@@ -1,4 +1,6 @@
 import fcntl
+import re
+import subprocess
 from datetime import datetime, timezone
 from pathlib import Path
 
@@ -63,3 +65,59 @@ def get_project_path(db, name: str) -> str | None:
             "SELECT path FROM projects WHERE name = ?", (name,)
         ).fetchone()
     return row["path"] if row else None
+
+
+def _resolve_name(repo_path: Path) -> str:
+    """Resolve project name from git remote origin URL, fall back to dir name."""
+    try:
+        result = subprocess.run(
+            ["git", "remote", "get-url", "origin"],
+            cwd=repo_path,
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        if result.returncode == 0:
+            url = result.stdout.strip().rstrip("/")
+            if url.endswith(".git"):
+                url = url[:-4]
+            return re.split(r"[/:]", url)[-1]
+    except Exception:
+        pass
+    return repo_path.name
+
+
+def scan_projects(
+    dirs: list[str],
+    db,
+    md_path: Path = _DEFAULT_MD,
+) -> dict:
+    """Scan directories (direct subdirectories (one level deep)) for git repos and register them as projects.
+
+    Returns {"added": [...], "skipped": [...], "failed": [...]}.
+    Existing projects (by name) are skipped without modification.
+    """
+    added: list[dict] = []
+    skipped: list[str] = []
+    failed: list[dict] = []
+    existing = {p["name"] for p in list_projects(db)}
+
+    for d in dirs:
+        p = Path(d).expanduser()
+        if not p.exists():
+            failed.append({"path": str(d), "reason": "directory not found"})
+            continue
+        for git_dir in sorted(p.glob("*/.git")):
+            repo_path = git_dir.parent
+            name = _resolve_name(repo_path)
+            if name in existing:
+                skipped.append(name)
+                continue
+            try:
+                add_project(db, name, path=str(repo_path), md_path=md_path)
+                added.append({"name": name, "path": str(repo_path)})
+                existing.add(name)
+            except Exception as e:
+                failed.append({"path": str(repo_path), "reason": str(e)})
+
+    return {"added": added, "skipped": skipped, "failed": failed}

package/tools/hub/hub/tui/app.py

@@ -28,9 +28,9 @@ class HubApp(App):
 
     BINDINGS = [
         Binding("tab", "cycle_focus", "Switch col", show=True),
-        Binding("f", "fetch", "Fetch", show=True),
+        Binding("ctrl+f", "fetch", "Fetch", show=True),
         Binding("enter", "open_project", "Open", show=True),
-        Binding("q", "quit", "Quit", show=True),
+        Binding("ctrl+q", "quit", "Quit", show=True),
     ]
 
     def __init__(self) -> None:

package/tools/hub/hub/tui/panels/projects.py

@@ -1,14 +1,25 @@
+import os
+from pathlib import Path
+
+from textual import work
 from textual.app import ComposeResult
+from textual.binding import Binding
 from textual.message import Message
 from textual.widget import Widget
-from textual.widgets import Label, ListItem, ListView
+from textual.widgets import Input, Label, ListItem, ListView
 
 from hub.core.db import HubDB
-from hub.core.projects import list_projects
+from hub.core.projects import list_projects, scan_projects
 from hub.core.tasks import list_tasks
 
+_DEFAULT_MD = Path.home() / ".hskill" / "public" / "PROJECTS.md"
+
 
 class ProjectsPanel(Widget):
+    BINDINGS = [
+        Binding("ctrl+s", "scan_action", "Scan", show=True),
+    ]
+
     DEFAULT_CSS = """
     ProjectsPanel {
         width: 30;
@@ -18,6 +29,9 @@ class ProjectsPanel(Widget):
     ProjectsPanel:focus-within {
         border: solid $accent;
     }
+    ProjectsPanel Input {
+        dock: bottom;
+    }
     """
 
     class ProjectSelected(Message):
@@ -56,3 +70,39 @@ class ProjectsPanel(Widget):
             self.selected_name = p["name"]
             self.selected_path = p.get("path", "")
             self.post_message(self.ProjectSelected(p["name"], p.get("path", "")))
+
+    def action_scan_action(self) -> None:
+        if self.query("#scan-dir-input"):
+            return
+        inp = Input(
+            placeholder="Directory to scan… (Enter to scan, Esc to cancel)",
+            id="scan-dir-input",
+        )
+        self.mount(inp)
+        inp.focus()
+
+    def on_input_submitted(self, event: Input.Submitted) -> None:
+        if event.input.id != "scan-dir-input":
+            return
+        directory = event.value.strip()
+        event.input.remove()
+        if directory:
+            self._scan_worker(directory)
+
+    def on_key(self, event) -> None:
+        if event.key == "escape" and self.query("#scan-dir-input"):
+            self.query_one("#scan-dir-input").remove()
+            event.prevent_default()
+
+    @work(thread=True)
+    def _scan_worker(self, directory: str) -> None:
+        md = Path(os.environ["HUB_MD_PATH"]) if "HUB_MD_PATH" in os.environ else _DEFAULT_MD
+        result = scan_projects([directory], self.db, md_path=md)
+        a = len(result["added"])
+        s = len(result["skipped"])
+        f = len(result["failed"])
+        self.app.call_from_thread(self._after_scan, a, s, f)
+
+    def _after_scan(self, added: int, skipped: int, failed: int) -> None:
+        self._reload()
+        self.app.notify(f"Scanned: {added} added, {skipped} skipped, {failed} failed")

package/tools/hub/hub/tui/panels/tasks.py

@@ -9,9 +9,9 @@ from hub.core.tasks import add_task, delete_task, list_tasks, mark_done, update_
 
 class TasksPanel(Widget):
     BINDINGS = [
-        Binding("n", "new_task", "New", show=True),
+        Binding("ctrl+n", "new_task", "New", show=True),
         Binding("space", "toggle_done", "Done", show=True),
-        Binding("D", "delete_task_action", "Delete", show=True),
+        Binding("ctrl+d", "delete_task_action", "Delete", show=True),
     ]
 
     DEFAULT_CSS = """

package/tools/hub/hub.sh

@@ -1,6 +1,18 @@
 #!/usr/bin/env bash
 set -e
 
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Auto-detect dev mode: script is running from the source tree
+if [ -d "${SCRIPT_DIR}/hub" ] && [ -f "${SCRIPT_DIR}/pyproject.toml" ]; then
+  DEV_VENV="${SCRIPT_DIR}/.venv"
+  if [ ! -x "${DEV_VENV}/bin/hub" ]; then
+    python3 -m venv "${DEV_VENV}"
+    "${DEV_VENV}/bin/pip" install -q -e "${SCRIPT_DIR}"
+  fi
+  exec "${DEV_VENV}/bin/hub" "$@"
+fi
+
 VENV_DIR="${HOME}/.hskill/tools/hub/venv"
 INSTALL_DIR="${HOME}/.hskill/tools/hub"
 

package/tools/hub/tests/test_scan.py

@@ -0,0 +1,89 @@
+import os
+import subprocess
+from pathlib import Path
+import pytest
+from hub.core.db import HubDB
+from hub.core.projects import scan_projects
+
+
+def _make_repo(path: Path, origin: str | None = None) -> Path:
+    """Create a minimal git repo under path/."""
+    path.mkdir(parents=True)
+    subprocess.run(["git", "init"], cwd=path, check=True, capture_output=True)
+    subprocess.run(
+        ["git", "commit", "--allow-empty", "-m", "init"],
+        cwd=path, check=True, capture_output=True,
+        env={**os.environ, "GIT_AUTHOR_NAME": "t",
+             "GIT_AUTHOR_EMAIL": "t@t", "GIT_COMMITTER_NAME": "t",
+             "GIT_COMMITTER_EMAIL": "t@t"},
+    )
+    if origin:
+        subprocess.run(
+            ["git", "remote", "add", "origin", origin],
+            cwd=path, check=True, capture_output=True,
+        )
+    return path
+
+
+def test_scan_adds_repo_using_remote_name(tmp_path):
+    _make_repo(tmp_path / "repo-a", origin="https://github.com/user/my-repo.git")
+    db = HubDB(db_path=tmp_path / "hub.db")
+    md_path = tmp_path / "PROJECTS.md"
+    result = scan_projects([str(tmp_path)], db, md_path=md_path)
+    assert len(result["added"]) == 1
+    assert result["added"][0]["name"] == "my-repo"
+    assert result["skipped"] == []
+    assert result["failed"] == []
+
+
+def test_scan_fallback_to_dir_name_when_no_remote(tmp_path):
+    _make_repo(tmp_path / "repo-b")  # no origin
+    db = HubDB(db_path=tmp_path / "hub.db")
+    md_path = tmp_path / "PROJECTS.md"
+    result = scan_projects([str(tmp_path)], db, md_path=md_path)
+    assert result["added"][0]["name"] == "repo-b"
+    assert result["skipped"] == []
+    assert result["failed"] == []
+
+
+def test_scan_skips_existing_project(tmp_path):
+    _make_repo(tmp_path / "repo-a", origin="https://github.com/user/repo-a.git")
+    db = HubDB(db_path=tmp_path / "hub.db")
+    md_path = tmp_path / "PROJECTS.md"
+    from hub.core.projects import add_project
+    add_project(db, "repo-a", path="/old/path", md_path=md_path)
+    result = scan_projects([str(tmp_path)], db, md_path=md_path)
+    assert "repo-a" in result["skipped"]
+    assert result["added"] == []
+    # Verify old path was NOT overwritten
+    from hub.core.projects import get_project_path
+    assert get_project_path(db, "repo-a") == "/old/path"
+
+
+def test_scan_adds_repo_using_ssh_remote_name(tmp_path):
+    _make_repo(tmp_path / "repo-c", origin="git@github.com:user/ssh-repo.git")
+    db = HubDB(db_path=tmp_path / "hub.db")
+    result = scan_projects([str(tmp_path)], db, md_path=tmp_path / "PROJECTS.md")
+    assert result["added"][0]["name"] == "ssh-repo"
+    assert result["skipped"] == []
+    assert result["failed"] == []
+
+
+def test_scan_nonexistent_dir_goes_to_failed(tmp_path):
+    db = HubDB(db_path=tmp_path / "hub.db")
+    result = scan_projects(["/nonexistent/path/xyz"], db)
+    assert result["added"] == []
+    assert result["failed"][0]["reason"] == "directory not found"
+
+
+def test_scan_multiple_dirs(tmp_path):
+    dir1 = tmp_path / "group1"
+    dir2 = tmp_path / "group2"
+    _make_repo(dir1 / "repo-x", origin="https://github.com/user/repo-x.git")
+    _make_repo(dir2 / "repo-y", origin="https://github.com/user/repo-y.git")
+    db = HubDB(db_path=tmp_path / "hub.db")
+    result = scan_projects([str(dir1), str(dir2)], db, md_path=tmp_path / "PROJECTS.md")
+    names = {p["name"] for p in result["added"]}
+    assert names == {"repo-x", "repo-y"}
+    assert result["skipped"] == []
+    assert result["failed"] == []

package/tools/hub/tests/test_tui_app.py

@@ -16,7 +16,7 @@ async def test_hub_app_mounts(tmp_path, monkeypatch):
 async def test_hub_app_quit(tmp_path, monkeypatch):
     monkeypatch.setenv("HUB_DB_PATH", str(tmp_path / "hub.db"))
     async with HubApp().run_test() as pilot:
-        await pilot.press("q")
+        await pilot.press("ctrl+q")
     # If we got here without hanging, the app quit cleanly.
     assert True
 

package/tools/hub/tests/test_tui_projects_panel.py

@@ -1,6 +1,6 @@
 import pytest
 from textual.app import App, ComposeResult
-from textual.widgets import ListItem
+from textual.widgets import Input, ListItem
 
 from hub.core.db import HubDB
 from hub.core.projects import add_project
@@ -51,6 +51,67 @@ async def test_projects_panel_posts_selected_message(tmp_path):
     assert any(m.name == "myrepo" for m in received)
 
 
+async def test_projects_panel_scan_input_appears(tmp_path):
+    db = HubDB(tmp_path / "hub.db")
+    async with _make_app(db).run_test() as pilot:
+        panel = pilot.app.query_one(ProjectsPanel)
+        panel.focus()
+        await pilot.press("ctrl+s")
+        await pilot.pause()
+        assert len(panel.query(Input)) == 1
+
+
+async def test_projects_panel_scan_esc_cancels(tmp_path):
+    db = HubDB(tmp_path / "hub.db")
+    async with _make_app(db).run_test() as pilot:
+        panel = pilot.app.query_one(ProjectsPanel)
+        panel.focus()
+        await pilot.press("ctrl+s")
+        await pilot.pause()
+        await pilot.press("escape")
+        await pilot.pause()
+        assert len(panel.query(Input)) == 0
+
+
+async def test_projects_panel_scan_submit_triggers_worker(tmp_path):
+    """Submitting the scan Input calls _scan_worker with the typed directory."""
+    db = HubDB(tmp_path / "hub.db")
+    calls: list[str] = []
+
+    async with _make_app(db).run_test() as pilot:
+        panel = pilot.app.query_one(ProjectsPanel)
+        panel.focus()
+        await pilot.press("ctrl+s")
+        await pilot.pause()
+
+        inp = panel.query_one("#scan-dir-input", Input)
+        panel._scan_worker = lambda d: calls.append(d)  # type: ignore[method-assign]
+
+        from textual.widgets import Input as _Input
+        panel.on_input_submitted(_Input.Submitted(inp, str(tmp_path)))
+        await pilot.pause()
+
+    assert calls == [str(tmp_path)]
+
+
+async def test_projects_panel_after_scan_reloads_list(tmp_path):
+    """_after_scan reloads the project list and shows a notification."""
+    db = HubDB(tmp_path / "hub.db")
+    add_project(db, "pre-existing", path="/old")
+
+    async with _make_app(db).run_test() as pilot:
+        panel = pilot.app.query_one(ProjectsPanel)
+        await pilot.pause()
+        assert len(panel.query(ListItem)) == 1
+
+        # Simulate a scan that added "new-repo" directly in the DB
+        add_project(db, "new-repo", path=str(tmp_path))
+        panel._after_scan(added=1, skipped=0, failed=0)
+        await pilot.pause()
+
+        assert len(panel.query(ListItem)) == 2
+
+
 async def test_projects_panel_shows_task_count(tmp_path):
     db = HubDB(tmp_path / "hub.db")
     add_project(db, "proj", path="/tmp/proj")

package/tools/hub/tests/test_tui_tasks_panel.py

@@ -62,7 +62,7 @@ async def test_tasks_panel_new_task_input_appears(tmp_path):
         panel.refresh_project("proj")
         await pilot.pause()
         panel.focus()
-        await pilot.press("n")
+        await pilot.press("ctrl+n")
         await pilot.pause()
         assert len(panel.query(Input)) == 1
 
@@ -77,7 +77,7 @@ async def test_tasks_panel_new_task_saves(tmp_path):
         panel.refresh_project("proj")
         await pilot.pause()
         panel.focus()
-        await pilot.press("n")
+        await pilot.press("ctrl+n")
         await pilot.pause()
         await pilot.press("M", "y", "space", "t", "a", "s", "k")
         await pilot.press("enter")
@@ -126,11 +126,11 @@ async def test_tasks_panel_delete_two_press(tmp_path):
         lst.focus()
         await pilot.press("down")
         # first D — should NOT delete yet
-        await pilot.press("D")
+        await pilot.press("ctrl+d")
         await pilot.pause()
         assert len(list_tasks(db, project="proj")) == 1
-        # second D — should delete
-        await pilot.press("D")
+        # second ctrl+d — should delete
+        await pilot.press("ctrl+d")
         await pilot.pause()
 
     assert len(list_tasks(db, project="proj")) == 0

package/skills/meta/npm-release/SKILL.md

@@ -1,214 +0,0 @@
----
-name: npm-release
-description: "Complete npm publish workflow for harveyz-skill: bump version, update CHANGELOG, create release branch, merge to staging then main, tag, and publish to npm. Use this skill whenever the user wants to release, publish, cut a version, bump version, ship to npm, or deploy a new package version."
-user_invocable: true
-version: "1.2.0"
----
-
-# npm-release
-
-harveyz-skill 发布到 npm 的完整流程：版本号升级 → CHANGELOG 更新 → 分支提交 → 本地合并到 staging 和 main → 打 tag → 给出推送 + 发布指令供用户执行。
-
-**说明**：所有 `git push` 和 `npm publish` 操作由用户自行执行，Claude 只做本地操作，最后统一给出指令清单。
-
----
-
-## 前置条件
-
-在开始之前先做以下检查，发现问题立即停下来告知用户：
-
-```bash
-# 1. 确认在 staging 分支（发版从 staging 开始）
-git branch --show-current
-
-# 2. 确认没有未提交的改动
-git status --porcelain
-
-# 3. 确认本地 staging 和远端同步
-git fetch origin staging
-git rev-list --count HEAD..origin/staging   # 应为 0
-
-# 4. 确认测试通过
-npm test
-```
-
-如果有未提交改动 → 告知用户先处理；如果测试失败 → 停止，展示失败信息。
-
----
-
-## Step 1 — 确定版本号
-
-先展示当前版本和 [Unreleased] 改动摘要：
-
-```bash
-node -e "console.log(require('./package.json').version)"
-# 摘取 CHANGELOG.md 中 ## [Unreleased] 下的内容
-awk '/^## \[Unreleased\]/{f=1;next} /^## \[/{f=0} f{print}' CHANGELOG.md | head -30
-```
-
-根据 [Unreleased] 内容建议升级类型，然后**询问用户**确认：
-
-| 类型 | 适用情况 |
-|------|---------|
-| patch | 只有 bugfix / docs / chore |
-| minor | 新增功能，向后兼容 |
-| major | 有 Breaking Change |
-
-等用户确认后，计算新版本号（当前版本 + 升级类型）。
-
----
-
-## Step 2 — 更新 CHANGELOG
-
-编辑 `CHANGELOG.md`，将 `## [Unreleased]` 节改为新版本节，同时在它上方保留空的 Unreleased 节：
-
-**改动前（示例）：**
-```markdown
-## [Unreleased]
-
-### Added
-- 新功能 X
-
-## [0.9.0] - 2026-05-29
-```
-
-**改动后（示例，假设新版为 0.10.0，今天为 2026-06-08）：**
-```markdown
-## [Unreleased]
-
-## [0.10.0] - 2026-06-08
-
-### Added
-- 新功能 X
-
-## [0.9.0] - 2026-05-29
-```
-
-日期用 `date +%Y-%m-%d` 获取当前日期。
-
----
-
-## Step 3 — 更新 package.json
-
-直接用 `npm version` 修改版本号（不打 tag，tag 在 Step 6 手动打）：
-
-```bash
-npm version <new-version> --no-git-tag-version
-```
-
-确认 `package.json` 中 `"version"` 已更新为新版本号。
-
----
-
-## Step 3.5 — 同步 .npmignore 和 package.json files 字段
-
-运行生成脚本，确保 `.npmignore` 和 `package.json` 中的 `files` 字段与当前 `skills-index.json` 保持一致：
-
-```bash
-node scripts/generate-npmignore.js
-```
-
-检查输出有无报错。此步骤必须在提交前完成，否则新增或重命名的 skill 路径不会被正确包含/排除。
-
----
-
-## Step 4 — 创建 release 分支并提交
-
-```bash
-# 从当前 staging 切出 release 分支
-git checkout -b release/<new-version>
-
-# 提交 CHANGELOG、package.json、package-lock.json 和 .npmignore
-git add CHANGELOG.md package.json package-lock.json .npmignore
-git commit -m "chore(release): bump version to <new-version>"
-```
-
----
-
-## Step 5 — 本地合并到 staging（不推送）
-
-```bash
-git checkout staging
-git merge release/<new-version>
-```
-
-只做本地合并，不执行 push。
-
----
-
-## Step 6 — 本地合并到 main 并打 tag（不推送）
-
-```bash
-git checkout main
-git pull origin main          # 只拉取，确保本地 main 是最新的
-git merge staging
-git tag -a v<new-version> -m "v<new-version>"
-```
-
-tag 使用 annotated tag（`-a`），符合项目 workflow-config.yml 的 `require_annotated: true` 规则。
-
-**不执行任何 push**，推送操作统一在最后由用户执行。
-
----
-
-## Step 7 — 给出最终执行清单
-
-本地准备工作已完成。向用户展示以下指令，请用户依次确认并手动执行：
-
----
-
-```
-== 待执行：推送 + 发布 ==
-
-# 1. 推送 staging
-git push origin staging
-
-# 2. 推送 main 和 tag
-git push origin main
-git push origin v<new-version>
-
-# 3. 发布到 npm（需要已登录：npm login）
-npm publish
-```
-
----
-
-说明：
-- 如果 `npm login` 状态已过期，先运行 `npm login` 再执行 `npm publish`
-- 如果 `git push origin main` 被 pre-push hook 拒绝，检查 tag 格式是否为 `v<X>.<Y>.<Z>`，以及是否是 annotated tag
-- 以上命令需在项目根目录执行
-
-用户执行完毕后，告知 Claude，Claude 会输出最终摘要。
-
----
-
-## Step 8 — 收尾（用户执行完毕后）
-
-用户确认推送和发布成功后输出摘要：
-
-```
-✓ 版本 v<new-version> 已发布
-
-  package.json  <old-version> → <new-version>
-  CHANGELOG     [Unreleased] → [<new-version>] - <date>
-  Git tag       v<new-version>（已推送）
-  npm           https://www.npmjs.com/package/harveyz-skill/v/<new-version>
-  分支          staging ✓  main ✓
-```
-
-可选：询问用户是否删除 release 分支（本地 + 远端）：
-
-```bash
-git branch -d release/<new-version>
-git push origin --delete release/<new-version>  # 若已推送
-```
-
----
-
-## 常见问题
-
-**`npm publish` 提示 403**：token 过期，运行 `npm login` 后重试。
-
-**`git push` 被 pre-push hook 拒绝**：检查 tag 格式是否符合 `v<X>.<Y>.<Z>`，annotated tag 是必须的。
-
-**[Unreleased] 为空**：没有新内容也能发版（通常是 patch），告知用户确认后继续。