- update --prune: detect skills deleted upstream and move them to trash
(batch + single-target paths), clean registry entries after prune
- update without --prune: warn about stale skills with suggestion
- check: report "stale" status for skills whose subdir no longer exists
in the remote repo (previously misreported as update_available)
- Refactor updateTrackedRepo, updateRegularSkill, updateTrackedRepoQuick,
updateSkillFromMeta to accept *updateContext instead of 7-10 individual
params; delete dead updateSkillOrRepo function
- Add integration tests for prune (standalone, nested, all-stale,
registry cleanup) and project-mode prune
- Update website docs for update --prune and check stale status
Homebrew path: replace direct stdout pipe with TreeSpinner + bytes.Buffer
so brew output no longer breaks the tree layout. Captured output is only
shown on failure for debugging.
GitHub release path: switch download/UI-asset spinners from StartSpinner
to StartTreeSpinner with correct isLast flags, add tree-line prefix to
confirmation prompt, use StepEnd for cancel.
Add TreeSpinner.Warn() and TreeLine() helper to internal/ui.
Add devcontainer test-brew-upgrade script to simulate Homebrew path.
- Summary line: CRITICAL/HIGH/MEDIUM/LOW/INFO colored by severity
- Risk label: colored by severity (e.g. red for CRITICAL)
- Finding groups: severity-colored prefix, locations on separate
indented gray line (maxLocs reduced from 5 to 3)
- Add visual gap between summary block and finding details
- Replace SkillBox with inline tree steps (Desc, License, Location)
for single-skill and tracked-repo install output
- Add custom application-level filter to dir picker and skill select
TUIs, replacing bubbles built-in filter for consistency with
list/search/log TUI pattern
- Add renderSkillMeta/renderTrackedRepoMeta/truncateDesc helpers
Move Header + StepStart before filesystem scan and metadata reads so
users see immediate feedback instead of a frozen terminal.
- check: Header printed before GetTrackedRepos/GetUpdatableSkills
- check filtered: Header printed before resolve phase
- Add spinners during blocking scan/resolve phases
- Unify tree structure: Repo/Skill use StepContinue (not StepStart)
- Add "(tracked)" label to tracked repo in update output
Enrich the single-skill install SkillBox with the SKILL.md frontmatter
description field, giving users useful context instead of repeating the
skill name. License line appended when present.
- Add Description field to SkillInfo struct
- Use ParseFrontmatterFields to read description + license in one pass
- Extract buildSkillBoxDesc helper for the two single-skill call sites
- Extract renderTUIFilterBar() shared by list, log, and search TUIs
- Extract renderPageInfoFromPaginator() for shared page info rendering
- Replace built-in bubbles filter with custom textinput filter in log
and search TUIs (matches list_tui pattern: / enter, esc clear, enter lock)
- search_tui: filter mode suppresses action keys (space/a/enter/s) to
avoid accidental checkbox toggles while typing
- Align status line left (remove extra indentation) across all TUIs
- Add ←→ page hint to all TUI help lines
- Unify pterm spinner to braille dot pattern (⣾⣽⣻⢿⡿⣟⣯⣷) with cyan
style, matching bubbletea spinner.Dot used in list_tui
- Move data loading inside TUI with bubbles/spinner to eliminate
blank screen after entering alt screen
- Thousand separators in status line (108,749 skills)
- Page info in status line (Page 2 of 4,729) replacing raw "1/4944"
- Fix "(showing 1,000)" appearing with empty filter text
- Parallel ReadMeta with bounded worker pool (64 workers)
- Parallel git dirty checks in uninstall (8 workers)
- Use DiscoverSourceSkillsLite for uninstall --all discovery
handleGitInstall has two single-skill paths (subdir and non-subdir)
that always printed "✓ Installed: <name>" even in dry-run mode.
Branch on opts.DryRun to show "[dry-run] Would install: <name>" instead,
matching the multi-skill path behavior.
Fixes failing CI tests: TestInstall_Auth_HTTPSPublicWithToken,
TestInstall_RemoteGitHubSubdir_DryRun.
Grow the detail panel from 12 to 16 reserved lines so more metadata is
visible. Description now word-wraps to terminal width (up to 3 lines
with trailing "..." when truncated) and is followed by a blank line for
visual separation. Also display the license field from SKILL.md
frontmatter when present.
Remove all survey/v2 dependency (7 call sites) and fuzzy direct usage:
- search.go: survey.Input → bufio.NewReader for simple text prompts
- init.go: survey.Select → inline numbered prompt for sync mode
- init.go: survey.MultiSelect → checklist TUI for target/agent selection
- init_project.go: survey.MultiSelect → checklist TUI for project targets
- install_prompt.go: survey.Select → checklist TUI for orchestrator mode
- install_prompt.go: delete dead promptSearchSelect function
- install_prompt.go: fuzzy → strings.Contains for filterSkillsByName
Add generic checklist_tui.go supporting both multi-select and single-select,
reusing the existing bubbletea/bubbles styling. Sync mode uses a simple
inline prompt (no alt-screen) for smoother init flow, with a copy-mode
hint when non-copy is selected. TUI selections now print confirmation
after exit so users see what they chose.
Single-skill check now shows the same tree-structured header (Source,
Items, Skill name, Source URL) and uses a spinner + StepResult instead
of a progress bar, consistent with how `update` renders single targets.
The // subdir syntax (e.g., repo//skills/foo) stores meta.Subdir with
a leading "/". git rev-parse and ls-tree paths never have leading
slashes, causing tree hash lookups to fail silently.
Strip leading "/" in getSubdirTreeHash(), resolveSkillStatuses(), and
handler_check.go. Add LeadingSlash unit test and E2E runbook.
Progress bar total was `len(repoInputs) + len(urlInputs)` which showed
"2/2" for 46K skills from 2 URLs — meaningless to users. Now uses actual
skill count so the bar shows "46321/46321" instead.
Previously `skillshare check` compared repo-level commit hashes, causing
all skills from a registry repo to show "update_available" whenever any
commit was pushed — even if the individual skill's files were unchanged.
Now each skill records its git tree hash (subdir-level SHA) at install
time. During check, a three-tier comparison is used:
1. Fast path: commit hash matches → up_to_date (zero extra cost)
2. Tree hash path: blobless fetch (~150KB) + batch ls-tree → per-skill
comparison; unchanged subdirs stay up_to_date
3. Fallback: no tree hash (old installs) → commit comparison (unchanged)
Also fixes pterm progress bar printing twice when it auto-stops at 100%.
Replace the single-select survey.Select prompt in `search` with a
bubbletea-based multi-select TUI, enabling batch installation of
search results. The new TUI supports space/a toggle, `s` for search
again, `/` filter, and esc to cancel — consistent with the existing
skill select TUI pattern from install.
Add batchInstallFromSearch() for sequential multi-skill installation
with per-skill error reporting.
- Replace promptMultiSelect's survey.MultiSelect with a full bubbletea
TUI (space toggle, a select-all, enter confirm, / filter, esc cancel)
- Unify TUI styling across all screens: brand yellow (#D4D93C) for
active item border+text, bright white for normal items
- Fix infinite loop when selecting (root) group in dir picker
- Compact single-line items with SetHeight(1) + SetSpacing(0)
- Pre-compute location strings and maintain selCount counter for
better toggle performance with large skill sets
- Remove inline ANSI from Title() to prevent filter highlighting corruption
- List TUI: single-line items with [tracked]/[local] badges, no description
Replace redundant "Updating N skill(s)" header + separator with the
same tree layout used by check: Header → StepStart("Source") →
StepContinue("Items") with repo/skill counts. Removes duplicate
"Updating" label that overlapped with the progress bar title.
groupSkillsByDirectory() used filepath.Dir() which always returned the
same parent regardless of recursion depth. Add a prefix parameter so
each level strips already-navigated directories before grouping.
Also fix stale assertion in TestCheck_RegularSkill_ShowsMeta to match
the summarized local-skill output introduced in 37f3425.
Introduce InstallContext interface to abstract global/project behavioral
differences, push config-based install logic down to internal/install,
and merge the nearly-identical Git discovery/subdir handlers.
- Add InstallContext interface (SourcePath, ConfigSkills, Reconcile,
PostInstallSkill, Mode) with SkillEntryDTO to avoid circular imports
- Add globalInstallContext and projectInstallContext implementations
- Extract InstallFromConfig() to internal/install/install_config.go,
replacing the 90%-identical installFromGlobalConfig/installFromProjectConfig
- Merge handleGitDiscovery + handleGitSubdirInstall into handleGitInstall,
branching on source.HasSubdir() for the few differences
Suppress per-item output for up_to_date repos/skills and local skills,
showing counts in the summary instead. This prevents terminal flooding
when checking hundreds of skills (e.g. 920+).
- Extract shared renderCheckResults() to deduplicate runCheck/runCheckFiltered
- Full check (no args): hide up_to_date + local, show counts in summary
- Filtered check (names/groups): hide up_to_date, still show local individually
- JSON output unchanged
Replace serial checkTrackedRepo/checkRegularSkill loop in
runCheckFiltered() with the same parallel batch pattern used by
runCheckAll(): partition targets into repo/skill names, call
collectCheckItems for URL deduplication, then fan out via
ParallelCheckRepos and ParallelCheckURLs with a progress bar.
Remove now-dead checkTrackedRepo and checkRegularSkill functions
and the unused git import they required.
logUpdateOp now captures mode, all, force, dry_run, skip_audit, threshold,
and diff flags. Dedicated formatUpdateLogPairs/Detail formatters replace the
generic fallback in both the TUI log viewer and the web UI LogPage.
Add 256-color palette ID constants (SeverityIDCritical, etc.) and
SeverityColorID() to ui package as single source of truth for severity
colors. Refactor log_tui.go colorizeSeverityBreakdown, colorizeThreshold,
and colorizeRiskValue to use shared IDs instead of hardcoded values.
Add ui.SeverityColor() and ui.Colorize() as shared helpers for consistent
severity coloring across the codebase. Apply colored severity labels to
the batch audit summary line (HIGH=150, MEDIUM=511, etc). Refactor
audit.go to use shared helpers instead of local duplicates.
Replace cfg *config.Config with sourcePath string in updateTrackedRepo and
updateRegularSkill. Add projectRoot param for mode-aware audit scanning.
Delete updateSingleProjectSkill and updateProjectTrackedRepo from
update_project.go — project mode now uses the same shared handlers.
All three duplicated 3-phase batch loops (tracked repos → grouped skills →
standalone skills) are now unified through executeBatchUpdate(). This
eliminates the local `target` struct in updateAllProjectSkills and ~160
lines of duplicated orchestration code.
Add updateContext struct with mode-aware auditScanFn() and makeInstallOpts().
Unify updateTrackedRepoQuick (add scanFn param) and updateSkillFromMeta
(accept InstallOptions) between global/project modes. Delete
updateProjectTrackedRepoQuick and updateProjectSkillFromMeta.
Delete parseProjectInstallArgs (identical copy) and projectInstallArgs type
from install_project.go. Both modes now share parseInstallArgs. The "no source
→ reject flags" check moved from parser to cmdInstall caller. Project mode
gains --audit-verbose support for free.
Move ~360 lines of skill selection UI functions (promptMultiSelect,
promptLargeRepoSelection, fuzzy filtering, etc.) to a dedicated file.
Pure structural move with no behavior changes.
Move ~820 lines of audit-related types, vars, and 30 functions from the
2608-line install.go monolith into a dedicated file. Pure structural move
with no behavior changes — same package, identical signatures.
Return sizeBytes (int64) instead of sizeMB (float64) from backup API
so the frontend controls display formatting. CLI backup commands now
use the existing formatBytes() helper for human-friendly output.
Extract duplicate formatSize() from CollectPage and TrashPage into
shared ui/src/lib/format.ts utility.
On TTY, `skillshare log` now launches a bubbletea TUI (same pattern as
`list`) with fuzzy filtering by timestamp/command/status/source/detail,
keyboard navigation, and a colorized detail panel showing structured
args per entry. Operations and audit entries are merged and sorted by
time in the combined view.
Also refactors the 979-line log.go into three focused files:
- log.go (303) — entry, dispatch, help
- log_format.go (495) — data→string conversion, logArg* helpers
- log_render.go (189) — TTY/non-TTY terminal output
Other changes:
- --no-tui flag to skip TUI and print plain text
- Shared applyTUIFilterStyle() for cyan filter cursor in both TUIs
- Update website docs and built-in skill references
Allow users to trigger audit, update, or uninstall directly from
the interactive list TUI via Shift-key shortcuts (A/U/X), avoiding
the need to exit and manually type commands.
Replace basic text output with bubbletea-based interactive TUI for the
list command. Falls back to plain text with --no-tui or non-TTY output.
- Bubbletea TUI: fuzzy filtering, keyboard navigation, detail panel
- Detail panel: description (SKILL.md), disk path, files, synced targets
- Search: `skillshare list <pattern>` filters by name/path/source
- Filter: `--type git|local` to filter by installation type
- Sort: `--sort name|date|type` with mode-specific defaults
- JSON: `--json` for CI/scripting consumption
- Pager: less/more wrapper for --no-tui plain text output
- 29 integration tests covering all new functionality
UpdateSkillsFromRepo was using filepath.Join(sourceDir, meta.Subdir) to
derive the local destination, but meta.Subdir is the repo-internal path
(e.g. "skills/foo") which may differ from the local install path ("foo/").
This created leaked copies at sourceDir/skills/foo/ alongside the correct
sourceDir/foo/, doubling the skill count on subsequent scans.
Change skillTargets from []string to map[string]string where key is the
repo subdir (for discovery lookup) and value is the local absolute path
(provided by the caller who already knows where the skill is installed).
Grouped skills batch path calls UpdateSkillsFromRepo which clones the
repo via DiscoverFromGitWithProgress — but OnProgress was nil so the
progress bar froze during clone then jumped on completion.
Wire OnProgress callback to forward git transfer lines into the
progress bar title, and add a 50ms render delay in the inner per-skill
loop so pterm can flush each step to the terminal. Both guarded by
IsTTY() to avoid overhead in CI/pipe contexts.