fix(cli): pin man-page date so docs check is deterministic (#329)

cobra/doc.GenManHeader.Date defaults to time.Now() when nil, embedding
the build-time month/year in every man page header. The Docs check job
ran make generate docs and diffed against committed pages, so on the
1st of every month every PR failed because the regenerated headers no
longer matched the committed ones.

Pin the date to a fixed constant (2026-01-01 UTC) and rewrite the 45
committed pages from "Apr 2026" to "Jan 2026" so the regenerated output
matches. The constant is bumped intentionally rather than implicitly
drifting with wall-clock.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: zeevdr

cmd/decree/gendocs.go

@@ -5,11 +5,18 @@ import (
 	"os"
 	"path/filepath"
 	"strings"
+	"time"
 
 	"github.com/spf13/cobra"
 	"github.com/spf13/cobra/doc"
 )
 
+// manPageDate pins the timestamp embedded in generated man pages so the
+// output is byte-deterministic across runs. cobra/doc defaults to
+// time.Now(), which produces a different "Mon YYYY" header every month
+// and breaks the docs-up-to-date CI check on the 1st of each month.
+var manPageDate = time.Date(2026, time.January, 1, 0, 0, 0, 0, time.UTC)
+
 var genDocsCmd = &cobra.Command{
 	Use:    "gen-docs [output-dir]",
 	Short:  "Generate CLI reference documentation in markdown",
@@ -66,6 +73,7 @@ var genManCmd = &cobra.Command{
 			Section: "1",
 			Source:  "OpenDecree",
 			Manual:  "OpenDecree CLI",
+			Date:    &manPageDate,
 		}
 
 		rootCmd.DisableAutoGenTag = true