@autonav/core 1.4.0 → 1.6.0

package/dist/memento/state.js

@@ -0,0 +1,156 @@
+/**
+ * Memento State Management
+ *
+ * File-based state persistence for the memento loop.
+ * Uses atomic writes to prevent corruption from crashes.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { randomUUID } from "node:crypto";
+const STATE_DIR = ".autonav";
+const STATE_FILE = "memento-state.json";
+const STATE_VERSION = "1.0.0";
+/**
+ * Get the path to the state file for a code directory
+ */
+export function getStatePath(codeDirectory) {
+    return path.join(codeDirectory, STATE_DIR, STATE_FILE);
+}
+/**
+ * Check if a memento state file exists
+ */
+export function stateExists(codeDirectory) {
+    return fs.existsSync(getStatePath(codeDirectory));
+}
+/**
+ * Load existing state from disk
+ *
+ * @throws {Error} If state file doesn't exist or is invalid
+ */
+export function loadState(codeDirectory) {
+    const statePath = getStatePath(codeDirectory);
+    if (!fs.existsSync(statePath)) {
+        throw new Error(`No memento state found at ${statePath}. Use --resume=false to start a new run.`);
+    }
+    const content = fs.readFileSync(statePath, "utf-8");
+    const state = JSON.parse(content);
+    // Validate version
+    if (state.version !== STATE_VERSION) {
+        throw new Error(`State version mismatch: found ${state.version}, expected ${STATE_VERSION}. ` +
+            `Manual migration may be required.`);
+    }
+    return state;
+}
+/**
+ * Save state to disk atomically
+ *
+ * Uses temp file + rename pattern to prevent corruption
+ */
+export function saveState(state) {
+    const statePath = getStatePath(state.codeDirectory);
+    const stateDir = path.dirname(statePath);
+    const tempPath = path.join(stateDir, `.memento-state-${Date.now()}.tmp`);
+    // Ensure .autonav directory exists
+    if (!fs.existsSync(stateDir)) {
+        fs.mkdirSync(stateDir, { recursive: true });
+    }
+    // Update timestamp
+    state.lastUpdated = new Date().toISOString();
+    // Write to temp file, then rename atomically
+    fs.writeFileSync(tempPath, JSON.stringify(state, null, 2));
+    fs.renameSync(tempPath, statePath);
+}
+/**
+ * Initialize a new memento state
+ */
+export function initializeState(codeDirectory, navDirectory, task, options) {
+    const state = {
+        version: STATE_VERSION,
+        runId: randomUUID(),
+        codeDirectory: path.resolve(codeDirectory),
+        navDirectory: path.resolve(navDirectory),
+        task,
+        branch: options.branch,
+        iteration: 0,
+        maxIterations: options.maxIterations,
+        promise: options.promise,
+        completed: false,
+        lastUpdated: new Date().toISOString(),
+        iterationTimestamps: [],
+        planHistory: [],
+    };
+    saveState(state);
+    return state;
+}
+/**
+ * Increment iteration counter and record timestamp
+ */
+export function incrementIteration(state) {
+    state.iteration += 1;
+    state.iterationTimestamps.push(new Date().toISOString());
+    saveState(state);
+    return state;
+}
+/**
+ * Record a plan in history
+ */
+export function recordPlan(state, summary) {
+    state.planHistory.push({
+        iteration: state.iteration,
+        summary,
+        timestamp: new Date().toISOString(),
+    });
+    saveState(state);
+    return state;
+}
+/**
+ * Mark the loop as completed
+ */
+export function completeLoop(state, completionMessage) {
+    state.completed = true;
+    state.completionMessage = completionMessage;
+    saveState(state);
+    return state;
+}
+/**
+ * Check if the loop should continue
+ */
+export function shouldContinue(state) {
+    if (state.completed) {
+        return false;
+    }
+    if (state.maxIterations > 0 && state.iteration >= state.maxIterations) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Delete state file (cleanup after successful completion)
+ */
+export function deleteState(codeDirectory) {
+    const statePath = getStatePath(codeDirectory);
+    if (fs.existsSync(statePath)) {
+        fs.unlinkSync(statePath);
+    }
+}
+/**
+ * Get or initialize state based on options
+ */
+export function getOrInitializeState(codeDirectory, navDirectory, task, options) {
+    if (options.resume && stateExists(codeDirectory)) {
+        const state = loadState(codeDirectory);
+        // Validate that the resumed state matches current parameters
+        if (state.navDirectory !== path.resolve(navDirectory)) {
+            throw new Error(`Navigator directory mismatch: state has ${state.navDirectory}, ` +
+                `but ${navDirectory} was provided. Delete state file to start fresh.`);
+        }
+        return state;
+    }
+    // If state exists but not resuming, warn and overwrite
+    if (stateExists(codeDirectory) && !options.resume) {
+        console.warn(`Warning: Existing state found. Starting fresh (use --resume to continue).`);
+        deleteState(codeDirectory);
+    }
+    return initializeState(codeDirectory, navDirectory, task, options);
+}
+//# sourceMappingURL=state.js.map

package/dist/memento/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/memento/state.ts"],"names":[],"mappings":"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"}

package/dist/memento/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Memento Loop Types
+ *
+ * Core type definitions for the context-clearing iterative development loop
+ * that coordinates navigator (planning) and worker (implementation) agents.
+ *
+ * Design principle: The WORKER forgets between iterations (memento pattern).
+ * The NAVIGATOR maintains its own memory. Git commits track worker progress.
+ * All types here are for in-memory use during loop execution.
+ */
+import { z } from "zod";
+/**
+ * Schema for implementation plan steps
+ */
+export declare const ImplementationStepSchema: z.ZodObject<{
+    description: z.ZodString;
+    files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    files?: string[] | undefined;
+    commands?: string[] | undefined;
+}, {
+    description: string;
+    files?: string[] | undefined;
+    commands?: string[] | undefined;
+}>;
+/**
+ * Schema for implementation plan returned by navigator
+ */
+export declare const ImplementationPlanSchema: z.ZodObject<{
+    summary: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        files?: string[] | undefined;
+        commands?: string[] | undefined;
+    }, {
+        description: string;
+        files?: string[] | undefined;
+        commands?: string[] | undefined;
+    }>, "many">;
+    validationCriteria: z.ZodArray<z.ZodString, "many">;
+    isComplete: z.ZodBoolean;
+    completionMessage: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    steps: {
+        description: string;
+        files?: string[] | undefined;
+        commands?: string[] | undefined;
+    }[];
+    validationCriteria: string[];
+    isComplete: boolean;
+    completionMessage?: string | undefined;
+}, {
+    summary: string;
+    steps: {
+        description: string;
+        files?: string[] | undefined;
+        commands?: string[] | undefined;
+    }[];
+    validationCriteria: string[];
+    isComplete: boolean;
+    completionMessage?: string | undefined;
+}>;
+export type ImplementationStep = z.infer<typeof ImplementationStepSchema>;
+export type ImplementationPlan = z.infer<typeof ImplementationPlanSchema>;
+/**
+ * Result from worker agent execution
+ */
+export interface WorkerResult {
+    /** Whether the worker completed successfully */
+    success: boolean;
+    /** Summary of what was done */
+    summary: string;
+    /** Files that were modified */
+    filesModified: string[];
+    /** Any errors encountered */
+    errors?: string[];
+    /** Duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * Command line options for memento command
+ */
+export interface MementoOptions {
+    /** Create and push to a new PR when complete */
+    pr?: boolean;
+    /** Maximum iterations (0 = unlimited) */
+    maxIterations: number;
+    /** Completion signal text */
+    promise: string;
+    /** Git branch name for work */
+    branch?: string;
+    /** Task description (overrides TASK.md) */
+    task?: string;
+    /** Show detailed logging */
+    verbose?: boolean;
+}
+/**
+ * Final result of memento loop execution
+ */
+export interface MementoResult {
+    /** Whether the task completed successfully */
+    success: boolean;
+    /** Number of iterations performed */
+    iterations: number;
+    /** Completion message from nav */
+    completionMessage?: string;
+    /** PR URL if --pr was used */
+    prUrl?: string;
+    /** Git branch name */
+    branch?: string;
+    /** Total duration in milliseconds */
+    durationMs: number;
+    /** Any errors that occurred */
+    errors?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/memento/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memento/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,EAAE,CAAC,EAAE,OAAO,CAAC;IAEb,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IAEtB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IAEjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/memento/types.js

@@ -0,0 +1,30 @@
+/**
+ * Memento Loop Types
+ *
+ * Core type definitions for the context-clearing iterative development loop
+ * that coordinates navigator (planning) and worker (implementation) agents.
+ *
+ * Design principle: The WORKER forgets between iterations (memento pattern).
+ * The NAVIGATOR maintains its own memory. Git commits track worker progress.
+ * All types here are for in-memory use during loop execution.
+ */
+import { z } from "zod";
+/**
+ * Schema for implementation plan steps
+ */
+export const ImplementationStepSchema = z.object({
+    description: z.string().describe("What this step accomplishes"),
+    files: z.array(z.string()).optional().describe("Files to create or modify"),
+    commands: z.array(z.string()).optional().describe("Commands to run"),
+});
+/**
+ * Schema for implementation plan returned by navigator
+ */
+export const ImplementationPlanSchema = z.object({
+    summary: z.string().describe("Brief summary of what this plan will accomplish"),
+    steps: z.array(ImplementationStepSchema).describe("Ordered implementation steps"),
+    validationCriteria: z.array(z.string()).describe("How to verify the implementation worked"),
+    isComplete: z.boolean().describe("True if the overall task is complete and no more iterations needed"),
+    completionMessage: z.string().optional().describe("Message to display when isComplete is true"),
+});
+//# sourceMappingURL=types.js.map

package/dist/memento/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memento/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC3E,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;CACrE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IAC/E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACjF,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC3F,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IACtG,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAChG,CAAC,CAAC"}

package/dist/memento/worker-agent.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Worker Agent for Memento Loop
+ *
+ * Executes implementation plans using the Claude Agent SDK.
+ */
+import type { ImplementationPlan, WorkerResult } from "./types.js";
+/**
+ * Minimal context for worker (no persisted state)
+ */
+interface WorkerContext {
+    codeDirectory: string;
+    task: string;
+}
+/**
+ * Options for worker agent execution
+ */
+export interface WorkerAgentOptions {
+    /** Show detailed logging */
+    verbose?: boolean;
+    /** Model to use (defaults to claude-sonnet-4-5) */
+    model?: string;
+    /** Maximum turns for worker agent */
+    maxTurns?: number;
+}
+/**
+ * Run the worker agent to implement a plan
+ */
+export declare function runWorkerAgent(context: WorkerContext, plan: ImplementationPlan, options?: WorkerAgentOptions): Promise<WorkerResult>;
+export {};
+//# sourceMappingURL=worker-agent.d.ts.map

package/dist/memento/worker-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-agent.d.ts","sourceRoot":"","sources":["../../src/memento/worker-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGnE;;GAEG;AACH,UAAU,aAAa;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAoHvB"}

package/dist/memento/worker-agent.js

@@ -0,0 +1,109 @@
+/**
+ * Worker Agent for Memento Loop
+ *
+ * Executes implementation plans using the Claude Agent SDK.
+ */
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { buildWorkerPrompt, buildWorkerSystemPrompt } from "./prompts.js";
+/**
+ * Run the worker agent to implement a plan
+ */
+export async function runWorkerAgent(context, plan, options = {}) {
+    const startTime = Date.now();
+    const { verbose = false, model = "claude-sonnet-4-5", maxTurns = 50, } = options;
+    const prompt = buildWorkerPrompt(context.codeDirectory, plan);
+    const systemPrompt = buildWorkerSystemPrompt(context.codeDirectory);
+    if (verbose) {
+        console.log("\n[Worker] Starting implementation...");
+        console.log(`[Worker] Plan: ${plan.summary}`);
+        console.log(`[Worker] Steps: ${plan.steps.length}`);
+    }
+    const filesModified = [];
+    let lastAssistantText = "";
+    let resultMessage;
+    try {
+        const queryIterator = query({
+            prompt,
+            options: {
+                model,
+                maxTurns,
+                systemPrompt,
+                cwd: context.codeDirectory,
+                permissionMode: "bypassPermissions",
+            },
+        });
+        for await (const message of queryIterator) {
+            if (message.type === "assistant") {
+                const content = message.message.content;
+                for (const block of content) {
+                    if (block.type === "tool_use") {
+                        // Track file operations
+                        if (verbose) {
+                            console.log(`[Worker] Tool: ${block.name}`);
+                        }
+                        // Extract file paths from common tools
+                        if (block.name === "Write" ||
+                            block.name === "Edit" ||
+                            block.name === "str_replace_based_edit_tool") {
+                            const input = block.input;
+                            const filePath = input.file_path || input.path;
+                            if (typeof filePath === "string" && !filesModified.includes(filePath)) {
+                                filesModified.push(filePath);
+                            }
+                        }
+                    }
+                    else if (block.type === "text") {
+                        lastAssistantText = block.text;
+                    }
+                }
+            }
+            if (message.type === "result") {
+                resultMessage = message;
+            }
+        }
+        const durationMs = Date.now() - startTime;
+        if (!resultMessage) {
+            return {
+                success: false,
+                summary: "No result message received from worker agent",
+                filesModified,
+                errors: ["No result message received"],
+                durationMs,
+            };
+        }
+        if (resultMessage.subtype !== "success") {
+            const errorDetails = "errors" in resultMessage
+                ? resultMessage.errors.join(", ")
+                : "Unknown error";
+            return {
+                success: false,
+                summary: `Worker failed: ${resultMessage.subtype}`,
+                filesModified,
+                errors: [errorDetails],
+                durationMs,
+            };
+        }
+        if (verbose) {
+            console.log(`[Worker] Completed in ${durationMs}ms`);
+            console.log(`[Worker] Files modified: ${filesModified.length}`);
+        }
+        return {
+            success: true,
+            summary: resultMessage.result || lastAssistantText || "Implementation completed",
+            filesModified,
+            durationMs,
+        };
+    }
+    catch (error) {
+        const durationMs = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            summary: `Worker error: ${errorMessage}`,
+            filesModified,
+            errors: [errorMessage],
+            durationMs,
+        };
+    }
+}
+//# sourceMappingURL=worker-agent.js.map

package/dist/memento/worker-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-agent.js","sourceRoot":"","sources":["../../src/memento/worker-agent.ts"],"names":[],"mappings":"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"}

package/dist/mend/index.d.ts

@@ -31,11 +31,17 @@ export declare function autoFixNavigator(navPath: string, checks: MendCheckResul
     action: string;
     success: boolean;
 }>>;
+/**
+ * Run LLM-powered quality review on CLAUDE.md
+ * Uses Claude Opus to check for contradictions, best practices, hallucination risks, etc.
+ */
+export declare function reviewNavigatorQuality(navPath: string): Promise<MendCheckResult[]>;
 /**
  * Run full mend operation: check health and auto-fix issues
  */
 export declare function mendNavigator(navPath: string, options?: {
     autoFix?: boolean;
     quiet?: boolean;
+    review?: boolean;
 }): Promise<MendResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/mend/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mend/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsO/E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EAAE,GACxB,OAAO,CAAC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAwGrE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACZ,GACL,OAAO,CAAC,UAAU,CAAC,CAoBrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mend/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA6Q/E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EAAE,GACxB,OAAO,CAAC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAwGrE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA4CxF;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,GACL,OAAO,CAAC,UAAU,CAAC,CA6BrB"}

package/dist/mend/index.js

@@ -6,6 +6,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { NavigatorConfigSchema, getSkillName, getUpdateSkillName, localSkillExists, skillExists, isSkillSymlink, createAndSymlinkSkill, createAndSymlinkUpdateSkill, } from "@autonav/communication-layer";
+import { reviewClaudeMd } from "./llm-review.js";
 /**
  * Run all health checks on a navigator
  */
@@ -73,6 +74,7 @@ export async function checkNavigatorHealth(navPath) {
     }
     // 3. Check CLAUDE.md exists
     const claudeMdPath = path.join(navPath, "CLAUDE.md");
+    let claudeMdContent = null;
     if (!fs.existsSync(claudeMdPath)) {
         checks.push({
             check: "CLAUDE.md",
@@ -83,7 +85,7 @@ export async function checkNavigatorHealth(navPath) {
     }
     else {
         // Check for required sections
-        const claudeMdContent = fs.readFileSync(claudeMdPath, "utf-8");
+        claudeMdContent = fs.readFileSync(claudeMdPath, "utf-8");
         const requiredSections = ["## Grounding Rules"];
         const missingSections = requiredSections.filter(section => !claudeMdContent.includes(section));
         if (missingSections.length > 0) {
@@ -103,6 +105,43 @@ export async function checkNavigatorHealth(navPath) {
                 autoFixable: false,
             });
         }
+        // 3a. Check CLAUDE.md doesn't have submit_answer instructions
+        // (submit_answer is injected at query-time by createAnswerQuestionPrompt)
+        if (claudeMdContent.includes("submit_answer")) {
+            checks.push({
+                check: "submit_answer in CLAUDE.md",
+                status: "warning",
+                message: "CLAUDE.md contains submit_answer instructions",
+                details: "submit_answer is injected at query-time and should not be in CLAUDE.md. Run 'autonav migrate' to fix, or manually remove the references.",
+                autoFixable: false, // Migration v1.3.1 handles this
+            });
+        }
+        else {
+            checks.push({
+                check: "submit_answer in CLAUDE.md",
+                status: "pass",
+                message: "CLAUDE.md correctly omits submit_answer (injected at query-time)",
+                autoFixable: false,
+            });
+        }
+        // 3b. Check CLAUDE.md has autonav mend instruction
+        if (!claudeMdContent.includes("autonav mend")) {
+            checks.push({
+                check: "autonav mend instruction",
+                status: "warning",
+                message: "CLAUDE.md missing 'autonav mend' instruction",
+                details: "Navigators should remind users to run mend after config changes. Consider regenerating CLAUDE.md or adding the instruction manually.",
+                autoFixable: false,
+            });
+        }
+        else {
+            checks.push({
+                check: "autonav mend instruction",
+                status: "pass",
+                message: "CLAUDE.md includes mend instruction",
+                autoFixable: false,
+            });
+        }
     }
     // 4. Check knowledge base directory exists
     const knowledgePath = config.knowledgeBasePath
@@ -343,6 +382,51 @@ export async function autoFixNavigator(navPath, checks) {
     }
     return fixes;
 }
+/**
+ * Run LLM-powered quality review on CLAUDE.md
+ * Uses Claude Opus to check for contradictions, best practices, hallucination risks, etc.
+ */
+export async function reviewNavigatorQuality(navPath) {
+    const checks = [];
+    const claudeMdPath = path.join(navPath, "CLAUDE.md");
+    if (!fs.existsSync(claudeMdPath)) {
+        return checks; // Skip review if no CLAUDE.md
+    }
+    const content = fs.readFileSync(claudeMdPath, "utf-8");
+    const review = await reviewClaudeMd(content);
+    if (review.passed && review.issues.length === 0) {
+        checks.push({
+            check: "CLAUDE.md quality review",
+            status: "pass",
+            message: review.summary,
+            autoFixable: false,
+        });
+    }
+    else {
+        // Add a check for each issue
+        for (const issue of review.issues) {
+            checks.push({
+                check: `CLAUDE.md: ${issue.category}`,
+                status: issue.severity === "error" ? "fail" : "warning",
+                message: issue.description,
+                details: issue.suggestion
+                    ? `${issue.location ? `Location: ${issue.location}. ` : ""}Suggestion: ${issue.suggestion}`
+                    : issue.location,
+                autoFixable: false,
+            });
+        }
+        // Add summary as info
+        if (review.summary) {
+            checks.push({
+                check: "CLAUDE.md quality summary",
+                status: review.passed ? "pass" : "warning",
+                message: review.summary,
+                autoFixable: false,
+            });
+        }
+    }
+    return checks;
+}
 /**
  * Run full mend operation: check health and auto-fix issues
  */
@@ -361,6 +445,13 @@ export async function mendNavigator(navPath, options = {}) {
             result.checks = recheckResult.checks;
         }
     }
+    // Run LLM quality review if requested
+    if (options.review) {
+        const reviewChecks = await reviewNavigatorQuality(navPath);
+        result.checks.push(...reviewChecks);
+        // Re-evaluate overall health (review errors can affect health)
+        result.healthy = !result.checks.some(c => c.status === "fail");
+    }
     return result;
 }
 //# sourceMappingURL=index.js.map