@maintainer-pro/ai-cli 0.1.3 → 0.1.4

package/README.md

@@ -58,6 +58,5 @@ Chat history is stored in Maintainer Pro admin. Do not put API keys in the brows
 |---------|------|
 | [`@maintainer-pro/ai-server`](https://www.npmjs.com/package/@maintainer-pro/ai-server) | Local Node chat server (sidecar) that uses this SDK |
 | [`@maintainer-pro/ai-ui`](https://www.npmjs.com/package/@maintainer-pro/ai-ui) | Embed widget (`ai-ui.iife.js`) — sidecar in dev, static file in prod |
-| [`@maintainer-pro/setup`](https://www.npmjs.com/package/@maintainer-pro/setup) | Download the sandbox setup guide |
 
 Optional SQL persistence lives on `@maintainer-pro/ai-cli/db` (install `better-sqlite3`, `postgres`, or `mysql2`).

package/dist/index.cjs

@@ -49,6 +49,7 @@ __export(index_exports, {
   createToolValidator: () => createToolValidator,
   formatClientContext: () => formatClientContext,
   getProviderPreference: () => getProviderPreference,
+  inspectAndRepairWorkspace: () => inspectAndRepairWorkspace,
   parseAiResponse: () => parseAiResponse,
   providerLabel: () => providerLabel,
   resolveCliBinary: () => resolveCliBinary,
@@ -103,7 +104,7 @@ function splitMessages(messages) {
   const history = latestUserIndex > 0 ? messages.slice(0, latestUserIndex) : [];
   return { request, history };
 }
-function buildUserFacingPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext) {
+function buildUserFacingPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext, technical) {
   const { request, history } = splitMessages(messages);
   const historyBlock = history.length > 0 ? `Conversation so far:
 ${buildConversationPrompt(history)}
@@ -123,27 +124,30 @@ ${buildConversationPrompt(history)}
 ${attachmentPaths.map((p) => `- ${p}`).join("\n")}
 
 ` : "";
+  const closer = technical ? "Do the work now. Follow the requested output format exactly." : "Do the work now (or ask one short clarifying question if needed). Reply in English, non-technical and user-facing. If it's not resolving, offer a quick call.";
   return `${systemSection}${contextSection}${priorSection}${historyBlock}${attachmentsSection}Current user request:
 ${request || "(See the attached screenshot(s).)"}
 
-Do the work now (or ask one short clarifying question if needed). Reply in English, non-technical and user-facing. If it's not resolving, offer a quick call.`;
+${closer}`;
 }
-function buildCursorPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext) {
+function buildCursorPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext, technical) {
   return buildUserFacingPrompt(
     systemPrompt,
     messages,
     context,
     attachmentPaths,
-    priorConversationsContext
+    priorConversationsContext,
+    technical
   );
 }
-function buildClaudeUserPrompt(messages, context, attachmentPaths, priorConversationsContext) {
+function buildClaudeUserPrompt(messages, context, attachmentPaths, priorConversationsContext, technical) {
   return buildUserFacingPrompt(
     null,
     messages,
     context,
     attachmentPaths,
-    priorConversationsContext
+    priorConversationsContext,
+    technical
   );
 }
 
@@ -256,7 +260,8 @@ async function callClaudeCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const resolved = resolveCliCommand("claude", command);
   const workspace = options.workspaceDir ?? process.env.AI_CLI_WORKSPACE ?? process.cwd();
@@ -295,7 +300,8 @@ async function callCursorCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const resolved = resolveCliCommand("cursor", command);
   const workspace = options.workspaceDir ?? process.env.AI_CLI_WORKSPACE ?? process.cwd();
@@ -336,7 +342,8 @@ async function callAntigravityCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const prompt = `You are operating as a coding agent with full permission to read and edit files in this workspace. Do not introduce yourself. Do not ask what you are. Execute the user's latest request now (edit files and/or emit runtime tool JSON as instructed).
 
@@ -1142,6 +1149,112 @@ function createMaintainerProStoreFromEnv() {
   if (!baseUrl || !apiKey) return null;
   return createMaintainerProStore({ baseUrl, apiKey });
 }
+
+// src/workspace-inspect.ts
+var import_zod = require("zod");
+var inspectJsonSchema = import_zod.z.object({
+  kind: import_zod.z.enum(["next", "vite", "html", "empty", "other"]).optional(),
+  name: import_zod.z.string().max(200).optional(),
+  summary: import_zod.z.string().max(800).optional(),
+  scripts: import_zod.z.object({
+    ui: import_zod.z.string().min(1).max(64).optional(),
+    backend: import_zod.z.string().min(1).max(64).optional(),
+    app: import_zod.z.string().min(1).max(64).optional()
+  }).optional(),
+  ports: import_zod.z.object({
+    ui: import_zod.z.number().int().min(1).max(65535).optional(),
+    backend: import_zod.z.number().int().min(1).max(65535).optional(),
+    app: import_zod.z.number().int().min(1).max(65535).optional()
+  }).optional(),
+  issues: import_zod.z.array(import_zod.z.string().max(500)).max(20).optional(),
+  fixes: import_zod.z.array(import_zod.z.string().max(500)).max(20).optional(),
+  ready: import_zod.z.boolean().optional()
+});
+function extractInspectJson(text) {
+  const fence = text.match(/```json\s*([\s\S]*?)```/i);
+  const raw = fence?.[1]?.trim() || text.match(/\{[\s\S]*\}/)?.[0];
+  if (!raw) return null;
+  try {
+    const parsed = inspectJsonSchema.safeParse(JSON.parse(raw));
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
+function setupSystemPrompt(input) {
+  return `You are Maintainer Pro's local setup assistant on the developer's machine.
+
+Workspace: ${input.workspaceDir}
+App name: ${input.appName || "the app"}
+
+Inspect this repository (package.json, README, lockfiles, existing env files, how the UI and API start).
+You MAY edit files to fix setup problems that would block local run or the chat widget (env keys, widget mount, missing config).
+Do NOT start long-lived dev servers, tunnels, or install global tools.
+Do NOT run \`npm run dev\` or similar.
+
+Script names you report MUST already exist in package.json. Omit chat/ai-server scripts.
+
+End with a short human summary AND one \`\`\`json fence with:
+
+{
+  "kind": "next" | "vite" | "html" | "empty" | "other",
+  "name": "package or folder name",
+  "summary": "one sentence about this project",
+  "scripts": { "ui": "dev:client", "backend": "dev:server" },
+  "ports": { "ui": 5173, "backend": 4100 },
+  "issues": ["remaining problems"],
+  "fixes": ["what you changed"],
+  "ready": true
+}`;
+}
+function setupUserMessage(input) {
+  if (input.problem?.trim()) {
+    return `The local bridge failed to keep this project running:
+
+${input.problem.trim()}
+
+${input.extraContext ? `${input.extraContext.trim()}
+
+` : ""}Inspect the repo, fix the cause if you can, and return the JSON report.`;
+  }
+  return `${input.extraContext ? `${input.extraContext.trim()}
+
+` : ""}Inspect this project, fix any setup gaps you can, and return the JSON report.`;
+}
+async function inspectAndRepairWorkspace(input) {
+  const workspaceDir = input.workspaceDir;
+  const provider = await resolveProvider({ preference: "auto" });
+  const response = await callAi(
+    [{ role: "user", content: setupUserMessage(input) }],
+    {
+      route: "/local-setup",
+      pageTitle: input.appName || "Local setup",
+      relevantFiles: ["package.json", "README.md", ".env", ".env.example"],
+      data: {
+        workspaceDir,
+        problem: input.problem || null
+      }
+    },
+    {
+      systemPrompt: setupSystemPrompt(input),
+      workspaceDir,
+      technical: true
+    }
+  );
+  const parsed = extractInspectJson(response.text);
+  return {
+    kind: parsed?.kind ?? "other",
+    name: parsed?.name?.trim() || input.appName || "",
+    summary: parsed?.summary?.trim() || response.text.replace(/```json[\s\S]*```/i, "").trim().slice(0, 400),
+    scripts: parsed?.scripts ?? {},
+    ports: parsed?.ports ?? {},
+    issues: parsed?.issues ?? [],
+    fixes: parsed?.fixes ?? [],
+    ready: parsed?.ready ?? parsed?.issues?.length === 0,
+    provider: response.provider || provider.id,
+    rawText: response.text
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   WORKING_PROVIDER,
@@ -1163,6 +1276,7 @@ function createMaintainerProStoreFromEnv() {
   createToolValidator,
   formatClientContext,
   getProviderPreference,
+  inspectAndRepairWorkspace,
   parseAiResponse,
   providerLabel,
   resolveCliBinary,

package/dist/index.d.cts

@@ -56,6 +56,8 @@ interface CallAiOptions {
     priorConversationsContext?: string;
     /** Extra / override providers (e.g. future HTTP model backends). */
     providers?: AiProvider[];
+    /** When true, skip the end-user chat footer so the agent can return structured output. */
+    technical?: boolean;
 }
 interface AiProvider {
     id: string;
@@ -85,9 +87,9 @@ declare function parseAiResponse(raw: string, provider: AiCliProviderId): AiResp
 declare function buildConversationPrompt(messages: ChatMessage[]): string;
 declare function formatClientContext(context?: ClientContext): string;
 /** Full prompt for providers without a native --system-prompt flag (Cursor). */
-declare function buildCursorPrompt(systemPrompt: string, messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string): string;
+declare function buildCursorPrompt(systemPrompt: string, messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string, technical?: boolean): string;
 /** Conversation + context for Claude (system prompt passed separately). */
-declare function buildClaudeUserPrompt(messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string): string;
+declare function buildClaudeUserPrompt(messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string, technical?: boolean): string;
 
 declare function createDefaultSystemPrompt(input: {
     productDescription: string;
@@ -241,4 +243,39 @@ interface PriorConversationOptions {
  */
 declare function buildPriorConversationsContext(db: ChatStoreLike, options: PriorConversationOptions): Promise<string>;
 
-export { type AiCliProviderId, type AiProvider, type AiResponse, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, type LocalStoredMessage, type MaintainerProStoreOptions, type PriorConversationOptions, type ProviderPreference, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createLocalDirectoryStore, createMaintainerProStore, createMaintainerProStoreFromEnv, createToolValidator, formatClientContext, getProviderPreference, parseAiResponse, providerLabel, resolveCliBinary, resolveProvider, saveChatAttachments, toNextRoute };
+type WorkspaceKind = "next" | "vite" | "html" | "empty" | "other";
+interface WorkspaceInspectInput {
+    workspaceDir: string;
+    appName?: string;
+    /** When set, the agent diagnoses and tries to fix this failure. */
+    problem?: string;
+    extraContext?: string;
+}
+interface WorkspaceInspectResult {
+    kind: WorkspaceKind;
+    name: string;
+    summary: string;
+    scripts: {
+        ui?: string;
+        backend?: string;
+        app?: string;
+    };
+    ports: {
+        ui?: number;
+        backend?: number;
+        app?: number;
+    };
+    issues: string[];
+    fixes: string[];
+    ready: boolean;
+    provider: string;
+    rawText: string;
+}
+/**
+ * Ask the coding-agent CLI (via callAi) to inspect a workspace and optionally
+ * repair setup issues. Used by ai-bridge so host-process planning uses the
+ * same provider resolution as chat.
+ */
+declare function inspectAndRepairWorkspace(input: WorkspaceInspectInput): Promise<WorkspaceInspectResult>;
+
+export { type AiCliProviderId, type AiProvider, type AiResponse, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, type LocalStoredMessage, type MaintainerProStoreOptions, type PriorConversationOptions, type ProviderPreference, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createLocalDirectoryStore, createMaintainerProStore, createMaintainerProStoreFromEnv, createToolValidator, formatClientContext, getProviderPreference, inspectAndRepairWorkspace, parseAiResponse, providerLabel, resolveCliBinary, resolveProvider, saveChatAttachments, toNextRoute };

package/dist/index.d.ts

@@ -56,6 +56,8 @@ interface CallAiOptions {
     priorConversationsContext?: string;
     /** Extra / override providers (e.g. future HTTP model backends). */
     providers?: AiProvider[];
+    /** When true, skip the end-user chat footer so the agent can return structured output. */
+    technical?: boolean;
 }
 interface AiProvider {
     id: string;
@@ -85,9 +87,9 @@ declare function parseAiResponse(raw: string, provider: AiCliProviderId): AiResp
 declare function buildConversationPrompt(messages: ChatMessage[]): string;
 declare function formatClientContext(context?: ClientContext): string;
 /** Full prompt for providers without a native --system-prompt flag (Cursor). */
-declare function buildCursorPrompt(systemPrompt: string, messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string): string;
+declare function buildCursorPrompt(systemPrompt: string, messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string, technical?: boolean): string;
 /** Conversation + context for Claude (system prompt passed separately). */
-declare function buildClaudeUserPrompt(messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string): string;
+declare function buildClaudeUserPrompt(messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string, technical?: boolean): string;
 
 declare function createDefaultSystemPrompt(input: {
     productDescription: string;
@@ -241,4 +243,39 @@ interface PriorConversationOptions {
  */
 declare function buildPriorConversationsContext(db: ChatStoreLike, options: PriorConversationOptions): Promise<string>;
 
-export { type AiCliProviderId, type AiProvider, type AiResponse, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, type LocalStoredMessage, type MaintainerProStoreOptions, type PriorConversationOptions, type ProviderPreference, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createLocalDirectoryStore, createMaintainerProStore, createMaintainerProStoreFromEnv, createToolValidator, formatClientContext, getProviderPreference, parseAiResponse, providerLabel, resolveCliBinary, resolveProvider, saveChatAttachments, toNextRoute };
+type WorkspaceKind = "next" | "vite" | "html" | "empty" | "other";
+interface WorkspaceInspectInput {
+    workspaceDir: string;
+    appName?: string;
+    /** When set, the agent diagnoses and tries to fix this failure. */
+    problem?: string;
+    extraContext?: string;
+}
+interface WorkspaceInspectResult {
+    kind: WorkspaceKind;
+    name: string;
+    summary: string;
+    scripts: {
+        ui?: string;
+        backend?: string;
+        app?: string;
+    };
+    ports: {
+        ui?: number;
+        backend?: number;
+        app?: number;
+    };
+    issues: string[];
+    fixes: string[];
+    ready: boolean;
+    provider: string;
+    rawText: string;
+}
+/**
+ * Ask the coding-agent CLI (via callAi) to inspect a workspace and optionally
+ * repair setup issues. Used by ai-bridge so host-process planning uses the
+ * same provider resolution as chat.
+ */
+declare function inspectAndRepairWorkspace(input: WorkspaceInspectInput): Promise<WorkspaceInspectResult>;
+
+export { type AiCliProviderId, type AiProvider, type AiResponse, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, type LocalStoredMessage, type MaintainerProStoreOptions, type PriorConversationOptions, type ProviderPreference, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createLocalDirectoryStore, createMaintainerProStore, createMaintainerProStoreFromEnv, createToolValidator, formatClientContext, getProviderPreference, inspectAndRepairWorkspace, parseAiResponse, providerLabel, resolveCliBinary, resolveProvider, saveChatAttachments, toNextRoute };

package/dist/index.js

@@ -43,7 +43,7 @@ function splitMessages(messages) {
   const history = latestUserIndex > 0 ? messages.slice(0, latestUserIndex) : [];
   return { request, history };
 }
-function buildUserFacingPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext) {
+function buildUserFacingPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext, technical) {
   const { request, history } = splitMessages(messages);
   const historyBlock = history.length > 0 ? `Conversation so far:
 ${buildConversationPrompt(history)}
@@ -63,27 +63,30 @@ ${buildConversationPrompt(history)}
 ${attachmentPaths.map((p) => `- ${p}`).join("\n")}
 
 ` : "";
+  const closer = technical ? "Do the work now. Follow the requested output format exactly." : "Do the work now (or ask one short clarifying question if needed). Reply in English, non-technical and user-facing. If it's not resolving, offer a quick call.";
   return `${systemSection}${contextSection}${priorSection}${historyBlock}${attachmentsSection}Current user request:
 ${request || "(See the attached screenshot(s).)"}
 
-Do the work now (or ask one short clarifying question if needed). Reply in English, non-technical and user-facing. If it's not resolving, offer a quick call.`;
+${closer}`;
 }
-function buildCursorPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext) {
+function buildCursorPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext, technical) {
   return buildUserFacingPrompt(
     systemPrompt,
     messages,
     context,
     attachmentPaths,
-    priorConversationsContext
+    priorConversationsContext,
+    technical
   );
 }
-function buildClaudeUserPrompt(messages, context, attachmentPaths, priorConversationsContext) {
+function buildClaudeUserPrompt(messages, context, attachmentPaths, priorConversationsContext, technical) {
   return buildUserFacingPrompt(
     null,
     messages,
     context,
     attachmentPaths,
-    priorConversationsContext
+    priorConversationsContext,
+    technical
   );
 }
 
@@ -196,7 +199,8 @@ async function callClaudeCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const resolved = resolveCliCommand("claude", command);
   const workspace = options.workspaceDir ?? process.env.AI_CLI_WORKSPACE ?? process.cwd();
@@ -235,7 +239,8 @@ async function callCursorCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const resolved = resolveCliCommand("cursor", command);
   const workspace = options.workspaceDir ?? process.env.AI_CLI_WORKSPACE ?? process.cwd();
@@ -276,7 +281,8 @@ async function callAntigravityCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const prompt = `You are operating as a coding agent with full permission to read and edit files in this workspace. Do not introduce yourself. Do not ask what you are. Execute the user's latest request now (edit files and/or emit runtime tool JSON as instructed).
 
@@ -1082,6 +1088,112 @@ function createMaintainerProStoreFromEnv() {
   if (!baseUrl || !apiKey) return null;
   return createMaintainerProStore({ baseUrl, apiKey });
 }
+
+// src/workspace-inspect.ts
+import { z } from "zod";
+var inspectJsonSchema = z.object({
+  kind: z.enum(["next", "vite", "html", "empty", "other"]).optional(),
+  name: z.string().max(200).optional(),
+  summary: z.string().max(800).optional(),
+  scripts: z.object({
+    ui: z.string().min(1).max(64).optional(),
+    backend: z.string().min(1).max(64).optional(),
+    app: z.string().min(1).max(64).optional()
+  }).optional(),
+  ports: z.object({
+    ui: z.number().int().min(1).max(65535).optional(),
+    backend: z.number().int().min(1).max(65535).optional(),
+    app: z.number().int().min(1).max(65535).optional()
+  }).optional(),
+  issues: z.array(z.string().max(500)).max(20).optional(),
+  fixes: z.array(z.string().max(500)).max(20).optional(),
+  ready: z.boolean().optional()
+});
+function extractInspectJson(text) {
+  const fence = text.match(/```json\s*([\s\S]*?)```/i);
+  const raw = fence?.[1]?.trim() || text.match(/\{[\s\S]*\}/)?.[0];
+  if (!raw) return null;
+  try {
+    const parsed = inspectJsonSchema.safeParse(JSON.parse(raw));
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
+function setupSystemPrompt(input) {
+  return `You are Maintainer Pro's local setup assistant on the developer's machine.
+
+Workspace: ${input.workspaceDir}
+App name: ${input.appName || "the app"}
+
+Inspect this repository (package.json, README, lockfiles, existing env files, how the UI and API start).
+You MAY edit files to fix setup problems that would block local run or the chat widget (env keys, widget mount, missing config).
+Do NOT start long-lived dev servers, tunnels, or install global tools.
+Do NOT run \`npm run dev\` or similar.
+
+Script names you report MUST already exist in package.json. Omit chat/ai-server scripts.
+
+End with a short human summary AND one \`\`\`json fence with:
+
+{
+  "kind": "next" | "vite" | "html" | "empty" | "other",
+  "name": "package or folder name",
+  "summary": "one sentence about this project",
+  "scripts": { "ui": "dev:client", "backend": "dev:server" },
+  "ports": { "ui": 5173, "backend": 4100 },
+  "issues": ["remaining problems"],
+  "fixes": ["what you changed"],
+  "ready": true
+}`;
+}
+function setupUserMessage(input) {
+  if (input.problem?.trim()) {
+    return `The local bridge failed to keep this project running:
+
+${input.problem.trim()}
+
+${input.extraContext ? `${input.extraContext.trim()}
+
+` : ""}Inspect the repo, fix the cause if you can, and return the JSON report.`;
+  }
+  return `${input.extraContext ? `${input.extraContext.trim()}
+
+` : ""}Inspect this project, fix any setup gaps you can, and return the JSON report.`;
+}
+async function inspectAndRepairWorkspace(input) {
+  const workspaceDir = input.workspaceDir;
+  const provider = await resolveProvider({ preference: "auto" });
+  const response = await callAi(
+    [{ role: "user", content: setupUserMessage(input) }],
+    {
+      route: "/local-setup",
+      pageTitle: input.appName || "Local setup",
+      relevantFiles: ["package.json", "README.md", ".env", ".env.example"],
+      data: {
+        workspaceDir,
+        problem: input.problem || null
+      }
+    },
+    {
+      systemPrompt: setupSystemPrompt(input),
+      workspaceDir,
+      technical: true
+    }
+  );
+  const parsed = extractInspectJson(response.text);
+  return {
+    kind: parsed?.kind ?? "other",
+    name: parsed?.name?.trim() || input.appName || "",
+    summary: parsed?.summary?.trim() || response.text.replace(/```json[\s\S]*```/i, "").trim().slice(0, 400),
+    scripts: parsed?.scripts ?? {},
+    ports: parsed?.ports ?? {},
+    issues: parsed?.issues ?? [],
+    fixes: parsed?.fixes ?? [],
+    ready: parsed?.ready ?? parsed?.issues?.length === 0,
+    provider: response.provider || provider.id,
+    rawText: response.text
+  };
+}
 export {
   WORKING_PROVIDER,
   buildClaudeUserPrompt,
@@ -1102,6 +1214,7 @@ export {
   createToolValidator,
   formatClientContext,
   getProviderPreference,
+  inspectAndRepairWorkspace,
   parseAiResponse,
   providerLabel,
   resolveCliBinary,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maintainer-pro/ai-cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Maintainer Pro server SDK: Claude/Cursor CLI, chat HTTP handlers, and optional SQL persistence",
   "keywords": [
     "maintainer-pro",