@autonav/core 1.0.0

package/dist/query-engine/output-formatter.js

@@ -0,0 +1,165 @@
+import chalk from "chalk";
+/**
+ * Format a navigator response for display
+ *
+ * @param response - Navigator response to format
+ * @param options - Formatting options
+ * @returns Formatted string for display
+ */
+export function formatResponse(response, options) {
+    // Disable chalk if noColor is set
+    if (options.noColor) {
+        chalk.level = 0;
+    }
+    switch (options.format) {
+        case "json":
+            return formatJSON(response);
+        case "compact":
+            return formatCompact(response);
+        case "pretty":
+        default:
+            return formatPretty(response, options.verbose);
+    }
+}
+/**
+ * Format response as JSON
+ */
+function formatJSON(response) {
+    return JSON.stringify(response, null, 2);
+}
+/**
+ * Format response in compact mode
+ * Answer + minimal source citations in brackets
+ */
+function formatCompact(response) {
+    const lines = [];
+    // Answer
+    lines.push(response.answer);
+    // Sources in brackets (using file field)
+    if (response.sources.length > 0) {
+        const sourceCitations = response.sources
+            .map((source) => source.file)
+            .join(", ");
+        lines.push(`[${sourceCitations}]`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format response in pretty mode
+ * Clear sections with formatting
+ */
+function formatPretty(response, verbose) {
+    const lines = [];
+    // Answer section
+    lines.push(chalk.bold.cyan("Answer:"));
+    lines.push(response.answer);
+    lines.push("");
+    // Sources section
+    if (response.sources.length > 0) {
+        lines.push(chalk.bold.cyan("Sources:"));
+        for (const source of response.sources) {
+            const filePath = chalk.white(source.file);
+            const sectionInfo = chalk.dim(` (${source.section})`);
+            lines.push(`${chalk.green("✓")} ${filePath}${sectionInfo}`);
+            // Show relevance
+            if (source.relevance) {
+                lines.push(chalk.dim(`  Relevance: ${source.relevance}`));
+            }
+        }
+        lines.push("");
+    }
+    // Confidence section (using enum value directly)
+    const confidenceColor = getConfidenceColor(response.confidence);
+    lines.push(`${chalk.bold("Confidence:")} ${confidenceColor(response.confidence)}`);
+    if (response.confidenceReason) {
+        lines.push(chalk.dim(`  Reason: ${response.confidenceReason}`));
+    }
+    lines.push("");
+    // Out of domain warning
+    if (response.outOfDomain) {
+        lines.push(chalk.yellow("⚠ This question is outside the navigator's domain"));
+        lines.push("");
+    }
+    // Related topics
+    if (response.relatedTopics && response.relatedTopics.length > 0) {
+        lines.push(chalk.bold.cyan("Related Topics:"));
+        for (const topic of response.relatedTopics) {
+            lines.push(`  ${chalk.dim("•")} ${topic}`);
+        }
+        lines.push("");
+    }
+    // Verbose information
+    if (verbose) {
+        lines.push(chalk.bold.dim("Debug Information:"));
+        lines.push(chalk.dim(`Protocol Version: ${response.protocolVersion}`));
+        if (response.metadata) {
+            lines.push(chalk.dim(`Navigator: ${response.metadata.navigatorName || "N/A"}`));
+            if (response.metadata.responseTimeMs) {
+                lines.push(chalk.dim(`Response Time: ${response.metadata.responseTimeMs}ms`));
+            }
+            if (response.metadata.filesSearched !== undefined) {
+                lines.push(chalk.dim(`Files Searched: ${response.metadata.filesSearched}`));
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Get color function for confidence level
+ */
+function getConfidenceColor(level) {
+    switch (level) {
+        case "high":
+            return chalk.green;
+        case "medium":
+            return chalk.yellow;
+        case "low":
+            return chalk.red;
+        default:
+            return chalk.gray;
+    }
+}
+/**
+ * Format loading message
+ */
+export function formatLoadingMessage(navigatorName) {
+    return `${chalk.blue("🔍")} Loading navigator: ${chalk.bold(navigatorName)}`;
+}
+/**
+ * Format query message
+ */
+export function formatQueryMessage(question) {
+    return `${chalk.blue("❓")} Question: ${chalk.italic(question)}`;
+}
+/**
+ * Format success message
+ */
+export function formatSuccessMessage(sourcesCount) {
+    return `${chalk.green("✅")} Query completed successfully! (${sourcesCount} source${sourcesCount !== 1 ? "s" : ""} cited)`;
+}
+/**
+ * Format error message
+ */
+export function formatErrorMessage(error) {
+    const message = error instanceof Error ? error.message : error;
+    return `${chalk.red("❌")} Error: ${message}`;
+}
+/**
+ * Format warning message
+ */
+export function formatWarningMessage(message) {
+    return `${chalk.yellow("⚠")} Warning: ${message}`;
+}
+/**
+ * Create a suggestion message with helpful text
+ */
+export function formatSuggestion(title, suggestions) {
+    const lines = [];
+    lines.push(chalk.bold(title));
+    for (const suggestion of suggestions) {
+        lines.push(`  ${chalk.dim("•")} ${suggestion}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=output-formatter.js.map

package/dist/query-engine/output-formatter.js.map

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

package/dist/query-engine/response-validator.d.ts

@@ -0,0 +1,55 @@
+import { NavigatorResponse, type ValidationResult, type ConfidenceLevel } from "@autonav/communication-layer";
+/**
+ * Response validation options
+ */
+export interface ResponseValidationOptions {
+    /**
+     * Minimum acceptable confidence level
+     * If set, responses below this level will fail validation
+     */
+    minimumConfidence?: ConfidenceLevel;
+    /**
+     * Whether to fail on missing sources (strict mode)
+     * Default: false (warnings only)
+     */
+    strictSourceValidation?: boolean;
+    /**
+     * Knowledge base path for source validation
+     */
+    knowledgeBasePath: string;
+}
+/**
+ * Extended validation result with confidence checking
+ */
+export interface ExtendedValidationResult extends ValidationResult {
+    /**
+     * Whether confidence level meets minimum requirement
+     */
+    confidenceMet: boolean;
+    /**
+     * Confidence level of the response
+     */
+    confidenceLevel?: ConfidenceLevel;
+    /**
+     * Minimum required confidence level
+     */
+    minimumConfidence?: ConfidenceLevel;
+}
+/**
+ * Validate a navigator response with additional checks
+ *
+ * @param response - Navigator response to validate
+ * @param options - Validation options
+ * @returns Extended validation result
+ */
+export declare function validateResponse(response: NavigatorResponse, options: ResponseValidationOptions): ExtendedValidationResult;
+/**
+ * Format validation errors for display
+ */
+export declare function formatValidationErrors(validation: ExtendedValidationResult): string;
+/**
+ * Format confidence information for display
+ */
+export declare function formatConfidenceInfo(validation: ExtendedValidationResult): string;
+export type { ConfidenceLevel };
+//# sourceMappingURL=response-validator.d.ts.map

package/dist/query-engine/response-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-validator.d.ts","sourceRoot":"","sources":["../../src/query-engine/response-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAGjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,eAAe,CAAC;IAEpC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;OAEG;IACH,iBAAiB,CAAC,EAAE,eAAe,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CAoD1B;AAuBD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,wBAAwB,GACnC,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,wBAAwB,GACnC,MAAM,CAeR;AAGD,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/query-engine/response-validator.js

@@ -0,0 +1,92 @@
+import { checkSourcesExist, detectHallucinations, } from "@autonav/communication-layer";
+/**
+ * Validate a navigator response with additional checks
+ *
+ * @param response - Navigator response to validate
+ * @param options - Validation options
+ * @returns Extended validation result
+ */
+export function validateResponse(response, options) {
+    // Run base validation (source existence, hallucination detection)
+    const sourceCheck = checkSourcesExist(response, options.knowledgeBasePath);
+    const hallucinationCheck = detectHallucinations(response);
+    // Combine validation results
+    const baseValidation = {
+        valid: sourceCheck.valid && hallucinationCheck.valid,
+        errors: [...sourceCheck.errors, ...hallucinationCheck.errors],
+        warnings: [...sourceCheck.warnings, ...hallucinationCheck.warnings],
+    };
+    // Check confidence level (now using enum)
+    const confidenceLevel = response.confidence;
+    const confidenceMet = checkConfidenceMeetsMinimum(confidenceLevel, options.minimumConfidence);
+    // Combine results
+    const extendedResult = {
+        ...baseValidation,
+        confidenceMet,
+        confidenceLevel,
+        minimumConfidence: options.minimumConfidence,
+    };
+    // Add confidence errors if threshold not met
+    if (!confidenceMet && options.minimumConfidence) {
+        extendedResult.valid = false;
+        extendedResult.errors.push(new Error(`Response confidence (${confidenceLevel}) is below required minimum (${options.minimumConfidence})`));
+    }
+    // Convert source validation warnings to errors if strict mode
+    if (options.strictSourceValidation && baseValidation.warnings.length > 0) {
+        const sourceWarnings = baseValidation.warnings.filter((w) => w.includes("Source file does not exist") || w.includes("not a file"));
+        if (sourceWarnings.length > 0) {
+            extendedResult.valid = false;
+            extendedResult.errors.push(...sourceWarnings.map((w) => new Error(`[STRICT MODE] ${w}`)));
+        }
+    }
+    return extendedResult;
+}
+/**
+ * Check if confidence level meets minimum requirement
+ */
+function checkConfidenceMeetsMinimum(actual, minimum) {
+    // If no minimum required, always pass
+    if (!minimum) {
+        return true;
+    }
+    const levels = {
+        low: 1,
+        medium: 2,
+        high: 3,
+    };
+    return levels[actual] >= levels[minimum];
+}
+/**
+ * Format validation errors for display
+ */
+export function formatValidationErrors(validation) {
+    const lines = [];
+    if (validation.errors.length > 0) {
+        lines.push("Validation errors:");
+        for (const error of validation.errors) {
+            lines.push(`  ❌ ${error.message}`);
+        }
+    }
+    if (validation.warnings.length > 0) {
+        lines.push("\nValidation warnings:");
+        for (const warning of validation.warnings) {
+            lines.push(`  ⚠ ${warning}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format confidence information for display
+ */
+export function formatConfidenceInfo(validation) {
+    const lines = [];
+    if (validation.confidenceLevel) {
+        lines.push(`Confidence: ${validation.confidenceLevel}`);
+        if (validation.minimumConfidence) {
+            lines.push(`Required: ${validation.minimumConfidence}`);
+            lines.push(`Met: ${validation.confidenceMet ? "✓ Yes" : "✗ No"}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=response-validator.js.map

package/dist/query-engine/response-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-validator.js","sourceRoot":"","sources":["../../src/query-engine/response-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EACjB,oBAAoB,GAGrB,MAAM,8BAA8B,CAAC;AA4CtC;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAA2B,EAC3B,OAAkC;IAElC,kEAAkE;IAClE,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3E,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAE1D,6BAA6B;IAC7B,MAAM,cAAc,GAAqB;QACvC,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,kBAAkB,CAAC,KAAK;QACpD,MAAM,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAC7D,QAAQ,EAAE,CAAC,GAAG,WAAW,CAAC,QAAQ,EAAE,GAAG,kBAAkB,CAAC,QAAQ,CAAC;KACpE,CAAC;IAEF,0CAA0C;IAC1C,MAAM,eAAe,GAAG,QAAQ,CAAC,UAAU,CAAC;IAC5C,MAAM,aAAa,GAAG,2BAA2B,CAC/C,eAAe,EACf,OAAO,CAAC,iBAAiB,CAC1B,CAAC;IAEF,kBAAkB;IAClB,MAAM,cAAc,GAA6B;QAC/C,GAAG,cAAc;QACjB,aAAa;QACb,eAAe;QACf,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KAC7C,CAAC;IAEF,6CAA6C;IAC7C,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAChD,cAAc,CAAC,KAAK,GAAG,KAAK,CAAC;QAC7B,cAAc,CAAC,MAAM,CAAC,IAAI,CACxB,IAAI,KAAK,CACP,wBAAwB,eAAe,gCAAgC,OAAO,CAAC,iBAAiB,GAAG,CACpG,CACF,CAAC;IACJ,CAAC;IAED,8DAA8D;IAC9D,IAAI,OAAO,CAAC,sBAAsB,IAAI,cAAc,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzE,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1D,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CACrE,CAAC;QAEF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,cAAc,CAAC,KAAK,GAAG,KAAK,CAAC;YAC7B,cAAc,CAAC,MAAM,CAAC,IAAI,CACxB,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAS,2BAA2B,CAClC,MAAuB,EACvB,OAAyB;IAEzB,sCAAsC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAoC;QAC9C,GAAG,EAAE,CAAC;QACN,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,CAAC;KACR,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAoC;IAEpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAoC;IAEpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;QAExD,IAAI,UAAU,CAAC,iBAAiB,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,aAAa,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;YACxD,KAAK,CAAC,IAAI,CACR,QAAQ,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CACtD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/templates/.gitignore.template

@@ -0,0 +1,23 @@
+# Node modules
+node_modules/
+
+# Environment variables
+.env
+.env.local
+
+# Plugin credentials (NEVER commit these!)
+.claude/plugins.json
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Logs
+*.log
+npm-debug.log*

package/dist/templates/CLAUDE-pack.md.template

@@ -0,0 +1,32 @@
+# Navigator: {{NAVIGATOR_NAME}}
+
+You are a specialized navigator using the {{PACK_NAME}} knowledge pack.
+
+## System Configuration
+
+Your domain-specific configuration is in `system-configuration.md`. Read and follow those guidelines carefully.
+
+## Your Knowledge Base
+
+Your knowledge is located in the `knowledge/` directory. This has been populated from the {{PACK_NAME}} knowledge pack.
+
+When answering questions:
+- Always cite specific files and sections
+- Use exact headings and references from the knowledge base
+- If you don't know something, say so explicitly
+- Never make up information not in your knowledge base
+- Follow the guidelines and response format specified in `system-configuration.md`
+
+## Source Citation
+
+Always structure responses with proper source citations as specified in `system-configuration.md`.
+
+Include:
+- Direct answer
+- File path references: [filename.md: Section Heading]
+- Relevant excerpts from sources
+- Confidence level
+
+## Response Format
+
+Follow the response format guidelines in `system-configuration.md`. Always use structured JSON responses following the NavigatorResponse schema.

package/dist/templates/CLAUDE.md.template

@@ -0,0 +1,128 @@
+# Navigator: {{NAVIGATOR_NAME}}
+
+You are a specialized navigator created with Autonav.
+
+## System Configuration
+
+If a `system-configuration.md` file exists, read it first. It contains domain-specific instructions, scope definitions, and response guidelines that override defaults.
+
+## Your Knowledge Base
+
+Your knowledge is located in the `knowledge/` directory. When answering questions:
+- Always cite specific files and sections
+- Use exact headings and references
+- If you don't know something, say so explicitly
+- Never make up information not in your knowledge base
+
+## Grounding Rules
+
+You MUST follow these rules when answering questions:
+
+1. **Always cite sources**: Every answer must reference specific files from the knowledge base
+2. **Quote directly**: Use exact excerpts from files, don't paraphrase
+3. **Never invent**: If information isn't in the knowledge base, say so clearly
+4. **File paths must exist**: Only cite files that actually exist in the knowledge/ directory
+5. **Be specific**: Include section headings or line numbers when citing sources
+6. **Acknowledge uncertainty**: If you're not confident, state that explicitly
+
+**Never do this**:
+- Don't make up commands, file paths, or configurations
+- Don't invent AWS resource names or ARNs
+- Don't hallucinate service endpoints or URLs
+- Don't guess if the information isn't in the docs
+
+**Always do this**:
+- Search the knowledge base thoroughly before answering
+- Cite specific files and sections
+- If unsure, say "I don't have information about that in the knowledge base"
+- Provide confidence scores honestly
+
+## How to Answer Questions
+
+1. **Search first**: Use grep/find to search the knowledge base for relevant information
+2. **Read carefully**: Use the Read tool to examine relevant files
+3. **Cite sources**: Always reference specific files and sections
+4. **Be honest**: If you don't know, say so clearly
+
+## Domain Scope
+
+[Define what this navigator knows about and what it doesn't]
+
+## Response Format
+
+Always structure your responses as JSON following the NavigatorResponse schema:
+
+```json
+{
+  "protocolVersion": "1.0.0",
+  "query": "the question asked",
+  "answer": "your detailed answer with inline citations",
+  "sources": [
+    {
+      "filePath": "relative/path/from/knowledge-base/file.md",
+      "excerpt": "exact quote from the file",
+      "section": "section heading"
+    }
+  ],
+  "confidence": 0.95
+}
+```
+
+## Knowledge Base Location
+
+All documentation is in the `knowledge/` directory. Only cite files that exist in this directory.
+
+## Example: Good Response
+
+**Question**: "How do I configure SSL?"
+
+```json
+{
+  "protocolVersion": "1.0.0",
+  "query": "How do I configure SSL?",
+  "answer": "To configure SSL, you need to update the load balancer settings. According to deployment/ssl-config.md, you should set the certificate ARN in the Terraform configuration.",
+  "sources": [
+    {
+      "filePath": "deployment/ssl-config.md",
+      "excerpt": "Set the certificate_arn parameter in the aws_lb_listener resource",
+      "section": "SSL Configuration"
+    }
+  ],
+  "confidence": 0.95
+}
+```
+
+## Example: Bad Response (Don't do this)
+
+**Question**: "How do I configure SSL?"
+
+```json
+{
+  "query": "How do I configure SSL?",
+  "answer": "You can configure SSL by updating the config.yaml file and setting ssl_enabled to true.",
+  "sources": [],
+  "confidence": 0.8
+}
+```
+
+**Problems**:
+- No sources cited
+- File path (config.yaml) may not exist
+- Vague answer without specifics
+- Claims knowledge without evidence
+
+## Confidence Scoring Guide
+
+- **1.0**: Fully grounded, multiple authoritative sources, no ambiguity
+- **0.8-0.9**: Well grounded, clear sources, minor gaps
+- **0.6-0.7**: Partially grounded, some inference required
+- **0.4-0.5**: Weakly grounded, significant uncertainty
+- **0.0-0.3**: Not grounded, likely needs human review
+
+If your confidence is below 0.5, acknowledge the uncertainty in your answer and suggest that a human review may be needed.
+
+## Remember
+
+Your value comes from accurately surfacing knowledge that already exists. Never invent information.
+
+You are here to multiply human potential by making existing knowledge easily accessible, not to replace human expertise.