1588 Commits
Author SHA1 Message Date
Willie 9307fc521c chore: release v0.19.12 v0.19.12 2026-05-14 23:43:43 +08:00
Willie 821178cb91 chore: release v0.19.11 v0.19.11 2026-05-14 13:28:11 +08:00
Willie 3b2f062cf0 docs: add v0.19.11 changelog, preserve_tilde_on_save docs, fix CI test
- Add changelog entry for v0.19.11 (preserve_tilde_on_save, backups gitignore)
- Document preserve_tilde_on_save in configuration reference, cross-machine sync, FAQ
- Fix TestFoldHomePath/unrelated-abs: use /opt/unrelated/foo instead of /tmp/foo (CI sets HOME=/tmp)
- Add iFwu to README contributors
2026-05-14 13:22:23 +08:00
iFwu 5403595120 feat(config): preserve ~ in saved config paths (opt-in)
Add PreserveTildeOnSave config flag (default false). When enabled, the
Save path folds $HOME prefixes back to ~ when serializing the in-memory
Config to YAML so the on-disk config stays portable across machines
(e.g. when shared via dotfiles).

The in-memory Config is left untouched; cloneForSave() produces a
shallow copy with path fields rewritten. Mirrors the existing
expandPath() calls performed in Load():
  - cfg.Source, cfg.ExtrasSource
  - cfg.Targets[*].Path / Skills.Path / Agents.Path
  - cfg.Extras[*].Source and Extras[*].Targets[*].Path

Adds:
  - utils.FoldHomePath() helper with unit tests (exact-home, child,
    sibling-non-home, unrelated-abs, relative, Windows case-insensitive)
  - 3 Save-path tests covering default-off, fold-on, and Load→Save
    idempotency.

Default off keeps the change backward compatible: existing users see no
behavior difference. Users who share their config via dotfiles can opt
in with:

    preserve_tilde_on_save: true
2026-05-14 13:09:56 +08:00
Willie fb821b7328 fix(project): add backups/ to .skillshare/.gitignore managed dirs
Project mode agent backup (sync --agents, backup -p) creates
.skillshare/backups/ but it was not gitignored — backup artifacts
could be accidentally committed.

Agent backup was added in 95c46ca8 (2026-04-06), after the gitignore
fix in 90c096b8 (2026-03-16) which only covered logs/ and trash/.
2026-05-13 03:49:40 +08:00
Willie 56fafb53e0 fix: preserve update metadata keys for symlinked sources v0.19.10 2026-05-12 21:10:08 +08:00
Willie 56007efa5c chore: fix lint error 2026-05-11 23:46:43 +08:00
Willie 9a7271c1ae fix: address PR #151 review feedback
- Project mode JSON sync now includes context_cost (was nil)
- Server handler respects symlink mode (skips include/exclude filters)
- checkBudget reports all targets exceeding threshold (not just worst)
- Budget warnings include target name in CLI and UI output
- ConfigPage indentation restored to original 2-space style
v0.19.9
2026-05-11 21:34:38 +08:00
Willie 786af85ae4 feat(ui): add i18n for context cost section on Sync page
All 11 locales: en, zh-TW, zh-CN, ja, ko, de, es, fr, pt-BR, id, fa.
2026-05-11 21:34:38 +08:00
Willie 1acfd4b9fe docs: add --quiet flag to sync flags table and context_cost to JSON example
Also documents context_budget config block in configuration reference
with field types, defaults, and cross-link to sync docs.
2026-05-11 21:34:38 +08:00
Willie 5bf9f839e2 docs: add v0.19.9 changelog entry
Context budget warnings (issue #150), --quiet flag, Web UI context
cost display, and HTTP protocol install fix.
2026-05-11 21:34:38 +08:00
Willie 06d2f9fefa refactor(ui): remove redundant context budget card from ConfigPage
The assistant panel already shows field documentation via JSON schema.
A static reference card is redundant and breaks the page's interaction
pattern of cursor-driven contextual help.
2026-05-11 21:34:38 +08:00
Willie 98688ac316 fix: add context_budget to JSON schema for config validation
Both global and project schemas now recognize context_budget,
resolving the 'Unknown field' warning in the Config page.
2026-05-11 21:34:38 +08:00
Willie 402fe38340 refactor: simplify budget warning code after review
- Define budgetTypeAlwaysLoaded/budgetTypeOnDemand constants
- Add showDetails param to printBudgetWarning; analyze reuses it
- Hoist buildAnalyzeEntries call to avoid duplicate computation
- Remove WHAT-comments that restate function names
2026-05-11 21:34:38 +08:00
Willie b1c29c5c9d docs: document context budget warnings and --quiet flag 2026-05-11 21:34:38 +08:00
Willie 60ed5eb857 feat(ui): add context budget reference to Config page 2026-05-11 21:34:38 +08:00
Willie 1ea07afeea feat(ui): display context cost and budget warnings on Sync page 2026-05-11 21:34:38 +08:00
Willie 9510476c45 feat(server): include context_cost in sync API response
Self-contained token estimation (chars/4) since buildAnalyzeEntries
is in main package. Returns grouped counts and budget violations.
2026-05-11 21:34:38 +08:00
Willie f173b1d456 test(sync): add integration tests for token summary and budget warnings
DiscoverSourceSkillsWithStats did not set collectContext=true, so
DescChars/BodyChars were always 0 when sync called buildAnalyzeEntries.
Add DiscoverSourceSkillsWithStatsAndContext that enables both ignore
stats and context collection in a single walk, and use it in sync.go
and sync_project.go.
2026-05-11 21:34:38 +08:00
Willie 76a242c019 feat(analyze): show budget warning when thresholds exceeded
Reuses checkBudget from sync_budget.go. No top-offender list
since analyze already shows the full per-skill breakdown.
2026-05-11 21:34:38 +08:00
Willie 87c355c76d feat(sync): add context_cost to JSON output
Always included in --json mode regardless of --quiet flag.
Contains grouped token counts and budget violation warnings.
2026-05-11 21:34:38 +08:00
Willie cfc7502774 feat(sync): wire up token summary and budget warnings in sync CLI
Add --quiet/-q flag to suppress token summary and budget warnings.
Both global and project sync paths call buildAnalyzeEntries after
SyncSummary to display context cost and budget violations.
2026-05-11 21:34:38 +08:00
Willie 8af9a89774 feat(sync): add printTokenSummary and printBudgetWarning 2026-05-11 21:34:38 +08:00
Willie 1d29686962 feat(sync): add core budget functions with unit tests 2026-05-11 21:34:38 +08:00
Willie a945b3c0c5 feat(config): add ContextBudgetConfig for token budget warnings 2026-05-11 21:34:38 +08:00
eekryuos a54bd20abe Fix install command not works with http protocol 2026-05-11 04:19:58 +08:00
Willie b88fb80305 chore: update Github 2026-05-11 03:41:47 +08:00
Willie d8007dd750 refactor: simplify completion with struct map, fix nushell gaps
- Replace three switch statements with a single shells map[string]shellDef
- Add missing --add-agent-{include,exclude} and --remove-agent-{include,exclude}
  flags to nushell target completion
- Fix nushell audit using 'target?' instead of 'subcommand?'
- Replace raw fmt.Println with ui.Info in post-install hints
- Use testutil assertion helpers in integration tests
- Verify --install actually writes the file to disk
v0.19.8
2026-05-08 16:06:14 +08:00
Willie a1c6c4b588 docs: add v0.19.8 changelog entry 2026-05-08 16:03:17 +08:00
Willie 20a6c7b475 docs: add @chaosky to contributors (#148) 2026-05-08 16:01:51 +08:00
Willie 084cc01792 docs: add completion command documentation (#148)
- New website/docs/reference/commands/completion.md page
- Update commands index with completion entry
- Update quick-reference with completion shortcut
- Add shell completion to README highlights
2026-05-08 16:01:16 +08:00
Willie f60976645b feat: add alias auto-detection to completion scripts
Bash, zsh, and PowerShell completion scripts now auto-detect aliases
pointing to skillshare (e.g. alias ss=skillshare) and register
completions for them. Also adds powershell/nushell to the shell
options in all completion scripts.
2026-05-08 15:58:42 +08:00
Willie 79cb6c2410 feat: add powershell/nushell completion + fix bash fallback (#148)
- Add PowerShell and Nushell completion scripts
- Fix bash completion when bash-completion package is not installed
  (fallback from _init_completion to manual COMP_WORDS parsing)
2026-05-08 15:54:16 +08:00
Willie 829851f420 feat: add shell completion command for bash/zsh/fish (#148)
Add 'skillshare completion <shell>' command that generates shell
completion scripts. Supports --install flag to auto-write the script
to the correct platform path.

Covers all commands, subcommands, and per-command flags for bash,
zsh, and fish shells.
2026-05-08 15:49:33 +08:00
Willie 5975c1109a test: add regression tests for azure_hosts wiring in project install and agent update
- TestParseOptsFromConfig_IncludesAzureHosts: verify global config
  helper passes AzureHosts to ParseOptions
- TestParseOptsFromProjectConfig_IncludesAzureHosts: verify project
  config helper passes AzureHosts
- TestParseOptsFromProjectConfig_AzureHostsParseOnPrem: end-to-end
  verify project config azure_hosts produces correct on-prem CloneURL
- TestUpdateAgent_AzureOnPrem_UsesParseOpts: verify server agent
  update handler parses on-prem Azure source via ParseSourceWithOptions
v0.19.7
2026-05-05 19:26:11 +08:00
Willie 204340c2e0 fix: wire azure_hosts through project install and agent update paths
- install_project.go: pass AzureHosts to temporary Config (was only
  passing GitLabHosts, so project-mode direct install ignored azure_hosts)
- update_agents.go: thread ParseOptions through batchUpdateAgents and
  reinstallAgent, replacing bare ParseSource with ParseSourceWithOptions
- handler_update.go: use ParseSourceWithOptions with s.parseOpts() for
  agent update in web UI

Without this fix, azure_hosts in .skillshare/config.yaml was silently
ignored during project install and agent update, causing on-prem Azure
DevOps URLs to be parsed incorrectly.
2026-05-05 18:54:45 +08:00
Willie e48a301623 feat: add azure_hosts config for Azure DevOps Server on-premises
Add azure_hosts config parameter (analogous to gitlab_hosts) that allows
users to register self-hosted Azure DevOps Server hostnames so they
receive proper URL parsing without appending .git to clone URLs.

- Add AzureHosts field to Config and ProjectConfig structs
- Add SKILLSHARE_AZURE_HOSTS env var support with merge semantics
- Generalize hostname validation into shared normalizeHostList/mergeHostsFromEnv
- Add azureOnPremPattern regex and parseAzureOnPrem for /_git/ URL routing
- Add isAzureHost for config-based host detection (no auto-detect)
- Update TrackName to handle on-prem Azure DevOps clone URLs
- Wire AzureHosts through InstallContext, ParseOptions, and Server
- Add JSON Schema, UI fieldDocs, and website documentation
- Add 19 new tests covering config, source parsing, and server

Closes #147
2026-05-05 18:33:07 +08:00
Willie d2946cb4d1 fix(tests): align integration tests with cursor project path change
The cursor target's project path was updated from .cursor/skills to
.agents/skills in 57b0649d but three integration tests still asserted
the old path:

- TestInitProject_Fresh_CreatesStructure
- TestInitProject_Discover_WithMode_AddsTargetMode
- TestSyncProject_MultipleTargets

Fix testutil knownPaths map and test assertions to match the new path.
Discover test now uses windsurf (unique path) instead of cursor
(grouped at .agents/skills with 10+ other targets).
v0.19.6
2026-05-05 12:11:06 +08:00
Willie 57b0649d20 feat(targets): add 8 new agent targets and update cursor project path
Add AiderDesk, CodeArts Agent (Huawei), Code Studio (Syncfusion),
Devin for Terminal (Cognition), Dexto, ForgeCode, Rovo Dev (Atlassian),
and Tabnine CLI as built-in targets (56 → 64).

Update Cursor's project-level skill path from .cursor/skills to
.agents/skills to match Cursor's official documentation, which now
lists both paths as supported with .agents/skills as the ecosystem
standard convention. Global path (~/.cursor/skills) and agents paths
are unchanged.

All paths verified against official documentation or source code.
Codemaker excluded — no official docs confirm SKILL.md support.
2026-05-05 11:55:26 +08:00
Willie e2cb9f66fc fix(sync): expand grouped target members in host path inference
GroupedProjectTargets() merges targets sharing the same project path
into a single canonical entry, dropping member targets. For example,
.agents/skills is shared by universal, codex, amp, and others, but
only 'universal' was returned as the inferred target.

Expand Members in getProjectTargetPaths() so all targets sharing a
project path are included in inference results.
2026-05-05 04:07:16 +08:00
Willie a4da5fc7f6 fix: migrate legacy root orchestrator updates 2026-05-01 13:25:37 +08:00
hhh2210 0821cb7111 fix(sync): address host target inference review 2026-04-29 18:47:05 +08:00
hhh2210 851f06dc0a fix(sync): infer targets from host skill paths 2026-04-29 18:47:05 +08:00
Willie 0c2981d24d feat(search): add repo-scoped results and inline frontmatter parsing
- Add repositoryMatchScore so popular repos matching the query (e.g. 'superpowers')
  rank above lower-signal exact-name copies; rebalance weights to fit.
- Fetch additional skill candidates via GitHub repository search + git tree API,
  surfacing SKILL.md files from well-known repos that code search misses.
- Prioritize preferred skill repos when batching star enrichment so their star
  counts are always populated within the fetch cap.
- Parse one-line '--- name: ... description: ... ---' frontmatter so single-line
  SKILL.md files are discoverable and render correct metadata.
- Update CHANGELOG/website changelog for v0.19.5.
v0.19.5
2026-04-23 18:11:37 +08:00
Willie 07c091529b refactor(search): harden preview error handling, cache, and a11y
- Add ErrSkillNotFound sentinel error in search/preview.go so callers
  can distinguish 404 from other errors with errors.Is instead of
  brittle string matching
- Cap previewCache at 200 entries with TTL purge + full reset on
  overflow to prevent unbounded memory growth
- Make Card and SearchResultsTable rows keyboard-accessible
  (role=button, tabIndex=0, Enter/Space handlers)
- Refactor SkillPreviewModal to accept a single SearchResult prop
  instead of 6 individual fields — reduces prop drilling and keeps
  the modal in sync with the result shape
- Fix search_online_test: add --list flag so output is not gated
  behind interactive TUI
2026-04-23 16:46:53 +08:00
Willie 4c5c56bb05 feat(search): improve result quality with rebalanced scoring and quality filters
Search results were dominated by low-quality repos because the scoring
formula gave name match 45% weight while stars (the strongest quality
proxy) only had 5%. Zero-star personal experiments ranked above
well-known skill repos.

Changes:
- Rebalance scoring weights: name 30%, desc 20%, stars 25%, source 25%
- Improve normalizeStars curve (log10/3.0) for better differentiation
  in the 5-50 star range where most useful skills live
- Lower sourceQualityScore base from 0.35 to 0.15 for unknown repos
- Add filterLowQuality(): remove 0-star non-preferred repos, short
  descriptions (<10 chars), and known spam orgs (inference-sh)
- Refactor search pipeline: extract buildGitHubCodeSearchQuery(),
  processSearchItems(), convertToSearchResult() for testability
- Add preferred repo boosting (anthropics/skills, vercel-labs/skills)
- Add SKILL.md frontmatter validation to filter non-skill results
- Add equivalent skill deduplication (same name+description → keep
  best source)
- Add repo-scoped query support (owner/repo[/subdir] patterns)

Closes #130 in .feature-radar/opportunities/
2026-04-23 16:26:14 +08:00
Willie a3235473eb feat: add skill preview modal to Search page (#141)
Add a preview modal so users can read a skill's SKILL.md content
before installing. Clicking a search result card or table row opens
the modal; the Install button is now inside the modal.

Backend:
- New GET /api/preview?source=owner/repo/path endpoint
- FetchSkillContent fetches SKILL.md from GitHub Contents API
- Git Tree API fallback for hub sources where the install shorthand
  doesn't match the repo's actual file path
- In-memory TTL cache (5 min) via sync.Map
- Proper 404/429/500 error handling with rate-limit support

Frontend:
- SkillPreviewModal component (DialogShell-based, lazy-fetch)
- Cards and table rows clickable to open preview
- Graceful fallback: if fetch fails but hub metadata exists, show
  description + tags instead of error
- Hide Stars column in table view for hub mode
- Fix Card component missing onClick prop passthrough
- Fix IntersectionObserver not reconnecting after loading more items
- Prevent background scroll when any modal is open (DialogShell)
- i18n keys added to all 11 locales

Closes #141
2026-04-23 14:20:42 +08:00
Willie d9ee14aa42 feat(search): add FetchSkillContent for remote skill preview
Fetches full SKILL.md from GitHub Contents API, parses frontmatter
metadata (name, description, license, tags), and returns star count.
Reuses existing ghclient auth and rate-limit patterns.

Ref: #141
2026-04-23 09:57:22 +08:00
Willie 63a4a57a0c feat(ui): allow editing source URL on skill detail page
Add PATCH /api/resources/{name}/source endpoint to update the source URL
for installed skills. For tracked repos, all sibling skills sharing the
same git remote are updated together with the new repo base URL, and the
git remote origin is also updated.

Frontend changes:
- Add Source URL input field in the skill editor (visible for all skills
  with metadata)
- Use shared Input/Textarea components in FrontmatterEditor for visual
  consistency, with new size='sm' variant
- Replace custom kind-badge/tracked-badge with shared KindBadge/SourceBadge
  components in the editor header
- Preserve original YAML frontmatter formatting when only the body or
  source URL is changed (avoids spurious quote style / line wrap diffs)
- Skip diff review dialog when only source URL is modified

Backend fixes:
- Two-pass skill lookup in handleGetSkill: prefer exact FlatName match
  over baseName fallback to prevent name collisions between standalone
  and tracked repo skills
- Add basename-only fallback in MetadataStore.GetByPath for tracked repo
  skills stored with short keys
- Use cfg.Source (global) consistently in save/patch handlers to match
  the source used by list/detail handlers in project mode

Closes #142
2026-04-22 23:06:53 +08:00
Willie 60ec8195e4 docs: add v0.19.4 changelog and E2E runbook for local install source preservation
Add changelog entry for v0.19.4 covering the CleanupDiscovery fix (#139)
and  token highlighting. Include E2E runbook that verifies local
source files survive CLI install, API discover, and API batch install.
v0.19.4
2026-04-22 17:59:46 +08:00