Rewrite remembering in Go

The shell pipeline (sed | sort | tee | awk | sort | cut | "$@"
plus the cut | uniq | awk profile rewrite) becomes a single static
binary with the same observable behaviour, pinned by the original
ranking.sh, signals.sh and cli-opts.sh suites, now aimed at
remembering.bin:

- the profile keeps the exact on-disk format, COUNT profile TEXT,
  byte-sorted with new picks appended at 1 and offered-but-never-
  picked entries persisted at 0;
- the menu stays count-descending with byte-order ties, stdin
  alone defines what is offered, and duplicate profile lines sum
  for ranking but collapse to the highest count on rewrite, as
  sort | uniq -f1 did;
- the wrapped command's exit status is forwarded as-is (128+sig
  for signal deaths), its stderr passes through, and an empty pick
  learns nothing;
- the profile rewrite stays atomic via .tmp plus rename.

Per the house CLI conventions, -h/-V/--help/--version are gone
(the manpage is the documentation; bad options print the usage on
stderr and exit 2), and getopts-style attached option arguments
(-pNAME) are not accepted any more --- no script in the wild used
them.

The project layout follows rot: raw go tool compile/link Makefile,
mkdeps.sh-generated deps.mk, white-box unit suite, fuzz target
over the profile parse/serialize roundtrip, functional pick
roundtrip, a 1M-line ranking benchmark, and a single English
asciidoc manpage absorbing the old .5 page; the po4a/aux release
machinery goes away.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

1 files changed, 76 insertions, 0 deletions

diff --git a/tests/fuzz/profile/remembering.go b/tests/fuzz/profile/remembering.go
new file mode 100644
index 0000000..aab4ac4
--- /dev/null
+++ b/tests/fuzz/profile/remembering.go
@@ -0,0 +1,76 @@
+package remembering
+
+import (
+	"os"
+	"reflect"
+	"strings"
+	"testing"
+	"testing/internal/testdeps"
+)
+
+
+
+func fn(f *testing.F) {
+	f.Add("0 profile a\n1 profile b\n", "c\nd", "a")
+	f.Add("", "x", "x")
+	f.Fuzz(func(
+		t *testing.T,
+		content string,
+		input string,
+		choice string,
+	) {
+		profile := parseProfile(content)
+		again := parseProfile(serializeProfile(profile))
+		if !reflect.DeepEqual(again, profile) {
+			t.Fatalf(
+				"roundtrip: %#v != %#v",
+				again, profile,
+			)
+		}
+
+		if choice == "" ||
+			strings.Contains(choice, "\n") {
+			return
+		}
+		lines := splitLines(input)
+		next := nextProfile(profile, lines, choice)
+
+		found := false
+		for _, entry := range next {
+			if entry.text == choice {
+				found = true
+			}
+		}
+		if !found {
+			t.Fatalf(
+				"pick %q not learnt in %#v",
+				choice, next,
+			)
+		}
+
+		reNext := parseProfile(serializeProfile(next))
+		if !reflect.DeepEqual(reNext, next) {
+			t.Fatalf(
+				"next roundtrip: %#v != %#v",
+				reNext, next,
+			)
+		}
+	})
+}
+
+
+
+func MainTest() {
+	fuzzTargets := []testing.InternalFuzzTarget{
+		{"fn", fn},
+	}
+
+	deps := testdeps.TestDeps{}
+	tests      := []testing.InternalTest     {}
+	benchmarks := []testing.InternalBenchmark{}
+	examples   := []testing.InternalExample  {}
+	m := testing.MainStart(
+		deps, tests, benchmarks, fuzzTargets, examples,
+	)
+	os.Exit(m.Run())
+}