docs: add specs and blackbox tests foundation

.github/workflows/blackbox-tests.yml

@@ -0,0 +1,60 @@
+name: Black-box Tests
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - ".github/workflows/blackbox-tests.yml"
+      - "cmd/**"
+      - "go.mod"
+      - "go.sum"
+      - "internal/**"
+      - "Makefile"
+      - "specs/**"
+      - "tests/**"
+  pull_request:
+    # Keep this workflow directly rerunnable from PR-only maintenance commits.
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - ready_for_review
+    paths:
+      - ".github/workflows/blackbox-tests.yml"
+      - "cmd/**"
+      - "go.mod"
+      - "go.sum"
+      - "internal/**"
+      - "Makefile"
+      - "specs/**"
+      - "tests/**"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  GO_VERSION: "1.26.3"
+
+jobs:
+  blackbox:
+    name: Black-box tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Check out code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Set up Go
+        uses: actions/setup-go@4a3601121dd01d1626a1e23e37211e3254c1c06c # v6.4.0
+        with:
+          go-version: ${{ env.GO_VERSION }}
+
+      - name: Build Dagu binary
+        run: make bin
+
+      - name: Run black-box tests
+        env:
+          DAGU_BIN: ${{ github.workspace }}/.local/bin/dagu
+        run: go test -count=1 ./tests

cmd/main.go

@@ -39,7 +39,6 @@ func init() {
 	rootCmd.AddCommand(cmd.Stop())
 	rootCmd.AddCommand(cmd.Restart())
 	rootCmd.AddCommand(cmd.Dry())
-	rootCmd.AddCommand(cmd.Validate())
 	rootCmd.AddCommand(cmd.Status())
 	rootCmd.AddCommand(cmd.History())
 	rootCmd.AddCommand(cmd.Version())
@@ -55,6 +54,7 @@ func init() {
 	rootCmd.AddCommand(cmd.Upgrade())
 	rootCmd.AddCommand(cmd.License())
 	rootCmd.AddCommand(cmd.Schema())
+	rootCmd.AddCommand(cmd.Workflow())
 	rootCmd.AddCommand(cmd.Example())
 	rootCmd.AddCommand(cmd.Config())
 	rootCmd.AddCommand(cmd.ContextCommand())

cmd/main_test.go

@@ -79,7 +79,7 @@ func TestRootCommand(t *testing.T) {
 			rootCmd.AddCommand(cmd.Stop())
 			rootCmd.AddCommand(cmd.Restart())
 			rootCmd.AddCommand(cmd.Dry())
-			rootCmd.AddCommand(cmd.Validate())
+			rootCmd.AddCommand(cmd.Workflow())
 			rootCmd.AddCommand(cmd.Status())
 			rootCmd.AddCommand(cmd.Version())
 			rootCmd.AddCommand(cmd.Server())
@@ -169,7 +169,7 @@ func TestRootCommandStructure(t *testing.T) {
 		"stop",
 		"restart",
 		"dry",
-		"validate",
+		"workflow",
 		"status",
 		"version",
 		"server",
@@ -190,6 +190,7 @@ func TestRootCommandStructure(t *testing.T) {
 	for _, expected := range expectedCommands {
 		assert.True(t, commands[expected], "Command %s not found", expected)
 	}
+	assert.False(t, commands["validate"], "Command validate should be removed from the v3 root command surface")
 }
 
 func TestRootCommandMetadata(t *testing.T) {
@@ -243,7 +244,7 @@ operations, or remote commands.
 	rootCmd.AddCommand(cmd.Stop())
 	rootCmd.AddCommand(cmd.Restart())
 	rootCmd.AddCommand(cmd.Dry())
-	rootCmd.AddCommand(cmd.Validate())
+	rootCmd.AddCommand(cmd.Workflow())
 	rootCmd.AddCommand(cmd.Status())
 	rootCmd.AddCommand(cmd.Version())
 	rootCmd.AddCommand(cmd.Server())

internal/cmd/context.go

@@ -540,7 +540,7 @@ func serviceForCommand(cmdName string) config.Service {
 	case "start", "restart", "retry", "dry", "exec", "agent":
 		return config.ServiceAgent
 	default:
-		// For all other commands (status, stop, validate, etc.), load all config
+		// For all other commands (status, stop, etc.), load all config.
 		return config.ServiceNone
 	}
 }