memory-journal-mcp 8.0.1 → 9.1.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAGjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC,YAAY,EACR,SAAS,EACT,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,GAAG,EACH,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,YAAY,GACf,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGjD,OAAO,EACH,WAAW,EACX,WAAW,EACX,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,GACnB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -1,13 +1,7 @@
-export { createServer } from './chunk-V3UTFQQK.js';
-import './chunk-UHSO65A4.js';
-export { VERSION } from './chunk-JFMITANR.js';
-export { META_GROUPS, TOOL_GROUPS, calculateTokenSavings, filterTools, getAllToolNames, getFilterSummary, getToolFilterFromEnv, getToolGroup, isToolEnabled, logger, parseToolFilter } from './chunk-6OHRCNYW.js';
-
-// src/types/index.ts
-var DEFAULT_CONFIG = {
-  dbPath: "./memory_journal.db",
-  enableSemanticSearch: true,
-  modelName: "all-MiniLM-L6-v2"
-};
-
-export { DEFAULT_CONFIG };
+export { createServer } from './chunk-Y6MMKR2Z.js';
+export { DEFAULT_CONFIG, META_GROUPS, TOOL_GROUPS, calculateTokenSavings, filterTools, getAllToolNames, getFilterSummary, getToolFilterFromEnv, getToolGroup, isToolEnabled, logger, parseToolFilter } from './chunk-T7SROBBV.js';
+export { VERSION } from './chunk-SGJU2DHU.js';
+import './chunk-4FZCHFB5.js';
+import './chunk-E6IQP6PE.js';
+import './chunk-FZLB6NAV.js';
+import './chunk-D2FY6XS5.js';

package/dist/markdown/converters/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * memory-journal-mcp — External Format Converters
+ *
+ * Converters normalize third-party exports (Notion, Obsidian, Logseq) into the
+ * internal standard frontmatter format for importing.
+ */
+import type { FrontmatterData } from '../frontmatter.js';
+import { parseYamlFrontmatter } from './yaml-parser.js';
+export { parseYamlFrontmatter };
+export type SourceFormat = 'notion' | 'obsidian' | 'logseq';
+export interface ConvertedFile {
+    filename: string;
+    metadata: FrontmatterData;
+    body: string;
+}
+/**
+ * Dispatcher to convert an external file to the internal format.
+ *
+ * @param content Raw markdown string from external export
+ * @param filename Original filename
+ * @param format The source platform format
+ * @param defaultEntryType Optional fallback entry type override
+ * @returns Normalized frontmatter metadata and body
+ */
+export declare function convertFile(content: string, filename: string, format: SourceFormat, defaultEntryType?: string): ConvertedFile;
+//# sourceMappingURL=index.d.ts.map

package/dist/markdown/converters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/markdown/converters/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAIxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAEvD,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAE/B,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAA;AAE3D,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,eAAe,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACvB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,gBAAgB,CAAC,EAAE,MAAM,GAC1B,aAAa,CAWf"}

package/dist/markdown/converters/logseq.d.ts

@@ -0,0 +1,14 @@
+/**
+ * memory-journal-mcp — Logseq Converter
+ *
+ * Normalizes Logseq markdown exports.
+ * Features:
+ * - Parses YAML frontmatter
+ * - Flattens block hierarchy (`- ` bullets) to paragraph-style with indent context
+ * - Strips `[[page refs]]` to plain text
+ * - Extracts `#tags` and `key:: value` inline properties
+ * - Normalizes task markers (`TODO`, `DONE`)
+ */
+import type { ConvertedFile } from './index.js';
+export declare function convertLogseq(content: string, filename: string, defaultEntryType?: string): ConvertedFile;
+//# sourceMappingURL=logseq.d.ts.map

package/dist/markdown/converters/logseq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logseq.d.ts","sourceRoot":"","sources":["../../../src/markdown/converters/logseq.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAK/C,wBAAgB,aAAa,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GAC1B,aAAa,CAkGf"}

package/dist/markdown/converters/notion.d.ts

@@ -0,0 +1,14 @@
+/**
+ * memory-journal-mcp — Notion Converter
+ *
+ * Normalizes Notion markdown exports.
+ * Features:
+ * - No frontmatter parsing (Notion exports are plain MD)
+ * - Derives tags from the directory hierarchy
+ * - Preserves Notion callouts as markdown blockquotes
+ * - Strips Notion internal file links to plain text
+ * - Shifts the H1 title into a body prefix if needed
+ */
+import type { ConvertedFile } from './index.js';
+export declare function convertNotion(content: string, filename: string, defaultEntryType?: string): ConvertedFile;
+//# sourceMappingURL=notion.d.ts.map

package/dist/markdown/converters/notion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion.d.ts","sourceRoot":"","sources":["../../../src/markdown/converters/notion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI/C,wBAAgB,aAAa,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GAC1B,aAAa,CAqEf"}

package/dist/markdown/converters/obsidian.d.ts

@@ -0,0 +1,14 @@
+/**
+ * memory-journal-mcp — Obsidian Converter
+ *
+ * Normalizes Obsidian markdown exports.
+ * Features:
+ * - Parses YAML frontmatter
+ * - Strips `[[wikilinks]]` to plain text
+ * - Converts `![[embeds]]` to blockquotes
+ * - Extracts inline `#tags`
+ * - Heuristics for `standup` (daily notes) vs `other`
+ */
+import type { ConvertedFile } from './index.js';
+export declare function convertObsidian(content: string, filename: string, defaultEntryType?: string): ConvertedFile;
+//# sourceMappingURL=obsidian.d.ts.map

package/dist/markdown/converters/obsidian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian.d.ts","sourceRoot":"","sources":["../../../src/markdown/converters/obsidian.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAK/C,wBAAgB,eAAe,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GAC1B,aAAa,CA+Df"}

package/dist/markdown/converters/utils.d.ts

@@ -0,0 +1,4 @@
+export declare function extractTags(yamlMeta: Record<string, unknown>, mergedTags: Set<string>, aliasKey?: string): void;
+export declare function formatToISODate(dateStr: string): string;
+export declare function getFirstString(yamlMeta: Record<string, unknown>, keys: string[]): string | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/dist/markdown/converters/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/markdown/converters/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,SAAY,GAAG,IAAI,CAgBlH;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAMpG"}

package/dist/markdown/converters/yaml-parser.d.ts

@@ -0,0 +1,32 @@
+/**
+ * memory-journal-mcp — Minimal YAML Frontmatter Parser
+ *
+ * Provides a minimal, zero-dependency YAML frontmatter parser for the external
+ * importers (Obsidian, Logseq). Only supports the simple subset of YAML needed
+ * for metadata extraction (scalars and simple arrays).
+ *
+ * This avoids introducing heavy dependencies like js-yaml, adhering to the
+ * established pattern of zero-dependency parsers for better supply chain security.
+ */
+/** Structure of extracted YAML frontmatter */
+export type FrontmatterData = Record<string, string | string[]>;
+/** Result of parsing a file with YAML frontmatter */
+export interface YamlParseResult {
+    metadata: FrontmatterData;
+    body: string;
+}
+/**
+ * Extract and minimally parse YAML frontmatter from a markdown string.
+ *
+ * Handles:
+ * - key: value
+ * - key: [item1, item2]
+ * - key:
+ *     - item1
+ *     - item2
+ *
+ * @param content Full markdown content
+ * @returns Parsed frontmatter and remaining body text
+ */
+export declare function parseYamlFrontmatter(content: string): YamlParseResult;
+//# sourceMappingURL=yaml-parser.d.ts.map

package/dist/markdown/converters/yaml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-parser.d.ts","sourceRoot":"","sources":["../../../src/markdown/converters/yaml-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAEhE,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,eAAe,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAqFrE"}

package/dist/markdown/exporter.d.ts

@@ -0,0 +1,54 @@
+/**
+ * memory-journal-mcp — Markdown Exporter
+ *
+ * Converts journal entries to frontmattered `.md` files.
+ * Deterministic filenames allow re-export to overwrite identically.
+ */
+import type { IDatabaseAdapter } from '../database/core/interfaces.js';
+/** Entry shape from database query results */
+export interface ExportableEntry {
+    id: number;
+    content: string;
+    entryType: string;
+    timestamp: string;
+    tags: string[];
+    significance?: string;
+    author?: string;
+}
+/** Result of an export operation */
+export interface ExportResult {
+    success: boolean;
+    exported_count: number;
+    output_dir: string;
+    files: string[];
+    skipped: number;
+}
+/**
+ * Generate a URL-safe slug from content text.
+ *
+ * - Takes first 50 characters
+ * - Lowercases, replaces non-alphanumeric with dashes
+ * - Trims leading/trailing dashes, collapses multiple dashes
+ * - Falls back to 'untitled' for empty content
+ */
+export declare function generateSlug(content: string): string;
+/**
+ * Generate a deterministic filename for an entry.
+ * Format: `{id}-{slug}.md`
+ */
+export declare function generateFilename(id: number, content: string): string;
+/**
+ * Export journal entries to frontmattered markdown files.
+ *
+ * - Creates output directory if it doesn't exist
+ * - Writes one `.md` file per entry
+ * - Deterministic filenames allow re-export without duplication
+ * - Fetches relationships per entry for frontmatter inclusion
+ *
+ * @param entries - Entries to export
+ * @param outputDir - Target directory for `.md` files
+ * @param db - Database adapter for relationship lookups
+ * @returns Export result with file list and counts
+ */
+export declare function exportEntriesToMarkdown(entries: ExportableEntry[], outputDir: string, db: IDatabaseAdapter, allowedRoots: string[]): Promise<ExportResult>;
+//# sourceMappingURL=exporter.d.ts.map

package/dist/markdown/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../src/markdown/exporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAWtE,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,oCAAoC;AACpC,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAClB;AAMD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,eAAe,EAAE,EAC1B,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,gBAAgB,EACpB,YAAY,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,YAAY,CAAC,CA6IvB"}

package/dist/markdown/frontmatter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * memory-journal-mcp — Frontmatter Parser & Serializer
+ *
+ * Hand-rolled YAML frontmatter parser (~100 lines) for zero-dependency
+ * markdown interoperability. Supports scalar values, string arrays,
+ * and object arrays (for relationships).
+ *
+ * Design rationale: Avoids adding a YAML parsing dependency (js-yaml,
+ * yaml, etc.) to keep supply-chain surface minimal. The subset of YAML
+ * used by MJ frontmatter is simple enough to parse with line splitting.
+ */
+/** Parsed frontmatter data structure */
+export interface FrontmatterData {
+    mj_id?: number;
+    entry_type?: string;
+    author?: string;
+    tags?: string[];
+    timestamp?: string;
+    significance?: string;
+    relationships?: {
+        type: string;
+        target_id: number;
+    }[];
+    source?: string;
+}
+/** Result of parsing a frontmattered markdown file */
+export interface ParseResult {
+    metadata: FrontmatterData;
+    body: string;
+}
+/**
+ * Serialize frontmatter data into a JSON frontmatter block.
+ * Output: `---\n{\n  "key": "value"\n}\n---\n`
+ */
+export declare function serializeFrontmatter(data: FrontmatterData | null | undefined): string;
+/**
+ * Parse a markdown file with YAML frontmatter.
+ *
+ * - First line must be `---`
+ * - Frontmatter ends at the next `---` line
+ * - Supports: scalar values, string arrays (`- item`), relationship objects
+ * - Returns validated metadata + body content
+ *
+ * @throws Error if frontmatter is malformed or fails validation
+ */
+export declare function parseFrontmatter(content: string): ParseResult;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/markdown/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/markdown/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,eAAe,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;CACf;AA6BD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAkBrF;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAsD7D"}

package/dist/markdown/importer.d.ts

@@ -0,0 +1,81 @@
+/**
+ * memory-journal-mcp — Markdown Importer
+ *
+ * Reads frontmattered `.md` files from a directory and upserts them
+ * into the journal database. Supports create, update, tag reconciliation,
+ * relationship linking, and dry-run mode.
+ */
+import type { IDatabaseAdapter } from '../database/core/interfaces.js';
+import type { VectorSearchManager } from '../vector/vector-search-manager/index.js';
+/** Options for the import operation */
+export interface ImportOptions {
+    /** Parse and validate without writing to database */
+    dry_run?: boolean;
+    /** Maximum files to process */
+    limit?: number;
+    /** Author name for new entries (team journal) */
+    author?: string;
+    /** Associate imported entries with a specific GitHub project number */
+    project_number?: number;
+    /** Workspace isolation identifier */
+    workspaceId?: string;
+}
+/** Result of an import operation */
+export interface ImportResult {
+    success: boolean;
+    created: number;
+    updated: number;
+    skipped: number;
+    relationshipsLinked: number;
+    vectorsIndexed: number;
+    errors: {
+        file: string;
+        error: string;
+    }[];
+    dry_run: boolean;
+}
+/**
+ * Import markdown files from a directory into the journal database.
+ *
+ * Upsert semantics:
+ * - If frontmatter has `mj_id` AND entry exists → UPDATE
+ * - If frontmatter has `mj_id` BUT entry not found → CREATE (DB assigns ID)
+ * - If no `mj_id` in frontmatter → CREATE
+ *
+ * Post-import processing:
+ * - Tags included in createEntry/updateEntry calls
+ * - Relationship linking where targets exist
+ * - Vector re-indexing (fire-and-forget)
+ *
+ * @param sourceDir - Directory containing `.md` files
+ * @param db - Database adapter for entry operations
+ * @param options - Import options (dry_run, limit, author)
+ * @param vectorManager - Optional vector search manager for re-indexing
+ * @returns Import result with counts and errors
+ */
+export interface ParsedFile {
+    filename: string;
+    body: string;
+    metadata: {
+        mj_id?: number;
+        entry_type?: string;
+        tags?: string[];
+        significance?: string;
+        relationships?: {
+            type: string;
+            target_id: number;
+        }[];
+    };
+}
+export declare function importMarkdownEntries(sourceDir: string, db: IDatabaseAdapter, options: ImportOptions | undefined, vectorManager: VectorSearchManager | undefined, allowedRoots: string[]): Promise<ImportResult>;
+/**
+ * Process a batch of parsed markdown files and upsert them into the database.
+ *
+ * @param parsedFiles Files to import
+ * @param db Database adapter
+ * @param options Import options
+ * @param vectorManager Optional vector search manager
+ * @returns Import result with counts and errors
+ */
+export declare function processImportBatch(parsedFiles: ParsedFile[], db: IDatabaseAdapter, options: ImportOptions | undefined, vectorManager: VectorSearchManager | undefined): Promise<ImportResult>;
+//# sourceMappingURL=importer.d.ts.map

package/dist/markdown/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../src/markdown/importer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAA;AAUnF,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC1B,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,oCAAoC;AACpC,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,mBAAmB,EAAE,MAAM,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzC,OAAO,EAAE,OAAO,CAAA;CACnB;AAyBD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;QACf,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,aAAa,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KACxD,CAAA;CACJ;AACD,wBAAsB,qBAAqB,CACvC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,gBAAgB,EACpB,OAAO,EAAE,aAAa,YAAK,EAC3B,aAAa,EAAE,mBAAmB,GAAG,SAAS,EAC9C,YAAY,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,YAAY,CAAC,CAqGvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACpC,WAAW,EAAE,UAAU,EAAE,EACzB,EAAE,EAAE,gBAAgB,EACpB,OAAO,EAAE,aAAa,YAAK,EAC3B,aAAa,EAAE,mBAAmB,GAAG,SAAS,GAC/C,OAAO,CAAC,YAAY,CAAC,CA8IvB"}

package/dist/markdown/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * memory-journal-mcp — Markdown Interoperability Module
+ *
+ * Barrel re-export for frontmatter parsing, markdown export, and import.
+ */
+export { parseFrontmatter, serializeFrontmatter } from './frontmatter.js';
+export type { FrontmatterData, ParseResult } from './frontmatter.js';
+export { exportEntriesToMarkdown, generateSlug, generateFilename } from './exporter.js';
+export type { ExportableEntry, ExportResult } from './exporter.js';
+export { importMarkdownEntries, processImportBatch } from './importer.js';
+export type { ImportOptions, ImportResult, ParsedFile } from './importer.js';
+export { convertFile } from './converters/index.js';
+export type { SourceFormat, ConvertedFile } from './converters/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACzE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEpE,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACvF,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAElE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACzE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/observability/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Observability Module Barrel
+ *
+ * Re-exports all observability sub-modules:
+ *   - token-estimator: byte-length heuristic for token counting
+ *   - metrics: in-memory Map-based accumulator + singleton
+ *   - interceptor: metrics-collecting tool handler wrapper
+ *   - latency-tracker: per-tool sliding-window percentile tracker
+ */
+export { estimateTokens, estimatePayloadTokens, injectTokenEstimate, detectContentType, } from './token-estimator.js';
+export type { ContentType } from './token-estimator.js';
+export { MetricsAccumulator } from './metrics.js';
+export type { ToolMetrics, MetricsSummary, SystemMetrics } from './metrics.js';
+export { wrapWithMetrics } from './interceptor.js';
+export type { ToolHandlerFn } from './interceptor.js';
+export { LatencyTracker } from './latency-tracker.js';
+export type { LatencyPercentiles } from './latency-tracker.js';
+export { formatPrometheusMetrics } from './prometheus-formatter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACH,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GACpB,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE9E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/observability/interceptor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Metrics Interceptor
+ *
+ * Wraps a tool handler invocation to capture:
+ *   - Wall-clock duration (using performance.now())
+ *   - Input token estimate (from serialized args)
+ *   - Output token estimate (from serialized result)
+ *   - Error detection ({success: false} shape or thrown exceptions)
+ *
+ * Design rules:
+ *   - NEVER throws — all interceptor errors are swallowed silently
+ *   - ALWAYS returns the original handler result unchanged
+ *   - Does NOT mutate the result (token injection happens separately in callTool)
+ */
+import type { MetricsAccumulator } from './metrics.js';
+/** Handler function signature that the interceptor wraps */
+export type ToolHandlerFn = (args: Record<string, unknown>) => Promise<unknown>;
+/**
+ * Wrap a tool handler with metrics collection.
+ *
+ * @param toolName  - Name of the tool being intercepted
+ * @param handler   - The original tool handler function
+ * @param accumulator - The MetricsAccumulator to record into
+ * @returns A new async function with identical signature that records metrics
+ */
+export declare function wrapWithMetrics(toolName: string, handler: ToolHandlerFn, accumulator: MetricsAccumulator): ToolHandlerFn;
+//# sourceMappingURL=interceptor.d.ts.map

package/dist/observability/interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/observability/interceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAQtD,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAoB/E;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,kBAAkB,GAChC,aAAa,CAkEf"}

package/dist/observability/latency-tracker.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Latency Tracker
+ *
+ * Per-tool sliding-window latency percentile tracker.
+ * Uses a zero-dependency sorted-insert algorithm with bounded memory.
+ *
+ * Design:
+ *   - One sorted number[] per tool name for O(1) percentile lookup
+ *   - One parallel insertion-order number[] per tool for FIFO eviction
+ *   - Binary-search insert: O(log n) per record
+ *   - Configurable max samples per tool (default: 1000)
+ *   - Nearest-rank percentile method (industry standard)
+ */
+export interface LatencyPercentiles {
+    toolName: string;
+    count: number;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    minMs: number;
+    maxMs: number;
+}
+export declare class LatencyTracker {
+    private readonly data;
+    private readonly maxSamplesPerTool;
+    constructor(maxSamplesPerTool?: number);
+    /**
+     * Record a latency sample for a tool.
+     */
+    record(toolName: string, durationMs: number): void;
+    /**
+     * Compute the p-th percentile for a tool using nearest-rank method.
+     * @param toolName - Tool to query
+     * @param p - Percentile as a fraction (0.50, 0.95, 0.99)
+     * @returns The percentile value, or 0 if no data
+     */
+    getPercentile(toolName: string, p: number): number;
+    /**
+     * Get latency summary for all tracked tools, sorted by p99 descending.
+     */
+    getLatencySummary(): LatencyPercentiles[];
+    /**
+     * Reset all tracked data (primarily for tests).
+     */
+    reset(): void;
+}
+//# sourceMappingURL=latency-tracker.d.ts.map

package/dist/observability/latency-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-tracker.d.ts","sourceRoot":"","sources":["../../src/observability/latency-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CAChB;AAqED,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;gBAE9B,iBAAiB,SAAO;IAIpC;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA2BlD;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAUlD;;OAEG;IACH,iBAAiB,IAAI,kBAAkB,EAAE;IAqBzC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGhB"}

package/dist/observability/metrics-server.d.ts

@@ -0,0 +1,3 @@
+import type { ServerRuntime } from '../utils/maintenance-lock.js';
+export declare function startMetricsServer(runtime: ServerRuntime, metricsPort?: number): () => Promise<void>;
+//# sourceMappingURL=metrics-server.d.ts.map

package/dist/observability/metrics-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-server.d.ts","sourceRoot":"","sources":["../../src/observability/metrics-server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAoDpG"}

package/dist/observability/metrics.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Metrics Accumulator
+ *
+ * In-memory, Map-based accumulator for tool call telemetry.
+ * No external dependencies. Exposes a singleton `globalMetrics` instance
+ * that the interceptor and resource handlers share.
+ *
+ * Per-tool data collected:
+ *   - callCount      — total invocations
+ *   - errorCount     — invocations that returned {success: false} or threw
+ *   - totalDurationMs — sum of wall-clock durations
+ *   - totalInputTokens — sum of estimated input token counts
+ *   - totalOutputTokens — sum of estimated output token counts
+ *   - lastCalledAt   — ISO timestamp of most recent call
+ *   - latency percentiles (p50/p95/p99) via LatencyTracker
+ */
+import type { LatencyPercentiles } from './latency-tracker.js';
+export interface ToolMetrics {
+    callCount: number;
+    errorCount: number;
+    totalDurationMs: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    lastCalledAt: string | null;
+}
+export interface ResourceMetrics {
+    readCount: number;
+    errorCount: number;
+    lastReadAt: string | null;
+}
+export interface MetricsSummary {
+    totalCalls: number;
+    totalErrors: number;
+    totalDurationMs: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalResourceReads: number;
+    upSince: string;
+    toolBreakdown: Record<string, ToolMetrics>;
+    resourceBreakdown: Record<string, ResourceMetrics>;
+}
+export interface SystemMetrics {
+    upSince: string;
+    uptimeSeconds: number;
+    processMemoryMb: number;
+    nodeVersion: string;
+    platform: string;
+}
+export declare class MetricsAccumulator {
+    private readonly toolData;
+    private readonly resourceData;
+    private readonly deprecationWarnings;
+    private readonly latencyTracker;
+    readonly upSince: string;
+    private readonly startTime;
+    constructor(maxLatencySamplesPerTool?: number);
+    /**
+     * Record a deprecation warning to be surfaced in the briefing.
+     */
+    recordDeprecationWarning(warning: string): void;
+    /**
+     * Retrieve active deprecation warnings.
+     */
+    getDeprecationWarnings(): string[];
+    /**
+     * Record a single tool invocation result.
+     */
+    record(opts: {
+        toolName: string;
+        durationMs: number;
+        inputTokens: number;
+        outputTokens: number;
+        isError: boolean;
+    }): void;
+    /**
+     * Record a single resource read.
+     */
+    recordResourceRead(uri: string, isError?: boolean): void;
+    /**
+     * Aggregate summary across all recorded tools and resources.
+     */
+    getSummary(): MetricsSummary;
+    /**
+     * Per-tool token usage breakdown, sorted by total output tokens desc.
+     */
+    getTokenBreakdown(): {
+        toolName: string;
+        inputTokens: number;
+        outputTokens: number;
+        callCount: number;
+        avgOutputTokens: number;
+    }[];
+    /**
+     * Per-resource read frequency breakdown, sorted by total reads desc.
+     */
+    getResourceBreakdown(): {
+        uri: string;
+        readCount: number;
+        errorCount: number;
+        lastReadAt: string | null;
+    }[];
+    /**
+     * Per-user call counts, sourced from a user tag injected by the interceptor.
+     * When no user tracking is configured this returns an empty breakdown.
+     */
+    getUserBreakdown(): Record<string, number>;
+    private readonly userCounts;
+    /**
+     * Per-tool latency percentile summary, sorted by p99 descending.
+     */
+    getLatencySummary(): LatencyPercentiles[];
+    recordUser(user: string): void;
+    /**
+     * System-level metrics snapshot.
+     */
+    getSystemMetrics(): SystemMetrics;
+    /**
+     * Reset all accumulated data (primarily useful in tests).
+     */
+    reset(): void;
+    /**
+     * Export the current metrics state as a JSON string.
+     */
+    exportState(): string;
+    /**
+     * Import metrics state from a JSON string, merging with current state.
+     */
+    importState(jsonState: string): void;
+    /**
+     * Save metrics to a file asynchronously.
+     */
+    saveToFile(path: string): Promise<void>;
+    /**
+     * Load metrics from a file asynchronously.
+     */
+    loadFromFile(path: string): Promise<void>;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observability/metrics.d.ts.map

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