first commit

2026-08-14 23:41:57 +08:00
commit 086803a8dd
471 changed files with 91938 additions and 0 deletions
@@ -0,0 +1,51 @@
+// This file provides the cli-layer helper that runs the SessionStart hook event
+// (US-010, FR-1) synchronously at the run-start seam. It lives in the cli layer
+// alongside the other hook assembly (hooks_install.go) because it bridges the
+// resolved Dispatcher and the runtime.RunConfig, which runtime itself must not
+// know about.
+//
+// SessionStart is dispatched SYNCHRONOUSLY at run start rather than through the
+// async OnEvent notifier: an async dispatch could land after the first turn's
+// request is built, so its additionalContext would miss the first turn (SPEC
+// §11.2). Dispatching inline before the loop starts guarantees the injected
+// context is present for the very first turn.
+//
+// Only injection is supported (there is nothing to block at session start): any
+// additionalContext is registered as a ONE-SHOT reminder on cfg.Reminders so the
+// text is injected into the first turn's provider context via the existing
+// TransformContext seam, then never again. It is not written to the persisted
+// message history (the reminder mechanism is ephemeral by construction).
+package run
+
+import (
+	"context"
+
+	"github.com/smallnest/pigo/internal/hooks"
+	"github.com/smallnest/pigo/internal/runtime"
+)
+
+// DispatchSessionStart runs the SessionStart event once at run start. source is
+// "startup" for a fresh run or "resume" when continuing an existing session; it
+// is carried in the HookInput so hooks can differentiate. Any additionalContext
+// returned by the hook is registered as a one-shot reminder on cfg.Reminders
+// (allocating a registry when cfg.Reminders is nil) so it is injected into the
+// first turn only.
+//
+// A nil dispatcher (no hooks configured) is a no-op.
+func DispatchSessionStart(ctx context.Context, d *hooks.Dispatcher, cfg *runtime.RunConfig, deps HookDeps, source string) {
+	if d == nil {
+		return
+	}
+	dec := d.Dispatch(ctx, "SessionStart", "", hooks.HookInput{
+		EventType:  "SessionStart",
+		SessionID:  deps.SessionID,
+		ProjectDir: deps.ProjectDir,
+		Source:     source,
+	})
+	if dec.AdditionalContext != "" && cfg != nil {
+		if cfg.Reminders == nil {
+			cfg.Reminders = runtime.NewReminderRegistry()
+		}
+		cfg.Reminders.Register(runtime.NewOneShotReminder("session-start", dec.AdditionalContext))
+	}
+}