Commit Graph
247 Commits
Author SHA1 Message Date
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
Willie 9501b59874 docs: update v0.17.0 changelog with UI redesign and additional bug fixes
Add Web UI redesign section (clean design, table view, keyboard shortcuts,
onboarding tour) and two missing bug fixes (dotdir skipping during install
discovery, sync collision message). Sync website changelog from v0.16.15
to v0.17.0 entry. Update release notes with matching content.
2026-03-12 16:45:02 +08:00
Willie 91d22fbaf5 docs: fix extras source paths and remove incorrect global-only claims
Extras source dir is under extras/ subdirectory (~/.config/skillshare/extras/<name>/),
not directly under the config root. Also, sync extras and the extras config field
both support project mode — removed incorrect "global only" admonitions.

- extras.md: fix source path references and example output
- sync.md: replace global-only admonition, fix directory structure diagram
- configuration.md: fix source path, add extras/ to overview tree
- index.md: add Extras Management category with extras command
2026-03-12 16:45:02 +08:00
Willie dfaf34215c docs: update website and built-in skill for extras first-class support
- diff.md: add --extras and --all flags
- status.md: add Extras section for sync status display
- doctor.md: add Extras health check section
- quick-reference.md: add Extras Management table and extras path
- project-skills.md: add extras to Mode Restrictions (supported) and directory structure
- sync-modes.md: add Extras Sync Modes section
- declarative-manifest.md: add Extras Configuration section
- SKILL.md: add extras commands to Quick Lookup table
2026-03-12 16:45:02 +08:00
Willie 9f8970c6c0 docs: add extras command reference and update sidebar 2026-03-12 16:45:02 +08:00
Willie 655c22036a docs: add JihuLab auto-detection to changelog and release notes 2026-03-12 16:45:02 +08:00
Willie 2826633eef feat(install): auto-detect JihuLab hosts for nested subgroup support
JihuLab (jihulab.com) is a GitLab distribution that supports nested
subgroups but its hostname doesn't contain "gitlab". Add "jihulab" to
the built-in host detection so URLs like jihulab.com/group/sub/project
are parsed as full-path repos without requiring gitlab_hosts config.
2026-03-12 16:45:02 +08:00
Willie 2769eaa8e8 docs: update changelog, release notes, and E2E runbook for gitlab_hosts
- CHANGELOG/website: add gitlab_hosts config and SKILLSHARE_GITLAB_HOSTS
  env var to New Features section, add HTTPS fallback bug fix
- RELEASE_NOTES: expand with EffectiveGitLabHosts design decisions,
  env var merge semantics, and project-mode isolation
- Runbook: extend gitlab_hosts_config_runbook from 10 to 18 steps
  covering env var merge, persistence safety, server parseOpts isolation,
  and CLI-level env var smoke tests (18/18 PASS verified)
2026-03-12 16:45:02 +08:00
Willie 8f16a90e5f feat(config): add SKILLSHARE_GITLAB_HOSTS env var and cleanup
Support CI/CD pipelines that need gitlab_hosts without a config file.
The env var is comma-separated and merged (deduplicated) with config
file values in both global and project modes.

Also cleans up from review:
- Extract isValidGitLabHostname to share validation logic
- Remove redundant ToLower before EqualFold in isGitLabHost
- Revert 3 no-opts call sites back to ParseSource()
- Add parseOptsFromProjectConfig helper to reduce inline duplication
- Fix project mode LoadProject missing env var merge
- Add install.md tip about custom GitLab domains
2026-03-12 16:45:02 +08:00
Willie a4d52615f7 feat(config): add gitlab_hosts for custom GitLab domain support
Self-managed GitLab instances on custom domains (e.g., git.company.com)
without "gitlab" in the hostname were parsed with 2-segment owner/repo
split instead of full-path repo. Users can now declare extra GitLab
hostnames in config so the parser treats them like gitlab.com (nested
subgroup support).

- Add `gitlab_hosts` field to both global and project Config structs
- Validate entries at load time (reject scheme, path, port, empty)
- Add `ParseOptions` / `ParseSourceWithOptions` to thread hosts into parser
- Add `isGitLabHost()` helper combining built-in + custom host detection
- Extend `InstallContext` interface with `GitLabHosts()` method
- Update all ParseSource call sites (install, search, update, server)
- Add JSON schemas for both config files
- Add unit tests for config validation and source parsing
- Add E2E runbook for devcontainer verification
- Document in configuration reference and URL formats appendix
2026-03-12 16:45:02 +08:00
Willie e2a8c7da2c fix(install): platform-aware HTTPS fallback to preserve GHE subdir behavior
The initial GitLab subgroup fix treated all multi-segment HTTPS paths as
full repo paths, regressing GHE and generic host subdir installs like
github.mycompany.com/org/repo/path/to/skill.

Add host-based heuristic: hosts containing "gitlab" use full-path-as-repo
behavior; all other hosts retain the original 2-segment owner/repo split
with remainder as subdir. This preserves backward compatibility for GHE,
Gitea, Gogs, and other non-GitLab platforms while correctly handling
GitLab nested subgroups.
2026-03-12 16:45:02 +08:00
Willie bf9eaa5e29 fix(install): support GitLab nested subgroup URLs (#72)
Replace rigid 2-segment HTTPS regex with flexible path parsing that
treats the entire URL path as a repo when no explicit boundary exists.
Use .git suffix as the canonical repo/subdir delimiter, preserving
/-/ (GitLab) and /src/ (Bitbucket) web URL markers.

This fixes install failures for URLs like
onprem.gitlab.internal/org-group/sub1/sub2/project which previously
misinterpreted extra path segments as monorepo subdirectories.
2026-03-12 16:45:02 +08:00
Willie 404ad0afde fix(tui): replace 256-color gray gradient with SGR dim in skill path rendering
colorSkillPath() and colorSkillPathBold() used Color("241")~Color("249")
gradient for subdirectory segments — fixed palette grays that render
inconsistently across terminal themes. Replace with tc.Dim (SGR faint).
2026-03-09 12:47:03 +08:00
Willie 7c582cbe21 docs: update v0.16.13 changelog to match project style
Expand bug fix descriptions, add grouped layout ASCII example,
and sync website changelog.
2026-03-06 23:10:48 +08:00
Willie 657b833569 fix: suppress devcontainer redirect for -j flag and show tracked badge in filter mode
- Add -j short flag to wants_machine_output() in devcontainer wrapper,
  preventing stderr banner noise for `skillshare list -j` etc.
- Show tracked repo name badge on skill items so filtered results remain
  distinguishable when group headers are absent. Two tracked skills from
  different repos now render with their repo origin visible.
2026-03-06 23:10:48 +08:00
Willie 9b5429a3fd feat(targets): add Warp, Purecode AI, Witsy targets
Add 3 new AI agent targets discovered from vercel-labs/skills PRs:
- warp: universal path (~/.agents/skills)
- purecode (alias: purecode-ai): ~/.purecode/skills (global), .agents/skills (project)
- witsy: universal path (~/.agents/skills)

Update website docs: badge grid, path table, alias table, universal
info box, and target counts (50+ → 55+).
2026-03-06 23:10:48 +08:00
Willie d707fc619b fix(cli): suppress stderr progress messages in --json mode
JSON mode stdout was already pure JSON, but stderr still emitted
progress lines (e.g. "Discovering skills...", "Found N local skill(s)")
which broke `2>&1 | jq .` pipelines. Remove the else-branch stderr
writes so --json mode is fully silent except for stdout JSON output.
2026-03-06 02:15:36 +08:00
Willie 71f560331b docs: add v0.16.12 changelog
Structured JSON output for 8 commands (sync, install, update,
uninstall, collect, target list, status, diff), bringing total
--json coverage to all 12 major CLI commands.
2026-03-06 02:15:36 +08:00
Willie f03ba456c0 chore: update docs 2026-03-06 02:15:36 +08:00
Willie 6730760215 feat(audit): add hardcoded secret detection (10 rules)
Detect inline API keys, tokens, and passwords in skill files via 10 new
hardcoded-secret-* rules (HIGH severity): Google API keys, AWS access
keys, GitHub PATs (classic + fine-grained), Slack tokens, OpenAI keys,
Anthropic keys, Stripe keys, PEM private key blocks, and generic
api_key/password assignments.

Closes a gap where GitHub Secret Scanning caught a Google API key in a
skill file but our audit engine missed it entirely.
2026-03-05 02:34:24 +08:00
Willie 7e072c33c9 feat(ui): replace "Show more" pagination with virtualized scrolling
AuditPage: use Virtuoso with useWindowScroll for skill audit cards.
SyncPage: use Virtuoso with fixed-height container for diff items
(100+ threshold), flat render for small lists.
2026-03-05 02:13:21 +08:00
Willie 2af44f1d3f chore(skills): strengthen built-in skill descriptions and content
Improve all 5 active skills with pushy descriptions for better
triggering accuracy, following devcontainer as the gold standard.

- changelog: add trigger scenarios (release notes, version prep)
- cli-e2e-test: add trigger scenarios (runbook, E2E validation)
- codebase-audit: add 3 new audit dimensions (handler split, oplog
  coverage, web API consistency) and trigger scenarios
- implement-feature: add project patterns reference (handler split,
  dual-mode, TUI, web API, oplog) and trigger scenarios
- update-docs: expand scope to all 7 doc categories with code-to-doc
  mapping guide and trigger scenarios

Also remove empty .skillshare/skills/frontend/ directory.
2026-03-05 02:13:21 +08:00
Willie 272735c607 feat(install): detect SSL certificate errors and show actionable guidance
When git operations fail due to SSL certificate issues (self-signed certs,
internal CAs), the error message now suggests GIT_SSL_CAINFO, GIT_SSL_NO_VERIFY,
and SSH as alternatives instead of showing raw git stderr.

Env vars like GIT_SSL_CAINFO are already inherited via os.Environ() in
gitCommand() — the actual gap was error detection and user guidance.
2026-03-05 02:13:21 +08:00
Willie 5bfca0e12d docs: add v0.16.10 changelog, tui command page, and release notes
Add CHANGELOG and website changelog entries for v0.16.10 covering
sync extras and tui toggle features. Create dedicated tui command
reference page and register it in sidebar and commands index.
Bump built-in skill version to v0.16.10.
2026-03-04 12:16:32 +08:00
Willie 9b849172ff docs: add sync extras documentation across website, skill, and README
Document the new `sync extras` subcommand and `--all` flag:
- sync.md: add Sync Extras section with config, modes, flowchart, example
- configuration.md: add `extras` field reference with schema table
- file-structure.md: show extras source directories alongside skills
- quick-reference.md: add sync extras and sync --all entries
- SKILL.md + references/sync.md: add extras recipes for AI callers
- README.md: add v0.16.10 to Recent Updates
2026-03-04 12:16:32 +08:00
Willie 6caf73faf0 docs(audit): split monolith audit.md into focused pages
The 1294-line audit.md mixed command reference, conceptual teaching,
rule management, and CI/CD recipes. Split into:

- understand/audit-engine.md — threat model, detection rules, risk
  scoring, command tiering, cross-skill analysis
- reference/commands/audit-rules.md — rule management, custom rules,
  built-in rule IDs table (adds 4 cross-skill finding IDs)
- how-to/recipes/ci-cd-skill-validation.md — absorb output format
  docs (SARIF, Markdown, JSON+jq, exit codes)
- reference/commands/audit.md — slim to ~370 lines, link to new pages

Also fixes:
- Replace ghost rule `system-writes-0` with `insecure-http-0` in all
  docs (the old ID no longer exists in rules.yaml)
- Update 3 cross-page links in security.md
- Update 1 rule ID in configuration.md
- Add sidebar entries for both new pages
2026-03-04 12:16:32 +08:00
Willie ef26da2280 chore: update docs 2026-03-03 16:08:11 +08:00
Willie 6d9545cb04 fix(audit): populate policy fields before TUI launch and update docs
applyPolicyToSummary was called in cmdAudit after auditInstalled/
auditFiltered returned, but both functions call presentAuditResults
(which launches the TUI) internally — so summary.PolicyProfile was
empty when the TUI rendered. Move applyPolicyToSummary before
presentAuditResults in both functions.

Also fix dedupe default label (global is now the default, not legacy)
and update audit/status docs to reflect current output format.
2026-03-03 16:08:11 +08:00
Willie d1e7f6558a feat(audit): wire --analyzer CLI flag, config field, and update docs
- Add EnabledAnalyzers []string to AuditConfig struct
- Add enabled_analyzers to both JSON schemas (config + project)
- Parse --analyzer repeatable flag in audit command
- Wire config → PolicyInputs → Registry for all scan paths
  (ParallelScan, single skill, single path, filtered)
- Add PolicyAnalyzers to JSON summary output
- Server handler also reads config enabled_analyzers
- Update audit.md: Policy & Profiles section, Finding Schema table,
  --profile/--dedupe/--analyzer in Options table and examples
- Update configuration.md: expanded audit section with all new fields,
  profile table, analyzer IDs, precedence rules
2026-03-03 16:08:11 +08:00