@theokit/sdk 4.58.0 → 4.60.0

package/dist/chunk-JVERBPRD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/memory/types.ts","../src/internal/memory/storage/memory-file.ts","../src/internal/memory/storage/markdown-store.ts"],"names":["resolvePath"],"mappings":"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","file":"chunk-JVERBPRD.js","sourcesContent":["/**\n * Public memory types (used by runtime + storage + migration + future index).\n *\n * Leaf module — only depends on `node:path` — so neither `runtime/memory-store.ts`\n * nor `internal/memory/markdown-store.ts` introduces a dependency cycle.\n *\n * @internal\n */\nimport { resolve as resolvePath } from \"node:path\";\n\nimport { safePathJoin, sanitizeIdentifier } from \"../security/path-guard.js\";\n\nexport interface MemoryConfig {\n  enabled: boolean;\n  namespace?: string;\n  userId?: string;\n  scope?: \"agent\" | \"user\" | \"team\";\n  storePath?: string;\n}\n\n/**\n * What a fact IS, which is what decides whether it ages (#389).\n *\n * The four are the distinctions that matter for retention and recall: a preference stays true until\n * the user changes their mind, a project fact goes stale when the code moves, a reference either\n * resolves or 404s, and feedback records a correction that was given. Without them, recall ranks one\n * undifferentiated corpus and pruning has no basis to prefer a durable fact over a transient one.\n *\n * A kind is never INFERRED. A wrong kind is worse than none, because it makes retention and recall\n * confident about the wrong thing — so a fact whose author did not say stays untyped.\n */\nexport type MemoryKind = \"user\" | \"feedback\" | \"project\" | \"reference\";\n\n/** The four values {@link MemoryKind} admits, for runtime validation at the storage boundary. */\nexport const MEMORY_KINDS: readonly MemoryKind[] = [\"user\", \"feedback\", \"project\", \"reference\"];\n\nexport interface MemoryFact {\n  text: string;\n  /**\n   * What this fact is (#389). Absent means untyped, which is what a hand-written bullet under\n   * `## Facts` stays — those files are already on disk in consumers' repositories and the store's\n   * own header invites editing them.\n   */\n  kind?: MemoryKind;\n  /**\n   * ISO 8601 instant this fact was last written, stamped BY THE SDK.\n   *\n   * Supplying it does nothing: a timestamp a caller can set is a timestamp that can lie about when\n   * something was learned, and the whole point is to weigh a note from this morning against one\n   * from four months ago. Absent on a fact written before this existed, or hand-added.\n   */\n  modified?: string;\n}\n\n// `redactSecrets` is now re-exported from the canonical security module\n// (ADR D68). Pre-T0.2 it was a 3-pattern local fn; consolidated to avoid\n// drift with the central 12-pattern list.\nexport { redactSecrets } from \"../security/index.js\";\n\n/**\n * Resolve the legacy JSON memory path used pre-ADR-D8 (kept for migration\n * helpers + tests). Centralized here so `migration.ts` and the legacy-aware\n * `runtime/memory-store.ts` don't duplicate the path logic (jscpd cleanup).\n */\nexport function legacyMemoryJsonPath(cwd: string, config: MemoryConfig): string {\n  // ADRs D79-D81: storePath is programmatic (trusted); namespace/scope/userId\n  // are user-shaped and pass sanitizeIdentifier. EC-7 (edge-case review):\n  // realistic userIds (UUIDs, hash IDs, \"default\") pass; \"user@example.com\"\n  // and similar need to be normalized by the caller before passing.\n  if (config.storePath !== undefined) {\n    return resolvePath(cwd, config.storePath);\n  }\n  const namespace = sanitizeIdentifier(config.namespace ?? \"default\");\n  const scope = sanitizeIdentifier(config.scope ?? \"agent\", { maxLen: 16 });\n  const userId = sanitizeIdentifier(config.userId ?? \"default\");\n  return safePathJoin(cwd, \".theokit\", \"memory\", namespace, `${scope}-${userId}.json`);\n}\n\n/**\n * A semantically meaningful slice of a markdown memory file, produced by\n * `chunkMarkdown`. Each chunk carries stable line numbers + a content hash\n * used downstream by the embedding cache.\n *\n * Mirrors peer-project's `MemoryChunk` shape\n * (`reference/peer-project/packages/memory-host-sdk/src/host/engine-storage.ts`).\n *\n * @internal\n */\nexport interface MemoryChunk {\n  /** 1-indexed starting line in the source file. */\n  startLine: number;\n  /** 1-indexed ending line (inclusive). */\n  endLine: number;\n  /** Slice of markdown source text. */\n  text: string;\n  /** sha256 of `text`; stable across runs for identical inputs. */\n  hash: string;\n  /** Optional nearest heading text (without the `#` markers). */\n  heading?: string;\n}\n\n/**\n * Result of `reader.readFile`. Contains the bounded slice plus truncation\n * + provenance info.\n *\n * Mirrors peer-project's `MemoryReadResult` shape.\n *\n * @internal\n */\nexport interface MemoryReadResult {\n  path: string;\n  /** Requested starting line (1-indexed, defaults to 1). */\n  from: number;\n  /** Number of lines actually returned (may be less than `lines` near EOF). */\n  linesReturned: number;\n  /** Total lines in the file (after the read). */\n  totalLines: number;\n  /** True when fewer lines were returned than the requested `lines` AND EOF was hit. */\n  truncated: boolean;\n  /** Lines past the returned slice that remain in the file. */\n  remainingLines: number;\n  /** Slice text (joined with `\\n`). */\n  text: string;\n}\n","/**\n * One memory as a file, in the shape the Claude Code CLI reads.\n *\n * `@theokit/sdk` already writes native Claude Code `.jsonl` sessions — the README's differentiator\n * is \"point `local.sessionDir` at `~/.claude` and the Claude Code CLI can `--continue` a session\n * your agent wrote\". Memory had no such convergence: a fact was a bullet under `## Facts` with its\n * kind in an HTML comment (#389), which that CLI reads as prose. Pointing a memory directory at\n * `~/.claude/projects/<project>/memory/` produced nothing it could open.\n *\n * The contract here was measured against a real store rather than inferred from documentation. Of\n * nine files, all nine carry `name`, `description` and `metadata.type`; six also carry\n * `node_type`, `originSessionId` and `modified`, which the runtime stamps on write. So the minimum\n * a reader must accept is the first three — refusing the rest would refuse memories the CLI itself\n * accepts.\n *\n * `originSessionId` is deliberately not written. It identifies the session that learned the fact,\n * and the append path has no session in scope; inventing one would be worse than omitting a field\n * the format already treats as optional.\n *\n * @internal\n */\n\nimport { parseSimpleYaml, splitFrontmatter } from \"../../runtime/context/context-yaml-lite.js\";\nimport { safeFilenameForId } from \"../../security/path-guard.js\";\nimport { MEMORY_KINDS, type MemoryKind } from \"../types.js\";\n\n/** The fields one memory file carries. */\nexport interface MemoryFileFields {\n  /** Slug, and the file's basename. */\n  readonly name: string;\n  /** One-line summary — what the index shows and what recall ranks. */\n  readonly description: string;\n  /** `metadata.type`, absent when the file does not declare one this contract admits. */\n  readonly kind?: MemoryKind;\n  /** `metadata.modified`, an ISO 8601 instant stamped by whoever wrote the file. */\n  readonly modified?: string;\n  /** The markdown after the frontmatter. */\n  readonly body: string;\n}\n\n/** The safe filename grammar a slug must satisfy before it is used as one. */\nconst SAFE_SLUG = /^[a-z0-9][a-z0-9_-]*$/;\n/** Long enough to stay readable, short enough to survive every filesystem's component limit. */\nconst MAX_SLUG_LENGTH = 64;\n\n/**\n * A readable, filesystem-safe slug for `text`.\n *\n * Readability is the goal — a directory of `h-3f2a…` files is a directory nobody browses — but it\n * is not the floor. The text comes from whatever a caller learned, so anything that fails the safe\n * grammar falls back to {@link safeFilenameForId}, which is total and always yields a valid\n * component.\n */\nexport function slugForFact(text: string): string {\n  const slug = text\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, MAX_SLUG_LENGTH)\n    .replace(/-+$/, \"\");\n  return SAFE_SLUG.test(slug) ? slug : safeFilenameForId(text);\n}\n\n/** Render one memory file. `description` is quoted so a colon in the text cannot break the block. */\nexport function renderMemoryFile(fields: MemoryFileFields): string {\n  const metadata = [\"  node_type: memory\"];\n  if (fields.kind !== undefined) metadata.push(`  type: ${fields.kind}`);\n  if (fields.modified !== undefined) metadata.push(`  modified: ${fields.modified}`);\n  return [\n    \"---\",\n    `name: ${fields.name}`,\n    `description: ${JSON.stringify(fields.description)}`,\n    \"metadata:\",\n    ...metadata,\n    \"---\",\n    \"\",\n    fields.body,\n    \"\",\n  ].join(\"\\n\");\n}\n\n/**\n * Read one memory file, or `undefined` when the content is not one.\n *\n * `undefined` rather than a throw, and rather than a best-effort object: the directory holds\n * hand-written notes and a `MEMORY.md` index alongside the memories, and turning any of those into\n * a fact would put text into recall that nobody recorded as one.\n */\nexport function parseMemoryFile(raw: string): MemoryFileFields | undefined {\n  const { yaml, body } = splitFrontmatter(raw);\n  if (yaml === undefined) return undefined;\n\n  let fields: Record<string, unknown>;\n  try {\n    fields = parseSimpleYaml(yaml);\n  } catch {\n    return undefined; // malformed frontmatter is not a memory\n  }\n\n  const name = fields.name;\n  const description = fields.description;\n  if (typeof name !== \"string\" || typeof description !== \"string\") return undefined;\n\n  const metadata = (fields.metadata ?? {}) as Record<string, unknown>;\n  const rawKind = metadata.type;\n  // An unknown `type` reads as untyped rather than as a fifth kind: the file is hand-editable and\n  // recall must not act on a value this contract does not admit.\n  const kind =\n    typeof rawKind === \"string\" && MEMORY_KINDS.includes(rawKind as MemoryKind)\n      ? (rawKind as MemoryKind)\n      : undefined;\n  const modified = typeof metadata.modified === \"string\" ? metadata.modified : undefined;\n\n  return {\n    name,\n    description,\n    ...(kind !== undefined ? { kind } : {}),\n    ...(modified !== undefined ? { modified } : {}),\n    body: body.trim(),\n  };\n}\n","import { mkdir, readdir, readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport { ConfigurationError } from \"../../../errors.js\";\nimport { replaceFileAtomic } from \"../../persistence/atomic-write.js\";\nimport { withCwdMutex } from \"../../persistence/cwd-mutex.js\";\nimport { encodeProjectDir } from \"../../persistence/session-transcript.js\";\nimport { MEMORY_KINDS, type MemoryConfig, type MemoryFact, redactSecrets } from \"../types.js\";\nimport { parseMemoryFile, renderMemoryFile, slugForFact } from \"./memory-file.js\";\n\n/**\n * Markdown-first memory storage (ADR D1 of memory-system-peer-project-parity).\n *\n * Layout, converged with the one the Claude Code CLI reads:\n *   <memoryDir>/\n *   ├── MEMORY.md          # INDEX — one `- [text](slug.md)` line per memory\n *   ├── <slug>.md          # one memory, frontmatter carrying `metadata.type` + `modified`\n *   └── notes/\n *       └── <slug>.md      # hand-written per-topic notes (read by the indexer, never written here)\n *\n * The SDK already emits native Claude Code `.jsonl` sessions, so a consumer can point\n * `local.sessionDir` at `~/.claude` and `--continue` a session its agent wrote. Memory did not hold\n * that line: a fact was a bullet under `## Facts` with its kind in an HTML comment (#389), which\n * that CLI reads as prose. Pointing a memory directory at `~/.claude/projects/<project>/memory/`\n * produced nothing it could open.\n *\n * `## Facts` bullets are still READ. They are already on disk in consumers' repositories, and a\n * format change that stopped reading them would delete what someone recorded — worse than the\n * format it replaces.\n *\n * All writes go through `replaceFileAtomic` + a per-cwd mutex (EC-4 of the\n * edge-case review) so concurrent `appendFact` calls within the same process\n * serialize. Multi-process safety is NOT provided.\n *\n * @internal\n */\n\nconst MEMORY_MD_HEADER =\n  \"# Memory\\n\\n> Auto-managed by @theokit/sdk. Edit freely — the SDK reads from here.\\n\";\nconst FACTS_HEADING = \"## Facts\";\n\n/**\n * The memory root for a workspace: `<cwd>/.theokit/memory`. Every other path here derives from it,\n * and `memory_get` refuses to read outside it. Pure path computation — nothing is created on disk.\n */\nexport function memoryDir(cwd: string): string {\n  return join(cwd, \".theokit\", \"memory\");\n}\n\n/**\n * Where a NEW fact should be written.\n *\n * `.theokit/memory` by default, exactly as before. When the agent was given a `local.sessionDir`,\n * it becomes `<sessionDir>/projects/<encoded-cwd>/memory` — the same place the transcript for that\n * project goes, so a session and the memories recorded during it land beside each other.\n *\n * `local.sessionDir` is the switch because it is already the option this project documents for CLI\n * interop: point it at `~/.claude` and the CLI can `--continue` a session this agent wrote. Someone\n * who set it has said they share state with that CLI, and memory following is what the sentence\n * already implied. It needs no new option, and nothing moves for anyone who never set it.\n *\n * Safe because of the rule this pairs with — WRITE ONE, READ ALL. {@link readFactsFromMarkdown}\n * covers every location, so a consumer whose new facts move keeps every fact they already had. The\n * change relocates where the next one lands; it orphans nothing.\n */\nexport function memoryWriteDir(cwd: string, sessionDir: string | undefined): string {\n  if (sessionDir === undefined || sessionDir.trim().length === 0) return memoryDir(cwd);\n  return join(sessionDir, \"projects\", encodeProjectDir(cwd), \"memory\");\n}\n\n/**\n * Where the Claude Code CLI keeps THIS project's memories.\n *\n * `<claudeHome>/projects/<encoded-cwd>/memory` — the same `encodeProjectDir` scheme the transcripts\n * already use, which is why no new encoding is invented here. `CLAUDE_CONFIG_DIR` names the home\n * when set (the CLI's own variable); `~/.claude` otherwise.\n *\n * Read, never written. Writing here by default would relocate every existing consumer's memories,\n * and an additive change must not move what is already on disk — so this is the direction that\n * costs nothing: a memory the CLI wrote becomes visible, and a memory the SDK wrote stays where the\n * SDK put it.\n */\nexport function claudeProjectMemoryDir(cwd: string): string {\n  const home = process.env.CLAUDE_CONFIG_DIR?.trim();\n  const root = home !== undefined && home.length > 0 ? home : join(homedir(), \".claude\");\n  return join(root, \"projects\", encodeProjectDir(cwd), \"memory\");\n}\n\n/**\n * Path to `MEMORY.md`, the index that points at the per-memory files — and, in stores written before\n * #389, the flat `## Facts` list itself. Pure path computation; the file may not exist.\n */\nexport function memoryMdPath(cwd: string): string {\n  return join(memoryDir(cwd), \"MEMORY.md\");\n}\n\n/**\n * Path to `<memory root>/notes`, where per-topic notes and the consolidated notes a dreaming sweep\n * writes live. Pure path computation — the directory may not exist.\n */\nexport function notesDir(cwd: string): string {\n  return join(memoryDir(cwd), \"notes\");\n}\n\n/**\n * Every memory in the store: the per-memory files, plus any legacy `## Facts` bullets still in\n * `MEMORY.md`. Returns `[]` when the directory does not exist.\n *\n * Reading both is not transitional politeness. Those bullets are already on disk in consumers'\n * repositories, and the store's own header invites editing them by hand — a converged writer that\n * stopped reading them would delete what someone recorded, which is worse than the format it fixes.\n */\nexport async function readFactsFromMarkdown(\n  cwd: string,\n  sessionDir?: string,\n): Promise<MemoryFact[]> {\n  const facts: MemoryFact[] = [];\n  // Both stores: this SDK's, then the one the Claude Code CLI keeps for the same project. The\n  // format has been shared since #389; only the directory was not, so a memory the CLI recorded was\n  // invisible to an agent working in the same repository.\n  // READ ALL: the project store, the location a configured `sessionDir` writes to, and the one the\n  // CLI uses by default. Deduplicated, because with `sessionDir` pointed at the CLI's own home the\n  // last two are the same directory and a fact would otherwise be recalled twice.\n  const roots = [\n    ...new Set([memoryDir(cwd), memoryWriteDir(cwd, sessionDir), claudeProjectMemoryDir(cwd)]),\n  ];\n  for (const dir of roots) {\n    let entries: string[];\n    try {\n      entries = await readdir(dir);\n    } catch {\n      continue;\n    }\n    for (const entry of entries.sort()) {\n      const fact = await readMemoryFileIn(dir, entry);\n      if (fact !== undefined) facts.push(fact);\n    }\n  }\n\n  try {\n    facts.push(...parseFactsSection(await readFile(memoryMdPath(cwd), \"utf8\")));\n  } catch {\n    // no index yet — the per-memory files above are the whole store\n  }\n  return facts;\n}\n\n/**\n * One directory entry as a fact, or `undefined` when it is not one.\n *\n * `MEMORY.md` is the index, not a memory; a non-markdown entry is not a memory; and a markdown file\n * without the frontmatter is a note somebody wrote by hand. Turning any of those into a fact would\n * put text into recall that nobody recorded as one.\n *\n * The DIRECTORY is a parameter rather than derived from `cwd`, because both stores — this SDK's and\n * the one the Claude Code CLI keeps for the same project — read entries the same way, and a second\n * copy of this function is a second place for those three rules to drift.\n */\nasync function readMemoryFileIn(dir: string, entry: string): Promise<MemoryFact | undefined> {\n  if (!entry.endsWith(\".md\") || entry === \"MEMORY.md\") return undefined;\n  let raw: string;\n  try {\n    raw = await readFile(join(dir, entry), \"utf8\");\n  } catch {\n    return undefined; // vanished between readdir and read\n  }\n  const parsed = parseMemoryFile(raw);\n  if (parsed === undefined) return undefined;\n  // The BODY is the memory; `description` is the one-line recall aid. This SDK writes both the same,\n  // so nothing it wrote changes — but the Claude Code CLI writes a summary in `description` and the\n  // substance below it, and reading only the summary silently dropped the fact itself.\n  const body = parsed.body.trim();\n  return {\n    text: body.length > 0 ? body : parsed.description,\n    ...(parsed.kind !== undefined ? { kind: parsed.kind } : {}),\n    ...(parsed.modified !== undefined ? { modified: parsed.modified } : {}),\n  };\n}\n\n/**\n * Write a fact as its own memory file and point the `MEMORY.md` index at it. Atomic + serialized.\n *\n * `modified` is stamped HERE and never read from `fact`: a timestamp a caller can set is a\n * timestamp that can lie about when something was learned, and weighing recency is the point.\n */\nexport function appendFactToMarkdown(\n  cwd: string,\n  fact: MemoryFact,\n  targetDir: string = memoryDir(cwd),\n): Promise<void> {\n  return withCwdMutex(targetDir, async () => {\n    // Validate at the boundary (`error-handling.md` § 2): a kind outside the four would be written\n    // to a file recall later trusts, so it is refused here rather than stored and believed.\n    if (fact.kind !== undefined && !MEMORY_KINDS.includes(fact.kind)) {\n      throw new ConfigurationError(\n        `Unknown memory fact kind \"${fact.kind}\". Expected one of: ${MEMORY_KINDS.join(\", \")}.`,\n        { code: \"invalid_memory_kind\" },\n      );\n    }\n    const text = redactSecrets(fact.text);\n    const name = slugForFact(text);\n    await mkdir(targetDir, { recursive: true });\n    await replaceFileAtomic(\n      join(targetDir, `${name}.md`),\n      renderMemoryFile({\n        name,\n        description: text,\n        ...(fact.kind !== undefined ? { kind: fact.kind } : {}),\n        modified: new Date().toISOString(),\n        body: text,\n      }),\n    );\n    // The index lives BESIDE the files it lists. A `MEMORY.md` in one directory pointing at\n    // memories in another names files that are not there — and the CLI reads that index.\n    await replaceFileAtomic(join(targetDir, \"MEMORY.md\"), await nextIndex(targetDir, text, name));\n  });\n}\n\n/**\n * The `MEMORY.md` index with `name` present exactly once.\n *\n * Rewriting the same memory replaces its line rather than adding a second: the index is a map from\n * memory to file, and two lines for one file is a map that disagrees with itself.\n */\nasync function nextIndex(dir: string, text: string, name: string): Promise<string> {\n  let existing = \"\";\n  try {\n    // The index in the directory being WRITTEN, not the project one — see the caller.\n    existing = await readFile(join(dir, \"MEMORY.md\"), \"utf8\");\n  } catch {\n    existing = \"\";\n  }\n  const entry = `- [${text}](${name}.md)`;\n  const kept = existing\n    .split(\"\\n\")\n    .filter((line) => !line.startsWith(`- [`) || !line.includes(`](${name}.md)`));\n  const body = kept.join(\"\\n\").trimEnd();\n  const head = body.length > 0 ? body : MEMORY_MD_HEADER.trimEnd();\n  return `${head}\\n${entry}\\n`;\n}\n\n/** A `MEMORY.md` index entry: a link whose target is a sibling `.md` file. */\nconst INDEX_ENTRY = /^\\[[^\\]]*\\]\\([^)]+\\.md\\)$/;\n\n/**\n * Facts from a legacy `## Facts` section — the shape every released version wrote.\n *\n * Kept for reading only. The converged writer puts each memory in its own file, and this parser\n * exists so a store written by an earlier version keeps answering.\n *\n * There is no metadata to recover from a bullet: `kind` and `modified` are absent, which is exactly\n * right, since nothing recorded them. A brief encoding that carried them in a trailing HTML comment\n * (#389) never reached a published version — 4.55.0 was published at 17:23Z and that commit landed\n * at 20:06Z — so there is no store in the wild to migrate from it.\n */\nfunction parseFactsSection(raw: string): MemoryFact[] {\n  const idx = raw.indexOf(FACTS_HEADING);\n  if (idx === -1) return [];\n  const tail = raw.slice(idx + FACTS_HEADING.length);\n  // Stop at the next top-level or h2 heading.\n  const nextHeading = tail.search(/\\n#{1,2}\\s/);\n  const block = nextHeading === -1 ? tail : tail.slice(0, nextHeading);\n  return (\n    block\n      .split(\"\\n\")\n      .map((line) => line.trim())\n      .filter((line) => line.startsWith(\"- \"))\n      .map((line) => line.slice(2).trim())\n      // An index entry is a POINTER to a memory, not a memory. Both are `- ` bullets, and when a\n      // legacy `## Facts` heading is present the appended index lines land under it — counting them\n      // here would report every converged memory twice, once from its file and once from its link.\n      .filter((body) => !INDEX_ENTRY.test(body))\n      .map((body) => ({ text: body }))\n  );\n}\n\n/**\n * Every memory in the store, honouring the `enabled` gate on {@link MemoryConfig}: when memory is\n * disabled the call resolves to `[]` without touching disk. Configuration-aware entry point;\n * {@link readFactsFromMarkdown} is the same read without the gate.\n */\nexport async function readFacts(\n  cwd: string,\n  config: MemoryConfig,\n  memoryHome?: string,\n): Promise<MemoryFact[]> {\n  if (!config.enabled) return [];\n  return readFactsFromMarkdown(cwd, memoryHome);\n}\n\n/**\n * Record a fact, honouring the `enabled` gate on {@link MemoryConfig}: when memory is disabled the\n * call resolves without touching disk. Configuration-aware entry point;\n * {@link appendFactToMarkdown} is the same write without the gate.\n *\n * `memoryHome` is the agent's `local.sessionDir` when it has one — see {@link memoryWriteDir} for\n * which store that sends the fact to.\n */\nexport async function appendFact(\n  cwd: string,\n  config: MemoryConfig,\n  fact: MemoryFact,\n  memoryHome?: string,\n): Promise<void> {\n  if (!config.enabled) return;\n  await appendFactToMarkdown(cwd, fact, memoryWriteDir(cwd, memoryHome));\n}\n"]}

package/dist/chunk-NY25NBZB.cjs

@@ -0,0 +1,203 @@
+'use strict';
+
+var chunkKRD3GQAA_cjs = require('./chunk-KRD3GQAA.cjs');
+var chunkR3UPQFKK_cjs = require('./chunk-R3UPQFKK.cjs');
+var chunkBUIK7GUA_cjs = require('./chunk-BUIK7GUA.cjs');
+var chunkZF2LDKQQ_cjs = require('./chunk-ZF2LDKQQ.cjs');
+var chunkI6TGFUCO_cjs = require('./chunk-I6TGFUCO.cjs');
+var chunkK3FW2XZD_cjs = require('./chunk-K3FW2XZD.cjs');
+var chunkJTB5Q42C_cjs = require('./chunk-JTB5Q42C.cjs');
+var promises = require('fs/promises');
+var os = require('os');
+var path = require('path');
+
+var MEMORY_KINDS = ["user", "feedback", "project", "reference"];
+function legacyMemoryJsonPath(cwd, config) {
+  if (config.storePath !== void 0) {
+    return path.resolve(cwd, config.storePath);
+  }
+  const namespace = chunkR3UPQFKK_cjs.sanitizeIdentifier(config.namespace ?? "default");
+  const scope = chunkR3UPQFKK_cjs.sanitizeIdentifier(config.scope ?? "agent", { maxLen: 16 });
+  const userId = chunkR3UPQFKK_cjs.sanitizeIdentifier(config.userId ?? "default");
+  return chunkR3UPQFKK_cjs.safePathJoin(cwd, ".theokit", "memory", namespace, `${scope}-${userId}.json`);
+}
+
+// src/internal/memory/storage/memory-file.ts
+var SAFE_SLUG = /^[a-z0-9][a-z0-9_-]*$/;
+var MAX_SLUG_LENGTH = 64;
+function slugForFact(text) {
+  const slug = text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, MAX_SLUG_LENGTH).replace(/-+$/, "");
+  return SAFE_SLUG.test(slug) ? slug : chunkR3UPQFKK_cjs.safeFilenameForId(text);
+}
+function renderMemoryFile(fields) {
+  const metadata = ["  node_type: memory"];
+  if (fields.kind !== void 0) metadata.push(`  type: ${fields.kind}`);
+  if (fields.modified !== void 0) metadata.push(`  modified: ${fields.modified}`);
+  return [
+    "---",
+    `name: ${fields.name}`,
+    `description: ${JSON.stringify(fields.description)}`,
+    "metadata:",
+    ...metadata,
+    "---",
+    "",
+    fields.body,
+    ""
+  ].join("\n");
+}
+function parseMemoryFile(raw) {
+  const { yaml, body } = chunkKRD3GQAA_cjs.splitFrontmatter(raw);
+  if (yaml === void 0) return void 0;
+  let fields;
+  try {
+    fields = chunkKRD3GQAA_cjs.parseSimpleYaml(yaml);
+  } catch {
+    return void 0;
+  }
+  const name = fields.name;
+  const description = fields.description;
+  if (typeof name !== "string" || typeof description !== "string") return void 0;
+  const metadata = fields.metadata ?? {};
+  const rawKind = metadata.type;
+  const kind = typeof rawKind === "string" && MEMORY_KINDS.includes(rawKind) ? rawKind : void 0;
+  const modified = typeof metadata.modified === "string" ? metadata.modified : void 0;
+  return {
+    name,
+    description,
+    ...kind !== void 0 ? { kind } : {},
+    ...modified !== void 0 ? { modified } : {},
+    body: body.trim()
+  };
+}
+
+// src/internal/memory/storage/markdown-store.ts
+var MEMORY_MD_HEADER = "# Memory\n\n> Auto-managed by @theokit/sdk. Edit freely \u2014 the SDK reads from here.\n";
+var FACTS_HEADING = "## Facts";
+function memoryDir(cwd) {
+  return path.join(cwd, ".theokit", "memory");
+}
+function memoryWriteDir(cwd, sessionDir) {
+  if (sessionDir === void 0 || sessionDir.trim().length === 0) return memoryDir(cwd);
+  return path.join(sessionDir, "projects", chunkBUIK7GUA_cjs.encodeProjectDir(cwd), "memory");
+}
+function claudeProjectMemoryDir(cwd) {
+  const home = process.env.CLAUDE_CONFIG_DIR?.trim();
+  const root = home !== void 0 && home.length > 0 ? home : path.join(os.homedir(), ".claude");
+  return path.join(root, "projects", chunkBUIK7GUA_cjs.encodeProjectDir(cwd), "memory");
+}
+function memoryMdPath(cwd) {
+  return path.join(memoryDir(cwd), "MEMORY.md");
+}
+function notesDir(cwd) {
+  return path.join(memoryDir(cwd), "notes");
+}
+async function readFactsFromMarkdown(cwd, sessionDir) {
+  const facts = [];
+  const roots = [
+    .../* @__PURE__ */ new Set([memoryDir(cwd), memoryWriteDir(cwd, sessionDir), claudeProjectMemoryDir(cwd)])
+  ];
+  for (const dir of roots) {
+    let entries;
+    try {
+      entries = await promises.readdir(dir);
+    } catch {
+      continue;
+    }
+    for (const entry of entries.sort()) {
+      const fact = await readMemoryFileIn(dir, entry);
+      if (fact !== void 0) facts.push(fact);
+    }
+  }
+  try {
+    facts.push(...parseFactsSection(await promises.readFile(memoryMdPath(cwd), "utf8")));
+  } catch {
+  }
+  return facts;
+}
+async function readMemoryFileIn(dir, entry) {
+  if (!entry.endsWith(".md") || entry === "MEMORY.md") return void 0;
+  let raw;
+  try {
+    raw = await promises.readFile(path.join(dir, entry), "utf8");
+  } catch {
+    return void 0;
+  }
+  const parsed = parseMemoryFile(raw);
+  if (parsed === void 0) return void 0;
+  const body = parsed.body.trim();
+  return {
+    text: body.length > 0 ? body : parsed.description,
+    ...parsed.kind !== void 0 ? { kind: parsed.kind } : {},
+    ...parsed.modified !== void 0 ? { modified: parsed.modified } : {}
+  };
+}
+function appendFactToMarkdown(cwd, fact, targetDir = memoryDir(cwd)) {
+  return chunkZF2LDKQQ_cjs.withCwdMutex(targetDir, async () => {
+    if (fact.kind !== void 0 && !MEMORY_KINDS.includes(fact.kind)) {
+      throw new chunkK3FW2XZD_cjs.ConfigurationError(
+        `Unknown memory fact kind "${fact.kind}". Expected one of: ${MEMORY_KINDS.join(", ")}.`,
+        { code: "invalid_memory_kind" }
+      );
+    }
+    const text = chunkJTB5Q42C_cjs.redactSecrets(fact.text);
+    const name = slugForFact(text);
+    await promises.mkdir(targetDir, { recursive: true });
+    await chunkI6TGFUCO_cjs.replaceFileAtomic(
+      path.join(targetDir, `${name}.md`),
+      renderMemoryFile({
+        name,
+        description: text,
+        ...fact.kind !== void 0 ? { kind: fact.kind } : {},
+        modified: (/* @__PURE__ */ new Date()).toISOString(),
+        body: text
+      })
+    );
+    await chunkI6TGFUCO_cjs.replaceFileAtomic(path.join(targetDir, "MEMORY.md"), await nextIndex(targetDir, text, name));
+  });
+}
+async function nextIndex(dir, text, name) {
+  let existing = "";
+  try {
+    existing = await promises.readFile(path.join(dir, "MEMORY.md"), "utf8");
+  } catch {
+    existing = "";
+  }
+  const entry = `- [${text}](${name}.md)`;
+  const kept = existing.split("\n").filter((line) => !line.startsWith(`- [`) || !line.includes(`](${name}.md)`));
+  const body = kept.join("\n").trimEnd();
+  const head = body.length > 0 ? body : MEMORY_MD_HEADER.trimEnd();
+  return `${head}
+${entry}
+`;
+}
+var INDEX_ENTRY = /^\[[^\]]*\]\([^)]+\.md\)$/;
+function parseFactsSection(raw) {
+  const idx = raw.indexOf(FACTS_HEADING);
+  if (idx === -1) return [];
+  const tail = raw.slice(idx + FACTS_HEADING.length);
+  const nextHeading = tail.search(/\n#{1,2}\s/);
+  const block = nextHeading === -1 ? tail : tail.slice(0, nextHeading);
+  return block.split("\n").map((line) => line.trim()).filter((line) => line.startsWith("- ")).map((line) => line.slice(2).trim()).filter((body) => !INDEX_ENTRY.test(body)).map((body) => ({ text: body }));
+}
+async function readFacts(cwd, config, memoryHome) {
+  if (!config.enabled) return [];
+  return readFactsFromMarkdown(cwd, memoryHome);
+}
+async function appendFact(cwd, config, fact, memoryHome) {
+  if (!config.enabled) return;
+  await appendFactToMarkdown(cwd, fact, memoryWriteDir(cwd, memoryHome));
+}
+
+exports.MEMORY_KINDS = MEMORY_KINDS;
+exports.appendFact = appendFact;
+exports.appendFactToMarkdown = appendFactToMarkdown;
+exports.claudeProjectMemoryDir = claudeProjectMemoryDir;
+exports.legacyMemoryJsonPath = legacyMemoryJsonPath;
+exports.memoryDir = memoryDir;
+exports.memoryMdPath = memoryMdPath;
+exports.memoryWriteDir = memoryWriteDir;
+exports.notesDir = notesDir;
+exports.readFacts = readFacts;
+exports.readFactsFromMarkdown = readFactsFromMarkdown;
+//# sourceMappingURL=chunk-NY25NBZB.cjs.map
+//# sourceMappingURL=chunk-NY25NBZB.cjs.map

package/dist/chunk-NY25NBZB.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/memory/types.ts","../src/internal/memory/storage/memory-file.ts","../src/internal/memory/storage/markdown-store.ts"],"names":["resolvePath","sanitizeIdentifier","safePathJoin","safeFilenameForId","splitFrontmatter","parseSimpleYaml","join","encodeProjectDir","homedir","readdir","readFile","withCwdMutex","ConfigurationError","redactSecrets","mkdir","replaceFileAtomic"],"mappings":"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","file":"chunk-NY25NBZB.cjs","sourcesContent":["/**\n * Public memory types (used by runtime + storage + migration + future index).\n *\n * Leaf module — only depends on `node:path` — so neither `runtime/memory-store.ts`\n * nor `internal/memory/markdown-store.ts` introduces a dependency cycle.\n *\n * @internal\n */\nimport { resolve as resolvePath } from \"node:path\";\n\nimport { safePathJoin, sanitizeIdentifier } from \"../security/path-guard.js\";\n\nexport interface MemoryConfig {\n  enabled: boolean;\n  namespace?: string;\n  userId?: string;\n  scope?: \"agent\" | \"user\" | \"team\";\n  storePath?: string;\n}\n\n/**\n * What a fact IS, which is what decides whether it ages (#389).\n *\n * The four are the distinctions that matter for retention and recall: a preference stays true until\n * the user changes their mind, a project fact goes stale when the code moves, a reference either\n * resolves or 404s, and feedback records a correction that was given. Without them, recall ranks one\n * undifferentiated corpus and pruning has no basis to prefer a durable fact over a transient one.\n *\n * A kind is never INFERRED. A wrong kind is worse than none, because it makes retention and recall\n * confident about the wrong thing — so a fact whose author did not say stays untyped.\n */\nexport type MemoryKind = \"user\" | \"feedback\" | \"project\" | \"reference\";\n\n/** The four values {@link MemoryKind} admits, for runtime validation at the storage boundary. */\nexport const MEMORY_KINDS: readonly MemoryKind[] = [\"user\", \"feedback\", \"project\", \"reference\"];\n\nexport interface MemoryFact {\n  text: string;\n  /**\n   * What this fact is (#389). Absent means untyped, which is what a hand-written bullet under\n   * `## Facts` stays — those files are already on disk in consumers' repositories and the store's\n   * own header invites editing them.\n   */\n  kind?: MemoryKind;\n  /**\n   * ISO 8601 instant this fact was last written, stamped BY THE SDK.\n   *\n   * Supplying it does nothing: a timestamp a caller can set is a timestamp that can lie about when\n   * something was learned, and the whole point is to weigh a note from this morning against one\n   * from four months ago. Absent on a fact written before this existed, or hand-added.\n   */\n  modified?: string;\n}\n\n// `redactSecrets` is now re-exported from the canonical security module\n// (ADR D68). Pre-T0.2 it was a 3-pattern local fn; consolidated to avoid\n// drift with the central 12-pattern list.\nexport { redactSecrets } from \"../security/index.js\";\n\n/**\n * Resolve the legacy JSON memory path used pre-ADR-D8 (kept for migration\n * helpers + tests). Centralized here so `migration.ts` and the legacy-aware\n * `runtime/memory-store.ts` don't duplicate the path logic (jscpd cleanup).\n */\nexport function legacyMemoryJsonPath(cwd: string, config: MemoryConfig): string {\n  // ADRs D79-D81: storePath is programmatic (trusted); namespace/scope/userId\n  // are user-shaped and pass sanitizeIdentifier. EC-7 (edge-case review):\n  // realistic userIds (UUIDs, hash IDs, \"default\") pass; \"user@example.com\"\n  // and similar need to be normalized by the caller before passing.\n  if (config.storePath !== undefined) {\n    return resolvePath(cwd, config.storePath);\n  }\n  const namespace = sanitizeIdentifier(config.namespace ?? \"default\");\n  const scope = sanitizeIdentifier(config.scope ?? \"agent\", { maxLen: 16 });\n  const userId = sanitizeIdentifier(config.userId ?? \"default\");\n  return safePathJoin(cwd, \".theokit\", \"memory\", namespace, `${scope}-${userId}.json`);\n}\n\n/**\n * A semantically meaningful slice of a markdown memory file, produced by\n * `chunkMarkdown`. Each chunk carries stable line numbers + a content hash\n * used downstream by the embedding cache.\n *\n * Mirrors peer-project's `MemoryChunk` shape\n * (`reference/peer-project/packages/memory-host-sdk/src/host/engine-storage.ts`).\n *\n * @internal\n */\nexport interface MemoryChunk {\n  /** 1-indexed starting line in the source file. */\n  startLine: number;\n  /** 1-indexed ending line (inclusive). */\n  endLine: number;\n  /** Slice of markdown source text. */\n  text: string;\n  /** sha256 of `text`; stable across runs for identical inputs. */\n  hash: string;\n  /** Optional nearest heading text (without the `#` markers). */\n  heading?: string;\n}\n\n/**\n * Result of `reader.readFile`. Contains the bounded slice plus truncation\n * + provenance info.\n *\n * Mirrors peer-project's `MemoryReadResult` shape.\n *\n * @internal\n */\nexport interface MemoryReadResult {\n  path: string;\n  /** Requested starting line (1-indexed, defaults to 1). */\n  from: number;\n  /** Number of lines actually returned (may be less than `lines` near EOF). */\n  linesReturned: number;\n  /** Total lines in the file (after the read). */\n  totalLines: number;\n  /** True when fewer lines were returned than the requested `lines` AND EOF was hit. */\n  truncated: boolean;\n  /** Lines past the returned slice that remain in the file. */\n  remainingLines: number;\n  /** Slice text (joined with `\\n`). */\n  text: string;\n}\n","/**\n * One memory as a file, in the shape the Claude Code CLI reads.\n *\n * `@theokit/sdk` already writes native Claude Code `.jsonl` sessions — the README's differentiator\n * is \"point `local.sessionDir` at `~/.claude` and the Claude Code CLI can `--continue` a session\n * your agent wrote\". Memory had no such convergence: a fact was a bullet under `## Facts` with its\n * kind in an HTML comment (#389), which that CLI reads as prose. Pointing a memory directory at\n * `~/.claude/projects/<project>/memory/` produced nothing it could open.\n *\n * The contract here was measured against a real store rather than inferred from documentation. Of\n * nine files, all nine carry `name`, `description` and `metadata.type`; six also carry\n * `node_type`, `originSessionId` and `modified`, which the runtime stamps on write. So the minimum\n * a reader must accept is the first three — refusing the rest would refuse memories the CLI itself\n * accepts.\n *\n * `originSessionId` is deliberately not written. It identifies the session that learned the fact,\n * and the append path has no session in scope; inventing one would be worse than omitting a field\n * the format already treats as optional.\n *\n * @internal\n */\n\nimport { parseSimpleYaml, splitFrontmatter } from \"../../runtime/context/context-yaml-lite.js\";\nimport { safeFilenameForId } from \"../../security/path-guard.js\";\nimport { MEMORY_KINDS, type MemoryKind } from \"../types.js\";\n\n/** The fields one memory file carries. */\nexport interface MemoryFileFields {\n  /** Slug, and the file's basename. */\n  readonly name: string;\n  /** One-line summary — what the index shows and what recall ranks. */\n  readonly description: string;\n  /** `metadata.type`, absent when the file does not declare one this contract admits. */\n  readonly kind?: MemoryKind;\n  /** `metadata.modified`, an ISO 8601 instant stamped by whoever wrote the file. */\n  readonly modified?: string;\n  /** The markdown after the frontmatter. */\n  readonly body: string;\n}\n\n/** The safe filename grammar a slug must satisfy before it is used as one. */\nconst SAFE_SLUG = /^[a-z0-9][a-z0-9_-]*$/;\n/** Long enough to stay readable, short enough to survive every filesystem's component limit. */\nconst MAX_SLUG_LENGTH = 64;\n\n/**\n * A readable, filesystem-safe slug for `text`.\n *\n * Readability is the goal — a directory of `h-3f2a…` files is a directory nobody browses — but it\n * is not the floor. The text comes from whatever a caller learned, so anything that fails the safe\n * grammar falls back to {@link safeFilenameForId}, which is total and always yields a valid\n * component.\n */\nexport function slugForFact(text: string): string {\n  const slug = text\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, MAX_SLUG_LENGTH)\n    .replace(/-+$/, \"\");\n  return SAFE_SLUG.test(slug) ? slug : safeFilenameForId(text);\n}\n\n/** Render one memory file. `description` is quoted so a colon in the text cannot break the block. */\nexport function renderMemoryFile(fields: MemoryFileFields): string {\n  const metadata = [\"  node_type: memory\"];\n  if (fields.kind !== undefined) metadata.push(`  type: ${fields.kind}`);\n  if (fields.modified !== undefined) metadata.push(`  modified: ${fields.modified}`);\n  return [\n    \"---\",\n    `name: ${fields.name}`,\n    `description: ${JSON.stringify(fields.description)}`,\n    \"metadata:\",\n    ...metadata,\n    \"---\",\n    \"\",\n    fields.body,\n    \"\",\n  ].join(\"\\n\");\n}\n\n/**\n * Read one memory file, or `undefined` when the content is not one.\n *\n * `undefined` rather than a throw, and rather than a best-effort object: the directory holds\n * hand-written notes and a `MEMORY.md` index alongside the memories, and turning any of those into\n * a fact would put text into recall that nobody recorded as one.\n */\nexport function parseMemoryFile(raw: string): MemoryFileFields | undefined {\n  const { yaml, body } = splitFrontmatter(raw);\n  if (yaml === undefined) return undefined;\n\n  let fields: Record<string, unknown>;\n  try {\n    fields = parseSimpleYaml(yaml);\n  } catch {\n    return undefined; // malformed frontmatter is not a memory\n  }\n\n  const name = fields.name;\n  const description = fields.description;\n  if (typeof name !== \"string\" || typeof description !== \"string\") return undefined;\n\n  const metadata = (fields.metadata ?? {}) as Record<string, unknown>;\n  const rawKind = metadata.type;\n  // An unknown `type` reads as untyped rather than as a fifth kind: the file is hand-editable and\n  // recall must not act on a value this contract does not admit.\n  const kind =\n    typeof rawKind === \"string\" && MEMORY_KINDS.includes(rawKind as MemoryKind)\n      ? (rawKind as MemoryKind)\n      : undefined;\n  const modified = typeof metadata.modified === \"string\" ? metadata.modified : undefined;\n\n  return {\n    name,\n    description,\n    ...(kind !== undefined ? { kind } : {}),\n    ...(modified !== undefined ? { modified } : {}),\n    body: body.trim(),\n  };\n}\n","import { mkdir, readdir, readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport { ConfigurationError } from \"../../../errors.js\";\nimport { replaceFileAtomic } from \"../../persistence/atomic-write.js\";\nimport { withCwdMutex } from \"../../persistence/cwd-mutex.js\";\nimport { encodeProjectDir } from \"../../persistence/session-transcript.js\";\nimport { MEMORY_KINDS, type MemoryConfig, type MemoryFact, redactSecrets } from \"../types.js\";\nimport { parseMemoryFile, renderMemoryFile, slugForFact } from \"./memory-file.js\";\n\n/**\n * Markdown-first memory storage (ADR D1 of memory-system-peer-project-parity).\n *\n * Layout, converged with the one the Claude Code CLI reads:\n *   <memoryDir>/\n *   ├── MEMORY.md          # INDEX — one `- [text](slug.md)` line per memory\n *   ├── <slug>.md          # one memory, frontmatter carrying `metadata.type` + `modified`\n *   └── notes/\n *       └── <slug>.md      # hand-written per-topic notes (read by the indexer, never written here)\n *\n * The SDK already emits native Claude Code `.jsonl` sessions, so a consumer can point\n * `local.sessionDir` at `~/.claude` and `--continue` a session its agent wrote. Memory did not hold\n * that line: a fact was a bullet under `## Facts` with its kind in an HTML comment (#389), which\n * that CLI reads as prose. Pointing a memory directory at `~/.claude/projects/<project>/memory/`\n * produced nothing it could open.\n *\n * `## Facts` bullets are still READ. They are already on disk in consumers' repositories, and a\n * format change that stopped reading them would delete what someone recorded — worse than the\n * format it replaces.\n *\n * All writes go through `replaceFileAtomic` + a per-cwd mutex (EC-4 of the\n * edge-case review) so concurrent `appendFact` calls within the same process\n * serialize. Multi-process safety is NOT provided.\n *\n * @internal\n */\n\nconst MEMORY_MD_HEADER =\n  \"# Memory\\n\\n> Auto-managed by @theokit/sdk. Edit freely — the SDK reads from here.\\n\";\nconst FACTS_HEADING = \"## Facts\";\n\n/**\n * The memory root for a workspace: `<cwd>/.theokit/memory`. Every other path here derives from it,\n * and `memory_get` refuses to read outside it. Pure path computation — nothing is created on disk.\n */\nexport function memoryDir(cwd: string): string {\n  return join(cwd, \".theokit\", \"memory\");\n}\n\n/**\n * Where a NEW fact should be written.\n *\n * `.theokit/memory` by default, exactly as before. When the agent was given a `local.sessionDir`,\n * it becomes `<sessionDir>/projects/<encoded-cwd>/memory` — the same place the transcript for that\n * project goes, so a session and the memories recorded during it land beside each other.\n *\n * `local.sessionDir` is the switch because it is already the option this project documents for CLI\n * interop: point it at `~/.claude` and the CLI can `--continue` a session this agent wrote. Someone\n * who set it has said they share state with that CLI, and memory following is what the sentence\n * already implied. It needs no new option, and nothing moves for anyone who never set it.\n *\n * Safe because of the rule this pairs with — WRITE ONE, READ ALL. {@link readFactsFromMarkdown}\n * covers every location, so a consumer whose new facts move keeps every fact they already had. The\n * change relocates where the next one lands; it orphans nothing.\n */\nexport function memoryWriteDir(cwd: string, sessionDir: string | undefined): string {\n  if (sessionDir === undefined || sessionDir.trim().length === 0) return memoryDir(cwd);\n  return join(sessionDir, \"projects\", encodeProjectDir(cwd), \"memory\");\n}\n\n/**\n * Where the Claude Code CLI keeps THIS project's memories.\n *\n * `<claudeHome>/projects/<encoded-cwd>/memory` — the same `encodeProjectDir` scheme the transcripts\n * already use, which is why no new encoding is invented here. `CLAUDE_CONFIG_DIR` names the home\n * when set (the CLI's own variable); `~/.claude` otherwise.\n *\n * Read, never written. Writing here by default would relocate every existing consumer's memories,\n * and an additive change must not move what is already on disk — so this is the direction that\n * costs nothing: a memory the CLI wrote becomes visible, and a memory the SDK wrote stays where the\n * SDK put it.\n */\nexport function claudeProjectMemoryDir(cwd: string): string {\n  const home = process.env.CLAUDE_CONFIG_DIR?.trim();\n  const root = home !== undefined && home.length > 0 ? home : join(homedir(), \".claude\");\n  return join(root, \"projects\", encodeProjectDir(cwd), \"memory\");\n}\n\n/**\n * Path to `MEMORY.md`, the index that points at the per-memory files — and, in stores written before\n * #389, the flat `## Facts` list itself. Pure path computation; the file may not exist.\n */\nexport function memoryMdPath(cwd: string): string {\n  return join(memoryDir(cwd), \"MEMORY.md\");\n}\n\n/**\n * Path to `<memory root>/notes`, where per-topic notes and the consolidated notes a dreaming sweep\n * writes live. Pure path computation — the directory may not exist.\n */\nexport function notesDir(cwd: string): string {\n  return join(memoryDir(cwd), \"notes\");\n}\n\n/**\n * Every memory in the store: the per-memory files, plus any legacy `## Facts` bullets still in\n * `MEMORY.md`. Returns `[]` when the directory does not exist.\n *\n * Reading both is not transitional politeness. Those bullets are already on disk in consumers'\n * repositories, and the store's own header invites editing them by hand — a converged writer that\n * stopped reading them would delete what someone recorded, which is worse than the format it fixes.\n */\nexport async function readFactsFromMarkdown(\n  cwd: string,\n  sessionDir?: string,\n): Promise<MemoryFact[]> {\n  const facts: MemoryFact[] = [];\n  // Both stores: this SDK's, then the one the Claude Code CLI keeps for the same project. The\n  // format has been shared since #389; only the directory was not, so a memory the CLI recorded was\n  // invisible to an agent working in the same repository.\n  // READ ALL: the project store, the location a configured `sessionDir` writes to, and the one the\n  // CLI uses by default. Deduplicated, because with `sessionDir` pointed at the CLI's own home the\n  // last two are the same directory and a fact would otherwise be recalled twice.\n  const roots = [\n    ...new Set([memoryDir(cwd), memoryWriteDir(cwd, sessionDir), claudeProjectMemoryDir(cwd)]),\n  ];\n  for (const dir of roots) {\n    let entries: string[];\n    try {\n      entries = await readdir(dir);\n    } catch {\n      continue;\n    }\n    for (const entry of entries.sort()) {\n      const fact = await readMemoryFileIn(dir, entry);\n      if (fact !== undefined) facts.push(fact);\n    }\n  }\n\n  try {\n    facts.push(...parseFactsSection(await readFile(memoryMdPath(cwd), \"utf8\")));\n  } catch {\n    // no index yet — the per-memory files above are the whole store\n  }\n  return facts;\n}\n\n/**\n * One directory entry as a fact, or `undefined` when it is not one.\n *\n * `MEMORY.md` is the index, not a memory; a non-markdown entry is not a memory; and a markdown file\n * without the frontmatter is a note somebody wrote by hand. Turning any of those into a fact would\n * put text into recall that nobody recorded as one.\n *\n * The DIRECTORY is a parameter rather than derived from `cwd`, because both stores — this SDK's and\n * the one the Claude Code CLI keeps for the same project — read entries the same way, and a second\n * copy of this function is a second place for those three rules to drift.\n */\nasync function readMemoryFileIn(dir: string, entry: string): Promise<MemoryFact | undefined> {\n  if (!entry.endsWith(\".md\") || entry === \"MEMORY.md\") return undefined;\n  let raw: string;\n  try {\n    raw = await readFile(join(dir, entry), \"utf8\");\n  } catch {\n    return undefined; // vanished between readdir and read\n  }\n  const parsed = parseMemoryFile(raw);\n  if (parsed === undefined) return undefined;\n  // The BODY is the memory; `description` is the one-line recall aid. This SDK writes both the same,\n  // so nothing it wrote changes — but the Claude Code CLI writes a summary in `description` and the\n  // substance below it, and reading only the summary silently dropped the fact itself.\n  const body = parsed.body.trim();\n  return {\n    text: body.length > 0 ? body : parsed.description,\n    ...(parsed.kind !== undefined ? { kind: parsed.kind } : {}),\n    ...(parsed.modified !== undefined ? { modified: parsed.modified } : {}),\n  };\n}\n\n/**\n * Write a fact as its own memory file and point the `MEMORY.md` index at it. Atomic + serialized.\n *\n * `modified` is stamped HERE and never read from `fact`: a timestamp a caller can set is a\n * timestamp that can lie about when something was learned, and weighing recency is the point.\n */\nexport function appendFactToMarkdown(\n  cwd: string,\n  fact: MemoryFact,\n  targetDir: string = memoryDir(cwd),\n): Promise<void> {\n  return withCwdMutex(targetDir, async () => {\n    // Validate at the boundary (`error-handling.md` § 2): a kind outside the four would be written\n    // to a file recall later trusts, so it is refused here rather than stored and believed.\n    if (fact.kind !== undefined && !MEMORY_KINDS.includes(fact.kind)) {\n      throw new ConfigurationError(\n        `Unknown memory fact kind \"${fact.kind}\". Expected one of: ${MEMORY_KINDS.join(\", \")}.`,\n        { code: \"invalid_memory_kind\" },\n      );\n    }\n    const text = redactSecrets(fact.text);\n    const name = slugForFact(text);\n    await mkdir(targetDir, { recursive: true });\n    await replaceFileAtomic(\n      join(targetDir, `${name}.md`),\n      renderMemoryFile({\n        name,\n        description: text,\n        ...(fact.kind !== undefined ? { kind: fact.kind } : {}),\n        modified: new Date().toISOString(),\n        body: text,\n      }),\n    );\n    // The index lives BESIDE the files it lists. A `MEMORY.md` in one directory pointing at\n    // memories in another names files that are not there — and the CLI reads that index.\n    await replaceFileAtomic(join(targetDir, \"MEMORY.md\"), await nextIndex(targetDir, text, name));\n  });\n}\n\n/**\n * The `MEMORY.md` index with `name` present exactly once.\n *\n * Rewriting the same memory replaces its line rather than adding a second: the index is a map from\n * memory to file, and two lines for one file is a map that disagrees with itself.\n */\nasync function nextIndex(dir: string, text: string, name: string): Promise<string> {\n  let existing = \"\";\n  try {\n    // The index in the directory being WRITTEN, not the project one — see the caller.\n    existing = await readFile(join(dir, \"MEMORY.md\"), \"utf8\");\n  } catch {\n    existing = \"\";\n  }\n  const entry = `- [${text}](${name}.md)`;\n  const kept = existing\n    .split(\"\\n\")\n    .filter((line) => !line.startsWith(`- [`) || !line.includes(`](${name}.md)`));\n  const body = kept.join(\"\\n\").trimEnd();\n  const head = body.length > 0 ? body : MEMORY_MD_HEADER.trimEnd();\n  return `${head}\\n${entry}\\n`;\n}\n\n/** A `MEMORY.md` index entry: a link whose target is a sibling `.md` file. */\nconst INDEX_ENTRY = /^\\[[^\\]]*\\]\\([^)]+\\.md\\)$/;\n\n/**\n * Facts from a legacy `## Facts` section — the shape every released version wrote.\n *\n * Kept for reading only. The converged writer puts each memory in its own file, and this parser\n * exists so a store written by an earlier version keeps answering.\n *\n * There is no metadata to recover from a bullet: `kind` and `modified` are absent, which is exactly\n * right, since nothing recorded them. A brief encoding that carried them in a trailing HTML comment\n * (#389) never reached a published version — 4.55.0 was published at 17:23Z and that commit landed\n * at 20:06Z — so there is no store in the wild to migrate from it.\n */\nfunction parseFactsSection(raw: string): MemoryFact[] {\n  const idx = raw.indexOf(FACTS_HEADING);\n  if (idx === -1) return [];\n  const tail = raw.slice(idx + FACTS_HEADING.length);\n  // Stop at the next top-level or h2 heading.\n  const nextHeading = tail.search(/\\n#{1,2}\\s/);\n  const block = nextHeading === -1 ? tail : tail.slice(0, nextHeading);\n  return (\n    block\n      .split(\"\\n\")\n      .map((line) => line.trim())\n      .filter((line) => line.startsWith(\"- \"))\n      .map((line) => line.slice(2).trim())\n      // An index entry is a POINTER to a memory, not a memory. Both are `- ` bullets, and when a\n      // legacy `## Facts` heading is present the appended index lines land under it — counting them\n      // here would report every converged memory twice, once from its file and once from its link.\n      .filter((body) => !INDEX_ENTRY.test(body))\n      .map((body) => ({ text: body }))\n  );\n}\n\n/**\n * Every memory in the store, honouring the `enabled` gate on {@link MemoryConfig}: when memory is\n * disabled the call resolves to `[]` without touching disk. Configuration-aware entry point;\n * {@link readFactsFromMarkdown} is the same read without the gate.\n */\nexport async function readFacts(\n  cwd: string,\n  config: MemoryConfig,\n  memoryHome?: string,\n): Promise<MemoryFact[]> {\n  if (!config.enabled) return [];\n  return readFactsFromMarkdown(cwd, memoryHome);\n}\n\n/**\n * Record a fact, honouring the `enabled` gate on {@link MemoryConfig}: when memory is disabled the\n * call resolves without touching disk. Configuration-aware entry point;\n * {@link appendFactToMarkdown} is the same write without the gate.\n *\n * `memoryHome` is the agent's `local.sessionDir` when it has one — see {@link memoryWriteDir} for\n * which store that sends the fact to.\n */\nexport async function appendFact(\n  cwd: string,\n  config: MemoryConfig,\n  fact: MemoryFact,\n  memoryHome?: string,\n): Promise<void> {\n  if (!config.enabled) return;\n  await appendFactToMarkdown(cwd, fact, memoryWriteDir(cwd, memoryHome));\n}\n"]}

package/dist/{chunk-27AXGJMV.cjs → chunk-Y2KJ7MYO.cjs}

@@ -1,11 +1,9 @@
 'use strict';
 
 var chunkGHX4P3V2_cjs = require('./chunk-GHX4P3V2.cjs');
-var chunkKRD3GQAA_cjs = require('./chunk-KRD3GQAA.cjs');
+var chunkNY25NBZB_cjs = require('./chunk-NY25NBZB.cjs');
 var chunkR3UPQFKK_cjs = require('./chunk-R3UPQFKK.cjs');
-var chunkBUIK7GUA_cjs = require('./chunk-BUIK7GUA.cjs');
 var chunkSKXBJ2NU_cjs = require('./chunk-SKXBJ2NU.cjs');
-var chunkZF2LDKQQ_cjs = require('./chunk-ZF2LDKQQ.cjs');
 var chunkI6TGFUCO_cjs = require('./chunk-I6TGFUCO.cjs');
 var chunkK3FW2XZD_cjs = require('./chunk-K3FW2XZD.cjs');
 var chunkJTB5Q42C_cjs = require('./chunk-JTB5Q42C.cjs');
@@ -14,7 +12,6 @@ var promises = require('fs/promises');
 var path = require('path');
 var fs = require('fs');
 var module$1 = require('module');
-var os = require('os');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 // src/internal/memory/escape-like-pattern.ts
@@ -80,7 +77,7 @@ function defaultIndexPath(cwd) {
 }
 function requireLance() {
   try {
-    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-27AXGJMV.cjs', document.baseURI).href)));
+    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-Y2KJ7MYO.cjs', document.baseURI).href)));
     return r("@lancedb/lancedb");
   } catch (cause) {
     throw new chunkK3FW2XZD_cjs.ConfigurationError(
@@ -303,178 +300,9 @@ async function openLanceIndex(opts) {
   });
   return new LanceMemoryAdapter(lance);
 }
-var MEMORY_KINDS = ["user", "feedback", "project", "reference"];
-function legacyMemoryJsonPath(cwd, config) {
-  if (config.storePath !== void 0) {
-    return path.resolve(cwd, config.storePath);
-  }
-  const namespace = chunkR3UPQFKK_cjs.sanitizeIdentifier(config.namespace ?? "default");
-  const scope = chunkR3UPQFKK_cjs.sanitizeIdentifier(config.scope ?? "agent", { maxLen: 16 });
-  const userId = chunkR3UPQFKK_cjs.sanitizeIdentifier(config.userId ?? "default");
-  return chunkR3UPQFKK_cjs.safePathJoin(cwd, ".theokit", "memory", namespace, `${scope}-${userId}.json`);
-}
-
-// src/internal/memory/storage/memory-file.ts
-var SAFE_SLUG = /^[a-z0-9][a-z0-9_-]*$/;
-var MAX_SLUG_LENGTH = 64;
-function slugForFact(text) {
-  const slug = text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, MAX_SLUG_LENGTH).replace(/-+$/, "");
-  return SAFE_SLUG.test(slug) ? slug : chunkR3UPQFKK_cjs.safeFilenameForId(text);
-}
-function renderMemoryFile(fields) {
-  const metadata = ["  node_type: memory"];
-  if (fields.kind !== void 0) metadata.push(`  type: ${fields.kind}`);
-  if (fields.modified !== void 0) metadata.push(`  modified: ${fields.modified}`);
-  return [
-    "---",
-    `name: ${fields.name}`,
-    `description: ${JSON.stringify(fields.description)}`,
-    "metadata:",
-    ...metadata,
-    "---",
-    "",
-    fields.body,
-    ""
-  ].join("\n");
-}
-function parseMemoryFile(raw) {
-  const { yaml, body } = chunkKRD3GQAA_cjs.splitFrontmatter(raw);
-  if (yaml === void 0) return void 0;
-  let fields;
-  try {
-    fields = chunkKRD3GQAA_cjs.parseSimpleYaml(yaml);
-  } catch {
-    return void 0;
-  }
-  const name = fields.name;
-  const description = fields.description;
-  if (typeof name !== "string" || typeof description !== "string") return void 0;
-  const metadata = fields.metadata ?? {};
-  const rawKind = metadata.type;
-  const kind = typeof rawKind === "string" && MEMORY_KINDS.includes(rawKind) ? rawKind : void 0;
-  const modified = typeof metadata.modified === "string" ? metadata.modified : void 0;
-  return {
-    name,
-    description,
-    ...kind !== void 0 ? { kind } : {},
-    ...modified !== void 0 ? { modified } : {},
-    body: body.trim()
-  };
-}
-
-// src/internal/memory/storage/markdown-store.ts
-var MEMORY_MD_HEADER = "# Memory\n\n> Auto-managed by @theokit/sdk. Edit freely \u2014 the SDK reads from here.\n";
-var FACTS_HEADING = "## Facts";
-function memoryDir(cwd) {
-  return path.join(cwd, ".theokit", "memory");
-}
-function claudeProjectMemoryDir(cwd) {
-  const home = process.env.CLAUDE_CONFIG_DIR?.trim();
-  const root = home !== void 0 && home.length > 0 ? home : path.join(os.homedir(), ".claude");
-  return path.join(root, "projects", chunkBUIK7GUA_cjs.encodeProjectDir(cwd), "memory");
-}
-function memoryMdPath(cwd) {
-  return path.join(memoryDir(cwd), "MEMORY.md");
-}
-function notesDir(cwd) {
-  return path.join(memoryDir(cwd), "notes");
-}
-async function readFactsFromMarkdown(cwd) {
-  const facts = [];
-  for (const dir of [memoryDir(cwd), claudeProjectMemoryDir(cwd)]) {
-    let entries;
-    try {
-      entries = await promises.readdir(dir);
-    } catch {
-      continue;
-    }
-    for (const entry of entries.sort()) {
-      const fact = await readMemoryFileIn(dir, entry);
-      if (fact !== void 0) facts.push(fact);
-    }
-  }
-  try {
-    facts.push(...parseFactsSection(await promises.readFile(memoryMdPath(cwd), "utf8")));
-  } catch {
-  }
-  return facts;
-}
-async function readMemoryFileIn(dir, entry) {
-  if (!entry.endsWith(".md") || entry === "MEMORY.md") return void 0;
-  let raw;
-  try {
-    raw = await promises.readFile(path.join(dir, entry), "utf8");
-  } catch {
-    return void 0;
-  }
-  const parsed = parseMemoryFile(raw);
-  if (parsed === void 0) return void 0;
-  const body = parsed.body.trim();
-  return {
-    text: body.length > 0 ? body : parsed.description,
-    ...parsed.kind !== void 0 ? { kind: parsed.kind } : {},
-    ...parsed.modified !== void 0 ? { modified: parsed.modified } : {}
-  };
-}
-function appendFactToMarkdown(cwd, fact) {
-  return chunkZF2LDKQQ_cjs.withCwdMutex(memoryDir(cwd), async () => {
-    if (fact.kind !== void 0 && !MEMORY_KINDS.includes(fact.kind)) {
-      throw new chunkK3FW2XZD_cjs.ConfigurationError(
-        `Unknown memory fact kind "${fact.kind}". Expected one of: ${MEMORY_KINDS.join(", ")}.`,
-        { code: "invalid_memory_kind" }
-      );
-    }
-    const text = chunkJTB5Q42C_cjs.redactSecrets(fact.text);
-    const name = slugForFact(text);
-    await promises.mkdir(memoryDir(cwd), { recursive: true });
-    await chunkI6TGFUCO_cjs.replaceFileAtomic(
-      path.join(memoryDir(cwd), `${name}.md`),
-      renderMemoryFile({
-        name,
-        description: text,
-        ...fact.kind !== void 0 ? { kind: fact.kind } : {},
-        modified: (/* @__PURE__ */ new Date()).toISOString(),
-        body: text
-      })
-    );
-    await chunkI6TGFUCO_cjs.replaceFileAtomic(memoryMdPath(cwd), await nextIndex(cwd, text, name));
-  });
-}
-async function nextIndex(cwd, text, name) {
-  let existing = "";
-  try {
-    existing = await promises.readFile(memoryMdPath(cwd), "utf8");
-  } catch {
-    existing = "";
-  }
-  const entry = `- [${text}](${name}.md)`;
-  const kept = existing.split("\n").filter((line) => !line.startsWith(`- [`) || !line.includes(`](${name}.md)`));
-  const body = kept.join("\n").trimEnd();
-  const head = body.length > 0 ? body : MEMORY_MD_HEADER.trimEnd();
-  return `${head}
-${entry}
-`;
-}
-var INDEX_ENTRY = /^\[[^\]]*\]\([^)]+\.md\)$/;
-function parseFactsSection(raw) {
-  const idx = raw.indexOf(FACTS_HEADING);
-  if (idx === -1) return [];
-  const tail = raw.slice(idx + FACTS_HEADING.length);
-  const nextHeading = tail.search(/\n#{1,2}\s/);
-  const block = nextHeading === -1 ? tail : tail.slice(0, nextHeading);
-  return block.split("\n").map((line) => line.trim()).filter((line) => line.startsWith("- ")).map((line) => line.slice(2).trim()).filter((body) => !INDEX_ENTRY.test(body)).map((body) => ({ text: body }));
-}
-async function readFacts(cwd, config) {
-  if (!config.enabled) return [];
-  return readFactsFromMarkdown(cwd);
-}
-async function appendFact(cwd, config, fact) {
-  if (!config.enabled) return;
-  await appendFactToMarkdown(cwd, fact);
-}
 var MAX_TURN_CHARS = 2e3;
 function sessionsDir(cwd) {
-  return path.join(memoryDir(cwd), "sessions");
+  return path.join(chunkNY25NBZB_cjs.memoryDir(cwd), "sessions");
 }
 function sessionSummaryPath(cwd, runId) {
   return path.join(sessionsDir(cwd), `${chunkR3UPQFKK_cjs.safeFilenameForId(runId, { maxLen: 128 })}.md`);
@@ -518,7 +346,7 @@ async function discoverSessionFiles(cwd) {
   } catch {
     return [];
   }
-  const root = memoryDir(cwd);
+  const root = chunkNY25NBZB_cjs.memoryDir(cwd);
   return entries.filter((entry) => entry.endsWith(".md")).map((entry) => {
     const absolutePath = path.join(sessionsDir(cwd), entry);
     return {
@@ -532,7 +360,7 @@ function relativeToRoot(root, absolutePath) {
   return absolutePath;
 }
 function wikiDir(cwd) {
-  return path.join(memoryDir(cwd), "wiki");
+  return path.join(chunkNY25NBZB_cjs.memoryDir(cwd), "wiki");
 }
 async function discoverWikiFiles(cwd) {
   let entries;
@@ -541,7 +369,7 @@ async function discoverWikiFiles(cwd) {
   } catch {
     return [];
   }
-  const root = memoryDir(cwd);
+  const root = chunkNY25NBZB_cjs.memoryDir(cwd);
   return entries.filter((entry) => entry.endsWith(".md")).map((entry) => ({
     absolutePath: path.join(wikiDir(cwd), entry),
     relPath: path.join("wiki", entry)
@@ -590,19 +418,19 @@ async function markdownFilesIn(dir, root, skip = []) {
   }));
 }
 async function collectMarkdownFiles(cwd) {
-  const root = memoryDir(cwd);
+  const root = chunkNY25NBZB_cjs.memoryDir(cwd);
   const results = [];
   try {
-    await promises.stat(memoryMdPath(cwd));
+    await promises.stat(chunkNY25NBZB_cjs.memoryMdPath(cwd));
     results.push({
-      absolutePath: memoryMdPath(cwd),
-      relPath: path.relative(root, memoryMdPath(cwd)),
+      absolutePath: chunkNY25NBZB_cjs.memoryMdPath(cwd),
+      relPath: path.relative(root, chunkNY25NBZB_cjs.memoryMdPath(cwd)),
       source: "memory"
     });
   } catch {
   }
-  results.push(...await markdownFilesIn(memoryDir(cwd), root, ["MEMORY.md"]));
-  results.push(...await markdownFilesIn(notesDir(cwd), root));
+  results.push(...await markdownFilesIn(chunkNY25NBZB_cjs.memoryDir(cwd), root, ["MEMORY.md"]));
+  results.push(...await markdownFilesIn(chunkNY25NBZB_cjs.notesDir(cwd), root));
   const wikiFiles = await discoverWikiFiles(cwd);
   for (const wiki of wikiFiles) {
     results.push({
@@ -1059,17 +887,9 @@ var IndexManager = class _IndexManager {
 
 exports.IndexManager = IndexManager;
 exports.LanceIndex = LanceIndex;
-exports.MEMORY_KINDS = MEMORY_KINDS;
-exports.appendFact = appendFact;
-exports.appendFactToMarkdown = appendFactToMarkdown;
 exports.defaultIndexPath = defaultIndexPath;
 exports.lanceStoragePath = lanceStoragePath;
-exports.legacyMemoryJsonPath = legacyMemoryJsonPath;
-exports.memoryDir = memoryDir;
-exports.memoryMdPath = memoryMdPath;
 exports.openMemoryDb = openMemoryDb;
-exports.readFacts = readFacts;
-exports.readFactsFromMarkdown = readFactsFromMarkdown;
 exports.writeSessionSummary = writeSessionSummary;
-//# sourceMappingURL=chunk-27AXGJMV.cjs.map
-//# sourceMappingURL=chunk-27AXGJMV.cjs.map
+//# sourceMappingURL=chunk-Y2KJ7MYO.cjs.map
+//# sourceMappingURL=chunk-Y2KJ7MYO.cjs.map