feat: implement scaffolding for agentrc.config.json and enhance workspace status view

Author: Harald Kirschner

packages/core/src/services/configScaffold.ts

@@ -0,0 +1,51 @@
+import path from "path";
+
+import { safeWriteFile } from "../utils/fs";
+
+import { detectWorkspaces } from "./analyzer";
+import type { Area } from "./analyzer";
+import type { AgentrcConfig, AgentrcConfigArea } from "./analyzer/config";
+export type ScaffoldConfigResult = {
+  wrote: boolean;
+  configPath: string;
+};
+
+/**
+ * Scaffolds agentrc.config.json from a list of detected areas.
+ * Detects workspaces automatically and maps standalone areas.
+ * Returns null if there are no areas to write (nothing to scaffold).
+ */
+export async function scaffoldAgentrcConfig(
+  repoPath: string,
+  areas: Area[],
+  force = false
+): Promise<ScaffoldConfigResult | null> {
+  if (areas.length === 0) return null;
+
+  const configPath = path.join(repoPath, "agentrc.config.json");
+  const workspaces = await detectWorkspaces(repoPath, areas);
+
+  const workspacePaths = workspaces.map((ws) => ws.path + "/");
+
+  const standaloneAreas: AgentrcConfigArea[] = areas
+    .filter((a) => {
+      if (!a.path) return true;
+      const rel = path.relative(repoPath, a.path).replace(/\\/gu, "/");
+      return !workspacePaths.some((prefix) => rel.startsWith(prefix));
+    })
+    .map((a) => ({
+      name: a.name,
+      applyTo: a.applyTo,
+      ...(a.description ? { description: a.description } : {})
+    }));
+
+  const agentrcConfig: AgentrcConfig = {};
+  if (workspaces.length > 0) agentrcConfig.workspaces = workspaces;
+  if (standaloneAreas.length > 0) agentrcConfig.areas = standaloneAreas;
+
+  if (!agentrcConfig.workspaces && !agentrcConfig.areas) return null;
+
+  const configContent = JSON.stringify(agentrcConfig, null, 2) + "\n";
+  const { wrote } = await safeWriteFile(configPath, configContent, force);
+  return { wrote, configPath };
+}

src/commands/init.ts

@@ -1,7 +1,6 @@
 import path from "path";
 
-import { analyzeRepo, detectWorkspaces } from "@agentrc/core/services/analyzer";
-import type { AgentrcConfig, AgentrcConfigArea } from "@agentrc/core/services/analyzer";
+import { analyzeRepo } from "@agentrc/core/services/analyzer";
 import type {
   AzureDevOpsOrg,
   AzureDevOpsProject,
@@ -13,6 +12,7 @@ import {
   listProjects,
   listRepos
 } from "@agentrc/core/services/azureDevops";
+import { scaffoldAgentrcConfig } from "@agentrc/core/services/configScaffold";
 import type { FileAction } from "@agentrc/core/services/generator";
 import { generateConfigs } from "@agentrc/core/services/generator";
 import { buildAuthedUrl, cloneRepo, isGitRepo, setRemoteUrl } from "@agentrc/core/services/git";
@@ -232,36 +232,14 @@ export async function initCommand(
 
   // Bootstrap agentrc.config.json with detected workspaces and standalone areas
   if (analysis.areas && analysis.areas.length > 0) {
-    const configPath = path.join(repoPath, "agentrc.config.json");
-    const workspaces = await detectWorkspaces(repoPath, analysis.areas);
-
-    // Areas already claimed by a workspace (match by path prefix, not name)
-    const workspacePaths = workspaces.map((ws) => ws.path + "/");
-
-    // Standalone areas not inside any workspace
-    const standaloneAreas: AgentrcConfigArea[] = analysis.areas
-      .filter((a) => {
-        if (!a.path) return true;
-        const rel = path.relative(repoPath, a.path).replace(/\\/gu, "/");
-        return !workspacePaths.some((prefix) => rel.startsWith(prefix));
-      })
-      .map((a) => ({
-        name: a.name,
-        applyTo: a.applyTo,
-        ...(a.description ? { description: a.description } : {})
-      }));
-
-    const agentrcConfig: AgentrcConfig = {};
-    if (workspaces.length > 0) agentrcConfig.workspaces = workspaces;
-    if (standaloneAreas.length > 0) agentrcConfig.areas = standaloneAreas;
-
-    if (agentrcConfig.workspaces || agentrcConfig.areas) {
-      const configContent = JSON.stringify(agentrcConfig, null, 2) + "\n";
-      const { wrote } = await safeWriteFile(configPath, configContent, Boolean(options.force));
-      const rel = path.relative(process.cwd(), configPath);
-      allFiles.push({ path: rel, action: wrote ? "wrote" : "skipped" });
+    const result = await scaffoldAgentrcConfig(repoPath, analysis.areas, Boolean(options.force));
+    if (result) {
+      const rel = path.relative(process.cwd(), result.configPath);
+      allFiles.push({ path: rel, action: result.wrote ? "wrote" : "skipped" });
       if (shouldLog(options)) {
-        process.stderr.write((wrote ? `Wrote ${rel}` : `Skipped ${rel} (exists)`) + "\n");
+        process.stderr.write(
+          (result.wrote ? `Wrote ${rel}` : `Skipped ${rel} (exists)`) + "\n"
+        );
       }
     }
   }

src/ui/tui.tsx

@@ -4,6 +4,7 @@ import path from "path";
 import type { RepoApp, Area } from "@agentrc/core/services/analyzer";
 import { analyzeRepo, loadAgentrcConfig } from "@agentrc/core/services/analyzer";
 import { getAzureDevOpsToken } from "@agentrc/core/services/azureDevops";
+import { scaffoldAgentrcConfig } from "@agentrc/core/services/configScaffold";
 import { listCopilotModels } from "@agentrc/core/services/copilot";
 import { generateEvalScaffold } from "@agentrc/core/services/evalScaffold";
 import type { EvalConfig } from "@agentrc/core/services/evalScaffold";
@@ -184,6 +185,7 @@ export function AgentRCTui({ repoPath, skipAnimation = false }: Props): React.JS
   const [modelPickTarget, setModelPickTarget] = useState<"eval" | "judge">("eval");
   const [modelCursor, setModelCursor] = useState(0);
   const [hasEvalConfig, setHasEvalConfig] = useState<boolean | null>(null);
+  const [hasAgentrcConfig, setHasAgentrcConfig] = useState<boolean | null>(null);
   const [activityLog, setActivityLog] = useState<LogEntry[]>([]);
   const [generateTarget, setGenerateTarget] = useState<"copilot-instructions" | "agents-md">(
     "copilot-instructions"
@@ -219,12 +221,26 @@ export function AgentRCTui({ repoPath, skipAnimation = false }: Props): React.JS
     setStatus("idle");
   };
 
-  // Check for eval config and repo structure on mount
+  // Check for eval config, agentrc config, and repo structure on mount
   useEffect(() => {
     const configPath = path.join(repoPath, "agentrc.eval.json");
     fs.access(configPath)
       .then(() => setHasEvalConfig(true))
       .catch(() => setHasEvalConfig(false));
+    const agentrcConfigCandidates = [
+      path.join(repoPath, "agentrc.config.json"),
+      path.join(repoPath, ".github", "agentrc.config.json")
+    ];
+    Promise.all(
+      agentrcConfigCandidates.map((p) =>
+        fs
+          .access(p)
+          .then(() => true)
+          .catch(() => false)
+      )
+    )
+      .then((results) => setHasAgentrcConfig(results.some(Boolean)))
+      .catch(() => setHasAgentrcConfig(false));
     analyzeRepo(repoPath)
       .then((analysis) => {
         const apps = analysis.apps ?? [];
@@ -233,6 +249,7 @@ export function AgentRCTui({ repoPath, skipAnimation = false }: Props): React.JS
         setRepoAreas(analysis.areas ?? []);
       })
       .catch((err) => {
+        setRepoAreas([]);
         addLog(`Repo analysis failed: ${err instanceof Error ? err.message : "unknown"}`, "error");
       });
   }, [repoPath]);
@@ -832,6 +849,46 @@ export function AgentRCTui({ repoPath, skipAnimation = false }: Props): React.JS
               return;
             }
 
+            if (input.toLowerCase() === "c") {
+              if (hasAgentrcConfig) {
+                setMessage("agentrc.config.json already exists.");
+                return;
+              }
+              if (repoAreas.length === 0) {
+                setMessage("No areas detected. Cannot scaffold agentrc.config.json.");
+                return;
+              }
+              setStatus("generating");
+              setMessage("Creating agentrc.config.json...");
+              addLog("Scaffolding agentrc.config.json...", "progress");
+              try {
+                const result = await scaffoldAgentrcConfig(repoPath, repoAreas);
+                if (!result) {
+                  setStatus("idle");
+                  setMessage("Nothing to scaffold — no areas or workspaces detected.");
+                  addLog("No areas to scaffold into config.", "info");
+                } else if (result.wrote) {
+                  setHasAgentrcConfig(true);
+                  setStatus("done");
+                  const msg = `Created agentrc.config.json`;
+                  setMessage(msg);
+                  addLog(msg, "success");
+                } else {
+                  setHasAgentrcConfig(true);
+                  setStatus("idle");
+                  setMessage("agentrc.config.json already exists (skipped).");
+                  addLog("agentrc.config.json already exists.", "info");
+                }
+              } catch (error) {
+                setStatus("error");
+                const msg =
+                  error instanceof Error ? error.message : "Failed to create config.";
+                setMessage(msg);
+                addLog(msg, "error");
+              }
+              return;
+            }
+
             if (input.toLowerCase() === "m") {
               if (hideModelPicker) {
                 setMessage(
@@ -1011,6 +1068,18 @@ export function AgentRCTui({ repoPath, skipAnimation = false }: Props): React.JS
             <Text color="yellow">no eval config — press [I] to create</Text>
           )}
         </Text>
+        <Text>
+          <Text color="gray">Config </Text>
+          {hasAgentrcConfig === null ? (
+            <Text color="gray" dimColor>
+              checking...
+            </Text>
+          ) : hasAgentrcConfig ? (
+            <Text color="green">agentrc.config.json found</Text>
+          ) : (
+            <Text color="yellow">no config — press [C] to create</Text>
+          )}
+        </Text>
       </Box>
 
       {/* Activity */}
@@ -1314,6 +1383,7 @@ export function AgentRCTui({ repoPath, skipAnimation = false }: Props): React.JS
             <Box>
               <KeyHint k="M" label="Model" />
               <KeyHint k="J" label="Judge" />
+              {!hasAgentrcConfig && <KeyHint k="C" label="Create config" />}
               <KeyHint k="Q" label="Quit" />
             </Box>
           </Box>

vscode-extension/package.json

@@ -94,6 +94,11 @@
     },
     "views": {
       "agentrc": [
+        {
+          "id": "agentrc.workspace",
+          "name": "Workspace",
+          "contextualTitle": "AgentRC"
+        },
         {
           "id": "agentrc.analysis",
           "name": "Analysis",
@@ -107,6 +112,11 @@
       ]
     },
     "viewsWelcome": [
+      {
+        "view": "agentrc.workspace",
+        "contents": "Open a folder to get started.\n[$(folder-opened) Open Folder](command:vscode.openFolder)",
+        "when": "workspaceFolderCount == 0"
+      },
       {
         "view": "agentrc.analysis",
         "contents": "Discover languages, frameworks, and project structure in your repository.\n[$(search) Analyze Repository](command:agentrc.analyze)\nNew to AgentRC? [Get Started](command:workbench.action.openWalkthrough?%5B%22microsoft.agentrc-vscode%23agentrc.gettingStarted%22%5D)",

vscode-extension/src/extension.ts

@@ -7,7 +7,7 @@ import { evalCommand, evalInitCommand } from "./commands/eval.js";
 import { initCommand } from "./commands/init.js";
 import { prCommand } from "./commands/pr.js";
 import { batchInstructionsCommand } from "./commands/batch.js";
-import { analysisTreeProvider, readinessTreeProvider } from "./views/providers.js";
+import { analysisTreeProvider, readinessTreeProvider, workspaceStatusTreeProvider } from "./views/providers.js";
 
 export function activate(context: vscode.ExtensionContext): void {
   // Status bar — only show after analysis
@@ -18,13 +18,16 @@ export function activate(context: vscode.ExtensionContext): void {
   context.subscriptions.push(statusBar);
 
   // Tree views (createTreeView for description/badge support)
+  const workspaceView = vscode.window.createTreeView("agentrc.workspace", {
+    treeDataProvider: workspaceStatusTreeProvider
+  });
   const analysisView = vscode.window.createTreeView("agentrc.analysis", {
     treeDataProvider: analysisTreeProvider
   });
   const readinessView = vscode.window.createTreeView("agentrc.readiness", {
     treeDataProvider: readinessTreeProvider
   });
-  context.subscriptions.push(analysisView, readinessView);
+  context.subscriptions.push(workspaceView, analysisView, readinessView);
 
   function updateAnalysisView(): void {
     const analysis = getCachedAnalysis();
@@ -74,10 +77,14 @@ export function activate(context: vscode.ExtensionContext): void {
       updateStatusBar();
     }),
     vscode.commands.registerCommand("agentrc.eval", evalCommand),
-    vscode.commands.registerCommand("agentrc.evalInit", evalInitCommand),
+    vscode.commands.registerCommand("agentrc.evalInit", async () => {
+      await evalInitCommand();
+      workspaceStatusTreeProvider.refresh();
+    }),
     vscode.commands.registerCommand("agentrc.init", async () => {
       await initCommand();
       analysisTreeProvider.refresh();
+      workspaceStatusTreeProvider.refresh();
       updateAnalysisView();
       updateStatusBar();
       vscode.commands.executeCommand("agentrc.analysis.focus");