package e2e import ( "encoding/json" "os" "path/filepath" "strings" "testing" ) func (e *syncEnv) writeLabelConfig(t *testing.T, labelsJSON string) { t.Helper() e.config = filepath.Join(e.configDir, "config.json") body := `{"repo_url":"` + filepath.ToSlash(e.workRepo) + `","ref":"main"` if labelsJSON != "" { body += `,"labels":` + labelsJSON } body += "}" if err := os.WriteFile(e.config, []byte(body), 0o600); err != nil { t.Fatal(err) } } func commitLabels(t *testing.T, h *harness, dir, content string) { t.Helper() if err := os.WriteFile(filepath.Join(dir, "agent-lib.labels.json"), []byte(content), 0o644); err != nil { t.Fatal(err) } h.git(t, dir, "add", "-A") h.git(t, dir, "commit", "-m", "labels") } func exists(p string) bool { _, err := os.Stat(p) return err == nil } func TestSyncLabelsFilterAndRemove(t *testing.T) { h := newHarness(t) env := newSyncEnv(t, h) buildWorkRepo(t, h, env.workRepo) commitLabels(t, h, env.workRepo, `{"version":1,"labels":{"ops":["deploy"],"dev":["helper","own-skill"]}}`) skill := filepath.Join(env.home, ".agents/skills/own-skill") cmd := filepath.Join(env.home, ".config/opencode/commands/deploy.md") agent := filepath.Join(env.home, ".config/opencode/agents/helper.md") // No labels field: no filtering at all (backward compatible). env.writeLabelConfig(t, "") if out, err := env.run(t); err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } if !exists(skill) || !exists(cmd) || !exists(agent) { t.Fatal("without client labels every item must deploy") } // labels ["ops"]: dev items go away, ops item stays. env.writeLabelConfig(t, `["ops"]`) out, err := env.run(t) if err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } if !strings.Contains(out, "labels: ops") || !strings.Contains(out, "2 item(s) not selected") { t.Errorf("sync must report the active selection, got:\n%s", out) } if exists(skill) || exists(agent) { t.Error("deselected unmodified items must be removed") } if !exists(cmd) { t.Error("selected item must stay") } // Second identical run is a no-op. out, err = env.run(t) if err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } if !strings.Contains(out, "deployed: 0") || !strings.Contains(out, "removed: 0") || !strings.Contains(out, "updated: 0") { t.Errorf("second run must change nothing, got:\n%s", out) } // [] = unlabeled items only: everything here is labeled. env.writeLabelConfig(t, `[]`) if out, err := env.run(t); err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } if exists(cmd) { t.Error("labels [] must deliver unlabeled items only") } } func TestSyncLabelsKeepModifiedCopy(t *testing.T) { h := newHarness(t) env := newSyncEnv(t, h) buildWorkRepo(t, h, env.workRepo) commitLabels(t, h, env.workRepo, `{"version":1,"labels":{"dev":["helper"]}}`) env.writeLabelConfig(t, `["dev"]`) if out, err := env.run(t); err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } agent := filepath.Join(env.home, ".config/opencode/agents/helper.md") if err := os.WriteFile(agent, []byte("my edit\n"), 0o644); err != nil { t.Fatal(err) } env.writeLabelConfig(t, `["ops"]`) if out, err := env.run(t); err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } if !exists(agent) { t.Fatal("a locally modified copy must survive deselection") } log, _ := os.ReadFile(filepath.Join(env.stateDir, "sync.log")) if !strings.Contains(string(log), "not selected for this client's labels") { t.Errorf("sync log must explain the label-based skip, got:\n%s", log) } if out, err := env.run(t, "--force"); err != nil { t.Fatalf("sync --force failed: %v\n%s", err, out) } if exists(agent) { t.Error("--force must remove the deselected modified copy") } } func TestSyncInvalidLabelsFileAbortsWithoutChange(t *testing.T) { h := newHarness(t) env := newSyncEnv(t, h) buildWorkRepo(t, h, env.workRepo) env.writeLabelConfig(t, `["ops"]`) if out, err := env.run(t); err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } manifestBefore, _ := os.ReadFile(filepath.Join(env.stateDir, "manifest.json")) commitLabels(t, h, env.workRepo, `{"version":1,"labels":{"Ops":["deploy"]}}`) out, err := env.run(t) if err == nil { t.Fatalf("an invalid labels file must fail the sync, got:\n%s", out) } if !strings.Contains(out, "agent-lib.labels.json") || !strings.Contains(out, "nothing changed") { t.Errorf("error must name the file and promise no change, got:\n%s", out) } manifestAfter, _ := os.ReadFile(filepath.Join(env.stateDir, "manifest.json")) if string(manifestBefore) != string(manifestAfter) { t.Error("an aborted sync must not touch the manifest") } if !exists(filepath.Join(env.home, ".config/opencode/commands/deploy.md")) { t.Error("an aborted sync must not remove anything") } } func TestSyncLabelsUnknownNameWarns(t *testing.T) { h := newHarness(t) env := newSyncEnv(t, h) buildWorkRepo(t, h, env.workRepo) commitLabels(t, h, env.workRepo, `{"version":1,"labels":{"ops":["deploy","no-such-item"]}}`) env.writeLabelConfig(t, `["ops"]`) out, err := env.run(t) if err != nil { t.Fatalf("an unknown name must not fail the client sync: %v\n%s", err, out) } if !strings.Contains(out, `"no-such-item"`) { t.Errorf("sync must warn about the unknown name, got:\n%s", out) } } func TestSyncLabelsReselectRedeploysAndIsByteStable(t *testing.T) { h := newHarness(t) env := newSyncEnv(t, h) buildWorkRepo(t, h, env.workRepo) commitLabels(t, h, env.workRepo, `{"version":1,"labels":{"dev":["helper"]}}`) agent := filepath.Join(env.home, ".config/opencode/agents/helper.md") env.writeLabelConfig(t, `["ops"]`) if out, err := env.run(t); err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } if exists(agent) { t.Fatal("helper is labeled dev and must not deploy for ops") } env.writeLabelConfig(t, `["ops","dev"]`) if out, err := env.run(t); err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } if !exists(agent) { t.Fatal("an item that becomes selected must deploy") } manifest := filepath.Join(env.stateDir, "manifest.json") before, _ := os.ReadFile(manifest) agentBefore, _ := os.ReadFile(agent) if out, err := env.run(t); err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } after, _ := os.ReadFile(manifest) agentAfter, _ := os.ReadFile(agent) if string(before) != string(after) || string(agentBefore) != string(agentAfter) { t.Error("a second run with labels must be a byte-level no-op") } } func TestStatusLabelsJSONAndNoDriftForDeselectedCopy(t *testing.T) { h := newHarness(t) env := newSyncEnv(t, h) buildWorkRepo(t, h, env.workRepo) commitLabels(t, h, env.workRepo, `{"version":1,"labels":{"dev":["helper"]}}`) env.writeLabelConfig(t, `["dev"]`) if out, err := env.run(t); err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } agent := filepath.Join(env.home, ".config/opencode/agents/helper.md") if err := os.WriteFile(agent, []byte("my edit\n"), 0o644); err != nil { t.Fatal(err) } env.writeLabelConfig(t, `["ops"]`) if out, err := env.run(t); err != nil { t.Fatalf("sync failed: %v\n%s", err, out) } cmd := agentLibCmd("status", "--json", "--config", env.config) cmd.Env = append(os.Environ(), "HOME="+env.home, "USERPROFILE="+env.home, "AGENT_LIB_STATE_DIR="+env.stateDir) out, err := cmd.Output() if err != nil { t.Fatalf("a kept copy of a deselected item is not drift; status must exit 0: %v\n%s", err, out) } var report struct { Drift bool `json:"problematic_drift"` Labels *struct { Client []string `json:"client"` Source string `json:"source"` File bool `json:"labels_file"` NotSelected []string `json:"not_selected"` } `json:"labels"` } if err := json.Unmarshal(out, &report); err != nil { t.Fatalf("status --json not parseable: %v\n%s", err, out) } if report.Drift { t.Error("deselected modified copy must not count as drift") } if report.Labels == nil || report.Labels.Source != "flag" || !report.Labels.File || strings.Join(report.Labels.Client, ",") != "ops" || strings.Join(report.Labels.NotSelected, ",") != "agents/helper" { t.Errorf("unexpected labels object: %+v", report.Labels) } } func TestValidateLabelsWithoutLockfile(t *testing.T) { h := newHarness(t) write := func(rel, content string) { p := filepath.Join(h.workDir, rel) os.MkdirAll(filepath.Dir(p), 0o755) os.WriteFile(p, []byte(content), 0o644) } write("skills/alpha/SKILL.md", "---\nname: alpha\ndescription: a\n---\n") write("agent-lib.labels.json", `{"version":1,"labels":{"dev":["alpha"]}}`) if out, err := h.run(t, "validate"); err != nil || !strings.Contains(out, "agent-lib.labels.json valid") { t.Fatalf("a repo without lockfile must still validate its labels: %v\n%s", err, out) } write("agent-lib.labels.json", `{"version":1,"labels":{"dev":["gamma"]}}`) if out, err := h.run(t, "validate"); err == nil || !strings.Contains(out, `"gamma"`) { t.Fatalf("an unknown name must fail validate: %v\n%s", err, out) } }