skill-creator 2.1.0 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,114 @@
 # Changelog
 
+## 2.3.0 (2026-09-22)
+
+Wikis move in with their workspaces, a fourth top-level Wiki panel, a
+`skill-creator wiki` subcommand, and the search engine swap that retires
+MiniSearch.
+
+### Added
+
+- **Wiki directory-mapping standard** — a workspace's wiki now lives at
+  `<workspace>/.agents/skill-wiki/` (a `.git/`-style directory property), and
+  global lives at `~/.agents/skill-wiki` (`SKILL_WIKI_HOME` overrides). Scope
+  is decided by the path itself: the slug registry, the central root, and the
+  `~/.skill-creator/wiki` sidecar are retired, and a one-shot migration script
+  carries existing data over (conflicts are refused conservatively). Project
+  wikis need no registry at all.
+- **Fourth top-level Wiki panel** — `/wiki` lists every scope (global card plus
+  each registered workspace, with read-only counts, latest update, and honest
+  "Not initialized" empty states); `/wiki/:wsId` is the per-scope fragment list
+  with filter, append form, similarity warning, and draft-preserving
+  disconnects. The legacy view under Workspaces is gone and its entries point
+  at the new panel.
+- **`wiki.scopes` RPC** — global is always listed, uninitialized scopes are
+  never lazily created by a read, and counts share one read-only membership
+  rule with the list view (illegal file names and malformed frontmatter are
+  dropped in both places).
+- **`skill-creator wiki` subcommand** — assembled in-process from the new
+  skill-wiki cli-kit (`createWikiCli` host slots: resolveScope, commandPrefix,
+  extraCommands). `--workspace` accepts a registry label, a `ws_*` id, a path,
+  `~`, or `./` (default); `wiki scopes` gives the global overview with
+  `--json`.
+
+### Changed
+
+- **@jixoai/search replaces MiniSearch** — the org-level package keeps recall
+  and persistence in pluggable backends (sqlite FTS5 by default, Tantivy in
+  single-process deployments) with BM25 scoring frozen in a shared JS layer;
+  the daemon/CLI default is sqlite because Tantivy's directory lock is
+  single-writer (`SKILL_CREATOR_SEARCH_BACKEND` switches).
+
+### Fixed
+
+- **Search-engine handles now close** — the persistent index exposes `close()`
+  and daemon teardown awaits it, so stopping or restarting no longer leaks the
+  sqlite handle (on Windows this made every later index-directory delete fail
+  with EPERM). Cross-platform validation on a real Windows host covered the
+  packages, the search/wiki surfaces, and CLI smoke runs; 63 pre-existing
+  Windows-only failures outside these areas are catalogued in
+  `docs/search-design.md` §17 for a follow-up change.
+
+## 2.2.0 (2026-09-20)
+
+A local BM25 skill-search index under the whole product, a first screen that
+loads in ~1s instead of ~7s, and native OS pickers for choosing directories.
+
+### Added
+
+- **Local skill search everywhere** — a daemon-owned search index (canonical
+  `realpath` dedup, CJK-aware frozen tokenizer, MiniSearch BM25 with frozen
+  rerank weights, persisted under a versioned envelope with per-file stat
+  freshness and event-driven watching) now backs four faces: `skill-creator
+search` on the CLI, `skills.search` / `skills.duplicates` over RPC, the
+  `skills_search` / `skills_duplicates` MCP tools, and three GUI entry points
+  — the ProviderView filter box (URL-`q` truth), the ⌘K command palette, and
+  the composer `$` menu. Exclusion dirs are tunable via a `search-config.toml`
+  written next to the index, with an in-UI shortcut to open it in your editor.
+- **Same-content badges on skill rows** — skills whose indexed bytes are
+  identical across installations show a Finder-style link badge (`↗N`,
+  "Same content as N other installations") in list and search rows, replacing
+  the old full-screen duplicate-groups block on the Workspaces home (owner
+  ruling: a badge is the honest signal, a wall of groups is noise).
+- **Native directory picker for workspace import** — the Import dialog's new
+  Browse… button routes through `@opentray/ext-dialog` (upgraded the opentray
+  family to 0.32.0, whose osascript bridge made real-host dialogs clickable —
+  two upstream bugs found and fixed along the way, jixoai/opentray#8 and #10).
+  Unsupported platforms or headless daemons hide the button; a picked
+  directory backfills the path and seeds the display name.
+- **Attachment pickers show loading** — the composer's image and document
+  buttons now spin their own icon while the native file-picker is up (each
+  target separately), matching the import Browse feedback.
+
+### Fixed
+
+- **Search returned nothing on real libraries** — the ranking pool folded
+  duplicate content _after_ the top-40 cut, so 30+ byte-identical copies of
+  one skill drowned every other result, and the surviving representative only
+  carried its own installation scope, which made provider-filtered views match
+  nothing. Folding now happens before the pool (one representative per content
+  hash) and the primary merges the group's full installation list.
+- **First screen took 5–7 seconds** — `workspace.list` ran two full discovery
+  sweeps over ~50 agent roots per call and the WebUI fired it 3–4× per load;
+  the registry now scans each `(provider, root)` exactly once (counts and
+  dedup keys from the same pass, Claude-plugin side effects skipped for
+  non-claude roots), the WebUI shares one in-flight request per connection
+  generation, the `npx skills` provenance probe warms in the background
+  instead of blocking the first `skills.list`, and same-target reads share
+  one in-flight discovery with explicit invalidation after every disk write.
+  Measured cold first paint: ~5–7s → ~1.07s; opening a skill: 27–156ms → 40ms.
+- Search-row clicks opened "Skill not found" — the global canonical id was
+  passed to the provider-scoped detail RPC; the row now resolves the local
+  skill by name.
+
+### Changed
+
+- **Visual polish pass over Workspaces** — a two-round reviewed rework: 22rem
+  list column with a width-capped centered detail pane, a 12px text floor,
+  unified hover/nesting card language, icon-only header actions, neutralized
+  row icons, an icon-rail active state, and layered not-found messaging that
+  keeps the opaque id out of the headline.
+
 ## 2.1.0 (2026-09-16)
 
 The `$` skill-reference composer surface, the dual-era MCP fix that revives the

package/README.md

@@ -123,6 +123,7 @@ Inside the repository use `pnpm skill-creator <command>` after building; as an i
 | `openinbrowser` | Explicitly open the current daemon's tokened WebUI URL in the system browser                                                                                                     |
 | `status`        | Print PID, version, HTTP port, tray state (mounted/web/headless), and any tray error                                                                                             |
 | `stop`          | Stop the production daemon; if the production endpoint is gone, discover and stop the dev daemon, waiting for endpoint release                                                   |
+| `search`        | Search local skills in-process (BM25 + skill tokenizer, no daemon required); see [Skill search](#skill-search)                                                                   |
 | `version`       | Print the package version                                                                                                                                                        |
 | `help`          | Print command help                                                                                                                                                               |
 
@@ -138,6 +139,18 @@ pnpm skill-creator stop
 
 The commands above were exercised against the built output (`dist/`, identical to the published package): headless `start` prints the recovery hint and exits 0; `status` prints pid/version/port/tray state, the DSH host health line (`--json` prints the full state), and the tokened WebUI URL; `open` is unavailable headless and hints `openinbrowser`; `openinbrowser` prints and invokes the system browser; after `stop` the HTTP endpoint releases immediately and `status` reports ENOENT with the `start` recovery entry. The published package was black-box tested the same way (start/status/stop/restart) after `npm install <tarball>` in an empty directory outside the repo (ccski is bundled into the output, no `link:` dependency; reproduce with `bun scripts/clean-install-check.sh.ts`, evidence in `docs/release/skill-steward.md`). Runtime requires Node `>=24.0.0` (kernel persistence uses `node:zlib`'s zstd; the `node:module` `stripTypeScriptTypes` that DSH code-runtime needs requires `>=22.13`, already covered by 24).
 
+## Skill search
+
+`skill-creator search <query...>` searches every local skill — all Global Workspace provider roots plus every Imported Workspace — in-process, without the daemon:
+
+```bash
+skill-creator search "React组件设计"            # human-readable output
+skill-creator search react component --json    # machine-readable: { "results": [...] }
+skill-creator search http3 --limit 20          # limit 1..50, default 10
+```
+
+Results are canonical: multiple installations of the same skill (symlinks included) collapse into one entry with an `installations` list, and byte-identical copies fold into `duplicates`. Ranking is field-weighted BM25+ (name ×10 … body ×1) plus a frozen rerank pass, with prefix and fuzzy (typo) matching; ordering is deterministic and replayable. The first run builds a persistent index under `~/.skill-creator/search-index.json`; later runs refresh it incrementally via stat checks (mtime/size/inode/ctime), so unchanged corpora are not re-read. Exit codes: `0` on a successful query (including zero results), `1` for an empty query, a bad flag, or an index I/O failure. Design, frozen tokenizer/ranking contracts, and benchmark methodology: [docs/search-design.md](docs/search-design.md).
+
 ## Skill Steward
 
 The skill steward is a Manager-owned maintenance workflow: choose a task and scope → run → review evidence → human approval → apply → roll back if needed. The entry point is the **Workflow** tab in the Workspaces provider view.