353 Commits
Author SHA1 Message Date
Willie 012a4ba97e fix(ui): resolve stuck update checks 2026-05-25 00:33:26 +08:00
Willie a2f958d288 feat(ui): background mode, in-place upgrade, and PWA support
Three user-visible additions to the web dashboard, plus the CLI surface
needed to drive them.

* `skillshare ui start` / `skillshare ui stop` — run the dashboard as a
  managed background process. Re-running start reuses the existing
  healthy process; stop uses the remembered host/port. Foreground
  `skillshare ui` keeps working unchanged. Process tracking lives in
  ui_process_{unix,windows,other}.go via a PID + current-state file.
* `--app` — opens the dashboard in a Chromium app-mode window (Chrome,
  Edge, Brave) on macOS, Windows, and Linux for a separate Dock/taskbar
  entry without browser chrome.
* In-place upgrade from the browser — the Update dialog and the Doctor
  page's Version card now expose an Update now button. Backed by two
  new endpoints (POST /api/upgrade, POST /api/restart in
  handler_restart_upgrade.go); the browser polls GET /api/health and
  reloads once the new server is ready. Dev builds short-circuit with
  `devMode: true` and a simulated restart so the flow can be exercised
  without rebuilding the binary.
* Progressive Web App — site.webmanifest, app icons (192/512), and a
  minimal service worker registered from main.tsx. Supporting browsers
  can install the dashboard as a standalone desktop app.
* Doctor Version card redesign — state-coloured icon (blue when an
  update is available, green when up to date), explicit
  `current → latest` delta, Update button only when there is something
  to upgrade.
* i18n — translate "DEV mode" in zh-TW / zh-CN / ko (previously left
  as raw English).

Adds CHANGELOG.md and website changelog entries for v0.19.20 and
refreshes website/docs/reference/commands/ui.md to document the new
modes, --app flag, new REST endpoints, and the in-place upgrade flow.
2026-05-24 01:21:06 +08:00
Willie c60bfd3c08 chore: release v0.19.19 2026-05-23 01:18:38 +08:00
Willie 9163d3b559 chore: release v0.19.18 2026-05-22 14:48:59 +08:00
Willie 37819bf76b docs: v0.19.17 changelog + doctor path overlap section
- CHANGELOG entry covering doctor warnings, sync hint, and cline path fix
- doctor.md: new "Path Overlap" section documenting shared_target_paths
  and cross_target_discovery checks with example output and resolutions
2026-05-22 01:00:59 +08:00
Willie f01a679c56 fix(targets): revert cline paths to brand-specific dirs
Cline's official docs (docs.cline.bot/features/skills) list only
.cline/skills (project) and ~/.cline/skills (global) as supported skill
directories. The previous change to ~/.agents/skills was based on the
incorrect assumption that Cline scans the universal .agents/skills path,
which it does not.

Restore cline paths to:
  - global:  ~/.cline/skills
  - project: .cline/skills

Also remove cline from the universal-grouping sentence in the website
target reference, since cline no longer shares the .agents/skills root.

Existing users with cline enabled should manually remove stale cline
entries under ~/.agents/skills after upgrading.
2026-05-21 23:18:27 +08:00
Willie ffbf15e702 chore: release v0.19.16 2026-05-21 15:34:35 +08:00
Willie caf22760b3 docs: global config sources map (Phase 7)
- CHANGELOG.md + website changelog: Unreleased entry for v0.19.16
  covering the global `sources:` map feature plus the two behavior
  changes (extras init no longer silently backfills extras_source;
  extras source command writes to whichever field the user already
  configured).
- website/docs/understand/source-and-targets.md: add "Custom Source
  Directories" section for global mode mirroring the project-mode
  writeup, with examples, backward-compat notes, and a cross-link to
  the project-skills page.
2026-05-21 15:13:36 +08:00
Willie 1809fd491d docs(changelog): add v0.19.15 entry for custom sources feature 2026-05-20 18:42:03 +08:00
Willie b1907cd611 docs: document custom project source directories
- Add 'Custom Source Directories' section to project-skills.md covering
  the sources map, common layouts, and constraints (no target alias,
  external paths skip gitignore, .skillshare/ for ops dirs, init seeds
  default paths).
- Add troubleshooting entries for the two new error classes: malformed
  project config (fail-closed) and source/target path overlap.
2026-05-20 18:39:16 +08:00
Willie 3b9cb44be6 chore: release v0.19.14 2026-05-20 14:07:51 +08:00
Willie 3ca4d099a7 chore: release v0.19.13 2026-05-17 22:35:17 +08:00
Willie 9307fc521c chore: release v0.19.12 2026-05-14 23:43:43 +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
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 2026-05-12 21:10:08 +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 b1c29c5c9d docs: document context budget warnings and --quiet flag 2026-05-11 21:34:38 +08:00
Willie a1c6c4b588 docs: add v0.19.8 changelog entry 2026-05-08 16:03:17 +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 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 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 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.
2026-04-23 18:11:37 +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.
2026-04-22 17:59:46 +08:00
Willie c663fe542c chore: release v0.19.3 2026-04-19 09:29:18 +08:00
Willie 1a5b4f809f feat(target): add targetNaming, sync, and agentSync fields to target list JSON output
Refactors targetListJSON (global and project modes) to use the shared
buildTargetTUIItems + newTargetListJSONItem path, eliminating duplicated
item-building logic and ensuring both modes expose consistent metadata:
- targetNaming: effective naming strategy (flat/nested)
- sync: skill sync summary string
- agentSync: agent sync summary string

Adds assertions in target_agents_test.go and a new integration test
(TestTarget_List_Project_JSON_IncludesSyncMetadata) to cover the new fields.
2026-04-14 20:41:56 +08:00
Willie 85abcb8bd6 chore: release v0.19.2 2026-04-14 18:16:11 +08:00
Willie 8b72af58a1 fix(install): root orchestrator skill copies only SKILL.md (#124)
Root SKILL.md in multi-skill repos has no directory boundary — the entire
repo root is its source, which drags in project infrastructure (src/,
assets/, CI, build scripts). Now when Path="." and descendants exist,
only the SKILL.md file is copied. Children install as independent flat
directories instead of nesting under the root.

Remove orchestrator nesting logic from installSelectedSkills — each skill
now installs at the top level regardless of whether the root is selected.
2026-04-13 23:02:11 +08:00
Willie 1c0528ccf6 docs: revamp CONTRIBUTING.md with proposal workflow and PR template
Restructure contribution guidelines to clarify expectations:
- Issues are the primary entry point for all contributions
- PRs are for small fixes; features require issue + proposal first
- Implementation is handled by maintainer after proposal approval
- All development must use devcontainer (make devc)

Add PR template to surface checklist when contributors open PRs.
Add proposals/ directory with TEMPLATE.md for feature proposals.
2026-04-13 16:05:00 +08:00
Willie 77cf272f93 docs(changelog): fix v0.19.0 CLI examples
- Filter Studio section used non-existent 'targets edit' subcommand and
  invalid '--agent-mode include' value. Fix to use the real 'skillshare
  target <name>' syntax with sync-mode values (merge|symlink|copy).
- 'update agents' and 'uninstall agents' were shown without the required
  <name|--all> argument. Add a concrete example for each.
2026-04-11 15:43:06 +08:00
Willie f2a6a391bc chore: release v0.19.0 2026-04-11 03:37:48 +08:00
Willie 806045d392 docs(agents): expand docs + skillshare SKILL.md for agent workflows
- skills/skillshare/SKILL.md: mention agents commands/flags in description
- website: document agents source dir, agent backup/restore, ignores,
  file structure, config fields, and project-mode agent rules
2026-04-11 00:41:29 +08:00
Willie 788f9bc6e9 feat(agents): JSON output + audit gate for install/update
Extend install/update with agent-aware --json output and apply the same
audit block-threshold gate skills already use.

Install:
- install --json: imply --force; imply --all only when neither
  --skill nor --agent is set (so explicit selectors still work)
- project-mode install now routes through cmdInstallProjectParsed
  so --json suppresses UI and emits a pure-JSON payload
- agent installs propagate SourceDir so metadata lands in the
  agents root, not the install subdir
- validation error lists --agent / --kind / --branch explicitly

Update agents:
- update agents supports --force, --skip-audit, --audit-threshold
- tracked agent repos + metadata-backed single-file agents now run
  the same audit gate as skills; blocks roll back from a temp stage
- JSON output returns the final per-agent status
  (updated/skipped/failed/up_to_date/...) by merging check results
  with batch update outcomes

Audit:
- auditInstalledAgent shares one helper with auditInstalledSkill
  (scan + cleanup callbacks); single-file agent scans now use
  audit.ScanFile / ScanFileForProject instead of staging the file
  into a temp directory
- UpdateAgentFromDiscovery stages to temp, audits, then renames
  atomically (rename already overwrites on POSIX)

Refactors pulled in while reworking these paths:
- extract jsonUISuppressor helper in json_output.go and use it
  from install/update/update_agents; collapses 4 copies of the
  suppress/restore closure dance and the per-error failJSON block
- drop relPath plumbing from installAgentFromDiscoveryInternal
  now that ScanFile doesn't need a staged relative path
- list.go render functions now use theme.ANSI() so NO_COLOR is
  respected in plain-text output

Tests:
- add TestInstallAgentFromDiscovery_HighFindingBlocked (unit)
- add TestUpdate_Agents_HighFindingBlockedByThreshold (integration)
- add TestInstall_Project_JSON_Agent_PureJSON,
  TestUpdate_Agents_JSON_ReportsFinalStatus
- fix TestList_SKILLSHARE_THEME_Light / TestList_NO_COLOR to
  write a config before invoking list
- fix TestTargetList_NoTUI_FallsBackToPlainText assertion to match
  the new structured Mode: merge output
- fix TestDoctor_AllGood_PassesAll by pinning SKILLSHARE_THEME=dark
  so the no-TTY theme fallback warning doesn't fire
- add list_tui_content_test.go covering light/dark glamour base
- list detail pane now picks LightStyleConfig on light terminals

Docs:
- update install.md, update.md, understand/agents.md for the new
  flags, JSON shapes, and agents update workflow
2026-04-10 23:27:26 +08:00
Willie d4bd0a66df docs(sync,diff): fix agent sync description and add agent diff section
- Fix sync.md: 'sync' defaults to skills only, not skills+agents
- Fix --all flag description: syncs skills + agents + extras
- Add 'sync agents' to usage examples
- Add Agent Diff section to diff.md with usage examples
2026-04-09 23:56:03 +08:00
Willie 294be5f08a docs(ui): update sync page and API description for kind param
- Sync page now has scope selector (Skills / Agents / Both)
- POST /api/sync accepts kind param
2026-04-09 23:53:25 +08:00
Willie 22e7028747 docs: update target/filtering docs for agent filters and metadata.targets
- Add --agent-mode, --add-agent-include/exclude flags to target command docs
- Update filtering reference with agent filter examples and storage paths
- Prefer metadata.targets over top-level targets in all examples
- Note agent filter limitations (merge/copy only, requires agents path)
- Update skill-format docs with metadata.targets precedence note
- Update built-in skill references/targets.md with agent filter examples
2026-04-09 03:14:58 +08:00
Willie 081348d39b refactor(collect): unify skills/agents flow with collectPlan + generics
Replace duplicated runCollectSkills/runCollectAgents (~110 lines of 95%
identical code) with a single runCollectPlan function driven by a
collectPlan struct + toCollectResources[T] generic converter.

Key changes:

- Add collectPlan/collectResources types and runCollectPlan unified flow
- Add toCollectResources[T] generic to bridge typed slices into the
  shared pipeline (scan → display → dry-run → confirm → pull → render)
- Replace fragile err.Error() == "already exists in source" string
  matching with ErrAlreadyExists sentinel error + errors.Is()
- Move os.MkdirAll from per-agent PullAgent to PullAgents (call once)
- Add FindLocalAgents/PullAgent/PullAgents to match FindLocalSkills API
- Add target selection, --force/--dry-run/--json support for agent collect
- Add integration tests for agent collect (target filter, dry-run, force,
  JSON, oplog, project mode)
- Update collect.md, agents.md, ui.md docs for agent collect support
2026-04-09 00:36:39 +08:00
Willie 36ee2fe15f fix: tone down doctor target colors — only status word is colored
Split status word from detail in displayTargetStatus. Only the status
word (merged/drift/linked) gets color, detail text uses dim. Reduces
the "wall of green" effect in doctor output.
2026-04-08 22:26:18 +08:00
Willie baea54d938 docs: update status, doctor, diff docs for unified agent layout
status.md:
  - Fix synced→merged for agents, add [merge] mode prefix
  - Remove synced from status table
  - Update project mode example

doctor.md:
  - Update example outputs with sub-item format (target name header + skills/agents indented)
  - Add agents source to environment checks table
  - Update targets section description
  - Single-line extras format
  - Remove leading spaces from output examples
2026-04-08 22:25:00 +08:00
Willie 8d909494ee docs: update status.md for unified layout with agents in targets
- Update example output to show new layout (agents as sub-items)
- Remove outdated agents/--all flags from options table
- Fix --json note: now supported in both global and project mode
- Add agents section to JSON output example
- Rewrite project mode example with new format
- Remove fictional "Remote Skills" section
2026-04-08 22:10:10 +08:00
Willie 4a84796160 docs: document agents_source config field
The agents_source field was already implemented but had no
documentation, unlike extras_source which was fully documented.

- Add agents_source to Full Example in configuration.md
- Add dedicated agents_source field reference section
- Add Custom Source Directory section to understand/agents.md
- Note agents_source in Skills vs Agents comparison table
2026-04-08 22:04:15 +08:00
Willie 9025fb35bf docs: update website docs for centralized .metadata.json format 2026-04-08 15:14:22 +08:00
Willie d759a7e8ee docs: add agent support to all command reference and getting-started pages
Command pages updated (7 files):
- list: 'skillshare list agents', [A] badge
- install: --kind agent, -a flag, auto-detection
- sync: agent sync with all three modes, supported targets
- check: 'skillshare check agents' drift detection
- audit: 'skillshare audit agents'
- enable: --kind agent routes to .agentignore
- uninstall: --kind agent flag

Getting started updated:
- first-sync: link to agents concepts in What's Next
- quick-reference: agent management command table + agents source path

Commands index: added agents row to What do you want to do table.
2026-04-07 18:05:40 +08:00
Willie 9896aa7cd6 docs: add Agents concepts page to website documentation
Create website/docs/understand/agents.md covering:
- Skills vs Agents comparison table
- Directory structure (global + project)
- Agent file format and naming conventions
- Supported targets (claude, cursor, opencode, augment)
- Sync modes (merge/symlink/copy)
- .agentignore usage
- Install from repos with auto-detection
- CLI commands reference
- Data flow diagram

Update sidebar ordering to include agents between skill-format and
project-skills.
2026-04-07 18:05:40 +08:00
Willie 7d4e6cad42 docs: add v0.18.9 changelog and document relative symlinks in project mode 2026-04-07 17:26:37 +08:00
Willie e82d18cfa4 fix: sync must not prune registry entries for installed skills
Sync's registry prune logic removed entries for installed skills whose
files were missing from disk. This was wrong: the registry is the
authoritative record of installations managed by install/uninstall.

Remove PruneStaleSkills calls from sync (CLI global, CLI project, and
web UI handler). Reconcile (called during install) still uses prune
with full metadata context, which is correct.

Fixes: running 'sync' after 'install' would clear registry.yaml when
the installed skill's source files were not yet on disk.
2026-04-06 17:28:10 +08:00
Willie 9ddff32f42 docs(blog): update legacy target config format to current style
Migrate flat targets format (targets.claude.path) to nested skills
sub-key format (targets.claude.skills.path) for consistency across
all blog posts.
2026-04-05 20:51:04 +08:00
Willie 17da67aaff fix(blog): correct image path and remove outdated posts
Fix Docusaurus build error: /static/img/ → /img/ for markdown images.
Remove e2e-testing-for-ai-agents and e2e-tests-now-powered-by-mdproof
blog posts.
2026-04-05 20:31:46 +08:00
Willie 9a02d82554 docs(blog): add multi-account Claude Code setup guide
Covers setting up multiple Claude Code accounts via CLAUDE_CONFIG_DIR
aliases, syncing skills across accounts with skillshare targets, and
syncing rules/hooks/agents with the extras feature. Includes web UI
section and full config example.
2026-04-05 20:26:47 +08:00