feat: prep release

Author: wisedev

.github/workflows/deploy-backend.yml

@@ -0,0 +1,69 @@
+name: Deploy Backend → Azure Container App
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'backend/**'
+      - 'docs-content/**'
+  workflow_dispatch:
+
+env:
+  IMAGE_NAME: ${{ github.repository_owner }}/maindoc-backend
+
+jobs:
+  build-push:
+    runs-on: ubuntu-latest
+    name: Build & Push to GHCR
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract image metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ env.IMAGE_NAME }}
+          tags: |
+            type=sha,prefix=sha-
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: backend/Dockerfile.ci
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+  deploy:
+    runs-on: ubuntu-latest
+    name: Deploy to Container App
+    needs: build-push
+    steps:
+      - name: Azure Login
+        uses: azure/login@v2
+        with:
+          creds: ${{ secrets.AZURE_CREDENTIALS }}
+
+      - name: Update Container App image
+        uses: azure/container-apps-deploy-action@v2
+        with:
+          resourceGroup: MaIN
+          containerAppName: maindoc-backend
+          imageToDeploy: ghcr.io/${{ env.IMAGE_NAME }}:sha-${{ github.sha }}
+          registryUrl: ghcr.io
+          registryUsername: ${{ github.actor }}
+          registryPassword: ${{ secrets.GHCR_PAT }}

.github/workflows/deploy-frontend.yml

@@ -0,0 +1,44 @@
+name: Deploy Frontend → Azure Static Web App
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'frontend/**'
+  workflow_dispatch:
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    name: Build & Deploy SWA
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Inject TURNSTILE_SITE_KEY into env.js
+        env:
+          TURNSTILE_SITE_KEY: ${{ secrets.TURNSTILE_SITE_KEY }}
+        run: envsubst < frontend/public/env.js > /tmp/env.js && mv /tmp/env.js frontend/public/env.js
+
+      - name: Install dependencies
+        working-directory: frontend
+        run: npm ci
+
+      - name: Build Angular
+        working-directory: frontend
+        run: npm run build
+
+      - name: Deploy to Static Web App
+        uses: Azure/static-web-apps-deploy@v1
+        with:
+          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          action: upload
+          app_location: frontend
+          output_location: dist/frontend/browser
+          skip_app_build: true

backend/Dockerfile.ci

@@ -0,0 +1,25 @@
+# Build context: MaIN.Docs/ (repo root)
+# Used by CI — bakes docs-content into the image (no volume mount needed).
+
+FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
+WORKDIR /build
+
+COPY backend/MaIN.Docs.Api/MaIN.Docs.Api.csproj MaIN.Docs.Api/
+RUN dotnet restore MaIN.Docs.Api/MaIN.Docs.Api.csproj
+
+COPY backend/MaIN.Docs.Api/ MaIN.Docs.Api/
+RUN dotnet publish MaIN.Docs.Api/MaIN.Docs.Api.csproj \
+        -c Release --self-contained false \
+        -o /app && \
+    rm -rf /app/runtimes
+
+FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS runtime
+WORKDIR /app
+
+COPY --from=build /app .
+COPY docs-content/ /app/docs-content/
+
+ENV ASPNETCORE_URLS=http://+:8080
+EXPOSE 8080
+
+ENTRYPOINT ["dotnet", "MaIN.Docs.Api.dll"]

backend/MaIN.Docs.Api/Endpoints/ChatEndpoints.cs

@@ -20,6 +20,18 @@ public static void MapChatEndpoints(this IEndpointRouteBuilder app)
         app.MapPost("/api/chat/complete", HandleChat)
            .RequireRateLimiting("chat");
 
+        app.MapPost("/api/artifact/generate", async (
+            ArtifactGenerateRequest req,
+            ArtifactService artifactService,
+            CancellationToken ct) =>
+        {
+            if (string.IsNullOrWhiteSpace(req.ArchiveName) || req.Files is not { Count: > 0 })
+                return Results.BadRequest("archiveName and at least one file are required.");
+            var files = req.Files.Select(f => (f.Path, f.Content)).ToList();
+            var url = await artifactService.CreateZipAndPresign(req.ArchiveName, files);
+            return Results.Ok(new { url, archiveName = req.ArchiveName });
+        }).RequireRateLimiting("chat");
+
         app.MapPost("/api/confirm/review", async () =>
         {
             if (!PrTools.HasPendingReview)
@@ -138,7 +150,8 @@ private static async Task<IResult> HandleChat(
             capacityService.RecordTokenUsage(TotalTokenUsage(result));
             return Results.Ok(new ChatResponse(result.Content, result.ToolsUsed, result.EstimatedTokens, result.ArtifactUrl, result.ArtifactProposed, result.IssueProposed, result.IssueUrl, result.PlanProposed, result.ReviewProposed, result.CodeChangeProposed, result.PrProposed, result.PrUrl, result.ReviewPosted, result.DocsRead,
                 Capacity: capacityService.GetCapacityLevel(),
-                CapacityDetails: capacityService.GetStatus()));
+                CapacityDetails: capacityService.GetStatus(),
+                FilesProposed: result.FilesProposed));
         }
         catch (TimeoutException ex)
         {

backend/MaIN.Docs.Api/Models/ChatRequest.cs

@@ -1,5 +1,9 @@
 namespace MaIN.Docs.Api.Models;
 
+public record ProposedFile(string Path, string Content, string Language);
+public record ArtifactFileEntry(string Path, string Content);
+public record ArtifactGenerateRequest(string ArchiveName, List<ArtifactFileEntry> Files, string Description = "");
+
 public record HistoryMessage(string Role, string Content);
 public record ChatRequest(string AgentId, string Message, List<HistoryMessage> History, List<string>? DocsAlreadyRead = null);
 public record ToolUsage(string Name, int Calls);
@@ -18,7 +22,8 @@ public record AgentResult(string Content, List<ToolUsage> ToolsUsed, int Estimat
     PrReviewProposal? ReviewProposed = null, CodeChangeProposal? CodeChangeProposed = null,
     PrProposal? PrProposed = null, string? PrUrl = null,
     ReviewPosted? ReviewPosted = null,
-    List<string>? DocsRead = null);
+    List<string>? DocsRead = null,
+    List<ProposedFile>? FilesProposed = null);
 public record ChatResponse(string Text, List<ToolUsage> ToolsUsed, int EstimatedTokens,
     string? ArtifactUrl = null, ArtifactProposal? ArtifactProposed = null,
     IssueProposal? IssueProposed = null, string? IssueUrl = null,
@@ -28,7 +33,8 @@ public record ChatResponse(string Text, List<ToolUsage> ToolsUsed, int Estimated
     ReviewPosted? ReviewPosted = null,
     List<string>? DocsRead = null,
     string Capacity = "normal",
-    CapacityStatus? CapacityDetails = null);
+    CapacityStatus? CapacityDetails = null,
+    List<ProposedFile>? FilesProposed = null);
 public record EnsembleDesignRequest(string Message, List<HistoryMessage> History);
 public record EnsembleCodeRequest(string OriginalMessage, string DesignContent);
 public record EnsembleReviewRequest(string OriginalMessage, string DesignContent, string CodeContent, string BranchName);

backend/MaIN.Docs.Api/Services/DocsAgentOrchestrator.cs

@@ -225,6 +225,7 @@ public async Task<AgentResult> ProcessAsync(
         CodeChangeProposal? codeChangeProposed = null;
         PrProposal? prProposed = null;
         string? prUrl = null;
+        var filesProposed = new List<ProposedFile>();
 
         var docsRead = new List<string>();
         var toolResultChars = 0;
@@ -238,6 +239,7 @@ public async Task<AgentResult> ProcessAsync(
         {
             ArtifactTools.SetCapture(url => artifactUrl = url);
             ArtifactTools.SetProposalCapture(p => artifactProposed = new ArtifactProposal(p.ArchiveName, p.Description, p.Kind));
+            FileTools.SetCapture(f => filesProposed.Add(new ProposedFile(f.Path, f.Content, f.Language)));
         }
 
         if (agentId is "design" or "ensemble-design")
@@ -354,7 +356,8 @@ async Task<AgentResult> Core(IAgentContextExecutor agentCtx)
                 return new AgentResult(content ?? string.Empty, toolsUsed, estimatedTokens,
                     artifactUrl, artifactProposed, issueProposed, issueUrl, planProposed,
                     reviewProposed, codeChangeProposed, prProposed, prUrl, reviewPosted,
-                    DocsRead: docsRead.Distinct().ToList());
+                    DocsRead: docsRead.Distinct().ToList(),
+                    FilesProposed: filesProposed.Count > 0 ? filesProposed : null);
             }
 
             try
@@ -374,6 +377,7 @@ async Task<AgentResult> Core(IAgentContextExecutor agentCtx)
                 issueUrl = null; issueProposed = null; planProposed = null;
                 reviewProposed = null; reviewPosted = null; codeChangeProposed = null;
                 prProposed = null; prUrl = null;
+                filesProposed.Clear();
 
                 await InitializeForTierAsync(3);
                 return await Core(_agents[agentId]);
@@ -383,6 +387,7 @@ async Task<AgentResult> Core(IAgentContextExecutor agentCtx)
         {
             ArtifactTools.SetCapture(null);
             ArtifactTools.SetProposalCapture(null);
+            FileTools.SetCapture(null);
             IssueTools.SetProposalCapture(null);
             IssueTools.SetUrlCapture(null);
             PlanTools.SetCapture(null);
@@ -818,15 +823,30 @@ private static ToolsConfiguration BuildEnsembleCodeTools() =>
 
     private static ToolsConfiguration BuildCodeTools(string docsPath) =>
         SharedDocsTools()
+            .AddTool<FileTools.ShowFileArgs>(
+                "show_file",
+                "Renders a file as a collapsible code tile in the UI. " +
+                "Call once per file — this is the ONLY way the user sees your code. " +
+                "Do NOT write fenced code blocks in your text response. " +
+                "Call for every file in the solution: minimum .csproj + Program.cs.",
+                new
+                {
+                    type = "object",
+                    properties = new
+                    {
+                        path     = new { type = "string", description = "Relative file path, e.g. MyAgent/Program.cs or MyAgent/MyAgent.csproj" },
+                        content  = new { type = "string", description = "Complete file content" },
+                        language = new { type = "string", description = "Language for syntax highlighting: csharp, xml, json, bash, etc." }
+                    },
+                    required = new[] { "path", "content", "language" }
+                },
+                FileTools.Show)
             .AddTool<ArtifactTools.ProposeArgs>(
                 "propose_artifact_generation",
-                "Signals the UI to offer a downloadable ZIP artifact. " +
-                "Call when your response contains a complete, compilable solution — not for partial snippets or conceptual answers. " +
-                "Skip it when the user is just exploring or when you'd need more details to make the code runnable. " +
-                "Call at most once per response. " +
-                "REQUIRES that the SAME response already contains the full code as fenced code blocks " +
-                "(File: <path> + ```lang block for every file) — this tool offers a download, it does not replace showing the code. " +
-                "Always pass the 'kind' arg matching the project shape you wrote (api/console/desktop) — see PROJECT KINDS.",
+                "Signals the UI to offer a downloadable ZIP of the files you just showed via show_file. " +
+                "Call AFTER all show_file calls are done. At most once per response. " +
+                "Only call when the solution is complete and runnable. " +
+                "Always pass the 'kind' arg matching the project shape (api/console/desktop).",
                 new
                 {
                     type = "object",
@@ -838,44 +858,12 @@ private static ToolsConfiguration BuildCodeTools(string docsPath) =>
                         {
                             type = "string",
                             @enum = new[] { "api", "console", "desktop" },
-                            description = "The project kind you just wrote: api (ASP.NET Core), console, or desktop (Avalonia)."
+                            description = "The project kind: api (ASP.NET Core), console, or desktop (Avalonia)."
                         }
                     },
                     required = new[] { "archiveName", "description", "kind" }
                 },
                 ArtifactTools.Propose)
-            .AddTool<ArtifactTools.GenerateArgs>(
-                "generate_artifact",
-                "Packages a complete .NET solution into a ZIP archive and uploads it to cloud storage. " +
-                "ONLY call when the user explicitly confirms they want to download. " +
-                "Include all files needed to run: .csproj with correct NuGet references (use Version=\"*\" for MaIN.NET/MaIN.Skills.* — never a guessed version number), Program.cs, and any supporting files. " +
-                "Do NOT call proactively.",
-                new
-                {
-                    type = "object",
-                    properties = new
-                    {
-                        archiveName = new { type = "string", description = "ZIP filename, e.g. MyAgent.zip" },
-                        files = new
-                        {
-                            type = "array",
-                            description = "Files to include in the archive",
-                            items = new
-                            {
-                                type = "object",
-                                properties = new
-                                {
-                                    path    = new { type = "string", description = "Relative path inside the zip, e.g. MyAgent/Program.cs" },
-                                    content = new { type = "string", description = "Complete file content" }
-                                },
-                                required = new[] { "path", "content" }
-                            }
-                        },
-                        description = new { type = "string", description = "One-line description of what the solution does" }
-                    },
-                    required = new[] { "archiveName", "files" }
-                },
-                ArtifactTools.Generate)
             .WithMaxIterations(10)
             .WithToolChoice("auto")
             .Build();
@@ -1254,7 +1242,7 @@ FRAMEWORK FACTS (don't guess, verify via tools):
         - Console bootstrap: MaINBootstrapper.Initialize(); ASP.NET: services.AddMaIN(configuration)
         - MCP has 3 integration styles: direct prompt, agent pipeline step, RAG knowledge source
 
-        TOOL ECONOMY: You have 7 tool slots. list_docs (1) → read app-template doc + maybe 1 more (2) → answer. Never read the same file twice. Propose artifact counts as 1 slot.
+        TOOL ECONOMY: You have 10 tool slots. list_docs (1) → read app-template doc + maybe 1 more (2) → show_file × N files (N) → propose_artifact_generation (1) = done. Never read the same file twice.
 
         TOOLS — use them every time, no improvising:
         1. list_docs — discover what files exist
@@ -1348,17 +1336,17 @@ that text directly into agent.ProcessAsync($"...the user's request...\n\n{extrac
           — NOT a type called "FileTypeFilter").
 
         ARTIFACTS — MANDATORY ORDER, NO EXCEPTIONS:
-        1. Write out EVERY file of the complete solution directly in your response TEXT first — minimum
-           .csproj + Program.cs, each as its own fenced code block immediately preceded by a line
-           "File: <path>". Nothing omitted, nothing summarized. THIS IS THE ONLY WAY THE USER SEES YOUR CODE.
-        2. ONLY THEN, in that same response, may you call propose_artifact_generation as an optional
-           convenience download. Calling it without first writing the code blocks in step 1 is a hard
-           failure — a tool call is not a substitute for showing the code.
-        3. Only propose when the solution is complete and runnable (has .csproj + Program.cs + runs with 'dotnet run').
-        4. generate_artifact: ONLY when the user explicitly confirms they want the download. Package the full project.
-        5. After generate_artifact succeeds, do NOT include the download URL in your text — the UI shows a download card. Just confirm it's ready.
-
-        RESPONSE RULE: ALWAYS write text in your response. When proposing an artifact, include a brief explanation of what you built. When generating an artifact, confirm it's ready in 1 sentence. Never return an empty text response.
+        1. Call show_file once for EVERY file in the solution — minimum .csproj + Program.cs.
+           This is the ONLY way the user sees your code. Do NOT write fenced code blocks in your
+           text. Do NOT combine files or skip any file.
+        2. After all show_file calls, write 1-2 sentences in your text describing what you built.
+        3. Call propose_artifact_generation to offer the download. Only call when the solution
+           is complete and runnable (has .csproj + Program.cs, runs with 'dotnet run').
+        4. The UI packages the shown files into a ZIP when the user clicks download — you do NOT
+           need to call any generate tool. Never confirm or mention downloading in your text.
+
+        RESPONSE RULE: ALWAYS write text in your response. Keep it to 1-3 sentences — the code is
+        shown via show_file tiles, so your text is just the summary. Never return an empty text response.
         """;
 
     private const string DesignSystemPrompt = """

backend/MaIN.Docs.Api/Services/FileTools.cs

@@ -0,0 +1,17 @@
+namespace MaIN.Docs.Api.Services;
+
+public static class FileTools
+{
+    public record ShowFileArgs(string Path, string Content, string Language = "");
+
+    private static Action<(string Path, string Content, string Language)>? _capture;
+
+    public static void SetCapture(Action<(string Path, string Content, string Language)>? capture)
+        => _capture = capture;
+
+    public static Task<object> Show(ShowFileArgs args)
+    {
+        _capture?.Invoke((args.Path, args.Content, args.Language));
+        return Task.FromResult<object>(new { shown = true, path = args.Path });
+    }
+}

frontend/public/staticwebapp.config.json

@@ -0,0 +1,16 @@
+{
+  "navigationFallback": {
+    "rewrite": "/index.html",
+    "exclude": [
+      "/api/**",
+      "/env.js",
+      "/scripts/**",
+      "/docs/**",
+      "*.{css,js,png,gif,ico,svg,woff,woff2,ttf,eot,map}"
+    ]
+  },
+  "mimeTypes": {
+    ".ps1": "text/plain",
+    ".sh": "text/plain"
+  }
+}