package api import ( "os" "path/filepath" "testing" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" ) // brain_pending lists a top-level note and a parked note of the same name as two // entries with the same filename. Acting on "a.md" must not silently pick one. func TestPromoteNote_ANameInBothQueuesNeedsTheQueueToBeNamed(t *testing.T) { dir := t.TempDir() writeRaw(t, dir, "a.md", "---\ncreated_at: 2026-10-20T08:00:00Z\n---\nTop-level body.\n") writeParked(t, dir, "a.md", parkedNote) _, err := PromoteNote(dir, PromoteOptions{Filename: "a.md", Wing: "homelab", Hall: "facts"}) require.Error(t, err) assert.Contains(t, err.Error(), "both") assert.Contains(t, err.Error(), "queue") _, statErr := os.Stat(filepath.Join(dir, "wiki/homelab/facts/a.md")) assert.ErrorIs(t, statErr, os.ErrNotExist, "nothing was promoted") rel, err := PromoteNote(dir, PromoteOptions{Filename: "a.md", Wing: "homelab", Hall: "facts", Queue: QueueNeedsReview}) require.NoError(t, err) got, _ := os.ReadFile(filepath.Join(dir, rel)) assert.Contains(t, string(got), "Body of the parked note.") _, statErr = os.Stat(filepath.Join(dir, "raw", "a.md")) assert.NoError(t, statErr, "the top-level note of the same name is untouched") } func TestPromoteNote_QueueInboxSelectsTheTopLevelNote(t *testing.T) { dir := t.TempDir() writeRaw(t, dir, "a.md", "---\ncreated_at: 2026-10-20T08:00:00Z\n---\nTop-level body.\n") writeParked(t, dir, "a.md", parkedNote) rel, err := PromoteNote(dir, PromoteOptions{Filename: "a.md", Wing: "homelab", Hall: "facts", Queue: QueueInbox}) require.NoError(t, err) got, _ := os.ReadFile(filepath.Join(dir, rel)) assert.Contains(t, string(got), "Top-level body.") _, statErr := os.Stat(filepath.Join(dir, "raw", "needs-review", "a.md")) assert.NoError(t, statErr, "the parked note is untouched") } func TestPromoteNote_ANamedQueueThatDoesNotHoldTheNoteIsAnError(t *testing.T) { dir := t.TempDir() writeRaw(t, dir, "a.md", "top") _, err := PromoteNote(dir, PromoteOptions{Filename: "a.md", Wing: "homelab", Hall: "facts", Queue: QueueNeedsReview}) assert.Error(t, err) _, err = PromoteNote(dir, PromoteOptions{Filename: "a.md", Wing: "homelab", Hall: "facts", Queue: "elsewhere"}) assert.Error(t, err, "an unknown queue name is refused") } func TestRejectNote_ANameInBothQueuesNeedsTheQueueToBeNamed(t *testing.T) { dir := t.TempDir() writeRaw(t, dir, "a.md", "top") writeParked(t, dir, "a.md", parkedNote) _, err := RejectNote(dir, RejectOptions{Filename: "a.md"}) require.Error(t, err) _, err = RejectNote(dir, RejectOptions{Filename: "a.md", Queue: QueueNeedsReview}) require.NoError(t, err) _, statErr := os.Stat(filepath.Join(dir, "raw", "a.md")) assert.NoError(t, statErr, "the top-level note is untouched") } func TestPromoteNote_NeverIntoARetiredLayoutName(t *testing.T) { for _, w := range []string{"sources", "concepts", "entities", "wiki"} { t.Run(w, func(t *testing.T) { dir := t.TempDir() writeRaw(t, dir, "a.md", "top") _, err := PromoteNote(dir, PromoteOptions{Filename: "a.md", Wing: w, Hall: "facts"}) assert.Error(t, err) _, statErr := os.Stat(filepath.Join(dir, "wiki", w)) assert.ErrorIs(t, statErr, os.ErrNotExist) }) } } func TestListPending_LabelsEveryEntryWithItsQueue(t *testing.T) { dir := t.TempDir() writeRaw(t, dir, "fresh.md", "---\ncreated_at: 2026-10-20T08:00:00Z\n---\nx\n") writeParked(t, dir, "p.md", parkedNote) got, err := ListPending(dir) require.NoError(t, err) require.Len(t, got, 2) queues := map[string]string{} for _, n := range got { queues[n.Filename] = n.Queue } assert.Equal(t, QueueInbox, queues["fresh.md"]) assert.Equal(t, QueueNeedsReview, queues["p.md"]) } // Parked notes that are not markdown (a pdf, a txt) were invisible: the only // trace was a log.md line. func TestListPending_ShowsParkedNonMarkdownFiles(t *testing.T) { dir := t.TempDir() require.NoError(t, os.MkdirAll(filepath.Join(dir, "raw", "needs-review"), 0o755)) require.NoError(t, os.WriteFile(filepath.Join(dir, "raw", "needs-review", "paper.pdf"), []byte("%PDF-1.4 binary"), 0o644)) require.NoError(t, os.WriteFile(filepath.Join(dir, "raw", "needs-review", "plain.txt"), []byte("some text"), 0o644)) got, err := ListPending(dir) require.NoError(t, err) names := map[string]PendingNote{} for _, n := range got { names[n.Filename] = n } require.Contains(t, names, "paper.pdf") require.Contains(t, names, "plain.txt") assert.Equal(t, QueueNeedsReview, names["paper.pdf"].Queue) assert.Contains(t, names["paper.pdf"].Excerpt, "proposal", "points the reader at where the proposal is") } func TestPromoteNote_OnlyMarkdownCanBePromoted(t *testing.T) { dir := t.TempDir() require.NoError(t, os.MkdirAll(filepath.Join(dir, "raw", "needs-review"), 0o755)) require.NoError(t, os.WriteFile(filepath.Join(dir, "raw", "needs-review", "paper.pdf"), []byte("%PDF binary"), 0o644)) _, err := PromoteNote(dir, PromoteOptions{Filename: "paper.pdf", Wing: "homelab", Hall: "facts"}) require.Error(t, err) assert.Contains(t, err.Error(), "markdown") _, statErr := os.Stat(filepath.Join(dir, "raw", "needs-review", "paper.pdf")) assert.NoError(t, statErr, "refused, untouched") }