Files
skillshare/internal/server/handler_sync_matrix.go
T
Willie f9be84c0f5 feat(projects): manage project folders from the global config
People with many repositories had to choose between listing every
project skills folder as a custom target or running project mode in
each repo. A `projects:` key in the global config now declares a folder
once with the tools used there, and sync treats each one as a
`<project>@<tool>` target with its own mode and filters.

- Expand `projects:` into virtual targets at load time and strip them
  on save; tools that share a project skills folder are written once
- Skip a project whose folder is missing with a warning instead of
  failing the whole sync; `collect` and `target` ignore project targets
- Add /api/projects (list, save, remove, convert) and detect ordinary
  targets that already point inside a project so they can be converted
- Add a Projects page to the dashboard with Skills, Agents and MCP tabs
  per project, replacing the Projects tab on the MCP page
- Extend Select with a multi-select mode for picking a project's targets

Refs #286
2026-09-21 01:52:34 +08:00

232 lines
7.3 KiB
Go

package server
import (
"encoding/json"
"net/http"
"strings"
"skillshare/internal/config"
"skillshare/internal/resource"
ssync "skillshare/internal/sync"
)
type syncMatrixEntry struct {
Skill string `json:"skill"`
Target string `json:"target"`
Status string `json:"status"`
Reason string `json:"reason"`
ReasonCode string `json:"reasonCode,omitempty"`
ReasonParams map[string]string `json:"reasonParams,omitempty"`
Kind string `json:"kind,omitempty"`
}
func syncMatrixReason(status, reason string) (string, map[string]string) {
if reason == "symlink mode — filters not applicable" {
return "sync_matrix.symlink_filters_not_applicable", nil
}
switch status {
case "synced":
return "sync_matrix.synced", nil
case "excluded":
return "sync_matrix.excluded", map[string]string{"pattern": reason}
case "not_included":
return "sync_matrix.not_included", nil
case "skill_target_mismatch":
return "sync_matrix.skill_target_mismatch", nil
default:
return "", nil
}
}
// agentFilterName is the name agent filter patterns match against, mirroring ssync.FilterAgents.
func agentFilterName(flatName string) string {
return strings.TrimSuffix(flatName, ".md")
}
func newSyncMatrixEntry(skill, target, status, reason, kind string) syncMatrixEntry {
reasonCode, reasonParams := syncMatrixReason(status, reason)
return syncMatrixEntry{
Skill: skill,
Target: target,
Status: status,
Reason: reason,
ReasonCode: reasonCode,
ReasonParams: reasonParams,
Kind: kind,
}
}
func (s *Server) handleSyncMatrix(w http.ResponseWriter, r *http.Request) {
// Snapshot config under RLock, then release before I/O.
s.mu.RLock()
source := s.cfg.EffectiveSkillsSource()
agentsSource := s.agentsSource()
targets := s.cloneTargets()
s.mu.RUnlock()
skills, err := ssync.DiscoverSourceSkills(source)
if err != nil {
writeError(w, http.StatusInternalServerError, "failed to discover skills: "+err.Error())
return
}
var agents []resource.DiscoveredResource
if agentsSource != "" {
discovered, _ := resource.AgentKind{}.Discover(agentsSource)
agents = resource.ActiveAgents(discovered)
}
var builtinAgents map[string]config.TargetConfig
if s.IsProjectMode() {
builtinAgents = config.ProjectAgentTargets()
} else {
builtinAgents = config.DefaultAgentTargets()
}
targetFilter := r.URL.Query().Get("target")
var entries []syncMatrixEntry
for name, target := range targets {
if targetFilter != "" && name != targetFilter {
continue
}
// Skills
sc := target.SkillsConfig()
if sc.Mode == "symlink" {
for _, skill := range skills {
entries = append(entries, newSyncMatrixEntry(skill.FlatName, name, "na", "symlink mode — filters not applicable", ""))
}
} else {
for _, skill := range skills {
status, reason := ssync.ClassifySkillForTarget(skill.FlatName, skill.Targets, name, sc.Include, sc.Exclude)
entries = append(entries, newSyncMatrixEntry(skill.FlatName, name, status, reason, ""))
}
}
// Agents — resolve path from user config or builtin defaults
ac := target.AgentsConfig()
agentPath := ac.Path
if agentPath == "" {
if builtin, ok := builtinAgents[name]; ok {
agentPath = builtin.Path
}
}
if agentPath == "" || len(agents) == 0 {
continue
}
agentMode := ac.Mode
if agentMode == "" {
agentMode = "merge"
}
if agentMode == "symlink" {
for _, agent := range agents {
entries = append(entries, newSyncMatrixEntry(agent.FlatName, name, "na", "symlink mode — filters not applicable", "agent"))
}
} else {
for _, agent := range agents {
status, reason := ssync.ClassifySkillForTarget(agentFilterName(agent.FlatName), agent.Targets, name, ac.Include, ac.Exclude)
entries = append(entries, newSyncMatrixEntry(agent.FlatName, name, status, reason, "agent"))
}
}
}
writeJSON(w, map[string]any{"entries": entries})
}
func (s *Server) handleSyncMatrixPreview(w http.ResponseWriter, r *http.Request) {
// Snapshot config under RLock, then release before I/O.
s.mu.RLock()
source := s.cfg.EffectiveSkillsSource()
agentsSource := s.agentsSource()
targets := s.cloneTargets()
s.mu.RUnlock()
var body struct {
Target string `json:"target"`
Include []string `json:"include"`
Exclude []string `json:"exclude"`
AgentInclude []string `json:"agent_include"`
AgentExclude []string `json:"agent_exclude"`
}
if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
writeError(w, http.StatusBadRequest, "invalid JSON: "+err.Error())
return
}
if body.Target == "" {
writeError(w, http.StatusBadRequest, "target is required")
return
}
// Validate skill patterns
if _, err := ssync.FilterSkills(nil, body.Include, nil); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
return
}
if _, err := ssync.FilterSkills(nil, nil, body.Exclude); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
return
}
// Validate agent patterns
if _, err := ssync.FilterSkills(nil, body.AgentInclude, nil); err != nil {
writeError(w, http.StatusBadRequest, "invalid agent include pattern: "+err.Error())
return
}
if _, err := ssync.FilterSkills(nil, nil, body.AgentExclude); err != nil {
writeError(w, http.StatusBadRequest, "invalid agent exclude pattern: "+err.Error())
return
}
skills, err := ssync.DiscoverSourceSkills(source)
if err != nil {
writeError(w, http.StatusInternalServerError, "failed to discover skills: "+err.Error())
return
}
var entries []syncMatrixEntry
for _, skill := range skills {
status, reason := ssync.ClassifySkillForTarget(skill.FlatName, skill.Targets, body.Target, body.Include, body.Exclude)
entries = append(entries, newSyncMatrixEntry(skill.FlatName, body.Target, status, reason, ""))
}
// Agents — resolve path from config or builtin defaults
target, ok := targets[body.Target]
_, projectTool, isProject := config.SplitProjectTarget(body.Target)
if (ok || isProject) && agentsSource != "" {
ac := target.AgentsConfig()
agentPath := ac.Path
if agentPath == "" {
var previewBuiltin map[string]config.TargetConfig
if s.IsProjectMode() {
previewBuiltin = config.ProjectAgentTargets()
} else {
previewBuiltin = config.DefaultAgentTargets()
}
if builtin, found := previewBuiltin[body.Target]; found {
agentPath = builtin.Path
}
// A project's draft can turn agents on before the project is saved.
if builtin, found := config.LookupProjectAgentTarget(projectTool); isProject && found {
agentPath = builtin.Path
}
}
if agentPath != "" {
discovered, _ := resource.AgentKind{}.Discover(agentsSource)
agents := resource.ActiveAgents(discovered)
agentMode := ac.Mode
if agentMode == "" {
agentMode = "merge"
}
if agentMode == "symlink" {
for _, agent := range agents {
entries = append(entries, newSyncMatrixEntry(agent.FlatName, body.Target, "na", "symlink mode — filters not applicable", "agent"))
}
} else {
for _, agent := range agents {
status, reason := ssync.ClassifySkillForTarget(agentFilterName(agent.FlatName), agent.Targets, body.Target, body.AgentInclude, body.AgentExclude)
entries = append(entries, newSyncMatrixEntry(agent.FlatName, body.Target, status, reason, "agent"))
}
}
}
}
writeJSON(w, map[string]any{"entries": entries})
}