Dev

applications/Unity.GrantManager/.github/agents/feature-planner.agent.md

@@ -1,16 +1,88 @@
 ---
 name: feature-planner
 description: Plans feature implementation across Domain, Application, EF Core, Web, and tests.
-tools: ['fetch', 'githubRepo', 'problems', 'usages', 'search', 'todos', 'runSubagent']
+argument-hint: Outline the goal or problem to research
+target: vscode
+disable-model-invocation: true
+tools: ['search', 'read', 'web', 'vscode/memory', 'github/issue_read', 'github.vscode-pull-request-github/issue_fetch', 'github.vscode-pull-request-github/activePullRequest', 'execute/getTerminalOutput', 'execute/testFailure', 'agent', 'vscode/askQuestions']
+agents: ['Explore']
+handoffs:
+  - label: Start Implementation
+    agent: agent
+    prompt: 'Start implementation'
+    send: true
+  - label: Open in Editor
+    agent: agent
+    prompt: '#createFile the plan as is into an untitled file (`untitled:plan-${camelCaseName}.prompt.md` without frontmatter) for further refinement.'
+    send: true
+    showContinueOn: false
 ---
 
 # ABP Feature Planner Agent
 
-You are the feature planning specialist for Unity Grant Manager.
+You are the FEATURE PLANNING AGENT for Unity Grant Manager, pairing with the user to create a detailed, actionable plan.
 
-## Mission
+You research the codebase → clarify with the user → capture findings and decisions to convert a feature request into a comprehensive plan that respects ABP modular layering and delivery flow. This iterative approach catches edge cases and non-obvious requirements BEFORE implementation begins.
 
-Convert a feature request into an implementation plan that respects ABP modular layering and delivery flow.
+Your SOLE responsibility is planning. NEVER start implementation.
+
+**Current plan**: `/memories/session/plan.md` - update using #tool:vscode/memory.
+
+<rules>
+- STOP if you consider running file editing tools — plans are for others to execute. The only write tool you have is #tool:vscode/memory for persisting plans.
+- Use #tool:vscode/askQuestions freely to clarify requirements — don't make large assumptions
+- Present a well-researched plan with loose ends tied BEFORE implementation
+</rules>
+
+<workflow>
+Cycle through these phases based on user input. This is iterative, not linear. If the user task is highly ambiguous, do only *Discovery* to outline a draft plan, then move on to alignment before fleshing out the full plan.
+
+## 1. Discovery
+
+Run the *Explore* subagent to gather context, analogous existing features to use as implementation templates, and potential blockers or ambiguities. When the task spans multiple independent areas (e.g., frontend + backend, different features, separate modules), launch **2-3 *Explore* subagents in parallel** — one per area — to speed up discovery.
+
+Identify:
+- Module ownership and whether the change is host, tenant, or both.
+- Work split by ABP layer: Domain.Shared → Domain → Application.Contracts → Application → EntityFrameworkCore → HttpApi/Web → Tests.
+- Dependencies and ordering constraints between layers.
+- Cross-module impacts and permission/localization requirements.
+
+Update the plan with your findings.
+
+## 2. Alignment
+
+If research reveals major ambiguities or if you need to validate assumptions:
+- Use #tool:vscode/askQuestions to clarify intent with the user.
+- Surface discovered technical constraints or alternative approaches.
+- If answers significantly change the scope, loop back to **Discovery**.
+
+## 3. Design
+
+Once context is clear, draft a comprehensive implementation plan structured around ABP layers.
+
+The plan should reflect:
+- Structured concisely enough to be scannable and detailed enough for effective execution.
+- Step-by-step implementation with explicit dependencies — mark which steps can run in parallel vs. which block on prior steps.
+- For plans with many steps, group into named phases that are each independently verifiable.
+- Verification steps for validating the implementation, both automated and manual.
+- Critical architecture to reuse or use as reference — reference specific functions, types, or patterns, not just file names.
+- Critical files to be modified (with full paths).
+- Explicit scope boundaries — what's included and what's deliberately excluded.
+- Reference decisions from the discussion.
+- Leave no ambiguity.
+
+Save the comprehensive plan document to `/memories/session/plan.md` via #tool:vscode/memory, then show the scannable plan to the user for review. You MUST show the plan to the user, as the plan file is for persistence only, not a substitute for showing it to the user.
+
+## 4. Refinement
+
+On user input after showing the plan:
+- Changes requested → revise and present updated plan. Update `/memories/session/plan.md` to keep the documented plan in sync.
+- Questions asked → clarify, or use #tool:vscode/askQuestions for follow-ups.
+- Alternatives wanted → loop back to **Discovery** with new subagent.
+- Approval given → acknowledge, the user can now use handoff buttons.
+
+Keep iterating until explicit approval or handoff.
+</workflow>
 
 ## Inputs
 
@@ -19,30 +91,54 @@ Convert a feature request into an implementation plan that respects ABP modular
 - Target module(s).
 - Any constraints (timeline, migration risk, tenant scope, security requirements).
 
-## Process
-
-1. Identify module ownership and whether the change is host, tenant, or both.
-2. Split work by layer:
-   - Domain.Shared
-   - Domain
-   - Application.Contracts
-   - Application
-   - EntityFrameworkCore
-   - HttpApi/Web
-   - Tests
-3. List dependencies and ordering constraints.
-4. Flag cross-module impacts and permission/localization requirements.
-
-## Output Format
-
-Return sections in this order:
-
-1. Scope summary.
-2. Layer-by-layer implementation tasks.
-3. Migration and data impact.
-4. Test plan summary.
-5. Risks and mitigations.
-6. Definition of done checklist.
+<plan_style_guide>
+```markdown
+## Plan: {Title (2-10 words)}
+
+{TL;DR - what, why, and how (your recommended approach).}
+
+**Steps**
+
+### Phase 1 — Domain & Contracts
+1. {Domain.Shared changes — enums, consts, error codes}
+2. {Domain entity/aggregate changes — note dependency ("*depends on N*") or parallelism ("*parallel with step N*") when applicable}
+3. {Application.Contracts — DTOs, IAppService interfaces, permissions}
+
+### Phase 2 — Application & Persistence
+4. {Application service implementation}
+5. {EntityFrameworkCore — DbContext, entity config, migration}
+
+### Phase 3 — API & Frontend
+6. {HttpApi controller / AutoAPI}
+7. {Web — Pages, JS, localization}
+
+### Phase 4 — Tests
+8. {Unit and integration tests}
+
+**Relevant files**
+- `{full/path/to/file}` — {what to modify or reuse, referencing specific functions/patterns}
+
+**Migration & Data Impact**
+- {Host vs tenant migration scope, data backfill needs, breaking schema changes}
+
+**Verification**
+1. {Verification steps for validating the implementation (**Specific** tasks, tests, commands, MCP tools, etc; not generic statements)}
+
+**Decisions** (if applicable)
+- {Decision, assumptions, and includes/excluded scope}
+
+**Risks & Mitigations** (if applicable)
+- {Risk and mitigation strategy}
+
+**Definition of Done**
+- [ ] {Checklist item}
+```
+
+Rules:
+- NO code blocks — describe changes, link to files and specific symbols/functions.
+- NO blocking questions at the end — ask during workflow via #tool:vscode/askQuestions.
+- The plan MUST be presented to the user, don't just mention the plan file.
+</plan_style_guide>
 
 ## Guardrails
 

applications/Unity.GrantManager/.github/skills/abp-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: abp-cli
-description: ABP CLI commands - generate-proxy, install-libs, add-package-ref, new-module, install-module, abp update, abp clean, abp suite generate. Use when the user asks how to run ABP CLI commands, generate proxies, install libraries, or use ABP Suite.
+description: ABP CLI commands - generate-proxy, install-libs, add-package-ref, new-module, install-module, abp update, abp clean, abp suite generate. Use when the user asks how to run ABP CLI commands, generate proxies, install NPM libraries, or use ABP Suite.
 ---
 
 # ABP CLI Commands

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Extraction/ITextExtractionService.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Extraction/ITextExtractionService.cs

@@ -1,6 +1,6 @@
 using System.Threading.Tasks;
 
-namespace Unity.GrantManager.AI.Extraction
+namespace Unity.AI.Extraction
 {
     public interface ITextExtractionService
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/IAIService.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/IAIService.cs

@@ -1,8 +1,8 @@
 using System.Threading.Tasks;
-using Unity.GrantManager.AI.Requests;
-using Unity.GrantManager.AI.Responses;
+using Unity.AI.Requests;
+using Unity.AI.Responses;
 
-namespace Unity.GrantManager.AI
+namespace Unity.AI
 {
     public interface IAIService
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Models/AIAttachmentItem.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Models/AIAttachmentItem.cs

@@ -1,6 +1,6 @@
 using System.Text.Json.Serialization;
 
-namespace Unity.GrantManager.AI.Models
+namespace Unity.AI.Models
 {
     public class AIAttachmentItem
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Models/AIJsonKeys.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Models/AIJsonKeys.cs

@@ -1,4 +1,4 @@
-namespace Unity.GrantManager.AI.Models
+namespace Unity.AI.Models
 {
     public static class AIJsonKeys
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Models/ApplicationAnalysisFinding.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Models/ApplicationAnalysisFinding.cs

@@ -1,6 +1,6 @@
 using System.Text.Json.Serialization;
 
-namespace Unity.GrantManager.AI.Models
+namespace Unity.AI.Models
 {
     public class ApplicationAnalysisFinding
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Models/ApplicationAnalysisRecommendation.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Models/ApplicationAnalysisRecommendation.cs

@@ -1,6 +1,6 @@
 using System.Text.Json.Serialization;
 
-namespace Unity.GrantManager.AI.Models
+namespace Unity.AI.Models
 {
     public class ApplicationAnalysisRecommendation
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Models/ApplicationScoringAnswer.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Models/ApplicationScoringAnswer.cs

@@ -1,7 +1,7 @@
 using System.Text.Json;
 using System.Text.Json.Serialization;
 
-namespace Unity.GrantManager.AI.Models
+namespace Unity.AI.Models
 {
     public class ApplicationScoringAnswer
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Requests/AICompletionRequest.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Requests/AICompletionRequest.cs

@@ -1,6 +1,6 @@
 using System.Text.Json.Serialization;
 
-namespace Unity.GrantManager.AI.Requests
+namespace Unity.AI.Requests
 {
     public class AICompletionRequest
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Requests/ApplicationAnalysisRequest.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Requests/ApplicationAnalysisRequest.cs

@@ -1,9 +1,9 @@
 using System.Collections.Generic;
 using System.Text.Json;
 using System.Text.Json.Serialization;
-using Unity.GrantManager.AI.Models;
+using Unity.AI.Models;
 
-namespace Unity.GrantManager.AI.Requests
+namespace Unity.AI.Requests
 {
     public class ApplicationAnalysisRequest
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Requests/ApplicationScoringRequest.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Requests/ApplicationScoringRequest.cs

@@ -1,9 +1,9 @@
 using System.Collections.Generic;
 using System.Text.Json;
 using System.Text.Json.Serialization;
-using Unity.GrantManager.AI.Models;
+using Unity.AI.Models;
 
-namespace Unity.GrantManager.AI.Requests
+namespace Unity.AI.Requests
 {
     public class ApplicationScoringRequest
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Requests/AttachmentSummaryRequest.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Requests/AttachmentSummaryRequest.cs

@@ -1,6 +1,6 @@
 using System.Text.Json.Serialization;
 
-namespace Unity.GrantManager.AI.Requests
+namespace Unity.AI.Requests
 {
     public class AttachmentSummaryRequest
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Responses/AICompletionResponse.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Responses/AICompletionResponse.cs

@@ -1,6 +1,6 @@
 using System.Text.Json.Serialization;
 
-namespace Unity.GrantManager.AI.Responses
+namespace Unity.AI.Responses
 {
     public class AICompletionResponse
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Responses/ApplicationAnalysisResponse.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Responses/ApplicationAnalysisResponse.cs

@@ -1,8 +1,8 @@
 using System.Collections.Generic;
 using System.Text.Json.Serialization;
-using Unity.GrantManager.AI.Models;
+using Unity.AI.Models;
 
-namespace Unity.GrantManager.AI.Responses
+namespace Unity.AI.Responses
 {
     public class ApplicationAnalysisResponse
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Responses/ApplicationScoringResponse.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Responses/ApplicationScoringResponse.cs

@@ -1,8 +1,8 @@
 using System.Collections.Generic;
 using System.Text.Json.Serialization;
-using Unity.GrantManager.AI.Models;
+using Unity.AI.Models;
 
-namespace Unity.GrantManager.AI.Responses
+namespace Unity.AI.Responses
 {
     public class ApplicationScoringResponse
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application.Contracts/AI/Responses/AttachmentSummaryResponse.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/AI/Responses/AttachmentSummaryResponse.cs

@@ -1,7 +1,7 @@
 using System.Text.Json.Serialization;
-using Unity.GrantManager.AI.Models;
+using Unity.AI.Models;
 
-namespace Unity.GrantManager.AI.Responses
+namespace Unity.AI.Responses
 {
     public class AttachmentSummaryResponse
     {

applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/Automation/IApplicationAIGenerationQueue.cs

@@ -0,0 +1,13 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+
+namespace Unity.AI.Automation;
+
+public interface IApplicationAIGenerationQueue
+{
+    Task QueueAttachmentSummariesAsync(IReadOnlyList<Guid> attachmentIds, Guid? tenantId, string? promptVersion = null);
+    Task QueueApplicationAnalysisAsync(Guid applicationId, Guid? tenantId, string? promptVersion = null);
+    Task QueueApplicationScoringAsync(Guid applicationId, Guid? tenantId, string? promptVersion = null);
+    Task QueueApplicationPipelineAsync(Guid applicationId, Guid? tenantId, string? promptVersion = null);
+}

applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application.Contracts/Unity.AI.Application.Contracts.csproj

@@ -1,27 +1,23 @@
 <Project Sdk="Microsoft.NET.Sdk">
-
   <Import Project="..\..\common.props" />
-
   <PropertyGroup>
     <TargetFramework>net9.0</TargetFramework>
     <Nullable>enable</Nullable>
     <RootNamespace>Unity.AI</RootNamespace>
   </PropertyGroup>
-
   <ItemGroup>
-    <PackageReference Include="Volo.Abp.Ddd.Application.Contracts" Version="9.1.3" />
+    <PackageReference Include="System.Text.Json" Version="9.0.5" />
     <PackageReference Include="Volo.Abp.Authorization" Version="9.1.3" />
+    <PackageReference Include="Volo.Abp.Ddd.Application.Contracts" Version="9.1.3" />
     <PackageReference Include="Volo.Abp.Features" Version="9.1.3" />
     <PackageReference Include="Volo.Abp.SettingManagement.Application.Contracts" Version="9.1.3" />
     <ProjectReference Include="..\Unity.AI.Domain.Shared\Unity.AI.Shared.csproj" />
   </ItemGroup>
-
   <ItemGroup>
     <PackageReference Update="ConfigureAwait.Fody" Version="3.3.2" />
     <PackageReference Update="Fody" Version="6.9.2">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
     </PackageReference>
   </ItemGroup>
-
-</Project>
+</Project>

applications/Unity.GrantManager/src/Unity.GrantManager.Application/AI/Extraction/TextExtractionService.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application/AI/Extraction/TextExtractionService.cs

@@ -13,7 +13,7 @@
 using UglyToad.PdfPig;
 using Volo.Abp.DependencyInjection;
 
-namespace Unity.GrantManager.AI.Extraction
+namespace Unity.AI.Extraction
 {
     public partial class TextExtractionService : ITextExtractionService, ITransientDependency
     {

applications/Unity.GrantManager/src/Unity.GrantManager.Application/AI/Operations/ApplicationAnalysisService.cs → applications/Unity.GrantManager/modules/Unity.AI/src/Unity.AI.Application/AI/Operations/ApplicationAnalysisService.cs

@@ -5,13 +5,13 @@
 using System.Linq;
 using System.Text.Json;
 using System.Threading.Tasks;
-using Unity.GrantManager.AI.Models;
-using Unity.GrantManager.AI.Prompts;
-using Unity.GrantManager.AI.Requests;
+using Unity.AI.Models;
+using Unity.AI.Prompts;
+using Unity.AI.Requests;
 using Unity.GrantManager.Applications;
 using Volo.Abp.DependencyInjection;
 
-namespace Unity.GrantManager.AI.Operations
+namespace Unity.AI.Operations
 {
     public class ApplicationAnalysisService(
         IApplicationRepository applicationRepository,