stack-agent 0.2.0 → 0.3.1

package/README.md

@@ -5,22 +5,16 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/node/v/stack-agent)](https://nodejs.org)
 
-AI-powered CLI that helps developers choose and scaffold full-stack applications through conversational interaction.
+AI-powered CLI that helps developers choose and scaffold full-stack applications through a fullscreen terminal UI.
 
-A senior software architect in your terminal — it walks you through stack decisions, explains trade-offs, and scaffolds your project using official framework tools.
+A senior software architect in your terminal — it recommends your entire stack, lets you review and refine each decision, then scaffolds the project with integration code.
 
-## How it works
-
-1. **Conversation** — The agent asks what you're building, then guides you through frontend, backend, database, auth, payments, AI/LLM, and deployment choices
-2. **Recommendations** — Each stage presents 2-3 options with a recommended pick and trade-off context
-3. **Review** — Once all decisions are made, the agent presents your full stack for approval
-4. **Scaffold** — The agent runs official tools (create-next-app, create-vite, etc.) and generates integration code grounded by current documentation
-
-## Quick start
+## Usage
 
 ```bash
 export ANTHROPIC_API_KEY=your-key-here
-npx stack-agent
+npx stack-agent            # Start or resume a session
+npx stack-agent --fresh    # Clear saved progress and start over
 ```
 
 ## Requirements
@@ -28,19 +22,13 @@ npx stack-agent
 - Node.js 20+
 - An [Anthropic API key](https://console.anthropic.com/settings/keys)
 
-## What it does
-
-- Delegates base scaffolding to official framework CLIs (create-next-app, create-vite, etc.)
-- Generates integration code (auth, database, payments) using Claude, grounded by up-to-date documentation via MCP
-- Writes `.env.example` with required environment variables
-- Installs dependencies automatically
-
 ## Development
 
 ```bash
 npm install
 npm run dev          # Run with tsx
-npm test             # Run tests
+npm run mockup       # Run interactive TUI mockup (no LLM calls)
+npm test             # Run tests (176 tests)
 npm run build        # Build with tsup
 ```
 

package/dist/index.js

@@ -6,14 +6,14 @@ import { withFullScreen } from "fullscreen-ink";
 
 // src/cli/app.tsx
 import { useState as useState5, useEffect as useEffect2, useCallback } from "react";
-import { Box as Box7, Text as Text7, useApp, useInput as useInput3 } from "ink";
+import { Box as Box8, Text as Text8, useApp, useInput as useInput3 } from "ink";
 import { useScreenSize } from "fullscreen-ink";
 
 // src/cli/components/header.tsx
 import { Box, Text } from "ink";
 import { jsx, jsxs } from "react/jsx-runtime";
-function Header({ appName, currentStage, stages, showDots = false }) {
-  const stageName = currentStage?.label ?? "Stack Progress";
+function Header({ appName, currentStage, stages, showDots = false, title }) {
+  const stageName = title ?? currentStage?.label ?? "Stack Progress";
   return /* @__PURE__ */ jsxs(Box, { borderStyle: "single", borderBottom: false, paddingX: 1, justifyContent: "space-between", children: [
     /* @__PURE__ */ jsxs(Box, { gap: 2, children: [
       /* @__PURE__ */ jsx(Text, { bold: true, color: "cyan", children: appName }),
@@ -53,6 +53,9 @@ function Footer({ progress, stages, terminalWidth, mode = "decisions" }) {
     case "input":
       display = "Enter submit \xB7 Esc stages";
       break;
+    case "scaffold":
+      display = "Scaffolding your project...";
+      break;
     default:
       display = buildDecisionsDisplay(progress, stages, terminalWidth);
       break;
@@ -259,12 +262,12 @@ function deserializeSession(json) {
 
 // src/cli/components/stage-list.tsx
 import { jsx as jsx5, jsxs as jsxs3 } from "react/jsx-runtime";
-function StageListView({ stages, currentStageId, progress, onResult }) {
+function StageListView({ stages, currentStageId, progress, showFresh = false, onResult }) {
   const [showConfirm, setShowConfirm] = useState3(false);
   const [showWarning, setShowWarning] = useState3("");
   const [cursor, setCursor] = useState3(0);
   const canBuild = isComplete(progress);
-  const itemCount = stages.length + 1;
+  const itemCount = stages.length + 1 + (showFresh ? 1 : 0);
   useInput2((input, key) => {
     if (showConfirm) return;
     if (key.upArrow) {
@@ -278,13 +281,15 @@ function StageListView({ stages, currentStageId, progress, onResult }) {
     if (key.return) {
       if (cursor < stages.length) {
         onResult({ kind: "select", stageId: stages[cursor].id });
-      } else {
+      } else if (cursor === stages.length) {
         if (canBuild) {
           setShowConfirm(true);
         } else {
           const missing = getMissingDecisions(progress);
           setShowWarning(`Complete ${missing.join(", ")} first.`);
         }
+      } else {
+        onResult({ kind: "fresh" });
       }
     }
     if (key.escape) {
@@ -322,6 +327,10 @@ function StageListView({ stages, currentStageId, progress, onResult }) {
         requiredRemaining(progress),
         " remaining)"
       ] })
+    ] }),
+    showFresh && /* @__PURE__ */ jsxs3(Box5, { children: [
+      /* @__PURE__ */ jsx5(Text5, { children: cursor === stages.length + 1 ? "\u276F " : "  " }),
+      /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: "Start fresh" })
     ] })
   ] });
 }
@@ -391,7 +400,7 @@ function getMissingDecisions(progress) {
 }
 
 // src/cli/app.tsx
-import { TextInput as TextInput2, Spinner as Spinner2 } from "@inkjs/ui";
+import { TextInput as TextInput2, Spinner as Spinner3 } from "@inkjs/ui";
 
 // src/cli/components/project-info-form.tsx
 import { useState as useState4 } from "react";
@@ -444,14 +453,34 @@ function ProjectInfoForm({ onSubmit }) {
   ] });
 }
 
+// src/cli/components/scaffold-view.tsx
+import { Box as Box7, Text as Text7 } from "ink";
+import { Spinner as Spinner2 } from "@inkjs/ui";
+import { jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
+function ScaffoldView({ steps }) {
+  return /* @__PURE__ */ jsx7(Box7, { flexDirection: "column", children: steps.map((step, i) => /* @__PURE__ */ jsxs5(Box7, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs5(Box7, { children: [
+      step.status === "running" && /* @__PURE__ */ jsx7(Spinner2, {}),
+      step.status === "done" && /* @__PURE__ */ jsx7(Text7, { color: "green", children: "\u2713" }),
+      step.status === "error" && /* @__PURE__ */ jsx7(Text7, { color: "red", children: "\u2717" }),
+      /* @__PURE__ */ jsxs5(Text7, { bold: step.status === "running", children: [
+        " ",
+        step.name
+      ] })
+    ] }),
+    step.status === "done" && step.files && step.files.length > 0 && /* @__PURE__ */ jsx7(Box7, { paddingLeft: 3, children: /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: step.files.join(", ") }) }),
+    step.status === "error" && step.error && /* @__PURE__ */ jsx7(Box7, { paddingLeft: 3, children: /* @__PURE__ */ jsx7(Text7, { color: "red", children: step.error }) })
+  ] }, i)) });
+}
+
 // src/cli/bridge.ts
 function createBridge() {
   const listeners = /* @__PURE__ */ new Map();
   let pendingResolve = null;
-  function emit(event, ...args2) {
+  function emit(event, ...args) {
     const set = listeners.get(event);
     if (set) {
-      for (const fn of set) fn(...args2);
+      for (const fn of set) fn(...args);
     }
   }
   return {
@@ -488,20 +517,48 @@ import { join as join2 } from "path";
 import Anthropic from "@anthropic-ai/sdk";
 
 // src/util/logger.ts
-import pino from "pino";
-var logger = pino({
-  level: process.env.LOG_LEVEL ?? "info",
-  transport: process.env.NODE_ENV !== "production" ? { target: "pino-pretty", options: { destination: 2 } } : void 0
-}, process.env.NODE_ENV === "production" ? pino.destination(2) : void 0);
+var LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+var currentLevel = process.env.LOG_LEVEL ?? "info";
+function log(level, component, msg, data) {
+  if (LEVELS[level] < LEVELS[currentLevel]) return;
+  const prefix = `[${level}] [${component}]`;
+  const line = data ? `${prefix} ${msg} ${JSON.stringify(data)}` : `${prefix} ${msg}`;
+  process.stderr.write(line + "\n");
+}
 function createLogger(component) {
-  return logger.child({ component });
+  return {
+    debug: (data, msg) => log("debug", component, msg, data),
+    info: (data, msg) => log("info", component, msg, data),
+    warn: (data, msg) => log("warn", component, msg, data),
+    error: (data, msg) => log("error", component, msg, data)
+  };
 }
 
 // src/llm/client.ts
-var log = createLogger("llm");
+var log2 = createLogger("llm");
 function summarizeMessages(messages) {
   return `${messages.length} messages, last: ${messages.at(-1)?.role ?? "none"}`;
 }
+function withMessageCaching(messages) {
+  if (messages.length < 2) return messages;
+  const cached = messages.map((m, i) => {
+    if (i !== messages.length - 2) return m;
+    const content = m.content;
+    if (typeof content === "string") {
+      return { ...m, content: [{ type: "text", text: content, cache_control: { type: "ephemeral" } }] };
+    }
+    if (Array.isArray(content)) {
+      const blocks = [...content];
+      const last = blocks[blocks.length - 1];
+      if (last) {
+        blocks[blocks.length - 1] = { ...last, cache_control: { type: "ephemeral" } };
+      }
+      return { ...m, content: blocks };
+    }
+    return m;
+  });
+  return cached;
+}
 function getClient() {
   const apiKey = process.env.ANTHROPIC_API_KEY;
   if (!apiKey) {
@@ -520,7 +577,7 @@ function client() {
 }
 async function chat(options) {
   const { system, messages, tools, maxTokens, mcpServers } = options;
-  log.debug({ maxTokens, toolCount: tools?.length ?? 0, messages: summarizeMessages(messages) }, "chat request");
+  log2.debug({ maxTokens, toolCount: tools?.length ?? 0, messages: summarizeMessages(messages) }, "chat request");
   let response;
   if (mcpServers && Object.keys(mcpServers).length > 0) {
     const mcpServerList = Object.entries(mcpServers).map(([name, config]) => ({
@@ -550,39 +607,39 @@ async function chat(options) {
     response = await client().messages.create({
       model: "claude-sonnet-4-6",
       max_tokens: maxTokens,
-      system,
-      messages,
+      system: [{ type: "text", text: system, cache_control: { type: "ephemeral" } }],
+      messages: withMessageCaching(messages),
       ...tools && tools.length > 0 && { tools }
     });
   }
-  log.info({
+  log2.info({
     stopReason: response.stop_reason,
     contentBlocks: response.content.length,
     usage: response.usage
   }, "chat response");
-  log.debug({ content: response.content }, "chat response content");
+  log2.debug({ content: response.content }, "chat response content");
   return response;
 }
 async function chatStream(options, callbacks) {
   const { system, messages, tools, maxTokens } = options;
-  log.debug({ maxTokens, toolCount: tools?.length ?? 0, messages: summarizeMessages(messages) }, "chatStream request");
+  log2.debug({ maxTokens, toolCount: tools?.length ?? 0, messages: summarizeMessages(messages) }, "chatStream request");
   const stream = client().messages.stream({
     model: "claude-sonnet-4-6",
     max_tokens: maxTokens,
-    system,
-    messages,
+    system: [{ type: "text", text: system, cache_control: { type: "ephemeral" } }],
+    messages: withMessageCaching(messages),
     ...tools && tools.length > 0 && { tools }
   });
   stream.on("text", (text) => {
     callbacks.onText(text);
   });
   const finalMessage = await stream.finalMessage();
-  log.info({
+  log2.info({
     stopReason: finalMessage.stop_reason,
     contentBlocks: finalMessage.content.length,
     usage: finalMessage.usage
   }, "chatStream response");
-  log.debug({ content: finalMessage.content }, "chatStream response content");
+  log2.debug({ content: finalMessage.content }, "chatStream response content");
   for (const block of finalMessage.content) {
     if (block.type === "tool_use") {
       callbacks.onToolUse(block);
@@ -709,6 +766,10 @@ function scaffoldToolDefinitions() {
       input_schema: {
         type: "object",
         properties: {
+          name: {
+            type: "string",
+            description: 'Short name for this integration (e.g. "Database", "Auth", "AI Chat", "Deploy Config").'
+          },
           files: {
             type: "object",
             additionalProperties: { type: "string" },
@@ -735,7 +796,7 @@ function scaffoldToolDefinitions() {
             description: "List of environment variable names required by the integration."
           }
         },
-        required: ["files"]
+        required: ["name", "files"]
       }
     }
   ];
@@ -878,7 +939,7 @@ Do not ask for confirmation. Proceed through all steps automatically.`;
 import { execFileSync } from "child_process";
 import { readdirSync, existsSync } from "fs";
 import { join } from "path";
-function runScaffold(tool, args2, projectName, cwd) {
+function runScaffold(tool, args, projectName, cwd) {
   const outputDir = join(cwd, projectName);
   if (existsSync(outputDir)) {
     const entries = readdirSync(outputDir);
@@ -888,7 +949,7 @@ function runScaffold(tool, args2, projectName, cwd) {
       );
     }
   }
-  const spawnArgs = [`${tool}@latest`, projectName, ...args2];
+  const spawnArgs = [`${tool}@latest`, projectName, ...args];
   const opts = { cwd, stdio: "pipe" };
   execFileSync("npx", spawnArgs, opts);
   return outputDir;
@@ -1068,14 +1129,7 @@ async function runStageLoop(stage, manager, bridge, mcpServers) {
     messages.push({ role: "user", content: inputResult.value });
   }
 }
-function createSimpleSpinner() {
-  return {
-    start: (msg) => process.stdout.write(`  ${msg}...`),
-    stop: (msg) => process.stdout.write(` ${msg}
-`)
-  };
-}
-async function runScaffoldLoop(progress, mcpServers) {
+async function runScaffoldLoop(progress, onProgress, mcpServers) {
   const messages = [];
   const system = buildScaffoldPrompt(progress);
   const cwd = process.cwd();
@@ -1083,11 +1137,22 @@ async function runScaffoldLoop(progress, mcpServers) {
   const projectDir = join2(cwd, projectName);
   let toolCallCount = 0;
   const maxToolCalls = 30;
+  const steps = [];
+  function pushStep(step) {
+    steps.push(step);
+    onProgress?.([...steps]);
+  }
+  function updateLastStep(patch) {
+    const last = steps[steps.length - 1];
+    if (last) Object.assign(last, patch);
+    onProgress?.([...steps]);
+  }
   messages.push({
     role: "user",
     content: "Begin scaffolding the project according to the plan."
   });
   while (true) {
+    pushStep({ name: "Planning next step...", status: "running" });
     const response = await chat({
       system,
       messages,
@@ -1095,6 +1160,8 @@ async function runScaffoldLoop(progress, mcpServers) {
       maxTokens: 16384,
       mcpServers
     });
+    steps.pop();
+    onProgress?.([...steps]);
     const contentBlocks = response.content;
     const toolUseBlocks = contentBlocks.filter(
       (b) => b.type === "tool_use"
@@ -1108,30 +1175,30 @@ async function runScaffoldLoop(progress, mcpServers) {
       const toolBlock = block;
       toolCallCount++;
       if (toolCallCount > maxToolCalls) {
-        console.error(`Tool call limit exceeded (${maxToolCalls}). Stopping scaffold loop.`);
+        pushStep({ name: "Tool call limit exceeded", status: "error", error: `Exceeded ${maxToolCalls} tool calls` });
         return false;
       }
-      const spinner = createSimpleSpinner();
       try {
         if (toolBlock.name === "run_scaffold") {
-          spinner.start(`Running scaffold: ${toolBlock.input.tool}`);
+          pushStep({ name: "Creating project", status: "running" });
           const outputDir = runScaffold(
             toolBlock.input.tool,
             toolBlock.input.args,
             projectName,
             cwd
           );
-          spinner.stop(`Scaffold complete: ${outputDir}`);
+          updateLastStep({ name: "Created project", status: "done" });
           toolResults.push({
             type: "tool_result",
             tool_use_id: toolBlock.id,
             content: `Scaffold completed. Project created at ${outputDir}`
           });
         } else if (toolBlock.name === "add_integration") {
-          const integrationDesc = Object.keys(
+          const files = Object.keys(
             toolBlock.input.files ?? {}
-          ).join(", ");
-          spinner.start(`Adding integration: ${integrationDesc}`);
+          );
+          const integrationName = toolBlock.input.name ?? "Integration";
+          pushStep({ name: `Adding ${integrationName}`, status: "running" });
           writeIntegration(projectDir, {
             files: toolBlock.input.files ?? {},
             dependencies: toolBlock.input.dependencies,
@@ -1139,14 +1206,14 @@ async function runScaffoldLoop(progress, mcpServers) {
             scripts: toolBlock.input.scripts,
             envVars: toolBlock.input.envVars
           });
-          spinner.stop("Integration added");
+          updateLastStep({ name: integrationName, status: "done", files });
           toolResults.push({
             type: "tool_result",
             tool_use_id: toolBlock.id,
             content: "Integration written successfully."
           });
         } else {
-          spinner.stop(`Unknown tool: ${toolBlock.name}`);
+          pushStep({ name: `Unknown tool: ${toolBlock.name}`, status: "error", error: `Unknown tool: "${toolBlock.name}"` });
           toolResults.push({
             type: "tool_result",
             tool_use_id: toolBlock.id,
@@ -1156,7 +1223,7 @@ async function runScaffoldLoop(progress, mcpServers) {
         }
       } catch (err) {
         const errorMessage = err instanceof Error ? err.message : String(err);
-        spinner.stop(`Error: ${errorMessage}`);
+        updateLastStep({ status: "error", error: errorMessage });
         toolResults.push({
           type: "tool_result",
           tool_use_id: toolBlock.id,
@@ -1170,7 +1237,7 @@ async function runScaffoldLoop(progress, mcpServers) {
 }
 
 // src/agent/recommend.ts
-var log2 = createLogger("recommend");
+var log3 = createLogger("recommend");
 var RECOMMEND_PROMPT = `You are a senior software architect. Based on the project description, recommend a complete technology stack.
 
 For each category, provide your recommendation as a JSON object. If a category is not needed for this project, set it to null.
@@ -1204,15 +1271,15 @@ Description: ${description}`
       maxTokens: 1024
     });
     const text = response.content.filter((b) => b.type === "text").map((b) => b.text).join("");
-    log2.info({ rawLength: text.length }, "received recommendation response");
-    log2.debug({ rawText: text }, "recommendation raw text");
+    log3.info({ rawLength: text.length }, "received recommendation response");
+    log3.debug({ rawText: text }, "recommendation raw text");
     const jsonStr = text.replace(/^```(?:json)?\s*\n?/m, "").replace(/\n?```\s*$/m, "").trim();
     const parsed = JSON.parse(jsonStr);
     const categories = Object.keys(parsed).filter((k) => parsed[k] !== null);
-    log2.info({ recommended: categories, skipped: Object.keys(parsed).filter((k) => parsed[k] === null) }, "parsed recommendations");
+    log3.info({ recommended: categories, skipped: Object.keys(parsed).filter((k) => parsed[k] === null) }, "parsed recommendations");
     return parsed;
   } catch (err) {
-    log2.error({ err }, "recommendation pass failed");
+    log3.error({ err }, "recommendation pass failed");
     return {};
   }
 }
@@ -1256,8 +1323,8 @@ function applyRecommendations(progress, stages, recommendations) {
 }
 
 // src/cli/app.tsx
-import { jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
-function App({ manager, onBuild, onExit }) {
+import { jsx as jsx8, jsxs as jsxs6 } from "react/jsx-runtime";
+function App({ manager, isResumed, onBuild, onFresh, onExit }) {
   const app = useApp();
   const { width, height } = useScreenSize();
   const [view, setView] = useState5(
@@ -1269,6 +1336,7 @@ function App({ manager, onBuild, onExit }) {
   const [stages, setStages] = useState5([...manager.stages]);
   const [options, setOptions] = useState5([]);
   const [errorMsg, setErrorMsg] = useState5("");
+  const [scaffoldSteps, setScaffoldSteps] = useState5([]);
   const syncState = useCallback(() => {
     setProgress({ ...manager.progress });
     setStages([...manager.stages]);
@@ -1330,7 +1398,7 @@ function App({ manager, onBuild, onExit }) {
     syncState();
     setView("stage_list");
   }, [manager, bridge, syncState]);
-  const handleStageResult = useCallback((result) => {
+  const handleStageResult = useCallback(async (result) => {
     if (result.kind === "select") {
       const stage = manager.stages.find((s) => s.id === result.stageId);
       if (stage && (stage.status === "complete" || stage.status === "skipped")) {
@@ -1338,8 +1406,28 @@ function App({ manager, onBuild, onExit }) {
         syncState();
       }
       runStage(result.stageId);
+    } else if (result.kind === "fresh") {
+      onFresh();
+      app.exit();
     } else if (result.kind === "build") {
-      onBuild();
+      setView("scaffold");
+      setScaffoldSteps([]);
+      const onScaffoldProgress = (steps) => {
+        setScaffoldSteps([...steps]);
+      };
+      try {
+        const success = await runScaffoldLoop(manager.progress, onScaffoldProgress);
+        if (success) {
+          manager.cleanup();
+          onBuild();
+        } else {
+          onBuild();
+        }
+      } catch (err) {
+        setErrorMsg(err.message);
+        setView("error");
+        return;
+      }
       app.exit();
     } else if (result.kind === "cancel") {
       manager.save();
@@ -1385,34 +1473,36 @@ function App({ manager, onBuild, onExit }) {
     syncState();
     setView("stage_list");
   }, [manager, syncState]);
-  const footerMode = view === "stage_list" ? "stage_list" : view === "options" ? "options" : view === "input" || view === "project_info" ? "input" : "decisions";
+  const footerMode = view === "scaffold" ? "scaffold" : view === "stage_list" ? "stage_list" : view === "options" ? "options" : view === "input" || view === "project_info" ? "input" : "decisions";
   const contentHeight = height - 4;
-  return /* @__PURE__ */ jsxs5(Box7, { flexDirection: "column", width, height, children: [
-    /* @__PURE__ */ jsx7(
+  return /* @__PURE__ */ jsxs6(Box8, { flexDirection: "column", width, height, children: [
+    /* @__PURE__ */ jsx8(
       Header,
       {
         appName: "stack-agent",
-        currentStage: view === "stage_list" ? null : currentStage,
+        currentStage: view === "stage_list" || view === "scaffold" ? null : currentStage,
         stages,
-        showDots: view !== "stage_list"
+        showDots: view !== "stage_list" && view !== "scaffold",
+        title: view === "scaffold" ? "Scaffolding" : void 0
       }
     ),
-    /* @__PURE__ */ jsxs5(Box7, { flexDirection: "column", height: contentHeight, paddingX: 1, borderStyle: "single", borderTop: false, borderBottom: false, children: [
-      view === "project_info" && /* @__PURE__ */ jsx7(ProjectInfoForm, { onSubmit: handleProjectInfo }),
-      view === "loading" && /* @__PURE__ */ jsx7(Box7, { flexDirection: "column", children: /* @__PURE__ */ jsx7(Spinner2, { label: "Analyzing your project and recommending a stack..." }) }),
-      view === "stage_list" && /* @__PURE__ */ jsx7(
+    /* @__PURE__ */ jsxs6(Box8, { flexDirection: "column", height: contentHeight, paddingX: 1, borderStyle: "single", borderTop: false, borderBottom: false, children: [
+      view === "project_info" && /* @__PURE__ */ jsx8(ProjectInfoForm, { onSubmit: handleProjectInfo }),
+      view === "loading" && /* @__PURE__ */ jsx8(Box8, { flexDirection: "column", children: /* @__PURE__ */ jsx8(Spinner3, { label: "Analyzing your project and recommending a stack..." }) }),
+      view === "stage_list" && /* @__PURE__ */ jsx8(
         StageListView,
         {
           stages,
           currentStageId: currentStage?.id ?? null,
           progress,
+          showFresh: isResumed,
           onResult: handleStageResult
         }
       ),
-      view === "conversation" && /* @__PURE__ */ jsx7(ConversationView, { bridge, maxLines: contentHeight }),
-      view === "input" && /* @__PURE__ */ jsxs5(Box7, { flexDirection: "column", children: [
-        /* @__PURE__ */ jsx7(ConversationView, { bridge, maxLines: contentHeight - 3 }),
-        /* @__PURE__ */ jsx7(Box7, { marginTop: 1, children: /* @__PURE__ */ jsx7(
+      view === "conversation" && /* @__PURE__ */ jsx8(ConversationView, { bridge, maxLines: contentHeight }),
+      view === "input" && /* @__PURE__ */ jsxs6(Box8, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsx8(ConversationView, { bridge, maxLines: contentHeight - 3 }),
+        /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx8(
           TextInput2,
           {
             placeholder: "Type your response...",
@@ -1420,19 +1510,20 @@ function App({ manager, onBuild, onExit }) {
           }
         ) })
       ] }),
-      view === "options" && /* @__PURE__ */ jsxs5(Box7, { flexDirection: "column", children: [
-        /* @__PURE__ */ jsx7(ConversationView, { bridge, maxLines: contentHeight - 8 }),
-        /* @__PURE__ */ jsx7(OptionSelect, { options, onSelect: handleOptionSelect })
+      view === "options" && /* @__PURE__ */ jsxs6(Box8, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsx8(ConversationView, { bridge, maxLines: contentHeight - 8 }),
+        /* @__PURE__ */ jsx8(OptionSelect, { options, onSelect: handleOptionSelect })
       ] }),
-      view === "error" && /* @__PURE__ */ jsxs5(Box7, { flexDirection: "column", children: [
-        /* @__PURE__ */ jsxs5(Text7, { color: "red", bold: true, children: [
+      view === "error" && /* @__PURE__ */ jsxs6(Box8, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsxs6(Text8, { color: "red", bold: true, children: [
           "Error: ",
           errorMsg
         ] }),
-        /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "Press Esc to return to stage list" })
-      ] })
+        /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: "Press Esc to return to stage list" })
+      ] }),
+      view === "scaffold" && /* @__PURE__ */ jsx8(ScaffoldView, { steps: scaffoldSteps })
     ] }),
-    /* @__PURE__ */ jsx7(
+    /* @__PURE__ */ jsx8(
       Footer,
       {
         progress,
@@ -1939,70 +2030,60 @@ What needs to change?`;
     }
   };
 }
-async function main(fresh = false) {
+async function main(startFresh = false) {
   const cwd = process.cwd();
   const invalidationFn = createInvalidationFn();
   process.on("SIGINT", () => {
     process.exit(0);
   });
-  if (fresh) {
+  if (startFresh) {
     const tempManager = StageManager.resume(cwd);
     tempManager?.cleanup();
-    console.log("Session cleared. Starting fresh.\n");
   }
   let manager;
-  const existingSession = fresh ? null : StageManager.detect(cwd);
-  if (existingSession) {
-    console.log(`
-Found saved progress for "${existingSession.progress.projectName ?? "unnamed"}"`);
-    console.log("Run with --fresh to start over.\n");
+  const isResumed = !startFresh && StageManager.detect(cwd) !== null;
+  if (isResumed) {
     const resumed = StageManager.resume(cwd, invalidationFn);
-    if (!resumed) {
-      console.log("Could not restore session. Starting fresh.");
-      manager = StageManager.start(cwd, invalidationFn);
-    } else {
-      manager = resumed;
-    }
+    manager = resumed ?? StageManager.start(cwd, invalidationFn);
   } else {
     manager = StageManager.start(cwd, invalidationFn);
   }
   let shouldBuild = false;
+  let shouldStartFresh = false;
   const ink = withFullScreen(
     React6.createElement(App, {
       manager,
+      isResumed,
       onBuild: () => {
         shouldBuild = true;
       },
+      onFresh: () => {
+        shouldStartFresh = true;
+      },
       onExit: () => {
-        shouldBuild = false;
       }
     })
   );
   await ink.start();
   await ink.waitUntilExit();
+  if (shouldStartFresh) {
+    manager.cleanup();
+    return main(true);
+  }
   if (shouldBuild) {
-    console.log("\nScaffolding your project...\n");
-    const success = await runScaffoldLoop(manager.progress);
-    if (success) {
-      const readiness = manager.progress.deployment ? checkDeployReadiness(manager.progress.deployment.component) : null;
-      renderPostScaffold(manager.progress.projectName, readiness);
-      manager.cleanup();
-      console.log("\nHappy building!\n");
-    } else {
-      console.error("\nScaffolding encountered errors. Check the output above.\n");
-    }
+    const readiness = manager.progress.deployment ? checkDeployReadiness(manager.progress.deployment.component) : null;
+    renderPostScaffold(manager.progress.projectName, readiness);
+    console.log("\nHappy building!\n");
   }
 }
-var args = process.argv.slice(2);
-var command = args[0];
-var isFresh = args.includes("--fresh");
-if (!command || command === "init" || command === "--fresh") {
-  main(isFresh).catch((err) => {
+var command = process.argv[2];
+if (!command || command === "init") {
+  main().catch((err) => {
     console.error(err);
     process.exit(1);
   });
 } else {
   console.error(`Unknown command: ${command}`);
-  console.error("Usage: stack-agent [init] [--fresh]");
+  console.error("Usage: stack-agent [init]");
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stack-agent",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "AI-powered CLI that helps developers choose and scaffold full-stack applications through conversational interaction",
   "type": "module",
   "license": "MIT",
@@ -46,7 +46,6 @@
     "ink": "^6.8.0",
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",
-    "pino": "^10.3.1",
     "react": "^19.2.4",
     "zod": "^4.3.6"
   },
@@ -55,7 +54,6 @@
     "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "ink-testing-library": "^4.0.0",
-    "pino-pretty": "^13.1.3",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",