diff --git a/pkg/commands/deps.go b/pkg/commands/deps.go
index 10bee236a..20fcf0a87 100644
--- a/pkg/commands/deps.go
+++ b/pkg/commands/deps.go
@@ -7,7 +7,7 @@ import "github.com/sipeed/picoclaw/pkg/config"
 // invocation time, not at construction time, so late-bound values
 // (e.g. channelManager set after NewAgentLoop) are visible.
 type Deps struct {
-	Config             *config.Config
+	Config             *config.Config // reserved for Phase 2 session commands
 	GetModelInfo       func() (name, provider string)
 	ListAgentIDs       func() []string
 	GetEnabledChannels func() []string
diff --git a/pkg/commands/executor.go b/pkg/commands/executor.go
index 0845b5950..9dcaef672 100644
--- a/pkg/commands/executor.go
+++ b/pkg/commands/executor.go
@@ -8,7 +8,9 @@ import (
 type Outcome int
 
 const (
+	// OutcomePassthrough means this input should continue through normal agent flow.
 	OutcomePassthrough Outcome = iota
+	// OutcomeHandled means a command handler executed (with or without handler error).
 	OutcomeHandled
 )