feat: let session destroy target latest session

Author: tmuskal

docs/cli-reference.md

@@ -59,9 +59,9 @@ List persisted sessions from `.agentpowershell/sessions.json`. Text mode include
 
 Show one persisted session from `.agentpowershell/sessions.json`. If `session-id` is omitted, the command returns the most recently created session. Missing sessions return `status: not-found` and a non-zero exit code.
 
-### `session destroy <session-id>`
+### `session destroy [session-id]`
 
-Remove a session from the session store. Missing sessions return `status: not-found`, `removed: false`, and a non-zero exit code.
+Remove a session from the session store. If `session-id` is omitted, the command removes the most recently created session. Missing sessions return `status: not-found`, `removed: false`, and a non-zero exit code.
 
 ### `policy validate <path>`
 

docs/getting-started.md

@@ -51,6 +51,12 @@ Show the most recent session:
 dotnet run --project src/AgentPowerShell.Cli -- session show --output json
 ```
 
+Destroy the most recent session:
+
+```powershell
+dotnet run --project src/AgentPowerShell.Cli -- session destroy --output json
+```
+
 Execute an explicit inline PowerShell command through the current runtime path:
 
 ```powershell

src/AgentPowerShell.Cli/CliApp.cs

@@ -250,14 +250,19 @@ private static Command BuildSessionCommand(Option<string> outputOption)
         }, showSessionId, outputOption);
 
         var destroy = new Command("destroy", "Destroy session");
-        var sessionId = new Argument<string>("session-id");
+        var sessionId = new Argument<string?>("session-id", () => null);
         destroy.AddArgument(sessionId);
-        destroy.SetHandler(async (string id, string output) =>
+        destroy.SetHandler(async (string? id, string output) =>
         {
-            var store = new SessionStore(Path.Combine(Environment.CurrentDirectory, ".agentpowershell", "sessions.json"));
+            using var store = new SessionStore(GetSessionsPath());
             await store.LoadAsync(CancellationToken.None).ConfigureAwait(false);
-            var removed = await store.RemoveAsync(id, CancellationToken.None).ConfigureAwait(false);
-            Emit(output, new { command = "session destroy", sessionId = id, removed, status = removed ? "removed" : "not-found" });
+            var sessions = await store.ListAsync(CancellationToken.None).ConfigureAwait(false);
+            var resolvedId = string.IsNullOrWhiteSpace(id)
+                ? sessions.Count == 0 ? null : sessions[^1].SessionId
+                : id;
+            var removed = !string.IsNullOrWhiteSpace(resolvedId)
+                && await store.RemoveAsync(resolvedId, CancellationToken.None).ConfigureAwait(false);
+            Emit(output, new { command = "session destroy", sessionId = resolvedId ?? id, removed, status = removed ? "removed" : "not-found" });
             if (!removed)
             {
                 Environment.ExitCode = 1;

tests/AgentPowerShell.Tests/ExecutionPolicyTests.cs

@@ -1671,6 +1671,52 @@ public void DaemonLaunchResolver_Falls_Back_To_Source_Project_When_Repo_Is_Avail
         }
     }
 
+    [Fact]
+    public async Task CliApp_SessionDestroy_Uses_Latest_Session_By_Default()
+    {
+        var root = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid():N}-cli-session-destroy-latest");
+        Directory.CreateDirectory(root);
+        var originalDirectory = Environment.CurrentDirectory;
+        var originalOut = Console.Out;
+
+        try
+        {
+            Environment.CurrentDirectory = root;
+
+            using (var store = new SessionStore(Path.Combine(root, ".agentpowershell", "sessions.json")))
+            {
+                await store.LoadAsync(CancellationToken.None);
+                await store.GetOrCreateAsync("session-a", root, new AgentPowerShellConfig().Sessions, CancellationToken.None);
+                await Task.Delay(10);
+                await store.GetOrCreateAsync("session-b", root, new AgentPowerShellConfig().Sessions, CancellationToken.None);
+            }
+
+            using var writer = new StringWriter();
+            Console.SetOut(writer);
+
+            Assert.Equal(0, CliApp.Run(["session", "destroy", "--output", "json"]));
+            var payload = writer.ToString();
+            Assert.Contains("\"command\":\"session destroy\"", payload, StringComparison.Ordinal);
+            Assert.Contains("\"sessionId\":\"session-b\"", payload, StringComparison.Ordinal);
+            Assert.Contains("\"removed\":true", payload, StringComparison.Ordinal);
+
+            using var verifyStore = new SessionStore(Path.Combine(root, ".agentpowershell", "sessions.json"));
+            await verifyStore.LoadAsync(CancellationToken.None);
+            var sessions = await verifyStore.ListAsync(CancellationToken.None);
+            Assert.DoesNotContain(sessions, session => session.SessionId == "session-b");
+            Assert.Contains(sessions, session => session.SessionId == "session-a");
+        }
+        finally
+        {
+            Console.SetOut(originalOut);
+            Environment.CurrentDirectory = originalDirectory;
+            if (Directory.Exists(root))
+            {
+                Directory.Delete(root, recursive: true);
+            }
+        }
+    }
+
     [Fact]
     public async Task SessionReportGenerator_Builds_Markdown_And_Findings()
     {