@kimbho/kimbho-cli 0.1.16 → 0.1.18

package/dist/index.cjs

@@ -10612,7 +10612,7 @@ var {
 // package.json
 var package_default = {
   name: "@kimbho/kimbho-cli",
-  version: "0.1.16",
+  version: "0.1.18",
   description: "Kimbho CLI is a terminal-native coding agent for planning, execution, and verification.",
   type: "module",
   engines: {
@@ -15029,7 +15029,9 @@ var PlanTaskSchema = external_exports.object({
   swarmDepth: external_exports.number().int().nonnegative().optional(),
   customAgentId: external_exports.string().min(1).optional(),
   teamId: external_exports.string().min(1).optional(),
-  teamMemberIds: external_exports.array(external_exports.string()).optional()
+  teamMemberIds: external_exports.array(external_exports.string()).optional(),
+  subagentLabel: external_exports.string().min(1).optional(),
+  subagentInstructions: external_exports.string().min(1).optional()
 });
 var PlanMilestoneSchema = external_exports.object({
   id: external_exports.string().min(1),
@@ -28070,6 +28072,9 @@ function buildSystemPrompt(agent, task, request, allowedTools, plan, extraInstru
   return [
     `You are Kimbho's ${agent.role}.`,
     `Purpose: ${agent.purpose}`,
+    ...task.subagentLabel ? [
+      `Delegated worker: ${task.subagentLabel}`
+    ] : [],
     `Goal: ${request.goal}`,
     `Current task: ${task.id} - ${task.title}`,
     `Task description: ${task.description}`,
@@ -28103,6 +28108,10 @@ function buildSystemPrompt(agent, task, request, allowedTools, plan, extraInstru
     `- After changing code, run verification with tests.run or shell.exec when appropriate.`,
     `- Do not claim success unless the task acceptance criteria are satisfied.`,
     `- If the task is underspecified, make a pragmatic implementation choice and continue.`,
+    ...task.subagentInstructions ? [
+      `Delegation instructions:`,
+      task.subagentInstructions
+    ] : [],
     ...extraInstructions ? [
       `Custom instructions:`,
       extraInstructions
@@ -31142,6 +31151,280 @@ function isStaticSiteTask(task, request) {
   }
   return task.filesLikelyTouched.some((filePath) => filePath === "src/app/page.tsx" || filePath === "src/app/layout.tsx" || filePath === "src/pages/index.tsx" || filePath === "index.html" || filePath === "styles.css");
 }
+function shouldDelegateTask(task) {
+  return (task.swarmDepth ?? 0) === 0 && task.type === "implementation" && ![
+    "repo-analyst",
+    "planner",
+    "reviewer",
+    "integrator",
+    "test-debugger",
+    "session-orchestrator",
+    "execution-manager"
+  ].includes(task.agentRole);
+}
+function terminalExpansionTaskIds(tasks) {
+  const referencedIds = new Set(tasks.flatMap((task) => task.dependsOn));
+  const terminalIds = tasks.filter((task) => !referencedIds.has(task.id)).map((task) => task.id);
+  return terminalIds.length > 0 ? terminalIds : tasks.map((task) => task.id);
+}
+function createDefaultDelegationPlan(task, request) {
+  if (!shouldDelegateTask(task)) {
+    return null;
+  }
+  if (task.agentRole === "frontend-specialist" || isStaticSiteTask(task, request)) {
+    return {
+      label: "auto-frontend-swarm",
+      strategy: "parallel",
+      members: [
+        {
+          id: "content-architect",
+          label: "content-architect",
+          agentRole: "frontend-specialist",
+          description: "Own information architecture, page composition, navigation, copy structure, and section flow.",
+          instructions: "Prioritize semantic layout, page structure, routes, content hierarchy, and component composition. Leave purely visual polish to the visual worker unless structure blocks it.",
+          acceptanceCriteria: [
+            "The page structure, sections, and navigation flow are clear and coherent.",
+            "Content hierarchy reflects the requested product, brand, or venue."
+          ],
+          outputs: [
+            "Structured page/content update"
+          ]
+        },
+        {
+          id: "visual-polisher",
+          label: "visual-polisher",
+          agentRole: "frontend-specialist",
+          description: "Own styling, gradients, motion, responsiveness, spacing, and visual finishing.",
+          instructions: "Focus on visual quality, gradients, motion, responsiveness, spacing, and interaction polish after inspecting the current structure. Keep edits aligned with the existing design language when present.",
+          acceptanceCriteria: [
+            "Visual styling and responsiveness are meaningfully improved.",
+            "Motion and polish remain consistent with the requested UI direction."
+          ],
+          outputs: [
+            "Visual polish update"
+          ]
+        }
+      ]
+    };
+  }
+  if (task.agentRole === "backend-specialist") {
+    return {
+      label: "auto-backend-swarm",
+      strategy: "sequential",
+      members: [
+        {
+          id: "contract-architect",
+          label: "contract-architect",
+          agentRole: "backend-specialist",
+          description: "Define the API/service surface, request-response shapes, and failure behavior.",
+          instructions: "Focus on service and API contracts, input/output shapes, handlers, and edge cases before broad implementation changes.",
+          acceptanceCriteria: [
+            "Contracts and failure cases are explicit.",
+            "The implementation path is narrowed to concrete handlers or services."
+          ],
+          outputs: [
+            "Backend contract design"
+          ]
+        },
+        {
+          id: "service-implementer",
+          label: "service-implementer",
+          agentRole: "backend-specialist",
+          description: "Implement handlers, services, and domain logic against the agreed contract.",
+          instructions: "Implement the core backend behavior against the established contract. Prefer targeted file edits and verification over broad rewrites.",
+          acceptanceCriteria: [
+            "Business logic is implemented against the contract.",
+            "The backend behavior satisfies the task acceptance criteria."
+          ],
+          outputs: [
+            "Backend implementation"
+          ]
+        }
+      ]
+    };
+  }
+  if (task.agentRole === "database-specialist") {
+    return {
+      label: "auto-database-swarm",
+      strategy: "sequential",
+      members: [
+        {
+          id: "schema-designer",
+          label: "schema-designer",
+          agentRole: "database-specialist",
+          description: "Design models, fields, relations, constraints, and persistence boundaries.",
+          instructions: "Focus on schema structure, data modeling, constraints, and identifiers. Keep the migration path safe and explicit.",
+          acceptanceCriteria: [
+            "Schema design reflects the requested domain.",
+            "Constraints and data relationships are explicit."
+          ],
+          outputs: [
+            "Schema design"
+          ]
+        },
+        {
+          id: "migration-planner",
+          label: "migration-planner",
+          agentRole: "database-specialist",
+          description: "Apply or prepare migrations and persistence wiring around the approved schema.",
+          instructions: "Translate the schema design into migrations or persistence updates. Keep destructive changes obvious and verification-friendly.",
+          acceptanceCriteria: [
+            "Persistence updates align with the intended schema.",
+            "Migration risk and verification needs are explicit."
+          ],
+          outputs: [
+            "Migration/persistence update"
+          ]
+        }
+      ]
+    };
+  }
+  if (task.agentRole === "infra-specialist") {
+    return {
+      label: "auto-infra-swarm",
+      strategy: "sequential",
+      members: [
+        {
+          id: "workspace-scaffolder",
+          label: "workspace-scaffolder",
+          agentRole: "infra-specialist",
+          description: "Set up required files, scripts, package wiring, and environment plumbing.",
+          instructions: "Focus on scaffolding, package manifests, scripts, environment wiring, and local runtime setup. Keep the workspace runnable.",
+          acceptanceCriteria: [
+            "Required scaffolding and environment wiring are in place.",
+            "The workspace can proceed into implementation or verification."
+          ],
+          outputs: [
+            "Workspace scaffolding"
+          ]
+        },
+        {
+          id: "runtime-verifier",
+          label: "runtime-verifier",
+          agentRole: "infra-specialist",
+          description: "Verify build/runtime setup and tighten any configuration or tooling gaps.",
+          instructions: "Focus on runtime, toolchain, script, and build verification after the initial setup work has landed.",
+          acceptanceCriteria: [
+            "The environment or app can be verified locally.",
+            "Tooling and configuration gaps are closed."
+          ],
+          outputs: [
+            "Runtime/config verification"
+          ]
+        }
+      ]
+    };
+  }
+  return null;
+}
+function materializeDelegatedTasks(plan, task, label, strategy, members) {
+  const existingIds = new Set(flattenPlanTasks(plan).filter((candidate) => candidate.id !== task.id).map((candidate) => candidate.id));
+  const teamMemberIds = members.map((member) => member.id);
+  const generatedTaskIds = members.map((member, index) => createUniqueTaskId2(`${task.id}-${slugify2(member.id) || `worker-${index + 1}`}`, existingIds));
+  return members.map((member, index) => {
+    const taskId = generatedTaskIds[index];
+    const dependsOn = strategy === "parallel" ? [
+      ...task.dependsOn
+    ] : index === 0 ? [
+      ...task.dependsOn
+    ] : [
+      generatedTaskIds[index - 1]
+    ];
+    return {
+      ...task,
+      id: taskId,
+      title: `${task.title} (${member.label})`,
+      description: [
+        task.description,
+        `Delegated worker: ${member.label}.`,
+        member.description
+      ].join("\n\n"),
+      agentRole: member.agentRole,
+      dependsOn,
+      acceptanceCriteria: member.acceptanceCriteria?.length ? member.acceptanceCriteria : index === members.length - 1 ? task.acceptanceCriteria : [
+        `Advance ${task.title.toLowerCase()} from the ${member.label} perspective.`,
+        "Leave concrete implementation evidence for the next worker."
+      ],
+      outputs: member.outputs?.length ? member.outputs : index === members.length - 1 ? task.outputs : [
+        `Delegated handoff from ${member.id}`
+      ],
+      filesLikelyTouched: member.filesLikelyTouched?.length ? member.filesLikelyTouched : task.filesLikelyTouched,
+      originTaskId: task.id,
+      swarmDepth: (task.swarmDepth ?? 0) + 1,
+      teamId: label,
+      teamMemberIds,
+      subagentLabel: member.label,
+      subagentInstructions: member.instructions
+    };
+  });
+}
+function appendReviewAndIntegrationTasks(plan, originalTask, expandedTasks, delegationLabel) {
+  const existingIds = new Set(flattenPlanTasks(plan).filter((candidate) => candidate.id !== originalTask.id).map((candidate) => candidate.id));
+  for (const task of expandedTasks) {
+    existingIds.add(task.id);
+  }
+  const terminalIds = terminalExpansionTaskIds(expandedTasks);
+  const reviewerId = createUniqueTaskId2(`${originalTask.id}-review`, existingIds);
+  const integratorId = createUniqueTaskId2(`${originalTask.id}-integrate`, existingIds);
+  const reviewerTask = {
+    ...originalTask,
+    id: reviewerId,
+    title: `Review ${originalTask.title.toLowerCase()}`,
+    description: `Inspect delegated worker output from ${delegationLabel} before integration and call out correctness or verification risk.`,
+    type: "verification",
+    agentRole: "reviewer",
+    dependsOn: terminalIds,
+    acceptanceCriteria: [
+      "Inspect the delegated changes for regressions or missing coverage.",
+      "Confirm whether the worker output is ready for integration."
+    ],
+    outputs: [
+      "Review summary"
+    ],
+    originTaskId: originalTask.id,
+    swarmDepth: (originalTask.swarmDepth ?? 0) + 1,
+    teamId: delegationLabel,
+    teamMemberIds: [
+      ...originalTask.teamMemberIds ?? [],
+      "reviewer"
+    ],
+    subagentLabel: "reviewer",
+    subagentInstructions: "Inspect the delegated changes, diff, and verification evidence. Surface concrete risks before integration."
+  };
+  const integratorTask = {
+    ...originalTask,
+    id: integratorId,
+    title: `Integrate ${originalTask.title.toLowerCase()}`,
+    description: `Finalize and integrate delegated worker output after reviewer sign-off for ${delegationLabel}.`,
+    type: "integration",
+    agentRole: "integrator",
+    dependsOn: [
+      reviewerId
+    ],
+    acceptanceCriteria: originalTask.acceptanceCriteria,
+    outputs: mergeUnique([
+      ...originalTask.outputs,
+      "Integrated change set"
+    ]),
+    originTaskId: originalTask.id,
+    swarmDepth: (originalTask.swarmDepth ?? 0) + 1,
+    teamId: delegationLabel,
+    teamMemberIds: [
+      ...originalTask.teamMemberIds ?? [],
+      "integrator"
+    ],
+    subagentLabel: "integrator",
+    subagentInstructions: "Finalize the accepted worker output, preserve repository consistency, and leave the workspace ready for downstream verification."
+  };
+  return {
+    tasks: [
+      ...expandedTasks,
+      reviewerTask,
+      integratorTask
+    ],
+    noteSuffix: `review tail ${reviewerId} -> integration tail ${integratorId}`
+  };
+}
 function renderToolResultSection(results) {
   return results.map((result) => {
     const lines = [
@@ -32199,15 +32482,7 @@ var ExecutionOrchestrator = class {
   }
   async maybeExpandReadyTaskGraph(sessionId, request, plan, events, emitProgress) {
     const envelope = this.buildEnvelope(request, plan, sessionId);
-    const candidate = envelope.readyTasks.find((task) => (task.swarmDepth ?? 0) === 0 && task.type === "implementation" && ![
-      "repo-analyst",
-      "planner",
-      "reviewer",
-      "integrator",
-      "test-debugger",
-      "session-orchestrator",
-      "execution-manager"
-    ].includes(task.agentRole));
+    const candidate = envelope.readyTasks.find((task) => shouldDelegateTask(task));
     if (!candidate) {
       return {
         plan
@@ -32215,47 +32490,37 @@ var ExecutionOrchestrator = class {
     }
     const matchedTeam = await selectAgentTeam(request.cwd, candidate, request);
     if (matchedTeam && matchedTeam.members.length > 1) {
-      const existingIds = new Set(flattenPlanTasks(plan).filter((task) => task.id !== candidate.id).map((task) => task.id));
-      const teamMemberIds = matchedTeam.members.map((member) => member.id);
-      const generatedTaskIds = matchedTeam.members.map((member, index) => createUniqueTaskId2(`${candidate.id}-${slugify2(member.id) || `member-${index + 1}`}`, existingIds));
-      const teamTasks = matchedTeam.members.map((member, index) => {
-        const taskId = generatedTaskIds[index];
-        const dependsOn = matchedTeam.team.strategy === "parallel" ? [
-          ...candidate.dependsOn
-        ] : index === 0 ? [
-          ...candidate.dependsOn
-        ] : [
-          generatedTaskIds[index - 1] ?? candidate.dependsOn[0] ?? ""
-        ].filter((value) => value.length > 0);
-        return {
-          ...candidate,
-          id: taskId,
-          title: `${candidate.title} (${member.label})`,
-          description: [
-            candidate.description,
-            `Assigned team member: ${member.label} (${member.id}).`,
-            member.purpose ? `Purpose: ${member.purpose}` : "",
-            matchedTeam.team.description ? `Team context: ${matchedTeam.team.description}` : ""
-          ].filter((part) => part.length > 0).join("\n\n"),
-          agentRole: member.baseRole,
-          dependsOn,
-          acceptanceCriteria: index === matchedTeam.members.length - 1 ? candidate.acceptanceCriteria : [
-            `Advance ${candidate.title.toLowerCase()} from the ${member.label} perspective.`,
-            "Leave clear handoff notes and concrete changed-file intent for the next team member."
-          ],
-          outputs: index === matchedTeam.members.length - 1 ? candidate.outputs : [
-            `Team handoff from ${member.id}`
-          ],
-          originTaskId: candidate.id,
-          swarmDepth: (candidate.swarmDepth ?? 0) + 1,
-          customAgentId: member.id,
-          teamId: matchedTeam.team.id,
-          teamMemberIds
-        };
-      });
-      const note = `Agent team ${matchedTeam.team.label} expanded ${candidate.id} into ${teamTasks.length} ${matchedTeam.team.strategy} subtasks: ${teamTasks.map((task) => task.id).join(", ")}.`;
+      const teamTasks = materializeDelegatedTasks(plan, candidate, matchedTeam.team.id, matchedTeam.team.strategy, matchedTeam.members.map((member) => ({
+        id: member.id,
+        label: member.label,
+        agentRole: member.baseRole,
+        description: [
+          `Assigned team member: ${member.label} (${member.id}).`,
+          member.purpose ? `Purpose: ${member.purpose}` : "",
+          matchedTeam.team.description ? `Team context: ${matchedTeam.team.description}` : ""
+        ].filter((part) => part.length > 0).join("\n\n"),
+        instructions: member.instructions
+      }))).map((task) => ({
+        ...task,
+        customAgentId: task.customAgentId ?? task.subagentLabel ? matchedTeam.members.find((member) => member.label === task.subagentLabel)?.id : void 0,
+        teamId: matchedTeam.team.id,
+        teamMemberIds: matchedTeam.members.map((member) => member.id)
+      }));
+      const augmented = appendReviewAndIntegrationTasks(plan, candidate, teamTasks, matchedTeam.team.label);
+      const note = `Agent team ${matchedTeam.team.label} expanded ${candidate.id} into ${teamTasks.length} worker subtasks with reviewer/integrator follow-through: ${augmented.tasks.map((task) => task.id).join(", ")}.`;
+      return {
+        plan: integratePlanTaskExpansion(plan, candidate.id, augmented.tasks, note),
+        note,
+        expandedTaskId: candidate.id
+      };
+    }
+    const defaultDelegation = createDefaultDelegationPlan(candidate, request);
+    if (defaultDelegation && defaultDelegation.members.length > 1) {
+      const delegatedTasks = materializeDelegatedTasks(plan, candidate, defaultDelegation.label, defaultDelegation.strategy, defaultDelegation.members);
+      const augmented = appendReviewAndIntegrationTasks(plan, candidate, delegatedTasks, defaultDelegation.label);
+      const note = `Execution manager delegated ${candidate.id} into ${delegatedTasks.length} subagents plus reviewer/integrator: ${augmented.tasks.map((task) => task.id).join(", ")}.`;
       return {
-        plan: integratePlanTaskExpansion(plan, candidate.id, teamTasks, note),
+        plan: integratePlanTaskExpansion(plan, candidate.id, augmented.tasks, note),
         note,
         expandedTaskId: candidate.id
       };
@@ -32317,12 +32582,14 @@ var ExecutionOrchestrator = class {
           plan
         };
       }
+      const expandedTasks = flattenPlanTasks(result.plan).filter((task) => result.createdTaskIds.includes(task.id));
+      const augmented = appendReviewAndIntegrationTasks(plan, candidate, expandedTasks, "planner-swarm");
       const noteParts = [
-        result.note,
+        result.note ? `${result.note} | Added reviewer/integrator pass: ${augmented.noteSuffix}.` : `Added reviewer/integrator pass: ${augmented.noteSuffix}.`,
         result.warning && result.source !== "model" ? `expander note: ${result.warning}` : ""
       ].filter(Boolean);
       return {
-        plan: result.plan,
+        plan: integratePlanTaskExpansion(plan, candidate.id, augmented.tasks, noteParts.join(" | ")),
         ...noteParts.length > 0 ? {
           note: noteParts.join(" | ")
         } : {},
@@ -32877,7 +33144,15 @@ async function generateProjectInitFile(cwd, outputFileName = "kimbho_init.md") {
   return {
     outputPath,
     indexArtifactPath: artifactPath,
-    summary: `Generated ${outputFileName} with indexed project context for ${import_node_path15.default.basename(cwd)}.`
+    summary: `Generated ${outputFileName} with indexed project context for ${import_node_path15.default.basename(cwd)}.`,
+    purpose,
+    frameworks,
+    entrypoints,
+    verificationCommands,
+    indexedFiles: index.summary.totalFiles,
+    sourceFiles: index.summary.sourceFiles,
+    routes: index.summary.routes,
+    schemas: index.summary.schemas
   };
 }
 
@@ -32934,7 +33209,15 @@ async function refreshMemoryFiles(cwd) {
     initFilePath: init.outputPath,
     projectMemoryPath,
     userMemoryPath,
-    summary: `Refreshed project bootstrap and memory files for ${import_node_path16.default.basename(cwd)}.`
+    summary: `Refreshed project bootstrap and memory files for ${import_node_path16.default.basename(cwd)}.`,
+    purpose: init.purpose,
+    frameworks: init.frameworks,
+    entrypoints: init.entrypoints,
+    verificationCommands: init.verificationCommands,
+    indexedFiles: init.indexedFiles,
+    sourceFiles: init.sourceFiles,
+    routes: init.routes,
+    schemas: init.schemas
   };
 }
 async function appendMemoryNote(cwd, scope, text, agentId) {
@@ -33076,6 +33359,22 @@ function createDoctorCommand() {
 
 // src/commands/init.ts
 var import_node_process7 = __toESM(require("node:process"), 1);
+function printProjectUnderstanding(result) {
+  console.log(result.summary);
+  console.log("Now I have a durable understanding of the current project structure.");
+  console.log(`Purpose: ${result.purpose}`);
+  console.log(`Indexed: ${result.indexedFiles} files (${result.sourceFiles} source files), ${result.routes} routes, ${result.schemas} schemas`);
+  console.log(`Frameworks: ${result.frameworks.length > 0 ? result.frameworks.join(", ") : "unknown"}`);
+  if (result.entrypoints.length > 0) {
+    console.log(`Entrypoints: ${result.entrypoints.slice(0, 5).join(", ")}`);
+  }
+  if (result.verificationCommands.length > 0) {
+    console.log(`Verification: ${result.verificationCommands.join(" -> ")}`);
+  }
+  console.log(`Wrote ${result.initFilePath}`);
+  console.log(`Wrote ${result.projectMemoryPath}`);
+  console.log(`Wrote ${result.userMemoryPath}`);
+}
 function createInitCommand() {
   return new Command("init").description("Create or refresh local Kimbho config and project bootstrap memory.").option("--template <template>", "Provider template to use for the initial provider").option("--provider-id <id>", "Identifier for the initial provider").option("--driver <driver>", "Provider driver to use when no template is supplied").option("--label <label>", "Human-readable provider label").option("--model <model>", "Default model to use for planner/coder/reviewer brains").option("--fast-model <model>", "Model to use for the fast utility brain").option("--api-key-env <env>", "Environment variable that stores the provider API key").option("--base-url <url>", "Base URL or endpoint for the provider driver").option("--module-path <path>", "Module path for a custom provider driver").option("--config-only", "Only write .kimbho/config.json and skip project memory generation", false).option("--memory-only", "Only generate kimbho_init.md and keep the existing config untouched", false).option("--memory-file <file>", "Project memory file to write", "kimbho_init.md").option("--force", "Overwrite an existing config file", false).action(async (options) => {
     const existing = await loadConfig(import_node_process7.default.cwd());
@@ -33141,10 +33440,7 @@ function createInitCommand() {
     }
     if (!options.configOnly) {
       const result = await refreshMemoryFiles(import_node_process7.default.cwd());
-      console.log(result.summary);
-      console.log(`Wrote ${result.initFilePath}`);
-      console.log(`Wrote ${result.projectMemoryPath}`);
-      console.log(`Wrote ${result.userMemoryPath}`);
+      printProjectUnderstanding(result);
     }
   });
 }
@@ -34889,6 +35185,9 @@ var PLAN_PREFIXES = [
   "outline ",
   "propose "
 ];
+function looksLikeExecutionRequest(input) {
+  return /\b(build|create|make|scaffold|implement|fix|refactor|setup|set up|generate|add|change|update|edit|rewrite|restyle|redesign|improve|enhance)\b/.test(input);
+}
 function color(code, value) {
   return `${code}${value}${RESET}`;
 }
@@ -35282,20 +35581,20 @@ function inferPromptIntent(input) {
   if (/^(hi|hello|hey|yo|sup)\b/.test(normalized)) {
     return "chat";
   }
-  if (normalized.endsWith("?")) {
-    return "chat";
-  }
   if (PLAN_PREFIXES.some((prefix) => normalized.startsWith(prefix))) {
     return "plan";
   }
   if (EXECUTION_PREFIXES.some((prefix) => normalized.startsWith(prefix))) {
     return "run";
   }
-  if (CHAT_PREFIXES.some((prefix) => normalized.startsWith(prefix))) {
+  if (looksLikeExecutionRequest(normalized)) {
+    return "run";
+  }
+  if (normalized.endsWith("?")) {
     return "chat";
   }
-  if (/\b(build|create|make|scaffold|implement|fix|refactor|setup|set up|generate)\b/.test(normalized)) {
-    return "run";
+  if (CHAT_PREFIXES.some((prefix) => normalized.startsWith(prefix))) {
+    return "chat";
   }
   return normalized.split(/\s+/).length >= 4 ? "plan" : "chat";
 }
@@ -36377,6 +36676,16 @@ async function handleMemoryCommand(cwd, tokens) {
   if (subcommand === "refresh") {
     const result = await refreshMemoryFiles(cwd);
     console.log(result.summary);
+    console.log("Now I have a durable understanding of the current project structure.");
+    console.log(`Purpose: ${result.purpose}`);
+    console.log(`Indexed: ${result.indexedFiles} files (${result.sourceFiles} source files), ${result.routes} routes, ${result.schemas} schemas`);
+    console.log(`Frameworks: ${result.frameworks.length > 0 ? result.frameworks.join(", ") : "unknown"}`);
+    if (result.entrypoints.length > 0) {
+      console.log(`Entrypoints: ${result.entrypoints.slice(0, 5).join(", ")}`);
+    }
+    if (result.verificationCommands.length > 0) {
+      console.log(`Verification: ${result.verificationCommands.join(" -> ")}`);
+    }
     console.log(`Wrote ${result.initFilePath}`);
     console.log(`Wrote ${result.projectMemoryPath}`);
     console.log(`Wrote ${result.userMemoryPath}`);