Improve package bundle matrix and inspector

[maojiebc]

Summary

• surface composite package bundles as first-class rows in the capability matrix, with component expansion and Claude/Codex coverage

• align the matrix first screen with the provided HTML reference: dense KPI strip, compact square filter chips, lighter table chrome, tighter bundle/component rows, version identity, and a refreshed README matrix screenshot

• make the HTML-style Matrix sort control interactive, with type, name, calls, tokens, and recent-use ordering backed by the cached usage index

• broaden Matrix search across source/author, enabled app targets, trigger phrases, package source, component kind/status, and config fields, including Chinese aliases like 套装 and 占位

• add HTML-style sidebar shortcuts for Matrix status and type filters so suites, Claude-only, Codex-only, broken links, and capability kinds are one click away

• cache sidebar Matrix shortcut counts from a single capability snapshot to reduce repeated filtering during sidebar redraws

• surface the current sync provider and last-sync status in the sidebar with a one-click path into Settings

• segment the matrix inspector into fast-scanning tabs aligned to the HTML detail views: Overview, README, Usage, Version, Sync, and Metadata where applicable

• add HTML-style inspector header chips for skill/app state, bundle coverage, calls, and token usage so usefulness is visible before changing tabs

• add a broken-links Matrix filter backed by deployment health, with bundle aggregation and localized badges

• add row-level broken-link badges across skill rows, bundle rows, and expanded components so filtered results explain the failing row inline

• split single-skill inspector details into HTML-aligned README / Usage / Version / Paths tabs, with source metadata and revealable local deployment paths

• enrich bundle component lists in the inspector with per-component Claude/Codex state badges, stub/off visibility, raw status, and usage-call counts

• surface Settings sync diagnostics with structured success/failure states, stderr/exit-code visibility, iCloud endpoint counts, and a read-only Status action

• normalize package/skill/agent search delimiters so Matrix and Command-K find baoyu-comic with baoyu comic, lark-cli with lark cli, and compact/spaced variants consistently

• load persisted Popskill stubs during app bootstrap so the matrix stub KPI and recoverable-state model survive relaunch; dedupe stub state after idle cleanup actions

• add matrix-level Tokens / Calls columns for skills, bundles, and expanded bundle components using a cached transcript usage index

• enrich the package inspector with usage aggregation, top component usage, local skill paths, safe actions, version metadata, sync/update status, and async SKILL.md README previews

• add single-skill usage metrics in the inspector so individual skills show attributed calls, token totals, and recent use after transcript scan

• add package-aware update matching and UI state so update scans cannot stack from multiple views

• extend Spotlight / Command-K so bundles can be found by package name, source, component name, component kind, status, or CJK trigger variants, then opened directly in the matrix inspector

• stabilize CI by running PR checks once, selecting Xcode 16 for Swift Testing, adding step timeouts, and keeping SwiftUI store-backed views MainActor-safe for strict actor isolation

• scope Matrix and Inspector usage metrics to a scanner-provided 30-day transcript window while preserving full Insights totals

• add HTML-style 30-day call trend bars and peak-day context to skill and bundle Inspector usage tabs using scanner-provided daily buckets

• show bundle membership and companion skill navigation in single-skill Inspector overview, matching the HTML detail-page context

• add safe single-skill Inspector actions for editing SKILL.md, checking updates, opening source, and revealing local files, matching the HTML detail action strip without destructive stub conversion

• add package-level activate-all actions in the bundle Inspector overview so installed suite skills can be enabled for Claude or Codex in one pass, matching the HTML bundle action strip while avoiding destructive disable-all flows

• add a single-skill This Machine summary in the Inspector overview so first activation, recent use, 30-day usage, and local size are visible without switching tabs, matching the HTML detail sidebar

• add a single-skill Source & Paths block in the Inspector overview so repository, directory, local store, source type, and SKILL.md are visible without switching tabs

• parse SKILL.md frontmatter into a manifest so semantic versions, authors, licenses, homepages, and required commands appear in the Matrix and single-skill Inspector instead of falling back to hashes only

• add a package-level This Machine summary in the Inspector overview so suite tokens, calls, top component, and local size are visible without switching tabs

• add a package-level Sync status block in the Inspector sync tab so suites show source, provider, last sync, and Claude/Codex link health without leaving the detail view

• show package component versions in the Inspector component list and Version tab, reusing manifest versions, hashes, or update dates so suite details match the HTML component table more closely

• mark the final expanded package component row with the HTML-style └─ tree prefix so bundle hierarchies scan correctly in the matrix

• show dependency health for SKILL.md required commands, so single-skill Inspector can distinguish available vs missing tools like bun and npx before a skill is used

• show HTML-style package composition summaries such as CLI/MCP/Skill counts in matrix, Spotlight, and Inspector package context

• add a Spotlight/Command-K action to re-scan usage and jump to Insights so calls and token metrics can be refreshed without opening detail panes

Validation

• git diff --check
• swift build --package-path swift-app
• swift test --package-path swift-app
• ./scripts/swiftpm.sh test --package-path swift-app
• ./scripts/smoke-app.sh 2
• ./scripts/ci-local.sh

Notes

• package-install is still treated as preview-only; this PR intentionally avoids destructive package-level install/disable actions.

• Package and skill usage breakdowns reuse the already-scanned transcript attribution summary; they do not read transcript files from the inspector.

• Visual verification now includes a local matrix window capture refreshed into docs/screenshots/matrix.jpg; local launch/screenshot/release smoke also pass through ./scripts/ci-local.sh.

• add Spotlight/Command-K matrix filter actions for bundles, skills, CLI tools, MCP servers, broken links, and inactive capabilities so keyboard users can jump to key matrix views

• rank Spotlight/Command-K empty-query results by recent 30-day usage before lifecycle recency, with localized recently-used labels matching the HTML command palette

• surface non-destructive package actions in the bundle Inspector overview so suite users can re-scan usage, check updates, open source, or reveal local files without switching to Sync

• add HTML-style package coverage percent and stub/off gap labels in bundle Inspector cards so suite coverage explains why an app is partial