minimem 0.0.4 → 0.0.6

package/dist/session.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session.ts"],"sourcesContent":["/**\n * Session tracking for memory entries\n *\n * Captures context about the originating session (Claude Code, VS Code, etc.)\n * and stores it as YAML frontmatter in memory files.\n */\n\nimport * as os from \"node:os\";\n\n/**\n * Session metadata for memory entries\n */\nexport type SessionContext = {\n  /** Session identifier (e.g., Claude Code session ID) */\n  id?: string;\n  /** Source application (claude-code, vscode, cursor, etc.) */\n  source?: string;\n  /** Project directory path */\n  project?: string;\n  /** Path to session transcript/log file */\n  transcript?: string;\n};\n\n/**\n * Source provenance for a knowledge entry\n */\nexport type KnowledgeSource = {\n  origin?: string;\n  trajectories?: string[];\n  agentId?: string;\n};\n\n/**\n * A directional link from this entry to another knowledge node\n */\nexport type KnowledgeLink = {\n  target: string;\n  relation: string;\n  layer?: string;\n};\n\n/**\n * Frontmatter structure for memory files\n */\nexport type MemoryFrontmatter = {\n  session?: SessionContext;\n  created?: string;\n  updated?: string;\n  tags?: string[];\n  /** Knowledge node identifier */\n  id?: string;\n  /** Knowledge entry type */\n  type?: \"observation\" | \"entity\" | \"domain-summary\" | string;\n  /** Domain tags for this knowledge entry */\n  domain?: string[];\n  /** Entity references in this knowledge entry */\n  entities?: string[];\n  /** Confidence score 0-1 */\n  confidence?: number;\n  /** Source provenance */\n  source?: KnowledgeSource;\n  /** Links to other knowledge nodes */\n  links?: KnowledgeLink[];\n  /** ID of the entry this supersedes */\n  supersedes?: string | null;\n};\n\n/**\n * Parse YAML frontmatter from content\n *\n * Frontmatter is delimited by --- at the start and end:\n * ```\n * ---\n * session:\n *   id: abc123\n *   source: claude-code\n * created: 2024-01-27T14:30:00Z\n * ---\n * Actual content here...\n * ```\n */\nexport function parseFrontmatter(content: string): {\n  frontmatter: MemoryFrontmatter | undefined;\n  body: string;\n} {\n  const frontmatterRegex = /^---\\n([\\s\\S]*?)\\n---\\n/;\n  const match = content.match(frontmatterRegex);\n\n  if (!match) {\n    return { frontmatter: undefined, body: content };\n  }\n\n  const yamlContent = match[1];\n  const body = content.slice(match[0].length);\n\n  try {\n    const frontmatter = parseSimpleYaml(yamlContent);\n    return { frontmatter, body };\n  } catch {\n    // If parsing fails, treat as no frontmatter\n    return { frontmatter: undefined, body: content };\n  }\n}\n\n/**\n * Simple YAML parser for frontmatter.\n *\n * **Limitations** (by design — keeps the dependency count at zero):\n * - Does not handle multi-line strings (block scalars `|` / `>`)\n * - Does not preserve comments\n * - Keys must be simple `\\w+` identifiers (no quoted or special-char keys)\n *\n * Supports:\n * - Multi-level nesting (objects within objects)\n * - Inline arrays `[a, b]`\n * - YAML list items with `- ` syntax (including `- {key: val}` objects)\n * - Null values via `~` or `null`\n */\nfunction parseSimpleYaml(yaml: string): MemoryFrontmatter {\n  const lines = yaml.split(\"\\n\");\n  return parseYamlBlock(lines, 0, 0, lines.length).value as MemoryFrontmatter;\n}\n\n/**\n * Parse a block of YAML lines at a given indentation level into an object.\n * Returns the parsed value and the line index where parsing stopped.\n */\nfunction parseYamlBlock(\n  lines: string[],\n  indent: number,\n  startIdx: number,\n  endIdx: number,\n): { value: Record<string, unknown>; nextIdx: number } {\n  const result: Record<string, unknown> = {};\n  let i = startIdx;\n\n  while (i < endIdx) {\n    const line = lines[i];\n    if (!line || !line.trim()) {\n      i++;\n      continue;\n    }\n\n    const lineIndent = getIndent(line);\n    // If we've dedented back beyond our level, stop\n    if (lineIndent < indent) break;\n    // Skip lines indented deeper than expected (shouldn't happen at top of block)\n    if (lineIndent > indent) {\n      i++;\n      continue;\n    }\n\n    // Match a key: value line\n    const keyMatch = line.match(/^(\\s*)([\\w-]+):\\s*(.*)?$/);\n    if (!keyMatch) {\n      i++;\n      continue;\n    }\n\n    const [, , key, rawValue] = keyMatch;\n    const value = rawValue?.trim() ?? \"\";\n\n    if (value === \"\" || value === undefined) {\n      // Could be an object or a list starting on next lines\n      const nextNonEmpty = findNextNonEmptyLine(lines, i + 1, endIdx);\n      if (nextNonEmpty < endIdx) {\n        const nextLine = lines[nextNonEmpty]!;\n        const nextIndent = getIndent(nextLine);\n        if (nextIndent > indent) {\n          // Check if it's a list (starts with \"- \")\n          if (nextLine.trimStart().startsWith(\"- \")) {\n            const listResult = parseYamlList(lines, nextIndent, i + 1, endIdx);\n            result[key] = listResult.value;\n            i = listResult.nextIdx;\n          } else {\n            // Nested object\n            const blockResult = parseYamlBlock(lines, nextIndent, i + 1, endIdx);\n            result[key] = blockResult.value;\n            i = blockResult.nextIdx;\n          }\n          continue;\n        }\n      }\n      // Empty value, no nested content\n      result[key] = null;\n      i++;\n    } else {\n      result[key] = parseYamlValue(value);\n      i++;\n    }\n  }\n\n  return { value: result, nextIdx: i };\n}\n\n/**\n * Parse a YAML list (lines starting with \"- \") at a given indentation level.\n */\nfunction parseYamlList(\n  lines: string[],\n  indent: number,\n  startIdx: number,\n  endIdx: number,\n): { value: unknown[]; nextIdx: number } {\n  const result: unknown[] = [];\n  let i = startIdx;\n\n  while (i < endIdx) {\n    const line = lines[i];\n    if (!line || !line.trim()) {\n      i++;\n      continue;\n    }\n\n    const lineIndent = getIndent(line);\n    if (lineIndent < indent) break;\n    if (lineIndent > indent) {\n      i++;\n      continue;\n    }\n\n    const trimmed = line.trimStart();\n    if (!trimmed.startsWith(\"- \")) break;\n\n    // Get content after \"- \"\n    const itemContent = trimmed.slice(2).trim();\n\n    if (itemContent === \"\" || itemContent === undefined) {\n      // Sub-block under this list item\n      const nextNonEmpty = findNextNonEmptyLine(lines, i + 1, endIdx);\n      if (nextNonEmpty < endIdx) {\n        const nextIndent = getIndent(lines[nextNonEmpty]!);\n        if (nextIndent > indent) {\n          const blockResult = parseYamlBlock(lines, nextIndent, i + 1, endIdx);\n          result.push(blockResult.value);\n          i = blockResult.nextIdx;\n          continue;\n        }\n      }\n      result.push(null);\n      i++;\n    } else {\n      // Check for inline key: value (object item like \"- target: foo\")\n      const kvMatch = itemContent.match(/^([\\w-]+):\\s*(.*)$/);\n      if (kvMatch) {\n        // This list item is an object — collect all keys at this item's indent + 2\n        const obj: Record<string, unknown> = {};\n        const [, firstKey, firstVal] = kvMatch;\n        obj[firstKey] = parseYamlValue(firstVal?.trim() ?? \"\");\n\n        // Look for continuation keys indented further\n        const itemKeyIndent = indent + 2;\n        let j = i + 1;\n        while (j < endIdx) {\n          const nextLine = lines[j];\n          if (!nextLine || !nextLine.trim()) {\n            j++;\n            continue;\n          }\n          const nextLineIndent = getIndent(nextLine);\n          if (nextLineIndent < itemKeyIndent) break;\n          if (nextLineIndent === itemKeyIndent) {\n            const nextKv = nextLine.match(/^\\s*([\\w-]+):\\s*(.*)$/);\n            if (nextKv) {\n              const [, nk, nv] = nextKv;\n              obj[nk] = parseYamlValue(nv?.trim() ?? \"\");\n              j++;\n              continue;\n            }\n          }\n          break;\n        }\n        result.push(obj);\n        i = j;\n      } else {\n        result.push(parseYamlValue(itemContent));\n        i++;\n      }\n    }\n  }\n\n  return { value: result, nextIdx: i };\n}\n\nfunction getIndent(line: string): number {\n  const match = line.match(/^(\\s*)/);\n  return match ? match[1].length : 0;\n}\n\nfunction findNextNonEmptyLine(lines: string[], from: number, end: number): number {\n  for (let i = from; i < end; i++) {\n    if (lines[i]?.trim()) return i;\n  }\n  return end;\n}\n\n/**\n * Parse a YAML value (handles strings, numbers, booleans, null, arrays)\n */\nfunction parseYamlValue(value: string): unknown {\n  // Empty string\n  if (value === \"\") return null;\n\n  // Remove quotes if present\n  if ((value.startsWith('\"') && value.endsWith('\"')) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\"))) {\n    return value.slice(1, -1);\n  }\n\n  // Null\n  if (value === \"null\" || value === \"~\") return null;\n\n  // Boolean\n  if (value === \"true\") return true;\n  if (value === \"false\") return false;\n\n  // Number\n  const num = Number(value);\n  if (!isNaN(num) && value !== \"\") return num;\n\n  // Array (simple inline format)\n  if (value.startsWith(\"[\") && value.endsWith(\"]\")) {\n    const inner = value.slice(1, -1);\n    if (inner.trim() === \"\") return [];\n    return inner.split(\",\").map((s) => parseYamlValue(s.trim()));\n  }\n\n  // String\n  return value;\n}\n\n/**\n * Serialize frontmatter to YAML string\n */\nexport function serializeFrontmatter(frontmatter: MemoryFrontmatter): string {\n  const lines: string[] = [\"---\"];\n\n  if (frontmatter.id) {\n    lines.push(`id: ${frontmatter.id}`);\n  }\n\n  if (frontmatter.type) {\n    lines.push(`type: ${frontmatter.type}`);\n  }\n\n  if (frontmatter.session) {\n    lines.push(\"session:\");\n    const session = frontmatter.session;\n    if (session.id) lines.push(`  id: ${session.id}`);\n    if (session.source) lines.push(`  source: ${session.source}`);\n    if (session.project) lines.push(`  project: ${formatPath(session.project)}`);\n    if (session.transcript) lines.push(`  transcript: ${formatPath(session.transcript)}`);\n  }\n\n  if (frontmatter.created) {\n    lines.push(`created: ${frontmatter.created}`);\n  }\n\n  if (frontmatter.updated) {\n    lines.push(`updated: ${frontmatter.updated}`);\n  }\n\n  if (frontmatter.tags && frontmatter.tags.length > 0) {\n    lines.push(`tags: [${frontmatter.tags.join(\", \")}]`);\n  }\n\n  if (frontmatter.domain && frontmatter.domain.length > 0) {\n    lines.push(`domain: [${frontmatter.domain.join(\", \")}]`);\n  }\n\n  if (frontmatter.entities && frontmatter.entities.length > 0) {\n    lines.push(`entities: [${frontmatter.entities.join(\", \")}]`);\n  }\n\n  if (frontmatter.confidence !== undefined) {\n    lines.push(`confidence: ${frontmatter.confidence}`);\n  }\n\n  if (frontmatter.source) {\n    lines.push(\"source:\");\n    if (frontmatter.source.origin) lines.push(`  origin: ${frontmatter.source.origin}`);\n    if (frontmatter.source.trajectories && frontmatter.source.trajectories.length > 0) {\n      lines.push(`  trajectories: [${frontmatter.source.trajectories.join(\", \")}]`);\n    }\n    if (frontmatter.source.agentId) lines.push(`  agentId: ${frontmatter.source.agentId}`);\n  }\n\n  if (frontmatter.links && frontmatter.links.length > 0) {\n    lines.push(\"links:\");\n    for (const link of frontmatter.links) {\n      lines.push(`  - target: ${link.target}`);\n      lines.push(`    relation: ${link.relation}`);\n      if (link.layer) lines.push(`    layer: ${link.layer}`);\n    }\n  }\n\n  if (frontmatter.supersedes !== undefined) {\n    lines.push(`supersedes: ${frontmatter.supersedes === null ? \"~\" : frontmatter.supersedes}`);\n  }\n\n  lines.push(\"---\");\n  return lines.join(\"\\n\") + \"\\n\";\n}\n\n/**\n * Add or update frontmatter in content\n */\nexport function addFrontmatter(\n  content: string,\n  frontmatter: MemoryFrontmatter,\n): string {\n  const { frontmatter: existing, body } = parseFrontmatter(content);\n\n  // Merge with existing frontmatter\n  const merged: MemoryFrontmatter = {\n    ...existing,\n    ...frontmatter,\n    session: {\n      ...existing?.session,\n      ...frontmatter.session,\n    },\n  };\n\n  // Update timestamp\n  if (!merged.created) {\n    merged.created = new Date().toISOString();\n  }\n  merged.updated = new Date().toISOString();\n\n  return serializeFrontmatter(merged) + body;\n}\n\n/**\n * Add session context as frontmatter to content\n */\nexport function addSessionToContent(\n  content: string,\n  session: SessionContext,\n): string {\n  return addFrontmatter(content, { session });\n}\n\n/**\n * Format path for display (use ~ for home directory)\n */\nfunction formatPath(filePath: string): string {\n  const home = os.homedir();\n  if (filePath.startsWith(home)) {\n    return \"~\" + filePath.slice(home.length);\n  }\n  return filePath;\n}\n\n/**\n * Extract session context from file content\n */\nexport function extractSession(content: string): SessionContext | undefined {\n  const { frontmatter } = parseFrontmatter(content);\n  return frontmatter?.session;\n}\n"],"mappings":"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","names":[]}

package/dist/session.d.cts

@@ -0,0 +1,96 @@
+/**
+ * Session tracking for memory entries
+ *
+ * Captures context about the originating session (Claude Code, VS Code, etc.)
+ * and stores it as YAML frontmatter in memory files.
+ */
+/**
+ * Session metadata for memory entries
+ */
+type SessionContext = {
+    /** Session identifier (e.g., Claude Code session ID) */
+    id?: string;
+    /** Source application (claude-code, vscode, cursor, etc.) */
+    source?: string;
+    /** Project directory path */
+    project?: string;
+    /** Path to session transcript/log file */
+    transcript?: string;
+};
+/**
+ * Source provenance for a knowledge entry
+ */
+type KnowledgeSource = {
+    origin?: string;
+    trajectories?: string[];
+    agentId?: string;
+};
+/**
+ * A directional link from this entry to another knowledge node
+ */
+type KnowledgeLink = {
+    target: string;
+    relation: string;
+    layer?: string;
+};
+/**
+ * Frontmatter structure for memory files
+ */
+type MemoryFrontmatter = {
+    session?: SessionContext;
+    created?: string;
+    updated?: string;
+    tags?: string[];
+    /** Knowledge node identifier */
+    id?: string;
+    /** Knowledge entry type */
+    type?: "observation" | "entity" | "domain-summary" | string;
+    /** Domain tags for this knowledge entry */
+    domain?: string[];
+    /** Entity references in this knowledge entry */
+    entities?: string[];
+    /** Confidence score 0-1 */
+    confidence?: number;
+    /** Source provenance */
+    source?: KnowledgeSource;
+    /** Links to other knowledge nodes */
+    links?: KnowledgeLink[];
+    /** ID of the entry this supersedes */
+    supersedes?: string | null;
+};
+/**
+ * Parse YAML frontmatter from content
+ *
+ * Frontmatter is delimited by --- at the start and end:
+ * ```
+ * ---
+ * session:
+ *   id: abc123
+ *   source: claude-code
+ * created: 2024-01-27T14:30:00Z
+ * ---
+ * Actual content here...
+ * ```
+ */
+declare function parseFrontmatter(content: string): {
+    frontmatter: MemoryFrontmatter | undefined;
+    body: string;
+};
+/**
+ * Serialize frontmatter to YAML string
+ */
+declare function serializeFrontmatter(frontmatter: MemoryFrontmatter): string;
+/**
+ * Add or update frontmatter in content
+ */
+declare function addFrontmatter(content: string, frontmatter: MemoryFrontmatter): string;
+/**
+ * Add session context as frontmatter to content
+ */
+declare function addSessionToContent(content: string, session: SessionContext): string;
+/**
+ * Extract session context from file content
+ */
+declare function extractSession(content: string): SessionContext | undefined;
+
+export { type KnowledgeLink, type KnowledgeSource, type MemoryFrontmatter, type SessionContext, addFrontmatter, addSessionToContent, extractSession, parseFrontmatter, serializeFrontmatter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimem",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "A lightweight file-based memory system with vector search for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -9,15 +9,18 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     },
     "./session": {
       "types": "./dist/session.d.ts",
-      "import": "./dist/session.js"
+      "import": "./dist/session.js",
+      "require": "./dist/session.cjs"
     },
     "./internal": {
       "types": "./dist/internal.d.ts",
-      "import": "./dist/internal.js"
+      "import": "./dist/internal.js",
+      "require": "./dist/internal.cjs"
     }
   },
   "files": [
@@ -31,7 +34,11 @@
     "test:integration": "npx tsx --test src/__tests__/minimem.integration.test.ts",
     "test:cli": "npx tsx --test src/cli/__tests__/commands.test.ts",
     "test:all": "npm run test && npm run test:integration && npm run test:cli",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "version:patch": "npm version patch && git push && git push --tags",
+    "version:minor": "npm version minor && git push && git push --tags",
+    "version:major": "npm version major && git push && git push --tags",
+    "publish:npm": "npm run build && npm publish"
   },
   "keywords": [
     "memory",