feat(agent): add log scan task and release notes v1.0.6

Author: goktugcy

CHANGELOG.md

@@ -15,6 +15,19 @@ Formatting rules:
 
 ## [Unreleased]
 
+## [1.0.6] - 2026-04-05
+
+### Added
+
+- Added a new `log.scan` task type with payload validation for `mode` and `sourcePresetId`, including optional root execution guarded by `task` scope checks.
+- Added `noderax-agent log-scan --request <path>` to execute log scan requests from a JSON file and return structured JSON results for task parsing.
+- Added a dedicated log scanning engine that supports preset sources (`syslog`, `auth.log`, `kern.log`, `noderax-agent`) with `preview` and `monitor` modes, source-aware cursor handling, and hard limits for lines, bytes, and backfill.
+
+### Fixed
+
+- Monitor-mode file scans now detect log rotation (inode change) and truncation (offset beyond file size), automatically reset the cursor, replay tail lines, and emit warning metadata for downstream diagnostics.
+- Log scan task result parsing now reports explicit system errors when command output is empty or invalid JSON, improving failure visibility in task logs.
+
 ## [1.0.5] - 2026-04-05
 
 ### Fixed

internal/agentctl/commands.go

@@ -129,6 +129,8 @@ func (c CLI) Handle(ctx context.Context, args []string) (bool, error) {
 	case "config":
 		brand.PrintLogo(c.stdoutOrDefault())
 		return true, c.Config(ctx, args[1:])
+	case "log-scan":
+		return true, c.LogScan(ctx, args[1:])
 	case "version", "--version", "-v":
 		return true, c.VersionInfo(args[1:])
 	default:

internal/agentctl/logscan.go

@@ -0,0 +1,43 @@
+package agentctl
+
+import (
+	"context"
+	"encoding/json"
+	"flag"
+	"fmt"
+	"io"
+	"os"
+
+	"github.com/noderax/noderax-agent/internal/logscan"
+)
+
+func (c CLI) LogScan(ctx context.Context, args []string) error {
+	flagSet := flag.NewFlagSet("log-scan", flag.ContinueOnError)
+	flagSet.SetOutput(io.Discard)
+
+	requestPath := flagSet.String("request", "", "")
+	if err := flagSet.Parse(args); err != nil {
+		return err
+	}
+	if *requestPath == "" {
+		return fmt.Errorf("log-scan requires --request")
+	}
+	if flagSet.NArg() > 0 {
+		return fmt.Errorf("unexpected log-scan arguments: %v", flagSet.Args())
+	}
+
+	request, err := logscan.LoadRequest(*requestPath)
+	if err != nil {
+		return err
+	}
+	_ = os.Remove(*requestPath)
+
+	result, err := logscan.Run(ctx, request)
+	if err != nil {
+		return err
+	}
+
+	encoder := json.NewEncoder(c.stdoutOrDefault())
+	encoder.SetEscapeHTML(false)
+	return encoder.Encode(result)
+}