v1.5.6

RELEASE v1.5.6

Summary

• v1.5.6 deepens the desktop runtime architecture around explicit bridge/query/command seams and shared deployment reconciliation.
• The release keeps the existing desktop workflows while reducing reverse dependencies and adding focused coverage for bridge payload decoding and deployment state coordination.

Highlights

1. Shared deployment reconciliation

• Added a dedicated deployment reconciler to the shared query runtime.
• Moved deployment coordination out of the broad runtime implementation into a focused module with dedicated tests.

2. Explicit desktop runtime seams

• Narrowed desktop query and command interfaces and clarified runtime dependency wiring.
• Centralized bridge payload decoding so desktop consumers share one decoding path.

3. View-model and test hardening

• Reduced reverse dependencies across detail, import, collection, settings, and main view-model logic.
• Added and updated Swift and TypeScript tests for the refactored runtime boundaries.

User-visible changes

• Existing CLI and desktop workflows remain available with no intentional command or protocol changes.
• Desktop bridge-backed operations use more explicit and consistent state coordination internally.

Release Artifacts

• Skill-Flow-arm64.dmg
• Skill-Flow-arm64.zip
• Skill-Flow-x86_64.dmg
• Skill-Flow-x86_64.zip
• Skill-Flow-universal.dmg
• Skill-Flow-universal.zip
• sha256.txt

Verification

• npm run build
• npm test
• scripts/release/release-github.sh all
• scripts/release/publish-github-release.sh --skip-build

v1.5.5

RELEASE v1.5.5

Summary

• v1.5.5 hardens online skill download and update on unstable networks, keeps multi-group updates consistent when some groups fail, and cleans up the desktop Group Operation Queue ownership after the v1.5.4 queue work.
• Compared with v1.5.4, refreshes and imports are less likely to fail early on timeouts, partial bulk updates report honest success/failure counts, and queue orchestration is isolated from MainViewModel.

Highlights

1. Longer network budgets for update and import (#10)

• Desktop bridge update and add use the extended network timeout (5 minutes), not the 60s UI default.
• Provider metadata fetch default is 60s; skill-group archive downloads use a dedicated 5-minute budget.
• Bridge timeout flag is named usesExtendedNetworkTimeout (covers import, update, and add).

2. More robust download and multi-group update

• Multi-source updateSources continues when one group fails and still persists successful checkouts and lock state.
• Result includes typed failed[] and status: partial when some groups fail.
• Git commands have a wall-clock timeout; transient clone/archive failures retry with backoff.
• Non-retryable HTTP client errors (for example missing branch) stay terminal.

3. Desktop queue ownership and bulk toast honesty

• GroupOperationCoordinator owns queue drain and phase publishing; card busy state has a single write path.
• Home Update All no longer always claims full success: partial outcomes show updated vs failed counts.

User-visible changes

• Online update/import is more tolerant of slow or flaky networks (longer waits before timeout).
• Update All (or multi-group update) may report partial success instead of a single success/failure for the whole batch.
• Queue and concurrent-click behavior from v1.5.4 is unchanged in intent; internal structure is cleaner.

Release Artifacts

• Skill-Flow-arm64.dmg
• Skill-Flow-arm64.zip
• Skill-Flow-x86_64.dmg
• Skill-Flow-x86_64.zip
• Skill-Flow-universal.dmg
• Skill-Flow-universal.zip
• sha256.txt

Verification

• npm run build
• npm test
• scripts/release/release-github.sh all
• gh release create / asset upload for v1.5.5

v1.5.4

RELEASE v1.5.4

Summary

• v1.5.4 improves macOS desktop multi-group workflows with a session FIFO update/import queue, shares agent display and group tags across production/dev app bundles, adds the built-in Grok Build deployment target, and tightens group-card detail navigation hit targets.
• Compared with v1.5.3, users can keep clicking Update/Import on many groups without waiting, desktop organization state survives package switches, and accidental whole-card detail opens are reduced.

Highlights

1. Desktop Group Operation Queue

• Continuous Update and Import clicks enqueue work instead of being blocked or rejected.
• Cards show distinct Queued vs Running (Updating / Downloading) feedback.
• Same group + same operation is deduped; failures and stale targets skip without stopping the rest of the queue.
• Home Update All is one bulk job that absorbs matching single-group updates.
• Bridge mutations serialize instead of failing with concurrent-mutation rejection.

2. Shared Desktop Workspace Memory

• Agent Display Visibility and Group Tags live in a shared macOS UserDefaults suite so production and *.dev.* packages share organization state on one Mac.
• One-shot migration from the best legacy per-bundle store; concurrent packages use last-write-wins.

3. Grok Build deployment target

• Built-in target grok-build with managed global path ~/.grok/skills/ and documented project path .grok/skills/.
• Override with SKILL_FLOW_TARGET_GROK_BUILD when needed.

4. Safer group card detail open

• Detail navigation is scoped to the card header (title / byline / stats) instead of the whole card, reducing mis-taps on agents, skills, and tags.

User-visible changes

• macOS desktop: multi-group Update/Import queue with Queued/Running card states.
• macOS desktop: tags and agent display visibility shared across app packages on the same Mac.
• CLI/desktop/TUI: Grok Build appears as a deployable agent target.
• macOS desktop: only the group card header opens the detail page.

Release Artifacts

• Skill-Flow-arm64.dmg
• Skill-Flow-arm64.zip
• Skill-Flow-x86_64.dmg
• Skill-Flow-x86_64.zip
• Skill-Flow-universal.dmg
• Skill-Flow-universal.zip
• sha256.txt

Verification

• npm run build
• npm test
• scripts/release/release-github.sh all
• scripts/release/publish-github-release.sh --skip-build

v1.5.2

RELEASE v1.5.2

Summary

• v1.5.2 improves CLI migration usability and tightens local agent detection across CLI and desktop flows.
• Compared with v1.5.1, Skill Flow now exposes more migration controls from the CLI, rejects empty target selections more clearly, and refreshes detected agents more reliably.

Highlights

1. CLI migration controls are easier to operate

• Added list --ids --warnings for source identity and warning visibility.
• Added enable, disable, and only for ON/OFF group management without state-file edits.
• Added --all-skills for target enablement when a registered group has an empty skill selection.
• Added import-manifest for plain text and JSON source manifests. JSON entries with targets must set skills: "all".

2. State and mutation handling is safer

• Added BOM-tolerant state JSON reads.
• Added mutation lock owner metadata and coarse add progress.
• Empty selections after duplicate filtering are now rejected instead of silently applying an invalid target update.

3. Local agent detection stays current

• Desktop target lists refresh detected agents after local roots change.
• Built-in agents installed at root directories are discovered correctly.
• Desktop update checks prefer GitHub Release data from the GitHub CLI when available.

User-visible changes

• CLI users can inspect source ids and warnings, import source manifests, and manage group enablement directly from commands.
• Target updates now fail clearly when a selection becomes empty after filtering.
• Desktop users see fresher agent target availability after local agent changes.
• Update checks can use the authenticated GitHub CLI path when available.

Release Artifacts

• Skill-Flow-arm64.dmg
• Skill-Flow-arm64.zip
• Skill-Flow-x86_64.dmg
• Skill-Flow-x86_64.zip
• Skill-Flow-universal.dmg
• Skill-Flow-universal.zip
• sha256.txt

Verification

• npm run build
• npm test
• scripts/release/release-github.sh all
• scripts/release/publish-github-release.sh --skip-build

v1.5.1

RELEASE v1.5.1

Summary

• v1.5.1 fixes local scan import ownership for skills discovered outside managed Skill Flow state.
• Compared with v1.5.0, Skill Flow now distinguishes agent target directories from manual local directories when deciding whether to replace the original skill path with a managed symlink.

Highlights

1. Agent-directory imports become managed symlinks

• Skills imported from configured agent target roots are copied into Skill Flow's managed checkout and the original agent-directory skill is replaced with a symlink to that checkout.
• This keeps agent directories aligned with Skill Flow after import instead of leaving unmanaged duplicate copies behind.

2. Manual local directories stay untouched

• Skills imported from ordinary local directories are still copied into Skill Flow state.
• The original manual source directory is left in place and is not replaced with a symlink.

3. Observed target metadata stays stable

• The symlink replacement check is limited to the import cleanup path.
• Local scan observed-target data keeps the existing path semantics used by bootstrap and reconciliation.

User-visible changes

• Importing a skill from a Codex, Claude, Cursor, or other configured agent directory now hands that path over to Skill Flow management with a symlink.
• Importing a skill from a non-agent folder no longer mutates that folder.

Release Artifacts

• Skill-Flow-arm64.dmg
• Skill-Flow-arm64.zip
• Skill-Flow-x86_64.dmg
• Skill-Flow-x86_64.zip
• Skill-Flow-universal.dmg
• Skill-Flow-universal.zip
• sha256.txt

Verification

• npm run -w @skill-flow/query build
• npm run -w skill-flow test -- src/tests/config-integration.test.ts
• npm run build
• npm test
• scripts/release/release-github.sh all
• scripts/release/publish-github-release.sh --skip-build

v1.5.0

RELEASE v1.5.0

Summary

• v1.5.0 ships an in-app DMG update flow for the macOS desktop app and tightens import target handling.
• Compared with v1.4.9, Skill Flow now lets macOS users upgrade to a new release from the Settings page and stays consistent when listing import targets.

Highlights

1. In-app DMG update flow on macOS

• Settings now shows the latest available release and prompts the user to install it in place.
• A new DesktopUpdateChecker and DesktopUpdateInstaller pair downloads the staged DMG, validates it, and re-launches the app once the new version is ready.
• Installer validation rejects malformed payloads and constrains the staged DMG to the expected location.

2. macOS import targets are more accurate

• Import target projection now matches the targets that are actually recommended to the user.
• Import target filtering keeps visible fallback targets and locally managed source targets in the picker.
• The import page keeps locally available agents selectable.

3. Agent icon rendering is corrected

• WorkBuddy and Kimi Code icons render with the correct asset in the macOS agent selector.

4. Diagnostics tolerate missing roots

• The doctor service no longer fails when a managed target root is missing from disk.

User-visible changes

• macOS Settings → "Check for updates" can now download and install the next v1.5.0 release in place, with localized confirmation in English, Simplified Chinese, and Japanese.
• The macOS import page now shows the same agent set that the underlying logic projects, including WorkBuddy and Kimi Code with their corrected icons.
• skill-flow doctor reports managed target status without failing when a target root has not been created yet.

Release Artifacts

• Skill-Flow-arm64.dmg
• Skill-Flow-arm64.zip
• Skill-Flow-x86_64.dmg
• Skill-Flow-x86_64.zip
• Skill-Flow-universal.dmg
• Skill-Flow-universal.zip
• sha256.txt

Verification

• npm run build
• npm test
• scripts/release/release-github.sh all
• scripts/release/publish-github-release.sh --skip-build

v1.4.9

RELEASE v1.4.9

Summary

• v1.4.9 expands built-in agent target coverage and refreshes the default agent ordering.
• Compared with v1.4.8, Skill Flow now recognizes Kimi Code, WorkBuddy, and CodeBuddy as first-class targets with bundled desktop icons.

Highlights

1. New built-in agent targets

• Kimi Code deploys to ~/.kimi-code/skills/ and reads compatible skills from ~/.agents/skills/.
• WorkBuddy deploys to ~/.workbuddy/skills/.
• CodeBuddy deploys to ~/.codebuddy/skills/.

2. Desktop target presentation is updated

• The macOS app includes bundled Kimi Code and CodeBuddy icons.
• WorkBuddy and CodeBuddy share the CodeBuddy icon.
• The default target order now matches the curated agent order used by CLI, bridge, and desktop surfaces.

3. Target handling is more robust

• Built-in target detection can distinguish detection roots from write roots.
• Missing managed target roots are created before deployment writes.
• Import target lists stay limited to visible fallback targets while preserving local source targets.

User-visible changes

• Kimi Code, WorkBuddy, and CodeBuddy appear as built-in targets without needing custom agent entries.
• Target lists use the new default order:
  Claude Code, Codex, ZCode, Cursor, Pi, WorkBuddy, CodeBuddy, Trae, Trae CN, Kimi Code, OpenCode, MiniMax Code, Hermes Agent, OpenClaw, GitHub Copilot, Gemini CLI, Windsurf, Amp, Kiro, Roo Code, Cline.
• Desktop target icons include the new Kimi Code and CodeBuddy assets.

Release Artifacts

• Skill-Flow-arm64.dmg
• Skill-Flow-arm64.zip
• Skill-Flow-x86_64.dmg
• Skill-Flow-x86_64.zip
• Skill-Flow-universal.dmg
• Skill-Flow-universal.zip
• sha256.txt

Verification

• npm run -w @skill-flow/domain build && npm run -w @skill-flow/integration build && npm run -w @skill-flow/core-engine build && npm run -w @skill-flow/query build && npm run -w skill-flow build
• npm run -w skill-flow test -- src/tests/target-definitions.test.ts src/tests/skill-flow.test.ts
• npm run -w @skill-flow/query test -- src/tests/source-lifecycle.test.ts
• swift test --package-path apps/desktop-mac --filter 'SettingsViewModelTests|MainViewModelSelectionTests|WorkflowCoverageTests'
• scripts/release/publish-github-release.sh

v1.4.8

RELEASE v1.4.8

Summary

• v1.4.8 is a macOS desktop usability release for search, import-page state, and target icon rendering.
• Compared with v1.4.7, search fields can be cleared directly, home search highlights matching skills inside groups, and successful imports stay on the import page without losing prepared recommendation details.

Highlights

1. Search fields are easier to reset

• Home and import search fields now show a clear action while text is present.
• Clearing import search resets the submitted import query and returns to the default import results.

2. Home search surfaces matching skills

• Skills whose names match the home search query are highlighted inside their group card.
• Matching skills sort before non-matching skills in the same group.

3. Import-page refresh stays in context

• Successful imports refresh installed state without automatically opening the imported group detail view.
• Recommendation cards keep their prepared preview details after installed-state refreshes.

4. Target icons render consistently

• macOS group target icons now use consistent cropped and padded rendering across targets.

User-visible changes

• Search is easier to clear from both home and import views.
• Searching a group by skill name makes the matched skill easier to spot.
• Importing a recommended group keeps the user on the import page and preserves the recommendation card state.
• Target icons have more consistent visual sizing.

Release Artifacts

• Skill-Flow-arm64.dmg
• Skill-Flow-arm64.zip
• Skill-Flow-x86_64.dmg
• Skill-Flow-x86_64.zip
• Skill-Flow-universal.dmg
• Skill-Flow-universal.zip
• sha256.txt

Verification

• swift test --package-path apps/desktop-mac
• npm test
• npm run build
• scripts/release/release-github.sh all

v1.4.7

RELEASE v1.4.7

Summary

• v1.4.7 is a desktop import stability release for GitHub Skill group imports.
• Compared with v1.4.6, import warnings now keep group downloads moving when selected skill selectors drift, while user-facing messages show numeric issue codes instead of internal bridge codes.

Highlights

1. Group imports no longer fail on selector drift

• If selected skill selectors no longer match the downloaded group, Skill Flow imports the downloaded group and reports a warning.
• When all selected selectors are unresolved, the imported group uses the downloaded group as the source of truth and selects all downloaded skills.
• Mixed selector warnings prefer the aggregate warning so users see the clearest issue code.

2. Issue-code based desktop import messages

• Desktop import, preview, apply, bridge, and operation failures now route through a shared issue presentation catalog.
• Toasts and import-card failure summaries display numeric issue codes instead of internal strings such as bridge or selector codes.
• English, Simplified Chinese, and Japanese copy is available for catalog-backed toast and detail messages.

3. Import failure paths are covered

• Structured bridge failures from real thrown command paths map to catalog issue messages.
• Malformed preview/apply responses and preview failure reasons display actionable issue-code text.
• Import success-with-warning flows use warning copy instead of failure copy.

User-visible changes

• GitHub Skill group imports are less likely to be blocked by stale skill selector metadata.
• Successful group imports can now show a warning with an issue code when Skill Flow had to fall back to the downloaded group.
• Import errors and warnings no longer expose internal code names in desktop toasts.

Release Artifacts

• Skill-Flow-arm64.dmg
• Skill-Flow-arm64.zip
• Skill-Flow-x86_64.dmg
• Skill-Flow-x86_64.zip
• Skill-Flow-universal.dmg
• Skill-Flow-universal.zip
• sha256.txt

Verification

• swift test --package-path apps/desktop-mac
• npm test
• npm run build
• scripts/release/release-github.sh all

v1.4.6

RELEASE v1.4.6

Summary

• v1.4.6 adds ZCode as a desktop deployment target and stabilizes the macOS desktop state split.
• Compared with v1.4.5, installed Skill group tags now survive app updates, and combined Skill groups display the merged tags from their member groups.

Highlights

1. ZCode target support

• ZCode is available as a desktop deployment target.
• Skill groups can use the same target selection and deployment planning flow as other supported local agents.

2. Saved group tags survive app updates

• The macOS desktop tag store now migrates legacy source, locator, and repository keys into the stable group tag key.
• Recommendation tags remain default initialization data only; saved group tags remain the single source of truth after they are created.

3. Combined groups derive tags from member groups

• Combined Skill group cards now merge member group tags in member order.
• Duplicate tags are collapsed, and only the first three tags are displayed when the merged list exceeds the normal tag limit.

4. Desktop state split hardening

• Home filters, import state, source summaries, detail enrichment, collection rows, and recently-updated markers now stay synchronized through their owning logic components.
• Rename and detail document cache behavior is more stable across stale list, inspect, and enrichment responses.

User-visible changes

• Previously downloaded Skill groups keep their saved tags after updating the app.
• Combined Skill groups no longer show an empty tag row when their member groups have tags.
• ZCode appears as a supported deployment target in desktop target lists.
• Import, detail, rename, collection, and project-scoped deployment views should preserve state more consistently after refreshes.

Release Artifacts

• skill-flow-1.4.6.tgz
• Skill-Flow-arm64.dmg
• Skill-Flow-arm64.zip
• Skill-Flow-x86_64.dmg
• Skill-Flow-x86_64.zip
• Skill-Flow-universal.dmg
• Skill-Flow-universal.zip
• sha256.txt

Verification

• swift test --package-path apps/desktop-mac
• npm test
• npm run build
• scripts/release/release-github.sh all