@memograph/cli 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Memograph CLI contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,402 @@
+# Memograph CLI
+
+**Memory Drift Inspector for Conversational AI**
+
+Analyze conversation transcripts and detect when AI assistants lose context. Get a drift score, identify repetitions, forgotten preferences, and contradictions using AI-powered semantic analysis.
+
+---
+
+## Table of Contents
+
+- [What it does](#what-it-does)
+- [Why this exists](#why-this-exists)
+- [Try it now](#try-it-now)
+- [Install](#install)
+- [Quickstart](#quickstart)
+- [Using Memograph](#using-memograph)
+  - [Interactive Mode](#interactive-mode-recommended)
+  - [CLI Mode](#cli-mode-for-scripts--automation)
+- [Configuration](#configuration)
+- [Input Format](#input-format)
+- [Output](#output)
+- [Privacy & Security](#privacy--security)
+- [For Developers & Contributors](#for-developers--contributors)
+- [Troubleshooting](#troubleshooting)
+- [License](#license)
+
+---
+
+## What it does
+
+Memograph analyzes conversation transcripts to detect when AI assistants lose context or "forget" information:
+
+- **Detects repetitions**: User forced to repeat themselves
+- **Finds session resets**: Assistant language suggesting it forgot context
+- **Identifies forgotten preferences**: User restating preferences
+- **Spots contradictions**: Conflicting facts over time
+- **Calculates drift score** (0-100) and token waste percentage
+
+---
+
+## Why this exists
+
+When building conversational apps, memory failures often look like:
+
+- Users repeating preferences: "I already said I want Bangla…"
+- The assistant resets context: "Let's start over…"
+- The same question is asked multiple times because the assistant doesn't converge
+- Contradictory facts creep in
+
+Memograph CLI gives you a **quick, local diagnostic** before you rebuild prompts, memory layers, or retrieval logic.
+
+---
+
+## Try it now
+
+Get started in one command:
+
+```bash
+npx memograph-cli
+```
+
+This launches interactive mode with:
+- Visual menu (arrow keys + Enter)
+- Setup wizard for AI configuration
+- Settings that persist across sessions
+- Real-time progress indicators
+
+---
+
+## Using Memograph
+
+### Interactive Mode (Recommended)
+
+Run without arguments for a guided experience with arrow key navigation:
+
+```bash
+npx memograph-cli
+```
+
+**Main features:**
+- **Visual menu** with ↑/↓ arrow key navigation
+- **Inspect transcripts**: Enter file path → Choose output format → View results
+- **Manage settings**: Configure once, settings persist in `~/.memograph/config.json`
+- **Setup wizard**: 5-step guided configuration for AI providers
+
+**Quick setup wizard:**
+1. Select provider category (Cloud/Aggregators/Local)
+2. Choose specific provider (OpenAI, Anthropic, Ollama, etc.)
+3. Configure base URL (if needed)
+4. Enter API key (if required)
+5. Select model
+
+**Keyboard shortcuts:**
+- `↑` / `↓` - Navigate options
+- `Enter` - Select/confirm
+- `Ctrl+C` - Exit
+
+---
+
+## Install
+
+### Option A: Try instantly (no installation) ⚡
+
+**Recommended for first-time users and quick analysis:**
+
+\`\`\`bash
+npx memograph-cli
+\`\`\`
+
+Launches the interactive mode immediately. Configure your AI model on first run, and you're ready to analyze transcripts!
+
+### Option B: Install globally 📦
+
+**Best for regular use:**
+
+\`\`\`bash
+npm i -g memograph-cli
+\`\`\`
+
+After installation, run from anywhere:
+
+\`\`\`bash
+# Interactive mode
+memograph
+
+# Or CLI mode
+memograph inspect -i ./transcript.json
+\`\`\`
+
+The package name is `memograph-cli` and the command is `memograph`.
+
+### Option C: Local development 🛠️
+
+**For contributors and local testing:**
+
+\`\`\`bash
+git clone https://github.com/yourusername/memograph-cli
+cd memograph-cli
+npm install
+npm run build
+
+# Run directly
+node dist/cli.js
+
+# Or use npm scripts
+npm start
+\`\`\`
+
+---
+
+## Quickstart
+
+### Interactive Mode (Recommended)
+
+**Get started in 3 steps:**
+
+\`\`\`bash
+# 1. Launch interactive mode
+npx memograph-cli
+
+# 2. First time? Run the setup wizard
+#    - Select your AI provider (OpenAI, Anthropic, Ollama, etc.)
+#    - Enter API key (if required)
+#    - Choose a model
+#    Settings are saved to ~/.memograph/config.json
+
+# 3. Select "Inspect a transcript"
+#    - Enter path: ./transcript.json
+#    - Choose format: Text or JSON
+#    - View your drift analysis!
+\`\`\`
+
+### CLI Mode (For Scripts & Power Users)
+
+**Quick example:**
+
+1. Create a transcript file:
+
+**transcript.json**
+
+\`\`\`json
+{
+  "schema_version": "1.0",
+  "messages": [
+    { "idx": 0, "role": "user", "content": "My name is Tusher" },
+    { "idx": 1, "role": "assistant", "content": "Nice to meet you!" },
+    { "idx": 2, "role": "user", "content": "Please reply in Bangla from now on" },
+    { "idx": 3, "role": "assistant", "content": "Sure." },
+    { "idx": 4, "role": "user", "content": "Reply in Bangla please (I told you before)" }
+  ]
+}
+\`\`\`
+
+2. Run inspect with flags:
+
+\`\`\`bash
+# Text output (uses settings from interactive mode or env vars)
+memograph inspect -i transcript.json
+
+# Or specify all options via CLI flags
+memograph inspect -i transcript.json \
+  --llm-provider openai \
+  --llm-model gpt-4o-mini \
+  --llm-api-key sk-...
+
+# JSON output for CI/scripts
+memograph inspect -i transcript.json --json
+\`\`\`
+
+**Note:** If you've configured settings in interactive mode, CLI commands automatically use those settings. You can override any setting with CLI flags.
+
+---
+
+### CLI Mode (For Scripts & Automation)
+
+For scripting and automation, use the `inspect` command directly:
+
+```bash
+memograph-cli inspect -i transcript.json
+```
+
+**When to use CLI mode:**
+- Automation scripts and CI/CD pipelines
+- Batch processing multiple files
+- When you already know your settings
+
+**Pro tip:** Configure settings once in interactive mode, then use CLI mode for automated workflows!
+
+---
+
+**CLI inspect command:**
+
+```bash
+memograph-cli inspect -i <path> [--json] [--llm-model <model>]
+```
+
+**Common options:**
+- `-i, --input <path>` - Transcript file (required)
+- `--json` - Output JSON instead of text
+- `--llm-model <model>` - Override model (e.g., gpt-4o)
+- `--llm-provider <provider>` - Override provider (openai, anthropic)
+- `--max-messages <n>` - Limit messages processed
+
+**Examples:**
+
+```bash
+# Basic usage (uses saved settings)
+memograph-cli inspect -i transcript.json
+
+# JSON output for scripts
+memograph-cli inspect -i transcript.json --json
+
+# Use different model
+memograph-cli inspect -i transcript.json --llm-model gpt-4o
+```
+
+For all options, run: `memograph-cli inspect --help`
+
+---
+
+## Configuration
+
+**Easiest: Interactive Setup**
+
+```bash
+npx memograph-cli
+# Select "Manage settings" → Follow wizard
+# Settings saved to ~/.memograph/config.json
+```
+
+**Alternative: Environment Variables**
+
+```bash
+# Create .env file
+OPENAI_API_KEY=sk-your-key-here
+LLM_MODEL=gpt-4o-mini
+```
+
+**Using Local Models (Ollama)**
+
+```bash
+# Install and start Ollama
+brew install ollama
+ollama pull llama3.2
+ollama serve
+
+# Configure in interactive mode or use CLI flags
+```
+
+Settings priority: CLI flags > Environment variables > Config file
+
+---
+
+## Input Format
+
+Provide a JSON file with conversation messages:
+
+```json
+{
+  "schema_version": "1.0",
+  "messages": [
+    { "idx": 0, "role": "user", "content": "Hello" },
+    { "idx": 1, "role": "assistant", "content": "Hi!" }
+  ]
+}
+```
+
+**Required fields:**
+- `role`: "user", "assistant", "system", or "tool"
+- `content`: Message text
+
+**Optional fields:**
+- `idx`: Message index (auto-assigned if missing)
+- `ts`: ISO timestamp
+- `tokens`: Token count (estimated if missing)
+
+---
+
+## Output
+
+**Text output** (default): Human-readable report with drift score, events, and extracted facts.
+
+**JSON output** (`--json` flag): Machine-readable format for scripts and CI/CD.
+
+```json
+{
+  "drift_score": 25,
+  "token_waste_pct": 7.1,
+  "events": [...],
+  "should_have_been_memory": [...]
+}
+```
+
+---
+
+
+
+## Privacy & Security
+
+**Your data stays local:**
+- Memograph reads transcript files from your local filesystem
+- Only sends data to LLM APIs for analysis (or uses local models)
+- No data is stored or transmitted elsewhere
+
+**API Key Safety:**
+- Keys are stored in `~/.memograph/config.json` or environment variables
+- Never commit API keys to git (add `.env` to `.gitignore`)
+- Use local models (Ollama) to avoid sending data to external APIs
+
+---
+
+
+
+## For Developers & Contributors
+
+Interested in contributing or understanding how Memograph works? Check out [CONTRIBUTING.md](CONTRIBUTING.md) for:
+
+- **How it works**: Detection algorithms, scoring, performance optimizations
+- **Development setup**: Local environment, project structure, testing
+- **Roadmap**: Planned features and improvements
+- **Publishing**: Guidelines for releasing new versions
+
+---
+
+## Troubleshooting
+
+### Common Issues
+
+**"API key not found"**
+- Run `npx memograph-cli` and use "Manage settings" → "Set/Update API Key"
+- Or set environment variable: `export OPENAI_API_KEY=sk-...`
+
+**Interactive mode doesn't start**
+- Don't pass any arguments (they trigger CLI mode)
+- Ensure terminal supports ANSI colors and arrow keys
+
+**Settings not saving**
+- Settings are in `~/.memograph/config.json`
+- Reset with: `rm ~/.memograph/config.json && npx memograph-cli`
+
+**Ollama not working**
+- Ensure Ollama is running: `ollama serve`
+- Use correct URL: `http://localhost:11434/v1`
+- Install model: `ollama pull llama3.2`
+
+**Network/API errors**
+- Check internet connection
+- Verify API status (status.openai.com / status.anthropic.com)
+- Try a different model or use local models
+
+**Where are settings stored?**
+- Location: `~/.memograph/config.json`
+- View: `cat ~/.memograph/config.json`
+- Edit via interactive mode: "Manage settings" → "Show raw config"
+
+**Settings priority:** CLI flags > Environment variables > Config file
+
+---
+
+## License
+
+MIT License - see LICENSE file for details.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,eAAe,CAAC"}

package/dist/cli.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const commander_1 = require("commander");
+const load_js_1 = require("./core/load.js");
+const inspect_js_1 = require("./core/inspect.js");
+const render_js_1 = require("./core/render.js");
+const index_js_1 = require("./interactive/index.js");
+const program = new commander_1.Command();
+program
+    .name('memograph')
+    .version('0.1.0')
+    .description('LLM-powered CLI tool for analyzing conversation transcripts and detecting memory drift');
+program
+    .command('inspect')
+    .description('Analyze a transcript for drift and repetition using LLM-based semantic analysis')
+    .requiredOption('-i, --input <path>', 'path to transcript JSON file')
+    .option('--json', 'output JSON (machine-readable)', false)
+    .option('--max-messages <n>', 'cap number of messages processed', (val) => parseInt(val, 10), 2000)
+    .option('--llm-provider <provider>', 'LLM provider: openai or anthropic', 'openai')
+    .option('--llm-model <model>', 'LLM model to use (e.g., gpt-4o-mini, claude-3-5-sonnet-20241022)')
+    .option('--llm-api-key <key>', 'LLM API key (or set OPENAI_API_KEY or ANTHROPIC_API_KEY env var)')
+    .option('--llm-base-url <url>', 'Custom base URL for LLM API (useful for local models like Ollama)')
+    .option('--llm-temperature <temp>', 'LLM temperature (0.0-1.0)', (val) => parseFloat(val), 0.3)
+    .option('--llm-max-tokens <tokens>', 'Maximum tokens for LLM response', (val) => parseInt(val, 10), 4096)
+    .action(async (options) => {
+    try {
+        // Load transcript
+        const transcript = await (0, load_js_1.loadTranscript)(options.input, options.maxMessages);
+        // Build inspection config (LLM-only mode)
+        const config = {
+            max_messages: options.maxMessages,
+            llm: {
+                provider: options.llmProvider,
+                apiKey: options.llmApiKey,
+                model: options.llmModel,
+                temperature: options.llmTemperature,
+                maxTokens: options.llmMaxTokens,
+                baseUrl: options.llmBaseUrl,
+            },
+        };
+        // Run inspection (LLM-based, async)
+        const result = await (0, inspect_js_1.inspectTranscript)(transcript, config);
+        // Render output
+        const output = options.json
+            ? (0, render_js_1.renderJsonReport)(result)
+            : (0, render_js_1.renderTextReport)(result);
+        console.log(output);
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Error: ${error.message}`);
+        }
+        else {
+            console.error('Unknown error occurred');
+        }
+        process.exit(1);
+    }
+});
+program
+    .command('interactive', { hidden: true })
+    .description('Launch interactive mode (automatically used when no arguments provided)')
+    .action(async () => {
+    try {
+        await (0, index_js_1.runInteractiveMode)();
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Error: ${error.message}`);
+        }
+        else {
+            console.error('Unknown error occurred');
+        }
+        process.exit(1);
+    }
+});
+// Check if we should launch interactive mode
+const args = process.argv.slice(2);
+// Check for help or version flags
+const isHelpOrVersion = args.length === 1 && (args[0] === '-h' || args[0] === '--help' || args[0] === '-V' || args[0] === '--version');
+// Check if there's a command (inspect, interactive)
+const hasCommand = args.length > 0 && (args[0] === 'inspect' || args[0] === 'interactive' || args[0] === 'help');
+if (!hasCommand && !isHelpOrVersion) {
+    // No command provided, launch interactive mode
+    (0, index_js_1.runInteractiveMode)().catch((error) => {
+        console.error('Error:', error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+    });
+}
+else {
+    // Parse command line arguments for CLI commands
+    program.parse(process.argv);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yBAAuB;AACvB,yCAAoC;AACpC,4CAAgD;AAChD,kDAAsD;AACtD,gDAAsE;AACtE,qDAA4D;AAE5D,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,wFAAwF,CAAC,CAAC;AAEzG,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,iFAAiF,CAAC;KAC9F,cAAc,CAAC,oBAAoB,EAAE,8BAA8B,CAAC;KACpE,MAAM,CAAC,QAAQ,EAAE,gCAAgC,EAAE,KAAK,CAAC;KACzD,MAAM,CAAC,oBAAoB,EAAE,kCAAkC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC;KAClG,MAAM,CAAC,2BAA2B,EAAE,mCAAmC,EAAE,QAAQ,CAAC;KAClF,MAAM,CAAC,qBAAqB,EAAE,kEAAkE,CAAC;KACjG,MAAM,CAAC,qBAAqB,EAAE,kEAAkE,CAAC;KACjG,MAAM,CAAC,sBAAsB,EAAE,mEAAmE,CAAC;KACnG,MAAM,CAAC,0BAA0B,EAAE,2BAA2B,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;KAC9F,MAAM,CAAC,2BAA2B,EAAE,iCAAiC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC;KACxG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,kBAAkB;QAClB,MAAM,UAAU,GAAG,MAAM,IAAA,wBAAc,EAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAE5E,0CAA0C;QAC1C,MAAM,MAAM,GAAQ;YAClB,YAAY,EAAE,OAAO,CAAC,WAAW;YACjC,GAAG,EAAE;gBACH,QAAQ,EAAE,OAAO,CAAC,WAAW;gBAC7B,MAAM,EAAE,OAAO,CAAC,SAAS;gBACzB,KAAK,EAAE,OAAO,CAAC,QAAQ;gBACvB,WAAW,EAAE,OAAO,CAAC,cAAc;gBACnC,SAAS,EAAE,OAAO,CAAC,YAAY;gBAC/B,OAAO,EAAE,OAAO,CAAC,UAAU;aAC5B;SACF,CAAC;QAEF,oCAAoC;QACpC,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAiB,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAE3D,gBAAgB;QAChB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI;YACzB,CAAC,CAAC,IAAA,4BAAgB,EAAC,MAAM,CAAC;YAC1B,CAAC,CAAC,IAAA,4BAAgB,EAAC,MAAM,CAAC,CAAC;QAE7B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KACxC,WAAW,CAAC,yEAAyE,CAAC;KACtF,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,IAAA,6BAAkB,GAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,6CAA6C;AAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,kCAAkC;AAClC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC;AAEvI,oDAAoD;AACpD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;AAEjH,IAAI,CAAC,UAAU,IAAI,CAAC,eAAe,EAAE,CAAC;IACpC,+CAA+C;IAC/C,IAAA,6BAAkB,GAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACnC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;KAAM,CAAC;IACN,gDAAgD;IAChD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/core/detect.d.ts

@@ -0,0 +1,30 @@
+import { TranscriptMessage, ExtractedFact, RepetitionCluster, SessionReset, PreferenceForgotten, Contradiction } from './types.js';
+/**
+ * Detect repetition clusters in user messages
+ */
+export declare function detectRepetitionClusters(messages: TranscriptMessage[], similarityThreshold?: number): {
+    events: RepetitionCluster[];
+    timing_ms: number;
+};
+/**
+ * Detect session reset signals in assistant messages
+ */
+export declare function detectSessionReset(messages: TranscriptMessage[]): {
+    events: SessionReset[];
+    timing_ms: number;
+};
+/**
+ * Detect when user restates preferences (suggesting they were forgotten)
+ */
+export declare function detectPreferenceForgotten(messages: TranscriptMessage[], facts: ExtractedFact[], gapThreshold?: number): {
+    events: PreferenceForgotten[];
+    timing_ms: number;
+};
+/**
+ * Detect contradictions in extracted facts
+ */
+export declare function detectContradictions(facts: ExtractedFact[]): {
+    events: Contradiction[];
+    timing_ms: number;
+};
+//# sourceMappingURL=detect.d.ts.map

package/dist/core/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/core/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB;;GAEG;AAEH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,mBAAmB,SAAO,GACzB;IAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CA+EpD;AAwBD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,EAAE,GAC5B;IAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAuC/C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,KAAK,EAAE,aAAa,EAAE,EACtB,YAAY,SAAI,GACf;IAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAyDtD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EAAE,GACrB;IAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAmChD"}