Commit Graph
21 Commits
Author SHA1 Message Date
github-actions[bot]andWillie 1100047f9c chore(main): release 0.30.6 (#850)
* chore(main): release 0.30.6

* chore(release): synchronize release metadata

* docs(changelog): write user-facing notes for 0.30.6

The generated entry listed commit subjects only. Describe each change by what users see, add CI examples for check --exit-code, and give a migration note for self-hosted servers, which no longer receive provider tokens after #861.

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Willie <egg358358@gmail.com>
2026-11-12 01:26:19 +08:00
Willie e317483459 feat(herdr): offer skillshare as a standalone mod (#857)
Preserve the complete Layout while adding a standalone Mod named skillshare. Generate both packages from one canonical mod and protect custom layouts and usage meters during installation and updates. Keep release versions aligned and route native Herdr instructions separately within existing context budgets.
2026-11-11 21:49:34 +08:00
Willie dab075c143 fix(herdr): load panel resources progressively (#855)
* fix(herdr): load panel resources progressively

Publish independent resource and source reads as they finish so a slow native plugin inventory cannot block the entire panel. Preserve cached rows while keeping pending and failed sync states explicitly unconfirmed across scopes and previews.

Keep machine upgrade and pull/sync spinners on their owning actions, and cover partial reads, retries, scoped failures, and rendered states with regression tests.

* fix(herdr): retain actionable overview rows during refresh

Keep previously actionable cached rows in an unconfirmed section while their reads are pending or failed, rather than hiding them when their sync state becomes unknown. Cover both states with a rendered regression test.
2026-11-11 19:57:58 +08:00
github-actions[bot] b78c90d03e chore(main): release 0.30.5 (#848)
Release the automatic version-check opt-out with CLI and dashboard controls, unchanged explicit checks and upgrades, and documented global configuration and environment precedence.

Synchronize the manifest, built-in skill, Herdr panel version and both user-facing changelog copies at 0.30.5. Include the reviewed release documentation from main.
2026-11-11 13:56:36 +08:00
github-actions[bot]andWillie 9f8935a3ca chore(main): release 0.30.4 (#832)
* chore(main): release 0.30.4

* chore(release): synchronize release metadata

* docs(changelog): describe 0.30.4 for users

The generated entry listed commit subjects. Rewrite it as what changes for someone using the Herdr panel, the CLI's --json output, plugin updates and audit, with the reporters credited.

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Willie <egg358358@gmail.com>
2026-11-11 01:13:36 +08:00
Willie 68fd28597f feat(herdr): show an operation's outcome before skillshare answers (#844)
* feat(herdr): enable and disable skills and agents from the panel

The Library lists disabled skills under Off, but the panel had no way
to turn one back on or to turn one off: that meant leaving Herdr for
the CLI or the dashboard.

A skill's or agent's preview now offers Disable, or Enable when it is
disabled. It asks first, then runs skillshare disable / enable with the
entry's own path, the pattern the dashboard writes, so enable removes
exactly what disable added. The next sync applies the change.

Exit 0 only means the entry's own line was written or was not there. A
glob, a folder pattern or a negation in the .local file can still
decide the other way, so the panel reads the list afterwards and
reports an entry that did not change instead of claiming success.

The confirm dialog shares the hook dialog's branch under the role
"able": "toggle" is already the tab-bar button's role, and an overlay
opened with it draws that button.

* feat(herdr): show an operation's outcome before skillshare answers

Every operation waited for the CLI and then for the next full read
before a row moved, so a click looked like nothing happened for
seconds.

The panel now lays its running requests over the rows it has read. A
disable, an enable, an uninstall and a hook change show their outcome
at once, and a finished install lists its skills without waiting for
the read. An update and a sync can be stopped by an audit or a failed
target, so their rows only say "updating…" or "syncing…" rather than
claim a result.

A request that fails is dropped and the rows go back. Otherwise the
first read that starts after the request ended replaces the guess; a
read already in flight when it ended is followed by another, which
also closes the gap where the post-operation refresh was skipped and
the list stayed stale until the next poll.

Git sync, upgrading skillshare and updating the panel are not guessed:
their result depends on the remote.

* refactor(herdr): decide the pending requests' fate in the model

Which optimistic rows survive a read, when an update's rows give way to
the checks, and whether another read is needed were decided inline in
main.js, which the node tests cannot load. herdr/AGENTS.md asks for new
logic in tested modules and main.js kept to views.

shownRows, endedRequests, afterRead and afterChecks now hold those
decisions in model.js; main.js only stores the list. Tests cover a
request ending during a read, a read newer than the request, an update
waiting for the checks, a failed request dropped, and another machine's
request.
2026-11-11 00:10:34 +08:00
Willie 709f5ce896 fix(herdr): align install discovery with CLI planning (#841)
Expose selected skill names and repository-relative paths in dry-run JSON so the panel follows CLI discovery, ignore rules, and canonical names. Refuse ambiguous plans and treat nonzero install exits as failures even with legacy JSON output.

Closes #838

Release-As: 0.30.4
2026-11-11 00:00:28 +08:00
Willie 22b90966a1 feat(herdr): name the targets behind a collapsed map line on hover (#842)
* feat(herdr): name the targets behind a collapsed map line on hover

The Overview map draws at most six lines, so with more targets the last
line reads "2 others" or "+3 more" and the panel never says which ones.
Finding out meant opening a preview's Targets tab.

Resting the pointer on such a line now opens a hover card listing those
targets with the same dot, mark, name and state a line of its own would
show. It uses the kit's HoverCard, so there is no motion of our own to
tune: a hover this frequent should stay quiet.

* test(herdr): close the collapsed-line test after the merge
2026-11-10 23:50:06 +08:00
Willie 833373f1a7 feat(herdr): enable and disable skills and agents from the panel (#843)
The Library lists disabled skills under Off, but the panel had no way
to turn one back on or to turn one off: that meant leaving Herdr for
the CLI or the dashboard.

A skill's or agent's preview now offers Disable, or Enable when it is
disabled. It asks first, then runs skillshare disable / enable with the
entry's own path, the pattern the dashboard writes, so enable removes
exactly what disable added. The next sync applies the change.

Exit 0 only means the entry's own line was written or was not there. A
glob, a folder pattern or a negation in the .local file can still
decide the other way, so the panel reads the list afterwards and
reports an entry that did not change instead of claiming success.

The confirm dialog shares the hook dialog's branch under the role
"able": "toggle" is already the tab-bar button's role, and an overlay
opened with it draws that button.
2026-11-10 23:36:10 +08:00
Willie 4776ca7ada fix(herdr): keep the header pill clear of the Update panel button (#840)
With a newer release published, the panel's header drew "Update panel"
on top of the folder and machine pill: at the panel's 400px the row has
no room for both, and the pill did not shrink, so the two overlapped.
Seen in a running Herdr with version.js set below the latest release.

The pill is now a plain element that shrinks and ends in an ellipsis,
so the button, the version and the close button keep their place.

panels.png gains the button in the first view, drawn as the running
panel shows it, with the pill shortened.
2026-11-10 23:36:04 +08:00
Willie 4be28c1258 feat(herdr): let the panel update itself from the latest release (#839)
The panel had no version and no way to update: a user had to copy the mod folder again by hand and could not tell when a newer one existed.

The panel now carries version.js, the skillshare release it shipped with, which Release Please rewrites in every release. While shown it asks once an hour where GitHub's "latest release" link lands and offers "Update panel" when that release is newer. It compares against the published release, not main, because the panel parses the CLI's --json output and a panel from main may need an unreleased CLI.

The update clones only the mod's folder at that tag and copies it over the installed one. It first checks the folder holds the running panel's version, keeps the replaced files once in .bak-update-<version>, and holds every machine's lock until the reloaded panel returns it, because Herdr's reload ends every running task.
2026-11-10 23:01:39 +08:00
Willie 819546f124 feat(herdr): answer "what needs me" first and preview every row (#836)
* feat(herdr): answer "what needs me" first and preview every row

The panel listed every resource in one long tab and put the detail of a
row in text under it, so the first screen never said whether anything
needed a sync, and a 400px column filled with wrapped lines.

Overview now leads with one headline, one Sync button and a map from the
source to every target, and lists only what needs attention. Library
holds the full lists. A row carries a name and one short state; clicking
it opens a preview dialog with its document, its targets and its
details, so nothing is crammed into the list. MCP previews show the
names of env, header and token entries, never their values.

Target names come from `status` as well as `diff`, because `diff` leaves
out targets that share another target's folder. A machine with
uncommitted or unpushed work offers Sync both ways, since a plain pull
would refuse there. Warnings and errors now clear after 8 s instead of
staying until closed. Dialogs draw their own card and fade in and out.

The map's lines, the target list and the machine's action live in
model.js with tests; rowSub and the hideDisabled filter had no caller
left and are removed.

* fix(herdr): list only the targets a previewed item can reach

The preview's Targets tab was wrong in two cases.

A skill already on some targets but new to one has the state "missing",
and the preview treated that state as "waits everywhere", so targets
already in sync were marked as needing a sync. Only the targets the
item's drift names wait now.

An agent's preview listed every configured target, including ones that
take no agents, as in sync. The loader now keeps the targets that take
skills and the ones `status` reports for agents apart, and the preview
uses the list for the item's kind.

* feat(herdr): sync from Library's waiting group

The redesign left Sync only on Overview, so someone reading the Library
list had to switch tabs to act on the rows in front of them. The
"NEEDS SYNC" header carries Sync again, for the scopes its rows wait in;
when only a hook notice has native changes, its header carries it.

* fix(herdr): keep Sync in Library's toolbar and stop the panel shrinking past its tabs

Sync on the "NEEDS SYNC" header only existed while something waited, so
with everything in sync Library had no way to sync at all. It now sits
in the toolbar beside the filter, primary while something waits.

The panel could be dragged down to 320px, where the tab row no longer
fits beside the scope switch and the switch is cut off. The column's
minimum is 380px, and the tab row is a little tighter.

* fix(herdr): sync every scope a target still waits in from Library

Library's Sync chose its scopes from the waiting rows alone. A target can
wait with no row left, as after uninstalling a project skill that a
copy-mode target still holds, so with All shown and one global row
waiting, Sync ran in the global scope only and left the project copy in
place. Overview already added the scopes with a waiting target.

Both now take their scopes from one model helper, syncScopes, which
covers waiting rows, waiting targets and the nothing-waiting fallback.

* refactor(herdr): finish the review's open findings on the panel

The first review left confirmed findings listed but unfixed, and the
commits after it were never reviewed. This closes both.

The map now counts a waiting MCP server, plugin or hook on the targets
it waits on, so its lines no longer stay green under a headline that
says something waits. A skill's Targets tab takes its targets from
status when status names them: diff also lists targets that take agents
alone. Library's Sync stays disabled until a scope has been read;
before that it sent an empty scope list and reported a sync that never
ran.

The map's trunk and lanes, the two pill switches, the placeholder block
and its pulse each had two or more copies in main.js and now have one.
The Overview headline, a machine's remote line and its waiting targets
move to model.js with tests. README's layout snippet names the 380px
minimum the layout file already has.
2026-11-10 22:25:13 +08:00
Willie 816938c09c fix(cli): report why uninstall and install fail under --json (#835)
Scripts and the herdr panel could not tell why an uninstall or install
failed: uninstall --json had no error field, project mode ignored --json
(printing text and still prompting), and a multi-skill or config install
in which every skill was blocked exited 0.

- uninstall --json (skills and agents, global and -p) sets "error" with
  each failed name and reason; skills exit non-zero when all fail,
  agents when any fails. Project mode now emits pure JSON, including on
  the first run that initializes the project.
- uninstall -p agents parses its flags instead of treating --help or an
  unknown flag as an agent name, and uninstall agents --json is logged.
- install exits non-zero, naming each skill and reason, when every skill
  from a source or from config fails; installed or skipped skills make it
  a partial success that still exits 0. Config installs show each
  failure's reason, and the dashboard logs an all-failed run as an error.
- herdr asks for JSON in project scope and shows the CLI's error.
2026-11-10 20:24:44 +08:00
Willie 2d5475ce87 docs(herdr): lead the panel's README and recipe with what skillshare is
A third of the repository's visitors arrive from herdr.dev and land on
herdr/skillshare, where the README opened with install steps and no
picture, and never said what skillshare is or linked back to it. The
recipe's first paragraph, which the Herdr gallery shows as the layout's
description, did not mention the Machines tab.

The preview was also stale: it predated the Hooks kind and the
List / By source switch. Redraw it from the design board, add a
three-view picture for the README, and refresh the copies that follow it.
2026-11-10 17:28:28 +08:00
Willie c677291e3d feat(herdr): hide disabled rows, group In sync by source, and split the panel into testable modules (#782)
* feat(herdr): hide disabled rows and group In sync by source

A source with many disabled skills buries the few rows that need
attention, and a long In sync list gives no sense of where skills
came from.

- Disabled rows are hidden by default; "Show disabled · n" lists them
  again and the choice is kept. A disabled hook with pending changes
  stays visible because it still needs a sync.
- In sync skills and agents can be grouped by their source repository
  (By source) or shown flat (List); a source with one row stays a
  plain row, and a filter opens every group.
- Opened plugin and MCP rows show their source, version and targets
  instead of an empty detail area.

* refactor(herdr): move the panel's logic out of main.js into testable modules

The bugs fixed in #773, #774 and #775 sat in main.js code that imports
Herdr, so node could not test it: the detached-job polling, the busy
state, and perform's op chain. Only model.js's parsing had tests.

Each concern now lives in a module that takes Herdr's functions as
arguments, so herdr/tests runs it:

- jobs.js runs skillshare: short reads as one exec, longer work
  detached and polled, with the sweep of old job folders and one
  JOB_MINUTES limit shared with SWEEP.
- channel.js carries requests, notices and one lock per machine
  through shared values. The install dialog used to check only a
  global busy string and then run without the lock; it now takes
  that machine's lock. Holders refresh the lock before each command
  and an untouched lock expires after a minute, because a dialog's
  task ends without cleanup when it closes.
- operations.js holds what each request runs and the conflict
  handling of a pull; perform only takes the lock and shows progress
  and the result.
- loader.js reads the Resources data and the Machines cards, and runs
  status alongside the snapshots.
2026-11-05 10:40:11 +08:00
Willie 4ede32f3e2 docs(herdr): point setup at the Herdr layouts listing
The skillshare layout is now published at herdr.dev/layouts, where one
agent prompt installs it without copying files by hand. Offer that path
first in the Herdr guide (all locales) and the panel README, and keep
the manual steps for anyone who wants to merge blocks into their own
layout.
2026-11-05 10:24:37 +08:00
Rusty Shackleford 5d05335853 feat(herdr): add a Hooks tab to the skillshare panel (#780)
* feat(herdr): add Hooks tab with confirmed entry actions

Show hook declarations and planned changes alongside the other resource kinds, reusing sync --all. Keep nested roots and cleanup status read-only, and confirm enable, disable and remove before saving.

Cover inventory states and scoped action arguments with fixtures; update panel documentation and translated kind lists.

* fix(herdr): preserve hook diagnostics and cleanup failures

Keep inactive reasons and plan warnings visible independently of file actions. Retain an inventory status row when cleanup preview fails after the final declaration is removed, and format root conflicts without an empty target prefix.

Add producer-shaped regression fixtures and document confirmed actions and CLI/dashboard conflict recovery across the panel guides.

* fix(herdr): separate hook notices from named resources

Keep diagnostic notices visible and filtered without inflating entry counts or groups. Propagate root-wide conflicts to affected entries and preserve inactive reasons independently of file alignment.

Show full nested root identities and offer scoped Sync for unnamed native writes. Cover projection and scoped snapshot reads with fixture-only tests, and align panel guides and translations.

* fix(herdr): distinguish unknown hook status from pending sync

Show entries with missing previews outside sync groups and report each scope error once. Preserve disabled state beside runtime diagnostics and omit unchanged targets from pending summaries while retaining expanded details.

Regress the confirmed presentation failures before fixing them, consolidate overlapping fixtures without dropping distinct checks, and align panel guides and translations. Keep source action eligibility because the CLI previews each changed draft.
2026-11-05 09:20:30 +08:00
Willie 8cc77fe58c fix(herdr): make panel actions run, and keep machines apart (#775)
Every panel action did nothing. The panel starts a request from render
with cx.spawn, which runs its body up to the first await at once, and
the first step calls cx.notify(), which throws during render. The error
was swallowed, so Pull and sync, Update, Sync and every dialog's confirm
button silently did nothing. Work started from render now waits for the
render to end.

With actions running, pull and upgrade exited with 129: Herdr hangs up
programs that still carry the exec's HC_SCOPE once the exec returns,
which killed the git and gh that skillshare runs. Detached jobs now drop
HC_SCOPE.

One machine's work also showed "Working..." on every machine card and
blocked the others. Work now runs one at a time per machine, and
machines run side by side.
2026-11-04 18:08:12 +08:00
Willie e5aaf1469f fix(herdr): remove job folders a closed panel never collected (#774)
A panel closed or reloaded while a long command ran never reads that
job's result, so its temp folder stayed in $TMPDIR on the machine for
good. Job folders are now named skillshare-panel.*, and the first long
command on each machine removes the ones unchanged for 15 minutes (the
longest a panel polls a job) whose job no longer runs. A job still
running, or one another panel may still be reading, is kept.
2026-11-04 17:45:20 +08:00
Willie b05961650e fix(herdr): keep detached jobs alive and report a killed one (#773)
The panel showed "skillshare took longer than 15 minutes" for any long
command on macOS. Herdr ends an exec's whole process group when the exec
returns, so the backgrounded job died with its starter and never wrote an
exit code; the panel then polled for the full 15 minutes.

Each job now gets its own process group (setsid where it exists, sh job
control otherwise), and the starter waits until the job has written its
pid. The panel checks every 5 s that a job without an exit code still
runs, counting a zombie as stopped since a container without init never
reaps it, and fails with the job's last stderr line instead of waiting.
2026-11-04 17:17:16 +08:00
Willie 16de1df814 feat(herdr): add a skillshare panel for Herdr (#766)
Herdr users run several agents side by side and had to leave it to see
which skills need an update or a sync. The panel brings that view, plus
install, update, uninstall, audit hand-off and source repository sync,
into a Herdr layout node so it survives space switches.

Install audits its own shallow clone first, because install --json names
a blocked skill without its findings; a block shows them before anything
is written. Pull conflicts show both versions side by side, and
.metadata.json merges per entry with the same rule as MergeMetadata so
installs from both machines are kept.

model.js has no Herdr imports, so make test-herdr covers it in make check
and CI. Docs gain a learn/with-herdr page with translations and a README
highlight, and the context router loads herdr/AGENTS.md with frontend.
2026-11-04 16:01:45 +08:00