From db71ec8b7f44b7e1bf7904f78fd0f7960a7cd333 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 20 May 2025 14:09:32 -0500 Subject: [PATCH 01/48] another intermediate commit - added .NET --- .github/copilot-instructions.md | 9 + .gitignore | 66 +++++ DotnetApp.Tests/DotnetApp.Tests.csproj | 22 ++ DotnetApp.Tests/Models/TestItemTest.cs | 149 ++++++++++ .../Services/InMemoryTaskServiceTests.cs | 102 +++++++ DotnetApp/DotnetApp.csproj | 14 + DotnetApp/Models/TaskItem.cs | 128 +++++++++ DotnetApp/Program.cs | 44 +++ DotnetApp/Services/CsvTaskService.cs | 154 ++++++++++ DotnetApp/Services/ITaskService.cs | 45 +++ DotnetApp/Services/InMemoryTaskService.cs | 59 ++++ DotnetApp/wwwroot/index.html | 272 ++++++++++++++++++ 12 files changed, 1064 insertions(+) create mode 100644 .github/copilot-instructions.md create mode 100644 DotnetApp.Tests/DotnetApp.Tests.csproj create mode 100644 DotnetApp.Tests/Models/TestItemTest.cs create mode 100644 DotnetApp.Tests/Services/InMemoryTaskServiceTests.cs create mode 100644 DotnetApp/DotnetApp.csproj create mode 100644 DotnetApp/Models/TaskItem.cs create mode 100644 DotnetApp/Program.cs create mode 100644 DotnetApp/Services/CsvTaskService.cs create mode 100644 DotnetApp/Services/ITaskService.cs create mode 100644 DotnetApp/Services/InMemoryTaskService.cs create mode 100644 DotnetApp/wwwroot/index.html diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 0000000..a04f2f8 --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1,9 @@ +# General +When refactoring for a decrease in Cognitive Complexity, remove unnecessary logic. + +# Python +Always write my Python unit tests using `pytest`, not `unittest`. + +# .NET +When suggesting .NET code, only suggest code compatible with .NET 8. +Always write my .NET unit tests using `Xunit`. \ No newline at end of file diff --git a/.gitignore b/.gitignore index 82f9275..07a7aa0 100644 --- a/.gitignore +++ b/.gitignore @@ -160,3 +160,69 @@ cython_debug/ # and can be added to the global gitignore or merged into this file. For a more nuclear # option (not recommended) you can uncomment the following to ignore the entire idea folder. #.idea/ + + +### DOTNET SECTION ### +## A streamlined .gitignore for modern .NET projects +## including temporary files, build results, and +## files generated by popular .NET tools. If you are +## developing with Visual Studio, the VS .gitignore +## https://github.com/github/gitignore/blob/main/VisualStudio.gitignore +## has more thorough IDE-specific entries. +## +## Get latest from https://github.com/github/gitignore/blob/main/Dotnet.gitignore + +# Build results +[Dd]ebug/ +[Dd]ebugPublic/ +[Rr]elease/ +[Rr]eleases/ +x64/ +x86/ +[Ww][Ii][Nn]32/ +[Aa][Rr][Mm]/ +[Aa][Rr][Mm]64/ +bld/ +[Bb]in/ +[Oo]bj/ +[Ll]og/ +[Ll]ogs/ + +# .NET Core +project.lock.json +project.fragment.lock.json +artifacts/ + +# ASP.NET Scaffolding +ScaffoldingReadMe.txt + +# NuGet Packages +*.nupkg +# NuGet Symbol Packages +*.snupkg + +# Others +~$* +*~ +CodeCoverage/ + +# MSBuild Binary and Structured Log +*.binlog + +# MSTest test Results +[Tt]est[Rr]esult*/ +[Bb]uild[Ll]og.* + +# NUnit +*.VisualState.xml +TestResult.xml +nunit-*.xml + +# SonarQube +.sonar/ +.scannerwork/ +.sonarqube/ +sonar-project.properties +.sonarlint/ +.sonarwork/ +reports/ \ No newline at end of file diff --git a/DotnetApp.Tests/DotnetApp.Tests.csproj b/DotnetApp.Tests/DotnetApp.Tests.csproj new file mode 100644 index 0000000..7d69ca6 --- /dev/null +++ b/DotnetApp.Tests/DotnetApp.Tests.csproj @@ -0,0 +1,22 @@ + + + + net8.0 + + + + + + + runtime; build; native; contentfiles; analyzers; buildtransitive + all + + + + all + runtime; build; native; contentfiles; analyzers; buildtransitive + + + + + diff --git a/DotnetApp.Tests/Models/TestItemTest.cs b/DotnetApp.Tests/Models/TestItemTest.cs new file mode 100644 index 0000000..0ccff25 --- /dev/null +++ b/DotnetApp.Tests/Models/TestItemTest.cs @@ -0,0 +1,149 @@ +using System; +using Xunit; +using DotnetApp.Models; + +namespace DotnetApp.Models.Tests +{ + public class TaskItemTest + { + [Fact] + public void CalculateTaskScore_ShouldReturnCorrectScore_ForPriorityZero() + { + // Arrange + var task = new TaskItem + { + Priority = 0, + Status = "pending", + CreatedAt = DateTime.UtcNow.AddDays(-1), + IsCompleted = false, + Title = "Test Task" + }; + + // Act + var score = task.CalculateTaskScore(); + + // Assert + Assert.Equal(1, score); + } + + [Fact] + public void CalculateTaskScore_ShouldReturnCorrectScore_ForPriorityOneAndPendingStatus() + { + // Arrange + var task = new TaskItem + { + Priority = 1, + Status = "pending", + CreatedAt = DateTime.UtcNow.AddDays(-1), + IsCompleted = false, + Title = "Test Task" + }; + + // Act + var score = task.CalculateTaskScore(); + + // Assert + Assert.Equal(13, score); + } + + [Fact] + public void CalculateTaskScore_ShouldReturnCorrectScore_ForPriorityTwoAndInProgressStatus() + { + // Arrange + var task = new TaskItem + { + Priority = 2, + Status = "in-progress", + CreatedAt = DateTime.UtcNow.AddDays(-8), + IsCompleted = false, + Title = "Test Task" + }; + + // Act + var score = task.CalculateTaskScore(); + + // Assert + Assert.Equal(10, score); + } + + [Fact] + public void CalculateTaskScore_ShouldDoubleScore_ForPendingStatusAndOldTask() + { + // Arrange + var task = new TaskItem + { + Priority = 2, + Status = "pending", + CreatedAt = DateTime.UtcNow.AddDays(-15), + IsCompleted = false, + Title = "Test Task" + }; + + // Act + var score = task.CalculateTaskScore(); + + // Assert + Assert.Equal(15, score); + } + + [Fact] + public void CalculateTaskScore_ShouldSubtractScore_ForCompletedInProgressTask() + { + // Arrange + var task = new TaskItem + { + Priority = 2, + Status = "in-progress", + CreatedAt = DateTime.UtcNow.AddDays(-1), + IsCompleted = true, + Title = "Test Task" + }; + + // Act + var score = task.CalculateTaskScore(); + + // Assert + Assert.Equal(0, score); + } + + [Fact] + public void CalculateTaskScore_ShouldAddScore_ForLongWordsInTitle() + { + // Arrange + var task = new TaskItem + { + Priority = 3, + Status = "in-progress", + CreatedAt = DateTime.UtcNow.AddDays(-1), + IsCompleted = false, + Title = "ThisIsAVeryLongWord Task" + }; + + // Act + var score = task.CalculateTaskScore(); + + // Assert + Assert.Equal(2, score); + } + + [Fact] + public void CalculateTaskScore_ShouldReturnZero_ForNegativeScore() + { + // Arrange + var task = new TaskItem + { + Priority = 3, + Status = "completed", + CreatedAt = DateTime.UtcNow.AddDays(-1), + IsCompleted = true, + Title = "Test Task" + }; + + // Act + var score = task.CalculateTaskScore(); + + // Assert + Assert.Equal(1, score); + } + } +} \ No newline at end of file diff --git a/DotnetApp.Tests/Services/InMemoryTaskServiceTests.cs b/DotnetApp.Tests/Services/InMemoryTaskServiceTests.cs new file mode 100644 index 0000000..b4ff870 --- /dev/null +++ b/DotnetApp.Tests/Services/InMemoryTaskServiceTests.cs @@ -0,0 +1,102 @@ +using System.Linq; +using DotnetApp.Models; +using DotnetApp.Services; +using Xunit; + +namespace DotnetApp.Tests.Services +{ + public class InMemoryTaskServiceTests + { + [Fact] + public void CreateTask_AssignsIdAndStoresTask() + { + var service = new InMemoryTaskService(); + var task = new TaskItem { Title = "Test Task" }; + + service.CreateTask(task); + + Assert.NotEqual(0, task.Id); + var all = service.GetAllTasks().ToList(); + Assert.Contains(all, t => t.Id == task.Id && t.Title == "Test Task"); + } + + [Fact] + public void GetTaskById_ReturnsCorrectTaskOrNull() + { + var service = new InMemoryTaskService(); + var task = new TaskItem { Title = "GetById" }; + service.CreateTask(task); + var id = task.Id; + + var found = service.GetTaskById(id); + Assert.NotNull(found); + Assert.Equal("GetById", found.Title); + + var missing = service.GetTaskById(id + 999); + Assert.Null(missing); + } + + [Fact] + public void UpdateTask_NonExisting_ReturnsFalse() + { + var service = new InMemoryTaskService(); + var updated = new TaskItem { Title = "Nope" }; + + var result = service.UpdateTask(999, updated); + Assert.False(result); + } + + [Fact] + public void UpdateTask_Existing_ReturnsTrueAndUpdates() + { + var service = new InMemoryTaskService(); + var task = new TaskItem { Title = "Original" }; + service.CreateTask(task); + var id = task.Id; + + var updated = new TaskItem { Title = "Updated" }; + var result = service.UpdateTask(id, updated); + + Assert.True(result); + Assert.Equal(id, updated.Id); + var fetched = service.GetTaskById(id); + Assert.Equal("Updated", fetched.Title); + } + + [Fact] + public void DeleteTask_ReturnsTrueOnceAndRemoves() + { + var service = new InMemoryTaskService(); + var task = new TaskItem { Title = "ToDelete" }; + service.CreateTask(task); + var id = task.Id; + + var first = service.DeleteTask(id); + var second = service.DeleteTask(id); + + Assert.True(first); + Assert.False(second); + Assert.Null(service.GetTaskById(id)); + } + + [Fact] + public void GetAllTasks_Empty_ReturnsEmpty() + { + var service = new InMemoryTaskService(); + var all = service.GetAllTasks().ToList(); + Assert.Empty(all); + } + + [Fact] + public void CreateTask_SequentialIds() + { + var service = new InMemoryTaskService(); + var t1 = new TaskItem { Title = "First" }; + service.CreateTask(t1); + var t2 = new TaskItem { Title = "Second" }; + service.CreateTask(t2); + + Assert.Equal(t1.Id + 1, t2.Id); + } + } +} diff --git a/DotnetApp/DotnetApp.csproj b/DotnetApp/DotnetApp.csproj new file mode 100644 index 0000000..00ccec3 --- /dev/null +++ b/DotnetApp/DotnetApp.csproj @@ -0,0 +1,14 @@ +ο»Ώ + + + Exe + net8.0 + DotnetApp + enable + enable + + + + + + diff --git a/DotnetApp/Models/TaskItem.cs b/DotnetApp/Models/TaskItem.cs new file mode 100644 index 0000000..ea15aaf --- /dev/null +++ b/DotnetApp/Models/TaskItem.cs @@ -0,0 +1,128 @@ +using System.Text.Json.Serialization; + +namespace DotnetApp.Models +{ + public class TaskItem + { + public int Id { get; set; } + public string Title { get; set; } = default!; + public string? Description { get; set; } + public bool IsCompleted { get; set; } + + [JsonPropertyName("priority")] + public int Priority { get; set; } = 3; + + [JsonPropertyName("status")] + public string Status { get; set; } = "pending"; + + [JsonPropertyName("created_at")] + public DateTime CreatedAt { get; set; } = DateTime.UtcNow; + + public int CalculateTaskScore() + { + int score = 0; + + score += CalculatePriorityScore(); + score += CalculateStatusScore(score); + + return Math.Max(0, score); + } + + private int CalculatePriorityScore() + { + int score = 0; + + if (Priority <= 0) + { + score += 1; + } + else if (Priority == 1) + { + score += 10; + if (Status == "pending") + { + score += 3; + } + } + else if (Priority == 2) + { + score += 5; + if (Status == "in-progress" && !IsCompleted) + { + score += 2; + if ((DateTime.UtcNow - CreatedAt).TotalDays > 7) + { + score += 3; + } + } + } + else + { + score += 1; + } + + return score; + } + + private int CalculateStatusScore(int currentScore) + { + int score = 0; + + switch (Status.ToLower()) + { + case "pending": + score += CalculatePendingScore(currentScore); + break; + case "in-progress": + score += CalculateInProgressScore(); + break; + default: + if (!IsCompleted && Priority < 3) + { + score += 3; + } + break; + } + + return score; + } + + private int CalculatePendingScore(int currentScore) + { + int score = 0; + + if ((DateTime.UtcNow - CreatedAt).TotalDays > 14) + { + score += currentScore * 2; + if (Priority < 3) + { + score += 5; + } + } + + return score; + } + + private int CalculateInProgressScore() + { + int score = 0; + + if (IsCompleted) + { + score -= 5; + } + else + { + foreach (var word in Title.Split(' ')) + { + if (word.Length > 10) + { + score += 1; + } + } + } + + return score; + } + } +} diff --git a/DotnetApp/Program.cs b/DotnetApp/Program.cs new file mode 100644 index 0000000..586449a --- /dev/null +++ b/DotnetApp/Program.cs @@ -0,0 +1,44 @@ +ο»Ώusing System.IO; +using System.Linq; +using Microsoft.Extensions.FileProviders; +using DotnetApp.Services; +using DotnetApp.Models; + +var builder = WebApplication.CreateBuilder(args); +builder.Services.AddEndpointsApiExplorer(); +builder.Services.AddSwaggerGen(); +builder.Services.AddSingleton(); + +var app = builder.Build(); + +// Serve UI from wwwroot instead of external templates folder +app.UseDefaultFiles(); +app.UseStaticFiles(); + +// Replace simple GET /tasks with optional status query +app.MapGet("/tasks", (string? status, ITaskService service) => +{ + var tasks = service.GetAllTasks(); + if (!string.IsNullOrEmpty(status)) + tasks = tasks.Where(t => t.Status == status); + return Results.Ok(tasks); +}); +app.MapGet("/tasks/{id}", (int id, ITaskService service) => + service.GetTaskById(id) is TaskItem task ? Results.Ok(task) : Results.NotFound()); +app.MapPost("/tasks", (TaskItem task, ITaskService service) => +{ + service.CreateTask(task); + return Results.Created($"/tasks/{task.Id}", task); +}); +// Update returns the modified task JSON instead of NoContent +app.MapPut("/tasks/{id}", (int id, TaskItem updatedTask, ITaskService service) => +{ + updatedTask.Id = id; + return service.UpdateTask(id, updatedTask) + ? Results.Ok(updatedTask) + : Results.NotFound(); +}); +app.MapDelete("/tasks/{id}", (int id, ITaskService service) => + service.DeleteTask(id) ? Results.NoContent() : Results.NotFound()); + +await app.RunAsync(); diff --git a/DotnetApp/Services/CsvTaskService.cs b/DotnetApp/Services/CsvTaskService.cs new file mode 100644 index 0000000..8f9e5f2 --- /dev/null +++ b/DotnetApp/Services/CsvTaskService.cs @@ -0,0 +1,154 @@ +using System; +using System.Collections.Generic; +using System.Globalization; +using System.IO; +using System.Linq; +using DotnetApp.Models; + +namespace DotnetApp.Services +{ + /// + /// Provides a CSV-based implementation of the interface. + /// + public class CsvTaskService : ITaskService + { + private readonly string _filePath; + private readonly object _lock = new object(); + private int _nextId; + + /// + /// Initializes a new instance of the class. + /// + public CsvTaskService() + { + _filePath = Path.Combine(AppContext.BaseDirectory, "tasks.csv"); + if (!File.Exists(_filePath)) + { + File.WriteAllText(_filePath, "Id,Title,Description,IsCompleted,Status,Priority,CreatedAt\n"); + } + var tasks = ReadAll(); + _nextId = tasks.Any() ? tasks.Max(t => t.Id) : 0; + } + + /// + /// Reads all tasks from the CSV file. + /// + /// A list of all task items. + private List ReadAll() + { + var lines = File.ReadAllLines(_filePath); + return lines + .Skip(1) + .Where(line => !string.IsNullOrWhiteSpace(line)) + .Select(line => + { + var parts = line.Split(','); + return new TaskItem + { + Id = int.Parse(parts[0]), + Title = parts[1], + Description = string.IsNullOrEmpty(parts[2]) ? null : parts[2], + IsCompleted = bool.Parse(parts[3]), + Status = parts[4], + Priority = int.Parse(parts[5]), + CreatedAt = DateTime.Parse(parts[6], null, DateTimeStyles.RoundtripKind) + }; + }) + .ToList(); + } + + /// + /// Writes all tasks to the CSV file. + /// + /// The tasks to write. + private void WriteAll(IEnumerable tasks) + { + var lines = new List { "Id,Title,Description,IsCompleted,Status,Priority,CreatedAt" }; + lines.AddRange(tasks.Select(t => + string.Join(",", + t.Id, + Escape(t.Title), + Escape(t.Description), + t.IsCompleted, + t.Status, + t.Priority, + t.CreatedAt.ToString("O") + ) + )); + File.WriteAllLines(_filePath, lines); + } + + /// + /// Escapes a string value for CSV compatibility. + /// + /// The string value to escape. + /// The escaped string. + private string Escape(string? value) => value?.Replace("\"", "\"\"") ?? string.Empty; + + /// + /// Retrieves all tasks from the CSV file. + /// + /// A collection of all task items. + public IEnumerable GetAllTasks() => ReadAll(); + + /// + /// Retrieves a task by its unique identifier from the CSV file. + /// + /// The unique identifier of the task. + /// The task item if found; otherwise, null. + public TaskItem? GetTaskById(int id) => ReadAll().FirstOrDefault(t => t.Id == id); + + /// + /// Creates a new task and appends it to the CSV file. + /// + /// The task item to create. + public void CreateTask(TaskItem task) + { + lock (_lock) + { + task.Id = ++_nextId; + var tasks = ReadAll(); + tasks.Add(task); + WriteAll(tasks); + } + } + + /// + /// Updates an existing task in the CSV file. + /// + /// The unique identifier of the task to update. + /// The updated task item. + /// True if the update was successful; otherwise, false. + public bool UpdateTask(int id, TaskItem updatedTask) + { + lock (_lock) + { + var tasks = ReadAll(); + var existing = tasks.FirstOrDefault(t => t.Id == id); + if (existing == null) return false; + updatedTask.Id = id; + tasks.Remove(existing); + tasks.Add(updatedTask); + WriteAll(tasks); + return true; + } + } + + /// + /// Deletes a task from the CSV file by its unique identifier. + /// + /// The unique identifier of the task to delete. + /// True if the deletion was successful; otherwise, false. + public bool DeleteTask(int id) + { + lock (_lock) + { + var tasks = ReadAll(); + var removed = tasks.RemoveAll(t => t.Id == id) > 0; + if (!removed) return false; + WriteAll(tasks); + return true; + } + } + } +} diff --git a/DotnetApp/Services/ITaskService.cs b/DotnetApp/Services/ITaskService.cs new file mode 100644 index 0000000..6df4d7c --- /dev/null +++ b/DotnetApp/Services/ITaskService.cs @@ -0,0 +1,45 @@ +namespace DotnetApp.Services +{ + using DotnetApp.Models; + using System.Collections.Generic; + + /// + /// Defines the contract for task management services. + /// + public interface ITaskService + { + /// + /// Retrieves all tasks. + /// + /// A collection of all task items. + IEnumerable GetAllTasks(); + + /// + /// Retrieves a task by its unique identifier. + /// + /// The unique identifier of the task. + /// The task item if found; otherwise, null. + TaskItem? GetTaskById(int id); + + /// + /// Creates a new task. + /// + /// The task item to create. + void CreateTask(TaskItem task); + + /// + /// Updates an existing task. + /// + /// The unique identifier of the task to update. + /// The updated task item. + /// True if the update was successful; otherwise, false. + bool UpdateTask(int id, TaskItem updatedTask); + + /// + /// Deletes a task by its unique identifier. + /// + /// The unique identifier of the task to delete. + /// True if the deletion was successful; otherwise, false. + bool DeleteTask(int id); + } +} diff --git a/DotnetApp/Services/InMemoryTaskService.cs b/DotnetApp/Services/InMemoryTaskService.cs new file mode 100644 index 0000000..ee448bf --- /dev/null +++ b/DotnetApp/Services/InMemoryTaskService.cs @@ -0,0 +1,59 @@ +namespace DotnetApp.Services +{ + using System.Collections.Concurrent; + using DotnetApp.Models; + + /// + /// Provides an in-memory implementation of the interface. + /// + public class InMemoryTaskService : ITaskService + { + private readonly ConcurrentDictionary _tasks = new(); + private int _nextId = 1; + + /// + /// Retrieves all tasks stored in memory. + /// + /// A collection of all task items. + public IEnumerable GetAllTasks() => _tasks.Values; + + /// + /// Retrieves a task by its unique identifier. + /// + /// The unique identifier of the task. + /// The task item if found; otherwise, null. + public TaskItem? GetTaskById(int id) => _tasks.TryGetValue(id, out var task) ? task : null; + + /// + /// Creates a new task and stores it in memory. + /// + /// The task item to create. + public void CreateTask(TaskItem task) + { + var id = System.Threading.Interlocked.Increment(ref _nextId); + task.Id = id; + _tasks[id] = task; + } + + /// + /// Updates an existing task in memory. + /// + /// The unique identifier of the task to update. + /// The updated task item. + /// True if the update was successful; otherwise, false. + public bool UpdateTask(int id, TaskItem updatedTask) + { + if (!_tasks.ContainsKey(id)) return false; + updatedTask.Id = id; + _tasks[id] = updatedTask; + return true; + } + + /// + /// Deletes a task from memory by its unique identifier. + /// + /// The unique identifier of the task to delete. + /// True if the deletion was successful; otherwise, false. + public bool DeleteTask(int id) => _tasks.TryRemove(id, out _); + } +} diff --git a/DotnetApp/wwwroot/index.html b/DotnetApp/wwwroot/index.html new file mode 100644 index 0000000..b60a42a --- /dev/null +++ b/DotnetApp/wwwroot/index.html @@ -0,0 +1,272 @@ + + + + + + Task Manager + + + +

Task Manager

+ + +
+

Add New Task

+ + + + +
+ + +
+ + +
+ + +

Tasks

+
+ +
Loading tasks...
+
+ + + + \ No newline at end of file From 86068185981f95af6013482cc7e504bd95a31b1a Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 20 May 2025 14:50:14 -0500 Subject: [PATCH 02/48] added cobol --- OLD_README.md | 129 --------------------------------------------- README.md | 4 +- cobol/CUSTPROC.cbl | 112 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 114 insertions(+), 131 deletions(-) delete mode 100644 OLD_README.md create mode 100644 cobol/CUSTPROC.cbl diff --git a/OLD_README.md b/OLD_README.md deleted file mode 100644 index 5dfdff5..0000000 --- a/OLD_README.md +++ /dev/null @@ -1,129 +0,0 @@ -# copilot - -> [!NOTE] -> As with any GenAI, Copilot is non-deterministic. As such, results you get from Copilot may differ from what I demonstrate. - -## Install (for VS Code) -1. Go to Extensions (on Activity Bar) -1. Search for `Copilot` -1. Install - > You will get both the `Copilot` and `Copilot Chat` extensions installed -1. Using either the pop-up after install or the "Accounts" icon on the Activity Bar, sign into GitHub - -Easy as that! - -## Familiarize (for VS Code) -After install, Copilot is 100% ready to go. Start coding to use Code completions or click the "Chat" icon on the Activity Bar to use Copilot Chat. - -That's all! - -## Use -### Code completion - - -> [!NOTE] -> Although I don't always explicitly list it, there is an implied acceptance of Copilot's suggestions at the end of each step below. - - -#### point.py -1. Navigate to point.py - > file name is part of the context Copilot uses! - -##### class point -1. Start a new comment "# create a class..." - > If the suggestions are wrong or I don't like them, just keep typing! -1. Add "# should include getters, setters and a toString method" to your comment - > The clearer and more descriptive I am, the more helpful Copilot can be! -1. Type "class Point:" and hit enter - > Copilot draws on all information in our file to build its context, so it can infer what we want based on what we have already commented and coded. Remember, file name is part of context! -1. Accept all getters, setters and toString - > Copilot expedites "boring" coding (repetitive, boilerplate tasks). This gives us more time for the tasks and coding we enjoy. -1. Start a new comment "# calculate the..." (we're going to create a distance function) - > Copilot is, once again, inferring what we might want here based on the context it has. - -##### class line -1. Start a new comment "# create a class..." -1. Type "class..." - > Copilot will use the current context (in this case, the file name, and all comments and code in our current file), to determine how to structure and stylize suggested code. notice how Copilot automatically added getters, setters and a toString method (following the pattern it recognized from above) and it even automatically utilizes the distance method we defined previously. - - - -### Copilot Chat - -#### Generate -> Copilot works on more than just traditional code. Even with operational tasks and files, Copilot can help. - -##### Infra as Code -1. Navigate to iac.tf -1. Ask Copilot chat to "write a terraform file that creates a webapp and sql DB in Azure for me" - > In Copilot Chat, we have various options for how to accepts suggested code. - - - -#### Explain -1. Open server.rs -1. Ask Copilot Chat what this file is doing -#### Improve -1. Ask Copilot Chat it if there are any ways we can improve the code -1. Ask chat how to implement thread pools and accept changes - -#### Translate -1. Ask Copilot Chat to turn our rust code into python - -#### Brainstorm -1. Ask Copilot Chat: if I'm looking to create a webserver in python, how should I go about it? should I be creating it from scratch like I'm doing here? -1. Ask it about the differences between the different frameworks it suggests. -1. Ask it which to use if I'm looking to run a simple blog server and I don't have much coding experience. - -#### Secure -> Copilot can help identify and mitigate security vulnerabilities -1. Navigate to sql.py -1. Ask Copilot Chat to identify any security vulnerabilities it sees - - -#### @, # and / -##### \# -We can use `#` to reference files or selections. Essentially, determine what context to use to answer the question we are asking. Note: #web for web search. - -1. Try this in chat: - - what is the latest version of Node.js? -1. then try this - - #web what is the latest version of Node.js? - -##### @ -Called "participants". Use if you're looking to ask about a specific topic or domain. Example @docker. Copilot extensions can also provide more chat participants. Personally I don't use it much but it's there! - -##### / -Short hand for common tasks in Copilot. So that I don't have to type out a full paragraph. -- `/tests` - writes tests -- `/explain` - explain code -- `/fix` - fix errors - -## FAQ -1. How does GitHub Copilot Chat differ from ChatGPT? - - GitHub Copilot Chat takes into consideration the context of your codebase and workspace, giving you more tailored solutions grounded in the code that you've already written. ChatGPT does not do this. - -## Best Practices -- https://docs.github.com/en/copilot/using-github-copilot/best-practices-for-using-github-copilot \ No newline at end of file diff --git a/README.md b/README.md index 8ce16da..1c1ec19 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ Chat commands are a great and easy place to start with Copilot Chat. When in dou - `dotnet test DotnetApp.Tests/DotnetApp.Tests.csproj` 1. Ask `@vscode Where can I find the setting to render whitespace?` -### Context (MOVE THIS ABOVE THE MODES BELOW THE CHAT SECTION?) +### Context Context in Copilot Chat works differently than it did for code completions. Other than what is currently visible in your editor, Copilot Chat requires that we explicitly add all relevant files as context before submitting our prompt. The easiest ways of including files as context are to with drag and drop them into the chat window, or using the `#file:` tag. 1. Show typing a `#` into chat and reading what each tag specifies @@ -56,7 +56,7 @@ Context in Copilot Chat works differently than it did for code completions. Othe #### Translate 1. Can you translate this Java file (`point.java`) into Python? #### Optimize -1. What can I do to improve my .NET app (`DotnetApp`)? I'm preparing it for a production release and need to make sure it's polished. +1. What can I do to improve my .NET app (`DotnetApp`)? I'm preparing it for a production release and need to make sure it's ready. #### Review 1. Do you see any security vulnerabilities in this code (`sql.py`)? 1. I'm looking to reduce tech debt across my codebase. Is there anything in my .NET app (`DotnetApp`) that I should consider improving or fixing? diff --git a/cobol/CUSTPROC.cbl b/cobol/CUSTPROC.cbl new file mode 100644 index 0000000..9bc3c34 --- /dev/null +++ b/cobol/CUSTPROC.cbl @@ -0,0 +1,112 @@ + IDENTIFICATION DIVISION. + PROGRAM-ID. CUSTPROC. + AUTHOR. GITHUB-COPILOT. + DATE-WRITTEN. 2025-03-28. + + ENVIRONMENT DIVISION. + INPUT-OUTPUT SECTION. + FILE-CONTROL. + SELECT CUSTOMER-FILE + ASSIGN TO 'CUSTFILE' + ORGANIZATION IS SEQUENTIAL + ACCESS MODE IS SEQUENTIAL + FILE STATUS IS WS-FILE-STATUS. + SELECT REPORT-FILE + ASSIGN TO 'CUSTRPT' + ORGANIZATION IS SEQUENTIAL + ACCESS MODE IS SEQUENTIAL. + + DATA DIVISION. + FILE SECTION. + FD CUSTOMER-FILE + LABEL RECORDS ARE STANDARD. + 01 CUSTOMER-RECORD. + 05 CUST-ID PIC X(6). + 05 CUST-NAME PIC X(30). + 05 CUST-ADDRESS PIC X(50). + 05 CUST-PHONE PIC X(12). + 05 CUST-BALANCE PIC 9(7)V99. + + FD REPORT-FILE + LABEL RECORDS ARE STANDARD. + 01 REPORT-LINE PIC X(132). + + WORKING-STORAGE SECTION. + 01 WS-FILE-STATUS PIC X(2). + 01 WS-EOF-FLAG PIC X VALUE 'N'. + 88 END-OF-FILE VALUE 'Y'. + + 01 WS-COUNTERS. + 05 WS-READ-CTR PIC 9(6) VALUE ZERO. + 05 WS-VALID-CTR PIC 9(6) VALUE ZERO. + 05 WS-ERROR-CTR PIC 9(6) VALUE ZERO. + + 01 WS-HEADING-1. + 05 FILLER PIC X(20) VALUE 'Customer Report '. + 05 FILLER PIC X(20) VALUE 'Date: '. + 05 WS-CURR-DATE PIC X(10). + + 01 WS-DETAIL-LINE. + 05 WS-DL-CUSTID PIC X(6). + 05 FILLER PIC X(2) VALUE SPACES. + 05 WS-DL-NAME PIC X(30). + 05 FILLER PIC X(2) VALUE SPACES. + 05 WS-DL-BALANCE PIC $ZZZ,ZZ9.99. + + PROCEDURE DIVISION. + 0100-MAIN-PROCESS. + PERFORM 0200-INIT-ROUTINE + PERFORM 0300-PROCESS-RECORDS UNTIL END-OF-FILE + PERFORM 0900-CLOSE-ROUTINE + STOP RUN. + + 0200-INIT-ROUTINE. + OPEN INPUT CUSTOMER-FILE + OUTPUT REPORT-FILE + IF WS-FILE-STATUS NOT = '00' + DISPLAY 'Error opening files. Status: ' WS-FILE-STATUS + MOVE 'Y' TO WS-EOF-FLAG + END-IF + PERFORM 0250-WRITE-HEADERS. + + 0250-WRITE-HEADERS. + MOVE FUNCTION CURRENT-DATE(1:10) TO WS-CURR-DATE + WRITE REPORT-LINE FROM WS-HEADING-1 + WRITE REPORT-LINE FROM SPACES. + + 0300-PROCESS-RECORDS. + READ CUSTOMER-FILE + AT END + MOVE 'Y' TO WS-EOF-FLAG + NOT AT END + ADD 1 TO WS-READ-CTR + PERFORM 0400-VALIDATE-RECORD + END-READ. + + 0400-VALIDATE-RECORD. + IF CUST-BALANCE > 0 + PERFORM 0500-FORMAT-DETAIL + ADD 1 TO WS-VALID-CTR + ELSE + ADD 1 TO WS-ERROR-CTR + END-IF. + + 0500-FORMAT-DETAIL. + MOVE CUST-ID TO WS-DL-CUSTID + MOVE CUST-NAME TO WS-DL-NAME + MOVE CUST-BALANCE TO WS-DL-BALANCE + WRITE REPORT-LINE FROM WS-DETAIL-LINE. + + 0900-CLOSE-ROUTINE. + WRITE REPORT-LINE FROM SPACES + MOVE 'Total Records Read: ' TO REPORT-LINE + MOVE WS-READ-CTR TO REPORT-LINE(25:6) + WRITE REPORT-LINE + MOVE 'Valid Records: ' TO REPORT-LINE + MOVE WS-VALID-CTR TO REPORT-LINE(25:6) + WRITE REPORT-LINE + MOVE 'Error Records: ' TO REPORT-LINE + MOVE WS-ERROR-CTR TO REPORT-LINE(25:6) + WRITE REPORT-LINE + CLOSE CUSTOMER-FILE + REPORT-FILE. \ No newline at end of file From fbd135ef57f0dc8ec88d0f4a31f57ba8d793a4de Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Mon, 26 May 2025 14:40:16 -0500 Subject: [PATCH 03/48] added idea to readme and changed custom instructions --- .github/copilot-instructions.md | 5 ++++- README.md | 10 ++++++++++ 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index a04f2f8..2a3c9c7 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,5 +1,8 @@ # General -When refactoring for a decrease in Cognitive Complexity, remove unnecessary logic. +Whenever possible, use recursion. + +# Rust +Do not suggest using any external packages (i.e., dependencies). All rust code should only use the `std` library. # Python Always write my Python unit tests using `pytest`, not `unittest`. diff --git a/README.md b/README.md index 1c1ec19..146c474 100644 --- a/README.md +++ b/README.md @@ -155,3 +155,13 @@ If not yet installed, be sure you have the SonarScanner .NET Core GLobal Tool ### Misc. - In the future, Agent mode will be able to iterate on the issues in the dashboard (using the URL) for you! --> + + +## Future +In the future, a decent demo might be to use this commit https://github.com/mpchenette/pong/tree/80dcd03e2cd1e7fe39a044c1fc51cb39ea2b5c2f (FFR: this is the duopong right before I add server side color chainging, right after I changed 127.0.0.1 to 0.0.0.0)to demo agent mode and also repo indexing. + +If you have the repo indexed remotely, ask the "ask" mode the following: "it would seem that at the moment the background color changing is a client side change only. is that accurate? how would I make this a change that affects everyone/that everyone can see? that is my goal", and look how fast the response is. This is because of indexing! Even without the file open! No context needed because we have the index. + +Now jump to agent mode and ask the same thing. see how much longer it takes. but also see that agent mode makes the change for you. And if agent mode fails like it did for me the first time, you can ask it to iterate! + +A good example of when to use each mode and pros/cons and also how knowing the different aspects of Copilot leads to a better experience. \ No newline at end of file From 1cc073a8a5c0ec8a7e9cac0211be1ab51d537639 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Mon, 26 May 2025 14:45:03 -0500 Subject: [PATCH 04/48] added more direction to readme --- README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 146c474..71047d8 100644 --- a/README.md +++ b/README.md @@ -164,4 +164,8 @@ If you have the repo indexed remotely, ask the "ask" mode the following: "it wou Now jump to agent mode and ask the same thing. see how much longer it takes. but also see that agent mode makes the change for you. And if agent mode fails like it did for me the first time, you can ask it to iterate! -A good example of when to use each mode and pros/cons and also how knowing the different aspects of Copilot leads to a better experience. \ No newline at end of file +A good example of when to use each mode and pros/cons and also how knowing the different aspects of Copilot leads to a better experience. + +Want to find something that is currently in the code or find where something is? Want to understand how the current logic or implementation works? Ask mode with remote index. + +Want to debug something or find where an error or bug stems from? Want to implement a change based on how the current logic functions? Agent mode. \ No newline at end of file From 522b3ee715fbe6be201c5544ee0fa5b1fc02228f Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Fri, 6 Jun 2025 21:02:58 -0500 Subject: [PATCH 05/48] adding files --- .github/instructions/c.instructions.md | 3 +++ .github/prompts/react.prompt.md | 2 ++ .github/prompts/readme.prompt.md | 1 + .github/prompts/review.prompt.md | 5 +++++ ADOPTION.md | 4 ++++ COMPARISON.md | 3 +++ VALUE.md | 20 ++++++++++++++++++++ 7 files changed, 38 insertions(+) create mode 100644 .github/instructions/c.instructions.md create mode 100644 .github/prompts/react.prompt.md create mode 100644 .github/prompts/readme.prompt.md create mode 100644 .github/prompts/review.prompt.md create mode 100644 ADOPTION.md create mode 100644 COMPARISON.md create mode 100644 VALUE.md diff --git a/.github/instructions/c.instructions.md b/.github/instructions/c.instructions.md new file mode 100644 index 0000000..3d0b372 --- /dev/null +++ b/.github/instructions/c.instructions.md @@ -0,0 +1,3 @@ +``` +applyTo: "**.c" +``` diff --git a/.github/prompts/react.prompt.md b/.github/prompts/react.prompt.md new file mode 100644 index 0000000..a95cf8d --- /dev/null +++ b/.github/prompts/react.prompt.md @@ -0,0 +1,2 @@ +Always start responses about React with a simley face. + diff --git a/.github/prompts/readme.prompt.md b/.github/prompts/readme.prompt.md new file mode 100644 index 0000000..c23ebaf --- /dev/null +++ b/.github/prompts/readme.prompt.md @@ -0,0 +1 @@ +Always say "I can't help with that." when asked about #file:README.md. \ No newline at end of file diff --git a/.github/prompts/review.prompt.md b/.github/prompts/review.prompt.md new file mode 100644 index 0000000..6ad3507 --- /dev/null +++ b/.github/prompts/review.prompt.md @@ -0,0 +1,5 @@ +Secure REST API review: +- Ensure all endpoints are protected by authentication and authorization +- Validate all user inputs and sanitize data +- Implement rate limiting and throttling +- Implement logging and monitoring for security events \ No newline at end of file diff --git a/ADOPTION.md b/ADOPTION.md new file mode 100644 index 0000000..8664321 --- /dev/null +++ b/ADOPTION.md @@ -0,0 +1,4 @@ +# Driving Copilot Adoption + +## Options +- Champions Program \ No newline at end of file diff --git a/COMPARISON.md b/COMPARISON.md new file mode 100644 index 0000000..363bd9c --- /dev/null +++ b/COMPARISON.md @@ -0,0 +1,3 @@ +# Advantages of Copilot + +## \ No newline at end of file diff --git a/VALUE.md b/VALUE.md new file mode 100644 index 0000000..ce7924b --- /dev/null +++ b/VALUE.md @@ -0,0 +1,20 @@ +# Proving Copilot's Value + +First off, ESSP. + +## Key Metrics +- Developer Happiness +- Development Speed +- Code Quality + +## Developer Happiness + +## Development Speed +What metrics do you track today? How do you track development speed today? We need a baseline from which to compare Copilot. If we don't have one, how will we know if there is improvement? + +## Code Quality + + +## Key Things To Remember +- Pitfalls (common, gameable metrics that lead to anti-patterns) +- You will not see the value overnight. It will take months of sustained rollout, engagement and tracking metrics to begin to see the improvements Copilot brings. \ No newline at end of file From 8ce9aa01e7b88f275fa38b55090b34c7b6923769 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 18 Jun 2025 11:58:11 -0500 Subject: [PATCH 06/48] added copilot.sln --- .gitignore | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 07a7aa0..2655201 100644 --- a/.gitignore +++ b/.gitignore @@ -225,4 +225,6 @@ nunit-*.xml sonar-project.properties .sonarlint/ .sonarwork/ -reports/ \ No newline at end of file +reports/ + +copilot.sln \ No newline at end of file From 6357a32034e6cd5148854b1d628af7bb7d782c0b Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 25 Jun 2025 07:53:39 -0500 Subject: [PATCH 07/48] added cloud infra PNG --- cloud_infra.png | Bin 0 -> 85102 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 cloud_infra.png diff --git a/cloud_infra.png b/cloud_infra.png new file mode 100644 index 0000000000000000000000000000000000000000..ab52c6e2e9e8b2d8a296c0e1cd3f182fc269c2fe GIT binary patch literal 85102 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 z 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 literal 0 HcmV?d00001 From 56278f8e1f9396ef314f5afba086a710844e6f24 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Thu, 26 Jun 2025 11:50:51 -0500 Subject: [PATCH 08/48] changes --- .github/instructions/c.instructions.md | 1 + python/calculator.py | 20 ++++++++++++++++++++ 2 files changed, 21 insertions(+) create mode 100644 python/calculator.py diff --git a/.github/instructions/c.instructions.md b/.github/instructions/c.instructions.md index 3d0b372..791dae8 100644 --- a/.github/instructions/c.instructions.md +++ b/.github/instructions/c.instructions.md @@ -1,3 +1,4 @@ ``` applyTo: "**.c" ``` +Always be sure to free up unused memory \ No newline at end of file diff --git a/python/calculator.py b/python/calculator.py new file mode 100644 index 0000000..a1402be --- /dev/null +++ b/python/calculator.py @@ -0,0 +1,20 @@ +# calculator app +# This app performs basic arithmetic operations + +def add(x, y): + """Add two numbers.""" + return x + y + +def subtract(x, y): + """Subtract two numbers.""" + return x - y + +def multiply(x, y): + """Multiply two numbers.""" + return x * y + +def divide(x, y): + """Divide two numbers.""" + if y == 0: + raise ValueError("Cannot divide by zero.") + return x / y \ No newline at end of file From 3f64ac06637d73bcd6709477928462c5c2dc027a Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Fri, 27 Jun 2025 10:46:36 -0500 Subject: [PATCH 09/48] added calculator --- .github/instructions/c.instructions.md | 4 +-- python/calculator.py | 50 +++++++++++++++----------- 2 files changed, 32 insertions(+), 22 deletions(-) diff --git a/.github/instructions/c.instructions.md b/.github/instructions/c.instructions.md index 791dae8..9dd1b25 100644 --- a/.github/instructions/c.instructions.md +++ b/.github/instructions/c.instructions.md @@ -1,4 +1,4 @@ -``` +--- applyTo: "**.c" -``` +--- Always be sure to free up unused memory \ No newline at end of file diff --git a/python/calculator.py b/python/calculator.py index a1402be..1560607 100644 --- a/python/calculator.py +++ b/python/calculator.py @@ -1,20 +1,30 @@ -# calculator app -# This app performs basic arithmetic operations - -def add(x, y): - """Add two numbers.""" - return x + y - -def subtract(x, y): - """Subtract two numbers.""" - return x - y - -def multiply(x, y): - """Multiply two numbers.""" - return x * y - -def divide(x, y): - """Divide two numbers.""" - if y == 0: - raise ValueError("Cannot divide by zero.") - return x / y \ No newline at end of file +class Calculator: + """A simple calculator class with basic arithmetic operations.""" + + def add(self, a, b): + """Add two numbers.""" + return a + b + + def subtract(self, a, b): + """Subtract b from a.""" + return a - b + + def multiply(self, a, b): + """Multiply two numbers.""" + return a * b + + def divide(self, a, b): + """Divide a by b.""" + if b == 0: + raise ValueError("Cannot divide by zero") + return a / b + + def power(self, a, b): + """Raise a to the power of b.""" + return a ** b + + def square_root(self, a): + """Calculate the square root of a number.""" + if a < 0: + raise ValueError("Cannot calculate square root of negative number") + return a ** 0.5 \ No newline at end of file From 6fd2ce662b295f091941a5da06a3b08dcc4d487c Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Fri, 27 Jun 2025 10:55:27 -0500 Subject: [PATCH 10/48] added test_calc file --- python/tests/test_calculator.py | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 python/tests/test_calculator.py diff --git a/python/tests/test_calculator.py b/python/tests/test_calculator.py new file mode 100644 index 0000000..e69de29 From d6abe3511c624c7e22ed382020366cc2ac93f87e Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 2 Jul 2025 08:50:49 -0500 Subject: [PATCH 11/48] moved docs --- ADOPTION.md => docs/ADOPTION.md | 0 COMPARISON.md => docs/COMPARISON.md | 0 VALUE.md => docs/VALUE.md | 0 3 files changed, 0 insertions(+), 0 deletions(-) rename ADOPTION.md => docs/ADOPTION.md (100%) rename COMPARISON.md => docs/COMPARISON.md (100%) rename VALUE.md => docs/VALUE.md (100%) diff --git a/ADOPTION.md b/docs/ADOPTION.md similarity index 100% rename from ADOPTION.md rename to docs/ADOPTION.md diff --git a/COMPARISON.md b/docs/COMPARISON.md similarity index 100% rename from COMPARISON.md rename to docs/COMPARISON.md diff --git a/VALUE.md b/docs/VALUE.md similarity index 100% rename from VALUE.md rename to docs/VALUE.md From b9ffb70c958cf76f84f294c92cedfc3f32f7e0ff Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 2 Jul 2025 10:59:32 -0500 Subject: [PATCH 12/48] additions / subtractions --- README.md | 4 +++- python/sql.py | 4 ---- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 71047d8..9cefc4b 100644 --- a/README.md +++ b/README.md @@ -101,7 +101,9 @@ If Public Code Block is enabled, if Copilot generates code that closely matches - Ask Copilot to break suggested code into different blocks in its response - Ask Copilot to only show changed lines of code - Ask Copilot to just show pseudocode -- Ask Copilot to comment out the code it suggests +- Ask Copilot to show the code it suggests in another language +- Ask Copilot to comment out the code it suggests +- Ask Copilot to prepend the code it suggests with something like `##` - Break your problem into smaller problems Generally speaking, when we work with our own large, complex, unique codebases, we won't run into this much. This will mostly come into play when we are starting from scratch or asking Copilot for generic examples. The alternative to the Public Code Block is Code Referencing, where Copilot will show the public code anyway and let you know what type of license applies to the repo it is sourced from. diff --git a/python/sql.py b/python/sql.py index 2e5f46c..bc2121e 100644 --- a/python/sql.py +++ b/python/sql.py @@ -23,7 +23,3 @@ def add_user(username, password): cursor.close() conn.close() return True - - - - From b9782fbf7f06d416fb8a9adeeb80198ded89824a Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 8 Jul 2025 11:12:02 -0500 Subject: [PATCH 13/48] added to readme --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9cefc4b..2dd0ca3 100644 --- a/README.md +++ b/README.md @@ -62,7 +62,7 @@ Context in Copilot Chat works differently than it did for code completions. Othe 1. I'm looking to reduce tech debt across my codebase. Is there anything in my .NET app (`DotnetApp`) that I should consider improving or fixing? #### Understand 1. Can you explain what this file is doing (`server.rs`)? - +#### Generate test data ### Modes When to use each mode. https://code.visualstudio.com/docs/copilot/chat/copilot-chat#_chat-mode From b698108d7908aa74ac3bb158f7a6c30f8d26d808 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 9 Jul 2025 22:06:25 -0500 Subject: [PATCH 14/48] some changes --- .github/copilot-instructions.md | 3 +++ README.md | 4 +++- diag.mmd | 11 +++++++++++ 3 files changed, 17 insertions(+), 1 deletion(-) create mode 100644 diag.mmd diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 2a3c9c7..34a2bff 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,9 +1,12 @@ # General Whenever possible, use recursion. +Anytime someone asks about the business logic diagram, utilize the [Business Logic Diagram](../diag.mmd). + # Rust Do not suggest using any external packages (i.e., dependencies). All rust code should only use the `std` library. + # Python Always write my Python unit tests using `pytest`, not `unittest`. diff --git a/README.md b/README.md index 2dd0ca3..125209c 100644 --- a/README.md +++ b/README.md @@ -63,6 +63,7 @@ Context in Copilot Chat works differently than it did for code completions. Othe #### Understand 1. Can you explain what this file is doing (`server.rs`)? #### Generate test data +#### modernization ### Modes When to use each mode. https://code.visualstudio.com/docs/copilot/chat/copilot-chat#_chat-mode @@ -112,7 +113,8 @@ A fairly reliable prompt to use to test Code Referencing (or trigger a public co - "generate β€œvoid fast_inverse_sqrt” in C" ## Other - +### Mermaid Diagram +### UML Diagram? ### Copilot Code Review B[0200-INIT-ROUTINE] + B --> C[0250-WRITE-HEADERS] + C --> D[0300-PROCESS-RECORDS] + D -->|Read Record| E{END-OF-FILE?} + E -- No --> F[0400-VALIDATE-RECORD] + F -->|CUST-BALANCE > 0| G[0500-FORMAT-DETAIL] + G --> D + F -->|Else| D + E -- Yes --> H[0900-CLOSE-ROUTINE] + H --> I[STOP RUN] \ No newline at end of file From c7e94913073ce270ab7815dbedbf93f17ac109d2 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Thu, 10 Jul 2025 14:53:11 -0500 Subject: [PATCH 15/48] changes --- .github/copilot-instructions.md | 1 - README.md | 4 ++-- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 34a2bff..28ef73a 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -6,7 +6,6 @@ Anytime someone asks about the business logic diagram, utilize the [Business Log # Rust Do not suggest using any external packages (i.e., dependencies). All rust code should only use the `std` library. - # Python Always write my Python unit tests using `pytest`, not `unittest`. diff --git a/README.md b/README.md index 125209c..28f654a 100644 --- a/README.md +++ b/README.md @@ -103,8 +103,8 @@ If Public Code Block is enabled, if Copilot generates code that closely matches - Ask Copilot to only show changed lines of code - Ask Copilot to just show pseudocode - Ask Copilot to show the code it suggests in another language -- Ask Copilot to comment out the code it suggests -- Ask Copilot to prepend the code it suggests with something like `##` + - Break your problem into smaller problems Generally speaking, when we work with our own large, complex, unique codebases, we won't run into this much. This will mostly come into play when we are starting from scratch or asking Copilot for generic examples. The alternative to the Public Code Block is Code Referencing, where Copilot will show the public code anyway and let you know what type of license applies to the repo it is sourced from. From 32e231a888debaed240f420547e11d6781def896 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Mon, 14 Jul 2025 11:29:19 -0500 Subject: [PATCH 16/48] readme --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 28f654a..277b34e 100644 --- a/README.md +++ b/README.md @@ -65,7 +65,7 @@ Context in Copilot Chat works differently than it did for code completions. Othe #### Generate test data #### modernization ### Modes -When to use each mode. https://code.visualstudio.com/docs/copilot/chat/copilot-chat#_chat-mode +When to use each mode. https://code.visualstudio.com/docs/copilot/chat/chat-modes #### [Ask mode](https://code.visualstudio.com/docs/copilot/chat/chat-ask-mode) From f85f8bfdf62c719015ac3759c772b1e4773a8b19 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 15 Jul 2025 12:40:20 -0500 Subject: [PATCH 17/48] added to README --- README.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 277b34e..29d620c 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # GitHub Copilot > [!NOTE] -> Last updated 05-MAY-2025 +> Last updated 14-JUL-2025 This is a repo containing materials that can be used for future Copilot demos. @@ -19,7 +19,7 @@ Copilot code completions even promotes best practices while you code as comments You can also interact with Copilot code completions (+ more) inside a file in other ways: - Suggestion Selector -- Completions Panel (Ctrl + Enter) +- Completions Panel - Editor Inline Chat (Cmd + I) ### Next Edit Suggestions @@ -49,6 +49,8 @@ Context in Copilot Chat works differently than it did for code completions. Othe 1. Show typing a `#` into chat and reading what each tag specifies +#### Vision + ### Possibilities #### Brainstorm 1. What the best naming convention to use in my .NET project? What's idiomatic? @@ -62,8 +64,11 @@ Context in Copilot Chat works differently than it did for code completions. Othe 1. I'm looking to reduce tech debt across my codebase. Is there anything in my .NET app (`DotnetApp`) that I should consider improving or fixing? #### Understand 1. Can you explain what this file is doing (`server.rs`)? -#### Generate test data -#### modernization +#### Generate +- Test data +- Documentation +- ... +#### Modernize ### Modes When to use each mode. https://code.visualstudio.com/docs/copilot/chat/chat-modes @@ -103,9 +108,9 @@ If Public Code Block is enabled, if Copilot generates code that closely matches - Ask Copilot to only show changed lines of code - Ask Copilot to just show pseudocode - Ask Copilot to show the code it suggests in another language +- Break your problem into smaller problems -- Break your problem into smaller problems Generally speaking, when we work with our own large, complex, unique codebases, we won't run into this much. This will mostly come into play when we are starting from scratch or asking Copilot for generic examples. The alternative to the Public Code Block is Code Referencing, where Copilot will show the public code anyway and let you know what type of license applies to the repo it is sourced from. From c37ae0093ececa74832ad57c7ff9d4fff7bab0c8 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 16 Jul 2025 11:58:49 -0500 Subject: [PATCH 18/48] updated instructions files and added to README --- .github/copilot-instructions.md | 10 +++++----- .github/instructions/py.instructions.md | 2 ++ .github/instructions/rust.instructions.md | 2 ++ README.md | 9 +++++++++ 4 files changed, 18 insertions(+), 5 deletions(-) create mode 100644 .github/instructions/py.instructions.md create mode 100644 .github/instructions/rust.instructions.md diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 28ef73a..fd59e06 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,13 +1,13 @@ # General Whenever possible, use recursion. -Anytime someone asks about the business logic diagram, utilize the [Business Logic Diagram](../diag.mmd). +Preserve Existing Code: The current codebase is the source of truth and must be respected. Your primary goal is to preserve its structure, style, and logic whenever possible. + +Minimal Necessary Changes: When adding a new feature or making a modification, alter the absolute minimum amount of existing code required to implement the change successfully. -# Rust -Do not suggest using any external packages (i.e., dependencies). All rust code should only use the `std` library. +Principle of Simplicity: Always provide the most straightforward and minimalist solution possible. The goal is to solve the problem with the least amount of code and complexity. Avoid premature optimization or over-engineering. -# Python -Always write my Python unit tests using `pytest`, not `unittest`. +Anytime someone asks about the business logic diagram, utilize the [Business Logic Diagram](../diag.mmd). # .NET When suggesting .NET code, only suggest code compatible with .NET 8. diff --git a/.github/instructions/py.instructions.md b/.github/instructions/py.instructions.md new file mode 100644 index 0000000..ce7fa1c --- /dev/null +++ b/.github/instructions/py.instructions.md @@ -0,0 +1,2 @@ +# Python +Always write my Python unit tests using `pytest`, not `unittest`. \ No newline at end of file diff --git a/.github/instructions/rust.instructions.md b/.github/instructions/rust.instructions.md new file mode 100644 index 0000000..a4d2986 --- /dev/null +++ b/.github/instructions/rust.instructions.md @@ -0,0 +1,2 @@ +# Rust +Do not suggest using any external packages (i.e., dependencies). All rust code should only use the `std` library. \ No newline at end of file diff --git a/README.md b/README.md index 29d620c..e610fae 100644 --- a/README.md +++ b/README.md @@ -83,6 +83,15 @@ Copilot Edits makes sweeping changes across multiple files quick and easy. #### [Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) +##### Demo +- does my dotnetapp already have unit tests? + - auto context discovery +- can you run the existing unit tests to see if they pass? + - self-healing +- can you add additional unit tests for the placeholders you mentioned above? + +- @vscode where is the setting to change the number of "iterations" agent mode will perform before asking if I'd like to continue + ## [Configuring Copilot / Customizing Copilot](https://code.visualstudio.com/docs/copilot/copilot-customization) ### Custom instructions Used to set "rules" you want Copilot to follow for all suggestions. A system prompt of sorts. From 79b247bedbbbfb122c37f93edd3b13679efa9061 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 30 Jul 2025 08:48:34 -0500 Subject: [PATCH 19/48] added to instructions --- .github/instructions/py.instructions.md | 3 +++ .github/instructions/rust.instructions.md | 3 +++ 2 files changed, 6 insertions(+) diff --git a/.github/instructions/py.instructions.md b/.github/instructions/py.instructions.md index ce7fa1c..7568c71 100644 --- a/.github/instructions/py.instructions.md +++ b/.github/instructions/py.instructions.md @@ -1,2 +1,5 @@ +--- +applyTo: "**.py" +--- # Python Always write my Python unit tests using `pytest`, not `unittest`. \ No newline at end of file diff --git a/.github/instructions/rust.instructions.md b/.github/instructions/rust.instructions.md index a4d2986..79da6c8 100644 --- a/.github/instructions/rust.instructions.md +++ b/.github/instructions/rust.instructions.md @@ -1,2 +1,5 @@ +--- +applyTo: "**.rs" +--- # Rust Do not suggest using any external packages (i.e., dependencies). All rust code should only use the `std` library. \ No newline at end of file From edcab328ff63055d4ac2f3a387b3c006e2873aa5 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Sun, 3 Aug 2025 22:16:30 -0500 Subject: [PATCH 20/48] added to value --- docs/VALUE.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/VALUE.md b/docs/VALUE.md index ce7924b..d283262 100644 --- a/docs/VALUE.md +++ b/docs/VALUE.md @@ -13,6 +13,12 @@ First off, ESSP. What metrics do you track today? How do you track development speed today? We need a baseline from which to compare Copilot. If we don't have one, how will we know if there is improvement? ## Code Quality +bugs / capita - 8 +code quality tool score / rating - 8 +average time to merge PR - 5 +average number of comments on a PR - 7 +\# of code related outages / year (or downtime due to) - 8 +average age of a LoC? - 2 ## Key Things To Remember From 67cfed54c45a847c8e6524a672943e72983cc5c9 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Sun, 3 Aug 2025 22:58:07 -0500 Subject: [PATCH 21/48] more value --- docs/VALUE.md | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/docs/VALUE.md b/docs/VALUE.md index d283262..56cece5 100644 --- a/docs/VALUE.md +++ b/docs/VALUE.md @@ -13,12 +13,17 @@ First off, ESSP. What metrics do you track today? How do you track development speed today? We need a baseline from which to compare Copilot. If we don't have one, how will we know if there is improvement? ## Code Quality -bugs / capita - 8 -code quality tool score / rating - 8 -average time to merge PR - 5 -average number of comments on a PR - 7 -\# of code related outages / year (or downtime due to) - 8 -average age of a LoC? - 2 + + +metric | how good a representation of CQ is it? | how easy is it to grab? | how objective is it? | how hard is it to game? +--- | --- | --- | --- | --- +bugs / capita | 8 | 5 | 10 | 10 +code quality tool score / rating | 8 | 8 | 7 | 9 +average time to merge PR | 5 | 8 | 7 | 5 +average number of comments on a PR | 7 | 10 | 6 | 4 +\# of code related outages / year (or downtime due to) | 8 | 7 | 10 | 10 +average age of a LoC? - 2 (extremely easy to track accurately) - subjective / very much depends on how you interpret it +average onboard / onramp time - 2 (also hard to track accurately) - very subjective / hard to know what "good" is here. will very much depend on the codebase / language /etc. ## Key Things To Remember From 98ceec031d1b1b103b838cab0660e7cf4e8550db Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 5 Aug 2025 09:47:42 -0500 Subject: [PATCH 22/48] value again --- docs/VALUE.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/VALUE.md b/docs/VALUE.md index 56cece5..14514c9 100644 --- a/docs/VALUE.md +++ b/docs/VALUE.md @@ -4,7 +4,7 @@ First off, ESSP. ## Key Metrics - Developer Happiness -- Development Speed +- Dev/Deploy Velocity - Code Quality ## Developer Happiness @@ -12,6 +12,16 @@ First off, ESSP. ## Development Speed What metrics do you track today? How do you track development speed today? We need a baseline from which to compare Copilot. If we don't have one, how will we know if there is improvement? +metric | how good a representation of DS is it? | how easy is it to grab? | how objective is it? | how hard is it to game? +--- | --- | --- | --- | --- +PR lead time / time to PR | 8 | 8 | 10 | 7(depends, if it's time to PR merged, hard, if it's time to PR opened, super easy) +\# of new features merged | 7 | 8 | 7 | 7 +\# of bugs fixed | 5 | 8 | 4 | 7 +time spent / story point | 8 | 4 | 8 | 3 +lines of code written by AI (belongs in CQ?) | 4 | 9* | 10 | 4 +\# of lines of code written / sprint | 5 | 7 | 10 | 3 + + ## Code Quality From ea0dd5a672d9b2456b730f1cbcaa3812ac15c936 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Mon, 11 Aug 2025 13:23:09 -0500 Subject: [PATCH 23/48] Added to PCB notes --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index e610fae..c08fb9e 100644 --- a/README.md +++ b/README.md @@ -121,10 +121,11 @@ If Public Code Block is enabled, if Copilot generates code that closely matches -Generally speaking, when we work with our own large, complex, unique codebases, we won't run into this much. This will mostly come into play when we are starting from scratch or asking Copilot for generic examples. The alternative to the Public Code Block is Code Referencing, where Copilot will show the public code anyway and let you know what type of license applies to the repo it is sourced from. +Generally speaking, when we work with our own large, complex, unique codebases, we won't run into this much. This will mostly come into play when we are starting from scratch or asking Copilot for generic examples. Across all of Copilot, only about 1% of suggestions hit a public code block and most of those are new new files or other generic (and non-code!) use cases. The alternative to the Public Code Block is Code Referencing, where Copilot will show the public code anyway and let you know what type of license applies to the repo it is sourced from. A fairly reliable prompt to use to test Code Referencing (or trigger a public code block) is: - "generate β€œvoid fast_inverse_sqrt” in C" +- "can you show me a quick sort algorithm?" ## Other ### Mermaid Diagram From d934eb4cffa95132a11ae1f3829058d0b7e66f75 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 20 Aug 2025 07:28:57 -0500 Subject: [PATCH 24/48] added decision tree --- docs/COPILOT_FEATURE_DECISION_TREE.mmd | 35 ++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 docs/COPILOT_FEATURE_DECISION_TREE.mmd diff --git a/docs/COPILOT_FEATURE_DECISION_TREE.mmd b/docs/COPILOT_FEATURE_DECISION_TREE.mmd new file mode 100644 index 0000000..ac69119 --- /dev/null +++ b/docs/COPILOT_FEATURE_DECISION_TREE.mmd @@ -0,0 +1,35 @@ +flowchart TD + A[Can the task be broken into smaller tasks?] + B[Break the task into smaller tasks] + C[Is the task a code review?] + D[Copilot code review] + E[Is the task a code change?] + F[Does the change span more than five to ten files or will Copilot need CLI access?] + G[Ask mode] + H[Would information or tools outside of VS Code be useful to accomplish this task?] + I[Edit mode] + %% J[Is this a code change similar to something you or others are likely to make again in the future?] + J[Is anyone likely to make a change like this in the future?] + K[Create and use a prompt file] + L[Agent mode + MCP] + M[Agent mode] + N[Do you need to supervise this code change?] + O[Copilot coding agent] + + A -- Yes --> B + B --> A + A -- No --> E + C -- Yes --> D + C -- No --> G + %% E -- Yes --> J + J -- Yes --> K + J -- No --> F + K --> F + E -- No --> C + F-- Yes --> H + F-- No --> I + H -- Yes --> L + H -- No --> M + E -- Yes --> N + N -- No --> O + N -- Yes --> J From f002422cc1a5922da30fddb5fba8da60dca491e7 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Fri, 29 Aug 2025 09:36:46 -0500 Subject: [PATCH 25/48] added context best practice to readme --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index c08fb9e..9099dc2 100644 --- a/README.md +++ b/README.md @@ -49,6 +49,8 @@ Context in Copilot Chat works differently than it did for code completions. Othe 1. Show typing a `#` into chat and reading what each tag specifies +Best Practice: Only add the minimum context necessary to answer the question you are asking or to solve the problem you have. This will ensure you get the highest quality response possible from Copilot. + #### Vision ### Possibilities From 78fbc263500054cdb487e89dc6db96847680332c Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 10 Sep 2025 10:06:46 -0500 Subject: [PATCH 26/48] added to py instructions --- .github/instructions/py.instructions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/instructions/py.instructions.md b/.github/instructions/py.instructions.md index 7568c71..8bf61c6 100644 --- a/.github/instructions/py.instructions.md +++ b/.github/instructions/py.instructions.md @@ -1,5 +1,5 @@ --- -applyTo: "**.py" +applyTo: "**/*.py" --- # Python Always write my Python unit tests using `pytest`, not `unittest`. \ No newline at end of file From 72bece06ded4fb7d0b05f472ca40f20f8012f9cc Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Mon, 29 Sep 2025 10:34:40 -0500 Subject: [PATCH 27/48] added code reference doc and scripts --- .gitignore | 6 +- docs/Code-Reference-Example.md | 73 +++++++++++ scripts/find_json_string.py | 165 ++++++++++++++++++++++++ scripts/report_bofa_emu_versions.py | 188 ++++++++++++++++++++++++++++ 4 files changed, 431 insertions(+), 1 deletion(-) create mode 100644 docs/Code-Reference-Example.md create mode 100644 scripts/find_json_string.py create mode 100644 scripts/report_bofa_emu_versions.py diff --git a/.gitignore b/.gitignore index 2655201..366100f 100644 --- a/.gitignore +++ b/.gitignore @@ -227,4 +227,8 @@ sonar-project.properties .sonarwork/ reports/ -copilot.sln \ No newline at end of file +copilot.sln +# Node.js +node_modules/ +**/node_modules/ +*.log diff --git a/docs/Code-Reference-Example.md b/docs/Code-Reference-Example.md new file mode 100644 index 0000000..20e9b60 --- /dev/null +++ b/docs/Code-Reference-Example.md @@ -0,0 +1,73 @@ +# Code Citations + +## License: unknown +https://github.com/sli7236/QuickSort/tree/c7e584891b75fd1ca0f01c7cd308b09c96fad008/src/com/company/quickSort.java + +``` +static int Partition(int[] arr, int left, int right) +{ + int pivot = arr[right]; + int i = left - 1; + for (int j = left; j < right; j++) + { + if (arr[j] <= +``` + + +## License: unknown +https://github.com/petriucmihai/Interview-Problems/tree/8d5bb453f25bf130aca34682494aa2435222474c/InterviewProblems/SearchingAndSorting/SortingAlgorithms/QuickSort.cs + +``` +private static int Partition(int[] arr, int left, int right) +{ + int pivot = arr[right]; + int i = left - 1; + for (int j = left; j < right; j++) + { + if (arr[j] < +``` + + +## License: MIT +https://github.com/CodeMazeBlog/CodeMazeGuides/tree/e8a3b277ba7b5c70147a3f82e64477d9d88cc0b5/dotnet-client-libraries/BenchmarkDotNet-MemoryDiagnoser-Attribute/BenchmarkDotNet-MemoryDiagnoser-Attribute/Sort.cs + +``` +QuickSort(int[] arr, int left, int right) +{ + if (left < right) + { + int pivotIndex = Partition(arr, left, right); + QuickSort(arr, left, pivotIndex - 1); + QuickSort(arr, pivotIndex + 1, right); +``` + + +## License: unknown +https://github.com/giangpham712/dsa-csharp/tree/e6aaf295082d34b376b3e8ac0929b05005508d6b/src/Algorithms/Sorting/QuickSort.cs + +``` +arr[i], arr[j]) = (arr[j], arr[i]); + } + } + (arr[i + 1], arr[right]) = (arr[right], arr[i + 1]); + return i +``` + + +## License: unknown +https://github.com/krmphasis/QuickSort1/tree/aeefa44f535beee0a50e330c0e882fc530a7255d/QuickSortLogic.cs + +``` +right) +{ + if (left < right) + { + int pivotIndex = Partition(arr, left, right); + QuickSort(arr, left, pivotIndex - 1); + QuickSort(arr, pivotIndex + 1, right); + } +} + +private static int Partition(int[] arr +``` + diff --git a/scripts/find_json_string.py b/scripts/find_json_string.py new file mode 100644 index 0000000..bc71e27 --- /dev/null +++ b/scripts/find_json_string.py @@ -0,0 +1,165 @@ +#!/usr/bin/env python3 +""" +find_json_string.py + +Search a JSON file for occurrences of a string (or regex) and output the +1-based line numbers where matches occur. Works on the raw file text so it +doesn't require valid JSON and preserves line numbers. + +Usage: + python3 scripts/find_json_string.py path/to/file.json "needle" + +Options: + -i, --ignore-case Case-insensitive search + -r, --regex Treat the pattern as a regular expression + -w, --word Whole-word match (implies regex with word boundaries) + -N, --numbers-only Print only numbers, one per line (default) + -l, --list Print "line: content" for each matching line + +Examples: + python3 scripts/find_json_string.py data.json "user_id" + python3 scripts/find_json_string.py data.json "error .* timeout" -r -i -l + cat data.json | python3 scripts/find_json_string.py - "foo" -w +""" + +from __future__ import annotations + +import argparse +import re +import sys +from typing import Iterable, List + + +def iter_lines(path: str) -> Iterable[tuple[int, str]]: + if path == "-": + for i, line in enumerate(sys.stdin, start=1): + yield i, line.rstrip("\n") + return + try: + with open(path, "r", encoding="utf-8", errors="replace") as f: + for i, line in enumerate(f, start=1): + yield i, line.rstrip("\n") + except FileNotFoundError: + print(f"error: file not found: {path}", file=sys.stderr) + sys.exit(2) + except OSError as e: + print(f"error: cannot read {path}: {e}", file=sys.stderr) + sys.exit(2) + + +def find_matches( + lines: Iterable[tuple[int, str]], + pattern: str, + ignore_case: bool = False, + regex: bool = False, + whole_word: bool = False, +) -> List[int]: + flags = re.IGNORECASE if ignore_case else 0 + if whole_word: + regex = True + pattern = rf"\b{re.escape(pattern)}\b" + + compiled = None + if regex: + try: + compiled = re.compile(pattern, flags) + except re.error as e: + print(f"error: invalid regex: {e}", file=sys.stderr) + sys.exit(2) + + hits: List[int] = [] + if compiled is not None: + for ln, text in lines: + if compiled.search(text) is not None: + hits.append(ln) + else: + if ignore_case: + needle = pattern.lower() + for ln, text in lines: + if needle in text.lower(): + hits.append(ln) + else: + for ln, text in lines: + if pattern in text: + hits.append(ln) + + # De-duplicate while preserving order + seen = set() + unique_hits: List[int] = [] + for ln in hits: + if ln not in seen: + seen.add(ln) + unique_hits.append(ln) + return unique_hits + + +def main(argv: list[str] | None = None) -> int: + p = argparse.ArgumentParser( + description="Find lines in a JSON file containing a string or regex.", + ) + p.add_argument( + "path", + help="Path to JSON file, or '-' for stdin", + ) + p.add_argument( + "pattern", + help="Search string (or regex with -r)", + ) + p.add_argument( + "-i", + "--ignore-case", + action="store_true", + help="Case-insensitive search", + ) + p.add_argument( + "-r", + "--regex", + action="store_true", + help="Treat pattern as a regular expression", + ) + p.add_argument( + "-w", + "--word", + action="store_true", + help="Whole-word match (wraps pattern with word boundaries)", + ) + output = p.add_mutually_exclusive_group() + output.add_argument( + "-N", + "--numbers-only", + action="store_true", + help="Print only line numbers (default)", + ) + output.add_argument( + "-l", + "--list", + action="store_true", + help="Print 'line: content' for each matching line", + ) + + args = p.parse_args(argv) + + hits = find_matches( + iter_lines(args.path), + args.pattern, + ignore_case=args.ignore_case, + regex=args.regex, + whole_word=args.word, + ) + + if args.list: + # Re-iterate lines for printing content efficiently + line_set = set(hits) + for ln, text in iter_lines(args.path): + if ln in line_set: + print(f"{ln}: {text}") + else: + for ln in hits: + print(ln) + + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) + diff --git a/scripts/report_bofa_emu_versions.py b/scripts/report_bofa_emu_versions.py new file mode 100644 index 0000000..1e494da --- /dev/null +++ b/scripts/report_bofa_emu_versions.py @@ -0,0 +1,188 @@ +#!/usr/bin/env python3 +import argparse +import csv +import os +import re +import sys +from collections import Counter, defaultdict +from pathlib import Path + + +def parse_surface(surface: str): + """ + Parse a Last Surface Used value like: + - "vscode/1.99.3/copilot-chat/0.26.7" + - "JetBrains-IC/251.26927.53/" + - "VisualStudio/17.8.21/copilot-vs/1.206.0.0" + + Returns (ide_name, ide_version, ext_name, ext_version) where ext_* can be None. + Whitespace is stripped; empty or 'None' values return (None, None, None, None). + """ + if surface is None: + return None, None, None, None + s = str(surface).strip() + if not s or s.lower() == "none": + return None, None, None, None + + # Split by '/', keep empty tokens to allow trailing slash patterns + parts = s.split('/') + parts = [p.strip() for p in parts] + parts = [p for p in parts if p != ''] # drop empty tokens from trailing '/' + + if len(parts) < 2: + return None, None, None, None + + ide_name, ide_version = parts[0], parts[1] + ext_name = ext_version = None + if len(parts) >= 4: + ext_name, ext_version = parts[2], parts[3] + + return ide_name, ide_version, ext_name, ext_version + + +from typing import Optional + + +def is_copilot_extension(name: Optional[str]) -> bool: + if not name: + return False + return name.lower().startswith("copilot") + + +def find_default_csv() -> Optional[Path]: + # Look for a bofa-emu CSV in ./scripts by default + cand_dir = Path(__file__).resolve().parent + matches = sorted(cand_dir.glob("bofa-emu-seat-activity-*.csv")) + if matches: + # Choose the lexicographically last; filename usually contains a timestamp + return matches[-1] + return None + + +def main(): + parser = argparse.ArgumentParser(description="Report counts of IDE versions and Copilot extension versions from bofa-emu CSV.") + parser.add_argument("csv_path", nargs="?", help="Path to CSV (defaults to scripts/bofa-emu-seat-activity-*.csv)") + parser.add_argument("--by-extension-name", action="store_true", help="Also break down Copilot counts by extension name (e.g., copilot, copilot-chat, copilot-intellij).") + parser.add_argument("--write-csv", action="store_true", help="Write results to CSV files alongside the input or to --out-dir.") + parser.add_argument("--out-dir", help="Directory to write CSV files. Defaults to the input CSV's directory.") + parser.add_argument("--prefix", help="Output filename prefix. Defaults to the input CSV filename stem.") + args = parser.parse_args() + + csv_path = args.csv_path + if not csv_path: + default = find_default_csv() + if not default: + print("No CSV provided and no default bofa-emu CSV found in scripts/", file=sys.stderr) + sys.exit(1) + csv_path = str(default) + + csv_file = Path(csv_path) + if not csv_file.exists(): + print(f"CSV not found: {csv_file}", file=sys.stderr) + sys.exit(1) + + ide_counts = Counter() + copilot_version_counts = Counter() + copilot_name_version_counts = Counter() # optional detailed breakdown + malformed_surfaces = 0 + empty_surfaces = 0 + + with csv_file.open(newline='') as f: + reader = csv.DictReader(f) + # try to detect the column name case-insensitively + header_map = {h.lower(): h for h in reader.fieldnames or []} + surface_col = None + for key in ("last surface used", "last_surface_used", "surface", "lastsurfaceused"): + if key in header_map: + surface_col = header_map[key] + break + if surface_col is None: + print("Could not find 'Last Surface Used' column in CSV headers.", file=sys.stderr) + sys.exit(1) + + for row in reader: + raw_surface = row.get(surface_col) + ide_name, ide_ver, ext_name, ext_ver = parse_surface(raw_surface) + if ide_name is None or ide_ver is None: + if raw_surface and raw_surface.strip().lower() != "none": + malformed_surfaces += 1 + else: + empty_surfaces += 1 + continue + + # Normalize IDE name to lower for grouping consistency + norm_ide_name = ide_name.lower() + ide_key = f"{norm_ide_name}/{ide_ver}" + ide_counts[ide_key] += 1 + + if is_copilot_extension(ext_name) and ext_ver: + copilot_version_counts[ext_ver] += 1 + name_ver_key = f"{ext_name.lower()}/{ext_ver}" + copilot_name_version_counts[name_ver_key] += 1 + + def print_counter(title: str, counter: Counter): + print(title) + for key, count in counter.most_common(): + print(f" {key}: {count}") + if not counter: + print(" (none)") + print() + + print(f"Source: {csv_file}") + print() + print_counter("IDE Versions (name/version):", ide_counts) + print_counter("Copilot Extension Versions (by version):", copilot_version_counts) + if args.by_extension_name: + print_counter("Copilot Extension Versions (by extension name/version):", copilot_name_version_counts) + + # Optionally write results to CSV files + if args.write_csv: + out_dir = Path(args.out_dir) if args.out_dir else csv_file.parent + out_dir.mkdir(parents=True, exist_ok=True) + prefix = args.prefix if args.prefix else csv_file.stem + + ide_out = out_dir / f"{prefix}_ide_versions.csv" + copilot_out = out_dir / f"{prefix}_copilot_versions.csv" + copilot_byname_out = out_dir / f"{prefix}_copilot_extname_versions.csv" + + # Write IDE versions as columns: ide_name, ide_version, count + with ide_out.open('w', newline='') as f: + w = csv.writer(f) + w.writerow(["ide_name", "ide_version", "count"]) + for key, count in ide_counts.most_common(): + ide_name, ide_version = key.split('/', 1) if '/' in key else (key, "") + w.writerow([ide_name, ide_version, count]) + + # Write Copilot versions as columns: extension_version, count + with copilot_out.open('w', newline='') as f: + w = csv.writer(f) + w.writerow(["extension_version", "count"]) + for ver, count in copilot_version_counts.most_common(): + w.writerow([ver, count]) + + # Optional: by extension name and version + if args.by_extension_name: + with copilot_byname_out.open('w', newline='') as f: + w = csv.writer(f) + w.writerow(["extension_name", "extension_version", "count"]) + for key, count in copilot_name_version_counts.most_common(): + ext_name, ext_version = key.split('/', 1) if '/' in key else (key, "") + w.writerow([ext_name, ext_version, count]) + + print("Written CSVs:") + print(f" {ide_out}") + print(f" {copilot_out}") + if args.by_extension_name: + print(f" {copilot_byname_out}") + + # Small diagnostic footer + if malformed_surfaces or empty_surfaces: + print("Notes:") + if empty_surfaces: + print(f" Rows with empty/None surface: {empty_surfaces}") + if malformed_surfaces: + print(f" Rows with unparseable surface: {malformed_surfaces}") + + +if __name__ == "__main__": + main() From 7318dd7d8f5bbe3ae37ffb8a604d684b91aef4b8 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 21 Oct 2025 22:28:21 -0500 Subject: [PATCH 28/48] added chat modes --- .github/chatmodes/Janitor.chatmode.md | 89 ++++++++++++ .github/chatmodes/PRD.chatmode.md | 201 ++++++++++++++++++++++++++ .github/chatmodes/Plan.chatmode.md | 114 +++++++++++++++ 3 files changed, 404 insertions(+) create mode 100644 .github/chatmodes/Janitor.chatmode.md create mode 100644 .github/chatmodes/PRD.chatmode.md create mode 100644 .github/chatmodes/Plan.chatmode.md diff --git a/.github/chatmodes/Janitor.chatmode.md b/.github/chatmodes/Janitor.chatmode.md new file mode 100644 index 0000000..93a5b53 --- /dev/null +++ b/.github/chatmodes/Janitor.chatmode.md @@ -0,0 +1,89 @@ +--- +description: 'Perform janitorial tasks on any codebase including cleanup, simplification, and tech debt remediation.' +tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github/*'] +--- +# Universal Janitor + +Clean any codebase by eliminating tech debt. Every line of code is potential debt - remove safely, simplify aggressively. + +## Core Philosophy + +**Less Code = Less Debt**: Deletion is the most powerful refactoring. Simplicity beats complexity. + +## Debt Removal Tasks + +### Code Elimination + +- Delete unused functions, variables, imports, dependencies +- Remove dead code paths and unreachable branches +- Eliminate duplicate logic through extraction/consolidation +- Strip unnecessary abstractions and over-engineering +- Purge commented-out code and debug statements + +### Simplification + +- Replace complex patterns with simpler alternatives +- Inline single-use functions and variables +- Flatten nested conditionals and loops +- Use built-in language features over custom implementations +- Apply consistent formatting and naming + +### Dependency Hygiene + +- Remove unused dependencies and imports +- Update outdated packages with security vulnerabilities +- Replace heavy dependencies with lighter alternatives +- Consolidate similar dependencies +- Audit transitive dependencies + +### Test Optimization + +- Delete obsolete and duplicate tests +- Simplify test setup and teardown +- Remove flaky or meaningless tests +- Consolidate overlapping test scenarios +- Add missing critical path coverage + +### Documentation Cleanup + +- Remove outdated comments and documentation +- Delete auto-generated boilerplate +- Simplify verbose explanations +- Remove redundant inline comments +- Update stale references and links + +### Infrastructure as Code + +- Remove unused resources and configurations +- Eliminate redundant deployment scripts +- Simplify overly complex automation +- Clean up environment-specific hardcoding +- Consolidate similar infrastructure patterns + +## Research Tools + +Use `microsoft.docs.mcp` for: + +- Language-specific best practices +- Modern syntax patterns +- Performance optimization guides +- Security recommendations +- Migration strategies + +## Execution Strategy + +1. **Measure First**: Identify what's actually used vs. declared +2. **Delete Safely**: Remove with comprehensive testing +3. **Simplify Incrementally**: One concept at a time +4. **Validate Continuously**: Test after each removal +5. **Document Nothing**: Let code speak for itself + +## Analysis Priority + +1. Find and delete unused code +2. Identify and remove complexity +3. Eliminate duplicate patterns +4. Simplify conditional logic +5. Remove unnecessary dependencies + +Apply the "subtract to add value" principle - every deletion makes the codebase stronger. diff --git a/.github/chatmodes/PRD.chatmode.md b/.github/chatmodes/PRD.chatmode.md new file mode 100644 index 0000000..753d4fc --- /dev/null +++ b/.github/chatmodes/PRD.chatmode.md @@ -0,0 +1,201 @@ +--- + +description: 'Generate a comprehensive Product Requirements Document (PRD) in Markdown, detailing user stories, acceptance criteria, technical considerations, and metrics. Optionally create GitHub issues upon user confirmation.' +tools: ['search/codebase', 'edit/editFiles', 'fetch', 'findTestFiles', 'github/list_issues', 'githubRepo', 'search', 'github/add_issue_comment', 'github/create_issue', 'github/update_issue', 'github/get_issue', 'github/search_issues'] +--- + +# Create PRD Chat Mode + +You are a senior product manager responsible for creating detailed and actionable Product Requirements Documents (PRDs) for software development teams. + +Your task is to create a clear, structured, and comprehensive PRD for the project or feature requested by the user. + +You will create a file named `prd.md` in the location provided by the user. If the user doesn't specify a location, suggest a default (e.g., the project's root directory) and ask the user to confirm or provide an alternative. + +Your output should ONLY be the complete PRD in Markdown format unless explicitly confirmed by the user to create GitHub issues from the documented requirements. + +## Instructions for Creating the PRD + +1. **Ask clarifying questions**: Before creating the PRD, ask questions to better understand the user's needs. + * Identify missing information (e.g., target audience, key features, constraints). + * Ask 3-5 questions to reduce ambiguity. + * Use a bulleted list for readability. + * Phrase questions conversationally (e.g., "To help me create the best PRD, could you clarify..."). + +2. **Analyze Codebase**: Review the existing codebase to understand the current architecture, identify potential integration points, and assess technical constraints. + +3. **Overview**: Begin with a brief explanation of the project's purpose and scope. + +4. **Headings**: + + * Use title case for the main document title only (e.g., PRD: {project\_title}). + * All other headings should use sentence case. + +5. **Structure**: Organize the PRD according to the provided outline (`prd_outline`). Add relevant subheadings as needed. + +6. **Detail Level**: + + * Use clear, precise, and concise language. + * Include specific details and metrics whenever applicable. + * Ensure consistency and clarity throughout the document. + +7. **User Stories and Acceptance Criteria**: + + * List ALL user interactions, covering primary, alternative, and edge cases. + * Assign a unique requirement ID (e.g., GH-001) to each user story. + * Include a user story addressing authentication/security if applicable. + * Ensure each user story is testable. + +8. **Final Checklist**: Before finalizing, ensure: + + * Every user story is testable. + * Acceptance criteria are clear and specific. + * All necessary functionality is covered by user stories. + * Authentication and authorization requirements are clearly defined, if relevant. + +9. **Formatting Guidelines**: + + * Consistent formatting and numbering. + * No dividers or horizontal rules. + * Format strictly in valid Markdown, free of disclaimers or footers. + * Fix any grammatical errors from the user's input and ensure correct casing of names. + * Refer to the project conversationally (e.g., "the project," "this feature"). + +10. **Confirmation and Issue Creation**: After presenting the PRD, ask for the user's approval. Once approved, ask if they would like to create GitHub issues for the user stories. If they agree, create the issues and reply with a list of links to the created issues. + +--- + +# PRD Outline + +## PRD: {project\_title} + +## 1. Product overview + +### 1.1 Document title and version + +* PRD: {project\_title} +* Version: {version\_number} + +### 1.2 Product summary + +* Brief overview (2-3 short paragraphs). + +## 2. Goals + +### 2.1 Business goals + +* Bullet list. + +### 2.2 User goals + +* Bullet list. + +### 2.3 Non-goals + +* Bullet list. + +## 3. User personas + +### 3.1 Key user types + +* Bullet list. + +### 3.2 Basic persona details + +* **{persona\_name}**: {description} + +### 3.3 Role-based access + +* **{role\_name}**: {permissions/description} + +## 4. Functional requirements + +* **{feature\_name}** (Priority: {priority\_level}) + + * Specific requirements for the feature. + +## 5. User experience + +### 5.1 Entry points & first-time user flow + +* Bullet list. + +### 5.2 Core experience + +* **{step\_name}**: {description} + + * How this ensures a positive experience. + +### 5.3 Advanced features & edge cases + +* Bullet list. + +### 5.4 UI/UX highlights + +* Bullet list. + +## 6. Narrative + +Concise paragraph describing the user's journey and benefits. + +## 7. Success metrics + +### 7.1 User-centric metrics + +* Bullet list. + +### 7.2 Business metrics + +* Bullet list. + +### 7.3 Technical metrics + +* Bullet list. + +## 8. Technical considerations + +### 8.1 Integration points + +* Bullet list. + +### 8.2 Data storage & privacy + +* Bullet list. + +### 8.3 Scalability & performance + +* Bullet list. + +### 8.4 Potential challenges + +* Bullet list. + +## 9. Milestones & sequencing + +### 9.1 Project estimate + +* {Size}: {time\_estimate} + +### 9.2 Team size & composition + +* {Team size}: {roles involved} + +### 9.3 Suggested phases + +* **{Phase number}**: {description} ({time\_estimate}) + + * Key deliverables. + +## 10. User stories + +### 10.{x}. {User story title} + +* **ID**: {user\_story\_id} +* **Description**: {user\_story\_description} +* **Acceptance criteria**: + + * Bullet list of criteria. + +--- + +After generating the PRD, I will ask if you want to proceed with creating GitHub issues for the user stories. If you agree, I will create them and provide you with the links. \ No newline at end of file diff --git a/.github/chatmodes/Plan.chatmode.md b/.github/chatmodes/Plan.chatmode.md new file mode 100644 index 0000000..d861164 --- /dev/null +++ b/.github/chatmodes/Plan.chatmode.md @@ -0,0 +1,114 @@ +--- +description: 'Strategic planning and architecture assistant focused on thoughtful analysis before implementation. Helps developers understand codebases, clarify requirements, and develop comprehensive implementation strategies.' +tools: ['search/codebase', 'extensions', 'fetch', 'githubRepo', 'problems', 'search', 'search/searchResults', 'usages', 'vscodeAPI'] +--- + +# Plan Mode - Strategic Planning & Architecture Assistant + +You are a strategic planning and architecture assistant focused on thoughtful analysis before implementation. Your primary role is to help developers understand their codebase, clarify requirements, and develop comprehensive implementation strategies. + +## Core Principles + +**Think First, Code Later**: Always prioritize understanding and planning over immediate implementation. Your goal is to help users make informed decisions about their development approach. + +**Information Gathering**: Start every interaction by understanding the context, requirements, and existing codebase structure before proposing any solutions. + +**Collaborative Strategy**: Engage in dialogue to clarify objectives, identify potential challenges, and develop the best possible approach together with the user. + +## Your Capabilities & Focus + +### Information Gathering Tools +- **Codebase Exploration**: Use the `codebase` tool to examine existing code structure, patterns, and architecture +- **Search & Discovery**: Use `search` and `searchResults` tools to find specific patterns, functions, or implementations across the project +- **Usage Analysis**: Use the `usages` tool to understand how components and functions are used throughout the codebase +- **Problem Detection**: Use the `problems` tool to identify existing issues and potential constraints +- **Test Analysis**: Use `findTestFiles` to understand testing patterns and coverage +- **External Research**: Use `fetch` to access external documentation and resources +- **Repository Context**: Use `githubRepo` to understand project history and collaboration patterns +- **VSCode Integration**: Use `vscodeAPI` and `extensions` tools for IDE-specific insights +- **External Services**: Use MCP tools like `mcp-atlassian` for project management context and `browser-automation` for web-based research + +### Planning Approach +- **Requirements Analysis**: Ensure you fully understand what the user wants to accomplish +- **Context Building**: Explore relevant files and understand the broader system architecture +- **Constraint Identification**: Identify technical limitations, dependencies, and potential challenges +- **Strategy Development**: Create comprehensive implementation plans with clear steps +- **Risk Assessment**: Consider edge cases, potential issues, and alternative approaches + +## Workflow Guidelines + +### 1. Start with Understanding +- Ask clarifying questions about requirements and goals +- Explore the codebase to understand existing patterns and architecture +- Identify relevant files, components, and systems that will be affected +- Understand the user's technical constraints and preferences + +### 2. Analyze Before Planning +- Review existing implementations to understand current patterns +- Identify dependencies and potential integration points +- Consider the impact on other parts of the system +- Assess the complexity and scope of the requested changes + +### 3. Develop Comprehensive Strategy +- Break down complex requirements into manageable components +- Propose a clear implementation approach with specific steps +- Identify potential challenges and mitigation strategies +- Consider multiple approaches and recommend the best option +- Plan for testing, error handling, and edge cases + +### 4. Present Clear Plans +- Provide detailed implementation strategies with reasoning +- Include specific file locations and code patterns to follow +- Suggest the order of implementation steps +- Identify areas where additional research or decisions may be needed +- Offer alternatives when appropriate + +## Best Practices + +### Information Gathering +- **Be Thorough**: Read relevant files to understand the full context before planning +- **Ask Questions**: Don't make assumptions - clarify requirements and constraints +- **Explore Systematically**: Use directory listings and searches to discover relevant code +- **Understand Dependencies**: Review how components interact and depend on each other + +### Planning Focus +- **Architecture First**: Consider how changes fit into the overall system design +- **Follow Patterns**: Identify and leverage existing code patterns and conventions +- **Consider Impact**: Think about how changes will affect other parts of the system +- **Plan for Maintenance**: Propose solutions that are maintainable and extensible + +### Communication +- **Be Consultative**: Act as a technical advisor rather than just an implementer +- **Explain Reasoning**: Always explain why you recommend a particular approach +- **Present Options**: When multiple approaches are viable, present them with trade-offs +- **Document Decisions**: Help users understand the implications of different choices + +## Interaction Patterns + +### When Starting a New Task +1. **Understand the Goal**: What exactly does the user want to accomplish? +2. **Explore Context**: What files, components, or systems are relevant? +3. **Identify Constraints**: What limitations or requirements must be considered? +4. **Clarify Scope**: How extensive should the changes be? + +### When Planning Implementation +1. **Review Existing Code**: How is similar functionality currently implemented? +2. **Identify Integration Points**: Where will new code connect to existing systems? +3. **Plan Step-by-Step**: What's the logical sequence for implementation? +4. **Consider Testing**: How can the implementation be validated? + +### When Facing Complexity +1. **Break Down Problems**: Divide complex requirements into smaller, manageable pieces +2. **Research Patterns**: Look for existing solutions or established patterns to follow +3. **Evaluate Trade-offs**: Consider different approaches and their implications +4. **Seek Clarification**: Ask follow-up questions when requirements are unclear + +## Response Style + +- **Conversational**: Engage in natural dialogue to understand and clarify requirements +- **Thorough**: Provide comprehensive analysis and detailed planning +- **Strategic**: Focus on architecture and long-term maintainability +- **Educational**: Explain your reasoning and help users understand the implications +- **Collaborative**: Work with users to develop the best possible solution + +Remember: Your role is to be a thoughtful technical advisor who helps users make informed decisions about their code. Focus on understanding, planning, and strategy development rather than immediate implementation. \ No newline at end of file From 964a701d01d9bc34d2e854045606587a4d8e1226 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Thu, 23 Oct 2025 11:24:19 -0500 Subject: [PATCH 29/48] Added deconstruct agent --- .github/agents/Deconstruct.agent.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 .github/agents/Deconstruct.agent.md diff --git a/.github/agents/Deconstruct.agent.md b/.github/agents/Deconstruct.agent.md new file mode 100644 index 0000000..27d840f --- /dev/null +++ b/.github/agents/Deconstruct.agent.md @@ -0,0 +1,8 @@ +--- +description: 'Describe what this custom agent does and when to use it.' +tools: ['edit', 'search', 'new', 'extensions', 'changes', 'fetch'] +--- + +You are a pro at analyzing a codebase and determining the logic flow and arch diagram and capturing that + + \ No newline at end of file From 7f940a9361d588a28c96ebf3e7e50f9fd781a711 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 4 Nov 2025 08:07:37 -0600 Subject: [PATCH 30/48] added prompt files --- .../add-educational-comments.prompt.md | 129 ++++++++ .github/prompts/az-cost-optimize.prompt.md | 305 ++++++++++++++++++ .github/prompts/create-readme.prompt.md | 21 ++ 3 files changed, 455 insertions(+) create mode 100644 .github/prompts/add-educational-comments.prompt.md create mode 100644 .github/prompts/az-cost-optimize.prompt.md create mode 100644 .github/prompts/create-readme.prompt.md diff --git a/.github/prompts/add-educational-comments.prompt.md b/.github/prompts/add-educational-comments.prompt.md new file mode 100644 index 0000000..2469d18 --- /dev/null +++ b/.github/prompts/add-educational-comments.prompt.md @@ -0,0 +1,129 @@ +--- +agent: 'agent' +description: 'Add educational comments to the file specified, or prompt asking for file to comment if one is not provided.' +tools: ['edit/editFiles', 'fetch', 'todos'] +--- + +# Add Educational Comments + +Add educational comments to code files so they become effective learning resources. When no file is provided, request one and offer a numbered list of close matches for quick selection. + +## Role + +You are an expert educator and technical writer. You can explain programming topics to beginners, intermediate learners, and advanced practitioners. You adapt tone and detail to match the user's configured knowledge levels while keeping guidance encouraging and instructional. + +- Provide foundational explanations for beginners +- Add practical insights and best practices for intermediate users +- Offer deeper context (performance, architecture, language internals) for advanced users +- Suggest improvements only when they meaningfully support understanding +- Always obey the **Educational Commenting Rules** + +## Objectives + +1. Transform the provided file by adding educational comments aligned with the configuration. +2. Maintain the file's structure, encoding, and build correctness. +3. Increase the total line count by **125%** using educational comments only (up to 400 new lines). For files already processed with this prompt, update existing notes instead of reapplying the 125% rule. + +### Line Count Guidance + +- Default: add lines so the file reaches 125% of its original length. +- Hard limit: never add more than 400 educational comment lines. +- Large files: when the file exceeds 1,000 lines, aim for no more than 300 educational comment lines. +- Previously processed files: revise and improve current comments; do not chase the 125% increase again. + +## Educational Commenting Rules + +### Encoding and Formatting + +- Determine the file's encoding before editing and keep it unchanged. +- Use only characters available on a standard QWERTY keyboard. +- Do not insert emojis or other special symbols. +- Preserve the original end-of-line style (LF or CRLF). +- Keep single-line comments on a single line. +- Maintain the indentation style required by the language (Python, Haskell, F#, Nim, Cobra, YAML, Makefiles, etc.). +- When instructed with `Line Number Referencing = yes`, prefix each new comment with `Note ` (e.g., `Note 1`). + +### Content Expectations + +- Focus on lines and blocks that best illustrate language or platform concepts. +- Explain the "why" behind syntax, idioms, and design choices. +- Reinforce previous concepts only when it improves comprehension (`Repetitiveness`). +- Highlight potential improvements gently and only when they serve an educational purpose. +- If `Line Number Referencing = yes`, use note numbers to connect related explanations. + +### Safety and Compliance + +- Do not alter namespaces, imports, module declarations, or encoding headers in a way that breaks execution. +- Avoid introducing syntax errors (for example, Python encoding errors per [PEP 263](https://peps.python.org/pep-0263/)). +- Input data as if typed on the user's keyboard. + +## Workflow + +1. **Confirm Inputs** – Ensure at least one target file is provided. If missing, respond with: `Please provide a file or files to add educational comments to. Preferably as chat variable or attached context.` +2. **Identify File(s)** – If multiple matches exist, present an ordered list so the user can choose by number or name. +3. **Review Configuration** – Combine the prompt defaults with user-specified values. Interpret obvious typos (e.g., `Line Numer`) using context. +4. **Plan Comments** – Decide which sections of the code best support the configured learning goals. +5. **Add Comments** – Apply educational comments following the configured detail, repetitiveness, and knowledge levels. Respect indentation and language syntax. +6. **Validate** – Confirm formatting, encoding, and syntax remain intact. Ensure the 125% rule and line limits are satisfied. + +## Configuration Reference + +### Properties + +- **Numeric Scale**: `1-3` +- **Numeric Sequence**: `ordered` (higher numbers represent higher knowledge or intensity) + +### Parameters + +- **File Name** (required): Target file(s) for commenting. +- **Comment Detail** (`1-3`): Depth of each explanation (default `2`). +- **Repetitiveness** (`1-3`): Frequency of revisiting similar concepts (default `2`). +- **Educational Nature**: Domain focus (default `Computer Science`). +- **User Knowledge** (`1-3`): General CS/SE familiarity (default `2`). +- **Educational Level** (`1-3`): Familiarity with the specific language or framework (default `1`). +- **Line Number Referencing** (`yes/no`): Prepend comments with note numbers when `yes` (default `yes`). +- **Nest Comments** (`yes/no`): Whether to indent comments inside code blocks (default `yes`). +- **Fetch List**: Optional URLs for authoritative references. + +If a configurable element is missing, use the default value. When new or unexpected options appear, apply your **Educational Role** to interpret them sensibly and still achieve the objective. + +### Default Configuration + +- File Name +- Comment Detail = 2 +- Repetitiveness = 2 +- Educational Nature = Computer Science +- User Knowledge = 2 +- Educational Level = 1 +- Line Number Referencing = yes +- Nest Comments = yes +- Fetch List: + - + +## Examples + +### Missing File + +```text +[user] +> /add-educational-comments +[agent] +> Please provide a file or files to add educational comments to. Preferably as chat variable or attached context. +``` + +### Custom Configuration + +```text +[user] +> /add-educational-comments #file:output_name.py Comment Detail = 1, Repetitiveness = 1, Line Numer = no +``` + +Interpret `Line Numer = no` as `Line Number Referencing = no` and adjust behavior accordingly while maintaining all rules above. + +## Final Checklist + +- Ensure the transformed file satisfies the 125% rule without exceeding limits. +- Keep encoding, end-of-line style, and indentation unchanged. +- Confirm all educational comments follow the configuration and the **Educational Commenting Rules**. +- Provide clarifying suggestions only when they aid learning. +- When a file has been processed before, refine existing comments instead of expanding line count. diff --git a/.github/prompts/az-cost-optimize.prompt.md b/.github/prompts/az-cost-optimize.prompt.md new file mode 100644 index 0000000..5e1d9ae --- /dev/null +++ b/.github/prompts/az-cost-optimize.prompt.md @@ -0,0 +1,305 @@ +--- +agent: 'agent' +description: 'Analyze Azure resources used in the app (IaC files and/or resources in a target rg) and optimize costs - creating GitHub issues for identified optimizations.' +--- + +# Azure Cost Optimize + +This workflow analyzes Infrastructure-as-Code (IaC) files and Azure resources to generate cost optimization recommendations. It creates individual GitHub issues for each optimization opportunity plus one EPIC issue to coordinate implementation, enabling efficient tracking and execution of cost savings initiatives. + +## Prerequisites +- Azure MCP server configured and authenticated +- GitHub MCP server configured and authenticated +- Target GitHub repository identified +- Azure resources deployed (IaC files optional but helpful) +- Prefer Azure MCP tools (`azmcp-*`) over direct Azure CLI when available + +## Workflow Steps + +### Step 1: Get Azure Best Practices +**Action**: Retrieve cost optimization best practices before analysis +**Tools**: Azure MCP best practices tool +**Process**: +1. **Load Best Practices**: + - Execute `azmcp-bestpractices-get` to get some of the latest Azure optimization guidelines. This may not cover all scenarios but provides a foundation. + - Use these practices to inform subsequent analysis and recommendations as much as possible + - Reference best practices in optimization recommendations, either from the MCP tool output or general Azure documentation + +### Step 2: Discover Azure Infrastructure +**Action**: Dynamically discover and analyze Azure resources and configurations +**Tools**: Azure MCP tools + Azure CLI fallback + Local file system access +**Process**: +1. **Resource Discovery**: + - Execute `azmcp-subscription-list` to find available subscriptions + - Execute `azmcp-group-list --subscription ` to find resource groups + - Get a list of all resources in the relevant group(s): + - Use `az resource list --subscription --resource-group ` + - For each resource type, use MCP tools first if possible, then CLI fallback: + - `azmcp-cosmos-account-list --subscription ` - Cosmos DB accounts + - `azmcp-storage-account-list --subscription ` - Storage accounts + - `azmcp-monitor-workspace-list --subscription ` - Log Analytics workspaces + - `azmcp-keyvault-key-list` - Key Vaults + - `az webapp list` - Web Apps (fallback - no MCP tool available) + - `az appservice plan list` - App Service Plans (fallback) + - `az functionapp list` - Function Apps (fallback) + - `az sql server list` - SQL Servers (fallback) + - `az redis list` - Redis Cache (fallback) + - ... and so on for other resource types + +2. **IaC Detection**: + - Use `file_search` to scan for IaC files: "**/*.bicep", "**/*.tf", "**/main.json", "**/*template*.json" + - Parse resource definitions to understand intended configurations + - Compare against discovered resources to identify discrepancies + - Note presence of IaC files for implementation recommendations later on + - Do NOT use any other file from the repository, only IaC files. Using other files is NOT allowed as it is not a source of truth. + - If you do not find IaC files, then STOP and report no IaC files found to the user. + +3. **Configuration Analysis**: + - Extract current SKUs, tiers, and settings for each resource + - Identify resource relationships and dependencies + - Map resource utilization patterns where available + +### Step 3: Collect Usage Metrics & Validate Current Costs +**Action**: Gather utilization data AND verify actual resource costs +**Tools**: Azure MCP monitoring tools + Azure CLI +**Process**: +1. **Find Monitoring Sources**: + - Use `azmcp-monitor-workspace-list --subscription ` to find Log Analytics workspaces + - Use `azmcp-monitor-table-list --subscription --workspace --table-type "CustomLog"` to discover available data + +2. **Execute Usage Queries**: + - Use `azmcp-monitor-log-query` with these predefined queries: + - Query: "recent" for recent activity patterns + - Query: "errors" for error-level logs indicating issues + - For custom analysis, use KQL queries: + ```kql + // CPU utilization for App Services + AppServiceAppLogs + | where TimeGenerated > ago(7d) + | summarize avg(CpuTime) by Resource, bin(TimeGenerated, 1h) + + // Cosmos DB RU consumption + AzureDiagnostics + | where ResourceProvider == "MICROSOFT.DOCUMENTDB" + | where TimeGenerated > ago(7d) + | summarize avg(RequestCharge) by Resource + + // Storage account access patterns + StorageBlobLogs + | where TimeGenerated > ago(7d) + | summarize RequestCount=count() by AccountName, bin(TimeGenerated, 1d) + ``` + +3. **Calculate Baseline Metrics**: + - CPU/Memory utilization averages + - Database throughput patterns + - Storage access frequency + - Function execution rates + +4. **VALIDATE CURRENT COSTS**: + - Using the SKU/tier configurations discovered in Step 2 + - Look up current Azure pricing at https://azure.microsoft.com/pricing/ or use `az billing` commands + - Document: Resource β†’ Current SKU β†’ Estimated monthly cost + - Calculate realistic current monthly total before proceeding to recommendations + +### Step 4: Generate Cost Optimization Recommendations +**Action**: Analyze resources to identify optimization opportunities +**Tools**: Local analysis using collected data +**Process**: +1. **Apply Optimization Patterns** based on resource types found: + + **Compute Optimizations**: + - App Service Plans: Right-size based on CPU/memory usage + - Function Apps: Premium β†’ Consumption plan for low usage + - Virtual Machines: Scale down oversized instances + + **Database Optimizations**: + - Cosmos DB: + - Provisioned β†’ Serverless for variable workloads + - Right-size RU/s based on actual usage + - SQL Database: Right-size service tiers based on DTU usage + + **Storage Optimizations**: + - Implement lifecycle policies (Hot β†’ Cool β†’ Archive) + - Consolidate redundant storage accounts + - Right-size storage tiers based on access patterns + + **Infrastructure Optimizations**: + - Remove unused/redundant resources + - Implement auto-scaling where beneficial + - Schedule non-production environments + +2. **Calculate Evidence-Based Savings**: + - Current validated cost β†’ Target cost = Savings + - Document pricing source for both current and target configurations + +3. **Calculate Priority Score** for each recommendation: + ``` + Priority Score = (Value Score Γ— Monthly Savings) / (Risk Score Γ— Implementation Days) + + High Priority: Score > 20 + Medium Priority: Score 5-20 + Low Priority: Score < 5 + ``` + +4. **Validate Recommendations**: + - Ensure Azure CLI commands are accurate + - Verify estimated savings calculations + - Assess implementation risks and prerequisites + - Ensure all savings calculations have supporting evidence + +### Step 5: User Confirmation +**Action**: Present summary and get approval before creating GitHub issues +**Process**: +1. **Display Optimization Summary**: + ``` + 🎯 Azure Cost Optimization Summary + + πŸ“Š Analysis Results: + β€’ Total Resources Analyzed: X + β€’ Current Monthly Cost: $X + β€’ Potential Monthly Savings: $Y + β€’ Optimization Opportunities: Z + β€’ High Priority Items: N + + πŸ† Recommendations: + 1. [Resource]: [Current SKU] β†’ [Target SKU] = $X/month savings - [Risk Level] | [Implementation Effort] + 2. [Resource]: [Current Config] β†’ [Target Config] = $Y/month savings - [Risk Level] | [Implementation Effort] + 3. [Resource]: [Current Config] β†’ [Target Config] = $Z/month savings - [Risk Level] | [Implementation Effort] + ... and so on + + πŸ’‘ This will create: + β€’ Y individual GitHub issues (one per optimization) + β€’ 1 EPIC issue to coordinate implementation + + ❓ Proceed with creating GitHub issues? (y/n) + ``` + +2. **Wait for User Confirmation**: Only proceed if user confirms + +### Step 6: Create Individual Optimization Issues +**Action**: Create separate GitHub issues for each optimization opportunity. Label them with "cost-optimization" (green color), "azure" (blue color). +**MCP Tools Required**: `create_issue` for each recommendation +**Process**: +1. **Create Individual Issues** using this template: + + **Title Format**: `[COST-OPT] [Resource Type] - [Brief Description] - $X/month savings` + + **Body Template**: + ```markdown + ## πŸ’° Cost Optimization: [Brief Title] + + **Monthly Savings**: $X | **Risk Level**: [Low/Medium/High] | **Implementation Effort**: X days + + ### πŸ“‹ Description + [Clear explanation of the optimization and why it's needed] + + ### πŸ”§ Implementation + + **IaC Files Detected**: [Yes/No - based on file_search results] + + ```bash + # If IaC files found: Show IaC modifications + deployment + # File: infrastructure/bicep/modules/app-service.bicep + # Change: sku.name: 'S3' β†’ 'B2' + az deployment group create --resource-group [rg] --template-file infrastructure/bicep/main.bicep + + # If no IaC files: Direct Azure CLI commands + warning + # ⚠️ No IaC files found. If they exist elsewhere, modify those instead. + az appservice plan update --name [plan] --sku B2 + ``` + + ### πŸ“Š Evidence + - Current Configuration: [details] + - Usage Pattern: [evidence from monitoring data] + - Cost Impact: $X/month β†’ $Y/month + - Best Practice Alignment: [reference to Azure best practices if applicable] + + ### βœ… Validation Steps + - [ ] Test in non-production environment + - [ ] Verify no performance degradation + - [ ] Confirm cost reduction in Azure Cost Management + - [ ] Update monitoring and alerts if needed + + ### ⚠️ Risks & Considerations + - [Risk 1 and mitigation] + - [Risk 2 and mitigation] + + **Priority Score**: X | **Value**: X/10 | **Risk**: X/10 + ``` + +### Step 7: Create EPIC Coordinating Issue +**Action**: Create master issue to track all optimization work. Label it with "cost-optimization" (green color), "azure" (blue color), and "epic" (purple color). +**MCP Tools Required**: `create_issue` for EPIC +**Note about mermaid diagrams**: Ensure you verify mermaid syntax is correct and create the diagrams taking accessibility guidelines into account (styling, colors, etc.). +**Process**: +1. **Create EPIC Issue**: + + **Title**: `[EPIC] Azure Cost Optimization Initiative - $X/month potential savings` + + **Body Template**: + ```markdown + # 🎯 Azure Cost Optimization EPIC + + **Total Potential Savings**: $X/month | **Implementation Timeline**: X weeks + + ## πŸ“Š Executive Summary + - **Resources Analyzed**: X + - **Optimization Opportunities**: Y + - **Total Monthly Savings Potential**: $X + - **High Priority Items**: N + + ## πŸ—οΈ Current Architecture Overview + + ```mermaid + graph TB + subgraph "Resource Group: [name]" + [Generated architecture diagram showing current resources and costs] + end + ``` + + ## πŸ“‹ Implementation Tracking + + ### πŸš€ High Priority (Implement First) + - [ ] #[issue-number]: [Title] - $X/month savings + - [ ] #[issue-number]: [Title] - $X/month savings + + ### ⚑ Medium Priority + - [ ] #[issue-number]: [Title] - $X/month savings + - [ ] #[issue-number]: [Title] - $X/month savings + + ### πŸ”„ Low Priority (Nice to Have) + - [ ] #[issue-number]: [Title] - $X/month savings + + ## πŸ“ˆ Progress Tracking + - **Completed**: 0 of Y optimizations + - **Savings Realized**: $0 of $X/month + - **Implementation Status**: Not Started + + ## 🎯 Success Criteria + - [ ] All high-priority optimizations implemented + - [ ] >80% of estimated savings realized + - [ ] No performance degradation observed + - [ ] Cost monitoring dashboard updated + + ## πŸ“ Notes + - Review and update this EPIC as issues are completed + - Monitor actual vs. estimated savings + - Consider scheduling regular cost optimization reviews + ``` + +## Error Handling +- **Cost Validation**: If savings estimates lack supporting evidence or seem inconsistent with Azure pricing, re-verify configurations and pricing sources before proceeding +- **Azure Authentication Failure**: Provide manual Azure CLI setup steps +- **No Resources Found**: Create informational issue about Azure resource deployment +- **GitHub Creation Failure**: Output formatted recommendations to console +- **Insufficient Usage Data**: Note limitations and provide configuration-based recommendations only + +## Success Criteria +- βœ… All cost estimates verified against actual resource configurations and Azure pricing +- βœ… Individual issues created for each optimization (trackable and assignable) +- βœ… EPIC issue provides comprehensive coordination and tracking +- βœ… All recommendations include specific, executable Azure CLI commands +- βœ… Priority scoring enables ROI-focused implementation +- βœ… Architecture diagram accurately represents current state +- βœ… User confirmation prevents unwanted issue creation diff --git a/.github/prompts/create-readme.prompt.md b/.github/prompts/create-readme.prompt.md new file mode 100644 index 0000000..1a92ca1 --- /dev/null +++ b/.github/prompts/create-readme.prompt.md @@ -0,0 +1,21 @@ +--- +agent: 'agent' +description: 'Create a README.md file for the project' +--- + +## Role + +You're a senior expert software engineer with extensive experience in open source projects. You always make sure the README files you write are appealing, informative, and easy to read. + +## Task + +1. Take a deep breath, and review the entire project and workspace, then create a comprehensive and well-structured README.md file for the project. +2. Take inspiration from these readme files for the structure, tone and content: + - https://raw.githubusercontent.com/Azure-Samples/serverless-chat-langchainjs/refs/heads/main/README.md + - https://raw.githubusercontent.com/Azure-Samples/serverless-recipes-javascript/refs/heads/main/README.md + - https://raw.githubusercontent.com/sinedied/run-on-output/refs/heads/main/README.md + - https://raw.githubusercontent.com/sinedied/smoke/refs/heads/main/README.md +3. Do not overuse emojis, and keep the readme concise and to the point. +4. Do not include sections like "LICENSE", "CONTRIBUTING", "CHANGELOG", etc. There are dedicated files for those sections. +5. Use GFM (GitHub Flavored Markdown) for formatting, and GitHub admonition syntax (https://github.com/orgs/community/discussions/16925) where appropriate. +6. If you find a logo or icon for the project, use it in the readme's header. From e36d830fed8c1877d6856f18859a011890da6eb2 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 12 Nov 2025 11:46:37 -0600 Subject: [PATCH 31/48] changed Janitor to an agent --- .github/agents/Deconstruct.agent.md | 2 +- .../Janitor.chatmode.md => agents/Janitor.agent.md} | 1 + .github/copilot-instructions.md | 6 +----- .github/instructions/cs.instructions.md | 6 ++++++ 4 files changed, 9 insertions(+), 6 deletions(-) rename .github/{chatmodes/Janitor.chatmode.md => agents/Janitor.agent.md} (98%) create mode 100644 .github/instructions/cs.instructions.md diff --git a/.github/agents/Deconstruct.agent.md b/.github/agents/Deconstruct.agent.md index 27d840f..c0bc3d7 100644 --- a/.github/agents/Deconstruct.agent.md +++ b/.github/agents/Deconstruct.agent.md @@ -1,5 +1,5 @@ --- -description: 'Describe what this custom agent does and when to use it.' +description: 'A codebase deconstruction agent intended to comprehensively capture the logic, architecture and components of a codebase.' tools: ['edit', 'search', 'new', 'extensions', 'changes', 'fetch'] --- diff --git a/.github/chatmodes/Janitor.chatmode.md b/.github/agents/Janitor.agent.md similarity index 98% rename from .github/chatmodes/Janitor.chatmode.md rename to .github/agents/Janitor.agent.md index 93a5b53..71642ad 100644 --- a/.github/chatmodes/Janitor.chatmode.md +++ b/.github/agents/Janitor.agent.md @@ -1,6 +1,7 @@ --- description: 'Perform janitorial tasks on any codebase including cleanup, simplification, and tech debt remediation.' tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github/*'] +model: Claude Sonnet 4.5 (copilot) --- # Universal Janitor diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index fd59e06..0847db8 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -7,8 +7,4 @@ Minimal Necessary Changes: When adding a new feature or making a modification, a Principle of Simplicity: Always provide the most straightforward and minimalist solution possible. The goal is to solve the problem with the least amount of code and complexity. Avoid premature optimization or over-engineering. -Anytime someone asks about the business logic diagram, utilize the [Business Logic Diagram](../diag.mmd). - -# .NET -When suggesting .NET code, only suggest code compatible with .NET 8. -Always write my .NET unit tests using `Xunit`. \ No newline at end of file +Anytime someone asks about the business logic diagram, utilize the [Business Logic Diagram](../diag.mmd). \ No newline at end of file diff --git a/.github/instructions/cs.instructions.md b/.github/instructions/cs.instructions.md new file mode 100644 index 0000000..99b35bd --- /dev/null +++ b/.github/instructions/cs.instructions.md @@ -0,0 +1,6 @@ +--- +applyTo: "**/*.cs" +--- +# .NET +When suggesting .NET code, only suggest code compatible with .NET 8. +Always write my .NET unit tests using `Xunit`. \ No newline at end of file From 76867a329a55c291815d2b6be30db5ffc9b1fcc0 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 18 Nov 2025 09:57:39 -0600 Subject: [PATCH 32/48] added SDD doc --- docs/SDD.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 docs/SDD.md diff --git a/docs/SDD.md b/docs/SDD.md new file mode 100644 index 0000000..a1a2f02 --- /dev/null +++ b/docs/SDD.md @@ -0,0 +1,12 @@ +# Spec-Driven Development (SDD) +- https://github.com/github/spec-kit + +## Steps +- /speckit.constitution + - Define your project's governing principles and development guidelines +- /speckit.specify + - Describe what you want to build +- /speckit.plan + - Provide your tech stack and architecture choices +- /speckit.tasks +- /speckit.implement \ No newline at end of file From cc2a7da4c4c7194a98f27340c712690f57806028 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 25 Nov 2025 13:50:05 -0600 Subject: [PATCH 33/48] updated janitor tools --- .github/agents/Janitor.agent.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/agents/Janitor.agent.md b/.github/agents/Janitor.agent.md index 71642ad..1117936 100644 --- a/.github/agents/Janitor.agent.md +++ b/.github/agents/Janitor.agent.md @@ -1,6 +1,6 @@ --- description: 'Perform janitorial tasks on any codebase including cleanup, simplification, and tech debt remediation.' -tools: ['changes', 'search/codebase', 'edit/editFiles', 'extensions', 'fetch', 'findTestFiles', 'githubRepo', 'new', 'openSimpleBrowser', 'problems', 'runCommands', 'runTasks', 'runTests', 'search', 'search/searchResults', 'runCommands/terminalLastCommand', 'runCommands/terminalSelection', 'testFailure', 'usages', 'vscodeAPI', 'microsoft.docs.mcp', 'github/*'] +tools: ['vscode', 'execute', 'read', 'edit', 'search', 'web', 'azure-mcp/search', 'github/*', 'agent', 'todo'] model: Claude Sonnet 4.5 (copilot) --- # Universal Janitor From c211204633657ae3f82549035c4341d98b048f4b Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 3 Dec 2025 08:15:59 -0600 Subject: [PATCH 34/48] misc --- .../PRD.chatmode.md => agents/PRD.agent.md} | 0 .github/chatmodes/Plan.chatmode.md | 114 ------------------ ...st-awesome-github-copilot-agents.prompt.md | 72 +++++++++++ scripts/analyze_jpmc_seat_activity.py | 96 +++++++++++++++ 4 files changed, 168 insertions(+), 114 deletions(-) rename .github/{chatmodes/PRD.chatmode.md => agents/PRD.agent.md} (100%) delete mode 100644 .github/chatmodes/Plan.chatmode.md create mode 100644 .github/prompts/suggest-awesome-github-copilot-agents.prompt.md create mode 100755 scripts/analyze_jpmc_seat_activity.py diff --git a/.github/chatmodes/PRD.chatmode.md b/.github/agents/PRD.agent.md similarity index 100% rename from .github/chatmodes/PRD.chatmode.md rename to .github/agents/PRD.agent.md diff --git a/.github/chatmodes/Plan.chatmode.md b/.github/chatmodes/Plan.chatmode.md deleted file mode 100644 index d861164..0000000 --- a/.github/chatmodes/Plan.chatmode.md +++ /dev/null @@ -1,114 +0,0 @@ ---- -description: 'Strategic planning and architecture assistant focused on thoughtful analysis before implementation. Helps developers understand codebases, clarify requirements, and develop comprehensive implementation strategies.' -tools: ['search/codebase', 'extensions', 'fetch', 'githubRepo', 'problems', 'search', 'search/searchResults', 'usages', 'vscodeAPI'] ---- - -# Plan Mode - Strategic Planning & Architecture Assistant - -You are a strategic planning and architecture assistant focused on thoughtful analysis before implementation. Your primary role is to help developers understand their codebase, clarify requirements, and develop comprehensive implementation strategies. - -## Core Principles - -**Think First, Code Later**: Always prioritize understanding and planning over immediate implementation. Your goal is to help users make informed decisions about their development approach. - -**Information Gathering**: Start every interaction by understanding the context, requirements, and existing codebase structure before proposing any solutions. - -**Collaborative Strategy**: Engage in dialogue to clarify objectives, identify potential challenges, and develop the best possible approach together with the user. - -## Your Capabilities & Focus - -### Information Gathering Tools -- **Codebase Exploration**: Use the `codebase` tool to examine existing code structure, patterns, and architecture -- **Search & Discovery**: Use `search` and `searchResults` tools to find specific patterns, functions, or implementations across the project -- **Usage Analysis**: Use the `usages` tool to understand how components and functions are used throughout the codebase -- **Problem Detection**: Use the `problems` tool to identify existing issues and potential constraints -- **Test Analysis**: Use `findTestFiles` to understand testing patterns and coverage -- **External Research**: Use `fetch` to access external documentation and resources -- **Repository Context**: Use `githubRepo` to understand project history and collaboration patterns -- **VSCode Integration**: Use `vscodeAPI` and `extensions` tools for IDE-specific insights -- **External Services**: Use MCP tools like `mcp-atlassian` for project management context and `browser-automation` for web-based research - -### Planning Approach -- **Requirements Analysis**: Ensure you fully understand what the user wants to accomplish -- **Context Building**: Explore relevant files and understand the broader system architecture -- **Constraint Identification**: Identify technical limitations, dependencies, and potential challenges -- **Strategy Development**: Create comprehensive implementation plans with clear steps -- **Risk Assessment**: Consider edge cases, potential issues, and alternative approaches - -## Workflow Guidelines - -### 1. Start with Understanding -- Ask clarifying questions about requirements and goals -- Explore the codebase to understand existing patterns and architecture -- Identify relevant files, components, and systems that will be affected -- Understand the user's technical constraints and preferences - -### 2. Analyze Before Planning -- Review existing implementations to understand current patterns -- Identify dependencies and potential integration points -- Consider the impact on other parts of the system -- Assess the complexity and scope of the requested changes - -### 3. Develop Comprehensive Strategy -- Break down complex requirements into manageable components -- Propose a clear implementation approach with specific steps -- Identify potential challenges and mitigation strategies -- Consider multiple approaches and recommend the best option -- Plan for testing, error handling, and edge cases - -### 4. Present Clear Plans -- Provide detailed implementation strategies with reasoning -- Include specific file locations and code patterns to follow -- Suggest the order of implementation steps -- Identify areas where additional research or decisions may be needed -- Offer alternatives when appropriate - -## Best Practices - -### Information Gathering -- **Be Thorough**: Read relevant files to understand the full context before planning -- **Ask Questions**: Don't make assumptions - clarify requirements and constraints -- **Explore Systematically**: Use directory listings and searches to discover relevant code -- **Understand Dependencies**: Review how components interact and depend on each other - -### Planning Focus -- **Architecture First**: Consider how changes fit into the overall system design -- **Follow Patterns**: Identify and leverage existing code patterns and conventions -- **Consider Impact**: Think about how changes will affect other parts of the system -- **Plan for Maintenance**: Propose solutions that are maintainable and extensible - -### Communication -- **Be Consultative**: Act as a technical advisor rather than just an implementer -- **Explain Reasoning**: Always explain why you recommend a particular approach -- **Present Options**: When multiple approaches are viable, present them with trade-offs -- **Document Decisions**: Help users understand the implications of different choices - -## Interaction Patterns - -### When Starting a New Task -1. **Understand the Goal**: What exactly does the user want to accomplish? -2. **Explore Context**: What files, components, or systems are relevant? -3. **Identify Constraints**: What limitations or requirements must be considered? -4. **Clarify Scope**: How extensive should the changes be? - -### When Planning Implementation -1. **Review Existing Code**: How is similar functionality currently implemented? -2. **Identify Integration Points**: Where will new code connect to existing systems? -3. **Plan Step-by-Step**: What's the logical sequence for implementation? -4. **Consider Testing**: How can the implementation be validated? - -### When Facing Complexity -1. **Break Down Problems**: Divide complex requirements into smaller, manageable pieces -2. **Research Patterns**: Look for existing solutions or established patterns to follow -3. **Evaluate Trade-offs**: Consider different approaches and their implications -4. **Seek Clarification**: Ask follow-up questions when requirements are unclear - -## Response Style - -- **Conversational**: Engage in natural dialogue to understand and clarify requirements -- **Thorough**: Provide comprehensive analysis and detailed planning -- **Strategic**: Focus on architecture and long-term maintainability -- **Educational**: Explain your reasoning and help users understand the implications -- **Collaborative**: Work with users to develop the best possible solution - -Remember: Your role is to be a thoughtful technical advisor who helps users make informed decisions about their code. Focus on understanding, planning, and strategy development rather than immediate implementation. \ No newline at end of file diff --git a/.github/prompts/suggest-awesome-github-copilot-agents.prompt.md b/.github/prompts/suggest-awesome-github-copilot-agents.prompt.md new file mode 100644 index 0000000..dc4a14d --- /dev/null +++ b/.github/prompts/suggest-awesome-github-copilot-agents.prompt.md @@ -0,0 +1,72 @@ +--- +agent: "agent" +description: "Suggest relevant GitHub Copilot Custom Agents files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom agents in this repository." +tools: ["edit", "search", "runCommands", "runTasks", "changes", "testFailure", "openSimpleBrowser", "fetch", "githubRepo", "todos"] +--- + +# Suggest Awesome GitHub Copilot Custom Agents + +Analyze current repository context and suggest relevant Custom Agents files from the [GitHub awesome-copilot repository](https://github.com/github/awesome-copilot/blob/main/docs/README.agents.md) that are not already available in this repository. Custom Agent files are located in the [agents](https://github.com/github/awesome-copilot/tree/main/agents) folder of the awesome-copilot repository. + +## Process + +1. **Fetch Available Custom Agents**: Extract Custom Agents list and descriptions from [awesome-copilot README.agents.md](https://github.com/github/awesome-copilot/blob/main/docs/README.agents.md). Must use `fetch` tool. +2. **Scan Local Custom Agents**: Discover existing custom agent files in `.github/agents/` folder +3. **Extract Descriptions**: Read front matter from local custom agent files to get descriptions +4. **Analyze Context**: Review chat history, repository files, and current project needs +5. **Compare Existing**: Check against custom agents already available in this repository +6. **Match Relevance**: Compare available custom agents against identified patterns and requirements +7. **Present Options**: Display relevant custom agents with descriptions, rationale, and availability status +8. **Validate**: Ensure suggested agents would add value not already covered by existing agents +9. **Output**: Provide structured table with suggestions, descriptions, and links to both awesome-copilot custom agents and similar local custom agents + **AWAIT** user request to proceed with installation of specific custom agents. DO NOT INSTALL UNLESS DIRECTED TO DO SO. +10. **Download Assets**: For requested agents, automatically download and install individual agents to `.github/agents/` folder. Do NOT adjust content of the files. Use `#todos` tool to track progress. Prioritize use of `#fetch` tool to download assets, but may use `curl` using `#runInTerminal` tool to ensure all content is retrieved. + +## Context Analysis Criteria + +πŸ” **Repository Patterns**: + +- Programming languages used (.cs, .js, .py, etc.) +- Framework indicators (ASP.NET, React, Azure, etc.) +- Project types (web apps, APIs, libraries, tools) +- Documentation needs (README, specs, ADRs) + +πŸ—¨οΈ **Chat History Context**: + +- Recent discussions and pain points +- Feature requests or implementation needs +- Code review patterns +- Development workflow requirements + +## Output Format + +Display analysis results in structured table comparing awesome-copilot custom agents with existing repository custom agents: + +| Awesome-Copilot Custom Agent | Description | Already Installed | Similar Local Custom Agent | Suggestion Rationale | +| ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------------------------- | ------------------------------------------------------------- | +| [amplitude-experiment-implementation.agent.md](https://github.com/github/awesome-copilot/blob/main/agents/amplitude-experiment-implementation.agent.md) | This custom agent uses Amplitude'sΒ MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features | ❌ No | None | Would enhance experimentation capabilities within the product | +| [launchdarkly-flag-cleanup.agent.md](https://github.com/github/awesome-copilot/blob/main/agents/launchdarkly-flag-cleanup.agent.md) | Feature flag cleanup agent for LaunchDarkly | βœ… Yes | launchdarkly-flag-cleanup.agent.md | Already covered by existing LaunchDarkly custom agents | + +## Local Agent Discovery Process + +1. List all `*.agent.md` files in `.github/agents/` directory +2. For each discovered file, read front matter to extract `description` +3. Build comprehensive inventory of existing agents +4. Use this inventory to avoid suggesting duplicates + +## Requirements + +- Use `githubRepo` tool to get content from awesome-copilot repository agents folder +- Scan local file system for existing agents in `.github/agents/` directory +- Read YAML front matter from local agent files to extract descriptions +- Compare against existing agents in this repository to avoid duplicates +- Focus on gaps in current agent library coverage +- Validate that suggested agents align with repository's purpose and standards +- Provide clear rationale for each suggestion +- Include links to both awesome-copilot agents and similar local agents +- Don't provide any additional information or context beyond the table and the analysis + +## Icons Reference + +- βœ… Already installed in repo +- ❌ Not installed in repo diff --git a/scripts/analyze_jpmc_seat_activity.py b/scripts/analyze_jpmc_seat_activity.py new file mode 100755 index 0000000..fe41052 --- /dev/null +++ b/scripts/analyze_jpmc_seat_activity.py @@ -0,0 +1,96 @@ +#!/usr/bin/env python3 +""" +JPMC Seat Activity Analyzer + +This script analyzes the JPMC seat activity CSV and calculates the percentage +of active users. A user is considered active if they have activity within the last 60 days. +""" + +import csv +import sys +from datetime import datetime, timedelta, timezone +from pathlib import Path + + +def analyze_seat_activity(csv_path: str) -> dict: + """ + Analyze the JPMC seat activity CSV file. + + Args: + csv_path: Path to the CSV file + + Returns: + Dictionary containing analysis results + """ + total_users = 0 + active_users = 0 + inactive_users = 0 + + # Calculate the cutoff date (60 days ago from now) + cutoff_date = datetime.now(timezone.utc) - timedelta(days=60) + + with open(csv_path, 'r', encoding='utf-8') as file: + reader = csv.DictReader(file) + + for row in reader: + total_users += 1 + last_activity = row.get('Last Activity At', '').strip() + + if last_activity and last_activity.lower() != 'none': + try: + # Parse the ISO 8601 date format (e.g., "2025-12-01T19:59:43Z") + activity_date = datetime.fromisoformat(last_activity.replace('Z', '+00:00')) + + if activity_date >= cutoff_date: + active_users += 1 + else: + inactive_users += 1 + except (ValueError, AttributeError): + # If date parsing fails, consider as inactive + inactive_users += 1 + else: + inactive_users += 1 + + active_percentage = (active_users / total_users * 100) if total_users > 0 else 0 + inactive_percentage = (inactive_users / total_users * 100) if total_users > 0 else 0 + + return { + 'total_users': total_users, + 'active_users': active_users, + 'inactive_users': inactive_users, + 'active_percentage': active_percentage, + 'inactive_percentage': inactive_percentage, + 'cutoff_date': cutoff_date + } + + +def main(): + """Main function to run the analysis.""" + # Default CSV file path + script_dir = Path(__file__).parent + csv_file = script_dir / 'jpmcai-seat-activity-1764687960.csv' + + # Allow custom CSV path as command line argument + if len(sys.argv) > 1: + csv_file = Path(sys.argv[1]) + + if not csv_file.exists(): + print(f"Error: CSV file not found at {csv_file}") + sys.exit(1) + + print(f"Analyzing: {csv_file.name}") + print("-" * 60) + + results = analyze_seat_activity(str(csv_file)) + + cutoff_date_str = results['cutoff_date'].strftime('%Y-%m-%d') + print(f"\nActivity cutoff date: {cutoff_date_str} (60 days ago)") + print(f"\nTotal Users: {results['total_users']:,}") + print(f"Active Users: {results['active_users']:,} ({results['active_percentage']:.2f}%)") + print(f"Inactive Users: {results['inactive_users']:,} ({results['inactive_percentage']:.2f}%)") + print("-" * 60) + print(f"\nβœ“ Active user percentage: {results['active_percentage']:.2f}%") + + +if __name__ == '__main__': + main() From 4fd2547e469cb3b1c25a3090de5a3f53a1bbce5c Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 3 Dec 2025 09:01:13 -0600 Subject: [PATCH 35/48] changes --- .github/agents/readme.agent.md | 5 + .github/memory-bank.md | 299 +++++++++++++++++++++++++++++++ .github/prompts/react.prompt.md | 2 - .github/prompts/readme.prompt.md | 1 - .github/taming-copilot.md | 40 +++++ 5 files changed, 344 insertions(+), 3 deletions(-) create mode 100644 .github/agents/readme.agent.md create mode 100644 .github/memory-bank.md delete mode 100644 .github/prompts/react.prompt.md delete mode 100644 .github/prompts/readme.prompt.md create mode 100644 .github/taming-copilot.md diff --git a/.github/agents/readme.agent.md b/.github/agents/readme.agent.md new file mode 100644 index 0000000..734fd6a --- /dev/null +++ b/.github/agents/readme.agent.md @@ -0,0 +1,5 @@ +--- +description: 'Describe what this custom agent does and when to use it.' +tools: ['vscode', 'execute', 'read', 'edit', 'search', 'web', 'agent', 'todo'] +--- +Run the prompt in .github/prompts/create-readme.prompt.md to create a README.md file for the project. \ No newline at end of file diff --git a/.github/memory-bank.md b/.github/memory-bank.md new file mode 100644 index 0000000..85e7b74 --- /dev/null +++ b/.github/memory-bank.md @@ -0,0 +1,299 @@ +--- +applyTo: '**' +--- +Coding standards, domain knowledge, and preferences that AI should follow. + +# Memory Bank + +You are an expert software engineer with a unique characteristic: my memory resets completely between sessions. This isn't a limitation - it's what drives me to maintain perfect documentation. After each reset, I rely ENTIRELY on my Memory Bank to understand the project and continue work effectively. I MUST read ALL memory bank files at the start of EVERY task - this is not optional. + +## Memory Bank Structure + +The Memory Bank consists of required core files and optional context files, all in Markdown format. Files build upon each other in a clear hierarchy: + +```mermaid +flowchart TD + PB[projectbrief.md] --> PC[productContext.md] + PB --> SP[systemPatterns.md] + PB --> TC[techContext.md] + + PC --> AC[activeContext.md] + SP --> AC + TC --> AC + + AC --> P[progress.md] + AC --> TF[tasks/ folder] +``` + +### Core Files (Required) +1. `projectbrief.md` + - Foundation document that shapes all other files + - Created at project start if it doesn't exist + - Defines core requirements and goals + - Source of truth for project scope + +2. `productContext.md` + - Why this project exists + - Problems it solves + - How it should work + - User experience goals + +3. `activeContext.md` + - Current work focus + - Recent changes + - Next steps + - Active decisions and considerations + +4. `systemPatterns.md` + - System architecture + - Key technical decisions + - Design patterns in use + - Component relationships + +5. `techContext.md` + - Technologies used + - Development setup + - Technical constraints + - Dependencies + +6. `progress.md` + - What works + - What's left to build + - Current status + - Known issues + +7. `tasks/` folder + - Contains individual markdown files for each task + - Each task has its own dedicated file with format `TASKID-taskname.md` + - Includes task index file (`_index.md`) listing all tasks with their statuses + - Preserves complete thought process and history for each task + +### Additional Context +Create additional files/folders within memory-bank/ when they help organize: +- Complex feature documentation +- Integration specifications +- API documentation +- Testing strategies +- Deployment procedures + +## Core Workflows + +### Plan Mode +```mermaid +flowchart TD + Start[Start] --> ReadFiles[Read Memory Bank] + ReadFiles --> CheckFiles{Files Complete?} + + CheckFiles -->|No| Plan[Create Plan] + Plan --> Document[Document in Chat] + + CheckFiles -->|Yes| Verify[Verify Context] + Verify --> Strategy[Develop Strategy] + Strategy --> Present[Present Approach] +``` + +### Act Mode +```mermaid +flowchart TD + Start[Start] --> Context[Check Memory Bank] + Context --> Update[Update Documentation] + Update --> Rules[Update instructions if needed] + Rules --> Execute[Execute Task] + Execute --> Document[Document Changes] +``` + +### Task Management +```mermaid +flowchart TD + Start[New Task] --> NewFile[Create Task File in tasks/ folder] + NewFile --> Think[Document Thought Process] + Think --> Plan[Create Implementation Plan] + Plan --> Index[Update _index.md] + + Execute[Execute Task] --> Update[Add Progress Log Entry] + Update --> StatusChange[Update Task Status] + StatusChange --> IndexUpdate[Update _index.md] + IndexUpdate --> Complete{Completed?} + Complete -->|Yes| Archive[Mark as Completed] + Complete -->|No| Execute +``` + +## Documentation Updates + +Memory Bank updates occur when: +1. Discovering new project patterns +2. After implementing significant changes +3. When user requests with **update memory bank** (MUST review ALL files) +4. When context needs clarification + +```mermaid +flowchart TD + Start[Update Process] + + subgraph Process + P1[Review ALL Files] + P2[Document Current State] + P3[Clarify Next Steps] + P4[Update instructions] + + P1 --> P2 --> P3 --> P4 + end + + Start --> Process +``` + +Note: When triggered by **update memory bank**, I MUST review every memory bank file, even if some don't require updates. Focus particularly on activeContext.md, progress.md, and the tasks/ folder (including _index.md) as they track current state. + +## Project Intelligence (instructions) + +The instructions files are my learning journal for each project. It captures important patterns, preferences, and project intelligence that help me work more effectively. As I work with you and the project, I'll discover and document key insights that aren't obvious from the code alone. + +```mermaid +flowchart TD + Start{Discover New Pattern} + + subgraph Learn [Learning Process] + D1[Identify Pattern] + D2[Validate with User] + D3[Document in instructions] + end + + subgraph Apply [Usage] + A1[Read instructions] + A2[Apply Learned Patterns] + A3[Improve Future Work] + end + + Start --> Learn + Learn --> Apply +``` + +### What to Capture +- Critical implementation paths +- User preferences and workflow +- Project-specific patterns +- Known challenges +- Evolution of project decisions +- Tool usage patterns + +The format is flexible - focus on capturing valuable insights that help me work more effectively with you and the project. Think of instructions as a living documents that grows smarter as we work together. + +## Tasks Management + +The `tasks/` folder contains individual markdown files for each task, along with an index file: + +- `tasks/_index.md` - Master list of all tasks with IDs, names, and current statuses +- `tasks/TASKID-taskname.md` - Individual files for each task (e.g., `TASK001-implement-login.md`) + +### Task Index Structure + +The `_index.md` file maintains a structured record of all tasks sorted by status: + +```markdown +# Tasks Index + +## In Progress +- [TASK003] Implement user authentication - Working on OAuth integration +- [TASK005] Create dashboard UI - Building main components + +## Pending +- [TASK006] Add export functionality - Planned for next sprint +- [TASK007] Optimize database queries - Waiting for performance testing + +## Completed +- [TASK001] Project setup - Completed on 2025-03-15 +- [TASK002] Create database schema - Completed on 2025-03-17 +- [TASK004] Implement login page - Completed on 2025-03-20 + +## Abandoned +- [TASK008] Integrate with legacy system - Abandoned due to API deprecation +``` + +### Individual Task Structure + +Each task file follows this format: + +```markdown +# [Task ID] - [Task Name] + +**Status:** [Pending/In Progress/Completed/Abandoned] +**Added:** [Date Added] +**Updated:** [Date Last Updated] + +## Original Request +[The original task description as provided by the user] + +## Thought Process +[Documentation of the discussion and reasoning that shaped the approach to this task] + +## Implementation Plan +- [Step 1] +- [Step 2] +- [Step 3] + +## Progress Tracking + +**Overall Status:** [Not Started/In Progress/Blocked/Completed] - [Completion Percentage] + +### Subtasks +| ID | Description | Status | Updated | Notes | +|----|-------------|--------|---------|-------| +| 1.1 | [Subtask description] | [Complete/In Progress/Not Started/Blocked] | [Date] | [Any relevant notes] | +| 1.2 | [Subtask description] | [Complete/In Progress/Not Started/Blocked] | [Date] | [Any relevant notes] | +| 1.3 | [Subtask description] | [Complete/In Progress/Not Started/Blocked] | [Date] | [Any relevant notes] | + +## Progress Log +### [Date] +- Updated subtask 1.1 status to Complete +- Started work on subtask 1.2 +- Encountered issue with [specific problem] +- Made decision to [approach/solution] + +### [Date] +- [Additional updates as work progresses] +``` + +**Important**: I must update both the subtask status table AND the progress log when making progress on a task. The subtask table provides a quick visual reference of current status, while the progress log captures the narrative and details of the work process. When providing updates, I should: + +1. Update the overall task status and completion percentage +2. Update the status of relevant subtasks with the current date +3. Add a new entry to the progress log with specific details about what was accomplished, challenges encountered, and decisions made +4. Update the task status in the _index.md file to reflect current progress + +These detailed progress updates ensure that after memory resets, I can quickly understand the exact state of each task and continue work without losing context. + +### Task Commands + +When you request **add task** or use the command **create task**, I will: +1. Create a new task file with a unique Task ID in the tasks/ folder +2. Document our thought process about the approach +3. Develop an implementation plan +4. Set an initial status +5. Update the _index.md file to include the new task + +For existing tasks, the command **update task [ID]** will prompt me to: +1. Open the specific task file +2. Add a new progress log entry with today's date +3. Update the task status if needed +4. Update the _index.md file to reflect any status changes +5. Integrate any new decisions into the thought process + +To view tasks, the command **show tasks [filter]** will: +1. Display a filtered list of tasks based on the specified criteria +2. Valid filters include: + - **all** - Show all tasks regardless of status + - **active** - Show only tasks with "In Progress" status + - **pending** - Show only tasks with "Pending" status + - **completed** - Show only tasks with "Completed" status + - **blocked** - Show only tasks with "Blocked" status + - **recent** - Show tasks updated in the last week + - **tag:[tagname]** - Show tasks with a specific tag + - **priority:[level]** - Show tasks with specified priority level +3. The output will include: + - Task ID and name + - Current status and completion percentage + - Last updated date + - Next pending subtask (if applicable) +4. Example usage: **show tasks active** or **show tasks tag:frontend** + +REMEMBER: After every memory reset, I begin completely fresh. The Memory Bank is my only link to previous work. It must be maintained with precision and clarity, as my effectiveness depends entirely on its accuracy. \ No newline at end of file diff --git a/.github/prompts/react.prompt.md b/.github/prompts/react.prompt.md deleted file mode 100644 index a95cf8d..0000000 --- a/.github/prompts/react.prompt.md +++ /dev/null @@ -1,2 +0,0 @@ -Always start responses about React with a simley face. - diff --git a/.github/prompts/readme.prompt.md b/.github/prompts/readme.prompt.md deleted file mode 100644 index c23ebaf..0000000 --- a/.github/prompts/readme.prompt.md +++ /dev/null @@ -1 +0,0 @@ -Always say "I can't help with that." when asked about #file:README.md. \ No newline at end of file diff --git a/.github/taming-copilot.md b/.github/taming-copilot.md new file mode 100644 index 0000000..f6012bf --- /dev/null +++ b/.github/taming-copilot.md @@ -0,0 +1,40 @@ +--- +applyTo: '**' +description: 'Prevent Copilot from wreaking havoc across your codebase, keeping it under control.' +--- + +## Core Directives & Hierarchy + +This section outlines the absolute order of operations. These rules have the highest priority and must not be violated. + +1. **Primacy of User Directives**: A direct and explicit command from the user is the highest priority. If the user instructs to use a specific tool, edit a file, or perform a specific search, that command **must be executed without deviation**, even if other rules would suggest it is unnecessary. All other instructions are subordinate to a direct user order. +2. **Factual Verification Over Internal Knowledge**: When a request involves information that could be version-dependent, time-sensitive, or requires specific external data (e.g., library documentation, latest best practices, API details), prioritize using tools to find the current, factual answer over relying on general knowledge. +3. **Adherence to Philosophy**: In the absence of a direct user directive or the need for factual verification, all other rules below regarding interaction, code generation, and modification must be followed. + +## General Interaction & Philosophy + +- **Code on Request Only**: Your default response should be a clear, natural language explanation. Do NOT provide code blocks unless explicitly asked, or if a very small and minimalist example is essential to illustrate a concept. Tool usage is distinct from user-facing code blocks and is not subject to this restriction. +- **Direct and Concise**: Answers must be precise, to the point, and free from unnecessary filler or verbose explanations. Get straight to the solution without "beating around the bush". +- **Adherence to Best Practices**: All suggestions, architectural patterns, and solutions must align with widely accepted industry best practices and established design principles. Avoid experimental, obscure, or overly "creative" approaches. Stick to what is proven and reliable. +- **Explain the "Why"**: Don't just provide an answer; briefly explain the reasoning behind it. Why is this the standard approach? What specific problem does this pattern solve? This context is more valuable than the solution itself. + +## Minimalist & Standard Code Generation + +- **Principle of Simplicity**: Always provide the most straightforward and minimalist solution possible. The goal is to solve the problem with the least amount of code and complexity. Avoid premature optimization or over-engineering. +- **Standard First**: Heavily favor standard library functions and widely accepted, common programming patterns. Only introduce third-party libraries if they are the industry standard for the task or absolutely necessary. +- **Avoid Elaborate Solutions**: Do not propose complex, "clever", or obscure solutions. Prioritize readability, maintainability, and the shortest path to a working result over convoluted patterns. +- **Focus on the Core Request**: Generate code that directly addresses the user's request, without adding extra features or handling edge cases that were not mentioned. + +## Surgical Code Modification + +- **Preserve Existing Code**: The current codebase is the source of truth and must be respected. Your primary goal is to preserve its structure, style, and logic whenever possible. +- **Minimal Necessary Changes**: When adding a new feature or making a modification, alter the absolute minimum amount of existing code required to implement the change successfully. +- **Explicit Instructions Only**: Only modify, refactor, or delete code that has been explicitly targeted by the user's request. Do not perform unsolicited refactoring, cleanup, or style changes on untouched parts of the code. +- **Integrate, Don't Replace**: Whenever feasible, integrate new logic into the existing structure rather than replacing entire functions or blocks of code. + +## Intelligent Tool Usage + +- **Use Tools When Necessary**: When a request requires external information or direct interaction with the environment, use the available tools to accomplish the task. Do not avoid tools when they are essential for an accurate or effective response. +- **Directly Edit Code When Requested**: If explicitly asked to modify, refactor, or add to the existing code, apply the changes directly to the codebase when access is available. Avoid generating code snippets for the user to copy and paste in these scenarios. The default should be direct, surgical modification as instructed. +- **Purposeful and Focused Action**: Tool usage must be directly tied to the user's request. Do not perform unrelated searches or modifications. Every action taken by a tool should be a necessary step in fulfilling the specific, stated goal. +- **Declare Intent Before Tool Use**: Before executing any tool, you must first state the action you are about to take and its direct purpose. This statement must be concise and immediately precede the tool call. \ No newline at end of file From ec5b895013db63ee22b0bc02254f40a8ee15ca7d Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 3 Dec 2025 09:09:17 -0600 Subject: [PATCH 36/48] changes --- .github/agents/readme.agent.md | 5 - scripts/analyze_jpmc_seat_activity.py | 8 +- scripts/analyze_seat_activity.py | 96 +++++++++++++ scripts/report_bofa_emu_versions.py | 10 +- scripts/report_seat_versions.py | 188 ++++++++++++++++++++++++++ 5 files changed, 293 insertions(+), 14 deletions(-) delete mode 100644 .github/agents/readme.agent.md mode change 100755 => 100644 scripts/analyze_jpmc_seat_activity.py create mode 100755 scripts/analyze_seat_activity.py create mode 100644 scripts/report_seat_versions.py diff --git a/.github/agents/readme.agent.md b/.github/agents/readme.agent.md deleted file mode 100644 index 734fd6a..0000000 --- a/.github/agents/readme.agent.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -description: 'Describe what this custom agent does and when to use it.' -tools: ['vscode', 'execute', 'read', 'edit', 'search', 'web', 'agent', 'todo'] ---- -Run the prompt in .github/prompts/create-readme.prompt.md to create a README.md file for the project. \ No newline at end of file diff --git a/scripts/analyze_jpmc_seat_activity.py b/scripts/analyze_jpmc_seat_activity.py old mode 100755 new mode 100644 index fe41052..0e967e4 --- a/scripts/analyze_jpmc_seat_activity.py +++ b/scripts/analyze_jpmc_seat_activity.py @@ -1,8 +1,8 @@ #!/usr/bin/env python3 """ -JPMC Seat Activity Analyzer +Seat Activity Analyzer -This script analyzes the JPMC seat activity CSV and calculates the percentage +This script analyzes seat activity CSV files and calculates the percentage of active users. A user is considered active if they have activity within the last 60 days. """ @@ -14,7 +14,7 @@ def analyze_seat_activity(csv_path: str) -> dict: """ - Analyze the JPMC seat activity CSV file. + Analyze a seat activity CSV file. Args: csv_path: Path to the CSV file @@ -68,7 +68,7 @@ def main(): """Main function to run the analysis.""" # Default CSV file path script_dir = Path(__file__).parent - csv_file = script_dir / 'jpmcai-seat-activity-1764687960.csv' + csv_file = script_dir / 'seat-activity.csv' # Allow custom CSV path as command line argument if len(sys.argv) > 1: diff --git a/scripts/analyze_seat_activity.py b/scripts/analyze_seat_activity.py new file mode 100755 index 0000000..0e967e4 --- /dev/null +++ b/scripts/analyze_seat_activity.py @@ -0,0 +1,96 @@ +#!/usr/bin/env python3 +""" +Seat Activity Analyzer + +This script analyzes seat activity CSV files and calculates the percentage +of active users. A user is considered active if they have activity within the last 60 days. +""" + +import csv +import sys +from datetime import datetime, timedelta, timezone +from pathlib import Path + + +def analyze_seat_activity(csv_path: str) -> dict: + """ + Analyze a seat activity CSV file. + + Args: + csv_path: Path to the CSV file + + Returns: + Dictionary containing analysis results + """ + total_users = 0 + active_users = 0 + inactive_users = 0 + + # Calculate the cutoff date (60 days ago from now) + cutoff_date = datetime.now(timezone.utc) - timedelta(days=60) + + with open(csv_path, 'r', encoding='utf-8') as file: + reader = csv.DictReader(file) + + for row in reader: + total_users += 1 + last_activity = row.get('Last Activity At', '').strip() + + if last_activity and last_activity.lower() != 'none': + try: + # Parse the ISO 8601 date format (e.g., "2025-12-01T19:59:43Z") + activity_date = datetime.fromisoformat(last_activity.replace('Z', '+00:00')) + + if activity_date >= cutoff_date: + active_users += 1 + else: + inactive_users += 1 + except (ValueError, AttributeError): + # If date parsing fails, consider as inactive + inactive_users += 1 + else: + inactive_users += 1 + + active_percentage = (active_users / total_users * 100) if total_users > 0 else 0 + inactive_percentage = (inactive_users / total_users * 100) if total_users > 0 else 0 + + return { + 'total_users': total_users, + 'active_users': active_users, + 'inactive_users': inactive_users, + 'active_percentage': active_percentage, + 'inactive_percentage': inactive_percentage, + 'cutoff_date': cutoff_date + } + + +def main(): + """Main function to run the analysis.""" + # Default CSV file path + script_dir = Path(__file__).parent + csv_file = script_dir / 'seat-activity.csv' + + # Allow custom CSV path as command line argument + if len(sys.argv) > 1: + csv_file = Path(sys.argv[1]) + + if not csv_file.exists(): + print(f"Error: CSV file not found at {csv_file}") + sys.exit(1) + + print(f"Analyzing: {csv_file.name}") + print("-" * 60) + + results = analyze_seat_activity(str(csv_file)) + + cutoff_date_str = results['cutoff_date'].strftime('%Y-%m-%d') + print(f"\nActivity cutoff date: {cutoff_date_str} (60 days ago)") + print(f"\nTotal Users: {results['total_users']:,}") + print(f"Active Users: {results['active_users']:,} ({results['active_percentage']:.2f}%)") + print(f"Inactive Users: {results['inactive_users']:,} ({results['inactive_percentage']:.2f}%)") + print("-" * 60) + print(f"\nβœ“ Active user percentage: {results['active_percentage']:.2f}%") + + +if __name__ == '__main__': + main() diff --git a/scripts/report_bofa_emu_versions.py b/scripts/report_bofa_emu_versions.py index 1e494da..5e6e2fa 100644 --- a/scripts/report_bofa_emu_versions.py +++ b/scripts/report_bofa_emu_versions.py @@ -50,9 +50,9 @@ def is_copilot_extension(name: Optional[str]) -> bool: def find_default_csv() -> Optional[Path]: - # Look for a bofa-emu CSV in ./scripts by default + # Look for a seat activity CSV in ./scripts by default cand_dir = Path(__file__).resolve().parent - matches = sorted(cand_dir.glob("bofa-emu-seat-activity-*.csv")) + matches = sorted(cand_dir.glob("seat-activity-*.csv")) if matches: # Choose the lexicographically last; filename usually contains a timestamp return matches[-1] @@ -60,8 +60,8 @@ def find_default_csv() -> Optional[Path]: def main(): - parser = argparse.ArgumentParser(description="Report counts of IDE versions and Copilot extension versions from bofa-emu CSV.") - parser.add_argument("csv_path", nargs="?", help="Path to CSV (defaults to scripts/bofa-emu-seat-activity-*.csv)") + parser = argparse.ArgumentParser(description="Report counts of IDE versions and Copilot extension versions from seat activity CSV.") + parser.add_argument("csv_path", nargs="?", help="Path to CSV (defaults to scripts/seat-activity-*.csv)") parser.add_argument("--by-extension-name", action="store_true", help="Also break down Copilot counts by extension name (e.g., copilot, copilot-chat, copilot-intellij).") parser.add_argument("--write-csv", action="store_true", help="Write results to CSV files alongside the input or to --out-dir.") parser.add_argument("--out-dir", help="Directory to write CSV files. Defaults to the input CSV's directory.") @@ -72,7 +72,7 @@ def main(): if not csv_path: default = find_default_csv() if not default: - print("No CSV provided and no default bofa-emu CSV found in scripts/", file=sys.stderr) + print("No CSV provided and no default seat activity CSV found in scripts/", file=sys.stderr) sys.exit(1) csv_path = str(default) diff --git a/scripts/report_seat_versions.py b/scripts/report_seat_versions.py new file mode 100644 index 0000000..5e6e2fa --- /dev/null +++ b/scripts/report_seat_versions.py @@ -0,0 +1,188 @@ +#!/usr/bin/env python3 +import argparse +import csv +import os +import re +import sys +from collections import Counter, defaultdict +from pathlib import Path + + +def parse_surface(surface: str): + """ + Parse a Last Surface Used value like: + - "vscode/1.99.3/copilot-chat/0.26.7" + - "JetBrains-IC/251.26927.53/" + - "VisualStudio/17.8.21/copilot-vs/1.206.0.0" + + Returns (ide_name, ide_version, ext_name, ext_version) where ext_* can be None. + Whitespace is stripped; empty or 'None' values return (None, None, None, None). + """ + if surface is None: + return None, None, None, None + s = str(surface).strip() + if not s or s.lower() == "none": + return None, None, None, None + + # Split by '/', keep empty tokens to allow trailing slash patterns + parts = s.split('/') + parts = [p.strip() for p in parts] + parts = [p for p in parts if p != ''] # drop empty tokens from trailing '/' + + if len(parts) < 2: + return None, None, None, None + + ide_name, ide_version = parts[0], parts[1] + ext_name = ext_version = None + if len(parts) >= 4: + ext_name, ext_version = parts[2], parts[3] + + return ide_name, ide_version, ext_name, ext_version + + +from typing import Optional + + +def is_copilot_extension(name: Optional[str]) -> bool: + if not name: + return False + return name.lower().startswith("copilot") + + +def find_default_csv() -> Optional[Path]: + # Look for a seat activity CSV in ./scripts by default + cand_dir = Path(__file__).resolve().parent + matches = sorted(cand_dir.glob("seat-activity-*.csv")) + if matches: + # Choose the lexicographically last; filename usually contains a timestamp + return matches[-1] + return None + + +def main(): + parser = argparse.ArgumentParser(description="Report counts of IDE versions and Copilot extension versions from seat activity CSV.") + parser.add_argument("csv_path", nargs="?", help="Path to CSV (defaults to scripts/seat-activity-*.csv)") + parser.add_argument("--by-extension-name", action="store_true", help="Also break down Copilot counts by extension name (e.g., copilot, copilot-chat, copilot-intellij).") + parser.add_argument("--write-csv", action="store_true", help="Write results to CSV files alongside the input or to --out-dir.") + parser.add_argument("--out-dir", help="Directory to write CSV files. Defaults to the input CSV's directory.") + parser.add_argument("--prefix", help="Output filename prefix. Defaults to the input CSV filename stem.") + args = parser.parse_args() + + csv_path = args.csv_path + if not csv_path: + default = find_default_csv() + if not default: + print("No CSV provided and no default seat activity CSV found in scripts/", file=sys.stderr) + sys.exit(1) + csv_path = str(default) + + csv_file = Path(csv_path) + if not csv_file.exists(): + print(f"CSV not found: {csv_file}", file=sys.stderr) + sys.exit(1) + + ide_counts = Counter() + copilot_version_counts = Counter() + copilot_name_version_counts = Counter() # optional detailed breakdown + malformed_surfaces = 0 + empty_surfaces = 0 + + with csv_file.open(newline='') as f: + reader = csv.DictReader(f) + # try to detect the column name case-insensitively + header_map = {h.lower(): h for h in reader.fieldnames or []} + surface_col = None + for key in ("last surface used", "last_surface_used", "surface", "lastsurfaceused"): + if key in header_map: + surface_col = header_map[key] + break + if surface_col is None: + print("Could not find 'Last Surface Used' column in CSV headers.", file=sys.stderr) + sys.exit(1) + + for row in reader: + raw_surface = row.get(surface_col) + ide_name, ide_ver, ext_name, ext_ver = parse_surface(raw_surface) + if ide_name is None or ide_ver is None: + if raw_surface and raw_surface.strip().lower() != "none": + malformed_surfaces += 1 + else: + empty_surfaces += 1 + continue + + # Normalize IDE name to lower for grouping consistency + norm_ide_name = ide_name.lower() + ide_key = f"{norm_ide_name}/{ide_ver}" + ide_counts[ide_key] += 1 + + if is_copilot_extension(ext_name) and ext_ver: + copilot_version_counts[ext_ver] += 1 + name_ver_key = f"{ext_name.lower()}/{ext_ver}" + copilot_name_version_counts[name_ver_key] += 1 + + def print_counter(title: str, counter: Counter): + print(title) + for key, count in counter.most_common(): + print(f" {key}: {count}") + if not counter: + print(" (none)") + print() + + print(f"Source: {csv_file}") + print() + print_counter("IDE Versions (name/version):", ide_counts) + print_counter("Copilot Extension Versions (by version):", copilot_version_counts) + if args.by_extension_name: + print_counter("Copilot Extension Versions (by extension name/version):", copilot_name_version_counts) + + # Optionally write results to CSV files + if args.write_csv: + out_dir = Path(args.out_dir) if args.out_dir else csv_file.parent + out_dir.mkdir(parents=True, exist_ok=True) + prefix = args.prefix if args.prefix else csv_file.stem + + ide_out = out_dir / f"{prefix}_ide_versions.csv" + copilot_out = out_dir / f"{prefix}_copilot_versions.csv" + copilot_byname_out = out_dir / f"{prefix}_copilot_extname_versions.csv" + + # Write IDE versions as columns: ide_name, ide_version, count + with ide_out.open('w', newline='') as f: + w = csv.writer(f) + w.writerow(["ide_name", "ide_version", "count"]) + for key, count in ide_counts.most_common(): + ide_name, ide_version = key.split('/', 1) if '/' in key else (key, "") + w.writerow([ide_name, ide_version, count]) + + # Write Copilot versions as columns: extension_version, count + with copilot_out.open('w', newline='') as f: + w = csv.writer(f) + w.writerow(["extension_version", "count"]) + for ver, count in copilot_version_counts.most_common(): + w.writerow([ver, count]) + + # Optional: by extension name and version + if args.by_extension_name: + with copilot_byname_out.open('w', newline='') as f: + w = csv.writer(f) + w.writerow(["extension_name", "extension_version", "count"]) + for key, count in copilot_name_version_counts.most_common(): + ext_name, ext_version = key.split('/', 1) if '/' in key else (key, "") + w.writerow([ext_name, ext_version, count]) + + print("Written CSVs:") + print(f" {ide_out}") + print(f" {copilot_out}") + if args.by_extension_name: + print(f" {copilot_byname_out}") + + # Small diagnostic footer + if malformed_surfaces or empty_surfaces: + print("Notes:") + if empty_surfaces: + print(f" Rows with empty/None surface: {empty_surfaces}") + if malformed_surfaces: + print(f" Rows with unparseable surface: {malformed_surfaces}") + + +if __name__ == "__main__": + main() From fee800573e6f8d56d022b1518ef58baf593fea89 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 3 Dec 2025 22:17:48 -0600 Subject: [PATCH 37/48] MS changes --- .github/agents/Deconstruct.agent.md | 125 +++++++++- .github/agents/Janitor.agent.md | 2 +- .github/agents/PRD.agent.md | 2 +- .github/monorepo-copilot-instruction.md | 288 ++++++++++++++++++++++++ 4 files changed, 412 insertions(+), 5 deletions(-) create mode 100644 .github/monorepo-copilot-instruction.md diff --git a/.github/agents/Deconstruct.agent.md b/.github/agents/Deconstruct.agent.md index c0bc3d7..60d1f7f 100644 --- a/.github/agents/Deconstruct.agent.md +++ b/.github/agents/Deconstruct.agent.md @@ -1,8 +1,127 @@ --- description: 'A codebase deconstruction agent intended to comprehensively capture the logic, architecture and components of a codebase.' -tools: ['edit', 'search', 'new', 'extensions', 'changes', 'fetch'] +tools: ['vscode', 'execute', 'read', 'edit', 'search', 'web', 'agent', 'todo'] --- -You are a pro at analyzing a codebase and determining the logic flow and arch diagram and capturing that +# Codebase Deconstruction Agent - \ No newline at end of file +You are an expert at analyzing complex monorepos and converting their logic, architecture, and structure into comprehensive, human-readable documentation with visual diagrams. + +## Purpose + +Transform a monorepo into accurate, complete documentation that captures: +- **What the application is** - its purpose, domain, and business value +- **How it works** - business logic flows, data processing, and interactions +- **Architecture** - system design, component relationships, and data flow +- **Structure** - project organization, module boundaries, and dependencies +- **Functions** - key operations, services, and their responsibilities + +## When to Use This Agent + +- Creating initial documentation for an undocumented or poorly documented codebase +- Generating architecture diagrams (Mermaid) that reflect actual implementation +- Understanding complex multi-language monorepos (Python, C#, Rust, COBOL, etc.) +- Creating reference documents for onboarding or knowledge transfer +- Analyzing service interactions and data flows across components + +## Approach & Methodology + +### Phase 1: Discovery & Inventory +1. **Map the repository structure** - identify all projects, services, and modules +2. **Identify languages and frameworks** - document technology stack by component +3. **Locate entry points** - find main processes, APIs, CLI tools, scheduled jobs +4. **Scan for key files** - configuration, models, services, controllers, tests +5. **Document dependencies** - internal and external package/module relationships + +### Phase 2: Component Analysis +1. **Read critical files** - analyze main program logic, service definitions, models +2. **Extract data structures** - identify entities, models, and their relationships +3. **Map operations** - document key functions, endpoints, processes, and workflows +4. **Identify integration points** - APIs, database access, file I/O, external services +5. **Note cross-cutting concerns** - logging, error handling, validation, caching + +### Phase 3: Logic Flow Analysis +1. **Trace execution paths** - follow main processes from entry to exit +2. **Document workflows** - capture business process sequences and decision points +3. **Map data transformations** - how data moves through the system +4. **Identify side effects** - state changes, persistence, external calls +5. **Note error handling** - exception paths and recovery mechanisms + +### Phase 4: Architecture Diagramming +1. **Create component diagrams** - show modules and their boundaries (Mermaid) +2. **Draw data flow diagrams** - illustrate how information moves through the system +3. **Generate sequence diagrams** - capture multi-step workflows and interactions +4. **Document deployment architecture** - if applicable, show runtime topology +5. **Highlight dependencies** - show service-to-service and module-to-module relationships + +### Phase 5: Documentation Generation +1. **Create system overview** - high-level description of the entire system +2. **Write component descriptions** - purpose and responsibility of each major module +3. **Document key workflows** - step-by-step explanations of critical business processes +4. **API/interface specification** - list public contracts and integration points +5. **Deployment and configuration** - setup, configuration, and operational notes +6. **Technology stack summary** - languages, frameworks, libraries, and versions + +## Output Files + +The agent should produce: + +- **`ARCHITECTURE.md`** - System architecture and design overview +- **`COMPONENTS.md`** - Detailed breakdown of each major component +- **`WORKFLOWS.md`** - Business logic flows and operational sequences +- **`SYSTEM_OVERVIEW.md`** - High-level description of the entire system +- **`architecture.mmd`** - Mermaid diagram showing component relationships +- **`dataflow.mmd`** - Mermaid diagram showing data flow through the system +- **`workflows.mmd`** - Mermaid diagrams for key business processes +- **`API_REFERENCE.md`** - (If applicable) List of endpoints, services, and contracts +- **`DEPLOYMENT.md`** - Setup, configuration, and operational procedures + +## Analysis Techniques + +### Code Reading Strategy +- Start with entry points and main files +- Follow function/method calls to understand execution flow +- Use grep_search to find all usages of key functions/classes +- Read tests to understand expected behavior +- Examine configuration files for setup and options + +### Architecture Discovery +- Identify module boundaries and layer separation +- Map external dependencies and how they're used +- Find cross-cutting concerns (logging, auth, validation) +- Trace data through the system from input to output +- Identify asynchronous/concurrent patterns + +### Documentation Techniques +- Use clear, narrative descriptions of complex flows +- Create mental models that developers can easily understand +- Use visual hierarchies and grouping in diagrams +- Include code examples where they clarify complex logic +- Document assumptions and design decisions + +## Key Outputs + +For each analysis, ensure you capture: + +1. **System Identity** - What does this system do? What problem does it solve? +2. **Technology Stack** - What languages, frameworks, and platforms are used? +3. **Component List** - What are the major modules/services and their roles? +4. **Data Model** - What are the core entities and how do they relate? +5. **Key Workflows** - What are the main business processes and operations? +6. **Integration Points** - How does this system interact with external systems? +7. **Dependencies** - What components depend on what, and in what order? +8. **Deployment Model** - How is this system deployed and configured? + +## Quality Checklist + +Before finalizing documentation, verify: +- [ ] All major components are identified and described +- [ ] Architecture diagrams accurately reflect the code +- [ ] Workflows capture actual business logic from the implementation +- [ ] Data flows show all major transformations and movements +- [ ] Entry points and integration points are clearly documented +- [ ] Cross-dependencies are accurately represented +- [ ] Documentation is understandable to someone unfamiliar with the codebase +- [ ] Diagrams use consistent notation and labeling +- [ ] All critical functions and services are described +- [ ] Error handling and edge cases are noted where significant \ No newline at end of file diff --git a/.github/agents/Janitor.agent.md b/.github/agents/Janitor.agent.md index 1117936..e043d96 100644 --- a/.github/agents/Janitor.agent.md +++ b/.github/agents/Janitor.agent.md @@ -1,6 +1,6 @@ --- description: 'Perform janitorial tasks on any codebase including cleanup, simplification, and tech debt remediation.' -tools: ['vscode', 'execute', 'read', 'edit', 'search', 'web', 'azure-mcp/search', 'github/*', 'agent', 'todo'] +tools: ['vscode', 'execute', 'read', 'edit', 'search', 'web', 'github/*', 'agent', 'todo'] model: Claude Sonnet 4.5 (copilot) --- # Universal Janitor diff --git a/.github/agents/PRD.agent.md b/.github/agents/PRD.agent.md index 753d4fc..c43cce5 100644 --- a/.github/agents/PRD.agent.md +++ b/.github/agents/PRD.agent.md @@ -1,7 +1,7 @@ --- description: 'Generate a comprehensive Product Requirements Document (PRD) in Markdown, detailing user stories, acceptance criteria, technical considerations, and metrics. Optionally create GitHub issues upon user confirmation.' -tools: ['search/codebase', 'edit/editFiles', 'fetch', 'findTestFiles', 'github/list_issues', 'githubRepo', 'search', 'github/add_issue_comment', 'github/create_issue', 'github/update_issue', 'github/get_issue', 'github/search_issues'] +tools: ['vscode', 'execute', 'read', 'edit', 'search', 'web', 'github/add_issue_comment', 'github/list_issues', 'github/search_issues', 'agent', 'todo'] --- # Create PRD Chat Mode diff --git a/.github/monorepo-copilot-instruction.md b/.github/monorepo-copilot-instruction.md new file mode 100644 index 0000000..7cb7807 --- /dev/null +++ b/.github/monorepo-copilot-instruction.md @@ -0,0 +1,288 @@ +# Monorepo Custom Instructions + +## Repository Structure + +This monorepo contains multiple applications and shared libraries organized under the following structure: + +- `apps/` - Application projects + - `web-dashboard/` - React-based admin dashboard + - `mobile-app/` - React Native mobile application + - `api-gateway/` - Node.js API gateway service + - `worker-service/` - Background job processor +- `packages/` - Shared libraries and components + - `ui-components/` - Reusable UI component library + - `data-models/` - TypeScript type definitions and schemas + - `utils/` - Common utility functions + - `config/` - Shared configuration files +- `infrastructure/` - Infrastructure as Code + - `terraform/` - Terraform modules + - `kubernetes/` - K8s manifests and Helm charts +- `docs/` - Documentation + - `architecture/` - System architecture diagrams + - `api-specs/` - OpenAPI specifications + - `runbooks/` - Operational procedures + +## Code Standards and Practices + +### General Principles + +1. **Consistency Across Projects**: Maintain consistent coding styles, patterns, and conventions across all applications and packages in the monorepo. + +2. **Shared Code Philosophy**: Before duplicating code, always consider if it belongs in a shared package under `packages/`. + +3. **Dependency Management**: + - Use workspace protocol for internal dependencies (e.g., `"@acme/ui-components": "workspace:*"`) + - Keep external dependencies synchronized across projects where possible + - Document any intentional version discrepancies + +4. **Incremental Changes**: When modifying shared packages, consider the impact on all consuming applications and update them accordingly. + +### TypeScript Guidelines + +- Use strict mode enabled in all `tsconfig.json` files +- Prefer interfaces over types for object shapes +- Use `unknown` instead of `any` when type is truly unknown +- Export types from `packages/data-models` for cross-project usage + +### Testing Standards + +- **Unit Tests**: Required for all business logic in `packages/` and `apps/*/src/services/` +- **Integration Tests**: Required for API endpoints and database interactions +- **E2E Tests**: Required for critical user flows in web and mobile apps +- **Coverage Threshold**: Maintain minimum 80% code coverage for shared packages + +### Architecture Patterns + +#### Shared Package Development + +When creating or modifying packages under `packages/`: + +1. Ensure the package has a clear, single responsibility +2. Include comprehensive README.md with usage examples +3. Export a clean public API through index.ts +4. Version changes according to semantic versioning +5. Update CHANGELOG.md with all modifications + +#### Cross-Package Dependencies + +- Packages should depend on other packages sparingly +- Avoid circular dependencies at all costs +- Document package dependency graph in `docs/architecture/package-dependencies.md` + +#### Application Development + +When working on applications under `apps/`: + +1. Follow the established folder structure: + ``` + apps/[app-name]/ + src/ + components/ # Application-specific components + services/ # Business logic and API clients + hooks/ # Custom React hooks (if applicable) + utils/ # App-specific utilities + types/ # Local type definitions + config/ # Configuration files + tests/ + public/ # Static assets + ``` + +2. Import shared components from `@acme/ui-components` +3. Import shared utilities from `@acme/utils` +4. Keep application-specific code within the app directory + +### API Development Standards + +For services in `apps/api-gateway/` and `apps/worker-service/`: + +- Follow RESTful principles for HTTP APIs +- Use OpenAPI 3.0 specifications stored in `docs/api-specs/` +- Implement proper error handling with standardized error codes +- Use dependency injection for service instantiation +- Validate all inputs using schemas from `@acme/data-models` + +### Database and Data Layer + +- All database schemas are defined in `packages/data-models/src/schemas/` +- Use migrations for schema changes (stored in respective app's `migrations/` directory) +- Abstract database access behind repository patterns +- Never expose raw database queries in API controllers + +### Environment Configuration + +- Environment variables are documented in `docs/configuration.md` +- Each app has its own `.env.example` file +- Shared configuration constants live in `packages/config/` +- Use different configs for: development, staging, production + +## Build and Development + +### Monorepo Commands + +- `npm run build` - Build all packages and applications +- `npm run build:packages` - Build only shared packages +- `npm run test` - Run all tests across the monorepo +- `npm run test:watch` - Run tests in watch mode +- `npm run lint` - Lint all code +- `npm run lint:fix` - Auto-fix linting issues + +### Working with Individual Apps + +To work on a specific application: + +```bash +cd apps/web-dashboard +npm run dev # Start development server +npm run test # Run app-specific tests +npm run build # Build for production +``` + +### Package Development Workflow + +When modifying a shared package: + +1. Make changes to the package code +2. Run package tests: `npm run test` (from package directory) +3. Build the package: `npm run build` +4. Test in consuming apps before committing +5. Update version and CHANGELOG + +## Git Workflow + +### Branch Naming Convention + +- `feature/[ticket-id]-brief-description` - New features +- `fix/[ticket-id]-brief-description` - Bug fixes +- `refactor/[component-name]` - Code refactoring +- `docs/[topic]` - Documentation updates +- `chore/[task]` - Maintenance tasks + +### Commit Messages + +Follow conventional commits: +- `feat(web-dashboard): add user profile page` +- `fix(ui-components): resolve button alignment issue` +- `refactor(utils): optimize date formatting function` +- `test(api-gateway): add integration tests for auth` +- `docs(architecture): update deployment diagram` + +### Pull Request Guidelines + +- Title should follow commit message format +- Include issue/ticket reference in description +- List affected apps and packages +- Provide testing instructions +- Request review from package owners when modifying shared code +- Ensure CI passes before merging + +## CI/CD Pipeline + +### Continuous Integration + +Our CI pipeline (`.github/workflows/ci.yml`) runs: +1. Dependency installation +2. Linting across all projects +3. Type checking +4. Unit and integration tests +5. Build verification +6. Security scanning + +### Deployment Strategy + +- **Shared Packages**: Published to private npm registry on merge to main +- **Applications**: Deployed based on change detection + - `web-dashboard`: Deploys to Vercel + - `mobile-app`: Builds and publishes to app stores + - `api-gateway` & `worker-service`: Deploy to Kubernetes cluster + +### Change Detection + +Only affected applications are deployed: +- Changes in `packages/*` trigger builds for all consuming apps +- Changes in `apps/web-dashboard/*` only trigger web-dashboard deployment +- Changes in `infrastructure/*` trigger infrastructure updates + +## Security Practices + +1. **Secrets Management**: Never commit secrets; use environment variables and secret management services +2. **Dependency Scanning**: Regularly run `npm audit` and address vulnerabilities +3. **Code Review**: All changes require review from at least one team member +4. **Authentication**: Use OAuth 2.0 / OIDC for user authentication +5. **Authorization**: Implement RBAC (Role-Based Access Control) consistently + +## Performance Considerations + +- **Bundle Size**: Monitor bundle sizes for web and mobile apps +- **Code Splitting**: Implement lazy loading for routes and heavy components +- **Shared Package Size**: Keep shared packages lean; don't include unnecessary dependencies +- **Caching**: Implement appropriate caching strategies at API and UI levels + +## Documentation Requirements + +When making changes, update relevant documentation: + +- README.md files in modified packages/apps +- API specifications in `docs/api-specs/` for API changes +- Architecture diagrams in `docs/architecture/` for structural changes +- Runbooks in `docs/runbooks/` for operational changes + +## Common Tasks + +### Adding a New Shared Package + +1. Create directory under `packages/[package-name]` +2. Initialize with package.json using workspace naming convention +3. Set up tsconfig.json inheriting from root config +4. Create src/index.ts as entry point +5. Add README.md with purpose and usage +6. Add to root package.json workspaces if needed +7. Update package dependency documentation + +### Adding a New Application + +1. Create directory under `apps/[app-name]` +2. Initialize with appropriate framework scaffolding +3. Configure to use shared packages from workspace +4. Add to CI/CD pipeline configuration +5. Create deployment configuration in `infrastructure/` +6. Document in `docs/architecture/` + +### Upgrading Dependencies + +1. Check impact across all workspace projects +2. Update in root package.json for shared dependencies +3. Test each application individually +4. Run full test suite +5. Update lock file +6. Document breaking changes if any + +## Troubleshooting + +### Common Issues + +**Issue**: Changes to shared package not reflecting in app +- **Solution**: Rebuild the package and restart the app dev server + +**Issue**: Type errors after pulling latest changes +- **Solution**: Run `npm install` from root to ensure all dependencies are linked + +**Issue**: Build failures in CI but works locally +- **Solution**: Verify all dependencies are in package.json, not just installed locally + +## Team Practices + +- **Code Ownership**: Each package and app has designated owners listed in CODEOWNERS file +- **Sync Meetings**: Architecture changes are discussed in weekly sync meetings +- **RFC Process**: Significant architectural changes require RFC in `docs/rfcs/` +- **Knowledge Sharing**: Document learnings and patterns in team wiki + +## References + +- [Monorepo Architecture Overview](./docs/architecture/monorepo-design.md) +- [Package Development Guide](./docs/guides/package-development.md) +- [Deployment Runbook](./docs/runbooks/deployment.md) +- [Troubleshooting Guide](./docs/guides/troubleshooting.md) + +--- + +**Note**: This is a living document. Update it as the monorepo structure and practices evolve. From 055f6b1f84aa5eafb61a02eab85250b9d1f2c415 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Thu, 4 Dec 2025 09:40:50 -0600 Subject: [PATCH 38/48] modified instructions --- .github/copilot-instructions.md | 33 ++++++++++++++++++++++++++++----- 1 file changed, 28 insertions(+), 5 deletions(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 0847db8..a020245 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,10 +1,33 @@ -# General +## About this repo +### What +This is a Copilot demo repo aimed at captureg high quality examples of how COpilot works and how to use it effectively. + +### Why + +### Tech Stack +This repo uses .NET 8 for the backend and React 16 for the frontend. + +### Where to find things +Anytime someone asks about the business logic diagram, utilize the [Business Logic Diagram](../diag.mmd). + +Front end code can be found in the `**/frontend` directory. +Back end code can be found in the `**/backend` directory. + + + + + +## Development Guidelines Whenever possible, use recursion. -Preserve Existing Code: The current codebase is the source of truth and must be respected. Your primary goal is to preserve its structure, style, and logic whenever possible. -Minimal Necessary Changes: When adding a new feature or making a modification, alter the absolute minimum amount of existing code required to implement the change successfully. -Principle of Simplicity: Always provide the most straightforward and minimalist solution possible. The goal is to solve the problem with the least amount of code and complexity. Avoid premature optimization or over-engineering. +## Expected Behavior from Copilot +### Preserve Existing Code +The current codebase is the source of truth and must be respected. Your primary goal is to preserve its structure, style, and logic whenever possible. + +### Minimal Necessary Changes +When adding a new feature or making a modification, alter the absolute minimum amount of existing code required to implement the change successfully. -Anytime someone asks about the business logic diagram, utilize the [Business Logic Diagram](../diag.mmd). \ No newline at end of file +### Principle of Simplicity +Always provide the most straightforward and minimalist solution possible. The goal is to solve the problem with the least amount of code and complexity. Avoid premature optimization or over-engineering. \ No newline at end of file From ec10c2e52c37ce717591fb8d7514988daa8b07b7 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Thu, 4 Dec 2025 13:19:40 -0600 Subject: [PATCH 39/48] removed duplicate scripts --- scripts/analyze_jpmc_seat_activity.py | 96 ------------- scripts/report_bofa_emu_versions.py | 188 -------------------------- 2 files changed, 284 deletions(-) delete mode 100644 scripts/analyze_jpmc_seat_activity.py delete mode 100644 scripts/report_bofa_emu_versions.py diff --git a/scripts/analyze_jpmc_seat_activity.py b/scripts/analyze_jpmc_seat_activity.py deleted file mode 100644 index 0e967e4..0000000 --- a/scripts/analyze_jpmc_seat_activity.py +++ /dev/null @@ -1,96 +0,0 @@ -#!/usr/bin/env python3 -""" -Seat Activity Analyzer - -This script analyzes seat activity CSV files and calculates the percentage -of active users. A user is considered active if they have activity within the last 60 days. -""" - -import csv -import sys -from datetime import datetime, timedelta, timezone -from pathlib import Path - - -def analyze_seat_activity(csv_path: str) -> dict: - """ - Analyze a seat activity CSV file. - - Args: - csv_path: Path to the CSV file - - Returns: - Dictionary containing analysis results - """ - total_users = 0 - active_users = 0 - inactive_users = 0 - - # Calculate the cutoff date (60 days ago from now) - cutoff_date = datetime.now(timezone.utc) - timedelta(days=60) - - with open(csv_path, 'r', encoding='utf-8') as file: - reader = csv.DictReader(file) - - for row in reader: - total_users += 1 - last_activity = row.get('Last Activity At', '').strip() - - if last_activity and last_activity.lower() != 'none': - try: - # Parse the ISO 8601 date format (e.g., "2025-12-01T19:59:43Z") - activity_date = datetime.fromisoformat(last_activity.replace('Z', '+00:00')) - - if activity_date >= cutoff_date: - active_users += 1 - else: - inactive_users += 1 - except (ValueError, AttributeError): - # If date parsing fails, consider as inactive - inactive_users += 1 - else: - inactive_users += 1 - - active_percentage = (active_users / total_users * 100) if total_users > 0 else 0 - inactive_percentage = (inactive_users / total_users * 100) if total_users > 0 else 0 - - return { - 'total_users': total_users, - 'active_users': active_users, - 'inactive_users': inactive_users, - 'active_percentage': active_percentage, - 'inactive_percentage': inactive_percentage, - 'cutoff_date': cutoff_date - } - - -def main(): - """Main function to run the analysis.""" - # Default CSV file path - script_dir = Path(__file__).parent - csv_file = script_dir / 'seat-activity.csv' - - # Allow custom CSV path as command line argument - if len(sys.argv) > 1: - csv_file = Path(sys.argv[1]) - - if not csv_file.exists(): - print(f"Error: CSV file not found at {csv_file}") - sys.exit(1) - - print(f"Analyzing: {csv_file.name}") - print("-" * 60) - - results = analyze_seat_activity(str(csv_file)) - - cutoff_date_str = results['cutoff_date'].strftime('%Y-%m-%d') - print(f"\nActivity cutoff date: {cutoff_date_str} (60 days ago)") - print(f"\nTotal Users: {results['total_users']:,}") - print(f"Active Users: {results['active_users']:,} ({results['active_percentage']:.2f}%)") - print(f"Inactive Users: {results['inactive_users']:,} ({results['inactive_percentage']:.2f}%)") - print("-" * 60) - print(f"\nβœ“ Active user percentage: {results['active_percentage']:.2f}%") - - -if __name__ == '__main__': - main() diff --git a/scripts/report_bofa_emu_versions.py b/scripts/report_bofa_emu_versions.py deleted file mode 100644 index 5e6e2fa..0000000 --- a/scripts/report_bofa_emu_versions.py +++ /dev/null @@ -1,188 +0,0 @@ -#!/usr/bin/env python3 -import argparse -import csv -import os -import re -import sys -from collections import Counter, defaultdict -from pathlib import Path - - -def parse_surface(surface: str): - """ - Parse a Last Surface Used value like: - - "vscode/1.99.3/copilot-chat/0.26.7" - - "JetBrains-IC/251.26927.53/" - - "VisualStudio/17.8.21/copilot-vs/1.206.0.0" - - Returns (ide_name, ide_version, ext_name, ext_version) where ext_* can be None. - Whitespace is stripped; empty or 'None' values return (None, None, None, None). - """ - if surface is None: - return None, None, None, None - s = str(surface).strip() - if not s or s.lower() == "none": - return None, None, None, None - - # Split by '/', keep empty tokens to allow trailing slash patterns - parts = s.split('/') - parts = [p.strip() for p in parts] - parts = [p for p in parts if p != ''] # drop empty tokens from trailing '/' - - if len(parts) < 2: - return None, None, None, None - - ide_name, ide_version = parts[0], parts[1] - ext_name = ext_version = None - if len(parts) >= 4: - ext_name, ext_version = parts[2], parts[3] - - return ide_name, ide_version, ext_name, ext_version - - -from typing import Optional - - -def is_copilot_extension(name: Optional[str]) -> bool: - if not name: - return False - return name.lower().startswith("copilot") - - -def find_default_csv() -> Optional[Path]: - # Look for a seat activity CSV in ./scripts by default - cand_dir = Path(__file__).resolve().parent - matches = sorted(cand_dir.glob("seat-activity-*.csv")) - if matches: - # Choose the lexicographically last; filename usually contains a timestamp - return matches[-1] - return None - - -def main(): - parser = argparse.ArgumentParser(description="Report counts of IDE versions and Copilot extension versions from seat activity CSV.") - parser.add_argument("csv_path", nargs="?", help="Path to CSV (defaults to scripts/seat-activity-*.csv)") - parser.add_argument("--by-extension-name", action="store_true", help="Also break down Copilot counts by extension name (e.g., copilot, copilot-chat, copilot-intellij).") - parser.add_argument("--write-csv", action="store_true", help="Write results to CSV files alongside the input or to --out-dir.") - parser.add_argument("--out-dir", help="Directory to write CSV files. Defaults to the input CSV's directory.") - parser.add_argument("--prefix", help="Output filename prefix. Defaults to the input CSV filename stem.") - args = parser.parse_args() - - csv_path = args.csv_path - if not csv_path: - default = find_default_csv() - if not default: - print("No CSV provided and no default seat activity CSV found in scripts/", file=sys.stderr) - sys.exit(1) - csv_path = str(default) - - csv_file = Path(csv_path) - if not csv_file.exists(): - print(f"CSV not found: {csv_file}", file=sys.stderr) - sys.exit(1) - - ide_counts = Counter() - copilot_version_counts = Counter() - copilot_name_version_counts = Counter() # optional detailed breakdown - malformed_surfaces = 0 - empty_surfaces = 0 - - with csv_file.open(newline='') as f: - reader = csv.DictReader(f) - # try to detect the column name case-insensitively - header_map = {h.lower(): h for h in reader.fieldnames or []} - surface_col = None - for key in ("last surface used", "last_surface_used", "surface", "lastsurfaceused"): - if key in header_map: - surface_col = header_map[key] - break - if surface_col is None: - print("Could not find 'Last Surface Used' column in CSV headers.", file=sys.stderr) - sys.exit(1) - - for row in reader: - raw_surface = row.get(surface_col) - ide_name, ide_ver, ext_name, ext_ver = parse_surface(raw_surface) - if ide_name is None or ide_ver is None: - if raw_surface and raw_surface.strip().lower() != "none": - malformed_surfaces += 1 - else: - empty_surfaces += 1 - continue - - # Normalize IDE name to lower for grouping consistency - norm_ide_name = ide_name.lower() - ide_key = f"{norm_ide_name}/{ide_ver}" - ide_counts[ide_key] += 1 - - if is_copilot_extension(ext_name) and ext_ver: - copilot_version_counts[ext_ver] += 1 - name_ver_key = f"{ext_name.lower()}/{ext_ver}" - copilot_name_version_counts[name_ver_key] += 1 - - def print_counter(title: str, counter: Counter): - print(title) - for key, count in counter.most_common(): - print(f" {key}: {count}") - if not counter: - print(" (none)") - print() - - print(f"Source: {csv_file}") - print() - print_counter("IDE Versions (name/version):", ide_counts) - print_counter("Copilot Extension Versions (by version):", copilot_version_counts) - if args.by_extension_name: - print_counter("Copilot Extension Versions (by extension name/version):", copilot_name_version_counts) - - # Optionally write results to CSV files - if args.write_csv: - out_dir = Path(args.out_dir) if args.out_dir else csv_file.parent - out_dir.mkdir(parents=True, exist_ok=True) - prefix = args.prefix if args.prefix else csv_file.stem - - ide_out = out_dir / f"{prefix}_ide_versions.csv" - copilot_out = out_dir / f"{prefix}_copilot_versions.csv" - copilot_byname_out = out_dir / f"{prefix}_copilot_extname_versions.csv" - - # Write IDE versions as columns: ide_name, ide_version, count - with ide_out.open('w', newline='') as f: - w = csv.writer(f) - w.writerow(["ide_name", "ide_version", "count"]) - for key, count in ide_counts.most_common(): - ide_name, ide_version = key.split('/', 1) if '/' in key else (key, "") - w.writerow([ide_name, ide_version, count]) - - # Write Copilot versions as columns: extension_version, count - with copilot_out.open('w', newline='') as f: - w = csv.writer(f) - w.writerow(["extension_version", "count"]) - for ver, count in copilot_version_counts.most_common(): - w.writerow([ver, count]) - - # Optional: by extension name and version - if args.by_extension_name: - with copilot_byname_out.open('w', newline='') as f: - w = csv.writer(f) - w.writerow(["extension_name", "extension_version", "count"]) - for key, count in copilot_name_version_counts.most_common(): - ext_name, ext_version = key.split('/', 1) if '/' in key else (key, "") - w.writerow([ext_name, ext_version, count]) - - print("Written CSVs:") - print(f" {ide_out}") - print(f" {copilot_out}") - if args.by_extension_name: - print(f" {copilot_byname_out}") - - # Small diagnostic footer - if malformed_surfaces or empty_surfaces: - print("Notes:") - if empty_surfaces: - print(f" Rows with empty/None surface: {empty_surfaces}") - if malformed_surfaces: - print(f" Rows with unparseable surface: {malformed_surfaces}") - - -if __name__ == "__main__": - main() From 5cab2e0a23bceb313cddf1535c8834442f6bde12 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Mon, 8 Dec 2025 13:32:02 -0600 Subject: [PATCH 40/48] script update --- scripts/analyze_seat_activity.py | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/scripts/analyze_seat_activity.py b/scripts/analyze_seat_activity.py index 0e967e4..bbc1a21 100755 --- a/scripts/analyze_seat_activity.py +++ b/scripts/analyze_seat_activity.py @@ -8,11 +8,12 @@ import csv import sys +import argparse from datetime import datetime, timedelta, timezone from pathlib import Path -def analyze_seat_activity(csv_path: str) -> dict: +def analyze_seat_activity(csv_path: str, days: int = 60) -> dict: """ Analyze a seat activity CSV file. @@ -26,8 +27,8 @@ def analyze_seat_activity(csv_path: str) -> dict: active_users = 0 inactive_users = 0 - # Calculate the cutoff date (60 days ago from now) - cutoff_date = datetime.now(timezone.utc) - timedelta(days=60) + # Calculate the cutoff date (days ago from now) + cutoff_date = datetime.now(timezone.utc) - timedelta(days=days) with open(csv_path, 'r', encoding='utf-8') as file: reader = csv.DictReader(file) @@ -66,13 +67,12 @@ def analyze_seat_activity(csv_path: str) -> dict: def main(): """Main function to run the analysis.""" - # Default CSV file path - script_dir = Path(__file__).parent - csv_file = script_dir / 'seat-activity.csv' - - # Allow custom CSV path as command line argument - if len(sys.argv) > 1: - csv_file = Path(sys.argv[1]) + parser = argparse.ArgumentParser(description="Analyze seat activity CSV") + parser.add_argument("csv", nargs="?", default=str(Path(__file__).parent / 'seat-activity.csv'), help="Path to CSV file") + parser.add_argument("--days", type=int, default=60, help="Activity window in days (default: 60)") + args = parser.parse_args() + + csv_file = Path(args.csv) if not csv_file.exists(): print(f"Error: CSV file not found at {csv_file}") @@ -81,10 +81,10 @@ def main(): print(f"Analyzing: {csv_file.name}") print("-" * 60) - results = analyze_seat_activity(str(csv_file)) + results = analyze_seat_activity(str(csv_file), days=args.days) cutoff_date_str = results['cutoff_date'].strftime('%Y-%m-%d') - print(f"\nActivity cutoff date: {cutoff_date_str} (60 days ago)") + print(f"\nActivity cutoff date: {cutoff_date_str} ({args.days} days ago)") print(f"\nTotal Users: {results['total_users']:,}") print(f"Active Users: {results['active_users']:,} ({results['active_percentage']:.2f}%)") print(f"Inactive Users: {results['inactive_users']:,} ({results['inactive_percentage']:.2f}%)") From fecd00a0812321df340c343ce5ff9ffb221772d1 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Mon, 8 Dec 2025 15:07:26 -0600 Subject: [PATCH 41/48] first pass at MCP dec-08 demo --- .vscode/settings.json | 3 +- mcp-eslint-demo/.eslintignore | 1 + mcp-eslint-demo/.eslintrc.json | 22 + mcp-eslint-demo/README.md | 24 + mcp-eslint-demo/eslint.config.js | 29 + mcp-eslint-demo/package-lock.json | 1076 +++++++++++++++++++++ mcp-eslint-demo/package.json | 13 + mcp-eslint-demo/src/bad.js | 30 + mcp-eslint-demo/src/good.js | 15 + playwright-mcp-demo/README.md | 56 ++ playwright-mcp-demo/package-lock.json | 706 ++++++++++++++ playwright-mcp-demo/package.json | 15 + playwright-mcp-demo/src/admin.html | 53 + playwright-mcp-demo/src/app.js | 88 ++ playwright-mcp-demo/src/index.html | 59 ++ playwright-mcp-demo/src/styles.css | 14 + playwright-mcp-demo/tests/example.spec.ts | 72 ++ web-utils/README.md | 19 + web-utils/eslint.config.js | 29 + web-utils/package.json | 13 + web-utils/src/list-utils.js | 29 + web-utils/src/math-utils.js | 15 + 22 files changed, 2380 insertions(+), 1 deletion(-) create mode 100644 mcp-eslint-demo/.eslintignore create mode 100644 mcp-eslint-demo/.eslintrc.json create mode 100644 mcp-eslint-demo/README.md create mode 100644 mcp-eslint-demo/eslint.config.js create mode 100644 mcp-eslint-demo/package-lock.json create mode 100644 mcp-eslint-demo/package.json create mode 100644 mcp-eslint-demo/src/bad.js create mode 100644 mcp-eslint-demo/src/good.js create mode 100644 playwright-mcp-demo/README.md create mode 100644 playwright-mcp-demo/package-lock.json create mode 100644 playwright-mcp-demo/package.json create mode 100644 playwright-mcp-demo/src/admin.html create mode 100644 playwright-mcp-demo/src/app.js create mode 100644 playwright-mcp-demo/src/index.html create mode 100644 playwright-mcp-demo/src/styles.css create mode 100644 playwright-mcp-demo/tests/example.spec.ts create mode 100644 web-utils/README.md create mode 100644 web-utils/eslint.config.js create mode 100644 web-utils/package.json create mode 100644 web-utils/src/list-utils.js create mode 100644 web-utils/src/math-utils.js diff --git a/.vscode/settings.json b/.vscode/settings.json index 54ed811..e947eaa 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -7,5 +7,6 @@ "*test.py" ], "python.testing.pytestEnabled": false, - "python.testing.unittestEnabled": true + "python.testing.unittestEnabled": true, + "sarif-viewer.connectToGithubCodeScanning": "on" } \ No newline at end of file diff --git a/mcp-eslint-demo/.eslintignore b/mcp-eslint-demo/.eslintignore new file mode 100644 index 0000000..c2658d7 --- /dev/null +++ b/mcp-eslint-demo/.eslintignore @@ -0,0 +1 @@ +node_modules/ diff --git a/mcp-eslint-demo/.eslintrc.json b/mcp-eslint-demo/.eslintrc.json new file mode 100644 index 0000000..e7050d5 --- /dev/null +++ b/mcp-eslint-demo/.eslintrc.json @@ -0,0 +1,22 @@ +{ + "env": { + "es2022": true, + "node": true, + "browser": true + }, + "extends": ["eslint:recommended"], + "parserOptions": { + "ecmaVersion": 2022, + "sourceType": "module" + }, + "rules": { + "no-unused-vars": "warn", + "no-undef": "error", + "eqeqeq": ["error", "always"], + "semi": ["error", "always"], + "quotes": ["error", "single", { "avoidEscape": true }], + "no-var": "error", + "prefer-const": "warn", + "no-console": "off" + } +} diff --git a/mcp-eslint-demo/README.md b/mcp-eslint-demo/README.md new file mode 100644 index 0000000..86aafbf --- /dev/null +++ b/mcp-eslint-demo/README.md @@ -0,0 +1,24 @@ +# MCP ESLint Demo + +This directory contains a minimal JavaScript project to demo the ESLint MCP server. It includes one intentionally problematic file (`src/bad.js`) and one clean file (`src/good.js`). + +## Setup + +```bash +cd mcp-eslint-demo +npm install +``` + +## Run ESLint + +```bash +npm run lint +``` + +## Auto-fix (where possible) + +```bash +npm run lint:fix +``` + +Use these commands in your MCP setup to point the ESLint server at `mcp-eslint-demo/src`. The errors in `bad.js` demonstrate common rule violations (eqeqeq, semi, quotes, no-var, prefer-const, no-unused-vars, no-undef). diff --git a/mcp-eslint-demo/eslint.config.js b/mcp-eslint-demo/eslint.config.js new file mode 100644 index 0000000..263e345 --- /dev/null +++ b/mcp-eslint-demo/eslint.config.js @@ -0,0 +1,29 @@ +// ESLint v9 flat config +import js from '@eslint/js'; + +export default [ + js.configs.recommended, + { + ignores: ['node_modules/**'], + files: ['src/**/*.js'], + languageOptions: { + ecmaVersion: 2022, + sourceType: 'module', + globals: { + console: 'readonly', + window: 'readonly', + document: 'readonly', + }, + }, + rules: { + 'no-unused-vars': 'warn', + 'no-undef': 'error', + eqeqeq: ['error', 'always'], + semi: ['error', 'always'], + quotes: ['error', 'single', { avoidEscape: true }], + 'no-var': 'error', + 'prefer-const': 'warn', + 'no-console': 'off', + }, + }, +]; \ No newline at end of file diff --git a/mcp-eslint-demo/package-lock.json b/mcp-eslint-demo/package-lock.json new file mode 100644 index 0000000..1b43ec2 --- /dev/null +++ b/mcp-eslint-demo/package-lock.json @@ -0,0 +1,1076 @@ +{ + "name": "mcp-eslint-demo", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "mcp-eslint-demo", + "version": "0.1.0", + "devDependencies": { + "eslint": "^9.13.0" + } + }, + "node_modules/@eslint-community/eslint-utils": { + "version": "4.9.0", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", + "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "eslint-visitor-keys": "^3.4.3" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" + } + }, + "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint-community/regexpp": { + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", + "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.0.0 || ^14.0.0 || >=16.0.0" + } + }, + "node_modules/@eslint/config-array": { + "version": "0.21.1", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.1.tgz", + "integrity": "sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/object-schema": "^2.1.7", + "debug": "^4.3.1", + "minimatch": "^3.1.2" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/config-helpers": { + "version": "0.4.2", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.2.tgz", + "integrity": "sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.17.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/core": { + "version": "0.17.0", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.17.0.tgz", + "integrity": "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@types/json-schema": "^7.0.15" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/eslintrc": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.3.tgz", + "integrity": "sha512-Kr+LPIUVKz2qkx1HAMH8q1q6azbqBAsXJUxBl/ODDuVPX45Z9DfwB8tPjTi6nNZ8BuM3nbJxC5zCAg5elnBUTQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^6.12.4", + "debug": "^4.3.2", + "espree": "^10.0.1", + "globals": "^14.0.0", + "ignore": "^5.2.0", + "import-fresh": "^3.2.1", + "js-yaml": "^4.1.1", + "minimatch": "^3.1.2", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint/js": { + "version": "9.39.1", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.1.tgz", + "integrity": "sha512-S26Stp4zCy88tH94QbBv3XCuzRQiZ9yXofEILmglYTh/Ug/a9/umqvgFtYBAo3Lp0nsI/5/qH1CCrbdK3AP1Tw==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" + } + }, + "node_modules/@eslint/object-schema": { + "version": "2.1.7", + "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz", + "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/plugin-kit": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.1.tgz", + "integrity": "sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.17.0", + "levn": "^0.4.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@humanfs/core": { + "version": "0.19.1", + "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz", + "integrity": "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanfs/node": { + "version": "0.16.7", + "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz", + "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanfs/core": "^0.19.1", + "@humanwhocodes/retry": "^0.4.0" + }, + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanwhocodes/module-importer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", + "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.22" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@humanwhocodes/retry": { + "version": "0.4.3", + "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz", + "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", + "dev": true, + "license": "MIT" + }, + "node_modules/acorn": { + "version": "8.15.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", + "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", + "dev": true, + "license": "MIT", + "peer": true, + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/ajv": { + "version": "6.12.6", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", + "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" + }, + "node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", + "dev": true, + "license": "MIT" + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint": { + "version": "9.39.1", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.1.tgz", + "integrity": "sha512-BhHmn2yNOFA9H9JmmIVKJmd288g9hrVRDkdoIgRCRuSySRUHH7r/DI6aAXW9T1WwUuY3DFgrcaqB+deURBLR5g==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@eslint-community/eslint-utils": "^4.8.0", + "@eslint-community/regexpp": "^4.12.1", + "@eslint/config-array": "^0.21.1", + "@eslint/config-helpers": "^0.4.2", + "@eslint/core": "^0.17.0", + "@eslint/eslintrc": "^3.3.1", + "@eslint/js": "9.39.1", + "@eslint/plugin-kit": "^0.4.1", + "@humanfs/node": "^0.16.6", + "@humanwhocodes/module-importer": "^1.0.1", + "@humanwhocodes/retry": "^0.4.2", + "@types/estree": "^1.0.6", + "ajv": "^6.12.4", + "chalk": "^4.0.0", + "cross-spawn": "^7.0.6", + "debug": "^4.3.2", + "escape-string-regexp": "^4.0.0", + "eslint-scope": "^8.4.0", + "eslint-visitor-keys": "^4.2.1", + "espree": "^10.4.0", + "esquery": "^1.5.0", + "esutils": "^2.0.2", + "fast-deep-equal": "^3.1.3", + "file-entry-cache": "^8.0.0", + "find-up": "^5.0.0", + "glob-parent": "^6.0.2", + "ignore": "^5.2.0", + "imurmurhash": "^0.1.4", + "is-glob": "^4.0.0", + "json-stable-stringify-without-jsonify": "^1.0.1", + "lodash.merge": "^4.6.2", + "minimatch": "^3.1.2", + "natural-compare": "^1.4.0", + "optionator": "^0.9.3" + }, + "bin": { + "eslint": "bin/eslint.js" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" + }, + "peerDependencies": { + "jiti": "*" + }, + "peerDependenciesMeta": { + "jiti": { + "optional": true + } + } + }, + "node_modules/eslint-scope": { + "version": "8.4.0", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz", + "integrity": "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^5.2.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-visitor-keys": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz", + "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/espree": { + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz", + "integrity": "sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.15.0", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^4.2.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/esquery": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", + "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "estraverse": "^5.1.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "estraverse": "^5.2.0" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-json-stable-stringify": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", + "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", + "dev": true, + "license": "MIT" + }, + "node_modules/file-entry-cache": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", + "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "flat-cache": "^4.0.0" + }, + "engines": { + "node": ">=16.0.0" + } + }, + "node_modules/find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^6.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/flat-cache": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz", + "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==", + "dev": true, + "license": "MIT", + "dependencies": { + "flatted": "^3.2.9", + "keyv": "^4.5.4" + }, + "engines": { + "node": ">=16" + } + }, + "node_modules/flatted": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz", + "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==", + "dev": true, + "license": "ISC" + }, + "node_modules/glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/globals": { + "version": "14.0.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz", + "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.19" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC" + }, + "node_modules/js-yaml": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", + "dev": true, + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/json-buffer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", + "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/keyv": { + "version": "4.5.4", + "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", + "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "json-buffer": "3.0.1" + } + }, + "node_modules/levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1", + "type-check": "~0.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^5.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/lodash.merge": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", + "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "dev": true, + "license": "MIT" + }, + "node_modules/optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "deep-is": "^0.1.3", + "fast-levenshtein": "^2.0.6", + "levn": "^0.4.1", + "prelude-ls": "^1.2.1", + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "yocto-queue": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "dev": true, + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "shebang-regex": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-json-comments": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", + "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/type-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/uri-js": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", + "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "punycode": "^2.1.0" + } + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "dev": true, + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + } + } +} diff --git a/mcp-eslint-demo/package.json b/mcp-eslint-demo/package.json new file mode 100644 index 0000000..9a7f8c9 --- /dev/null +++ b/mcp-eslint-demo/package.json @@ -0,0 +1,13 @@ +{ + "name": "mcp-eslint-demo", + "version": "0.1.0", + "private": true, + "type": "module", + "scripts": { + "lint": "eslint \"src/**/*.js\"", + "lint:fix": "eslint \"src/**/*.js\" --fix" + }, + "devDependencies": { + "eslint": "^9.13.0" + } +} diff --git a/mcp-eslint-demo/src/bad.js b/mcp-eslint-demo/src/bad.js new file mode 100644 index 0000000..852f3d3 --- /dev/null +++ b/mcp-eslint-demo/src/bad.js @@ -0,0 +1,30 @@ +// Intentionally includes common lint issues for demo +var foo = 1 // missing semicolon, uses var +let bar = 2 +let unused = 3 + +function compare(a, b) { + if (a == b) { // eqeqeq violation + console.log("Equal!\n"); // double quotes + } +} + +function shadow() { + let bar = 'shadowed'; + console.log(bar) +} + +// undefined variable usage +console.log(result) + +// prefer-const violation +let arr = [1,2,3] +arr.push(4) + +// mixed spaces and tabs +for (var i = 0; i < arr.length; i++) { + console.log(arr[i]) +} + +compare(foo, bar) +shadow() diff --git a/mcp-eslint-demo/src/good.js b/mcp-eslint-demo/src/good.js new file mode 100644 index 0000000..6edeb63 --- /dev/null +++ b/mcp-eslint-demo/src/good.js @@ -0,0 +1,15 @@ +// Clean file to contrast with bad.js +const answer = 42; + +function greet(name) { + if (typeof name !== 'string') return; + console.log('Hello, ' + name + '!'); +} + +function sum(nums) { + if (!Array.isArray(nums)) return 0; + return nums.reduce((acc, n) => acc + n, 0); +} + +greet('World'); +console.log('Sum:', sum([1, 2, 3])); diff --git a/playwright-mcp-demo/README.md b/playwright-mcp-demo/README.md new file mode 100644 index 0000000..bdcccdd --- /dev/null +++ b/playwright-mcp-demo/README.md @@ -0,0 +1,56 @@ +# Playwright MCP Demo + +A minimal static web UI + Playwright tests designed to be easy for an MCP server (e.g., Playwright MCP server) to drive. + +## What’s included +- Static UI: `src/index.html`, `src/app.js`, `src/styles.css` +- Playwright tests: `tests/example.spec.ts` +- Scripts: local HTTP server and test runner + +## Quick start + +1. Install dev dependencies: + +```bash +npm install +``` + +2. Serve the static site (default port 5173): + +```bash +npm run serve +``` + +3. In another terminal, run tests (they assume the server is running): + +```bash +npm test +``` + +To use a different port, set `PORT` when running tests, and start the server on the same port: + +```bash +PORT=8080 npm run serve +PORT=8080 npm test +``` + +## MCP Server Integration Notes +- The page exposes stable selectors (`data-testid`, ids) to enable robust automation. +- Flows covered: + - Login success/failure + - Task add/clear + - Modal open/close +- You can point the Playwright MCP server to the served URL and use actions that mirror the test steps. + +## Folder structure +``` +playwright-mcp-demo/ + package.json + README.md + src/ + index.html + app.js + styles.css + tests/ + example.spec.ts +``` diff --git a/playwright-mcp-demo/package-lock.json b/playwright-mcp-demo/package-lock.json new file mode 100644 index 0000000..7c9d662 --- /dev/null +++ b/playwright-mcp-demo/package-lock.json @@ -0,0 +1,706 @@ +{ + "name": "playwright-mcp-demo", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "playwright-mcp-demo", + "version": "0.1.0", + "devDependencies": { + "@playwright/test": "^1.49.0", + "http-server": "^14.1.1" + } + }, + "node_modules/@playwright/test": { + "version": "1.57.0", + "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.57.0.tgz", + "integrity": "sha512-6TyEnHgd6SArQO8UO2OMTxshln3QMWBtPGrOCgs3wVEmQmwyuNtB10IZMfmYDE0riwNR1cu4q+pPcxMVtaG3TA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright": "1.57.0" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/async": { + "version": "3.2.6", + "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", + "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", + "dev": true, + "license": "MIT" + }, + "node_modules/basic-auth": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/basic-auth/-/basic-auth-2.0.1.tgz", + "integrity": "sha512-NF+epuEdnUYVlGuhaxbbq+dvJttwLnGY+YixlXlME5KpQ5W3CnXA5cVTneY3SPbPDRkcjMbifrwmFYcClgOZeg==", + "dev": true, + "license": "MIT", + "dependencies": { + "safe-buffer": "5.1.2" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/call-bound": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz", + "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "get-intrinsic": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/corser": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/corser/-/corser-2.0.1.tgz", + "integrity": "sha512-utCYNzRSQIZNPIcGZdQc92UVJYAhtGAteCFg0yRaFm8f0P+CPtyGyHXJcGXnffjCybUCEx3FQ2G7U3/o9eIkVQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", + "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/eventemitter3": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-4.0.7.tgz", + "integrity": "sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw==", + "dev": true, + "license": "MIT" + }, + "node_modules/follow-redirects": { + "version": "1.15.11", + "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.11.tgz", + "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==", + "dev": true, + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/RubenVerborgh" + } + ], + "license": "MIT", + "engines": { + "node": ">=4.0" + }, + "peerDependenciesMeta": { + "debug": { + "optional": true + } + } + }, + "node_modules/fsevents": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz", + "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "dev": true, + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", + "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/he": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz", + "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==", + "dev": true, + "license": "MIT", + "bin": { + "he": "bin/he" + } + }, + "node_modules/html-encoding-sniffer": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-3.0.0.tgz", + "integrity": "sha512-oWv4T4yJ52iKrufjnyZPkrN0CH3QnrUqdB6In1g5Fe1mia8GmF36gnfNySxoZtxD5+NmYw1EElVXiBk93UeskA==", + "dev": true, + "license": "MIT", + "dependencies": { + "whatwg-encoding": "^2.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/http-proxy": { + "version": "1.18.1", + "resolved": "https://registry.npmjs.org/http-proxy/-/http-proxy-1.18.1.tgz", + "integrity": "sha512-7mz/721AbnJwIVbnaSv1Cz3Am0ZLT/UBwkC92VlxhXv/k/BBQfM2fXElQNC27BVGr0uwUpplYPQM9LnaBMR5NQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "eventemitter3": "^4.0.0", + "follow-redirects": "^1.0.0", + "requires-port": "^1.0.0" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/http-server": { + "version": "14.1.1", + "resolved": "https://registry.npmjs.org/http-server/-/http-server-14.1.1.tgz", + "integrity": "sha512-+cbxadF40UXd9T01zUHgA+rlo2Bg1Srer4+B4NwIHdaGxAGGv59nYRnGGDJ9LBk7alpS0US+J+bLLdQOOkJq4A==", + "dev": true, + "license": "MIT", + "dependencies": { + "basic-auth": "^2.0.1", + "chalk": "^4.1.2", + "corser": "^2.0.1", + "he": "^1.2.0", + "html-encoding-sniffer": "^3.0.0", + "http-proxy": "^1.18.1", + "mime": "^1.6.0", + "minimist": "^1.2.6", + "opener": "^1.5.1", + "portfinder": "^1.0.28", + "secure-compare": "3.0.1", + "union": "~0.5.0", + "url-join": "^4.0.1" + }, + "bin": { + "http-server": "bin/http-server" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/iconv-lite": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", + "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", + "dev": true, + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/mime": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", + "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", + "dev": true, + "license": "MIT", + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/minimist": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", + "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/object-inspect": { + "version": "1.13.4", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz", + "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/opener": { + "version": "1.5.2", + "resolved": "https://registry.npmjs.org/opener/-/opener-1.5.2.tgz", + "integrity": "sha512-ur5UIdyw5Y7yEj9wLzhqXiy6GZ3Mwx0yGI+5sMn2r0N0v3cKJvUmFH5yPP+WXh9e0xfyzyJX95D8l088DNFj7A==", + "dev": true, + "license": "(WTFPL OR MIT)", + "bin": { + "opener": "bin/opener-bin.js" + } + }, + "node_modules/playwright": { + "version": "1.57.0", + "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.57.0.tgz", + "integrity": "sha512-ilYQj1s8sr2ppEJ2YVadYBN0Mb3mdo9J0wQ+UuDhzYqURwSoW4n1Xs5vs7ORwgDGmyEh33tRMeS8KhdkMoLXQw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright-core": "1.57.0" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "fsevents": "2.3.2" + } + }, + "node_modules/playwright-core": { + "version": "1.57.0", + "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.57.0.tgz", + "integrity": "sha512-agTcKlMw/mjBWOnD6kFZttAAGHgi/Nw0CZ2o6JqWSbMlI219lAFLZZCyqByTsvVAJq5XA5H8cA6PrvBRpBWEuQ==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "playwright-core": "cli.js" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/portfinder": { + "version": "1.0.38", + "resolved": "https://registry.npmjs.org/portfinder/-/portfinder-1.0.38.tgz", + "integrity": "sha512-rEwq/ZHlJIKw++XtLAO8PPuOQA/zaPJOZJ37BVuN97nLpMJeuDVLVGRwbFoBgLudgdTMP2hdRJP++H+8QOA3vg==", + "dev": true, + "license": "MIT", + "dependencies": { + "async": "^3.2.6", + "debug": "^4.3.6" + }, + "engines": { + "node": ">= 10.12" + } + }, + "node_modules/qs": { + "version": "6.14.0", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.0.tgz", + "integrity": "sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "side-channel": "^1.1.0" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/requires-port": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz", + "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/safe-buffer": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", + "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", + "dev": true, + "license": "MIT" + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "dev": true, + "license": "MIT" + }, + "node_modules/secure-compare": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/secure-compare/-/secure-compare-3.0.1.tgz", + "integrity": "sha512-AckIIV90rPDcBcglUwXPF3kg0P0qmPsPXAj6BBEENQE1p5yA1xfmDJzfi1Tappj37Pv2mVbKpL3Z1T+Nn7k1Qw==", + "dev": true, + "license": "MIT" + }, + "node_modules/side-channel": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz", + "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3", + "side-channel-list": "^1.0.0", + "side-channel-map": "^1.0.1", + "side-channel-weakmap": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-list": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz", + "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-map": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz", + "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-weakmap": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz", + "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3", + "side-channel-map": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/union": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/union/-/union-0.5.0.tgz", + "integrity": "sha512-N6uOhuW6zO95P3Mel2I2zMsbsanvvtgn6jVqJv4vbVcz/JN0OkL9suomjQGmWtxJQXOCqUJvquc1sMeNz/IwlA==", + "dev": true, + "dependencies": { + "qs": "^6.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/url-join": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/url-join/-/url-join-4.0.1.tgz", + "integrity": "sha512-jk1+QP6ZJqyOiuEI9AEWQfju/nB2Pw466kbA0LEZljHwKeMgd9WrAEgEGxjPDD2+TNbbb37rTyhEfrCXfuKXnA==", + "dev": true, + "license": "MIT" + }, + "node_modules/whatwg-encoding": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-2.0.0.tgz", + "integrity": "sha512-p41ogyeMUrw3jWclHWTQg1k05DSVXPLcVxRTYsXUk+ZooOCZLcoYgPZ/HL/D/N+uQPOtcp1me1WhBEaX02mhWg==", + "dev": true, + "license": "MIT", + "dependencies": { + "iconv-lite": "0.6.3" + }, + "engines": { + "node": ">=12" + } + } + } +} diff --git a/playwright-mcp-demo/package.json b/playwright-mcp-demo/package.json new file mode 100644 index 0000000..d4b9dbf --- /dev/null +++ b/playwright-mcp-demo/package.json @@ -0,0 +1,15 @@ +{ + "name": "playwright-mcp-demo", + "private": true, + "version": "0.1.0", + "description": "Minimal static site and Playwright tests suitable for MCP server automation", + "scripts": { + "test": "playwright test", + "test:ui": "playwright test --ui", + "serve": "npx http-server ./src -p 5173 -c-" + }, + "devDependencies": { + "@playwright/test": "^1.49.0", + "http-server": "^14.1.1" + } +} diff --git a/playwright-mcp-demo/src/admin.html b/playwright-mcp-demo/src/admin.html new file mode 100644 index 0000000..1b4d428 --- /dev/null +++ b/playwright-mcp-demo/src/admin.html @@ -0,0 +1,53 @@ + + + + + + Admin Area + + + + +

+

Admin Area

+ +
+
+
+

+
+ +
+ + + diff --git a/playwright-mcp-demo/src/app.js b/playwright-mcp-demo/src/app.js new file mode 100644 index 0000000..0a2f3f3 --- /dev/null +++ b/playwright-mcp-demo/src/app.js @@ -0,0 +1,88 @@ +const state = { + loggedIn: false, + tasks: [] +}; + +function $(sel) { return document.querySelector(sel); } +function el(tag, props = {}, children = []) { + const node = document.createElement(tag); + Object.entries(props).forEach(([k, v]) => { + if (k === 'dataset') Object.entries(v).forEach(([dk, dv]) => node.dataset[dk] = dv); + else if (k in node) node[k] = v; else node.setAttribute(k, v); + }); + children.forEach(c => node.appendChild(typeof c === 'string' ? document.createTextNode(c) : c)); + return node; +} + +function renderTasks() { + const list = $('#task-list'); + list.innerHTML = ''; + state.tasks.forEach((t, i) => { + const item = el('li', { className: 'task-item' }, [ + el('input', { type: 'checkbox', checked: !!t.done, 'aria-label': `Complete ${t.text}` }), + el('span', { className: 'task-text' }, [t.text]), + el('button', { className: 'delete-btn' }, ['Delete']) + ]); + + item.querySelector('input').addEventListener('change', (e) => { + state.tasks[i].done = e.target.checked; + }); + item.querySelector('.delete-btn').addEventListener('click', () => { + state.tasks.splice(i, 1); + renderTasks(); + }); + list.appendChild(item); + }); +} + +function initLogin() { + $('#login-form').addEventListener('submit', (e) => { + e.preventDefault(); + const u = $('#username').value.trim(); + const p = $('#password').value; + setTimeout(() => { + if (u && p) { + state.loggedIn = true; + // Very simple demo role handling: admin if username+password both 'admin' + const isAdmin = u.toLowerCase() === 'admin' && p === 'admin'; + const role = isAdmin ? 'admin' : 'user'; + try { localStorage.setItem('demo-role', role); } catch {} + $('#login-status').textContent = isAdmin ? `Logged in as admin` : `Logged in as ${u}`; + $('#login-status').dataset.testid = isAdmin ? 'admin-login' : 'login-success'; + } else { + state.loggedIn = false; + $('#login-status').textContent = 'Login failed'; + $('#login-status').dataset.testid = 'login-failed'; + } + }, 150); + }); +} + +function initTasks() { + $('#add-task').addEventListener('click', () => { + const text = $('#new-task').value.trim(); + if (!text) return; + state.tasks.push({ text, done: false }); + $('#new-task').value = ''; + renderTasks(); + }); + + $('#clear-completed').addEventListener('click', () => { + state.tasks = state.tasks.filter(t => !t.done); + renderTasks(); + }); +} + +function initModal() { + const dialog = $('#demo-modal'); + $('#open-modal').addEventListener('click', () => dialog.showModal()); + $('#close-modal').addEventListener('click', () => dialog.close()); +} + +function init() { + initLogin(); + initTasks(); + initModal(); +} + +document.addEventListener('DOMContentLoaded', init); diff --git a/playwright-mcp-demo/src/index.html b/playwright-mcp-demo/src/index.html new file mode 100644 index 0000000..99e43f2 --- /dev/null +++ b/playwright-mcp-demo/src/index.html @@ -0,0 +1,59 @@ + + + + + + Playwright MCP Demo + + + +
+

Playwright MCP Demo

+
+ +
+
+
+ + + + + + + +
+

+
+ +
+
+ + + +
+
    +
    + +
    + + +
    +

    Demo Modal

    +

    This is a modal for UI automation.

    + +
    +     +
    + +
    +

    + Admin area: + /admin +

    +

    Log in as admin/admin to gain access.

    +
    +
    + + + + diff --git a/playwright-mcp-demo/src/styles.css b/playwright-mcp-demo/src/styles.css new file mode 100644 index 0000000..7d121fd --- /dev/null +++ b/playwright-mcp-demo/src/styles.css @@ -0,0 +1,14 @@ +* { box-sizing: border-box; } +body { font-family: system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif; margin: 0; padding: 24px; background: #fafafa; } +header { border-bottom: 1px solid #e5e5e5; margin-bottom: 16px; } +h1 { margin: 0 0 12px; } +main { display: grid; gap: 24px; grid-template-columns: 1fr; max-width: 720px; } +label { display: block; margin: 8px 0 4px; } +input[type="text"], input[type="password"] { width: 100%; padding: 8px; border: 1px solid #ccc; border-radius: 6px; } +button { margin-top: 8px; padding: 8px 12px; border: 1px solid #ccc; background: white; border-radius: 6px; cursor: pointer; } +.controls { display: flex; gap: 8px; align-items: center; } +#new-task { flex: 1; } +#task-list { list-style: none; padding: 0; } +.task-item { display: flex; align-items: center; gap: 8px; padding: 6px 0; } +.task-text { flex: 1; } +dialog { border: none; border-radius: 8px; padding: 16px; } diff --git a/playwright-mcp-demo/tests/example.spec.ts b/playwright-mcp-demo/tests/example.spec.ts new file mode 100644 index 0000000..920dc9f --- /dev/null +++ b/playwright-mcp-demo/tests/example.spec.ts @@ -0,0 +1,72 @@ +import { test, expect } from '@playwright/test'; + +const PORT = process.env.PORT || '5173'; +const BASE = `http://localhost:${PORT}`; + +// Basic smoke tests for MCP-friendly actions + +test.describe('Playwright MCP Demo', () => { + test.beforeEach(async ({ page }) => { + await page.goto(BASE); + }); + + test('renders title', async ({ page }) => { + const title = page.getByTestId('title'); + await expect(title).toHaveText('Playwright MCP Demo'); + }); + + test('login success and failure', async ({ page }) => { + await page.fill('#username', 'mcp-user'); + await page.fill('#password', 'secret'); + await page.click('#login-btn'); + await expect(page.locator('#login-status[data-testid="login-success"]')).toContainText('Logged in as mcp-user'); + + await page.fill('#username', ''); + await page.fill('#password', ''); + await page.click('#login-btn'); + await expect(page.locator('#login-status[data-testid="login-failed"]')).toHaveText('Login failed'); + }); + + test('add and clear tasks', async ({ page }) => { + await page.fill('#new-task', 'Write MCP test'); + await page.click('#add-task'); + await expect(page.locator('#task-list .task-item .task-text')).toHaveText('Write MCP test'); + + await page.check('#task-list .task-item input[type="checkbox"]'); + await page.click('#clear-completed'); + await expect(page.locator('#task-list .task-item')).toHaveCount(0); + }); + + test('modal open/close', async ({ page }) => { + await page.click('#open-modal'); + const modal = page.locator('dialog#demo-modal'); + await expect(modal).toBeVisible(); + await page.click('#close-modal'); + await expect(modal).not.toBeVisible(); + }); + + test('normal user cannot access admin', async ({ page }) => { + // Login as a normal user + await page.fill('#username', 'alice'); + await page.fill('#password', 'secret'); + await page.click('#login-btn'); + await expect(page.locator('#login-status[data-testid="login-success"]')).toContainText('Logged in as alice'); + + // Navigate to /admin + await page.goto(`${BASE}/admin`); + // Confirm access denied message is shown and admin content hidden + await expect(page.locator('#status[data-testid="admin-access-denied"]')).toHaveText('Access denied: insufficient permissions'); + }); + + test('admin can access admin area', async ({ page }) => { + // Login as admin/admin + await page.fill('#username', 'admin'); + await page.fill('#password', 'admin'); + await page.click('#login-btn'); + await expect(page.locator('#login-status[data-testid="admin-login"]')).toHaveText('Logged in as admin'); + + await page.goto(`${BASE}/admin`); + await expect(page.locator('#status[data-testid="admin-access-granted"]')).toHaveText('Access granted: admin'); + await expect(page.getByRole('heading', { name: 'System Controls' })).toBeVisible(); + }); +}); diff --git a/web-utils/README.md b/web-utils/README.md new file mode 100644 index 0000000..28a5e57 --- /dev/null +++ b/web-utils/README.md @@ -0,0 +1,19 @@ +# Web Utils + +A small client-side utilities module to demonstrate ESLint integration, with realistic file names and structure. + +## Setup + +```bash +cd web-utils +npm install +``` + +## Lint + +```bash +npm run lint +npm run lint:fix +``` + +The `src/list-utils.js` contains intentional issues to show lint findings while still resembling real application code. `src/math-utils.js` is mostly clean. diff --git a/web-utils/eslint.config.js b/web-utils/eslint.config.js new file mode 100644 index 0000000..8427f73 --- /dev/null +++ b/web-utils/eslint.config.js @@ -0,0 +1,29 @@ +// ESLint v9 flat config +import js from '@eslint/js'; + +export default [ + js.configs.recommended, + { + ignores: ['node_modules/**'], + files: ['src/**/*.js'], + languageOptions: { + ecmaVersion: 2022, + sourceType: 'module', + globals: { + console: 'readonly', + window: 'readonly', + document: 'readonly', + }, + }, + rules: { + 'no-unused-vars': 'warn', + 'no-undef': 'error', + eqeqeq: ['error', 'always'], + semi: ['error', 'always'], + quotes: ['error', 'single', { avoidEscape: true }], + 'no-var': 'error', + 'prefer-const': 'warn', + 'no-console': 'off', + }, + }, +]; diff --git a/web-utils/package.json b/web-utils/package.json new file mode 100644 index 0000000..e6ea9ae --- /dev/null +++ b/web-utils/package.json @@ -0,0 +1,13 @@ +{ + "name": "web-utils", + "version": "0.1.0", + "private": true, + "type": "module", + "scripts": { + "lint": "eslint \"src/**/*.js\"", + "lint:fix": "eslint \"src/**/*.js\" --fix" + }, + "devDependencies": { + "eslint": "^9.13.0" + } +} diff --git a/web-utils/src/list-utils.js b/web-utils/src/list-utils.js new file mode 100644 index 0000000..be8f2b9 --- /dev/null +++ b/web-utils/src/list-utils.js @@ -0,0 +1,29 @@ +// List utilities for client-side rendering (with intentional issues for lint demo) +var foo = 1 // missing semicolon, uses var +let bar = 2 +let unused = 3 + +export function areEqual(a, b) { + if (a == b) { // eqeqeq violation + console.log("Equal!\n"); // double quotes + } +} + +export function renderList(items) { + let bar = 'shadowed'; + console.log(bar) + + // undefined variable usage + console.log(result) + + // prefer-const violation + let arr = [1,2,3] + arr.push(4) + + // mixed spaces and tabs + for (var i = 0; i < items.length; i++) { + console.log(items[i]) + } + + areEqual(foo, bar) +} diff --git a/web-utils/src/math-utils.js b/web-utils/src/math-utils.js new file mode 100644 index 0000000..a8dcd7e --- /dev/null +++ b/web-utils/src/math-utils.js @@ -0,0 +1,15 @@ +// Basic math helpers used by UI widgets +export const answer = 42; + +export function greet(name) { + if (typeof name !== 'string') return; + console.log('Hello, ' + name + '!'); +} + +export function sum(nums) { + if (!Array.isArray(nums)) return 0; + return nums.reduce((acc, n) => acc + n, 0); +} + +greet('World'); +console.log('Sum:', sum([1, 2, 3])); From 3f9f506652d45cd76a3ffb6d355f4c92efa1d823 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 9 Dec 2025 11:50:55 -0600 Subject: [PATCH 42/48] eslint changes --- web-utils/package-lock.json | 1077 +++++++++++++++++++++++++++++++++++ web-utils/package.json | 3 +- 2 files changed, 1079 insertions(+), 1 deletion(-) create mode 100644 web-utils/package-lock.json diff --git a/web-utils/package-lock.json b/web-utils/package-lock.json new file mode 100644 index 0000000..043e7b4 --- /dev/null +++ b/web-utils/package-lock.json @@ -0,0 +1,1077 @@ +{ + "name": "web-utils", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "web-utils", + "version": "0.1.0", + "devDependencies": { + "@eslint/js": "^9.39.1", + "eslint": "^9.39.1" + } + }, + "node_modules/@eslint-community/eslint-utils": { + "version": "4.9.0", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", + "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "eslint-visitor-keys": "^3.4.3" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" + } + }, + "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint-community/regexpp": { + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", + "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.0.0 || ^14.0.0 || >=16.0.0" + } + }, + "node_modules/@eslint/config-array": { + "version": "0.21.1", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.1.tgz", + "integrity": "sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/object-schema": "^2.1.7", + "debug": "^4.3.1", + "minimatch": "^3.1.2" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/config-helpers": { + "version": "0.4.2", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.2.tgz", + "integrity": "sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.17.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/core": { + "version": "0.17.0", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.17.0.tgz", + "integrity": "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@types/json-schema": "^7.0.15" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/eslintrc": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.3.tgz", + "integrity": "sha512-Kr+LPIUVKz2qkx1HAMH8q1q6azbqBAsXJUxBl/ODDuVPX45Z9DfwB8tPjTi6nNZ8BuM3nbJxC5zCAg5elnBUTQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^6.12.4", + "debug": "^4.3.2", + "espree": "^10.0.1", + "globals": "^14.0.0", + "ignore": "^5.2.0", + "import-fresh": "^3.2.1", + "js-yaml": "^4.1.1", + "minimatch": "^3.1.2", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint/js": { + "version": "9.39.1", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.1.tgz", + "integrity": "sha512-S26Stp4zCy88tH94QbBv3XCuzRQiZ9yXofEILmglYTh/Ug/a9/umqvgFtYBAo3Lp0nsI/5/qH1CCrbdK3AP1Tw==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" + } + }, + "node_modules/@eslint/object-schema": { + "version": "2.1.7", + "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz", + "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/plugin-kit": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.1.tgz", + "integrity": "sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.17.0", + "levn": "^0.4.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@humanfs/core": { + "version": "0.19.1", + "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz", + "integrity": "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanfs/node": { + "version": "0.16.7", + "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz", + "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanfs/core": "^0.19.1", + "@humanwhocodes/retry": "^0.4.0" + }, + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanwhocodes/module-importer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", + "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.22" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@humanwhocodes/retry": { + "version": "0.4.3", + "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz", + "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", + "dev": true, + "license": "MIT" + }, + "node_modules/acorn": { + "version": "8.15.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", + "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", + "dev": true, + "license": "MIT", + "peer": true, + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/ajv": { + "version": "6.12.6", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", + "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" + }, + "node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", + "dev": true, + "license": "MIT" + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint": { + "version": "9.39.1", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.1.tgz", + "integrity": "sha512-BhHmn2yNOFA9H9JmmIVKJmd288g9hrVRDkdoIgRCRuSySRUHH7r/DI6aAXW9T1WwUuY3DFgrcaqB+deURBLR5g==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@eslint-community/eslint-utils": "^4.8.0", + "@eslint-community/regexpp": "^4.12.1", + "@eslint/config-array": "^0.21.1", + "@eslint/config-helpers": "^0.4.2", + "@eslint/core": "^0.17.0", + "@eslint/eslintrc": "^3.3.1", + "@eslint/js": "9.39.1", + "@eslint/plugin-kit": "^0.4.1", + "@humanfs/node": "^0.16.6", + "@humanwhocodes/module-importer": "^1.0.1", + "@humanwhocodes/retry": "^0.4.2", + "@types/estree": "^1.0.6", + "ajv": "^6.12.4", + "chalk": "^4.0.0", + "cross-spawn": "^7.0.6", + "debug": "^4.3.2", + "escape-string-regexp": "^4.0.0", + "eslint-scope": "^8.4.0", + "eslint-visitor-keys": "^4.2.1", + "espree": "^10.4.0", + "esquery": "^1.5.0", + "esutils": "^2.0.2", + "fast-deep-equal": "^3.1.3", + "file-entry-cache": "^8.0.0", + "find-up": "^5.0.0", + "glob-parent": "^6.0.2", + "ignore": "^5.2.0", + "imurmurhash": "^0.1.4", + "is-glob": "^4.0.0", + "json-stable-stringify-without-jsonify": "^1.0.1", + "lodash.merge": "^4.6.2", + "minimatch": "^3.1.2", + "natural-compare": "^1.4.0", + "optionator": "^0.9.3" + }, + "bin": { + "eslint": "bin/eslint.js" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" + }, + "peerDependencies": { + "jiti": "*" + }, + "peerDependenciesMeta": { + "jiti": { + "optional": true + } + } + }, + "node_modules/eslint-scope": { + "version": "8.4.0", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz", + "integrity": "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^5.2.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-visitor-keys": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz", + "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/espree": { + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz", + "integrity": "sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.15.0", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^4.2.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/esquery": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", + "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "estraverse": "^5.1.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "estraverse": "^5.2.0" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-json-stable-stringify": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", + "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", + "dev": true, + "license": "MIT" + }, + "node_modules/file-entry-cache": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", + "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "flat-cache": "^4.0.0" + }, + "engines": { + "node": ">=16.0.0" + } + }, + "node_modules/find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^6.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/flat-cache": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz", + "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==", + "dev": true, + "license": "MIT", + "dependencies": { + "flatted": "^3.2.9", + "keyv": "^4.5.4" + }, + "engines": { + "node": ">=16" + } + }, + "node_modules/flatted": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz", + "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==", + "dev": true, + "license": "ISC" + }, + "node_modules/glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/globals": { + "version": "14.0.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz", + "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.19" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC" + }, + "node_modules/js-yaml": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", + "dev": true, + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/json-buffer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", + "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/keyv": { + "version": "4.5.4", + "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", + "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "json-buffer": "3.0.1" + } + }, + "node_modules/levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1", + "type-check": "~0.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^5.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/lodash.merge": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", + "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "dev": true, + "license": "MIT" + }, + "node_modules/optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "deep-is": "^0.1.3", + "fast-levenshtein": "^2.0.6", + "levn": "^0.4.1", + "prelude-ls": "^1.2.1", + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "yocto-queue": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "dev": true, + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "shebang-regex": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-json-comments": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", + "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/type-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/uri-js": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", + "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "punycode": "^2.1.0" + } + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "dev": true, + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + } + } +} diff --git a/web-utils/package.json b/web-utils/package.json index e6ea9ae..cfd6910 100644 --- a/web-utils/package.json +++ b/web-utils/package.json @@ -8,6 +8,7 @@ "lint:fix": "eslint \"src/**/*.js\" --fix" }, "devDependencies": { - "eslint": "^9.13.0" + "@eslint/js": "^9.39.1", + "eslint": "^9.39.1" } } From 5fbbe21077f7c70054e181bd7cbf79a99e0cb4b3 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Tue, 9 Dec 2025 12:09:40 -0600 Subject: [PATCH 43/48] pre-demo changes --- mcp-eslint-demo/.eslintignore | 1 - mcp-eslint-demo/.eslintrc.json | 22 - mcp-eslint-demo/README.md | 24 - mcp-eslint-demo/eslint.config.js | 29 - mcp-eslint-demo/package-lock.json | 1076 ----------------- mcp-eslint-demo/package.json | 13 - mcp-eslint-demo/src/bad.js | 30 - mcp-eslint-demo/src/good.js | 15 - .../README.md | 0 .../package-lock.json | 0 .../package.json | 0 .../src/admin.html | 0 .../src/app.js | 0 .../src/index.html | 0 .../src/styles.css | 0 task-management/test-results/.last-run.json | 6 + .../tests/example.spec.ts | 0 17 files changed, 6 insertions(+), 1210 deletions(-) delete mode 100644 mcp-eslint-demo/.eslintignore delete mode 100644 mcp-eslint-demo/.eslintrc.json delete mode 100644 mcp-eslint-demo/README.md delete mode 100644 mcp-eslint-demo/eslint.config.js delete mode 100644 mcp-eslint-demo/package-lock.json delete mode 100644 mcp-eslint-demo/package.json delete mode 100644 mcp-eslint-demo/src/bad.js delete mode 100644 mcp-eslint-demo/src/good.js rename {playwright-mcp-demo => task-management}/README.md (100%) rename {playwright-mcp-demo => task-management}/package-lock.json (100%) rename {playwright-mcp-demo => task-management}/package.json (100%) rename {playwright-mcp-demo => task-management}/src/admin.html (100%) rename {playwright-mcp-demo => task-management}/src/app.js (100%) rename {playwright-mcp-demo => task-management}/src/index.html (100%) rename {playwright-mcp-demo => task-management}/src/styles.css (100%) create mode 100644 task-management/test-results/.last-run.json rename {playwright-mcp-demo => task-management}/tests/example.spec.ts (100%) diff --git a/mcp-eslint-demo/.eslintignore b/mcp-eslint-demo/.eslintignore deleted file mode 100644 index c2658d7..0000000 --- a/mcp-eslint-demo/.eslintignore +++ /dev/null @@ -1 +0,0 @@ -node_modules/ diff --git a/mcp-eslint-demo/.eslintrc.json b/mcp-eslint-demo/.eslintrc.json deleted file mode 100644 index e7050d5..0000000 --- a/mcp-eslint-demo/.eslintrc.json +++ /dev/null @@ -1,22 +0,0 @@ -{ - "env": { - "es2022": true, - "node": true, - "browser": true - }, - "extends": ["eslint:recommended"], - "parserOptions": { - "ecmaVersion": 2022, - "sourceType": "module" - }, - "rules": { - "no-unused-vars": "warn", - "no-undef": "error", - "eqeqeq": ["error", "always"], - "semi": ["error", "always"], - "quotes": ["error", "single", { "avoidEscape": true }], - "no-var": "error", - "prefer-const": "warn", - "no-console": "off" - } -} diff --git a/mcp-eslint-demo/README.md b/mcp-eslint-demo/README.md deleted file mode 100644 index 86aafbf..0000000 --- a/mcp-eslint-demo/README.md +++ /dev/null @@ -1,24 +0,0 @@ -# MCP ESLint Demo - -This directory contains a minimal JavaScript project to demo the ESLint MCP server. It includes one intentionally problematic file (`src/bad.js`) and one clean file (`src/good.js`). - -## Setup - -```bash -cd mcp-eslint-demo -npm install -``` - -## Run ESLint - -```bash -npm run lint -``` - -## Auto-fix (where possible) - -```bash -npm run lint:fix -``` - -Use these commands in your MCP setup to point the ESLint server at `mcp-eslint-demo/src`. The errors in `bad.js` demonstrate common rule violations (eqeqeq, semi, quotes, no-var, prefer-const, no-unused-vars, no-undef). diff --git a/mcp-eslint-demo/eslint.config.js b/mcp-eslint-demo/eslint.config.js deleted file mode 100644 index 263e345..0000000 --- a/mcp-eslint-demo/eslint.config.js +++ /dev/null @@ -1,29 +0,0 @@ -// ESLint v9 flat config -import js from '@eslint/js'; - -export default [ - js.configs.recommended, - { - ignores: ['node_modules/**'], - files: ['src/**/*.js'], - languageOptions: { - ecmaVersion: 2022, - sourceType: 'module', - globals: { - console: 'readonly', - window: 'readonly', - document: 'readonly', - }, - }, - rules: { - 'no-unused-vars': 'warn', - 'no-undef': 'error', - eqeqeq: ['error', 'always'], - semi: ['error', 'always'], - quotes: ['error', 'single', { avoidEscape: true }], - 'no-var': 'error', - 'prefer-const': 'warn', - 'no-console': 'off', - }, - }, -]; \ No newline at end of file diff --git a/mcp-eslint-demo/package-lock.json b/mcp-eslint-demo/package-lock.json deleted file mode 100644 index 1b43ec2..0000000 --- a/mcp-eslint-demo/package-lock.json +++ /dev/null @@ -1,1076 +0,0 @@ -{ - "name": "mcp-eslint-demo", - "version": "0.1.0", - "lockfileVersion": 3, - "requires": true, - "packages": { - "": { - "name": "mcp-eslint-demo", - "version": "0.1.0", - "devDependencies": { - "eslint": "^9.13.0" - } - }, - "node_modules/@eslint-community/eslint-utils": { - "version": "4.9.0", - "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", - "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==", - "dev": true, - "license": "MIT", - "dependencies": { - "eslint-visitor-keys": "^3.4.3" - }, - "engines": { - "node": "^12.22.0 || ^14.17.0 || >=16.0.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - }, - "peerDependencies": { - "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" - } - }, - "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": { - "version": "3.4.3", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", - "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", - "dev": true, - "license": "Apache-2.0", - "engines": { - "node": "^12.22.0 || ^14.17.0 || >=16.0.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/@eslint-community/regexpp": { - "version": "4.12.2", - "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", - "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", - "dev": true, - "license": "MIT", - "engines": { - "node": "^12.0.0 || ^14.0.0 || >=16.0.0" - } - }, - "node_modules/@eslint/config-array": { - "version": "0.21.1", - "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.1.tgz", - "integrity": "sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==", - "dev": true, - "license": "Apache-2.0", - "dependencies": { - "@eslint/object-schema": "^2.1.7", - "debug": "^4.3.1", - "minimatch": "^3.1.2" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - } - }, - "node_modules/@eslint/config-helpers": { - "version": "0.4.2", - "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.2.tgz", - "integrity": "sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw==", - "dev": true, - "license": "Apache-2.0", - "dependencies": { - "@eslint/core": "^0.17.0" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - } - }, - "node_modules/@eslint/core": { - "version": "0.17.0", - "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.17.0.tgz", - "integrity": "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==", - "dev": true, - "license": "Apache-2.0", - "dependencies": { - "@types/json-schema": "^7.0.15" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - } - }, - "node_modules/@eslint/eslintrc": { - "version": "3.3.3", - "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.3.tgz", - "integrity": "sha512-Kr+LPIUVKz2qkx1HAMH8q1q6azbqBAsXJUxBl/ODDuVPX45Z9DfwB8tPjTi6nNZ8BuM3nbJxC5zCAg5elnBUTQ==", - "dev": true, - "license": "MIT", - "dependencies": { - "ajv": "^6.12.4", - "debug": "^4.3.2", - "espree": "^10.0.1", - "globals": "^14.0.0", - "ignore": "^5.2.0", - "import-fresh": "^3.2.1", - "js-yaml": "^4.1.1", - "minimatch": "^3.1.2", - "strip-json-comments": "^3.1.1" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/@eslint/js": { - "version": "9.39.1", - "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.1.tgz", - "integrity": "sha512-S26Stp4zCy88tH94QbBv3XCuzRQiZ9yXofEILmglYTh/Ug/a9/umqvgFtYBAo3Lp0nsI/5/qH1CCrbdK3AP1Tw==", - "dev": true, - "license": "MIT", - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://eslint.org/donate" - } - }, - "node_modules/@eslint/object-schema": { - "version": "2.1.7", - "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz", - "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==", - "dev": true, - "license": "Apache-2.0", - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - } - }, - "node_modules/@eslint/plugin-kit": { - "version": "0.4.1", - "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.1.tgz", - "integrity": "sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==", - "dev": true, - "license": "Apache-2.0", - "dependencies": { - "@eslint/core": "^0.17.0", - "levn": "^0.4.1" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - } - }, - "node_modules/@humanfs/core": { - "version": "0.19.1", - "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz", - "integrity": "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==", - "dev": true, - "license": "Apache-2.0", - "engines": { - "node": ">=18.18.0" - } - }, - "node_modules/@humanfs/node": { - "version": "0.16.7", - "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz", - "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==", - "dev": true, - "license": "Apache-2.0", - "dependencies": { - "@humanfs/core": "^0.19.1", - "@humanwhocodes/retry": "^0.4.0" - }, - "engines": { - "node": ">=18.18.0" - } - }, - "node_modules/@humanwhocodes/module-importer": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", - "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", - "dev": true, - "license": "Apache-2.0", - "engines": { - "node": ">=12.22" - }, - "funding": { - "type": "github", - "url": "https://github.com/sponsors/nzakas" - } - }, - "node_modules/@humanwhocodes/retry": { - "version": "0.4.3", - "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz", - "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==", - "dev": true, - "license": "Apache-2.0", - "engines": { - "node": ">=18.18" - }, - "funding": { - "type": "github", - "url": "https://github.com/sponsors/nzakas" - } - }, - "node_modules/@types/estree": { - "version": "1.0.8", - "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", - "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", - "dev": true, - "license": "MIT" - }, - "node_modules/@types/json-schema": { - "version": "7.0.15", - "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", - "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", - "dev": true, - "license": "MIT" - }, - "node_modules/acorn": { - "version": "8.15.0", - "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", - "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", - "dev": true, - "license": "MIT", - "peer": true, - "bin": { - "acorn": "bin/acorn" - }, - "engines": { - "node": ">=0.4.0" - } - }, - "node_modules/acorn-jsx": { - "version": "5.3.2", - "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", - "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", - "dev": true, - "license": "MIT", - "peerDependencies": { - "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" - } - }, - "node_modules/ajv": { - "version": "6.12.6", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", - "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", - "dev": true, - "license": "MIT", - "dependencies": { - "fast-deep-equal": "^3.1.1", - "fast-json-stable-stringify": "^2.0.0", - "json-schema-traverse": "^0.4.1", - "uri-js": "^4.2.2" - }, - "funding": { - "type": "github", - "url": "https://github.com/sponsors/epoberezkin" - } - }, - "node_modules/ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "dev": true, - "license": "MIT", - "dependencies": { - "color-convert": "^2.0.1" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" - } - }, - "node_modules/argparse": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", - "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", - "dev": true, - "license": "Python-2.0" - }, - "node_modules/balanced-match": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", - "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", - "dev": true, - "license": "MIT" - }, - "node_modules/brace-expansion": { - "version": "1.1.12", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", - "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", - "dev": true, - "license": "MIT", - "dependencies": { - "balanced-match": "^1.0.0", - "concat-map": "0.0.1" - } - }, - "node_modules/callsites": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", - "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=6" - } - }, - "node_modules/chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", - "dev": true, - "license": "MIT", - "dependencies": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/chalk/chalk?sponsor=1" - } - }, - "node_modules/color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "dev": true, - "license": "MIT", - "dependencies": { - "color-name": "~1.1.4" - }, - "engines": { - "node": ">=7.0.0" - } - }, - "node_modules/color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "dev": true, - "license": "MIT" - }, - "node_modules/concat-map": { - "version": "0.0.1", - "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", - "dev": true, - "license": "MIT" - }, - "node_modules/cross-spawn": { - "version": "7.0.6", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", - "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", - "dev": true, - "license": "MIT", - "dependencies": { - "path-key": "^3.1.0", - "shebang-command": "^2.0.0", - "which": "^2.0.1" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/debug": { - "version": "4.4.3", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", - "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", - "dev": true, - "license": "MIT", - "dependencies": { - "ms": "^2.1.3" - }, - "engines": { - "node": ">=6.0" - }, - "peerDependenciesMeta": { - "supports-color": { - "optional": true - } - } - }, - "node_modules/deep-is": { - "version": "0.1.4", - "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", - "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", - "dev": true, - "license": "MIT" - }, - "node_modules/escape-string-regexp": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", - "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/eslint": { - "version": "9.39.1", - "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.1.tgz", - "integrity": "sha512-BhHmn2yNOFA9H9JmmIVKJmd288g9hrVRDkdoIgRCRuSySRUHH7r/DI6aAXW9T1WwUuY3DFgrcaqB+deURBLR5g==", - "dev": true, - "license": "MIT", - "peer": true, - "dependencies": { - "@eslint-community/eslint-utils": "^4.8.0", - "@eslint-community/regexpp": "^4.12.1", - "@eslint/config-array": "^0.21.1", - "@eslint/config-helpers": "^0.4.2", - "@eslint/core": "^0.17.0", - "@eslint/eslintrc": "^3.3.1", - "@eslint/js": "9.39.1", - "@eslint/plugin-kit": "^0.4.1", - "@humanfs/node": "^0.16.6", - "@humanwhocodes/module-importer": "^1.0.1", - "@humanwhocodes/retry": "^0.4.2", - "@types/estree": "^1.0.6", - "ajv": "^6.12.4", - "chalk": "^4.0.0", - "cross-spawn": "^7.0.6", - "debug": "^4.3.2", - "escape-string-regexp": "^4.0.0", - "eslint-scope": "^8.4.0", - "eslint-visitor-keys": "^4.2.1", - "espree": "^10.4.0", - "esquery": "^1.5.0", - "esutils": "^2.0.2", - "fast-deep-equal": "^3.1.3", - "file-entry-cache": "^8.0.0", - "find-up": "^5.0.0", - "glob-parent": "^6.0.2", - "ignore": "^5.2.0", - "imurmurhash": "^0.1.4", - "is-glob": "^4.0.0", - "json-stable-stringify-without-jsonify": "^1.0.1", - "lodash.merge": "^4.6.2", - "minimatch": "^3.1.2", - "natural-compare": "^1.4.0", - "optionator": "^0.9.3" - }, - "bin": { - "eslint": "bin/eslint.js" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://eslint.org/donate" - }, - "peerDependencies": { - "jiti": "*" - }, - "peerDependenciesMeta": { - "jiti": { - "optional": true - } - } - }, - "node_modules/eslint-scope": { - "version": "8.4.0", - "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz", - "integrity": "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==", - "dev": true, - "license": "BSD-2-Clause", - "dependencies": { - "esrecurse": "^4.3.0", - "estraverse": "^5.2.0" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/eslint-visitor-keys": { - "version": "4.2.1", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz", - "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==", - "dev": true, - "license": "Apache-2.0", - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/espree": { - "version": "10.4.0", - "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz", - "integrity": "sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==", - "dev": true, - "license": "BSD-2-Clause", - "dependencies": { - "acorn": "^8.15.0", - "acorn-jsx": "^5.3.2", - "eslint-visitor-keys": "^4.2.1" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/esquery": { - "version": "1.6.0", - "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", - "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", - "dev": true, - "license": "BSD-3-Clause", - "dependencies": { - "estraverse": "^5.1.0" - }, - "engines": { - "node": ">=0.10" - } - }, - "node_modules/esrecurse": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", - "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", - "dev": true, - "license": "BSD-2-Clause", - "dependencies": { - "estraverse": "^5.2.0" - }, - "engines": { - "node": ">=4.0" - } - }, - "node_modules/estraverse": { - "version": "5.3.0", - "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", - "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", - "dev": true, - "license": "BSD-2-Clause", - "engines": { - "node": ">=4.0" - } - }, - "node_modules/esutils": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", - "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", - "dev": true, - "license": "BSD-2-Clause", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/fast-deep-equal": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", - "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", - "dev": true, - "license": "MIT" - }, - "node_modules/fast-json-stable-stringify": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", - "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", - "dev": true, - "license": "MIT" - }, - "node_modules/fast-levenshtein": { - "version": "2.0.6", - "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", - "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", - "dev": true, - "license": "MIT" - }, - "node_modules/file-entry-cache": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", - "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==", - "dev": true, - "license": "MIT", - "dependencies": { - "flat-cache": "^4.0.0" - }, - "engines": { - "node": ">=16.0.0" - } - }, - "node_modules/find-up": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", - "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", - "dev": true, - "license": "MIT", - "dependencies": { - "locate-path": "^6.0.0", - "path-exists": "^4.0.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/flat-cache": { - "version": "4.0.1", - "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz", - "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==", - "dev": true, - "license": "MIT", - "dependencies": { - "flatted": "^3.2.9", - "keyv": "^4.5.4" - }, - "engines": { - "node": ">=16" - } - }, - "node_modules/flatted": { - "version": "3.3.3", - "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz", - "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==", - "dev": true, - "license": "ISC" - }, - "node_modules/glob-parent": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", - "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", - "dev": true, - "license": "ISC", - "dependencies": { - "is-glob": "^4.0.3" - }, - "engines": { - "node": ">=10.13.0" - } - }, - "node_modules/globals": { - "version": "14.0.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz", - "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=18" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=8" - } - }, - "node_modules/ignore": { - "version": "5.3.2", - "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", - "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">= 4" - } - }, - "node_modules/import-fresh": { - "version": "3.3.1", - "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", - "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", - "dev": true, - "license": "MIT", - "dependencies": { - "parent-module": "^1.0.0", - "resolve-from": "^4.0.0" - }, - "engines": { - "node": ">=6" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/imurmurhash": { - "version": "0.1.4", - "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", - "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=0.8.19" - } - }, - "node_modules/is-extglob": { - "version": "2.1.1", - "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", - "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/is-glob": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", - "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", - "dev": true, - "license": "MIT", - "dependencies": { - "is-extglob": "^2.1.1" - }, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/isexe": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", - "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", - "dev": true, - "license": "ISC" - }, - "node_modules/js-yaml": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", - "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", - "dev": true, - "license": "MIT", - "dependencies": { - "argparse": "^2.0.1" - }, - "bin": { - "js-yaml": "bin/js-yaml.js" - } - }, - "node_modules/json-buffer": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", - "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", - "dev": true, - "license": "MIT" - }, - "node_modules/json-schema-traverse": { - "version": "0.4.1", - "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", - "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", - "dev": true, - "license": "MIT" - }, - "node_modules/json-stable-stringify-without-jsonify": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", - "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", - "dev": true, - "license": "MIT" - }, - "node_modules/keyv": { - "version": "4.5.4", - "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", - "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", - "dev": true, - "license": "MIT", - "dependencies": { - "json-buffer": "3.0.1" - } - }, - "node_modules/levn": { - "version": "0.4.1", - "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", - "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", - "dev": true, - "license": "MIT", - "dependencies": { - "prelude-ls": "^1.2.1", - "type-check": "~0.4.0" - }, - "engines": { - "node": ">= 0.8.0" - } - }, - "node_modules/locate-path": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", - "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", - "dev": true, - "license": "MIT", - "dependencies": { - "p-locate": "^5.0.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/lodash.merge": { - "version": "4.6.2", - "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", - "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", - "dev": true, - "license": "MIT" - }, - "node_modules/minimatch": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", - "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", - "dev": true, - "license": "ISC", - "dependencies": { - "brace-expansion": "^1.1.7" - }, - "engines": { - "node": "*" - } - }, - "node_modules/ms": { - "version": "2.1.3", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", - "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", - "dev": true, - "license": "MIT" - }, - "node_modules/natural-compare": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", - "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", - "dev": true, - "license": "MIT" - }, - "node_modules/optionator": { - "version": "0.9.4", - "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", - "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", - "dev": true, - "license": "MIT", - "dependencies": { - "deep-is": "^0.1.3", - "fast-levenshtein": "^2.0.6", - "levn": "^0.4.1", - "prelude-ls": "^1.2.1", - "type-check": "^0.4.0", - "word-wrap": "^1.2.5" - }, - "engines": { - "node": ">= 0.8.0" - } - }, - "node_modules/p-limit": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", - "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", - "dev": true, - "license": "MIT", - "dependencies": { - "yocto-queue": "^0.1.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/p-locate": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", - "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", - "dev": true, - "license": "MIT", - "dependencies": { - "p-limit": "^3.0.2" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/parent-module": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", - "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", - "dev": true, - "license": "MIT", - "dependencies": { - "callsites": "^3.0.0" - }, - "engines": { - "node": ">=6" - } - }, - "node_modules/path-exists": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", - "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=8" - } - }, - "node_modules/path-key": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", - "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=8" - } - }, - "node_modules/prelude-ls": { - "version": "1.2.1", - "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", - "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">= 0.8.0" - } - }, - "node_modules/punycode": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", - "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=6" - } - }, - "node_modules/resolve-from": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", - "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=4" - } - }, - "node_modules/shebang-command": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", - "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", - "dev": true, - "license": "MIT", - "dependencies": { - "shebang-regex": "^3.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/shebang-regex": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", - "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=8" - } - }, - "node_modules/strip-json-comments": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", - "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", - "dev": true, - "license": "MIT", - "dependencies": { - "has-flag": "^4.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/type-check": { - "version": "0.4.0", - "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", - "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", - "dev": true, - "license": "MIT", - "dependencies": { - "prelude-ls": "^1.2.1" - }, - "engines": { - "node": ">= 0.8.0" - } - }, - "node_modules/uri-js": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", - "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", - "dev": true, - "license": "BSD-2-Clause", - "dependencies": { - "punycode": "^2.1.0" - } - }, - "node_modules/which": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", - "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", - "dev": true, - "license": "ISC", - "dependencies": { - "isexe": "^2.0.0" - }, - "bin": { - "node-which": "bin/node-which" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/word-wrap": { - "version": "1.2.5", - "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", - "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/yocto-queue": { - "version": "0.1.0", - "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", - "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - } - } -} diff --git a/mcp-eslint-demo/package.json b/mcp-eslint-demo/package.json deleted file mode 100644 index 9a7f8c9..0000000 --- a/mcp-eslint-demo/package.json +++ /dev/null @@ -1,13 +0,0 @@ -{ - "name": "mcp-eslint-demo", - "version": "0.1.0", - "private": true, - "type": "module", - "scripts": { - "lint": "eslint \"src/**/*.js\"", - "lint:fix": "eslint \"src/**/*.js\" --fix" - }, - "devDependencies": { - "eslint": "^9.13.0" - } -} diff --git a/mcp-eslint-demo/src/bad.js b/mcp-eslint-demo/src/bad.js deleted file mode 100644 index 852f3d3..0000000 --- a/mcp-eslint-demo/src/bad.js +++ /dev/null @@ -1,30 +0,0 @@ -// Intentionally includes common lint issues for demo -var foo = 1 // missing semicolon, uses var -let bar = 2 -let unused = 3 - -function compare(a, b) { - if (a == b) { // eqeqeq violation - console.log("Equal!\n"); // double quotes - } -} - -function shadow() { - let bar = 'shadowed'; - console.log(bar) -} - -// undefined variable usage -console.log(result) - -// prefer-const violation -let arr = [1,2,3] -arr.push(4) - -// mixed spaces and tabs -for (var i = 0; i < arr.length; i++) { - console.log(arr[i]) -} - -compare(foo, bar) -shadow() diff --git a/mcp-eslint-demo/src/good.js b/mcp-eslint-demo/src/good.js deleted file mode 100644 index 6edeb63..0000000 --- a/mcp-eslint-demo/src/good.js +++ /dev/null @@ -1,15 +0,0 @@ -// Clean file to contrast with bad.js -const answer = 42; - -function greet(name) { - if (typeof name !== 'string') return; - console.log('Hello, ' + name + '!'); -} - -function sum(nums) { - if (!Array.isArray(nums)) return 0; - return nums.reduce((acc, n) => acc + n, 0); -} - -greet('World'); -console.log('Sum:', sum([1, 2, 3])); diff --git a/playwright-mcp-demo/README.md b/task-management/README.md similarity index 100% rename from playwright-mcp-demo/README.md rename to task-management/README.md diff --git a/playwright-mcp-demo/package-lock.json b/task-management/package-lock.json similarity index 100% rename from playwright-mcp-demo/package-lock.json rename to task-management/package-lock.json diff --git a/playwright-mcp-demo/package.json b/task-management/package.json similarity index 100% rename from playwright-mcp-demo/package.json rename to task-management/package.json diff --git a/playwright-mcp-demo/src/admin.html b/task-management/src/admin.html similarity index 100% rename from playwright-mcp-demo/src/admin.html rename to task-management/src/admin.html diff --git a/playwright-mcp-demo/src/app.js b/task-management/src/app.js similarity index 100% rename from playwright-mcp-demo/src/app.js rename to task-management/src/app.js diff --git a/playwright-mcp-demo/src/index.html b/task-management/src/index.html similarity index 100% rename from playwright-mcp-demo/src/index.html rename to task-management/src/index.html diff --git a/playwright-mcp-demo/src/styles.css b/task-management/src/styles.css similarity index 100% rename from playwright-mcp-demo/src/styles.css rename to task-management/src/styles.css diff --git a/task-management/test-results/.last-run.json b/task-management/test-results/.last-run.json new file mode 100644 index 0000000..0b626df --- /dev/null +++ b/task-management/test-results/.last-run.json @@ -0,0 +1,6 @@ +{ + "status": "failed", + "failedTests": [ + "b3a1b63342050f33a2cc-7681d50341b1ff43aa2e" + ] +} \ No newline at end of file diff --git a/playwright-mcp-demo/tests/example.spec.ts b/task-management/tests/example.spec.ts similarity index 100% rename from playwright-mcp-demo/tests/example.spec.ts rename to task-management/tests/example.spec.ts From 643ed43453515477e994a0f9e2825df074be4725 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 10 Dec 2025 22:09:15 -0600 Subject: [PATCH 44/48] for testing demo --- .github/agents/TDD.agent.md | 210 ++++++++++++++++++ .../prompts/plan-testCaseCoverage.prompt.md | 146 ++++++++++++ testing-demo.md | 6 + 3 files changed, 362 insertions(+) create mode 100644 .github/agents/TDD.agent.md create mode 100644 .github/prompts/plan-testCaseCoverage.prompt.md create mode 100644 testing-demo.md diff --git a/.github/agents/TDD.agent.md b/.github/agents/TDD.agent.md new file mode 100644 index 0000000..9892353 --- /dev/null +++ b/.github/agents/TDD.agent.md @@ -0,0 +1,210 @@ +--- +name: "TDD" +description: "Drive a strict test-driven development loop: specify behavior, write failing tests, then minimal implementation and refactor." +argument-hint: "Describe the behavior you want to add or change; I’ll guide you through TDD." +target: vscode +infer: true +tools: ['vscode', 'execute', 'read', 'edit', 'search', 'web', 'agent', 'todo'] +--- + +You are a senior engineer acting as a **strict TDD navigator** inside VS Code. + +Your job is to keep the user in a *tight* red β†’ green β†’ refactor loop: +1. Clarify behavior. +2. Write (or update) tests that **fail for the right reason**. +3. Implement only the minimal production code required to make those tests pass. +4. Refactor while keeping all tests green. +5. Repeat. + +Always bias toward **more tests, smaller steps, and fast feedback**. + +--- + +## Core principles + +When this agent is active, follow these principles: + +1. **Tests first by default** + - If the user asks for a new feature or behavior and there are tests in the project, *propose and/or write tests first*. + - Only write production code without tests when: + - The project clearly has no testing setup yet, *and* you are helping bootstrap it; or + - The user explicitly insists on skipping tests (in which case, gently remind them of the trade-offs once, then comply). + +2. **Red β†’ Green β†’ Refactor** + - **Red**: Introduce or update a test that fails due to missing/incorrect behavior. + - **Green**: Implement the smallest change that makes that test (and the suite) pass. + - **Refactor**: Improve design (naming, duplication, structure) without changing behavior, keeping tests passing. + +3. **Executable specifications** + - Treat tests as the primary specification of behavior. + - Prioritize clear, intention-revealing test names and scenarios over clever implementations. + - Keep tests deterministic, fast, and independent. + +4. **Prefer existing patterns** + - Match the project’s existing testing style, frameworks, folder layout, and naming conventions. + - Reuse existing test helpers, fixtures, factories, and patterns instead of inventing new ones. + +--- + +## Default workflow for each request + +For any user request related to new behavior, a bug, or a refactor: + +1. **Clarify behavior and scope** + - Ask concise questions to clarify: + - The end-user behavior or API contract. + - Edge cases, error conditions, and performance constraints. + - Summarize your understanding back to the user in a short bullet list before changing code. + +2. **Discover current state** + - Use `codebase`, `fileSearch`, or `textSearch` to locate: + - Existing implementation. + - Existing tests and helpers for that area. + - If there is a testing setup, reflect it back briefly: framework, runner, and typical file locations. + +3. **Design tests** + - Propose a *small set* of test cases ordered from simplest to more complex. + - For each test, describe: + - What scenario it covers. + - Why it’s valuable. + - Then generate or edit the appropriate test file using the `edit` tools. + - Follow framework- and language-specific conventions (see below). + +4. **Run tests and inspect failures** + - Prefer `runTests` to execute the tests from within VS Code rather than raw CLI commands. [oai_citation:1‑Visual Studio Code](https://code.visualstudio.com/docs/copilot/reference/copilot-vscode-features) + - Use `testFailure` and `problems` to pull in failure details and diagnostics. + - Summarize failures in plain language (β€œExpected X but got Y from function Z in file F”). + +5. **Implement the minimal change** + - Use `edit` tools to modify production code. + - When editing: + - Make **small, reviewable diffs**. + - Keep behavior changes tightly scoped to what the tests expect. + - Avoid speculative features or abstractions. + +6. **Re-run tests** + - After each set of changes, run tests again (via `runTests`). + - If additional failures appear, treat them as new feedback and either: + - Adjust tests if they were incorrect, or + - Adjust implementation if behavior should change. + +7. **Refactor with safety** + - Once tests are green and the user is satisfied with behavior: + - Suggest refactorings (naming, decomposition, duplication removal, simplifying conditionals). + - Perform refactors in small steps, re-running tests each time. + - Always keep the system in a state where tests pass. + +8. **Track progress** + - For larger tasks, use the `todos` tool to maintain a checklist: + - Tests to add. + - Cases to generalize. + - Refactors to perform later. + +--- + +## Use of VS Code tools (within this agent) + +When deciding which tools to use, prioritize the built-in Copilot testing and workspace tools: [oai_citation:2‑Visual Studio Code](https://code.visualstudio.com/docs/copilot/reference/copilot-vscode-features) + +- **Search/context** + - `codebase`: Find relevant files and usages automatically when the request is high level (β€œHow is order pricing calculated?”). + - `fileSearch`: Locate files by pattern or name (`*test*`, `order_service.*`, etc.). + - `textSearch`: Find function names, test names, error messages, or TODOs. + +- **Editing** + - `editFiles`: Apply tightly scoped, explicit edits. + - `runVscodeCommand`: Only for safe commands like opening files, focusing views, or triggering built-in test UI commands. + +- **Testing & diagnostics** + - `runTests`: Run tests via the VS Code integrated testing system instead of inventing ad-hoc CLI commands. + - `testFailure`: Pull the stack traces and assertion messages for failing tests and reason about them. + - `problems`: Use diagnostics to catch type errors, lints, and compilation issues that block the TDD loop. + +- **Terminal / tasks (safety rules)** + - `runInTerminal`, `runCommands`, `runTasks`, `getTerminalOutput`, `getTaskOutput`: + - Prefer running **existing test tasks** (like β€œtest” or β€œwatch” tasks) instead of raw commands. + - When you must run a raw command, stick to testing-related commands: + - Examples: `npm test`, `pnpm test`, `yarn test`, `pytest`, `dotnet test`, `mvn test`, `gradle test`. + - **Do not**: + - Install dependencies, + - Run migrations, + - Perform `curl`/`wget`/`ssh` or other network/system-level commands, + - Modify editor/terminal configuration, + unless the user explicitly and knowingly asks for that outcome. + +--- + +## Framework- and language-aware behavior + +Adjust recommendations based on the detected stack and existing patterns in the repo: + +### JavaScript / TypeScript + +- Common frameworks: Jest, Vitest, Mocha, Playwright, Cypress (for e2e). [oai_citation:3‑Visual Studio Code](https://code.visualstudio.com/docs/debugtest/testing?utm_source=chatgpt.com) +- Conventions: + - Use existing test runners and configurations (`jest.config`, `vitest.config`, etc.). + - Match file naming: `*.test.ts`, `*.spec.ts`, `__tests__` folder, or repo-specific conventions. +- TDD style: + - Use descriptive `describe`/`it` blocks for behavior. + - Favor many small tests over a few giant ones. + - Use mocks/spies only where side effects or IO make it necessary. + +### Python + +- Common frameworks: `pytest`, `unittest`. [oai_citation:4‑Visual Studio Code](https://code.visualstudio.com/docs/debugtest/testing?utm_source=chatgpt.com) +- Conventions: + - Respect `tests/` layout and existing fixtures (`conftest.py`, factories, etc.). + - Prefer `pytest` style if the repo already uses it (fixtures, parametrize, simple assertions). +- TDD style: + - Start with simple cases, then parametrized tests for edge cases. + - Avoid hitting real external services; use fixtures or fakes instead. + +### C# / .NET + +- Frameworks: xUnit, NUnit, MSTest. [oai_citation:5‑Visual Studio Code](https://code.visualstudio.com/docs/debugtest/testing?utm_source=chatgpt.com) +- Conventions: + - Follow existing test project structure (e.g., `MyApp.Tests`). + - Reuse existing test base classes and helper methods. +- TDD style: + - Keep tests focused on a single member or behavior. + - Use clear Arrange–Act–Assert structure. + +### Java + +- Frameworks: JUnit (4/5), TestNG. [oai_citation:6‑Visual Studio Code](https://code.visualstudio.com/docs/debugtest/testing?utm_source=chatgpt.com) +- Conventions: + - Match existing naming like `FooServiceTest` or `FooServiceTests`. +- TDD style: + - Prefer simple POJOs and constructor injection to keep tests fast and isolated. + - Only bring in Spring / framework context when absolutely necessary. + +### Other languages + +- Infer preferred frameworks and patterns from existing tests. +- When in doubt, ask the user which framework and style they prefer and then commit to it consistently. + +--- + +## Working with existing TDD content & docs + +When the user wants more background or examples: + +- Use workspace context (`codebase`, `fileSearch`) to show existing TDD-style tests in their repo. +- Draw on the Copilot testing guidance and TDD examples (e.g., `/setupTests`, `/tests`) to recommend commands or flows, but keep the interaction inside the agent’s normal conversation instead of just dumping raw documentation. [oai_citation:7‑Visual Studio Code](https://code.visualstudio.com/docs/copilot/guides/test-with-copilot?utm_source=chatgpt.com) + +--- + +## Communication style + +While helping the user: + +- Be concise, but explicit about **which step of the TDD loop** you are in: + - β€œStep 1: clarify behavior” + - β€œStep 2: write failing test …” + - β€œStep 3: minimal implementation …” +- Prefer short bullet points over long prose. +- When you propose code or test changes, summarize the intent in 1–3 bullets so the user can quickly review them before applying. + +If the user explicitly asks to deviate from TDD, comply, but: +- Briefly highlight the risk (e.g., β€œThis skips tests, so regressions are more likely”) once. +- Then follow their requested workflow without nagging. \ No newline at end of file diff --git a/.github/prompts/plan-testCaseCoverage.prompt.md b/.github/prompts/plan-testCaseCoverage.prompt.md new file mode 100644 index 0000000..3671dde --- /dev/null +++ b/.github/prompts/plan-testCaseCoverage.prompt.md @@ -0,0 +1,146 @@ +# Comprehensive Test Case Documentation and Coverage Strategy + +## Plan Overview + +Draft a systematic approach to identify, document, and implement comprehensive test cases covering 100% of code logic and edge cases. + +## Steps + +1. **Create test case inventory document** in [.github/TEST_CASES.md](.github/TEST_CASES.md) organized by service/feature with categories: Happy Path, Edge Cases, Error Handling, and Concurrency. + +2. **Document TaskItem scoring edge cases**: Test all combinations of Priority (negative, 0, 1-3, >3), Status (pending, in-progress, completed, invalid), Age (0, 7, 14, 30 days), IsCompleted flag, and title word length. + +3. **Document InMemoryTaskService tests**: Cover ID generation thread-safety, concurrent operations, null/empty collections, and boundary conditions (max int ID, duplicate operations). + +4. **Document CsvTaskService tests**: Cover file I/O (missing file, permission denied, corrupted CSV), CSV escaping (quotes, commas, newlines in values), concurrent file access, and recovery scenarios. + +5. **Document API endpoint tests**: Integration tests for all 5 endpoints (GET all, GET by ID, POST create, PUT update, DELETE), status query filtering, response codes, null validations, and request body validation. + +6. **Document validation tests**: Null/empty title handling, negative/zero priority values, invalid status strings, and edge case date values. + +7. **Organize by test class**: Map each test case to the appropriate xUnit test class (create new ones for gaps). + +## Further Considerations + +### 1. Test Case Taxonomy +Question: Should the document group tests by (A) service/component, (B) test type (unit/integration/edge-case), or (C) risk area (data integrity, performance, concurrency)? + +**Recommendation**: Use (A) with subsections for test types. + +### 2. Coverage Metrics +Would you like the document to include coverage % targets per service and a checklist to track implementation progress? + +### 3. CSV File Handling Scope +CsvTaskService has no tests currently. Should this get the same depth of testing as InMemoryTaskService, or a focused subset given it's for persistence demonstration? + +## Key Findings from Analysis + +### Current Test Coverage Status +- **InMemoryTaskService**: 7 tests covering basic CRUD operations +- **TaskItem.GetScore()**: 7 tests covering priority/status combinations +- **CsvTaskService**: Zero tests (gap) +- **API Endpoints**: Zero tests (gap) +- **Validation**: Zero tests (gap) +- **Concurrency**: Zero tests (gap) + +### Critical Areas Requiring Test Coverage + +#### TaskItem.GetScore() Edge Cases +- Priority values: negative, 0, 1, 2, 3, >3 +- Status values: "pending", "in-progress", "completed", invalid/custom +- Age-based escalation: 0, 7, 14, 30+ days old +- Title analysis: word length variations, empty title, very long title +- IsCompleted flag combinations with each status +- Score floor validation (Math.Max(0, ...)) + +#### InMemoryTaskService +- **ID Generation**: Thread-safe increment, max int boundary +- **Concurrent Operations**: Multiple threads reading/writing simultaneously +- **Edge Collections**: Empty list operations, single item, duplicate creates +- **Update/Delete**: Non-existent IDs, null taskItem parameter +- **GetAll with Filtering**: Status query parameter case sensitivity + +#### CsvTaskService (Persistence Layer) +- **File Operations**: Missing file, read-only file, no disk space +- **CSV Escaping**: Titles with commas, quotes, newlines, special characters +- **Data Corruption**: Malformed CSV, invalid record format, incomplete rows +- **Concurrent Access**: Multiple processes reading/writing file simultaneously +- **State Management**: ID counter persistence, recovery from crashes +- **Large Files**: Performance with 1000+, 10000+ records + +#### API Endpoints +- **GET /tasks**: Returns all tasks, empty collection, large result sets +- **GET /tasks?status=X**: Case sensitivity, non-existent status, empty result +- **GET /tasks/{id}**: Valid ID, invalid ID, negative ID, max int ID +- **POST /tasks**: Valid creation, null/empty title, all fields, minimal fields +- **PUT /tasks/{id}**: Valid update, invalid ID, partial update, null values +- **DELETE /tasks/{id}**: Valid delete, invalid ID, delete non-existent + +#### Input Validation +- Null or empty Title field +- Negative, zero, and extreme priority values +- Invalid status strings +- Future-dated CreatedAt values +- Unicode/special characters in title and description + +#### Error Handling & Recovery +- File I/O errors in CSV service +- Concurrent modification exceptions +- Invalid request bodies +- Missing or malformed JSON +- Network timeouts (if applicable) + +#### Performance & Boundary Conditions +- Very large task lists (10000+ items) +- Very long titles/descriptions +- Rapid concurrent operations +- Repeated operations on same task + +## Test Organization Structure + +``` +DotnetApp.Tests/ +β”œβ”€β”€ Models/ +β”‚ └── TaskItemTest.cs (EXISTING - expand) +β”‚ β”œβ”€β”€ GetScore_Priority_* (existing 7 tests) +β”‚ └── [ADD] Edge cases, boundaries, status variations +β”œβ”€β”€ Services/ +β”‚ β”œβ”€β”€ InMemoryTaskServiceTests.cs (EXISTING - expand) +β”‚ β”‚ β”œβ”€β”€ CRUD operations (existing 7 tests) +β”‚ β”‚ └── [ADD] Concurrency, edge cases, filtering +β”‚ └── CsvTaskServiceTests.cs (NEW) +β”‚ β”œβ”€β”€ File I/O operations +β”‚ β”œβ”€β”€ CSV escaping +β”‚ β”œβ”€β”€ Concurrent access +β”‚ └── Recovery scenarios +└── Integration/ + └── TaskApiEndpointTests.cs (NEW) + β”œβ”€β”€ GET /tasks + β”œβ”€β”€ GET /tasks?status=X + β”œβ”€β”€ GET /tasks/{id} + β”œβ”€β”€ POST /tasks + β”œβ”€β”€ PUT /tasks/{id} + └── DELETE /tasks/{id} +``` + +## Implementation Priority + +**Phase 1 (Critical Path)**: TaskItem edge cases + API endpoints +- Covers core business logic and HTTP contract +- Easiest to implement without infrastructure changes + +**Phase 2 (Data Integrity)**: CsvTaskService + Validation +- Ensures persistence layer reliability +- Validates data correctness + +**Phase 3 (Robustness)**: Concurrency + Error scenarios +- Stress tests and failure modes +- Production readiness + +## Success Criteria + +- [ ] All test cases documented in TEST_CASES.md +- [ ] Coverage report shows >90% line coverage +- [ ] All identified edge cases have corresponding tests +- [ ] All critical gaps filled with tests +- [ ] Documentation includes implementation checklist diff --git a/testing-demo.md b/testing-demo.md new file mode 100644 index 0000000..6824a4a --- /dev/null +++ b/testing-demo.md @@ -0,0 +1,6 @@ +## Plan mode +- "I'm looking to write unit tests for this app but i need to be sure they are comprehensive and have as close to 100% test coverage as possible. Can you help me thing through corner cases and uncommon scenarios I may need to test here? I want to log all of them in a file somewhere" +- save to file (i.e., do not start implementation, use other button) +- run prompt file + +## TDD \ No newline at end of file From dca76a9457b4d2c8a14cd40f5766135016865a59 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Wed, 10 Dec 2025 22:36:35 -0600 Subject: [PATCH 45/48] tdd --- tdd-demo/README.md | 78 +++++++++ tdd-demo/cart.py | 207 ++++++++++++++++++++++ tdd-demo/product.py | 54 ++++++ tdd-demo/pytest.ini | 6 + tdd-demo/tests/__init__.py | 1 + tdd-demo/tests/test_cart.py | 310 +++++++++++++++++++++++++++++++++ tdd-demo/tests/test_product.py | 84 +++++++++ testing-demo.md | 76 +++++++- 8 files changed, 815 insertions(+), 1 deletion(-) create mode 100644 tdd-demo/README.md create mode 100644 tdd-demo/cart.py create mode 100644 tdd-demo/product.py create mode 100644 tdd-demo/pytest.ini create mode 100644 tdd-demo/tests/__init__.py create mode 100644 tdd-demo/tests/test_cart.py create mode 100644 tdd-demo/tests/test_product.py diff --git a/tdd-demo/README.md b/tdd-demo/README.md new file mode 100644 index 0000000..8e51720 --- /dev/null +++ b/tdd-demo/README.md @@ -0,0 +1,78 @@ +# πŸ›’ Shopping Cart Pricing Engine - TDD Demo + +A hands-on Test-Driven Development demonstration featuring a realistic pricing engine with bulk discounts, category-based taxes, and shipping calculations. + +## Quick Start + +```bash +cd tdd-demo +pytest -v +``` + +You'll see: **18 passed, 10 failed, 7 skipped** + +## The Challenge + +The `ShoppingCart` needs a **pricing engine** with real business logic: + +### Round 1: `get_subtotal()` with Bulk Discounts +- Calculate subtotal from all items (price Γ— quantity) +- Apply tiered bulk discounts based on total items: + - **10+ items**: 15% off + - **5-9 items**: 10% off + - **3-4 items**: 5% off + - **1-2 items**: no discount + +### Round 2: `get_tax()` with Category-Based Rates +- Each product has a tax category with different rates: + - **Standard**: 8% (general merchandise) + - **Food**: 2% (groceries) + - **Luxury**: 12% (premium items) + - **Exempt**: 0% (gift cards, etc.) +- Tax calculated on **discounted** prices (after bulk discount) + +### Bonus Round: `get_shipping()` +- Free shipping over $50 +- Base rate: $5.99 +- Heavy item surcharge: +$3.00 per item β‰₯ 5 lbs + +## Demo Flow + +### πŸ”΄ Round 1: Subtotal (10 failing tests) +```bash +pytest tests/test_cart.py::TestSubtotalWithBulkDiscounts -v +``` +1. Show failing tests +2. Prompt: *"Fix the failing get_subtotal tests"* +3. Watch AI implement the discount logic +4. Run tests β†’ 🟒 Green! + +### πŸ”΄ Round 2: Tax (9 failing tests) +```bash +pytest tests/test_cart.py::TestTaxCalculation -v +``` +1. Show failing tests +2. Prompt: *"Fix the failing get_tax tests"* +3. Watch AI implement category-based tax calculation +4. Run tests β†’ 🟒 Green! + +## What Makes This Demo Impressive + +- **Real algorithm required**: Can't solve with one-liners +- **Business rules to implement**: Tiered discounts, tax rates +- **Edge cases covered**: Empty cart, rounding, mixed categories +- **Progressive complexity**: Round 2 depends on Round 1 +- **Relatable domain**: Everyone understands shopping carts + +## Project Structure + +``` +tdd-demo/ +β”œβ”€β”€ README.md +β”œβ”€β”€ product.py # Product with categories and weights +β”œβ”€β”€ cart.py # Shopping cart with pricing engine +β”œβ”€β”€ pytest.ini +└── tests/ + β”œβ”€β”€ test_product.py # Product tests (passing) + └── test_cart.py # Cart tests (some failing!) +``` diff --git a/tdd-demo/cart.py b/tdd-demo/cart.py new file mode 100644 index 0000000..9de153d --- /dev/null +++ b/tdd-demo/cart.py @@ -0,0 +1,207 @@ +"""Shopping cart with pricing engine.""" + +from product import Product + + +class CartItem: + """Represents a product with quantity in the cart.""" + + def __init__(self, product: Product, quantity: int = 1): + if quantity < 1: + raise ValueError("Quantity must be at least 1") + self.product = product + self.quantity = quantity + + @property + def line_total(self) -> float: + """Calculate total for this line item (price * quantity).""" + return self.product.price * self.quantity + + def __repr__(self): + return f"CartItem({self.product.name}, qty={self.quantity})" + + +class ShoppingCart: + """ + A shopping cart with full pricing engine. + + Features: + - Quantity management (adding same product increases quantity) + - Tiered bulk discounts (buy more, save more) + - Category-based tax calculation + - Weight-based shipping with free shipping threshold + - Coupon code support + """ + + # Shipping constants + BASE_SHIPPING = 5.99 + FREE_SHIPPING_THRESHOLD = 50.00 + HEAVY_ITEM_SURCHARGE = 3.00 + HEAVY_WEIGHT_THRESHOLD = 5.0 # pounds + + # Bulk discount tiers: (min_quantity, discount_percent) + BULK_DISCOUNT_TIERS = [ + (10, 0.15), # 10+ items: 15% off + (5, 0.10), # 5-9 items: 10% off + (3, 0.05), # 3-4 items: 5% off + ] + + # Valid coupon codes: code -> (discount_type, value, min_purchase) + COUPON_CODES = { + "SAVE10": ("percent", 10, 0), # 10% off, no minimum + "SAVE20": ("percent", 20, 50), # 20% off, $50 minimum + "FLAT15": ("fixed", 15, 30), # $15 off, $30 minimum + "FREESHIP": ("shipping", 100, 25), # Free shipping, $25 minimum + } + + def __init__(self): + """Initialize an empty shopping cart.""" + self._items: dict[str, CartItem] = {} # keyed by product name + self._applied_coupon: str | None = None + + def add_item(self, product: Product, quantity: int = 1) -> None: + """ + Add a product to the cart. + If product already exists, increase its quantity. + """ + if product.name in self._items: + self._items[product.name].quantity += quantity + else: + self._items[product.name] = CartItem(product, quantity) + + def get_item_count(self) -> int: + """Return the total number of items (sum of all quantities).""" + return sum(item.quantity for item in self._items.values()) + + def get_unique_item_count(self) -> int: + """Return the number of unique products in the cart.""" + return len(self._items) + + def is_empty(self) -> bool: + """Return True if the cart is empty.""" + return len(self._items) == 0 + + # ============================================================ + # TDD DEMO ROUND 1: Subtotal with Bulk Discounts + # ============================================================ + + def get_subtotal(self) -> float: + """ + Calculate subtotal with bulk discounts applied. + + Business Rules: + - Sum up (price * quantity) for each item + - Apply bulk discount based on TOTAL items in cart: + - 10+ items: 15% off + - 5-9 items: 10% off + - 3-4 items: 5% off + - 1-2 items: no discount + - Round to 2 decimal places + + TODO: Implement using TDD! + """ + raise NotImplementedError("Implement using TDD!") + + def _get_bulk_discount_rate(self) -> float: + """ + Get the bulk discount rate based on total item count. + Helper method - implement this too! + """ + raise NotImplementedError("Implement using TDD!") + + # ============================================================ + # TDD DEMO ROUND 2: Tax Calculation + # ============================================================ + + def get_tax(self) -> float: + """ + Calculate tax based on each product's category. + + Business Rules: + - Each product has a tax category (standard=8%, food=2%, luxury=12%, exempt=0%) + - Tax is calculated on the DISCOUNTED subtotal for each item + - Apply bulk discount to each line item proportionally before calculating tax + - Round to 2 decimal places + + Example: + - Cart has 5 items total (10% bulk discount applies) + - 3 standard items @ $10 = $30 -> $27 after discount -> $2.16 tax + - 2 food items @ $5 = $10 -> $9 after discount -> $0.18 tax + - Total tax = $2.34 + + TODO: Implement using TDD! + """ + raise NotImplementedError("Implement using TDD!") + + # ============================================================ + # TDD DEMO ROUND 3 (BONUS): Shipping Calculation + # ============================================================ + + def get_shipping(self) -> float: + """ + Calculate shipping cost. + + Business Rules: + - Free shipping if subtotal >= $50 + - Otherwise, base shipping is $5.99 + - Add $3.00 surcharge for each item weighing 5+ pounds + - If FREESHIP coupon is applied, shipping is $0 + - Empty cart = $0 shipping + + TODO: Implement using TDD! + """ + raise NotImplementedError("Implement using TDD!") + + # ============================================================ + # ALREADY IMPLEMENTED (for demo setup) + # ============================================================ + + def apply_coupon(self, code: str) -> bool: + """ + Apply a coupon code to the cart. + Returns True if coupon was valid and applied. + """ + code = code.upper() + if code not in self.COUPON_CODES: + return False + + discount_type, value, min_purchase = self.COUPON_CODES[code] + + # Check minimum purchase requirement + raw_subtotal = sum(item.line_total for item in self._items.values()) + if raw_subtotal < min_purchase: + return False + + self._applied_coupon = code + return True + + def get_coupon_discount(self) -> float: + """Calculate the discount from the applied coupon.""" + if not self._applied_coupon: + return 0.0 + + discount_type, value, _ = self.COUPON_CODES[self._applied_coupon] + + if discount_type == "percent": + # Percentage off subtotal + return round(self.get_subtotal() * (value / 100), 2) + elif discount_type == "fixed": + # Fixed dollar amount off + return min(value, self.get_subtotal()) # Can't exceed subtotal + elif discount_type == "shipping": + # Shipping discount handled in get_shipping() + return 0.0 + + return 0.0 + + def get_total(self) -> float: + """ + Calculate final total: subtotal + tax + shipping - coupon discount. + Note: Requires get_subtotal(), get_tax(), and get_shipping() to work. + """ + subtotal = self.get_subtotal() + tax = self.get_tax() + shipping = self.get_shipping() + coupon_discount = self.get_coupon_discount() + + return round(subtotal + tax + shipping - coupon_discount, 2) diff --git a/tdd-demo/product.py b/tdd-demo/product.py new file mode 100644 index 0000000..5eab563 --- /dev/null +++ b/tdd-demo/product.py @@ -0,0 +1,54 @@ +"""Product model for the shopping cart.""" + + +class Product: + """Represents a product that can be added to a shopping cart.""" + + # Tax categories with different rates + TAX_RATES = { + "standard": 0.08, # 8% - general merchandise + "food": 0.02, # 2% - groceries + "luxury": 0.12, # 12% - luxury items + "exempt": 0.0, # 0% - tax exempt + } + + def __init__(self, name: str, price: float, category: str = "standard", weight: float = 0.5): + """ + Initialize a product. + + Args: + name: The product name + price: The product price (must be non-negative) + category: Tax category (standard, food, luxury, exempt) + weight: Weight in pounds for shipping calculation + """ + if price < 0: + raise ValueError("Price cannot be negative") + if category not in self.TAX_RATES: + raise ValueError(f"Invalid category. Must be one of: {list(self.TAX_RATES.keys())}") + if weight < 0: + raise ValueError("Weight cannot be negative") + + self.name = name + self.price = price + self.category = category + self.weight = weight + + @property + def tax_rate(self) -> float: + """Get the tax rate for this product's category.""" + return self.TAX_RATES[self.category] + + def __eq__(self, other): + """Two products are equal if they have the same name.""" + if not isinstance(other, Product): + return False + return self.name == other.name + + def __hash__(self): + """Hash based on name for use in dictionaries.""" + return hash(self.name) + + def __repr__(self): + """Return string representation of the product.""" + return f"Product('{self.name}', {self.price}, '{self.category}')" diff --git a/tdd-demo/pytest.ini b/tdd-demo/pytest.ini new file mode 100644 index 0000000..9855d94 --- /dev/null +++ b/tdd-demo/pytest.ini @@ -0,0 +1,6 @@ +[pytest] +testpaths = tests +python_files = test_*.py +python_classes = Test* +python_functions = test_* +addopts = -v --tb=short diff --git a/tdd-demo/tests/__init__.py b/tdd-demo/tests/__init__.py new file mode 100644 index 0000000..66173ae --- /dev/null +++ b/tdd-demo/tests/__init__.py @@ -0,0 +1 @@ +# Test package diff --git a/tdd-demo/tests/test_cart.py b/tdd-demo/tests/test_cart.py new file mode 100644 index 0000000..fa96286 --- /dev/null +++ b/tdd-demo/tests/test_cart.py @@ -0,0 +1,310 @@ +"""Tests for the ShoppingCart pricing engine.""" + +import pytest +import sys +import os + +sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) + +from cart import ShoppingCart, CartItem +from product import Product + + +class TestCartBasics: + """Basic cart tests - these already pass!""" + + def test_new_cart_is_empty(self): + """A new shopping cart should be empty.""" + cart = ShoppingCart() + assert cart.is_empty() is True + assert cart.get_item_count() == 0 + + def test_add_single_item(self): + """Adding an item should increase the count.""" + cart = ShoppingCart() + cart.add_item(Product("Apple", 1.99)) + assert cart.get_item_count() == 1 + + def test_add_same_product_increases_quantity(self): + """Adding the same product should increase quantity, not add new item.""" + cart = ShoppingCart() + apple = Product("Apple", 1.99) + + cart.add_item(apple, quantity=2) + cart.add_item(apple, quantity=3) + + assert cart.get_unique_item_count() == 1 # Still one unique product + assert cart.get_item_count() == 5 # But 5 total items + + def test_add_item_with_quantity(self): + """Can add multiple of same item at once.""" + cart = ShoppingCart() + cart.add_item(Product("Apple", 1.99), quantity=5) + assert cart.get_item_count() == 5 + + +class TestSubtotalWithBulkDiscounts: + """ + πŸ”΄ TDD DEMO ROUND 1: Subtotal Calculation with Bulk Discounts + + These tests are FAILING! Implement get_subtotal() to make them pass. + + Business Rules: + - 10+ items: 15% off + - 5-9 items: 10% off + - 3-4 items: 5% off + - 1-2 items: no discount + """ + + # ⬇️ WRITE THIS TEST LIVE DURING DEMO ⬇️ + # def test_empty_cart_has_zero_subtotal(self): + # """An empty cart should have subtotal of 0.""" + # cart = ShoppingCart() + # assert cart.get_subtotal() == 0.0 + + def test_single_item_no_discount(self): + """Single item gets no bulk discount.""" + cart = ShoppingCart() + cart.add_item(Product("Laptop", 100.00)) + + # 1 item = no discount, subtotal = $100 + assert cart.get_subtotal() == 100.00 + + def test_two_items_no_discount(self): + """Two items still get no bulk discount.""" + cart = ShoppingCart() + cart.add_item(Product("Book", 25.00), quantity=2) + + # 2 items = no discount, subtotal = $50 + assert cart.get_subtotal() == 50.00 + + def test_three_items_five_percent_discount(self): + """3-4 items get 5% bulk discount.""" + cart = ShoppingCart() + cart.add_item(Product("Shirt", 20.00), quantity=3) + + # 3 items @ $20 = $60, minus 5% = $57 + assert cart.get_subtotal() == 57.00 + + def test_four_items_five_percent_discount(self): + """4 items still in 5% discount tier.""" + cart = ShoppingCart() + cart.add_item(Product("Mug", 10.00), quantity=4) + + # 4 items @ $10 = $40, minus 5% = $38 + assert cart.get_subtotal() == 38.00 + + def test_five_items_ten_percent_discount(self): + """5-9 items get 10% bulk discount.""" + cart = ShoppingCart() + cart.add_item(Product("Pen", 5.00), quantity=5) + + # 5 items @ $5 = $25, minus 10% = $22.50 + assert cart.get_subtotal() == 22.50 + + def test_nine_items_ten_percent_discount(self): + """9 items still in 10% discount tier.""" + cart = ShoppingCart() + cart.add_item(Product("Notebook", 8.00), quantity=9) + + # 9 items @ $8 = $72, minus 10% = $64.80 + assert cart.get_subtotal() == 64.80 + + def test_ten_items_fifteen_percent_discount(self): + """10+ items get 15% bulk discount.""" + cart = ShoppingCart() + cart.add_item(Product("Sticker", 2.00), quantity=10) + + # 10 items @ $2 = $20, minus 15% = $17 + assert cart.get_subtotal() == 17.00 + + def test_bulk_discount_with_mixed_products(self): + """Bulk discount applies to total item count across all products.""" + cart = ShoppingCart() + cart.add_item(Product("Apple", 1.00), quantity=3) + cart.add_item(Product("Banana", 0.50), quantity=2) + + # 5 total items = 10% discount + # Raw: (3 * $1) + (2 * $0.50) = $4.00 + # After 10% off: $3.60 + assert cart.get_subtotal() == 3.60 + + def test_subtotal_rounds_to_two_decimals(self): + """Subtotal should be rounded to 2 decimal places.""" + cart = ShoppingCart() + # Create a scenario that would produce more than 2 decimals + cart.add_item(Product("Widget", 3.33), quantity=3) + + # 3 items @ $3.33 = $9.99, minus 5% = $9.4905 -> rounds to $9.49 + assert cart.get_subtotal() == 9.49 + + +class TestTaxCalculation: + """ + πŸ”΄ TDD DEMO ROUND 2: Tax Calculation by Category + + These tests are FAILING! Implement get_tax() to make them pass. + + Tax rates by category: + - standard: 8% + - food: 2% + - luxury: 12% + - exempt: 0% + + Tax is calculated on the DISCOUNTED price! + """ + + def test_empty_cart_has_zero_tax(self): + """Empty cart has no tax.""" + cart = ShoppingCart() + assert cart.get_tax() == 0.0 + + def test_standard_tax_rate(self): + """Standard category items have 8% tax.""" + cart = ShoppingCart() + cart.add_item(Product("Laptop", 100.00, category="standard")) + + # 1 item = no bulk discount + # Tax: $100 * 8% = $8.00 + assert cart.get_tax() == 8.00 + + def test_food_tax_rate(self): + """Food category items have 2% tax.""" + cart = ShoppingCart() + cart.add_item(Product("Bread", 5.00, category="food")) + + # 1 item = no bulk discount + # Tax: $5 * 2% = $0.10 + assert cart.get_tax() == 0.10 + + def test_luxury_tax_rate(self): + """Luxury category items have 12% tax.""" + cart = ShoppingCart() + cart.add_item(Product("Watch", 200.00, category="luxury")) + + # 1 item = no bulk discount + # Tax: $200 * 12% = $24.00 + assert cart.get_tax() == 24.00 + + def test_exempt_has_no_tax(self): + """Exempt category items have 0% tax.""" + cart = ShoppingCart() + cart.add_item(Product("Gift Card", 50.00, category="exempt")) + + assert cart.get_tax() == 0.0 + + def test_mixed_categories_tax(self): + """Tax calculated correctly for mixed categories.""" + cart = ShoppingCart() + cart.add_item(Product("Laptop", 100.00, category="standard")) # 8% + cart.add_item(Product("Bread", 10.00, category="food")) # 2% + + # 2 items = no bulk discount + # Standard: $100 * 8% = $8.00 + # Food: $10 * 2% = $0.20 + # Total tax: $8.20 + assert cart.get_tax() == 8.20 + + def test_tax_calculated_on_discounted_subtotal(self): + """Tax should be calculated AFTER bulk discount is applied.""" + cart = ShoppingCart() + cart.add_item(Product("Book", 10.00, category="standard"), quantity=5) + + # 5 items = 10% bulk discount + # Raw: $50, After discount: $45 + # Tax: $45 * 8% = $3.60 + assert cart.get_tax() == 3.60 + + def test_tax_with_mixed_categories_and_bulk_discount(self): + """Complex scenario: mixed categories with bulk discount.""" + cart = ShoppingCart() + cart.add_item(Product("Gadget", 20.00, category="standard"), quantity=3) # 8% + cart.add_item(Product("Snacks", 10.00, category="food"), quantity=2) # 2% + + # 5 total items = 10% bulk discount + # Gadgets: $60 -> $54 after discount -> $54 * 8% = $4.32 + # Snacks: $20 -> $18 after discount -> $18 * 2% = $0.36 + # Total tax: $4.68 + assert cart.get_tax() == 4.68 + + def test_tax_rounds_to_two_decimals(self): + """Tax should be rounded to 2 decimal places.""" + cart = ShoppingCart() + cart.add_item(Product("Item", 33.33, category="standard")) + + # $33.33 * 8% = $2.6664 -> rounds to $2.67 + assert cart.get_tax() == 2.67 + + +class TestShippingCalculation: + """ + πŸ”΄ TDD DEMO ROUND 3 (BONUS): Shipping Calculation + + These tests are SKIPPED. Enable them for an extended demo! + + Rules: + - Free shipping if subtotal >= $50 + - Base shipping: $5.99 + - Heavy item surcharge: +$3.00 per item >= 5 lbs + """ + + @pytest.mark.skip(reason="Bonus round - enable when ready") + def test_empty_cart_no_shipping(self): + """Empty cart has no shipping cost.""" + cart = ShoppingCart() + assert cart.get_shipping() == 0.0 + + @pytest.mark.skip(reason="Bonus round - enable when ready") + def test_base_shipping_under_threshold(self): + """Orders under $50 pay base shipping.""" + cart = ShoppingCart() + cart.add_item(Product("Book", 20.00)) + + assert cart.get_shipping() == 5.99 + + @pytest.mark.skip(reason="Bonus round - enable when ready") + def test_free_shipping_at_threshold(self): + """Orders at exactly $50 get free shipping.""" + cart = ShoppingCart() + cart.add_item(Product("Item", 50.00)) + + assert cart.get_shipping() == 0.0 + + @pytest.mark.skip(reason="Bonus round - enable when ready") + def test_free_shipping_over_threshold(self): + """Orders over $50 get free shipping.""" + cart = ShoppingCart() + cart.add_item(Product("Laptop", 500.00)) + + assert cart.get_shipping() == 0.0 + + @pytest.mark.skip(reason="Bonus round - enable when ready") + def test_heavy_item_surcharge(self): + """Heavy items (5+ lbs) add $3 surcharge each.""" + cart = ShoppingCart() + cart.add_item(Product("Light Item", 10.00, weight=1.0)) + cart.add_item(Product("Heavy Item", 15.00, weight=6.0)) + + # Under $50 threshold, so base shipping applies + # Plus $3 for the heavy item + # $5.99 + $3.00 = $8.99 + assert cart.get_shipping() == 8.99 + + @pytest.mark.skip(reason="Bonus round - enable when ready") + def test_multiple_heavy_items_surcharge(self): + """Each heavy item adds its own surcharge.""" + cart = ShoppingCart() + cart.add_item(Product("Dumbbell", 10.00, weight=10.0), quantity=2) + + # Under $50, base shipping + 2 heavy surcharges + # $5.99 + $3.00 + $3.00 = $11.99 + assert cart.get_shipping() == 11.99 + + @pytest.mark.skip(reason="Bonus round - enable when ready") + def test_heavy_items_still_charged_over_threshold(self): + """Heavy item surcharge applies even with free shipping threshold.""" + cart = ShoppingCart() + cart.add_item(Product("Heavy Expensive", 100.00, weight=8.0)) + + # Over $50 so free base shipping, but still pay heavy surcharge + assert cart.get_shipping() == 3.00 diff --git a/tdd-demo/tests/test_product.py b/tdd-demo/tests/test_product.py new file mode 100644 index 0000000..70f1131 --- /dev/null +++ b/tdd-demo/tests/test_product.py @@ -0,0 +1,84 @@ +"""Tests for the Product class.""" + +import pytest +import sys +import os + +sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) + +from product import Product + + +class TestProduct: + """Test suite for Product.""" + + def test_create_product_with_name_and_price(self): + """A product should have a name and price.""" + product = Product("Apple", 1.99) + + assert product.name == "Apple" + assert product.price == 1.99 + + def test_product_has_default_category(self): + """Products default to 'standard' category.""" + product = Product("Apple", 1.99) + assert product.category == "standard" + + def test_product_with_custom_category(self): + """Products can have a custom tax category.""" + product = Product("Bread", 3.99, category="food") + assert product.category == "food" + + def test_product_tax_rate_standard(self): + """Standard products have 8% tax rate.""" + product = Product("Laptop", 999.99, category="standard") + assert product.tax_rate == 0.08 + + def test_product_tax_rate_food(self): + """Food products have 2% tax rate.""" + product = Product("Milk", 4.99, category="food") + assert product.tax_rate == 0.02 + + def test_product_tax_rate_luxury(self): + """Luxury products have 12% tax rate.""" + product = Product("Watch", 5000.00, category="luxury") + assert product.tax_rate == 0.12 + + def test_product_tax_rate_exempt(self): + """Exempt products have 0% tax rate.""" + product = Product("Gift Card", 50.00, category="exempt") + assert product.tax_rate == 0.0 + + def test_product_price_cannot_be_negative(self): + """Creating a product with negative price should raise ValueError.""" + with pytest.raises(ValueError, match="Price cannot be negative"): + Product("Apple", -1.00) + + def test_invalid_category_raises_error(self): + """Invalid category should raise ValueError.""" + with pytest.raises(ValueError, match="Invalid category"): + Product("Item", 10.00, category="invalid") + + def test_product_has_default_weight(self): + """Products have a default weight of 0.5 lbs.""" + product = Product("Apple", 1.99) + assert product.weight == 0.5 + + def test_product_with_custom_weight(self): + """Products can have a custom weight.""" + product = Product("Dumbbell", 29.99, weight=10.0) + assert product.weight == 10.0 + + def test_product_equality_by_name(self): + """Two products with same name are equal.""" + product1 = Product("Apple", 1.99) + product2 = Product("Apple", 2.99) # Different price + + assert product1 == product2 + + def test_product_inequality_different_name(self): + """Products with different names are not equal.""" + product1 = Product("Apple", 1.99) + product2 = Product("Orange", 1.99) + + assert product1 != product2 diff --git a/testing-demo.md b/testing-demo.md index 6824a4a..09fa368 100644 --- a/testing-demo.md +++ b/testing-demo.md @@ -1,6 +1,80 @@ +## are there tests in this app + ## Plan mode - "I'm looking to write unit tests for this app but i need to be sure they are comprehensive and have as close to 100% test coverage as possible. Can you help me thing through corner cases and uncommon scenarios I may need to test here? I want to log all of them in a file somewhere" - save to file (i.e., do not start implementation, use other button) - run prompt file -## TDD \ No newline at end of file +## execute / write tests / agent mode + +## TDD (Agentic Demo) + +### Setup +```bash +cd tdd-demo +pytest -v +``` +You'll see: **17 passed, 18 failed, 7 skipped** + +--- + +### πŸ“ Round 0: Write Your First Test (Live!) + +**Show the TDD philosophy - test FIRST, then code** + +1. Open `tests/test_cart.py` - show the commented-out first test +2. Uncomment or write this test live: + ```python + def test_empty_cart_has_zero_subtotal(self): + """An empty cart should have subtotal of 0.""" + cart = ShoppingCart() + assert cart.get_subtotal() == 0.0 + ``` +3. Run: `pytest tests/test_cart.py::TestSubtotalWithBulkDiscounts::test_empty_cart_has_zero_subtotal -v` +4. Watch it fail! πŸ”΄ `NotImplementedError: Implement using TDD!` +5. **Talking point:** "Now we have a failing test. In true TDD, we write the minimum code to pass." + +--- + +### πŸ”΄ Round 1: `get_subtotal()` with Bulk Discounts (9 more pre-written tests) + +**The Challenge:** Implement tiered bulk discounts +- 10+ items: 15% off +- 5-9 items: 10% off +- 3-4 items: 5% off +- 1-2 items: no discount + +**Demo Steps:** +1. **"I've already written the remaining tests. Let's see what else needs to pass."** +2. Run: `pytest tests/test_cart.py::TestSubtotalWithBulkDiscounts -v` +3. Show all 10 failing tests (including yours from Round 0) +4. Prompt: *"Fix the failing get_subtotal tests in cart.py"* +5. Watch AI implement the discount tier logic +6. Run tests β†’ 🟒 10 tests pass! + +--- + +### πŸ”΄ Round 2: `get_tax()` with Category-Based Rates (9 failing tests) + +**The Challenge:** Calculate tax per product category, on discounted prices +- Standard: 8%, Food: 2%, Luxury: 12%, Exempt: 0% +- Tax applies AFTER bulk discount + +**Demo Steps:** +1. Run: `pytest tests/test_cart.py::TestTaxCalculation -v` +2. Show the 9 failing tests +3. Prompt: *"Fix the failing get_tax tests in cart.py"* +4. Watch AI implement category-based tax calculation +5. Run tests β†’ 🟒 All 19 tests pass! + +--- + +### Key Talking Points +- **Round 0** shows the TDD philosophy: test first +- **Rounds 1-2** show realistic workflow: tests exist, AI implements +- Real algorithms required (not one-liners!) +- AI reads test expectations and business rules from docstrings +- Round 2 depends on Round 1 (tax uses discounted subtotal) +- 7 more skipped tests for bonus round (shipping calculation) + +## MCP \ No newline at end of file From ce7428672dc1cbbf1f225941436c966ada806b59 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Thu, 11 Dec 2025 09:11:32 -0600 Subject: [PATCH 46/48] test-data demo --- test-data-demo/README.md | 57 +++++++++ test-data-demo/data_loader.py | 76 ++++++++++++ test-data-demo/models.py | 107 ++++++++++++++++ test-data-demo/order_processor.py | 102 ++++++++++++++++ test-data-demo/tests/__init__.py | 0 test-data-demo/tests/conftest.py | 35 ++++++ test-data-demo/tests/fixtures/README.md | 11 ++ test-data-demo/tests/test_customer.py | 67 ++++++++++ test-data-demo/tests/test_integration.py | 100 +++++++++++++++ test-data-demo/tests/test_order.py | 149 +++++++++++++++++++++++ test-data-demo/tests/test_product.py | 95 +++++++++++++++ testing-demo.md | 8 +- 12 files changed, 805 insertions(+), 2 deletions(-) create mode 100644 test-data-demo/README.md create mode 100644 test-data-demo/data_loader.py create mode 100644 test-data-demo/models.py create mode 100644 test-data-demo/order_processor.py create mode 100644 test-data-demo/tests/__init__.py create mode 100644 test-data-demo/tests/conftest.py create mode 100644 test-data-demo/tests/fixtures/README.md create mode 100644 test-data-demo/tests/test_customer.py create mode 100644 test-data-demo/tests/test_integration.py create mode 100644 test-data-demo/tests/test_order.py create mode 100644 test-data-demo/tests/test_product.py diff --git a/test-data-demo/README.md b/test-data-demo/README.md new file mode 100644 index 0000000..3cb5766 --- /dev/null +++ b/test-data-demo/README.md @@ -0,0 +1,57 @@ +# Test Data Generation Demo + +This demo showcases using GitHub Copilot to generate test data for an existing test suite. + +## Overview + +This is a simple **Order Processing System** that validates and processes customer orders. The tests are already written but are missing the test data fixtures needed to run them. + +## The Challenge + +The test files in `tests/` reference data fixtures that don't exist yet: +- `tests/fixtures/sample_customers.json` - Customer records for testing +- `tests/fixtures/sample_orders.json` - Order records for testing +- `tests/fixtures/sample_products.json` - Product catalog for testing + +## Demo Goals + +Use Copilot to: +1. Generate realistic test data that matches the expected schemas +2. Create edge case data for boundary testing +3. Generate data that covers various validation scenarios + +## Running Tests + +```bash +cd test-data-demo +pip install pytest +pytest -v +``` + +**Note:** Tests will fail until the fixture data is generated! + +## Data Models + +### Customer +- `id`: string (UUID format) +- `name`: string +- `email`: string (valid email format) +- `membership_level`: string ("bronze", "silver", "gold", "platinum") +- `created_at`: string (ISO date format) + +### Product +- `id`: string (UUID format) +- `name`: string +- `price`: float (positive) +- `category`: string +- `in_stock`: boolean +- `stock_quantity`: integer + +### Order +- `id`: string (UUID format) +- `customer_id`: string (must match a customer) +- `items`: list of order items + - `product_id`: string + - `quantity`: integer (positive) +- `status`: string ("pending", "confirmed", "shipped", "delivered", "cancelled") +- `order_date`: string (ISO date format) diff --git a/test-data-demo/data_loader.py b/test-data-demo/data_loader.py new file mode 100644 index 0000000..fa90c18 --- /dev/null +++ b/test-data-demo/data_loader.py @@ -0,0 +1,76 @@ +"""Utilities for loading test data from JSON fixtures.""" + +import json +import os +from typing import List +from models import Customer, Product, Order, OrderItem + + +FIXTURES_DIR = os.path.join(os.path.dirname(__file__), "tests", "fixtures") + + +def load_customers(filepath: str = None) -> List[Customer]: + """Load customers from a JSON file.""" + if filepath is None: + filepath = os.path.join(FIXTURES_DIR, "sample_customers.json") + + with open(filepath, "r") as f: + data = json.load(f) + + return [ + Customer( + id=c["id"], + name=c["name"], + email=c["email"], + membership_level=c["membership_level"], + created_at=c["created_at"] + ) + for c in data + ] + + +def load_products(filepath: str = None) -> List[Product]: + """Load products from a JSON file.""" + if filepath is None: + filepath = os.path.join(FIXTURES_DIR, "sample_products.json") + + with open(filepath, "r") as f: + data = json.load(f) + + return [ + Product( + id=p["id"], + name=p["name"], + price=p["price"], + category=p["category"], + in_stock=p["in_stock"], + stock_quantity=p["stock_quantity"] + ) + for p in data + ] + + +def load_orders(filepath: str = None) -> List[Order]: + """Load orders from a JSON file.""" + if filepath is None: + filepath = os.path.join(FIXTURES_DIR, "sample_orders.json") + + with open(filepath, "r") as f: + data = json.load(f) + + orders = [] + for o in data: + items = [ + OrderItem(product_id=i["product_id"], quantity=i["quantity"]) + for i in o["items"] + ] + orders.append( + Order( + id=o["id"], + customer_id=o["customer_id"], + items=items, + status=o["status"], + order_date=o["order_date"] + ) + ) + return orders diff --git a/test-data-demo/models.py b/test-data-demo/models.py new file mode 100644 index 0000000..9a37e4d --- /dev/null +++ b/test-data-demo/models.py @@ -0,0 +1,107 @@ +"""Data models for the order processing system.""" + +from dataclasses import dataclass +from typing import List +import re +from datetime import datetime + + +@dataclass +class Customer: + id: str + name: str + email: str + membership_level: str + created_at: str + + VALID_MEMBERSHIP_LEVELS = ("bronze", "silver", "gold", "platinum") + + def is_valid(self) -> bool: + """Validate the customer data.""" + if not self.id or not self.name: + return False + if not self._is_valid_email(self.email): + return False + if self.membership_level not in self.VALID_MEMBERSHIP_LEVELS: + return False + return True + + def _is_valid_email(self, email: str) -> bool: + """Check if email format is valid.""" + pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$' + return bool(re.match(pattern, email)) + + def get_discount_rate(self) -> float: + """Get discount rate based on membership level.""" + discounts = { + "bronze": 0.0, + "silver": 0.05, + "gold": 0.10, + "platinum": 0.15 + } + return discounts.get(self.membership_level, 0.0) + + +@dataclass +class Product: + id: str + name: str + price: float + category: str + in_stock: bool + stock_quantity: int + + def is_valid(self) -> bool: + """Validate the product data.""" + if not self.id or not self.name: + return False + if self.price <= 0: + return False + if self.stock_quantity < 0: + return False + return True + + def is_available(self, quantity: int) -> bool: + """Check if the requested quantity is available.""" + return self.in_stock and self.stock_quantity >= quantity + + +@dataclass +class OrderItem: + product_id: str + quantity: int + + def is_valid(self) -> bool: + """Validate the order item.""" + return bool(self.product_id) and self.quantity > 0 + + +@dataclass +class Order: + id: str + customer_id: str + items: List[OrderItem] + status: str + order_date: str + + VALID_STATUSES = ("pending", "confirmed", "shipped", "delivered", "cancelled") + + def is_valid(self) -> bool: + """Validate the order data.""" + if not self.id or not self.customer_id: + return False + if not self.items: + return False + if self.status not in self.VALID_STATUSES: + return False + if not all(item.is_valid() for item in self.items): + return False + return True + + def can_be_cancelled(self) -> bool: + """Check if the order can be cancelled.""" + return self.status in ("pending", "confirmed") + + def get_total_items(self) -> int: + """Get total number of items in the order.""" + return sum(item.quantity for item in self.items) diff --git a/test-data-demo/order_processor.py b/test-data-demo/order_processor.py new file mode 100644 index 0000000..7aed18c --- /dev/null +++ b/test-data-demo/order_processor.py @@ -0,0 +1,102 @@ +"""Order processing logic.""" + +from typing import Dict, List, Optional, Tuple +from models import Customer, Product, Order, OrderItem + + +class OrderProcessor: + """Handles order validation and processing.""" + + def __init__(self, customers: List[Customer], products: List[Product]): + self.customers = {c.id: c for c in customers} + self.products = {p.id: p for p in products} + + def get_customer(self, customer_id: str) -> Optional[Customer]: + """Retrieve a customer by ID.""" + return self.customers.get(customer_id) + + def get_product(self, product_id: str) -> Optional[Product]: + """Retrieve a product by ID.""" + return self.products.get(product_id) + + def validate_order(self, order: Order) -> Tuple[bool, List[str]]: + """ + Validate an order and return validation result with error messages. + """ + errors = [] + + if not order.is_valid(): + errors.append("Order has invalid structure") + return False, errors + + # Validate customer exists + customer = self.get_customer(order.customer_id) + if not customer: + errors.append(f"Customer {order.customer_id} not found") + + # Validate each item + for item in order.items: + product = self.get_product(item.product_id) + if not product: + errors.append(f"Product {item.product_id} not found") + elif not product.is_available(item.quantity): + errors.append( + f"Product {product.name} has insufficient stock " + f"(requested: {item.quantity}, available: {product.stock_quantity})" + ) + + return len(errors) == 0, errors + + def calculate_order_total(self, order: Order) -> float: + """Calculate the total price for an order including discounts.""" + if not order.is_valid(): + return 0.0 + + subtotal = 0.0 + for item in order.items: + product = self.get_product(item.product_id) + if product: + subtotal += product.price * item.quantity + + # Apply customer discount + customer = self.get_customer(order.customer_id) + if customer: + discount_rate = customer.get_discount_rate() + subtotal *= (1 - discount_rate) + + return round(subtotal, 2) + + def process_order(self, order: Order) -> Tuple[bool, str]: + """ + Process an order: validate, calculate total, and update stock. + Returns success status and message. + """ + is_valid, errors = self.validate_order(order) + if not is_valid: + return False, f"Order validation failed: {'; '.join(errors)}" + + # Update stock quantities + for item in order.items: + product = self.get_product(item.product_id) + if product: + product.stock_quantity -= item.quantity + if product.stock_quantity == 0: + product.in_stock = False + + total = self.calculate_order_total(order) + return True, f"Order processed successfully. Total: ${total:.2f}" + + def get_orders_by_status(self, orders: List[Order], status: str) -> List[Order]: + """Filter orders by status.""" + return [o for o in orders if o.status == status] + + def get_customer_orders(self, orders: List[Order], customer_id: str) -> List[Order]: + """Get all orders for a specific customer.""" + return [o for o in orders if o.customer_id == customer_id] + + def get_low_stock_products(self, threshold: int = 5) -> List[Product]: + """Get products with stock below the threshold.""" + return [ + p for p in self.products.values() + if p.stock_quantity <= threshold + ] diff --git a/test-data-demo/tests/__init__.py b/test-data-demo/tests/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/test-data-demo/tests/conftest.py b/test-data-demo/tests/conftest.py new file mode 100644 index 0000000..132ab9b --- /dev/null +++ b/test-data-demo/tests/conftest.py @@ -0,0 +1,35 @@ +"""Test fixtures and data loading for tests.""" + +import pytest +import os +import sys + +# Add parent directory to path for imports +sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) + +from data_loader import load_customers, load_products, load_orders + + +@pytest.fixture +def sample_customers(): + """Load sample customers from fixtures.""" + return load_customers() + + +@pytest.fixture +def sample_products(): + """Load sample products from fixtures.""" + return load_products() + + +@pytest.fixture +def sample_orders(): + """Load sample orders from fixtures.""" + return load_orders() + + +@pytest.fixture +def order_processor(sample_customers, sample_products): + """Create an OrderProcessor with sample data.""" + from order_processor import OrderProcessor + return OrderProcessor(sample_customers, sample_products) diff --git a/test-data-demo/tests/fixtures/README.md b/test-data-demo/tests/fixtures/README.md new file mode 100644 index 0000000..76c9443 --- /dev/null +++ b/test-data-demo/tests/fixtures/README.md @@ -0,0 +1,11 @@ +# Test Data Fixtures + +This directory should contain the following JSON fixture files: + +- `sample_customers.json` - Customer test data +- `sample_products.json` - Product test data +- `sample_orders.json` - Order test data + +**These files are intentionally missing for the demo!** + +Use GitHub Copilot to generate realistic test data that matches the schemas defined in the main README. diff --git a/test-data-demo/tests/test_customer.py b/test-data-demo/tests/test_customer.py new file mode 100644 index 0000000..35b7e44 --- /dev/null +++ b/test-data-demo/tests/test_customer.py @@ -0,0 +1,67 @@ +"""Tests for Customer model.""" + +import pytest +import os +import sys + +sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) + +from models import Customer + + +class TestCustomerValidation: + """Test customer validation logic.""" + + def test_valid_customers_pass_validation(self, sample_customers): + """All sample customers should pass validation.""" + for customer in sample_customers: + assert customer.is_valid(), f"Customer {customer.id} should be valid" + + def test_customer_has_valid_email_format(self, sample_customers): + """All customers should have valid email addresses.""" + for customer in sample_customers: + assert "@" in customer.email, f"Customer {customer.name} has invalid email" + assert "." in customer.email.split("@")[1], f"Customer {customer.name} has invalid email domain" + + def test_customer_membership_levels_are_valid(self, sample_customers): + """All customers should have valid membership levels.""" + valid_levels = Customer.VALID_MEMBERSHIP_LEVELS + for customer in sample_customers: + assert customer.membership_level in valid_levels, \ + f"Customer {customer.name} has invalid membership level: {customer.membership_level}" + + def test_customers_have_unique_ids(self, sample_customers): + """All customers should have unique IDs.""" + ids = [c.id for c in sample_customers] + assert len(ids) == len(set(ids)), "Customer IDs are not unique" + + def test_customers_have_unique_emails(self, sample_customers): + """All customers should have unique emails.""" + emails = [c.email for c in sample_customers] + assert len(emails) == len(set(emails)), "Customer emails are not unique" + + +class TestCustomerDiscounts: + """Test customer discount rate logic.""" + + def test_discount_rates_by_membership(self, sample_customers): + """Verify discount rates are correct for each membership level.""" + expected_discounts = { + "bronze": 0.0, + "silver": 0.05, + "gold": 0.10, + "platinum": 0.15 + } + + for customer in sample_customers: + expected = expected_discounts[customer.membership_level] + actual = customer.get_discount_rate() + assert actual == expected, \ + f"Customer {customer.name} ({customer.membership_level}) has wrong discount rate" + + def test_has_customers_at_each_membership_level(self, sample_customers): + """Sample data should include at least one customer at each level.""" + levels_present = {c.membership_level for c in sample_customers} + for level in Customer.VALID_MEMBERSHIP_LEVELS: + assert level in levels_present, \ + f"No sample customer with membership level '{level}'" diff --git a/test-data-demo/tests/test_integration.py b/test-data-demo/tests/test_integration.py new file mode 100644 index 0000000..696289a --- /dev/null +++ b/test-data-demo/tests/test_integration.py @@ -0,0 +1,100 @@ +"""Integration tests for the order processing system.""" + +import pytest +import os +import sys + +sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) + + +class TestDataIntegrity: + """Test that all fixture data works together correctly.""" + + def test_all_fixtures_load_successfully(self, sample_customers, sample_products, sample_orders): + """All fixture files should load without errors.""" + assert len(sample_customers) > 0, "No customers loaded" + assert len(sample_products) > 0, "No products loaded" + assert len(sample_orders) > 0, "No orders loaded" + + def test_minimum_data_requirements(self, sample_customers, sample_products, sample_orders): + """Fixtures should have minimum required data for meaningful tests.""" + assert len(sample_customers) >= 5, "Need at least 5 customers for tests" + assert len(sample_products) >= 10, "Need at least 10 products for tests" + assert len(sample_orders) >= 8, "Need at least 8 orders for tests" + + def test_order_customer_references_are_valid(self, sample_customers, sample_orders): + """All order customer_ids should reference actual customers.""" + customer_ids = {c.id for c in sample_customers} + + for order in sample_orders: + assert order.customer_id in customer_ids, \ + f"Order {order.id} references unknown customer {order.customer_id}" + + def test_order_product_references_are_valid(self, sample_products, sample_orders): + """All order product_ids should reference actual products.""" + product_ids = {p.id for p in sample_products} + + for order in sample_orders: + for item in order.items: + assert item.product_id in product_ids, \ + f"Order {order.id} references unknown product {item.product_id}" + + +class TestEndToEndScenarios: + """End-to-end scenario tests.""" + + def test_process_valid_order_workflow(self, order_processor, sample_orders, sample_products): + """Test complete order processing workflow.""" + # Find an order with in-stock items + in_stock_ids = {p.id for p in sample_products if p.in_stock and p.stock_quantity >= 5} + + valid_order = None + for order in sample_orders: + if all(item.product_id in in_stock_ids and item.quantity <= 5 for item in order.items): + valid_order = order + break + + if valid_order: + is_valid, errors = order_processor.validate_order(valid_order) + # Order should be valid if products have sufficient stock + + def test_low_stock_detection(self, order_processor, sample_products): + """Test detection of low stock products.""" + low_stock = order_processor.get_low_stock_products(threshold=10) + + # Verify all returned products are actually low stock + for product in low_stock: + assert product.stock_quantity <= 10 + + def test_customer_order_history(self, order_processor, sample_orders, sample_customers): + """Test retrieving customer order history.""" + # Find a customer with orders + for customer in sample_customers: + orders = order_processor.get_customer_orders(sample_orders, customer.id) + for order in orders: + assert order.customer_id == customer.id + + +class TestEdgeCases: + """Test edge cases in the data.""" + + def test_has_high_value_order(self, order_processor, sample_orders): + """Sample data should include at least one high-value order.""" + totals = [order_processor.calculate_order_total(o) for o in sample_orders] + max_total = max(totals) + assert max_total >= 100, "No high-value orders in sample data" + + def test_has_single_item_order(self, sample_orders): + """Sample data should include orders with single items.""" + single_item_orders = [o for o in sample_orders if len(o.items) == 1] + assert len(single_item_orders) > 0, "No single-item orders in sample data" + + def test_has_multi_item_order(self, sample_orders): + """Sample data should include orders with multiple items.""" + multi_item_orders = [o for o in sample_orders if len(o.items) > 1] + assert len(multi_item_orders) > 0, "No multi-item orders in sample data" + + def test_has_cancelled_order(self, sample_orders): + """Sample data should include at least one cancelled order.""" + cancelled = [o for o in sample_orders if o.status == "cancelled"] + assert len(cancelled) > 0, "No cancelled orders in sample data" diff --git a/test-data-demo/tests/test_order.py b/test-data-demo/tests/test_order.py new file mode 100644 index 0000000..79dd110 --- /dev/null +++ b/test-data-demo/tests/test_order.py @@ -0,0 +1,149 @@ +"""Tests for Order model and OrderProcessor.""" + +import pytest +import os +import sys + +sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) + +from models import Order, OrderItem + + +class TestOrderValidation: + """Test order validation logic.""" + + def test_valid_orders_pass_validation(self, sample_orders): + """All sample orders should pass basic validation.""" + for order in sample_orders: + assert order.is_valid(), f"Order {order.id} should be valid" + + def test_orders_have_valid_status(self, sample_orders): + """All orders should have valid status values.""" + for order in sample_orders: + assert order.status in Order.VALID_STATUSES, \ + f"Order {order.id} has invalid status: {order.status}" + + def test_orders_have_at_least_one_item(self, sample_orders): + """All orders should have at least one item.""" + for order in sample_orders: + assert len(order.items) > 0, f"Order {order.id} has no items" + + def test_order_items_have_positive_quantities(self, sample_orders): + """All order items should have positive quantities.""" + for order in sample_orders: + for item in order.items: + assert item.quantity > 0, \ + f"Order {order.id} has item with non-positive quantity" + + def test_orders_have_unique_ids(self, sample_orders): + """All orders should have unique IDs.""" + ids = [o.id for o in sample_orders] + assert len(ids) == len(set(ids)), "Order IDs are not unique" + + +class TestOrderStatuses: + """Test order status distribution and logic.""" + + def test_has_orders_in_each_status(self, sample_orders): + """Sample data should include orders in various statuses.""" + statuses_present = {o.status for o in sample_orders} + + # Should have at least pending and delivered orders + assert "pending" in statuses_present, "No pending orders in sample data" + assert "delivered" in statuses_present, "No delivered orders in sample data" + + def test_cancellable_orders(self, sample_orders): + """Test can_be_cancelled logic on sample orders.""" + cancellable = [o for o in sample_orders if o.can_be_cancelled()] + non_cancellable = [o for o in sample_orders if not o.can_be_cancelled()] + + # Verify cancellable orders have correct statuses + for order in cancellable: + assert order.status in ("pending", "confirmed"), \ + f"Order {order.id} should not be cancellable with status {order.status}" + + # Verify non-cancellable orders have correct statuses + for order in non_cancellable: + assert order.status in ("shipped", "delivered", "cancelled"), \ + f"Order {order.id} should be cancellable with status {order.status}" + + +class TestOrderProcessorValidation: + """Test OrderProcessor validation.""" + + def test_orders_reference_valid_customers(self, order_processor, sample_orders): + """All orders should reference existing customers.""" + for order in sample_orders: + customer = order_processor.get_customer(order.customer_id) + assert customer is not None, \ + f"Order {order.id} references non-existent customer {order.customer_id}" + + def test_order_items_reference_valid_products(self, order_processor, sample_orders): + """All order items should reference existing products.""" + for order in sample_orders: + for item in order.items: + product = order_processor.get_product(item.product_id) + assert product is not None, \ + f"Order {order.id} references non-existent product {item.product_id}" + + def test_validate_order_returns_success_for_valid_orders(self, order_processor, sample_orders, sample_products): + """Valid orders should pass processor validation.""" + # Find orders that reference in-stock products + in_stock_product_ids = { + p.id for p in sample_products if p.in_stock and p.stock_quantity > 0 + } + + for order in sample_orders: + # Check if all items are for in-stock products + all_in_stock = all( + item.product_id in in_stock_product_ids + for item in order.items + ) + + if all_in_stock: + is_valid, errors = order_processor.validate_order(order) + # Note: may fail due to quantity issues, which is okay + + +class TestOrderCalculations: + """Test order total calculations.""" + + def test_calculate_total_returns_positive_for_valid_orders(self, order_processor, sample_orders): + """Order totals should be positive for valid orders.""" + for order in sample_orders: + total = order_processor.calculate_order_total(order) + assert total >= 0, f"Order {order.id} has negative total" + + def test_platinum_customers_get_best_discount(self, order_processor, sample_customers, sample_orders): + """Platinum customers should have lowest totals for same items.""" + platinum_customers = [c for c in sample_customers if c.membership_level == "platinum"] + bronze_customers = [c for c in sample_customers if c.membership_level == "bronze"] + + assert len(platinum_customers) > 0, "No platinum customers to test" + assert len(bronze_customers) > 0, "No bronze customers to test" + + def test_get_total_items_is_correct(self, sample_orders): + """get_total_items should return correct count.""" + for order in sample_orders: + expected = sum(item.quantity for item in order.items) + actual = order.get_total_items() + assert actual == expected, \ + f"Order {order.id} total items mismatch: expected {expected}, got {actual}" + + +class TestOrderFiltering: + """Test order filtering methods.""" + + def test_filter_by_status(self, order_processor, sample_orders): + """Should correctly filter orders by status.""" + for status in Order.VALID_STATUSES: + filtered = order_processor.get_orders_by_status(sample_orders, status) + for order in filtered: + assert order.status == status + + def test_filter_by_customer(self, order_processor, sample_orders, sample_customers): + """Should correctly filter orders by customer.""" + for customer in sample_customers: + filtered = order_processor.get_customer_orders(sample_orders, customer.id) + for order in filtered: + assert order.customer_id == customer.id diff --git a/test-data-demo/tests/test_product.py b/test-data-demo/tests/test_product.py new file mode 100644 index 0000000..9bbe951 --- /dev/null +++ b/test-data-demo/tests/test_product.py @@ -0,0 +1,95 @@ +"""Tests for Product model.""" + +import pytest +import os +import sys + +sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) + +from models import Product + + +class TestProductValidation: + """Test product validation logic.""" + + def test_valid_products_pass_validation(self, sample_products): + """All sample products should pass validation.""" + for product in sample_products: + assert product.is_valid(), f"Product {product.id} should be valid" + + def test_products_have_positive_prices(self, sample_products): + """All products should have positive prices.""" + for product in sample_products: + assert product.price > 0, f"Product {product.name} has non-positive price" + + def test_products_have_non_negative_stock(self, sample_products): + """All products should have non-negative stock quantities.""" + for product in sample_products: + assert product.stock_quantity >= 0, \ + f"Product {product.name} has negative stock" + + def test_products_have_unique_ids(self, sample_products): + """All products should have unique IDs.""" + ids = [p.id for p in sample_products] + assert len(ids) == len(set(ids)), "Product IDs are not unique" + + def test_products_have_categories(self, sample_products): + """All products should have a category assigned.""" + for product in sample_products: + assert product.category, f"Product {product.name} has no category" + + +class TestProductAvailability: + """Test product availability logic.""" + + def test_in_stock_products_have_positive_quantity(self, sample_products): + """Products marked as in_stock should have positive quantity.""" + for product in sample_products: + if product.in_stock: + assert product.stock_quantity > 0, \ + f"Product {product.name} is in_stock but has zero quantity" + + def test_out_of_stock_products_have_zero_quantity(self, sample_products): + """Products not in_stock should have zero quantity.""" + for product in sample_products: + if not product.in_stock: + assert product.stock_quantity == 0, \ + f"Product {product.name} is not in_stock but has quantity" + + def test_availability_check_works(self, sample_products): + """is_available should return correct results.""" + for product in sample_products: + if product.in_stock and product.stock_quantity >= 1: + assert product.is_available(1), \ + f"Product {product.name} should be available for quantity 1" + + # Should not be available for more than stock + assert not product.is_available(product.stock_quantity + 1), \ + f"Product {product.name} should not be available for quantity exceeding stock" + + def test_has_mix_of_stock_statuses(self, sample_products): + """Sample data should include both in-stock and out-of-stock products.""" + in_stock = [p for p in sample_products if p.in_stock] + out_of_stock = [p for p in sample_products if not p.in_stock] + + assert len(in_stock) > 0, "No in-stock products in sample data" + assert len(out_of_stock) > 0, "No out-of-stock products in sample data" + + +class TestProductCategories: + """Test product categorization.""" + + def test_has_multiple_categories(self, sample_products): + """Sample data should have products in multiple categories.""" + categories = {p.category for p in sample_products} + assert len(categories) >= 3, \ + f"Expected at least 3 categories, found: {categories}" + + def test_price_ranges_are_realistic(self, sample_products): + """Products should have a range of prices.""" + prices = [p.price for p in sample_products] + min_price = min(prices) + max_price = max(prices) + + assert min_price < 50, "No low-priced items in sample data" + assert max_price > 100, "No high-priced items in sample data" diff --git a/testing-demo.md b/testing-demo.md index 09fa368..b0465b6 100644 --- a/testing-demo.md +++ b/testing-demo.md @@ -1,7 +1,8 @@ ## are there tests in this app +- "are there any unit tests already in this app? if so can you run them to see if they pass? if they don't can you fix them?" ## Plan mode -- "I'm looking to write unit tests for this app but i need to be sure they are comprehensive and have as close to 100% test coverage as possible. Can you help me thing through corner cases and uncommon scenarios I may need to test here? I want to log all of them in a file somewhere" +- "I'm looking to write unit tests for this app but I need to be sure they are comprehensive and have as close to 100% test coverage as possible. Can you help me think through corner cases and uncommon scenarios I may need to test here? I want to log all of them in a file somewhere" - save to file (i.e., do not start implementation, use other button) - run prompt file @@ -77,4 +78,7 @@ You'll see: **17 passed, 18 failed, 7 skipped** - Round 2 depends on Round 1 (tax uses discounted subtotal) - 7 more skipped tests for bonus round (shipping calculation) -## MCP \ No newline at end of file +## MCP + +## Test data generation +- "can you generate test data for this app? In particular I need to popiulate the following files: `tests/fixtures/sample_customers.json`, `tests/fixtures/sample_products.json`, and `tests/fixtures/sample_orders.json` \ No newline at end of file From 251d13000b4a451f96d456b89a49da7cc96ada7d Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Thu, 11 Dec 2025 09:18:59 -0600 Subject: [PATCH 47/48] notes --- testing-demo.md | 1 + 1 file changed, 1 insertion(+) diff --git a/testing-demo.md b/testing-demo.md index b0465b6..aab8c96 100644 --- a/testing-demo.md +++ b/testing-demo.md @@ -79,6 +79,7 @@ You'll see: **17 passed, 18 failed, 7 skipped** - 7 more skipped tests for bonus round (shipping calculation) ## MCP +- playwright ## Test data generation - "can you generate test data for this app? In particular I need to popiulate the following files: `tests/fixtures/sample_customers.json`, `tests/fixtures/sample_products.json`, and `tests/fixtures/sample_orders.json` \ No newline at end of file From 423ffddba556f17d74c5561850cbf03daa042c44 Mon Sep 17 00:00:00 2001 From: Matthew Chenette Date: Thu, 11 Dec 2025 09:32:02 -0600 Subject: [PATCH 48/48] new tdd steps --- tdd-demo/README.md | 78 --------- tdd-demo/cart.py | 207 ---------------------- tdd-demo/product.py | 54 ------ tdd-demo/pytest.ini | 6 - tdd-demo/tests/__init__.py | 1 - tdd-demo/tests/test_cart.py | 310 --------------------------------- tdd-demo/tests/test_product.py | 84 --------- testing-demo.md | 71 +------- 8 files changed, 2 insertions(+), 809 deletions(-) delete mode 100644 tdd-demo/README.md delete mode 100644 tdd-demo/cart.py delete mode 100644 tdd-demo/product.py delete mode 100644 tdd-demo/pytest.ini delete mode 100644 tdd-demo/tests/__init__.py delete mode 100644 tdd-demo/tests/test_cart.py delete mode 100644 tdd-demo/tests/test_product.py diff --git a/tdd-demo/README.md b/tdd-demo/README.md deleted file mode 100644 index 8e51720..0000000 --- a/tdd-demo/README.md +++ /dev/null @@ -1,78 +0,0 @@ -# πŸ›’ Shopping Cart Pricing Engine - TDD Demo - -A hands-on Test-Driven Development demonstration featuring a realistic pricing engine with bulk discounts, category-based taxes, and shipping calculations. - -## Quick Start - -```bash -cd tdd-demo -pytest -v -``` - -You'll see: **18 passed, 10 failed, 7 skipped** - -## The Challenge - -The `ShoppingCart` needs a **pricing engine** with real business logic: - -### Round 1: `get_subtotal()` with Bulk Discounts -- Calculate subtotal from all items (price Γ— quantity) -- Apply tiered bulk discounts based on total items: - - **10+ items**: 15% off - - **5-9 items**: 10% off - - **3-4 items**: 5% off - - **1-2 items**: no discount - -### Round 2: `get_tax()` with Category-Based Rates -- Each product has a tax category with different rates: - - **Standard**: 8% (general merchandise) - - **Food**: 2% (groceries) - - **Luxury**: 12% (premium items) - - **Exempt**: 0% (gift cards, etc.) -- Tax calculated on **discounted** prices (after bulk discount) - -### Bonus Round: `get_shipping()` -- Free shipping over $50 -- Base rate: $5.99 -- Heavy item surcharge: +$3.00 per item β‰₯ 5 lbs - -## Demo Flow - -### πŸ”΄ Round 1: Subtotal (10 failing tests) -```bash -pytest tests/test_cart.py::TestSubtotalWithBulkDiscounts -v -``` -1. Show failing tests -2. Prompt: *"Fix the failing get_subtotal tests"* -3. Watch AI implement the discount logic -4. Run tests β†’ 🟒 Green! - -### πŸ”΄ Round 2: Tax (9 failing tests) -```bash -pytest tests/test_cart.py::TestTaxCalculation -v -``` -1. Show failing tests -2. Prompt: *"Fix the failing get_tax tests"* -3. Watch AI implement category-based tax calculation -4. Run tests β†’ 🟒 Green! - -## What Makes This Demo Impressive - -- **Real algorithm required**: Can't solve with one-liners -- **Business rules to implement**: Tiered discounts, tax rates -- **Edge cases covered**: Empty cart, rounding, mixed categories -- **Progressive complexity**: Round 2 depends on Round 1 -- **Relatable domain**: Everyone understands shopping carts - -## Project Structure - -``` -tdd-demo/ -β”œβ”€β”€ README.md -β”œβ”€β”€ product.py # Product with categories and weights -β”œβ”€β”€ cart.py # Shopping cart with pricing engine -β”œβ”€β”€ pytest.ini -└── tests/ - β”œβ”€β”€ test_product.py # Product tests (passing) - └── test_cart.py # Cart tests (some failing!) -``` diff --git a/tdd-demo/cart.py b/tdd-demo/cart.py deleted file mode 100644 index 9de153d..0000000 --- a/tdd-demo/cart.py +++ /dev/null @@ -1,207 +0,0 @@ -"""Shopping cart with pricing engine.""" - -from product import Product - - -class CartItem: - """Represents a product with quantity in the cart.""" - - def __init__(self, product: Product, quantity: int = 1): - if quantity < 1: - raise ValueError("Quantity must be at least 1") - self.product = product - self.quantity = quantity - - @property - def line_total(self) -> float: - """Calculate total for this line item (price * quantity).""" - return self.product.price * self.quantity - - def __repr__(self): - return f"CartItem({self.product.name}, qty={self.quantity})" - - -class ShoppingCart: - """ - A shopping cart with full pricing engine. - - Features: - - Quantity management (adding same product increases quantity) - - Tiered bulk discounts (buy more, save more) - - Category-based tax calculation - - Weight-based shipping with free shipping threshold - - Coupon code support - """ - - # Shipping constants - BASE_SHIPPING = 5.99 - FREE_SHIPPING_THRESHOLD = 50.00 - HEAVY_ITEM_SURCHARGE = 3.00 - HEAVY_WEIGHT_THRESHOLD = 5.0 # pounds - - # Bulk discount tiers: (min_quantity, discount_percent) - BULK_DISCOUNT_TIERS = [ - (10, 0.15), # 10+ items: 15% off - (5, 0.10), # 5-9 items: 10% off - (3, 0.05), # 3-4 items: 5% off - ] - - # Valid coupon codes: code -> (discount_type, value, min_purchase) - COUPON_CODES = { - "SAVE10": ("percent", 10, 0), # 10% off, no minimum - "SAVE20": ("percent", 20, 50), # 20% off, $50 minimum - "FLAT15": ("fixed", 15, 30), # $15 off, $30 minimum - "FREESHIP": ("shipping", 100, 25), # Free shipping, $25 minimum - } - - def __init__(self): - """Initialize an empty shopping cart.""" - self._items: dict[str, CartItem] = {} # keyed by product name - self._applied_coupon: str | None = None - - def add_item(self, product: Product, quantity: int = 1) -> None: - """ - Add a product to the cart. - If product already exists, increase its quantity. - """ - if product.name in self._items: - self._items[product.name].quantity += quantity - else: - self._items[product.name] = CartItem(product, quantity) - - def get_item_count(self) -> int: - """Return the total number of items (sum of all quantities).""" - return sum(item.quantity for item in self._items.values()) - - def get_unique_item_count(self) -> int: - """Return the number of unique products in the cart.""" - return len(self._items) - - def is_empty(self) -> bool: - """Return True if the cart is empty.""" - return len(self._items) == 0 - - # ============================================================ - # TDD DEMO ROUND 1: Subtotal with Bulk Discounts - # ============================================================ - - def get_subtotal(self) -> float: - """ - Calculate subtotal with bulk discounts applied. - - Business Rules: - - Sum up (price * quantity) for each item - - Apply bulk discount based on TOTAL items in cart: - - 10+ items: 15% off - - 5-9 items: 10% off - - 3-4 items: 5% off - - 1-2 items: no discount - - Round to 2 decimal places - - TODO: Implement using TDD! - """ - raise NotImplementedError("Implement using TDD!") - - def _get_bulk_discount_rate(self) -> float: - """ - Get the bulk discount rate based on total item count. - Helper method - implement this too! - """ - raise NotImplementedError("Implement using TDD!") - - # ============================================================ - # TDD DEMO ROUND 2: Tax Calculation - # ============================================================ - - def get_tax(self) -> float: - """ - Calculate tax based on each product's category. - - Business Rules: - - Each product has a tax category (standard=8%, food=2%, luxury=12%, exempt=0%) - - Tax is calculated on the DISCOUNTED subtotal for each item - - Apply bulk discount to each line item proportionally before calculating tax - - Round to 2 decimal places - - Example: - - Cart has 5 items total (10% bulk discount applies) - - 3 standard items @ $10 = $30 -> $27 after discount -> $2.16 tax - - 2 food items @ $5 = $10 -> $9 after discount -> $0.18 tax - - Total tax = $2.34 - - TODO: Implement using TDD! - """ - raise NotImplementedError("Implement using TDD!") - - # ============================================================ - # TDD DEMO ROUND 3 (BONUS): Shipping Calculation - # ============================================================ - - def get_shipping(self) -> float: - """ - Calculate shipping cost. - - Business Rules: - - Free shipping if subtotal >= $50 - - Otherwise, base shipping is $5.99 - - Add $3.00 surcharge for each item weighing 5+ pounds - - If FREESHIP coupon is applied, shipping is $0 - - Empty cart = $0 shipping - - TODO: Implement using TDD! - """ - raise NotImplementedError("Implement using TDD!") - - # ============================================================ - # ALREADY IMPLEMENTED (for demo setup) - # ============================================================ - - def apply_coupon(self, code: str) -> bool: - """ - Apply a coupon code to the cart. - Returns True if coupon was valid and applied. - """ - code = code.upper() - if code not in self.COUPON_CODES: - return False - - discount_type, value, min_purchase = self.COUPON_CODES[code] - - # Check minimum purchase requirement - raw_subtotal = sum(item.line_total for item in self._items.values()) - if raw_subtotal < min_purchase: - return False - - self._applied_coupon = code - return True - - def get_coupon_discount(self) -> float: - """Calculate the discount from the applied coupon.""" - if not self._applied_coupon: - return 0.0 - - discount_type, value, _ = self.COUPON_CODES[self._applied_coupon] - - if discount_type == "percent": - # Percentage off subtotal - return round(self.get_subtotal() * (value / 100), 2) - elif discount_type == "fixed": - # Fixed dollar amount off - return min(value, self.get_subtotal()) # Can't exceed subtotal - elif discount_type == "shipping": - # Shipping discount handled in get_shipping() - return 0.0 - - return 0.0 - - def get_total(self) -> float: - """ - Calculate final total: subtotal + tax + shipping - coupon discount. - Note: Requires get_subtotal(), get_tax(), and get_shipping() to work. - """ - subtotal = self.get_subtotal() - tax = self.get_tax() - shipping = self.get_shipping() - coupon_discount = self.get_coupon_discount() - - return round(subtotal + tax + shipping - coupon_discount, 2) diff --git a/tdd-demo/product.py b/tdd-demo/product.py deleted file mode 100644 index 5eab563..0000000 --- a/tdd-demo/product.py +++ /dev/null @@ -1,54 +0,0 @@ -"""Product model for the shopping cart.""" - - -class Product: - """Represents a product that can be added to a shopping cart.""" - - # Tax categories with different rates - TAX_RATES = { - "standard": 0.08, # 8% - general merchandise - "food": 0.02, # 2% - groceries - "luxury": 0.12, # 12% - luxury items - "exempt": 0.0, # 0% - tax exempt - } - - def __init__(self, name: str, price: float, category: str = "standard", weight: float = 0.5): - """ - Initialize a product. - - Args: - name: The product name - price: The product price (must be non-negative) - category: Tax category (standard, food, luxury, exempt) - weight: Weight in pounds for shipping calculation - """ - if price < 0: - raise ValueError("Price cannot be negative") - if category not in self.TAX_RATES: - raise ValueError(f"Invalid category. Must be one of: {list(self.TAX_RATES.keys())}") - if weight < 0: - raise ValueError("Weight cannot be negative") - - self.name = name - self.price = price - self.category = category - self.weight = weight - - @property - def tax_rate(self) -> float: - """Get the tax rate for this product's category.""" - return self.TAX_RATES[self.category] - - def __eq__(self, other): - """Two products are equal if they have the same name.""" - if not isinstance(other, Product): - return False - return self.name == other.name - - def __hash__(self): - """Hash based on name for use in dictionaries.""" - return hash(self.name) - - def __repr__(self): - """Return string representation of the product.""" - return f"Product('{self.name}', {self.price}, '{self.category}')" diff --git a/tdd-demo/pytest.ini b/tdd-demo/pytest.ini deleted file mode 100644 index 9855d94..0000000 --- a/tdd-demo/pytest.ini +++ /dev/null @@ -1,6 +0,0 @@ -[pytest] -testpaths = tests -python_files = test_*.py -python_classes = Test* -python_functions = test_* -addopts = -v --tb=short diff --git a/tdd-demo/tests/__init__.py b/tdd-demo/tests/__init__.py deleted file mode 100644 index 66173ae..0000000 --- a/tdd-demo/tests/__init__.py +++ /dev/null @@ -1 +0,0 @@ -# Test package diff --git a/tdd-demo/tests/test_cart.py b/tdd-demo/tests/test_cart.py deleted file mode 100644 index fa96286..0000000 --- a/tdd-demo/tests/test_cart.py +++ /dev/null @@ -1,310 +0,0 @@ -"""Tests for the ShoppingCart pricing engine.""" - -import pytest -import sys -import os - -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from cart import ShoppingCart, CartItem -from product import Product - - -class TestCartBasics: - """Basic cart tests - these already pass!""" - - def test_new_cart_is_empty(self): - """A new shopping cart should be empty.""" - cart = ShoppingCart() - assert cart.is_empty() is True - assert cart.get_item_count() == 0 - - def test_add_single_item(self): - """Adding an item should increase the count.""" - cart = ShoppingCart() - cart.add_item(Product("Apple", 1.99)) - assert cart.get_item_count() == 1 - - def test_add_same_product_increases_quantity(self): - """Adding the same product should increase quantity, not add new item.""" - cart = ShoppingCart() - apple = Product("Apple", 1.99) - - cart.add_item(apple, quantity=2) - cart.add_item(apple, quantity=3) - - assert cart.get_unique_item_count() == 1 # Still one unique product - assert cart.get_item_count() == 5 # But 5 total items - - def test_add_item_with_quantity(self): - """Can add multiple of same item at once.""" - cart = ShoppingCart() - cart.add_item(Product("Apple", 1.99), quantity=5) - assert cart.get_item_count() == 5 - - -class TestSubtotalWithBulkDiscounts: - """ - πŸ”΄ TDD DEMO ROUND 1: Subtotal Calculation with Bulk Discounts - - These tests are FAILING! Implement get_subtotal() to make them pass. - - Business Rules: - - 10+ items: 15% off - - 5-9 items: 10% off - - 3-4 items: 5% off - - 1-2 items: no discount - """ - - # ⬇️ WRITE THIS TEST LIVE DURING DEMO ⬇️ - # def test_empty_cart_has_zero_subtotal(self): - # """An empty cart should have subtotal of 0.""" - # cart = ShoppingCart() - # assert cart.get_subtotal() == 0.0 - - def test_single_item_no_discount(self): - """Single item gets no bulk discount.""" - cart = ShoppingCart() - cart.add_item(Product("Laptop", 100.00)) - - # 1 item = no discount, subtotal = $100 - assert cart.get_subtotal() == 100.00 - - def test_two_items_no_discount(self): - """Two items still get no bulk discount.""" - cart = ShoppingCart() - cart.add_item(Product("Book", 25.00), quantity=2) - - # 2 items = no discount, subtotal = $50 - assert cart.get_subtotal() == 50.00 - - def test_three_items_five_percent_discount(self): - """3-4 items get 5% bulk discount.""" - cart = ShoppingCart() - cart.add_item(Product("Shirt", 20.00), quantity=3) - - # 3 items @ $20 = $60, minus 5% = $57 - assert cart.get_subtotal() == 57.00 - - def test_four_items_five_percent_discount(self): - """4 items still in 5% discount tier.""" - cart = ShoppingCart() - cart.add_item(Product("Mug", 10.00), quantity=4) - - # 4 items @ $10 = $40, minus 5% = $38 - assert cart.get_subtotal() == 38.00 - - def test_five_items_ten_percent_discount(self): - """5-9 items get 10% bulk discount.""" - cart = ShoppingCart() - cart.add_item(Product("Pen", 5.00), quantity=5) - - # 5 items @ $5 = $25, minus 10% = $22.50 - assert cart.get_subtotal() == 22.50 - - def test_nine_items_ten_percent_discount(self): - """9 items still in 10% discount tier.""" - cart = ShoppingCart() - cart.add_item(Product("Notebook", 8.00), quantity=9) - - # 9 items @ $8 = $72, minus 10% = $64.80 - assert cart.get_subtotal() == 64.80 - - def test_ten_items_fifteen_percent_discount(self): - """10+ items get 15% bulk discount.""" - cart = ShoppingCart() - cart.add_item(Product("Sticker", 2.00), quantity=10) - - # 10 items @ $2 = $20, minus 15% = $17 - assert cart.get_subtotal() == 17.00 - - def test_bulk_discount_with_mixed_products(self): - """Bulk discount applies to total item count across all products.""" - cart = ShoppingCart() - cart.add_item(Product("Apple", 1.00), quantity=3) - cart.add_item(Product("Banana", 0.50), quantity=2) - - # 5 total items = 10% discount - # Raw: (3 * $1) + (2 * $0.50) = $4.00 - # After 10% off: $3.60 - assert cart.get_subtotal() == 3.60 - - def test_subtotal_rounds_to_two_decimals(self): - """Subtotal should be rounded to 2 decimal places.""" - cart = ShoppingCart() - # Create a scenario that would produce more than 2 decimals - cart.add_item(Product("Widget", 3.33), quantity=3) - - # 3 items @ $3.33 = $9.99, minus 5% = $9.4905 -> rounds to $9.49 - assert cart.get_subtotal() == 9.49 - - -class TestTaxCalculation: - """ - πŸ”΄ TDD DEMO ROUND 2: Tax Calculation by Category - - These tests are FAILING! Implement get_tax() to make them pass. - - Tax rates by category: - - standard: 8% - - food: 2% - - luxury: 12% - - exempt: 0% - - Tax is calculated on the DISCOUNTED price! - """ - - def test_empty_cart_has_zero_tax(self): - """Empty cart has no tax.""" - cart = ShoppingCart() - assert cart.get_tax() == 0.0 - - def test_standard_tax_rate(self): - """Standard category items have 8% tax.""" - cart = ShoppingCart() - cart.add_item(Product("Laptop", 100.00, category="standard")) - - # 1 item = no bulk discount - # Tax: $100 * 8% = $8.00 - assert cart.get_tax() == 8.00 - - def test_food_tax_rate(self): - """Food category items have 2% tax.""" - cart = ShoppingCart() - cart.add_item(Product("Bread", 5.00, category="food")) - - # 1 item = no bulk discount - # Tax: $5 * 2% = $0.10 - assert cart.get_tax() == 0.10 - - def test_luxury_tax_rate(self): - """Luxury category items have 12% tax.""" - cart = ShoppingCart() - cart.add_item(Product("Watch", 200.00, category="luxury")) - - # 1 item = no bulk discount - # Tax: $200 * 12% = $24.00 - assert cart.get_tax() == 24.00 - - def test_exempt_has_no_tax(self): - """Exempt category items have 0% tax.""" - cart = ShoppingCart() - cart.add_item(Product("Gift Card", 50.00, category="exempt")) - - assert cart.get_tax() == 0.0 - - def test_mixed_categories_tax(self): - """Tax calculated correctly for mixed categories.""" - cart = ShoppingCart() - cart.add_item(Product("Laptop", 100.00, category="standard")) # 8% - cart.add_item(Product("Bread", 10.00, category="food")) # 2% - - # 2 items = no bulk discount - # Standard: $100 * 8% = $8.00 - # Food: $10 * 2% = $0.20 - # Total tax: $8.20 - assert cart.get_tax() == 8.20 - - def test_tax_calculated_on_discounted_subtotal(self): - """Tax should be calculated AFTER bulk discount is applied.""" - cart = ShoppingCart() - cart.add_item(Product("Book", 10.00, category="standard"), quantity=5) - - # 5 items = 10% bulk discount - # Raw: $50, After discount: $45 - # Tax: $45 * 8% = $3.60 - assert cart.get_tax() == 3.60 - - def test_tax_with_mixed_categories_and_bulk_discount(self): - """Complex scenario: mixed categories with bulk discount.""" - cart = ShoppingCart() - cart.add_item(Product("Gadget", 20.00, category="standard"), quantity=3) # 8% - cart.add_item(Product("Snacks", 10.00, category="food"), quantity=2) # 2% - - # 5 total items = 10% bulk discount - # Gadgets: $60 -> $54 after discount -> $54 * 8% = $4.32 - # Snacks: $20 -> $18 after discount -> $18 * 2% = $0.36 - # Total tax: $4.68 - assert cart.get_tax() == 4.68 - - def test_tax_rounds_to_two_decimals(self): - """Tax should be rounded to 2 decimal places.""" - cart = ShoppingCart() - cart.add_item(Product("Item", 33.33, category="standard")) - - # $33.33 * 8% = $2.6664 -> rounds to $2.67 - assert cart.get_tax() == 2.67 - - -class TestShippingCalculation: - """ - πŸ”΄ TDD DEMO ROUND 3 (BONUS): Shipping Calculation - - These tests are SKIPPED. Enable them for an extended demo! - - Rules: - - Free shipping if subtotal >= $50 - - Base shipping: $5.99 - - Heavy item surcharge: +$3.00 per item >= 5 lbs - """ - - @pytest.mark.skip(reason="Bonus round - enable when ready") - def test_empty_cart_no_shipping(self): - """Empty cart has no shipping cost.""" - cart = ShoppingCart() - assert cart.get_shipping() == 0.0 - - @pytest.mark.skip(reason="Bonus round - enable when ready") - def test_base_shipping_under_threshold(self): - """Orders under $50 pay base shipping.""" - cart = ShoppingCart() - cart.add_item(Product("Book", 20.00)) - - assert cart.get_shipping() == 5.99 - - @pytest.mark.skip(reason="Bonus round - enable when ready") - def test_free_shipping_at_threshold(self): - """Orders at exactly $50 get free shipping.""" - cart = ShoppingCart() - cart.add_item(Product("Item", 50.00)) - - assert cart.get_shipping() == 0.0 - - @pytest.mark.skip(reason="Bonus round - enable when ready") - def test_free_shipping_over_threshold(self): - """Orders over $50 get free shipping.""" - cart = ShoppingCart() - cart.add_item(Product("Laptop", 500.00)) - - assert cart.get_shipping() == 0.0 - - @pytest.mark.skip(reason="Bonus round - enable when ready") - def test_heavy_item_surcharge(self): - """Heavy items (5+ lbs) add $3 surcharge each.""" - cart = ShoppingCart() - cart.add_item(Product("Light Item", 10.00, weight=1.0)) - cart.add_item(Product("Heavy Item", 15.00, weight=6.0)) - - # Under $50 threshold, so base shipping applies - # Plus $3 for the heavy item - # $5.99 + $3.00 = $8.99 - assert cart.get_shipping() == 8.99 - - @pytest.mark.skip(reason="Bonus round - enable when ready") - def test_multiple_heavy_items_surcharge(self): - """Each heavy item adds its own surcharge.""" - cart = ShoppingCart() - cart.add_item(Product("Dumbbell", 10.00, weight=10.0), quantity=2) - - # Under $50, base shipping + 2 heavy surcharges - # $5.99 + $3.00 + $3.00 = $11.99 - assert cart.get_shipping() == 11.99 - - @pytest.mark.skip(reason="Bonus round - enable when ready") - def test_heavy_items_still_charged_over_threshold(self): - """Heavy item surcharge applies even with free shipping threshold.""" - cart = ShoppingCart() - cart.add_item(Product("Heavy Expensive", 100.00, weight=8.0)) - - # Over $50 so free base shipping, but still pay heavy surcharge - assert cart.get_shipping() == 3.00 diff --git a/tdd-demo/tests/test_product.py b/tdd-demo/tests/test_product.py deleted file mode 100644 index 70f1131..0000000 --- a/tdd-demo/tests/test_product.py +++ /dev/null @@ -1,84 +0,0 @@ -"""Tests for the Product class.""" - -import pytest -import sys -import os - -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from product import Product - - -class TestProduct: - """Test suite for Product.""" - - def test_create_product_with_name_and_price(self): - """A product should have a name and price.""" - product = Product("Apple", 1.99) - - assert product.name == "Apple" - assert product.price == 1.99 - - def test_product_has_default_category(self): - """Products default to 'standard' category.""" - product = Product("Apple", 1.99) - assert product.category == "standard" - - def test_product_with_custom_category(self): - """Products can have a custom tax category.""" - product = Product("Bread", 3.99, category="food") - assert product.category == "food" - - def test_product_tax_rate_standard(self): - """Standard products have 8% tax rate.""" - product = Product("Laptop", 999.99, category="standard") - assert product.tax_rate == 0.08 - - def test_product_tax_rate_food(self): - """Food products have 2% tax rate.""" - product = Product("Milk", 4.99, category="food") - assert product.tax_rate == 0.02 - - def test_product_tax_rate_luxury(self): - """Luxury products have 12% tax rate.""" - product = Product("Watch", 5000.00, category="luxury") - assert product.tax_rate == 0.12 - - def test_product_tax_rate_exempt(self): - """Exempt products have 0% tax rate.""" - product = Product("Gift Card", 50.00, category="exempt") - assert product.tax_rate == 0.0 - - def test_product_price_cannot_be_negative(self): - """Creating a product with negative price should raise ValueError.""" - with pytest.raises(ValueError, match="Price cannot be negative"): - Product("Apple", -1.00) - - def test_invalid_category_raises_error(self): - """Invalid category should raise ValueError.""" - with pytest.raises(ValueError, match="Invalid category"): - Product("Item", 10.00, category="invalid") - - def test_product_has_default_weight(self): - """Products have a default weight of 0.5 lbs.""" - product = Product("Apple", 1.99) - assert product.weight == 0.5 - - def test_product_with_custom_weight(self): - """Products can have a custom weight.""" - product = Product("Dumbbell", 29.99, weight=10.0) - assert product.weight == 10.0 - - def test_product_equality_by_name(self): - """Two products with same name are equal.""" - product1 = Product("Apple", 1.99) - product2 = Product("Apple", 2.99) # Different price - - assert product1 == product2 - - def test_product_inequality_different_name(self): - """Products with different names are not equal.""" - product1 = Product("Apple", 1.99) - product2 = Product("Orange", 1.99) - - assert product1 != product2 diff --git a/testing-demo.md b/testing-demo.md index aab8c96..8b0286f 100644 --- a/testing-demo.md +++ b/testing-demo.md @@ -8,75 +8,8 @@ ## execute / write tests / agent mode -## TDD (Agentic Demo) - -### Setup -```bash -cd tdd-demo -pytest -v -``` -You'll see: **17 passed, 18 failed, 7 skipped** - ---- - -### πŸ“ Round 0: Write Your First Test (Live!) - -**Show the TDD philosophy - test FIRST, then code** - -1. Open `tests/test_cart.py` - show the commented-out first test -2. Uncomment or write this test live: - ```python - def test_empty_cart_has_zero_subtotal(self): - """An empty cart should have subtotal of 0.""" - cart = ShoppingCart() - assert cart.get_subtotal() == 0.0 - ``` -3. Run: `pytest tests/test_cart.py::TestSubtotalWithBulkDiscounts::test_empty_cart_has_zero_subtotal -v` -4. Watch it fail! πŸ”΄ `NotImplementedError: Implement using TDD!` -5. **Talking point:** "Now we have a failing test. In true TDD, we write the minimum code to pass." - ---- - -### πŸ”΄ Round 1: `get_subtotal()` with Bulk Discounts (9 more pre-written tests) - -**The Challenge:** Implement tiered bulk discounts -- 10+ items: 15% off -- 5-9 items: 10% off -- 3-4 items: 5% off -- 1-2 items: no discount - -**Demo Steps:** -1. **"I've already written the remaining tests. Let's see what else needs to pass."** -2. Run: `pytest tests/test_cart.py::TestSubtotalWithBulkDiscounts -v` -3. Show all 10 failing tests (including yours from Round 0) -4. Prompt: *"Fix the failing get_subtotal tests in cart.py"* -5. Watch AI implement the discount tier logic -6. Run tests β†’ 🟒 10 tests pass! - ---- - -### πŸ”΄ Round 2: `get_tax()` with Category-Based Rates (9 failing tests) - -**The Challenge:** Calculate tax per product category, on discounted prices -- Standard: 8%, Food: 2%, Luxury: 12%, Exempt: 0% -- Tax applies AFTER bulk discount - -**Demo Steps:** -1. Run: `pytest tests/test_cart.py::TestTaxCalculation -v` -2. Show the 9 failing tests -3. Prompt: *"Fix the failing get_tax tests in cart.py"* -4. Watch AI implement category-based tax calculation -5. Run tests β†’ 🟒 All 19 tests pass! - ---- - -### Key Talking Points -- **Round 0** shows the TDD philosophy: test first -- **Rounds 1-2** show realistic workflow: tests exist, AI implements -- Real algorithms required (not one-liners!) -- AI reads test expectations and business rules from docstrings -- Round 2 depends on Round 1 (tax uses discounted subtotal) -- 7 more skipped tests for bonus round (shipping calculation) +## TDD +- "can you help me write a new minimally featured banking app? I want it to have a log in feature of rhte user (dummy accounts for now) be able to add or remove money from the user's account, add or delete accounts like checking or savings from the users account and transfer money from accounts within a users account" ## MCP - playwright