@praneeth_54/agentdoctor 3.0.2 → 3.0.3

package/dist/cli/ask-progress.js

@@ -0,0 +1,85 @@
+import { colors, symbolFail, symbolOk } from "../utils/colors.js";
+const STAGE_LABELS = {
+    understand: "Understanding question",
+    search: "Searching project knowledge",
+    retrieve: "Retrieving relevant evidence",
+    verify: "Verifying evidence",
+    prepare: "Preparing answer",
+};
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+/**
+ * Human-readable ask progress. Stages must be driven by real operations.
+ * Animation uses setInterval only for frame updates while work is in flight —
+ * never to invent delay.
+ */
+export function createAskProgress(options = {}) {
+    const enabled = options.enabled !== false;
+    const stream = options.stream ?? process.stderr;
+    const tty = options.isTTY ??
+        Boolean(stream && typeof stream === "object" && "isTTY" in stream && stream.isTTY);
+    let frame = 0;
+    let timer;
+    let activeLabel;
+    let stopped = false;
+    const clearLine = () => {
+        if (!tty || !enabled)
+            return;
+        stream.write("\r\x1b[K");
+    };
+    const stopSpin = () => {
+        if (timer) {
+            clearInterval(timer);
+            timer = undefined;
+        }
+        clearLine();
+    };
+    const renderSpin = () => {
+        if (!tty || !enabled || !activeLabel || stopped)
+            return;
+        const glyph = SPINNER_FRAMES[frame % SPINNER_FRAMES.length];
+        frame += 1;
+        stream.write(`\r${colors.cyan(glyph)} ${activeLabel}...`);
+    };
+    const writeDone = (ok, label, detail) => {
+        if (!enabled || stopped)
+            return;
+        const mark = ok ? symbolOk() : symbolFail();
+        const suffix = detail ? colors.dim(` — ${detail}`) : "";
+        stream.write(`${mark} ${label}${suffix}\n`);
+    };
+    return {
+        stage(id, state, detail) {
+            if (!enabled || stopped)
+                return;
+            const label = STAGE_LABELS[id];
+            if (state === "start") {
+                stopSpin();
+                activeLabel = label;
+                if (tty) {
+                    frame = 0;
+                    renderSpin();
+                    timer = setInterval(renderSpin, 80);
+                    timer.unref?.();
+                }
+                else {
+                    stream.write(`${label}...\n`);
+                }
+                return;
+            }
+            stopSpin();
+            activeLabel = undefined;
+            writeDone(state === "ok", state === "ok" && id === "prepare" ? "Answer ready" : label, detail);
+        },
+        stop() {
+            stopSpin();
+            activeLabel = undefined;
+            stopped = true;
+        },
+    };
+}
+export function silentAskProgress() {
+    return {
+        stage() { },
+        stop() { },
+    };
+}

package/dist/cli/commands/chat.d.ts

@@ -5,6 +5,12 @@ export declare function runAskCommand(options: {
     json?: boolean;
     /** Test-only: force mock provider */
     useMock?: boolean;
+    /** Test override: force progress enabled/disabled */
+    progressEnabled?: boolean;
+    /** Test override: progress stream */
+    progressStream?: NodeJS.WritableStream;
+    /** Test override: treat progress stream as TTY */
+    progressIsTTY?: boolean;
 }): Promise<ExitCode>;
 export declare function runChatCommand(options: {
     root?: string;

package/dist/cli/commands/chat.js

@@ -5,6 +5,7 @@ import { MockModelProvider, createModelProvider, loadAiConfig } from "../../ai/i
 import { EXIT_CODES } from "../../types/index.js";
 import { resolveCliProjectRoot } from "../safe-root.js";
 import { colors } from "../../utils/colors.js";
+import { createAskProgress } from "../ask-progress.js";
 function printBanner(options) {
     const lines = [
         "",
@@ -58,13 +59,21 @@ export async function runAskCommand(options) {
     }
     const root = gated.root;
     const provider = options.useMock ? new MockModelProvider() : createModelProvider(loadAiConfig());
+    const progressEnabled = options.progressEnabled ?? !options.json;
+    const progress = createAskProgress({
+        enabled: progressEnabled,
+        ...(options.progressStream ? { stream: options.progressStream } : {}),
+        ...(options.progressIsTTY !== undefined ? { isTTY: options.progressIsTTY } : {}),
+    });
     const chat = new ChatService({
         root,
         provider,
         persistAudit: !options.useMock,
+        progress,
     });
     try {
         const response = await chat.ask(options.question);
+        progress.stop();
         if (options.json) {
             process.stdout.write(`${JSON.stringify(response, null, 2)}\n`);
         }
@@ -78,7 +87,14 @@ export async function runAskCommand(options) {
         }
         return EXIT_CODES.SUCCESS;
     }
+    catch (error) {
+        progress.stop();
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`AgentDoctor error:\n${message}`);
+        return EXIT_CODES.INTERNAL_ERROR;
+    }
     finally {
+        progress.stop();
         await chat.end();
     }
 }

package/dist/cli/program.js

@@ -1255,7 +1255,8 @@ export function createProgram() {
         .argument("<question>", "Question about the project")
         .argument("[path]", "Repository path (default: current directory)")
         .option("--json", "Emit JSON response", false)
-        .action(async (question, pathArg, options) => {
+        .action(async (question, pathArg, _options, command) => {
+        const options = command.optsWithGlobals();
         process.exitCode = await runAskCommand({
             question,
             root: resolveTargetArgument(pathArg),

package/dist/constants.d.ts

@@ -1,5 +1,5 @@
 import type { AgentId } from "./types/index.js";
-export declare const PACKAGE_VERSION = "3.0.2";
+export declare const PACKAGE_VERSION = "3.0.3";
 export declare const DEFAULT_MAX_FILE_SIZE_BYTES: number;
 /** Directories skipped during normal discovery (unless a rule needs them later). */
 export declare const DEFAULT_IGNORE_DIRECTORIES: Set<string>;

package/dist/constants.js

@@ -1,4 +1,4 @@
-export const PACKAGE_VERSION = "3.0.2";
+export const PACKAGE_VERSION = "3.0.3";
 export const DEFAULT_MAX_FILE_SIZE_BYTES = 2 * 1024 * 1024; // 2 MiB
 /** Directories skipped during normal discovery (unless a rule needs them later). */
 export const DEFAULT_IGNORE_DIRECTORIES = new Set([

package/dist/core/understanding/brain/storage/store.js

@@ -128,7 +128,6 @@ export class LocalBrainStore {
         await fs.mkdir(path.join(this.root, "deltas"), { recursive: true });
     }
     async readMeta() {
-        await this.ensureRoot();
         try {
             const raw = await fs.readFile(this.metaPath(), "utf8");
             const parsed = JSON.parse(raw);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praneeth_54/agentdoctor",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "Engineering assurance for AI coding agents — repository intelligence, change evidence, safety controls, and MCP tools.",
   "type": "module",
   "bin": {