feat: Add validate command for evidence.yaml configuration and complete command for shell completion.

Author: canaria-computer

README.md

@@ -416,21 +416,30 @@ down-force init --stdout
 
 ### 4.3 検証コマンド
 
+✅ **実装済み**: `cmd/validate.go`, `internal/config/config.go`
+
 ```bash
-# 設定ファイル検証（JSONスキーマ使用）
-down-force validate <config-file>
+down-force validate <config-file>        # Default: strict mode
 
-# 詳細検証（UA名の重複チェックなど）
-down-force validate <config-file> --strict
+down-force validate <config-file> --lax  # Lenient mode (schema only)
 ```
 
+strict モードでは以下を検証:
+- JSON Schema validation
+- UA名の重複チェック
+- ディレクトリ名として有効なUA名チェック
+- 必須フィールドの存在チェック
+
 ### 4.4 補完コマンド
 
+✅ **実装済み**: `cmd/complete.go`
+
 ```bash
 # evidence.yamlにUA文字列を自動追加（べき等性確保）
 down-force complete <config-file>
 
-# 出力例: user_agent_stringが自動追加される
+# プレビューのみ（ファイル変更なし）
+down-force complete <config-file> --dry-run
 ```
 
 ## 5. 処理フロー

cmd/complete.go

@@ -1,40 +1,93 @@
 /*
-Copyright © 2025 NAME HERE <EMAIL ADDRESS>
-
+Copyright © 2025 canaria-computer
 */
 package cmd
 
 import (
 	"fmt"
+	"os"
 
+	"github.com/canaria-computer/down-force/internal/config"
+	"github.com/charmbracelet/log"
 	"github.com/spf13/cobra"
 )
 
+var (
+	completeDryRun bool
+)
+
 // completeCmd represents the complete command
 var completeCmd = &cobra.Command{
-	Use:   "complete",
-	Short: "A brief description of your command",
-	Long: `A longer description that spans multiple lines and likely contains examples
-and usage of using your command. For example:
-
-Cobra is a CLI library for Go that empowers applications.
-This application is a tool to generate the needed files
-to quickly create a Cobra application.`,
-	Run: func(cmd *cobra.Command, args []string) {
-		fmt.Println("complete called")
-	},
+	Use:   "complete <config-file>",
+	Short: "Auto-complete user agent strings in evidence.yaml",
+	Long: `Auto-complete missing user agent strings in an evidence.yaml file.
+
+When a user agent entry uses a builtin name (e.g., "Desktop_Chrome") but doesn't
+specify a user_agent_string, this command fills in the builtin UA string and
+viewport dimensions.
+
+This ensures idempotency - the config file will contain the exact UA strings
+that will be used during evidence collection.
+
+Examples:
+  # Complete missing UA strings in place
+  down-force complete evidence.yaml
+
+  # Preview changes without modifying the file
+  down-force complete evidence.yaml --dry-run
+`,
+	Args: cobra.ExactArgs(1),
+	Run:  runComplete,
 }
 
 func init() {
-	liteCmd.AddCommand(completeCmd)
+	rootCmd.AddCommand(completeCmd)
+
+	completeCmd.Flags().BoolVar(&completeDryRun, "dry-run", false, "Preview changes without modifying the file")
+}
+
+func runComplete(cmd *cobra.Command, args []string) {
+	configPath := args[0]
+
+	// Check if config file exists
+	if _, err := os.Stat(configPath); os.IsNotExist(err) {
+		log.Fatalf("❌ Config file not found: %s", configPath)
+	}
+
+	// Load and complete config
+	cfg, modified, err := config.LoadAndCompleteConfig(configPath)
+	if err != nil {
+		log.Fatalf("❌ Failed to load config: %v", err)
+	}
+
+	if !modified {
+		log.Infof("✅ No changes needed: all user agents are already complete")
+		return
+	}
+
+	// Show what was completed
+	fmt.Println("📝 Changes to be applied:")
+	fmt.Println()
+
+	for _, ua := range cfg.UserAgents {
+		builtin := config.GetBuiltinUserAgent(ua.Name)
+		if builtin != nil && ua.UserAgentString == builtin.UserAgentString {
+			fmt.Printf("  • %s\n", ua.Name)
+			fmt.Printf("    UA: %s...\n", truncateString(ua.UserAgentString, 60))
+			fmt.Printf("    Viewport: %dx%d\n", ua.ViewportWidth, ua.ViewportHeight)
+			fmt.Println()
+		}
+	}
 
-	// Here you will define your flags and configuration settings.
+	if completeDryRun {
+		log.Info("🔍 Dry run - no changes written")
+		return
+	}
 
-	// Cobra supports Persistent Flags which will work for this command
-	// and all subcommands, e.g.:
-	// completeCmd.PersistentFlags().String("foo", "", "A help for foo")
+	// Save the completed config
+	if err := config.SaveConfig(configPath, cfg); err != nil {
+		log.Fatalf("❌ Failed to save config: %v", err)
+	}
 
-	// Cobra supports local flags which will only run when this command
-	// is called directly, e.g.:
-	// completeCmd.Flags().BoolP("toggle", "t", false, "Help message for toggle")
+	log.Infof("✅ Updated %s with complete user agent strings", configPath)
 }

cmd/validate.go

@@ -1,40 +1,130 @@
 /*
-Copyright © 2025 NAME HERE <EMAIL ADDRESS>
-
+Copyright © 2025 canaria-computer
 */
 package cmd
 
 import (
 	"fmt"
+	"os"
+	"path/filepath"
 
+	"github.com/canaria-computer/down-force/internal/config"
+	"github.com/charmbracelet/log"
 	"github.com/spf13/cobra"
 )
 
+var (
+	validateLax bool
+)
+
 // validateCmd represents the validate command
 var validateCmd = &cobra.Command{
-	Use:   "validate",
-	Short: "A brief description of your command",
-	Long: `A longer description that spans multiple lines and likely contains examples
-and usage of using your command. For example:
-
-Cobra is a CLI library for Go that empowers applications.
-This application is a tool to generate the needed files
-to quickly create a Cobra application.`,
-	Run: func(cmd *cobra.Command, args []string) {
-		fmt.Println("validate called")
-	},
+	Use:   "validate <config-file>",
+	Short: "Validate an evidence.yaml configuration file",
+	Long: `Validate an evidence.yaml configuration file against the JSON schema.
+
+By default, strict validation is performed which includes:
+- JSON Schema validation
+- Duplicate user agent name detection
+- Directory name validity check for UA names
+- Required field checks
+
+Use --lax for lenient validation (schema only).
+
+Examples:
+  # Strict validation (default)
+  down-force validate evidence.yaml
+
+  # Lenient validation (schema only)
+  down-force validate evidence.yaml --lax
+`,
+	Args: cobra.ExactArgs(1),
+	Run:  runValidate,
 }
 
 func init() {
-	liteCmd.AddCommand(validateCmd)
+	rootCmd.AddCommand(validateCmd)
+
+	validateCmd.Flags().BoolVar(&validateLax, "lax", false, "Lenient validation (schema only, skip strict checks)")
+}
+
+func runValidate(cmd *cobra.Command, args []string) {
+	configPath := args[0]
+
+	// Check if config file exists
+	if _, err := os.Stat(configPath); os.IsNotExist(err) {
+		log.Fatalf("❌ Config file not found: %s", configPath)
+	}
+
+	// Find schema file
+	schemaPath, err := findSchemaPath()
+	if err != nil {
+		log.Fatalf("❌ Failed to find schema: %v", err)
+	}
+
+	// Validate
+	strict := !validateLax
+	result, err := config.ValidateConfigFromFile(configPath, schemaPath, strict)
+	if err != nil {
+		log.Fatalf("❌ Validation failed: %v", err)
+	}
+
+	// Report results
+	if result.Valid {
+		mode := "strict"
+		if validateLax {
+			mode = "lax"
+		}
+		log.Infof("✅ Validation passed (%s mode): %s", mode, configPath)
+	} else {
+		log.Errorf("❌ Validation failed: %d error(s) found", len(result.Errors))
+		fmt.Println()
+
+		for i, verr := range result.Errors {
+			path := verr.Path
+			if path == "" {
+				path = "(root)"
+			}
+			fmt.Printf("  %d. %s\n", i+1, verr.Message)
+			fmt.Printf("     Path: %s\n", path)
+			if verr.Value != nil {
+				fmt.Printf("     Value: %v\n", verr.Value)
+			}
+			fmt.Println()
+		}
+
+		os.Exit(1)
+	}
+}
+
+// findSchemaPath locates the JSON schema file
+func findSchemaPath() (string, error) {
+	// Try relative paths first
+	candidates := []string{
+		"schema/evidence.schema.json",
+		"../schema/evidence.schema.json",
+		"../../schema/evidence.schema.json",
+	}
 
-	// Here you will define your flags and configuration settings.
+	// Get executable path and try relative to it
+	execPath, err := os.Executable()
+	if err == nil {
+		execDir := filepath.Dir(execPath)
+		candidates = append(candidates,
+			filepath.Join(execDir, "schema", "evidence.schema.json"),
+			filepath.Join(execDir, "..", "schema", "evidence.schema.json"),
+		)
+	}
 
-	// Cobra supports Persistent Flags which will work for this command
-	// and all subcommands, e.g.:
-	// validateCmd.PersistentFlags().String("foo", "", "A help for foo")
+	for _, path := range candidates {
+		absPath, err := filepath.Abs(path)
+		if err != nil {
+			continue
+		}
+		if _, err := os.Stat(absPath); err == nil {
+			return absPath, nil
+		}
+	}
 
-	// Cobra supports local flags which will only run when this command
-	// is called directly, e.g.:
-	// validateCmd.Flags().BoolP("toggle", "t", false, "Help message for toggle")
+	return "", fmt.Errorf("schema file not found, searched: %v", candidates)
 }

go.mod

@@ -6,7 +6,9 @@ toolchain go1.24.11
 
 require (
 	github.com/charmbracelet/huh v0.8.0
+	github.com/santhosh-tekuri/jsonschema/v5 v5.3.1
 	golang.org/x/net v0.47.0
+	gopkg.in/yaml.v3 v3.0.1
 )
 
 require (

go.sum

@@ -77,6 +77,8 @@ github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJ
 github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
 github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
+github.com/santhosh-tekuri/jsonschema/v5 v5.3.1 h1:lZUw3E0/J3roVtGQ+SCrUrg3ON6NgVqpn3+iol9aGu4=
+github.com/santhosh-tekuri/jsonschema/v5 v5.3.1/go.mod h1:uToXkOrWAZ6/Oc07xWQrPOhJotwFIyu2bBVN41fcDUY=
 github.com/spf13/cobra v1.10.2 h1:DMTTonx5m65Ic0GOoRY2c16WCbHxOOw6xxezuLaBpcU=
 github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTUUS4=
 github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
@@ -116,6 +118,7 @@ golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
 golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM=
 golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=