Commit Graph
275 Commits
Author SHA1 Message Date
Willie b93f437d8e feat(ui): add update notification dialog to Web UI
Show a compact dialog on first visit when a newer CLI or skill version
is available. Queries /api/version (shared cache with Dashboard), displays
version diff with copyable upgrade command. Dismissed once per browser
session via sessionStorage. Supports ?update-test param for local testing.
2026-03-24 23:17:06 +08:00
Willie 3a45d38305 docs: add filtering skills guide and reference
New users frequently ask for per-target skill management without
realizing three filtering layers already exist (#93). Add two new
doc pages to surface the full picture:

- How-to guide (6 scenarios + decision flowchart + verification table)
- Reference page (comparison table + evaluation order + full specs)

Also add cross-links from sync, target, file-structure, and
creating-skills pages, sidebar entries, and a README highlight.

Ref: #93
2026-03-20 18:29:05 +08:00
Willie 1c7bdcdd84 feat(ui): add Force toggle to Extras page and auto-reset after sync
- Add Force toggle button with tooltip in Extras PageHeader
- Pass force flag to syncExtras API for both Sync All and per-extra sync
- Show "enable Force to override" hint in toast when files are skipped
- Auto-reset Force to disabled after successful sync (Extras + Sync pages)
- Fix ExtrasSyncResult type to match server response (target field, errors array)
- Update v0.17.9 changelog entries
2026-03-20 18:29:05 +08:00
Willie 5198a74287 fix(ui): fix assistant panel scrolling, remove false target warnings, add virtual scroll
- Fix Config and Audit Rules assistant panels with fixed 500px content
  height to enable scrolling (matching CodeMirror editor height)
- Remove target name validation that produced false "Unknown target"
  warnings — target names are user-defined and freely configurable
- Enrich targets field docs example with all sub-fields
- Add react-virtuoso virtual scrolling to FilterStudioPage preview list
- Add v0.17.9 changelog and website changelog
2026-03-20 18:29:05 +08:00
Willie 5a0a8753d0 fix(test): update extras source-not-exist test for auto-create behavior
Sync now auto-creates missing extras source directories instead of
failing with "does not exist". Update the assertion to match.
2026-03-20 02:36:50 +08:00
Willie c4b493ca03 docs: add audit rules assistant panel to v0.17.8 changelog
Add YAML editor assistant panel with regex tester feature to
CHANGELOG.md and website changelog.
2026-03-20 02:36:50 +08:00
Willie 34aedc99b2 docs: update v0.17.8 changelog with assistant panel and bug fixes
Add config editor assistant panel feature and three bug fixes to
CHANGELOG.md and website changelog.
2026-03-20 02:36:50 +08:00
Willie 4b7f02ffde docs: extras source config documentation and v0.17.8 changelog
- extras command reference: --source flag, source_type, resolution priority
- configuration reference: extras_source and per-extra source fields
- CHANGELOG and website changelog: v0.17.8 entry
- mdproof lessons-learned: jq mixed stdout, ssenv+mdproof conflict
2026-03-20 02:36:50 +08:00
Willie 0b5eba205d feat(ui): add batch uninstall route, nav entry, and link from SkillsPage
- Add lazy import and route for BatchUninstallPage in App.tsx
  (placed before skills/:name to avoid capturing as dynamic param)
- Add "Batch Uninstall" nav entry with Trash2 icon in Layout.tsx MANAGE group
- Add "Batch Uninstall" secondary button next to "New Skill" in SkillsPage header
2026-03-19 16:33:24 +08:00
Willie 8c0e97ac13 feat: add remove action (R key) to target list TUI
Press R on a selected target to show a confirmation overlay.
Confirming exits the TUI and dispatches the full target remove
flow (backup + unlink + config update), matching the existing
exit-with-action pattern used by the skill list TUI.

Supports both global and project modes.
2026-03-19 16:33:24 +08:00
Willie 643e3c5c07 fix: auto-create missing target directories with notification (#87)
v0.17.5 blocked sync when target directories didn't exist, which
prevented first-time users on fresh CLI installs from syncing.

Sync now auto-creates missing directories and reports what it did
in CLI output, dry-run preview, and the Web UI. Init also creates
target directories when it detects an installed CLI tool.

Web UI: Sync Preview modal stays open after sync with a success
banner instead of immediately closing, so users can review results.

Closes #87
2026-03-19 03:57:08 +08:00
Willie b6475acb6e docs: add Hermes Agent to v0.17.5 changelog 2026-03-19 03:57:08 +08:00
Willie c57391ea39 feat: add Hermes Agent (Nous Research) target support
Hermes Agent is a CLI tool by Nous Research with skills support.
Paths: ~/.hermes/skills (global), .hermes/skills (project).
Ref: https://hermes-agent.nousresearch.com/docs/reference/optional-skills-catalog

Also updates target count from 55+ to 56+ across docs and homepage.
2026-03-19 03:57:08 +08:00
Willie 94269a032e docs: add Web UI New Skill Wizard to v0.17.5 changelog
Add dashboard wizard entry (+ New Skill button, step-by-step flow,
two new API endpoints) to both CHANGELOG.md and website changelog.
2026-03-18 22:35:02 +08:00
Willie 948adf9a11 docs: add web UI wizard to new and ui command pages
- ui.md: add "New Skill" page to dashboard pages table, add
  GET /api/skills/templates and POST /api/skills to REST API table
- new.md: add "Web UI Wizard" section with step-by-step description
2026-03-18 22:35:02 +08:00
Willie c1e6f1d7b8 docs: add metadata.targets to v0.17.5 changelog 2026-03-18 22:35:02 +08:00
Willie 0ae936a3c1 docs: document metadata.targets in skill format page
Add the new metadata: block placement for targets, explain the
priority rule (metadata wins over top-level), and describe the
metadata block as an ecosystem convention.
2026-03-18 22:35:02 +08:00
Willie 6b3858620f feat(skillignore): add .skillignore.local for local pattern overrides
Allow users to override shared .skillignore patterns without modifying
the committed file. ReadMatcher transparently merges .skillignore +
.skillignore.local (local appended last so !negation rules win).

- Matcher.HasLocal flag tracks .local presence for CLI reporting
- IgnoreStats gains RootLocalFile, RepoLocalFiles, HasLocal() method
- sync/status/doctor show ".local active" indicator
- 6 unit tests + 2 integration tests
- Docs: file-structure, sync, status, doctor, best-practices, creating-skills, org-sharing
2026-03-18 22:35:02 +08:00
Willie 93a3067c76 refactor(tui): move wizard breadcrumbs to help bar footer
Compact single-line format: "✓ reviewer → quality" appended to
the help bar instead of a multi-line header above the list.
2026-03-18 22:35:02 +08:00
Willie 26760157b6 docs: add pattern and category fields to skill format reference 2026-03-18 22:35:02 +08:00
Willie c4bfcb0a44 docs: add skill design patterns guide and update new command reference
Add comprehensive skill design patterns page covering five structural
templates (Tool Wrapper, Generator, Reviewer, Inversion, Pipeline) with
a decision flowchart, use-case categories, and detailed examples.

Update `new` command reference with -P/--pattern flag documentation and
a scaffold directories table. Cross-link from skill-design.md.
2026-03-18 22:35:02 +08:00
Willie 6d0ac1bf81 docs: add SKILLSHARE_UI_BASE_PATH to environment variables reference
Ref: #85
2026-03-18 22:35:02 +08:00
Willie 329869f258 docs: add use case context to reverse proxy section
Ref: #85
2026-03-18 22:35:02 +08:00
Willie 657adcc8a6 test+docs: add base path integration tests and reverse proxy guide
- Integration tests: --base-path missing value, -b short flag, env var
- Docs: --base-path flag in table, Nginx/Caddy examples, env var usage

Ref: #85
2026-03-18 22:35:02 +08:00
Willie 92603f5be6 feat: add config save validation and sync safety checks
Validate config semantics (source path, sync modes, target paths) at
save time (API + CLI) instead of failing at sync time with cryptic
errors. Sync no longer auto-creates missing target directories — fails
fast to catch typos like ~/.cusor/skills. Dry-run also validates paths.

- ValidateConfig / ValidateProjectConfig with warnings + errors
- handlePutConfig returns 400 for invalid configs, 200 + warnings
- handleSync pre-checks via ValidateConfig
- ensureRealTargetDir shared helper (replaces duplicated blocks)
- UI: warning toast on config save, warning banners on sync/preview
- Dashboard shows full absolute source path
2026-03-18 22:35:02 +08:00
Willie 6424bc635e docs: update v0.17.5 changelog to reflect banner-based sync preview
Replace toast action description with inline banner approach.
Remove Toast Action Buttons section (feature was reverted).
2026-03-18 22:35:02 +08:00
Willie 48a7e40e75 docs: add sync ignored skills and doctor fixes to v0.17.4 changelog
New entries: sync .skillignore visibility (CLI + JSON + UI), doctor
CLI text output for skillignore, doctor output readability, duplicate
names truncation, doctor global mode bug fix.
2026-03-18 00:19:30 +08:00
Willie 7c533f2012 docs: update sync and doctor pages for .skillignore visibility
- sync: add ignored_count/ignored_skills to JSON example, note about
  .skillignore filtering
- doctor: add Skillignore to environment checks table, update example
  output with skillignore line and visual spacing
2026-03-18 00:19:30 +08:00
Willie 02a5ace7f9 docs: add skillignore visibility features to v0.17.4 changelog
Add .skillignore Visibility section covering status/doctor CLI output,
Config page editor tab, Doctor page SegmentedControl unification,
and new API endpoints.
2026-03-18 00:19:30 +08:00
Willie 6852b0ee14 docs: update doctor/status/ui docs for skillignore visibility
- doctor.md: add skillignore check to JSON example, document info status
- status.md: add skillignore field to JSON schema
- ui.md: update Config page description, add skillignore/doctor API endpoints
2026-03-18 00:19:30 +08:00
Willie 4214cb1038 feat(skillignore): upgrade to full gitignore-compatible syntax
Replace the naive string matcher (~40 lines) with a proper gitignore
implementation (~200 lines, no external deps) supporting **, ?, [abc],
!negation, /anchored, pattern/ (dir-only), and \#/\! escapes.

New Matcher API (Compile, ReadMatcher, Match, CanSkipDir, HasRules)
replaces the old Match/ReadPatterns functions (kept as deprecated
wrappers). Call sites in sync.go and install_discovery.go updated.
Also fixes isDir=true for install discovery (skill paths are dirs).

100% test coverage on skillignore package (~150 table-driven cases).
Added 7 sync discovery tests and 5 install integration tests covering
**, !negation, pattern/, [Tt] char class, and combined patterns.
2026-03-18 00:19:30 +08:00
Willie 0df114decb docs: add quieter integrity checks to v0.17.4 changelog 2026-03-18 00:19:30 +08:00
Willie e04a36df85 docs(doctor): update integrity check docs to match new behavior
Local skills without meta are silently skipped. Only installed skills
with incomplete metadata show warnings with skill names listed.
2026-03-18 00:19:30 +08:00
Willie bc790bdcea docs: add #83 .skillignore bug fix to v0.17.4 changelog
Add missing bug fix entry for .skillignore not being respected in source
discovery, which caused false doctor warnings. Synced to website changelog.
2026-03-18 00:19:30 +08:00
Willie d882a1ec28 docs: add v0.17.4 changelog
- CHANGELOG.md: doctor --json, Health Check UI page, root-level .skillignore
- Website changelog synced
2026-03-18 00:19:30 +08:00
Willie a50ff861dc docs: add doctor --json documentation and quick-reference entry
- Add JSON Output section to doctor.md with structure, exit codes, CI examples
- Add doctor --json to quick-reference utilities table
- Website build: PASS (no broken links)
2026-03-18 00:19:30 +08:00
Willie a2b408003f docs: update .skillignore docs with root-level support and all-commands scope 2026-03-18 00:19:30 +08:00
Willie 6e5bae272b docs: update v0.17.3 changelog with init auto-select, TUI help bar, and server stability fixes 2026-03-17 04:50:02 +08:00
Willie f381c42266 docs: update v0.17.3 changelog and release notes with Filter Studio
Add Filter Studio, Target Distribution, Skill Detail styling, unified
input borders, and auto-commit-on-blur to changelog and release notes.
2026-03-17 04:48:42 +08:00
Willie f431525e81 docs: update v0.17.3 changelog with target filter and extras empty state fixes
Add two bug fix entries for commits landed after the initial changelog
was written: Web UI target filter persistence (saveConfig without
reloadConfig) and extras list empty state tour target.
2026-03-17 04:48:42 +08:00
Willie 41e3f6ae2b feat(init): add interactive source path prompt during init -g
Previously, `init` silently defaulted source to ~/.config/skillshare/skills/
with no way for users to discover customization without reading docs. Now
interactive mode asks whether to customize the source path (Y/N gate + text
input), with tilde expansion and filepath.Abs normalization. The success
message also hints at --source and config path for future changes.

- promptSourcePath() follows same Y/N pattern as useSourceSubdir()
- TTY guard ensures non-interactive (piped stdin, --source flag) is unaffected
- Integration test verifies success message contains source hint
- Updated init.md flowchart, --source option note, and first-sync.md steps
2026-03-17 04:48:42 +08:00
Willie 0c2d700fb9 feat(project): add --config local for centralized skills repo workflow
Enable teams to use one project as a shared skills repo where each
developer manages their own targets independently.

- Add `--config local` flag to `init -p` that gitignores config.yaml
- Auto-detect shared repo on clone via .gitignore check (no flag needed)
- Fix partialInitRepair to run interactive prompt instead of auto-select
- Export GitignoreContains, add UpdateGitIgnoreFiles for file-mode entries
- Refactor gitignore helpers to share addGitIgnoreEntries private helper
- Add 5 integration tests covering all new flows
- Add recipe docs page, update init reference, changelogs, release notes
2026-03-17 04:48:42 +08:00
Willie 603ea03ddc docs: add v0.17.3 changelog, target list TUI docs, and trash gitignore refs
- CHANGELOG.md + website changelog: v0.17.3 entry (target list TUI,
  web UI error guidance, init --help fix, project trash gitignore)
- RELEASE_NOTES_0.17.3.md: full release notes
- target.md: document interactive TUI, --no-tui flag, options table
- tui.md: add target list to TUI-enabled commands list
- SKILL.md: add target list to --no-tui command list
- project-skills, tracked-repositories, project-setup, install:
  update .gitignore references to include trash/
2026-03-17 04:48:42 +08:00
Willie 4cbaa5f3ab perf(tui): async dirSize and lazy loading in restore TUI
dirSize() was called synchronously for every backup version during list
population and on each cursor move, blocking the entire TUI event loop.

- Add ListBackupVersionsLite() that skips dirSize (TotalSize = -1)
- Compute size asynchronously via tea.Cmd, cache in versionSizeCache
- Replace redundant ListBackupVersions() in renderTargetDetail() with
  direct os.ReadDir() on the latest backup directory
- Cap per-skill I/O (readSkillDescription + listSkillFiles) to 20 items
  in both renderTargetDetail() and renderVersionDetail()
2026-03-14 04:01:10 +08:00
Willie 6a94c69e47 docs: update docs and changelog for v0.17.1
Add documentation for new features (UI theme system, init --subdir),
bug fixes (collect .git skip, actionable git errors), and release notes.
Update CHANGELOG.md, website changelog, and 6 doc pages.
2026-03-13 14:09:40 +08:00
Willie 405a2f907a feat(extras): add mode command for CLI, TUI, and Web UI
Add ability to change sync mode of an extra's target across all three
interfaces: CLI (`extras mode`/shorthand `extras <name> --mode`),
TUI (`M` key with mode picker overlay), and Web UI (inline Select
dropdown per target with PATCH /api/extras/{name}/mode endpoint).

Fix sync behavior so symlinks from a previous mode are auto-replaced
without --force, while regular files still require explicit --force.

Consolidate sync mode list into config.ExtraSyncModes single source
of truth. Fix Select component missing disabled prop and add viewport
collision detection with useLayoutEffect.

Includes 8 integration tests covering mode command happy path, error
cases, shorthand syntax, and mode-switch sync behavior.
2026-03-12 16:45:02 +08:00
Willie 5b224a1f87 fix(extras): remove unused width params, load fresh config in doRemove
Address code review findings:
- Remove unused width parameter from renderExtrasDetail and
  renderExtrasContentPanelStr to eliminate dead code
- Load fresh config in doRemove to avoid mutating the TUI model's
  config copy in a background goroutine (prevents potential data race)
2026-03-12 16:45:02 +08:00
Willie a8e2f9c57c docs(extras): document interactive TUI and --no-tui flag for extras list 2026-03-12 16:45:02 +08:00
Willie ee38d34513 refactor(diff): show extras by default, remove --extras/--all flags
Extras diff is now automatically included when extras are configured.
No need for explicit --extras or --all flags — simpler UX.

- Remove showExtras/showAll from diffRenderOpts
- Replace flag check with len(cfg.Extras) > 0
- Update integration test, built-in skill refs, website docs, changelog
2026-03-12 16:45:02 +08:00
Willie 04c669e0ba feat(website): clean design system for docs pages and add mdproof blog post
Redesign docs/non-homepage pages to match the ui/ dashboard's clean
aesthetic (solid borders, subtle blur shadows, clean border-radius)
while preserving the homepage's hand-drawn style via CSS modules.
Add blog post announcing skillshare's full migration to mdproof for
E2E testing.
2026-03-12 16:45:02 +08:00