@memoire-ai/collector 0.1.0

package/dist/cursor-hooks.js

@@ -0,0 +1,251 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, chmodSync, copyFileSync } from 'node:fs';
+import { join, dirname, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+// ---------------------------------------------------------------------------
+// Shell script sources (embedded at build time via string literals)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the directory containing the bundled shell scripts.
+ * Works whether this module is consumed as ESM source or from `dist/`.
+ */
+function getScriptsDir() {
+    // cursor-hooks/ lives as a sibling to packages/collector/src/
+    // at packages/collector/cursor-hooks/
+    const thisFile = fileURLToPath(import.meta.url);
+    const thisDir = dirname(thisFile);
+    // When running from dist/ (compiled), scripts are at ../../cursor-hooks/
+    const fromDist = resolve(thisDir, '..', 'cursor-hooks');
+    if (existsSync(fromDist))
+        return fromDist;
+    // When running from src/ (development), scripts are at ../cursor-hooks/
+    const fromSrc = resolve(thisDir, '..', 'cursor-hooks');
+    if (existsSync(fromSrc))
+        return fromSrc;
+    // Fallback: look relative to package root
+    const fromRoot = resolve(thisDir, '..', '..', 'cursor-hooks');
+    if (existsSync(fromRoot))
+        return fromRoot;
+    throw new Error('Memoire cursor-hooks scripts directory not found. ' +
+        'Ensure the cursor-hooks/ directory exists alongside the collector package.');
+}
+const SCRIPT_FILES = ['context-inject.sh', 'session-summary.sh', 'save-observation.sh', 'save-shell-execution.sh', 'save-file-edit.sh'];
+// ---------------------------------------------------------------------------
+// generateHooksJson
+// ---------------------------------------------------------------------------
+/**
+ * Generate a Cursor `hooks.json` configuration object.
+ *
+ * The returned object can be serialised to `<project>/.cursor/hooks.json`
+ * (or merged into an existing one).
+ *
+ * @param apiUrl - Optional Memoire API URL baked into hook commands.
+ *                 When omitted, scripts read from env / config file at runtime.
+ */
+export function generateHooksJson(apiUrl) {
+    const envPrefix = apiUrl ? `MEMOIRE_API_URL=${quote(apiUrl)} ` : '';
+    return {
+        hooks: {
+            beforeSubmitPrompt: [
+                {
+                    command: `${envPrefix}sh .cursor/hooks/context-inject.sh "$PROMPT"`,
+                    description: 'Inject Memoire project context into Cursor rules',
+                    blocking: true,
+                },
+            ],
+            stop: [
+                {
+                    command: `${envPrefix}sh .cursor/hooks/session-summary.sh`,
+                    description: 'Generate Memoire session summary',
+                    blocking: false,
+                },
+            ],
+            afterMCPExecution: [
+                {
+                    command: `${envPrefix}sh .cursor/hooks/save-observation.sh "$TOOL_NAME" "$TOOL_STATUS"`,
+                    description: 'Track MCP tool calls in Memoire',
+                    blocking: false,
+                },
+            ],
+            afterShellExecution: [
+                {
+                    command: `${envPrefix}sh .cursor/hooks/save-shell-execution.sh "$COMMAND" "$EXIT_CODE"`,
+                    description: 'Track shell commands in Memoire',
+                    blocking: false,
+                },
+            ],
+            afterFileEdit: [
+                {
+                    command: `${envPrefix}sh .cursor/hooks/save-file-edit.sh "$FILE_PATH"`,
+                    description: 'Track file edits in Memoire',
+                    blocking: false,
+                },
+            ],
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// generateSetupInstructions
+// ---------------------------------------------------------------------------
+/**
+ * Return human-readable setup instructions for a given project path.
+ */
+export function generateSetupInstructions(projectPath) {
+    const abs = resolve(projectPath);
+    return [
+        'Memoire Cursor Hooks — Setup Instructions',
+        '==========================================',
+        '',
+        '1. Ensure the Memoire API is running (default: http://127.0.0.1:3100)',
+        '',
+        `2. Run the installer (already done if you see .cursor/hooks/ in ${abs}):`,
+        '',
+        "   import { installCursorHooks } from '@memoire-ai/collector';",
+        `   installCursorHooks('${abs}');`,
+        '',
+        '3. Create ~/.memoire/config with your credentials:',
+        '',
+        '   MEMOIRE_API_URL=http://127.0.0.1:3100',
+        '   MEMOIRE_API_KEY=<your-api-key>',
+        '   MEMOIRE_ORG_ID=<your-org-id>',
+        '   MEMOIRE_PROJECT_ID=<your-project-id>',
+        '   MEMOIRE_USER_ID=<your-user-id>',
+        '',
+        '4. Restart Cursor to pick up the hooks.',
+        '',
+        '5. Add to .gitignore:',
+        '',
+        '   .cursor/rules/memoire-context.mdc',
+        '',
+        'The hook scripts (.cursor/hooks/*.sh) can be committed to share with your team.',
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// installCursorHooks
+// ---------------------------------------------------------------------------
+/**
+ * Install Memoire Cursor hooks into a project directory.
+ *
+ * 1. Copies (or merges) `hooks.json` into `<project>/.cursor/hooks.json`
+ * 2. Copies shell scripts into `<project>/.cursor/hooks/`
+ * 3. Makes shell scripts executable (chmod +x)
+ * 4. Optionally writes `~/.memoire/config` with API credentials
+ *
+ * Safe to call repeatedly — existing hooks are preserved via merge.
+ *
+ * @param projectPath - Absolute or relative path to the project root
+ * @param apiUrl      - Memoire API URL (written to config if provided)
+ * @param apiKey      - Memoire API key (written to config if provided)
+ */
+export function installCursorHooks(projectPath, apiUrl, apiKey) {
+    const root = resolve(projectPath);
+    const cursorDir = join(root, '.cursor');
+    const hooksDir = join(cursorDir, 'hooks');
+    const hooksJsonPath = join(cursorDir, 'hooks.json');
+    // Ensure directories exist
+    mkdirSync(hooksDir, { recursive: true });
+    // ------------------------------------------------------------------
+    // 1. hooks.json — merge with any existing configuration
+    // ------------------------------------------------------------------
+    const generated = generateHooksJson(apiUrl);
+    if (existsSync(hooksJsonPath)) {
+        try {
+            const existing = JSON.parse(readFileSync(hooksJsonPath, 'utf-8'));
+            const merged = mergeHooksJson(existing, generated);
+            writeJsonAtomic(hooksJsonPath, merged);
+        }
+        catch {
+            // Existing file is corrupt — overwrite
+            writeJsonAtomic(hooksJsonPath, generated);
+        }
+    }
+    else {
+        writeJsonAtomic(hooksJsonPath, generated);
+    }
+    // ------------------------------------------------------------------
+    // 2 & 3. Copy shell scripts and make them executable
+    // ------------------------------------------------------------------
+    const scriptsDir = getScriptsDir();
+    for (const script of SCRIPT_FILES) {
+        const src = join(scriptsDir, script);
+        const dest = join(hooksDir, script);
+        if (!existsSync(src)) {
+            throw new Error(`Memoire hook script not found: ${src}`);
+        }
+        copyFileSync(src, dest);
+        chmodSync(dest, 0o755);
+    }
+    // ------------------------------------------------------------------
+    // 4. Optionally write ~/.memoire/config
+    // ------------------------------------------------------------------
+    if (apiUrl || apiKey) {
+        writeOrUpdateMemoireConfig(apiUrl, apiKey);
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Merge two hooks.json configs, preserving existing non-Memoire hooks.
+ * Memoire hooks (identified by description prefix) are replaced.
+ */
+function mergeHooksJson(existing, incoming) {
+    const merged = { hooks: { ...existing.hooks } };
+    for (const hookName of ['beforeSubmitPrompt', 'stop', 'afterMCPExecution', 'afterShellExecution', 'afterFileEdit']) {
+        const incomingEntries = incoming.hooks[hookName] ?? [];
+        const existingEntries = existing.hooks[hookName] ?? [];
+        // Remove any existing Memoire entries
+        const nonMemoire = existingEntries.filter((entry) => !entry.description.toLowerCase().includes('memoire'));
+        merged.hooks[hookName] = [...nonMemoire, ...incomingEntries];
+    }
+    return merged;
+}
+/** Atomic JSON write via temp + rename. */
+function writeJsonAtomic(filePath, data) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const tmp = `${filePath}.tmp`;
+    writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+    const { renameSync } = require('node:fs');
+    renameSync(tmp, filePath);
+}
+/** Write or update ~/.memoire/config with KEY=VALUE entries. */
+function writeOrUpdateMemoireConfig(apiUrl, apiKey) {
+    const configDir = join(homedir(), '.memoire');
+    const configPath = join(configDir, 'config');
+    mkdirSync(configDir, { recursive: true });
+    // Read existing config if present
+    const existing = new Map();
+    if (existsSync(configPath)) {
+        const content = readFileSync(configPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eqIdx = trimmed.indexOf('=');
+            if (eqIdx > 0) {
+                existing.set(trimmed.slice(0, eqIdx).trim(), trimmed.slice(eqIdx + 1).trim());
+            }
+        }
+    }
+    // Update with new values (don't overwrite existing values with undefined)
+    if (apiUrl)
+        existing.set('MEMOIRE_API_URL', apiUrl);
+    if (apiKey)
+        existing.set('MEMOIRE_API_KEY', apiKey);
+    // Write back
+    const lines = ['# Memoire configuration (auto-generated)'];
+    for (const [key, value] of existing) {
+        lines.push(`${key}=${value}`);
+    }
+    lines.push('');
+    writeFileSync(configPath, lines.join('\n'), { encoding: 'utf-8', mode: 0o600 });
+}
+/** Shell-safe quoting for values embedded in hook commands. */
+function quote(value) {
+    // Simple single-quote wrapping with escaping
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=cursor-hooks.js.map

package/dist/cursor-hooks.js.map

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

package/dist/cursor-rules.d.ts

@@ -0,0 +1,42 @@
+export declare const DEFAULT_CURSOR_RULES_TOKEN_BUDGET = 900;
+export interface CursorRulesContext {
+    projectName: string;
+    profile?: {
+        architecture?: string;
+        conventions?: string[];
+        stack?: string[];
+        currentFocus?: string;
+    };
+    recentFacts?: Array<{
+        subject: string;
+        predicate: string;
+        object: string;
+    }>;
+    recentSummary?: string;
+    apiUrl?: string;
+    resumeText?: string;
+    focusQuery?: string;
+    tokenBudget?: number;
+}
+/**
+ * Generate and write a `.cursor/rules/memoire-context.mdc` file
+ * that Cursor auto-injects into every conversation.
+ *
+ * Inspired by claude-mem's context injection approach:
+ * - alwaysApply: true → auto-included in every chat
+ * - Contains project profile + recent facts for zero-config context
+ * - Updated after each session end
+ * - Atomic write (temp file + rename) to prevent corruption
+ */
+export declare function writeCursorRules(workspacePath: string, context: CursorRulesContext): void;
+/**
+ * Read existing cursor rules context if present.
+ */
+export declare function readCursorRules(workspacePath: string): string | null;
+/**
+ * Remove the cursor rules file.
+ */
+export declare function removeCursorRules(workspacePath: string): boolean;
+export declare function estimateCursorRulesTokens(content: string): number;
+export declare function buildCursorRulesContent(context: CursorRulesContext): string;
+//# sourceMappingURL=cursor-rules.d.ts.map

package/dist/cursor-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-rules.d.ts","sourceRoot":"","sources":["../src/cursor-rules.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAIrD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAezF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAUhE;AAMD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAyC3E"}

package/dist/cursor-rules.js

@@ -0,0 +1,229 @@
+import { writeFileSync, mkdirSync, existsSync, renameSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const RULES_FILENAME = 'memoire-context.mdc';
+export const DEFAULT_CURSOR_RULES_TOKEN_BUDGET = 900;
+const CHARS_PER_TOKEN_ESTIMATE = 4;
+const MAX_LINE_LENGTH = 160;
+/**
+ * Generate and write a `.cursor/rules/memoire-context.mdc` file
+ * that Cursor auto-injects into every conversation.
+ *
+ * Inspired by claude-mem's context injection approach:
+ * - alwaysApply: true → auto-included in every chat
+ * - Contains project profile + recent facts for zero-config context
+ * - Updated after each session end
+ * - Atomic write (temp file + rename) to prevent corruption
+ */
+export function writeCursorRules(workspacePath, context) {
+    const rulesDir = join(workspacePath, '.cursor', 'rules');
+    const rulesFile = join(rulesDir, RULES_FILENAME);
+    const tempFile = `${rulesFile}.tmp`;
+    // Ensure .cursor/rules/ exists
+    if (!existsSync(rulesDir)) {
+        mkdirSync(rulesDir, { recursive: true });
+    }
+    const content = buildCursorRulesContent(context);
+    // Atomic write: write to temp, then rename
+    writeFileSync(tempFile, content, 'utf-8');
+    renameSync(tempFile, rulesFile);
+}
+/**
+ * Read existing cursor rules context if present.
+ */
+export function readCursorRules(workspacePath) {
+    const rulesFile = join(workspacePath, '.cursor', 'rules', RULES_FILENAME);
+    if (!existsSync(rulesFile))
+        return null;
+    try {
+        return readFileSync(rulesFile, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Remove the cursor rules file.
+ */
+export function removeCursorRules(workspacePath) {
+    const rulesFile = join(workspacePath, '.cursor', 'rules', RULES_FILENAME);
+    if (!existsSync(rulesFile))
+        return false;
+    try {
+        const { unlinkSync } = require('node:fs');
+        unlinkSync(rulesFile);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function generateRulesContent(context) {
+    return buildCursorRulesContent(context);
+}
+export function estimateCursorRulesTokens(content) {
+    return Math.ceil(content.length / CHARS_PER_TOKEN_ESTIMATE);
+}
+export function buildCursorRulesContent(context) {
+    const sections = [];
+    const maxChars = Math.max(1200, (context.tokenBudget ?? DEFAULT_CURSOR_RULES_TOKEN_BUDGET) * CHARS_PER_TOKEN_ESTIMATE);
+    // YAML frontmatter — alwaysApply ensures Cursor auto-includes this
+    sections.push(`---
+alwaysApply: true
+description: "Memoire shared memory context for ${context.projectName} (auto-updated)"
+---`);
+    sections.push(`# Memoire Context: ${context.projectName}`);
+    sections.push('');
+    sections.push('> Auto-generated by Memoire.');
+    sections.push('> Condensed for token efficiency. Use Memoire MCP tools for deeper queries.');
+    sections.push('');
+    const remainingBudget = {
+        value: maxChars - sections.join('\n').length,
+    };
+    if (context.resumeText) {
+        appendResumeSections(sections, context, remainingBudget);
+    }
+    else {
+        appendStructuredSections(sections, context, remainingBudget);
+    }
+    // Footer with MCP hint
+    appendWithinBudget(sections, [
+        '---',
+        '*Use Memoire MCP tools (`search_context`, `assemble_context`, `search_docs`) for deeper context on demand.*',
+    ].join('\n'), remainingBudget);
+    if (context.apiUrl) {
+        appendWithinBudget(sections, `*API: ${context.apiUrl}*`, remainingBudget);
+    }
+    return sections.join('\n');
+}
+function appendResumeSections(sections, context, remainingBudget) {
+    const parsed = parseResumeSections(context.resumeText ?? '');
+    const focus = context.focusQuery?.trim() || parsed.focus;
+    if (focus) {
+        appendSection(sections, 'Focus', [focus], remainingBudget, 1, 220);
+    }
+    appendSection(sections, 'Project Profile', parsed.profile.length > 0 ? parsed.profile : buildStructuredProfileItems(context.profile), remainingBudget, 5, 720);
+    appendSection(sections, 'Durable Facts', parsed.facts.length > 0 ? parsed.facts : buildFactItems(context.recentFacts), remainingBudget, 6, 820);
+    appendSection(sections, 'Current Work', parsed.shared.length > 0 ? parsed.shared : normalizeItems([context.recentSummary ?? '']), remainingBudget, 6, 1200);
+    appendSection(sections, 'Relevant Docs', parsed.docs, remainingBudget, 3, 420);
+}
+function appendStructuredSections(sections, context, remainingBudget) {
+    appendSection(sections, 'Focus', normalizeItems([context.focusQuery ?? '']), remainingBudget, 1, 220);
+    appendSection(sections, 'Project Profile', buildStructuredProfileItems(context.profile), remainingBudget, 5, 720);
+    appendSection(sections, 'Durable Facts', buildFactItems(context.recentFacts), remainingBudget, 6, 820);
+    appendSection(sections, 'Current Work', normalizeItems([context.recentSummary ?? '']), remainingBudget, 4, 900);
+}
+function buildStructuredProfileItems(profile) {
+    if (!profile)
+        return [];
+    return normalizeItems([
+        profile.architecture ? `Architecture: ${profile.architecture}` : '',
+        profile.stack?.length ? `Key files: ${profile.stack.join(', ')}` : '',
+        profile.currentFocus ? `Current focus: ${profile.currentFocus}` : '',
+        ...(profile.conventions ?? []).map((item) => `Convention: ${item}`),
+    ]);
+}
+function buildFactItems(facts) {
+    return normalizeItems((facts ?? []).map((fact) => `${fact.subject} ${fact.predicate} ${fact.object}`));
+}
+function appendSection(sections, title, items, remainingBudget, maxItems, sectionBudget) {
+    const normalized = normalizeItems(items).slice(0, maxItems);
+    if (normalized.length === 0 || remainingBudget.value <= 0) {
+        return;
+    }
+    const heading = `## ${title}`;
+    const lines = [heading];
+    let used = heading.length + 1;
+    const allowed = Math.min(sectionBudget, remainingBudget.value);
+    for (const item of normalized) {
+        const line = `- ${truncateLine(item, MAX_LINE_LENGTH)}`;
+        const nextCost = line.length + 1;
+        if (used + nextCost > allowed) {
+            break;
+        }
+        lines.push(line);
+        used += nextCost;
+    }
+    if (lines.length === 1) {
+        return;
+    }
+    lines.push('');
+    appendWithinBudget(sections, lines.join('\n'), remainingBudget);
+}
+function appendWithinBudget(sections, block, remainingBudget) {
+    if (!block || remainingBudget.value <= 0)
+        return;
+    const blockCost = block.length + 1;
+    if (blockCost > remainingBudget.value)
+        return;
+    sections.push(block);
+    remainingBudget.value -= blockCost;
+}
+function parseResumeSections(resume) {
+    const lines = resume.split('\n');
+    const sectionMap = new Map();
+    let current = '';
+    let currentSubheading = '';
+    let focus;
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        if (line.startsWith('# '))
+            continue;
+        if (line.startsWith('Focus:')) {
+            focus = line.slice('Focus:'.length).trim();
+            continue;
+        }
+        if (line.startsWith('## ')) {
+            current = line.slice(3).trim().toLowerCase();
+            currentSubheading = '';
+            sectionMap.set(current, sectionMap.get(current) ?? []);
+            continue;
+        }
+        if (!current)
+            continue;
+        if (!line.startsWith('-') && line.endsWith(':')) {
+            currentSubheading = line.slice(0, -1).trim();
+            continue;
+        }
+        if (line.startsWith('```'))
+            continue;
+        const cleaned = normalizeResumeLine(line, currentSubheading);
+        if (cleaned) {
+            sectionMap.get(current)?.push(cleaned);
+        }
+    }
+    return {
+        focus,
+        profile: normalizeItems(sectionMap.get('project profile') ?? []),
+        facts: normalizeItems(sectionMap.get('derived facts') ?? []),
+        shared: normalizeItems(sectionMap.get('shared memory') ?? []),
+        docs: normalizeItems(sectionMap.get('relevant docs') ?? []),
+    };
+}
+function normalizeResumeLine(line, sectionLabel) {
+    const stripped = line.replace(/^[-*]\s*/, '').trim();
+    if (!stripped)
+        return '';
+    if (sectionLabel && !stripped.toLowerCase().startsWith(`${sectionLabel.toLowerCase()}:`)) {
+        return `${sectionLabel}: ${stripped}`;
+    }
+    return stripped;
+}
+function normalizeItems(items) {
+    const unique = new Set();
+    for (const item of items) {
+        const normalized = item.replace(/\s+/g, ' ').trim();
+        if (!normalized)
+            continue;
+        unique.add(normalized);
+    }
+    return Array.from(unique);
+}
+function truncateLine(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength - 1)}…`;
+}
+//# sourceMappingURL=cursor-rules.js.map

package/dist/cursor-rules.js.map

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

package/dist/cursor-rules.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cursor-rules.test.d.ts.map

package/dist/cursor-rules.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-rules.test.d.ts","sourceRoot":"","sources":["../src/cursor-rules.test.ts"],"names":[],"mappings":""}

package/dist/cursor-rules.test.js

@@ -0,0 +1,55 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { buildCursorRulesContent, estimateCursorRulesTokens, DEFAULT_CURSOR_RULES_TOKEN_BUDGET, } from './cursor-rules.js';
+test('buildCursorRulesContent compacts oversized resume content into the token budget', () => {
+    const repeated = 'OAuth callback flow was verified, middleware was updated, and redirect handling was standardized across the dashboard and API.';
+    const hugeResume = [
+        '# Memoire Resume',
+        'Focus: fix auth redirects',
+        '',
+        '## Project Profile',
+        'The project is a shared memory backend for AI coding agents with a hosted dashboard and worker.',
+        ...Array.from({ length: 12 }, (_, index) => `- Convention ${index + 1}: ${repeated}`),
+        '',
+        '## Derived Facts',
+        'Static facts:',
+        ...Array.from({ length: 12 }, (_, index) => `- Fact ${index + 1}: ${repeated}`),
+        '',
+        '## Shared Memory',
+        ...Array.from({ length: 20 }, (_, index) => `- Active work ${index + 1}: ${repeated}`),
+        '',
+        '## Relevant Docs',
+        ...Array.from({ length: 8 }, (_, index) => `- next-auth@${index}: ${repeated}`),
+    ].join('\n');
+    const content = buildCursorRulesContent({
+        projectName: 'Memoire',
+        resumeText: hugeResume,
+        focusQuery: 'fix auth redirects',
+    });
+    assert.ok(content.includes('## Focus'));
+    assert.ok(content.includes('## Project Profile'));
+    assert.ok(content.includes('## Current Work'));
+    assert.ok(content.includes('Condensed for token efficiency'));
+    assert.ok(estimateCursorRulesTokens(content) <= DEFAULT_CURSOR_RULES_TOKEN_BUDGET);
+});
+test('buildCursorRulesContent keeps structured cursor rules bounded too', () => {
+    const content = buildCursorRulesContent({
+        projectName: 'Memoire',
+        profile: {
+            architecture: 'Hono API, Postgres, pgvector, worker, dashboard',
+            stack: Array.from({ length: 10 }, (_, i) => `apps/api/src/file-${i}.ts`),
+            conventions: Array.from({ length: 12 }, (_, i) => `Convention ${i + 1} for handling auth, API edges, and background work`),
+            currentFocus: 'Hosted onboarding, docs indexing, and cross-agent handoffs',
+        },
+        recentFacts: Array.from({ length: 12 }, (_, i) => ({
+            subject: `fact-${i + 1}`,
+            predicate: 'uses',
+            object: 'token-aware context packaging for Cursor rules',
+        })),
+        recentSummary: 'Shipped token-aware cursor rules packaging and kept the rest of the shared memory flow intact.',
+    });
+    assert.ok(content.includes('## Project Profile'));
+    assert.ok(content.includes('## Durable Facts'));
+    assert.ok(estimateCursorRulesTokens(content) <= DEFAULT_CURSOR_RULES_TOKEN_BUDGET);
+});
+//# sourceMappingURL=cursor-rules.test.js.map

package/dist/cursor-rules.test.js.map

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

package/dist/dedup.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Client-side content deduplication using a hash-based sliding window.
+ * Prevents noisy hooks from flooding the API with duplicate observations
+ * within a short time window (default 30 seconds).
+ *
+ * Mirrors claude-mem's 30-second content-hash dedup at the edge.
+ */
+export declare class ContentDedup {
+    private seen;
+    private windowMs;
+    private cleanupTimer;
+    constructor(windowMs?: number);
+    /**
+     * Returns true if content is a duplicate (already seen within the window).
+     * Returns false if content is new — and records it.
+     */
+    isDuplicate(content: string): boolean;
+    /** Remove entries older than the window */
+    private evict;
+    destroy(): void;
+}
+//# sourceMappingURL=dedup.d.ts.map

package/dist/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../src/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA6C;gBAErD,QAAQ,SAAS;IAS7B;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAarC,2CAA2C;IAC3C,OAAO,CAAC,KAAK;IASb,OAAO,IAAI,IAAI;CAOhB"}