@theglitchking/semantic-memory 1.2.2 → 1.5.1

package/dist/chunk-CSXZ7QUU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/crud.ts","../src/core/frontmatter.ts","../src/core/watcher.ts","../src/core/ingest.ts","../src/core/index-regen.ts","../src/core/patch.ts","../src/core/synthesize.ts","../src/core/agents-contract.ts"],"sourcesContent":["import { readFile, writeFile, unlink, rename, mkdir } from \"node:fs/promises\";\nimport { dirname, join, relative } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { glob } from \"glob\";\nimport matter from \"gray-matter\";\nimport type { UpdateNoteOptions } from \"./types.js\";\n\nexport class NoteCrud {\n  private notesPath: string;\n\n  constructor(notesPath: string) {\n    this.notesPath = notesPath;\n  }\n\n  async create(\n    relativePath: string,\n    content: string,\n    frontmatter?: Record<string, unknown>\n  ): Promise<string> {\n    const absPath = join(this.notesPath, relativePath);\n    if (existsSync(absPath)) {\n      throw new Error(`Note already exists: ${relativePath}`);\n    }\n\n    await mkdir(dirname(absPath), { recursive: true });\n\n    // Merge auto-stamps with caller-supplied frontmatter (caller wins on conflicts)\n    const stamps = computeStamps(content);\n    const merged = { ...stamps, ...(frontmatter ?? {}) };\n    const fileContent = matter.stringify(content, merged);\n\n    await writeFile(absPath, fileContent, \"utf-8\");\n    return relativePath;\n  }\n\n  async read(relativePath: string): Promise<string> {\n    const absPath = join(this.notesPath, relativePath);\n    return readFile(absPath, \"utf-8\");\n  }\n\n  async readMultiple(paths: string[]): Promise<Map<string, string>> {\n    const results = new Map<string, string>();\n    await Promise.all(\n      paths.map(async (p) => {\n        try {\n          const content = await this.read(p);\n          results.set(p, content);\n        } catch {\n          results.set(p, `[Error: could not read ${p}]`);\n        }\n      })\n    );\n    return results;\n  }\n\n  async update(\n    relativePath: string,\n    content: string,\n    options: UpdateNoteOptions\n  ): Promise<void> {\n    const absPath = join(this.notesPath, relativePath);\n    if (!existsSync(absPath)) {\n      throw new Error(`Note does not exist: ${relativePath}`);\n    }\n\n    const existing = await readFile(absPath, \"utf-8\");\n\n    let updated: string;\n\n    switch (options.mode) {\n      case \"overwrite\":\n        updated = content;\n        break;\n\n      case \"append\":\n        updated = existing + \"\\n\" + content;\n        break;\n\n      case \"prepend\": {\n        const { data, content: body } = matter(existing);\n        const newBody = content + \"\\n\" + body;\n        updated = Object.keys(data).length > 0 ? matter.stringify(newBody, data) : newBody;\n        break;\n      }\n\n      case \"patch-by-heading\": {\n        if (!options.heading) throw new Error(\"patch-by-heading requires a heading\");\n        updated = this.patchByHeading(existing, options.heading, content);\n        break;\n      }\n    }\n\n    // Re-parse the final content and inject updated stamps\n    // (preserves all existing frontmatter, only overwrites the three auto fields)\n    const { data: existingFm, content: body } = matter(updated);\n    const stamps = computeStamps(body);\n    const newFm = { ...existingFm, ...stamps };\n    await writeFile(absPath, matter.stringify(body, newFm), \"utf-8\");\n  }\n\n  async delete(relativePath: string): Promise<void> {\n    const absPath = join(this.notesPath, relativePath);\n    if (!existsSync(absPath)) {\n      throw new Error(`Note does not exist: ${relativePath}`);\n    }\n    await unlink(absPath);\n  }\n\n  async move(fromPath: string, toPath: string): Promise<void> {\n    const absFrom = join(this.notesPath, fromPath);\n    const absTo = join(this.notesPath, toPath);\n\n    if (!existsSync(absFrom)) {\n      throw new Error(`Note does not exist: ${fromPath}`);\n    }\n    if (existsSync(absTo)) {\n      throw new Error(`Destination already exists: ${toPath}`);\n    }\n\n    await mkdir(dirname(absTo), { recursive: true });\n    await rename(absFrom, absTo);\n\n    // Update wikilinks in other files that reference the old path\n    await this.updateWikilinksAfterMove(fromPath, toPath);\n  }\n\n  private async updateWikilinksAfterMove(\n    oldPath: string,\n    newPath: string\n  ): Promise<void> {\n    const oldName = oldPath.replace(/\\.md$/, \"\").split(\"/\").pop()!;\n    const newName = newPath.replace(/\\.md$/, \"\").split(\"/\").pop()!;\n\n    if (oldName === newName) return;\n\n    const files = await glob(\"**/*.md\", { cwd: this.notesPath });\n\n    for (const file of files) {\n      const absPath = join(this.notesPath, file);\n      const content = await readFile(absPath, \"utf-8\");\n\n      const pattern = new RegExp(`\\\\[\\\\[${escapeRegex(oldName)}(\\\\|[^\\\\]]*)?\\\\]\\\\]`, \"g\");\n      if (!pattern.test(content)) continue;\n\n      const updated = content.replace(pattern, `[[${newName}$1]]`);\n      await writeFile(absPath, updated, \"utf-8\");\n    }\n  }\n\n  private patchByHeading(\n    content: string,\n    heading: string,\n    newContent: string\n  ): string {\n    const lines = content.split(\"\\n\");\n    const headingPattern = new RegExp(`^#{1,6}\\\\s+${escapeRegex(heading)}\\\\s*$`, \"i\");\n\n    let headingIndex = -1;\n    let headingLevel = 0;\n\n    for (let i = 0; i < lines.length; i++) {\n      if (headingPattern.test(lines[i])) {\n        headingIndex = i;\n        const match = lines[i].match(/^(#{1,6})\\s+/);\n        headingLevel = match ? match[1].length : 1;\n        break;\n      }\n    }\n\n    if (headingIndex === -1) {\n      throw new Error(`Heading not found: ${heading}`);\n    }\n\n    // Find the end of this section (next heading of same or higher level)\n    let endIndex = lines.length;\n    for (let i = headingIndex + 1; i < lines.length; i++) {\n      const match = lines[i].match(/^(#{1,6})\\s+/);\n      if (match && match[1].length <= headingLevel) {\n        endIndex = i;\n        break;\n      }\n    }\n\n    const before = lines.slice(0, headingIndex + 1);\n    const after = lines.slice(endIndex);\n\n    return [...before, \"\", newContent, \"\", ...after].join(\"\\n\");\n  }\n}\n\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\n/**\n * Compute the three auto-stamp fields from note body text.\n * These are always factual/computable — no editorial judgment required.\n * - last_updated: today's date (YYYY-MM-DD)\n * - word_count: whitespace-separated token count\n * - estimated_read_time: assumes ~200 wpm average reading speed\n */\nfunction computeStamps(body: string): Record<string, unknown> {\n  const today = new Date().toISOString().slice(0, 10); // YYYY-MM-DD\n  const wordCount = body.trim() ? body.trim().split(/\\s+/).length : 0;\n  const minutes = Math.max(1, Math.ceil(wordCount / 200));\n  return {\n    last_updated: today,\n    word_count: wordCount,\n    estimated_read_time: `${minutes} min read`,\n  };\n}\n","import { readFile, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { glob } from \"glob\";\nimport matter from \"gray-matter\";\n\nexport class FrontmatterManager {\n  private notesPath: string;\n\n  constructor(notesPath: string) {\n    this.notesPath = notesPath;\n  }\n\n  async get(relativePath: string): Promise<Record<string, unknown>> {\n    const absPath = join(this.notesPath, relativePath);\n    const raw = await readFile(absPath, \"utf-8\");\n    const { data } = matter(raw);\n    return data;\n  }\n\n  async update(\n    relativePath: string,\n    fields: Record<string, unknown>\n  ): Promise<void> {\n    const absPath = join(this.notesPath, relativePath);\n    const raw = await readFile(absPath, \"utf-8\");\n    const { data, content } = matter(raw);\n\n    for (const [key, value] of Object.entries(fields)) {\n      if (value === null || value === undefined) {\n        delete data[key];\n      } else {\n        data[key] = value;\n      }\n    }\n\n    const updated = matter.stringify(content, data);\n    await writeFile(absPath, updated, \"utf-8\");\n  }\n}\n\nexport class TagManager {\n  private notesPath: string;\n\n  constructor(notesPath: string) {\n    this.notesPath = notesPath;\n  }\n\n  async list(relativePath: string): Promise<string[]> {\n    const absPath = join(this.notesPath, relativePath);\n    const raw = await readFile(absPath, \"utf-8\");\n    const { data, content } = matter(raw);\n\n    const fmTags = Array.isArray(data.tags) ? (data.tags as string[]) : [];\n    const inlineTags = [...content.matchAll(/(?:^|\\s)#([a-zA-Z][\\w-/]*)/g)].map(\n      (m) => m[1]\n    );\n\n    return [...new Set([...fmTags, ...inlineTags])];\n  }\n\n  async add(relativePath: string, tags: string[]): Promise<void> {\n    const absPath = join(this.notesPath, relativePath);\n    const raw = await readFile(absPath, \"utf-8\");\n    const { data, content } = matter(raw);\n\n    const existing = Array.isArray(data.tags) ? (data.tags as string[]) : [];\n    const merged = [...new Set([...existing, ...tags])];\n    data.tags = merged;\n\n    const updated = matter.stringify(content, data);\n    await writeFile(absPath, updated, \"utf-8\");\n  }\n\n  async remove(relativePath: string, tags: string[]): Promise<void> {\n    const absPath = join(this.notesPath, relativePath);\n    const raw = await readFile(absPath, \"utf-8\");\n    const { data, content } = matter(raw);\n\n    // Remove from frontmatter\n    if (Array.isArray(data.tags)) {\n      data.tags = (data.tags as string[]).filter((t) => !tags.includes(t));\n    }\n\n    // Remove inline tags\n    let updatedContent = content;\n    for (const tag of tags) {\n      const pattern = new RegExp(`(^|\\\\s)#${escapeRegex(tag)}(?=\\\\s|$)`, \"g\");\n      updatedContent = updatedContent.replace(pattern, \"$1\");\n    }\n\n    const updated = matter.stringify(updatedContent, data);\n    await writeFile(absPath, updated, \"utf-8\");\n  }\n\n  async renameVaultWide(oldTag: string, newTag: string): Promise<number> {\n    const files = await glob(\"**/*.md\", { cwd: this.notesPath });\n    let count = 0;\n\n    for (const file of files) {\n      const absPath = join(this.notesPath, file);\n      const raw = await readFile(absPath, \"utf-8\");\n      const { data, content } = matter(raw);\n      let changed = false;\n\n      // Rename in frontmatter\n      if (Array.isArray(data.tags)) {\n        const idx = (data.tags as string[]).indexOf(oldTag);\n        if (idx >= 0) {\n          (data.tags as string[])[idx] = newTag;\n          changed = true;\n        }\n      }\n\n      // Rename inline tags\n      const pattern = new RegExp(`(^|\\\\s)#${escapeRegex(oldTag)}(?=\\\\s|$)`, \"g\");\n      const updatedContent = content.replace(pattern, `$1#${newTag}`);\n      if (updatedContent !== content) changed = true;\n\n      if (changed) {\n        const updated = matter.stringify(updatedContent, data);\n        await writeFile(absPath, updated, \"utf-8\");\n        count++;\n      }\n    }\n\n    return count;\n  }\n}\n\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n","import { watch, type FSWatcher } from \"chokidar\";\nimport { EventEmitter } from \"node:events\";\n\nexport interface WatcherEvents {\n  changed: (paths: string[]) => void;\n  error: (error: Error) => void;\n}\n\nexport class Watcher extends EventEmitter {\n  private notesPath: string;\n  private fsWatcher: FSWatcher | null = null;\n  private debounceMs: number;\n  private pendingChanges = new Set<string>();\n  private debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  private readyPromise: Promise<void> | null = null;\n  private usePolling: boolean;\n\n  constructor(notesPath: string, debounceMs: number = 500, usePolling: boolean = false) {\n    super();\n    this.notesPath = notesPath;\n    this.debounceMs = debounceMs;\n    this.usePolling = usePolling;\n  }\n\n  start(): void {\n    if (this.fsWatcher) return;\n\n    this.fsWatcher = watch(\"**/*.md\", {\n      cwd: this.notesPath,\n      ignoreInitial: true,\n      followSymlinks: true,\n      ignored: [\n        \"**/node_modules/**\",\n        \"**/.semantic-sidekick-index/**\",\n        \"**/.git/**\",\n      ],\n      ...(this.usePolling ? { usePolling: true, interval: 100 } : {}),\n    });\n\n    this.readyPromise = new Promise<void>((resolve) => {\n      this.fsWatcher!.on(\"ready\", resolve);\n    });\n\n    this.fsWatcher.on(\"add\", (path) => this.enqueue(path));\n    this.fsWatcher.on(\"change\", (path) => this.enqueue(path));\n    this.fsWatcher.on(\"unlink\", (path) => this.enqueue(path));\n    this.fsWatcher.on(\"error\", (err) => this.emit(\"error\", err));\n  }\n\n  async ready(): Promise<void> {\n    if (this.readyPromise) await this.readyPromise;\n  }\n\n  stop(): void {\n    if (this.debounceTimer) clearTimeout(this.debounceTimer);\n    this.fsWatcher?.close();\n    this.fsWatcher = null;\n    this.pendingChanges.clear();\n  }\n\n  private enqueue(path: string): void {\n    this.pendingChanges.add(path);\n\n    if (this.debounceTimer) clearTimeout(this.debounceTimer);\n    this.debounceTimer = setTimeout(() => {\n      const paths = [...this.pendingChanges];\n      this.pendingChanges.clear();\n      this.emit(\"changed\", paths);\n    }, this.debounceMs);\n  }\n}\n","import { basename } from \"node:path\";\nimport type { ChangeSet, PatchCreate } from \"./patch.js\";\n\nexport interface IngestSource {\n  /** Identifier of the source — URL, filesystem path, DOI, ISBN, etc. */\n  source_uri: string;\n  /** Human-readable title for the source-note's frontmatter */\n  source_title: string;\n  /** One of the schema types; typically \"source\" */\n  source_type?: string;\n  /** Path under the vault to write the source-note. Defaults to `sources/<slug>.md`. */\n  source_path?: string;\n  /** Free-form body for the source-note (summary, abstract, your notes on it) */\n  source_summary?: string;\n  /** Tags for the source-note */\n  source_tags?: string[];\n}\n\nexport interface IngestUnit {\n  /** Path under the vault where this extracted note should live */\n  path: string;\n  /** Note title — if absent, derived from basename */\n  title?: string;\n  /** Note body — markdown */\n  content: string;\n  /** Schema type. Default: \"note\". */\n  type?: string;\n  /** Additional wikilink-style derived_from targets beyond the source-note */\n  extra_derived_from?: string[];\n  /** Additional free-form frontmatter fields */\n  extra_frontmatter?: Record<string, unknown>;\n  /** Per-unit confidence override */\n  confidence?: string;\n}\n\nexport interface IngestInput {\n  source: IngestSource;\n  units: IngestUnit[];\n  /** If true, the existing source-note is updated if present; else an error is raised */\n  allow_existing_source?: boolean;\n}\n\nexport interface IngestPreview {\n  changeset: ChangeSet;\n  sourcePath: string;\n  unitPaths: string[];\n}\n\n/**\n * Build a ChangeSet for ingesting a source into the vault.\n *\n * Shape: one create for the source-note (type=source) + one create per unit,\n * each stamped with `derived_from: [<source-path>]` so lint.missing_provenance\n * is satisfied automatically and the graph reflects the provenance edge.\n *\n * Intentionally does NOT touch the filesystem — callers route the result\n * through applyPatch for atomicity, validation, and rollback.\n */\nexport function buildIngestChangeSet(input: IngestInput): IngestPreview {\n  const today = new Date().toISOString().slice(0, 10);\n  const sourcePath = input.source.source_path ?? defaultSourcePath(input.source);\n\n  const sourceNote: PatchCreate = {\n    path: sourcePath,\n    content: buildSourceBody(input.source),\n    frontmatter: {\n      title: input.source.source_title,\n      type: input.source.source_type ?? \"source\",\n      status: \"active\",\n      source: input.source.source_uri,\n      last_verified: today,\n      confidence: \"high\",\n      ...(input.source.source_tags && input.source.source_tags.length > 0 && { tags: input.source.source_tags }),\n    },\n  };\n\n  const unitCreates: PatchCreate[] = input.units.map((u) => {\n    const title = u.title ?? titleFromPath(u.path);\n    const derivedFrom = [sourcePath, ...(u.extra_derived_from ?? [])];\n    return {\n      path: u.path.endsWith(\".md\") ? u.path : u.path + \".md\",\n      content: u.content.startsWith(\"#\") ? u.content : `# ${title}\\n\\n${u.content.trim()}\\n`,\n      frontmatter: {\n        title,\n        type: u.type ?? \"note\",\n        status: \"active\",\n        derived_from: derivedFrom,\n        last_verified: today,\n        confidence: u.confidence ?? \"medium\",\n        ...(u.extra_frontmatter ?? {}),\n      },\n    };\n  });\n\n  return {\n    changeset: { creates: [sourceNote, ...unitCreates] },\n    sourcePath,\n    unitPaths: unitCreates.map((c) => c.path),\n  };\n}\n\nfunction buildSourceBody(source: IngestSource): string {\n  const lines = [`# ${source.source_title}`, \"\", `**Source:** ${source.source_uri}`, \"\"];\n  if (source.source_summary) {\n    lines.push(source.source_summary.trim(), \"\");\n  } else {\n    lines.push(\"_Summary not provided — fill in when referencing this source._\", \"\");\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction defaultSourcePath(source: IngestSource): string {\n  const slug = slugify(source.source_title);\n  return `sources/${slug}.md`;\n}\n\nfunction titleFromPath(p: string): string {\n  return basename(p).replace(/\\.md$/, \"\").replace(/[-_]/g, \" \");\n}\n\nfunction slugify(s: string): string {\n  return s\n    .toLowerCase()\n    .replace(/[^\\w\\s-]/g, \"\")\n    .replace(/\\s+/g, \"-\")\n    .replace(/-+/g, \"-\")\n    .replace(/^-|-$/g, \"\")\n    .slice(0, 80);\n}\n","import { readdir, readFile, writeFile, stat } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { join, dirname, basename, sep } from \"node:path\";\nimport matter from \"gray-matter\";\n\nexport const INDEX_FILE = \"INDEX.md\";\nexport const INDEX_OVERFLOW_THRESHOLD = 100; // entries before we warn about splitting\n\nexport interface IndexEntry {\n  path: string; // relative to the directory\n  title: string;\n  summary?: string;\n}\n\nexport interface RegenResult {\n  directory: string;\n  indexPath: string;\n  entryCount: number;\n  overflowed: boolean;\n  wrote: boolean;\n}\n\n/**\n * Regenerate INDEX.md for a single vault directory.\n * Lists every *.md file in the directory (non-recursive, excluding the index itself)\n * with its title (frontmatter or first heading) and optional summary (from frontmatter\n * `purpose` or first non-heading paragraph).\n */\nexport async function regenDirectoryIndex(vaultPath: string, dirRel: string): Promise<RegenResult> {\n  const absDir = join(vaultPath, dirRel);\n  const indexPath = join(absDir, INDEX_FILE);\n  const relIndex = join(dirRel, INDEX_FILE);\n\n  if (!existsSync(absDir)) {\n    return { directory: dirRel, indexPath: relIndex, entryCount: 0, overflowed: false, wrote: false };\n  }\n\n  const files = (await readdir(absDir)).filter(\n    (f) => f.endsWith(\".md\") && f !== INDEX_FILE && f !== \"README.md\"\n  );\n\n  const entries: IndexEntry[] = [];\n  for (const f of files) {\n    const full = join(absDir, f);\n    try {\n      const st = await stat(full);\n      if (!st.isFile()) continue;\n      const raw = await readFile(full, \"utf-8\");\n      const { data, content } = matter(raw);\n      const title = typeof data.title === \"string\" ? data.title : firstHeading(content) ?? basenameNoExt(f);\n      const summary = typeof data.purpose === \"string\" ? data.purpose : firstParagraph(content);\n      entries.push({ path: f, title, summary });\n    } catch {\n      /* skip unreadable */\n    }\n  }\n\n  entries.sort((a, b) => a.title.localeCompare(b.title));\n  const body = renderIndex(dirRel, entries);\n  const overflowed = entries.length > INDEX_OVERFLOW_THRESHOLD;\n\n  let wrote = false;\n  if (existsSync(indexPath)) {\n    const current = await readFile(indexPath, \"utf-8\");\n    if (current !== body) {\n      await writeFile(indexPath, body, \"utf-8\");\n      wrote = true;\n    }\n  } else {\n    await writeFile(indexPath, body, \"utf-8\");\n    wrote = true;\n  }\n\n  return { directory: dirRel, indexPath: relIndex, entryCount: entries.length, overflowed, wrote };\n}\n\n/**\n * Regenerate indexes for every directory affected by a set of paths.\n * Walks up the parent chain for each input so a deep change at\n * `a/b/c/note.md` regenerates `a/b/c/INDEX.md`. Does NOT recurse further —\n * `a/b/INDEX.md` stays as-is unless a path under `a/b/` (not `a/b/c/`)\n * also changed.\n */\nexport async function regenIndexesForPaths(\n  vaultPath: string,\n  paths: string[]\n): Promise<RegenResult[]> {\n  const dirs = new Set<string>();\n  for (const p of paths) {\n    const d = dirname(p);\n    if (d === \".\" || d === \"/\") continue;\n    dirs.add(d);\n  }\n  const results: RegenResult[] = [];\n  for (const d of dirs) {\n    results.push(await regenDirectoryIndex(vaultPath, d));\n  }\n  return results;\n}\n\nfunction renderIndex(dirRel: string, entries: IndexEntry[]): string {\n  const header = `# ${toTitle(dirRel)} Index\\n\\n> Auto-generated by semantic-sidekick. Changes are overwritten on apply_patch. Add prose to per-note files, not here.\\n\\n`;\n  if (entries.length === 0) return header + \"_No notes in this directory yet._\\n\";\n  const overflowNote =\n    entries.length > INDEX_OVERFLOW_THRESHOLD\n      ? `> ⚠️  ${entries.length} entries — consider splitting this directory into subfolders (threshold: ${INDEX_OVERFLOW_THRESHOLD}).\\n\\n`\n      : \"\";\n  const lines = entries.map((e) => {\n    const linkText = e.title;\n    const target = e.path.replace(/\\.md$/, \"\");\n    const summary = e.summary ? ` — ${truncate(e.summary, 140)}` : \"\";\n    return `- [${linkText}](./${e.path}) — \\`[[${target}]]\\`${summary}`;\n  });\n  return header + overflowNote + lines.join(\"\\n\") + \"\\n\";\n}\n\nfunction toTitle(dirRel: string): string {\n  return dirRel\n    .split(sep)\n    .pop()!\n    .replace(/[-_]/g, \" \")\n    .replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\nfunction basenameNoExt(p: string): string {\n  return basename(p).replace(/\\.md$/, \"\");\n}\n\nfunction firstHeading(content: string): string | null {\n  const m = content.match(/^\\s*#{1,6}\\s+(.+)$/m);\n  return m ? m[1].trim() : null;\n}\n\nfunction firstParagraph(content: string): string | undefined {\n  // Skip leading headings, then take the first line of non-heading text\n  const lines = content.split(\"\\n\");\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (!trimmed) continue;\n    if (trimmed.startsWith(\"#\")) continue;\n    if (trimmed.startsWith(\">\")) continue;\n    if (trimmed.startsWith(\"```\")) continue;\n    return trimmed.replace(/\\s+/g, \" \");\n  }\n  return undefined;\n}\n\nfunction truncate(s: string, n: number): string {\n  return s.length <= n ? s : s.slice(0, n - 1).trimEnd() + \"…\";\n}\n","import { readFile, writeFile, unlink, rename, mkdir } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport matter from \"gray-matter\";\nimport type { UpdateNoteOptions } from \"./types.js\";\nimport { NoteCrud } from \"./crud.js\";\nimport { loadSchema, validateNote, type LintFinding, type VaultSchema } from \"./schema.js\";\nimport { regenIndexesForPaths, type RegenResult } from \"./index-regen.js\";\n\nexport interface PatchCreate {\n  path: string;\n  content: string;\n  frontmatter?: Record<string, unknown>;\n}\n\nexport interface PatchUpdate {\n  path: string;\n  content: string;\n  mode: UpdateNoteOptions[\"mode\"];\n  heading?: string;\n}\n\nexport interface PatchDelete {\n  path: string;\n}\n\nexport interface PatchMove {\n  from: string;\n  to: string;\n}\n\nexport interface ChangeSet {\n  creates?: PatchCreate[];\n  updates?: PatchUpdate[];\n  deletes?: PatchDelete[];\n  moves?: PatchMove[];\n}\n\nexport interface ApplyPatchOptions {\n  dryRun?: boolean;\n  validate?: boolean;\n  allowLintWarnings?: boolean;\n  /** Regenerate INDEX.md in directories touched by this patch. Default: true. */\n  regenIndexes?: boolean;\n}\n\nexport interface AppliedOp {\n  op: \"create\" | \"update\" | \"delete\" | \"move\";\n  path: string;\n}\n\nexport interface ApplyPatchResult {\n  ok: boolean;\n  applied: AppliedOp[];\n  rolledBack: AppliedOp[];\n  lint: LintFinding[];\n  errors: string[];\n  /** Index files regenerated as a side-effect. Empty if regenIndexes=false or dry-run. */\n  indexes_regenerated?: RegenResult[];\n}\n\ninterface Snapshot {\n  op: \"create\" | \"update\" | \"delete\" | \"move\";\n  path: string;\n  absPath: string;\n  prevContent?: string; // for update/delete/move(from)\n  prevAbsPath?: string; // for move (prev location)\n}\n\n/**\n * Atomic multi-note patch with rollback. Applies creates → updates → moves → deletes\n * in that order. If any op fails, all successful ops before it are reverted in reverse.\n *\n * In dry-run mode, nothing is written; the result describes what would have happened,\n * including lint findings on the proposed state.\n */\nexport async function applyPatch(\n  notesPath: string,\n  changeset: ChangeSet,\n  options: ApplyPatchOptions = {}\n): Promise<ApplyPatchResult> {\n  const validate = options.validate !== false;\n  const dryRun = options.dryRun === true;\n  const allowWarn = options.allowLintWarnings !== false;\n\n  const errors: string[] = [];\n  const lint: LintFinding[] = [];\n  const applied: AppliedOp[] = [];\n  const snapshots: Snapshot[] = [];\n\n  const crud = new NoteCrud(notesPath);\n\n  let schema: VaultSchema | null = null;\n  if (validate) {\n    try {\n      schema = await loadSchema(notesPath);\n    } catch (e) {\n      errors.push(`failed to load schema: ${e instanceof Error ? e.message : String(e)}`);\n      return { ok: false, applied, rolledBack: [], lint, errors };\n    }\n  }\n\n  // Pre-check: collisions on creates, missing sources on updates/deletes/moves.\n  for (const c of changeset.creates ?? []) {\n    if (existsSync(join(notesPath, c.path))) {\n      errors.push(`create: already exists: ${c.path}`);\n    }\n  }\n  for (const u of changeset.updates ?? []) {\n    if (!existsSync(join(notesPath, u.path))) {\n      errors.push(`update: does not exist: ${u.path}`);\n    }\n  }\n  for (const d of changeset.deletes ?? []) {\n    if (!existsSync(join(notesPath, d.path))) {\n      errors.push(`delete: does not exist: ${d.path}`);\n    }\n  }\n  for (const m of changeset.moves ?? []) {\n    if (!existsSync(join(notesPath, m.from))) {\n      errors.push(`move: source does not exist: ${m.from}`);\n    }\n    if (existsSync(join(notesPath, m.to))) {\n      errors.push(`move: destination exists: ${m.to}`);\n    }\n  }\n\n  if (errors.length > 0) {\n    return { ok: false, applied, rolledBack: [], lint, errors };\n  }\n\n  // Lint pre-flight on proposed state. Simulate each create/update and validate.\n  if (validate && schema) {\n    for (const c of changeset.creates ?? []) {\n      const proposed = matter.stringify(c.content, c.frontmatter ?? {});\n      lint.push(...validateNote(c.path, proposed, schema));\n    }\n    for (const u of changeset.updates ?? []) {\n      const abs = join(notesPath, u.path);\n      let proposed: string;\n      try {\n        const existing = await readFile(abs, \"utf-8\");\n        proposed = applyUpdateInMemory(existing, u);\n      } catch (e) {\n        errors.push(`update precheck: ${u.path}: ${e instanceof Error ? e.message : String(e)}`);\n        continue;\n      }\n      lint.push(...validateNote(u.path, proposed, schema));\n    }\n\n    const schemaErrors = lint.filter((f) => f.rule === \"schema_violations\" && f.severity === \"error\");\n    if (schemaErrors.length > 0) {\n      errors.push(`${schemaErrors.length} schema violation(s) blocked the patch`);\n    }\n    if (!allowWarn) {\n      const warns = lint.filter((f) => f.severity === \"warn\");\n      if (warns.length > 0) errors.push(`${warns.length} lint warning(s) blocked the patch (allowLintWarnings=false)`);\n    }\n  }\n\n  if (errors.length > 0 || dryRun) {\n    return { ok: errors.length === 0, applied, rolledBack: [], lint, errors };\n  }\n\n  // Execute — capture snapshots as we go so rollback can reverse.\n  try {\n    for (const c of changeset.creates ?? []) {\n      const abs = join(notesPath, c.path);\n      await crud.create(c.path, c.content, c.frontmatter);\n      snapshots.push({ op: \"create\", path: c.path, absPath: abs });\n      applied.push({ op: \"create\", path: c.path });\n    }\n    for (const u of changeset.updates ?? []) {\n      const abs = join(notesPath, u.path);\n      const prev = await readFile(abs, \"utf-8\");\n      await crud.update(u.path, u.content, { mode: u.mode, heading: u.heading } as UpdateNoteOptions);\n      snapshots.push({ op: \"update\", path: u.path, absPath: abs, prevContent: prev });\n      applied.push({ op: \"update\", path: u.path });\n    }\n    for (const m of changeset.moves ?? []) {\n      await crud.move(m.from, m.to);\n      snapshots.push({\n        op: \"move\",\n        path: m.to,\n        absPath: join(notesPath, m.to),\n        prevAbsPath: join(notesPath, m.from),\n      });\n      applied.push({ op: \"move\", path: `${m.from} -> ${m.to}` });\n    }\n    for (const d of changeset.deletes ?? []) {\n      const abs = join(notesPath, d.path);\n      const prev = await readFile(abs, \"utf-8\");\n      await crud.delete(d.path);\n      snapshots.push({ op: \"delete\", path: d.path, absPath: abs, prevContent: prev });\n      applied.push({ op: \"delete\", path: d.path });\n    }\n  } catch (e) {\n    errors.push(`op failed: ${e instanceof Error ? e.message : String(e)} — rolling back`);\n    const rolledBack = await rollback(snapshots);\n    return { ok: false, applied, rolledBack, lint, errors };\n  }\n\n  let indexes_regenerated: RegenResult[] = [];\n  if (options.regenIndexes !== false) {\n    const touched = [\n      ...(changeset.creates ?? []).map((c) => c.path),\n      ...(changeset.deletes ?? []).map((d) => d.path),\n      ...(changeset.moves ?? []).flatMap((m) => [m.from, m.to]),\n    ];\n    try {\n      indexes_regenerated = await regenIndexesForPaths(notesPath, touched);\n    } catch (e) {\n      // Non-fatal: patch succeeded; index regen is a best-effort side effect.\n      errors.push(`index regen failed (patch still applied): ${e instanceof Error ? e.message : String(e)}`);\n    }\n  }\n\n  return { ok: true, applied, rolledBack: [], lint, errors, indexes_regenerated };\n}\n\nasync function rollback(snapshots: Snapshot[]): Promise<AppliedOp[]> {\n  const reverted: AppliedOp[] = [];\n  for (const s of snapshots.slice().reverse()) {\n    try {\n      switch (s.op) {\n        case \"create\":\n          if (existsSync(s.absPath)) await unlink(s.absPath);\n          reverted.push({ op: \"create\", path: s.path });\n          break;\n        case \"update\":\n          if (s.prevContent !== undefined) {\n            await writeFile(s.absPath, s.prevContent, \"utf-8\");\n          }\n          reverted.push({ op: \"update\", path: s.path });\n          break;\n        case \"delete\":\n          if (s.prevContent !== undefined) {\n            await mkdir(dirname(s.absPath), { recursive: true });\n            await writeFile(s.absPath, s.prevContent, \"utf-8\");\n          }\n          reverted.push({ op: \"delete\", path: s.path });\n          break;\n        case \"move\":\n          if (s.prevAbsPath && existsSync(s.absPath)) {\n            await mkdir(dirname(s.prevAbsPath), { recursive: true });\n            await rename(s.absPath, s.prevAbsPath);\n          }\n          reverted.push({ op: \"move\", path: s.path });\n          break;\n      }\n    } catch {\n      // swallow — best-effort rollback\n    }\n  }\n  return reverted;\n}\n\nfunction applyUpdateInMemory(existing: string, u: PatchUpdate): string {\n  switch (u.mode) {\n    case \"overwrite\":\n      return u.content;\n    case \"append\":\n      return existing + \"\\n\" + u.content;\n    case \"prepend\": {\n      const { data, content: body } = matter(existing);\n      const newBody = u.content + \"\\n\" + body;\n      return Object.keys(data).length > 0 ? matter.stringify(newBody, data) : newBody;\n    }\n    case \"patch-by-heading\": {\n      if (!u.heading) throw new Error(\"patch-by-heading requires heading\");\n      return patchByHeadingInMemory(existing, u.heading, u.content);\n    }\n  }\n}\n\nfunction patchByHeadingInMemory(content: string, heading: string, newContent: string): string {\n  const lines = content.split(\"\\n\");\n  const re = new RegExp(`^#{1,6}\\\\s+${heading.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")}\\\\s*$`, \"i\");\n  let idx = -1;\n  let level = 0;\n  for (let i = 0; i < lines.length; i++) {\n    if (re.test(lines[i])) {\n      idx = i;\n      const m = lines[i].match(/^(#{1,6})\\s+/);\n      level = m ? m[1].length : 1;\n      break;\n    }\n  }\n  if (idx === -1) throw new Error(`Heading not found: ${heading}`);\n  let end = lines.length;\n  for (let i = idx + 1; i < lines.length; i++) {\n    const m = lines[i].match(/^(#{1,6})\\s+/);\n    if (m && m[1].length <= level) {\n      end = i;\n      break;\n    }\n  }\n  return [...lines.slice(0, idx + 1), \"\", newContent, \"\", ...lines.slice(end)].join(\"\\n\");\n}\n","import { basename } from \"node:path\";\nimport type { ChangeSet, PatchCreate, PatchUpdate } from \"./patch.js\";\n\nexport interface SynthesizeNoteInput {\n  topic: string;\n  answer: string;\n  suggested_path: string;\n  type?: string;\n  sources?: string[];\n  derived_from?: string[];\n  related_notes?: string[];\n  status?: string;\n  confidence?: string;\n  decision_maker?: string;\n  decided_on?: string;\n  severity?: string;\n  /** Verbatim symptom phrases (the user's own words) — symptom-keyed for retrieval. */\n  symptoms?: string[];\n  extra_frontmatter?: Record<string, unknown>;\n  /**\n   * When true, the resulting note is filed under `proposals/<date>-<slug>.md` with\n   * `status: proposal` frontmatter, regardless of `suggested_path`. The original path\n   * is preserved as `proposed_target` in frontmatter so `synthesize_promote` knows\n   * where to move it on acceptance.\n   */\n  proposal?: boolean;\n  /**\n   * When provided alongside `proposal: true`, used as the proposal subdirectory name.\n   * Defaults to \"proposals\". Useful for callers that want to segregate by source\n   * (e.g. \"proposals/research\", \"proposals/outage\").\n   */\n  proposal_subdir?: string;\n}\n\nexport interface SynthesizePreview {\n  changeset: ChangeSet;\n  path: string;\n  title: string;\n  /** True when the preview is a proposal — caller (or `synthesize_promote`) must move it later. */\n  is_proposal?: boolean;\n  /** When `is_proposal` is true, the canonical path that `synthesize_promote` should move it to. */\n  proposed_target?: string;\n}\n\n/**\n * Convert a query answer + provenance into a ChangeSet that can be fed to applyPatch.\n * The shaped note includes provenance frontmatter and auto-inserts [[wikilinks]] for\n * any related_notes that appear as bare titles in the body.\n *\n * Does NOT write to disk — always returns a ChangeSet. Callers pass it to applyPatch.\n *\n * Proposal mode: when `proposal: true`, the path is rewritten to\n * `<proposal_subdir>/<YYYY-MM-DD>-<slug>.md`, the `status` is forced to `proposal`,\n * and `proposed_target` records the original suggested path. `synthesize_promote`\n * later moves the file to that target and clears the proposal frontmatter.\n */\nexport function buildSynthesizeChangeSet(input: SynthesizeNoteInput): SynthesizePreview {\n  const today = new Date().toISOString().slice(0, 10);\n  const title = input.topic.trim();\n  const canonicalPath = input.suggested_path.endsWith(\".md\") ? input.suggested_path : input.suggested_path + \".md\";\n\n  const isProposal = input.proposal === true;\n  const subdir = (input.proposal_subdir ?? \"proposals\").replace(/\\/+$/, \"\");\n  const slug = slugForTopic(title);\n  const path = isProposal ? `${subdir}/${today}-${slug}.md` : canonicalPath;\n\n  const frontmatter: Record<string, unknown> = {\n    title,\n    type: input.type ?? \"note\",\n    status: isProposal ? \"proposal\" : (input.status ?? \"active\"),\n    last_verified: today,\n    confidence: input.confidence ?? \"medium\",\n    ...(input.sources && input.sources.length > 0 && { sources: input.sources }),\n    ...(input.derived_from && input.derived_from.length > 0 && { derived_from: input.derived_from }),\n    ...(input.decision_maker && { decision_maker: input.decision_maker }),\n    ...(input.decided_on && { decided_on: input.decided_on }),\n    ...(input.severity && { severity: input.severity }),\n    ...(input.symptoms && input.symptoms.length > 0 && { symptoms: input.symptoms }),\n    ...(isProposal && { proposed_target: canonicalPath }),\n    ...(input.extra_frontmatter ?? {}),\n  };\n\n  const body = buildBody(title, input.answer, input.related_notes ?? []);\n\n  const create: PatchCreate = { path, content: body, frontmatter };\n  const changeset: ChangeSet = { creates: [create] };\n\n  return {\n    changeset,\n    path,\n    title,\n    ...(isProposal && { is_proposal: true, proposed_target: canonicalPath }),\n  };\n}\n\nfunction slugForTopic(topic: string): string {\n  return topic\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 60) || \"untitled\";\n}\n\nfunction buildBody(title: string, answer: string, relatedNotes: string[]): string {\n  let body = `# ${title}\\n\\n${answer.trim()}\\n`;\n\n  if (relatedNotes.length > 0) {\n    body = autoWikilink(body, relatedNotes);\n    const links = relatedNotes.map((r) => `- [[${wikilinkName(r)}]]`).join(\"\\n\");\n    body += `\\n## Related\\n\\n${links}\\n`;\n  }\n\n  return body;\n}\n\n/**\n * For each related note, replace the first bare occurrence of its title in the body\n * with a [[wikilink]]. Conservative — only replaces whole-word matches outside code blocks.\n */\nfunction autoWikilink(body: string, relatedNotes: string[]): string {\n  // Skip content inside fenced code blocks\n  const parts = body.split(/(```[\\s\\S]*?```)/g);\n  return parts\n    .map((part, i) => {\n      if (i % 2 === 1) return part; // code block\n      let out = part;\n      for (const r of relatedNotes) {\n        const name = wikilinkName(r);\n        if (/[\\[\\]]/.test(out) && out.includes(`[[${name}]]`)) continue; // already linked\n        const escaped = name.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n        const re = new RegExp(`\\\\b${escaped}\\\\b`, \"i\");\n        out = out.replace(re, `[[${name}]]`);\n      }\n      return out;\n    })\n    .join(\"\");\n}\n\nfunction wikilinkName(pathOrName: string): string {\n  // \"decisions/auth-migration.md\" → \"auth-migration\"\n  // \"Auth Migration\" → \"Auth Migration\"\n  const base = basename(pathOrName).replace(/\\.md$/, \"\");\n  return base;\n}\n\nexport interface PromoteInput {\n  /**\n   * Path to the proposal note (relative to vault root). Must have `status: proposal` frontmatter\n   * AND `proposed_target` frontmatter, both written by `buildSynthesizeChangeSet` in proposal mode.\n   */\n  proposal_path: string;\n  /**\n   * Optional override for the destination path. When omitted, the proposal's own\n   * `proposed_target` frontmatter is used.\n   */\n  target_path?: string;\n}\n\nexport interface PromotePreview {\n  changeset: ChangeSet;\n  from: string;\n  to: string;\n}\n\n/**\n * Promote a reviewed proposal to its canonical destination.\n *\n * Reads the proposal's existing content + frontmatter, strips `status: proposal` and\n * `proposed_target` keys, restores the original status (default \"active\"), and returns\n * a ChangeSet that:\n *   - creates the canonical path with the cleaned frontmatter + body\n *   - deletes the proposal path\n *\n * The caller (the MCP tool) reads the proposal file, runs this builder, and applies the\n * resulting changeset via applyPatch — preserving atomicity and rollback semantics.\n */\nexport function buildPromoteChangeSet(input: {\n  proposal_path: string;\n  target_path?: string;\n  body: string;\n  frontmatter: Record<string, unknown>;\n}): PromotePreview {\n  const fm = { ...input.frontmatter };\n  const target = input.target_path ?? (typeof fm.proposed_target === \"string\" ? fm.proposed_target : undefined);\n  if (!target) {\n    throw new Error(\n      `Cannot promote ${input.proposal_path}: no target_path provided and no 'proposed_target' frontmatter on the proposal.`\n    );\n  }\n  // Restore canonical status (default \"active\") and strip proposal markers.\n  if (fm.status === \"proposal\") fm.status = \"active\";\n  delete fm.proposed_target;\n\n  const create: PatchCreate = {\n    path: target,\n    content: input.body,\n    frontmatter: fm,\n  };\n  const changeset: ChangeSet = {\n    creates: [create],\n    deletes: [{ path: input.proposal_path }],\n  };\n\n  return { changeset, from: input.proposal_path, to: target };\n}\n","import { readFile, writeFile } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst BEGIN_MARKER = \"<!-- semantic-memory:begin contract -->\";\nconst END_MARKER = \"<!-- semantic-memory:end contract -->\";\nconst LOCAL_NOTES_HEADING = \"## Local Notes\";\n\nexport interface ToolSummary {\n  name: string;\n  description: string;\n  deprecated?: boolean;\n}\n\nexport interface ModeSummary {\n  name: string;\n  description: string;\n  isDefault?: boolean;\n}\n\nexport interface RegenerateContractOptions {\n  projectRoot: string;\n  pluginVersion: string;\n  tools: ToolSummary[];\n  modes?: ModeSummary[];\n  /** When true, overwrite hand-edited managed blocks. Default false → fails loudly on detected hand-edits. */\n  force?: boolean;\n  /** Override \"now\" — used by tests for deterministic timestamps. */\n  nowIso?: string;\n}\n\nexport interface RegenerateContractResult {\n  path: string;\n  written: boolean;\n  reason?: string;\n  hand_edit_detected?: boolean;\n  preserved_local_notes_chars?: number;\n}\n\n/**\n * Generate or refresh AGENTS.md at the project root.\n *\n * Behavior:\n *  - If AGENTS.md is absent, write the full contract + an empty Local Notes section.\n *  - If AGENTS.md exists and contains the managed block markers:\n *      * Regenerate the content INSIDE the markers from the current tool/mode inventory.\n *      * Preserve everything OUTSIDE the markers (Local Notes tail, custom sections, frontmatter the\n *        user added).\n *      * If `force` is false and the inside-block content differs from a freshly-generated block AND\n *        the difference is not just a regenerable timestamp/version, fail with hand_edit_detected.\n *  - If AGENTS.md exists without managed-block markers, refuse and report — the user has a custom\n *    AGENTS.md and we should not silently take it over.\n */\nexport async function regenerateAgentsContract(opts: RegenerateContractOptions): Promise<RegenerateContractResult> {\n  const path = join(opts.projectRoot, \"AGENTS.md\");\n  const generatedBlock = buildManagedBlock(opts);\n  const generatedFull = buildFullDocument(opts, generatedBlock);\n\n  if (!existsSync(path)) {\n    await writeFile(path, generatedFull, \"utf-8\");\n    return { path, written: true };\n  }\n\n  const existing = await readFile(path, \"utf-8\");\n  const beginIdx = existing.indexOf(BEGIN_MARKER);\n  const endIdx = existing.indexOf(END_MARKER);\n\n  if (beginIdx === -1 || endIdx === -1 || endIdx < beginIdx) {\n    return {\n      path,\n      written: false,\n      reason:\n        \"AGENTS.md exists but does not contain the semantic-memory managed-block markers. Move your existing content into a Local Notes section outside the managed block, or delete AGENTS.md and re-run to bootstrap from scratch.\",\n    };\n  }\n\n  const existingBlock = existing.slice(beginIdx, endIdx + END_MARKER.length);\n  const localTail = extractLocalTail(existing, endIdx + END_MARKER.length);\n\n  if (!opts.force && hasHandEdits(existingBlock, generatedBlock)) {\n    return {\n      path,\n      written: false,\n      hand_edit_detected: true,\n      reason:\n        \"Managed-block content has been hand-edited. Move your changes to the Local Notes section (outside the managed block) and re-run, or pass force=true to overwrite.\",\n    };\n  }\n\n  // Refresh the entire pre-block prefix (frontmatter + title) so timestamp/version\n  // stamps reflect the current regeneration. Keep the managed block fresh and the\n  // Local Notes tail untouched.\n  const newPrefix = buildPrefix(opts);\n  const newDoc = newPrefix + generatedBlock + localTail;\n  await writeFile(path, newDoc, \"utf-8\");\n  return {\n    path,\n    written: true,\n    preserved_local_notes_chars: localTail.length,\n  };\n}\n\nfunction buildPrefix(opts: RegenerateContractOptions): string {\n  return [\n    \"---\",\n    `generated_by: semantic-memory`,\n    `version: ${opts.pluginVersion}`,\n    `last_generated: ${opts.nowIso ?? new Date().toISOString()}`,\n    \"---\",\n    \"\",\n    \"# Project Agent Contract\",\n    \"\",\n  ].join(\"\\n\");\n}\n\nfunction buildFullDocument(opts: RegenerateContractOptions, managedBlock: string): string {\n  const localNotes = `\\n\\n${LOCAL_NOTES_HEADING}\\n\\n_User-authored content lives here. Preserved across \\`regenerate_contract\\` runs._\\n`;\n  return buildPrefix(opts) + managedBlock + localNotes;\n}\n\nfunction buildManagedBlock(opts: RegenerateContractOptions): string {\n  const lines: string[] = [BEGIN_MARKER, \"\"];\n\n  lines.push(\"## Active Modes\", \"\");\n  const modes = opts.modes ?? defaultModes();\n  for (const m of modes) {\n    const tag = m.isDefault ? \" (default)\" : \"\";\n    lines.push(`- **${m.name}**${tag} — ${m.description}`);\n  }\n  lines.push(\"\");\n\n  lines.push(\"## Required Workflow\", \"\");\n  lines.push(\"1. For multi-step work that needs verification, open a session: `session_start({task})`.\");\n  lines.push(\"2. Use mode-aware retrieval: `search_hybrid`, `read_note`, `list_notes`, `backlinks`/`forwardlinks`.\");\n  lines.push(\"3. Make durable updates via `apply_patch` or `synthesize_note` — never bypass the patch layer for multi-note edits.\");\n  lines.push(\"4. Run verification commands inside a session: `session_run({cmd})`.\");\n  lines.push(\"5. Close with `session_finish({summary})` — refused without verification unless explicitly waived.\");\n  lines.push(\"6. Lint regularly: `lint_vault({checks: ['schema','provenance','stale','broken_links']})`.\");\n  lines.push(\"\");\n\n  lines.push(\"## Tool Surface\", \"\");\n  const live = opts.tools.filter((t) => !t.deprecated);\n  const deprecated = opts.tools.filter((t) => t.deprecated);\n  for (const t of live) {\n    lines.push(`- \\`${t.name}\\` — ${stripDeprecationPrefix(t.description)}`);\n  }\n  if (deprecated.length > 0) {\n    lines.push(\"\");\n    lines.push(\"### Deprecated (removed in v2.0.0)\", \"\");\n    for (const t of deprecated) {\n      lines.push(`- \\`${t.name}\\` — ${stripDeprecationPrefix(t.description)}`);\n    }\n  }\n  lines.push(\"\");\n\n  lines.push(\"## Memory Policy\", \"\");\n  lines.push(\"- Markdown is canonical. The vault under `.claude/.vault/` (or wherever `--notes` points) is the source of truth.\");\n  lines.push(\"- Indexes (vector / graph / FTS) are derived state — rebuildable via `reindex` without losing knowledge.\");\n  lines.push(\"- Provenance frontmatter is required for `note`/`decision`/`gotcha` types — `sources` (external) or `derived_from` (internal).\");\n  lines.push(\"- Mode router lives at `.claude/.semantic-memory/mode` (legacy `.claude/.sidekick-mode` still readable through v1.x); explicit `/mode` is ground truth.\");\n  lines.push(\"\");\n\n  lines.push(END_MARKER);\n  return lines.join(\"\\n\");\n}\n\nfunction defaultModes(): ModeSummary[] {\n  return [\n    { name: \"vault-first\", description: \"Project-scoped prose questions trigger vault consultation with cite-or-deflect.\", isDefault: true },\n    { name: \"research\", description: \"Every source introduced is filed via `ingest_source`; mandatory `synthesize_note` on exit.\" },\n    { name: \"outage-silence\", description: \"No proactive vault search. Terse responses. Postmortem `synthesize_note` on exit.\" },\n  ];\n}\n\nfunction stripDeprecationPrefix(description: string): string {\n  return description.replace(/^\\[DEPRECATED[^\\]]*\\]\\s*/, \"(deprecated) \");\n}\n\nfunction extractLocalTail(existing: string, afterEndIdx: number): string {\n  const tail = existing.slice(afterEndIdx);\n  // Trim a single leading blank-line-then-newline if present so we don't double-space across regenerations.\n  return tail;\n}\n\n/**\n * Detect hand-edits by comparing semantic content of the managed block, ignoring lines that are\n * regenerable (currently no per-block timestamps live inside the block — they're in frontmatter).\n * Returns true if the existing block diverges from what we'd generate now.\n */\nfunction hasHandEdits(existingBlock: string, generatedBlock: string): boolean {\n  return existingBlock.trim() !== generatedBlock.trim();\n}\n\n/**\n * Inspect AGENTS.md without modifying it. Returns whether the file exists, whether it has managed\n * markers, and how many characters of Local Notes tail are preserved.\n */\nexport async function inspectAgentsContract(projectRoot: string): Promise<{\n  path: string;\n  exists: boolean;\n  has_managed_block: boolean;\n  local_notes_chars: number;\n}> {\n  const path = join(projectRoot, \"AGENTS.md\");\n  if (!existsSync(path)) {\n    return { path, exists: false, has_managed_block: false, local_notes_chars: 0 };\n  }\n  const raw = await readFile(path, \"utf-8\");\n  const beginIdx = raw.indexOf(BEGIN_MARKER);\n  const endIdx = raw.indexOf(END_MARKER);\n  if (beginIdx === -1 || endIdx === -1) {\n    return { path, exists: true, has_managed_block: false, local_notes_chars: 0 };\n  }\n  const localTail = raw.slice(endIdx + END_MARKER.length).trim();\n  return { path, exists: true, has_managed_block: true, local_notes_chars: localTail.length };\n}\n"],"mappings":"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","names":["body","readFile","writeFile","join","glob","matter","escapeRegex","readFile","writeFile","existsSync","join","dirname","basename","matter","readFile","writeFile","unlink","rename","mkdir","existsSync","dirname","join","matter","existsSync","join","matter","readFile","unlink","writeFile","mkdir","dirname","rename","basename","readFile","writeFile","existsSync","join"]}

package/dist/chunk-FM26NFTR.js

@@ -0,0 +1,272 @@
+import {
+  readSelectionLog
+} from "./chunk-NTYYS53O.js";
+import {
+  compileLexicon,
+  findAliasConflicts
+} from "./chunk-A3KYHKB5.js";
+import {
+  deriveProjectRoot
+} from "./chunk-S4KW7VH4.js";
+import {
+  loadSchema,
+  validateNote
+} from "./chunk-OWZWMB4P.js";
+import {
+  computeDecay,
+  loadDecayConfig,
+  normalizeVerifiedDate
+} from "./chunk-5ZKNO6ZD.js";
+
+// src/core/lint.ts
+import { readFile } from "fs/promises";
+import { existsSync } from "fs";
+import { basename, join } from "path";
+import { glob } from "glob";
+import matter from "gray-matter";
+async function lintVault(notesPath, opts = {}) {
+  const schema = opts.schemaOverride ?? await loadSchema(notesPath);
+  const files = await glob(opts.pathGlob ?? "**/*.md", {
+    cwd: notesPath,
+    ignore: ["node_modules/**", ".semantic-sidekick-index/**", "vault.schema.yml"]
+  });
+  const findings = [];
+  const knownNames = /* @__PURE__ */ new Set();
+  const rawByPath = /* @__PURE__ */ new Map();
+  for (const rel of files) {
+    try {
+      const raw = await readFile(join(notesPath, rel), "utf-8");
+      rawByPath.set(rel, raw);
+      knownNames.add(basename(rel).replace(/\.md$/, ""));
+    } catch {
+    }
+  }
+  const codeRoot = opts.checkCodeSymbols ? resolveCodeRoot(opts.projectRoot ?? deriveProjectRoot(notesPath)) : null;
+  for (const [rel, raw] of rawByPath) {
+    findings.push(...validateNote(rel, raw, schema, { todayIso: opts.todayIso }));
+    findings.push(...findBrokenLinks(rel, raw, knownNames));
+    if (codeRoot) findings.push(...findCodeSymbolDrift(rel, raw, codeRoot));
+  }
+  if (opts.checkDecayCandidates) {
+    findings.push(...await findDecayCandidates(notesPath, rawByPath, opts.todayIso));
+  }
+  if (opts.checkAliasConflicts) {
+    for (const c of findAliasConflicts(await compileLexicon(notesPath))) {
+      findings.push({
+        path: "lexicon",
+        rule: "alias_conflicts",
+        severity: "warn",
+        message: `phrase "${c.phrase}" maps to ${c.canonicals.length} targets: ${c.canonicals.join(", ")} \u2014 pick one`
+      });
+    }
+  }
+  if (opts.checkDecoys) {
+    findings.push(...await findDecoys(notesPath, rawByPath));
+  }
+  const byRule = {
+    schema_violations: findings.filter((f) => f.rule === "schema_violations"),
+    missing_provenance: findings.filter((f) => f.rule === "missing_provenance"),
+    stale: findings.filter((f) => f.rule === "stale"),
+    broken_links: findings.filter((f) => f.rule === "broken_links"),
+    code_symbols: findings.filter((f) => f.rule === "code_symbols"),
+    decay_candidates: findings.filter((f) => f.rule === "decay_candidates"),
+    alias_conflicts: findings.filter((f) => f.rule === "alias_conflicts"),
+    decoys: findings.filter((f) => f.rule === "decoys")
+  };
+  const errors = findings.filter((f) => f.severity === "error").length;
+  const warnings = findings.filter((f) => f.severity === "warn").length;
+  return {
+    schemaPath: join(notesPath, "vault.schema.yml"),
+    findings,
+    byRule,
+    counts: { errors, warnings, filesLinted: files.length }
+  };
+}
+function findBrokenLinks(relPath, rawFileContent, knownNames) {
+  const { content } = matter(rawFileContent);
+  const findings = [];
+  const stripped = content.replace(/```[\s\S]*?```/g, "").replace(/`[^`]+`/g, "");
+  const re = /\[\[([^\]\|]+)(?:\|[^\]]+)?\]\]/g;
+  const seen = /* @__PURE__ */ new Set();
+  let m;
+  while ((m = re.exec(stripped)) !== null) {
+    const target = m[1].trim().split("#")[0].split("/").pop().replace(/\.md$/, "");
+    if (seen.has(target)) continue;
+    seen.add(target);
+    if (!knownNames.has(target)) {
+      findings.push({
+        path: relPath,
+        rule: "broken_links",
+        severity: "warn",
+        message: `wikilink [[${target}]] has no matching note`
+      });
+    }
+  }
+  return findings;
+}
+var CODE_EXTENSIONS = /* @__PURE__ */ new Set([
+  "ts",
+  "tsx",
+  "js",
+  "jsx",
+  "mjs",
+  "cjs",
+  "py",
+  "rb",
+  "go",
+  "rs",
+  "java",
+  "kt",
+  "c",
+  "h",
+  "cpp",
+  "hpp",
+  "cs",
+  "php",
+  "swift",
+  "scala",
+  "sh",
+  "bash",
+  "sql",
+  "json",
+  "yaml",
+  "yml",
+  "toml",
+  "css",
+  "scss",
+  "html",
+  "vue",
+  "svelte",
+  "md"
+]);
+function resolveCodeRoot(root) {
+  if (!root || !existsSync(root)) return null;
+  const markers = ["package.json", ".git", "src", "lib", "pyproject.toml", "go.mod", "Cargo.toml"];
+  return markers.some((m) => existsSync(join(root, m))) ? root : null;
+}
+function findCodeSymbolDrift(relPath, rawFileContent, codeRoot) {
+  const { content } = matter(rawFileContent);
+  const withoutFences = content.replace(/```[\s\S]*?```/g, "");
+  const findings = [];
+  const seen = /* @__PURE__ */ new Set();
+  const re = /`([^`\n]+)`/g;
+  let m;
+  while ((m = re.exec(withoutFences)) !== null) {
+    let token = m[1].trim();
+    if (!looksLikeRepoPath(token)) continue;
+    token = token.replace(/^\.\//, "");
+    if (seen.has(token)) continue;
+    seen.add(token);
+    const firstSeg = token.split("/")[0];
+    if (!existsSync(join(codeRoot, firstSeg))) continue;
+    if (!existsSync(join(codeRoot, token))) {
+      findings.push({
+        path: relPath,
+        rule: "code_symbols",
+        severity: "warn",
+        message: `inline code path \`${token}\` does not exist under the project root (stale reference?)`
+      });
+    }
+  }
+  return findings;
+}
+function looksLikeRepoPath(token) {
+  if (!token.includes("/")) return false;
+  if (/\s/.test(token)) return false;
+  if (token.includes("://")) return false;
+  if (/[*?\[\]{}()<>|]/.test(token)) return false;
+  if (token.startsWith("/") || token.startsWith("~")) return false;
+  const normalized = token.replace(/^\.\//, "");
+  if (normalized.startsWith("..")) return false;
+  const last = normalized.split("/").pop() ?? "";
+  const dot = last.lastIndexOf(".");
+  if (dot <= 0) return false;
+  const ext = last.slice(dot + 1).toLowerCase();
+  return CODE_EXTENSIONS.has(ext);
+}
+var DECAY_CANDIDATE_THRESHOLD = 0.5;
+async function findDecayCandidates(notesPath, rawByPath, todayIso) {
+  const events = await readSelectionLog(notesPath);
+  if (events.length === 0) return [];
+  const retrieved = /* @__PURE__ */ new Map();
+  for (const e of events) {
+    if (e.kind === "search") {
+      for (const r of e.results) retrieved.set(r.path, (retrieved.get(r.path) ?? 0) + 1);
+    }
+  }
+  if (retrieved.size === 0) return [];
+  const config = loadDecayConfig(notesPath);
+  if (!config.enabled) return [];
+  const nowMs = todayIso ? Date.parse(todayIso) : void 0;
+  const findings = [];
+  for (const [rel, count] of retrieved) {
+    const raw = rawByPath.get(rel);
+    if (!raw) continue;
+    const { data: fm } = matter(raw);
+    const decay = computeDecay({
+      type: typeof fm.type === "string" ? fm.type : void 0,
+      last_verified: normalizeVerifiedDate(fm.last_verified),
+      evergreen: fm.evergreen === true,
+      config,
+      nowMs
+    });
+    if (decay.multiplier <= DECAY_CANDIDATE_THRESHOLD) {
+      findings.push({
+        path: rel,
+        rule: "decay_candidates",
+        severity: "warn",
+        message: `retrieved ${count}\xD7 recently but decayed to ${decay.multiplier.toFixed(2)} (age ${Math.round(decay.age_days)}d) \u2014 verify_note or revise`
+      });
+    }
+  }
+  findings.sort((a, b) => (retrieved.get(b.path) ?? 0) - (retrieved.get(a.path) ?? 0));
+  return findings;
+}
+var DECOY_MIN_RETRIEVALS = 3;
+async function findDecoys(notesPath, rawByPath) {
+  const events = await readSelectionLog(notesPath);
+  if (events.length === 0) return [];
+  const retrieved = /* @__PURE__ */ new Map();
+  const cited = /* @__PURE__ */ new Set();
+  for (const e of events) {
+    if (e.kind === "search") {
+      for (const r of e.results) retrieved.set(r.path, (retrieved.get(r.path) ?? 0) + 1);
+    } else if (e.kind === "selection") {
+      cited.add(e.note_path);
+    }
+  }
+  const findings = [];
+  for (const [rel, count] of retrieved) {
+    if (count < DECOY_MIN_RETRIEVALS) continue;
+    if (cited.has(rel)) continue;
+    if (!rawByPath.has(rel)) continue;
+    findings.push({
+      path: rel,
+      rule: "decoys",
+      severity: "warn",
+      message: `retrieved ${count}\xD7 but never cited \u2014 decoy noise, or a note answers wrongly skip? (surfaced, not auto-down-ranked)`
+    });
+  }
+  findings.sort((a, b) => (retrieved.get(b.path) ?? 0) - (retrieved.get(a.path) ?? 0));
+  return findings;
+}
+function formatLintReport(report, opts = {}) {
+  const target = opts.rule ? report.byRule[opts.rule] : report.findings;
+  if (target.length === 0) {
+    return `clean: 0 findings across ${report.counts.filesLinted} files`;
+  }
+  const lines = [
+    `${target.length} finding${target.length === 1 ? "" : "s"} (errors=${report.counts.errors}, warnings=${report.counts.warnings}, files=${report.counts.filesLinted})`,
+    ""
+  ];
+  for (const f of target) {
+    lines.push(`[${f.severity}] ${f.rule}: ${f.path} \u2014 ${f.message}`);
+  }
+  return lines.join("\n");
+}
+
+export {
+  lintVault,
+  formatLintReport
+};
+//# sourceMappingURL=chunk-FM26NFTR.js.map

package/dist/chunk-FM26NFTR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/lint.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport { glob } from \"glob\";\nimport matter from \"gray-matter\";\nimport { loadSchema, validateNote, type LintFinding, type VaultSchema } from \"./schema.js\";\nimport { deriveProjectRoot } from \"./session.js\";\nimport { computeDecay, loadDecayConfig, normalizeVerifiedDate } from \"./decay.js\";\nimport { readSelectionLog } from \"./telemetry.js\";\nimport { compileLexicon, findAliasConflicts } from \"./lexicon.js\";\n\nexport interface LintReport {\n  schemaPath: string;\n  findings: LintFinding[];\n  byRule: {\n    schema_violations: LintFinding[];\n    missing_provenance: LintFinding[];\n    stale: LintFinding[];\n    broken_links: LintFinding[];\n    code_symbols: LintFinding[];\n    decay_candidates: LintFinding[];\n    alias_conflicts: LintFinding[];\n    decoys: LintFinding[];\n  };\n  counts: {\n    errors: number;\n    warnings: number;\n    filesLinted: number;\n  };\n}\n\nexport async function lintVault(\n  notesPath: string,\n  opts: {\n    pathGlob?: string;\n    schemaOverride?: VaultSchema;\n    todayIso?: string;\n    /**\n     * When true, run the code-symbol drift check: flag inline-code file-path\n     * references in notes that no longer exist under the project root. Opt-in\n     * (off by default) so the standard report and the healthcheck slow tier stay\n     * quiet and byte-stable. Fails open when the project root is not a code repo.\n     */\n    checkCodeSymbols?: boolean;\n    /** Override the project root for code-symbol resolution (default: derived from notesPath). */\n    projectRoot?: string;\n    /**\n     * When true, run the decay-candidates check: cross-reference the selection\n     * log (notes that appeared in recent search results) against each note's\n     * current decay multiplier, and flag notes that are frequently retrieved yet\n     * heavily decayed (\"relevant but going stale — verify or revise\"). Opt-in;\n     * a silent no-op when no selection log exists.\n     */\n    checkDecayCandidates?: boolean;\n    /**\n     * When true, run the alias-conflict check: flag lexicon phrases that map to\n     * more than one canonical target (a wrong binding misroutes queries). Opt-in;\n     * no-op when the vault has no lexicon.\n     */\n    checkAliasConflicts?: boolean;\n    /**\n     * When true, run the decoys check: flag notes that were retrieved often (per\n     * the selection log) but NEVER cited in an answer. Surfaced for a human to\n     * judge — a decoy might be genuine noise OR a note the answers were wrong to\n     * skip; usage-feedback ranking (v1.5) never auto-down-ranks on this ambiguous\n     * signal (decision Q5). Opt-in; a no-op with no selection log.\n     */\n    checkDecoys?: boolean;\n  } = {}\n): Promise<LintReport> {\n  const schema = opts.schemaOverride ?? (await loadSchema(notesPath));\n  const files = await glob(opts.pathGlob ?? \"**/*.md\", {\n    cwd: notesPath,\n    ignore: [\"node_modules/**\", \".semantic-sidekick-index/**\", \"vault.schema.yml\"],\n  });\n\n  const findings: LintFinding[] = [];\n  // Build known-note set first, to make broken-link detection O(1) per link.\n  const knownNames = new Set<string>();\n  const rawByPath = new Map<string, string>();\n  for (const rel of files) {\n    try {\n      const raw = await readFile(join(notesPath, rel), \"utf-8\");\n      rawByPath.set(rel, raw);\n      // Wikilink names match on basename-without-ext (obsidian-style)\n      knownNames.add(basename(rel).replace(/\\.md$/, \"\"));\n    } catch {\n      /* skip */\n    }\n  }\n\n  // Code-symbol drift is opt-in and only meaningful against a real code repo.\n  const codeRoot = opts.checkCodeSymbols\n    ? resolveCodeRoot(opts.projectRoot ?? deriveProjectRoot(notesPath))\n    : null;\n\n  for (const [rel, raw] of rawByPath) {\n    findings.push(...validateNote(rel, raw, schema, { todayIso: opts.todayIso }));\n    findings.push(...findBrokenLinks(rel, raw, knownNames));\n    if (codeRoot) findings.push(...findCodeSymbolDrift(rel, raw, codeRoot));\n  }\n\n  if (opts.checkDecayCandidates) {\n    findings.push(...(await findDecayCandidates(notesPath, rawByPath, opts.todayIso)));\n  }\n\n  if (opts.checkAliasConflicts) {\n    for (const c of findAliasConflicts(await compileLexicon(notesPath))) {\n      findings.push({\n        path: \"lexicon\",\n        rule: \"alias_conflicts\",\n        severity: \"warn\",\n        message: `phrase \"${c.phrase}\" maps to ${c.canonicals.length} targets: ${c.canonicals.join(\", \")} — pick one`,\n      });\n    }\n  }\n\n  if (opts.checkDecoys) {\n    findings.push(...(await findDecoys(notesPath, rawByPath)));\n  }\n\n  const byRule = {\n    schema_violations: findings.filter((f) => f.rule === \"schema_violations\"),\n    missing_provenance: findings.filter((f) => f.rule === \"missing_provenance\"),\n    stale: findings.filter((f) => f.rule === \"stale\"),\n    broken_links: findings.filter((f) => f.rule === \"broken_links\"),\n    code_symbols: findings.filter((f) => f.rule === \"code_symbols\"),\n    decay_candidates: findings.filter((f) => f.rule === \"decay_candidates\"),\n    alias_conflicts: findings.filter((f) => f.rule === \"alias_conflicts\"),\n    decoys: findings.filter((f) => f.rule === \"decoys\"),\n  };\n  const errors = findings.filter((f) => f.severity === \"error\").length;\n  const warnings = findings.filter((f) => f.severity === \"warn\").length;\n\n  return {\n    schemaPath: join(notesPath, \"vault.schema.yml\"),\n    findings,\n    byRule,\n    counts: { errors, warnings, filesLinted: files.length },\n  };\n}\n\nfunction findBrokenLinks(\n  relPath: string,\n  rawFileContent: string,\n  knownNames: Set<string>\n): LintFinding[] {\n  const { content } = matter(rawFileContent);\n  const findings: LintFinding[] = [];\n  // Match [[target]] and [[target|alias]] — skip fenced code and inline code.\n  const stripped = content\n    .replace(/```[\\s\\S]*?```/g, \"\")\n    .replace(/`[^`]+`/g, \"\");\n  const re = /\\[\\[([^\\]\\|]+)(?:\\|[^\\]]+)?\\]\\]/g;\n  const seen = new Set<string>();\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(stripped)) !== null) {\n    const target = m[1].trim().split(\"#\")[0].split(\"/\").pop()!.replace(/\\.md$/, \"\");\n    if (seen.has(target)) continue;\n    seen.add(target);\n    if (!knownNames.has(target)) {\n      findings.push({\n        path: relPath,\n        rule: \"broken_links\",\n        severity: \"warn\",\n        message: `wikilink [[${target}]] has no matching note`,\n      });\n    }\n  }\n  return findings;\n}\n\n/** File extensions we treat as \"this looks like a source/doc file reference\". */\nconst CODE_EXTENSIONS = new Set([\n  \"ts\", \"tsx\", \"js\", \"jsx\", \"mjs\", \"cjs\", \"py\", \"rb\", \"go\", \"rs\", \"java\", \"kt\",\n  \"c\", \"h\", \"cpp\", \"hpp\", \"cs\", \"php\", \"swift\", \"scala\", \"sh\", \"bash\", \"sql\",\n  \"json\", \"yaml\", \"yml\", \"toml\", \"css\", \"scss\", \"html\", \"vue\", \"svelte\", \"md\",\n]);\n\n/**\n * Decide whether `root` is a real code repository worth checking paths against.\n * Fails open (returns null) for non-code roots so the check is a silent no-op\n * outside a project — e.g. a standalone vault, or when babel-fish isn't present.\n */\nfunction resolveCodeRoot(root: string): string | null {\n  if (!root || !existsSync(root)) return null;\n  const markers = [\"package.json\", \".git\", \"src\", \"lib\", \"pyproject.toml\", \"go.mod\", \"Cargo.toml\"];\n  return markers.some((m) => existsSync(join(root, m))) ? root : null;\n}\n\n/**\n * Code-symbol drift: scan a note's inline-code spans for repo-relative file-path\n * references and flag ones whose first path segment IS a real directory in the repo\n * but whose full path no longer exists — i.e. a stale reference to a moved/deleted\n * file. Anchoring on an existing first segment keeps false positives low: paths\n * belonging to other repos (whose top-level dir isn't present here) are skipped.\n *\n * Scope note: this validates *path* references. Fine-grained symbol-name checking\n * (function/class identifiers) needs a real symbol index and is planned for the\n * v1.4 lexicon arc, which will extend this same `code_symbols` rule.\n */\nfunction findCodeSymbolDrift(relPath: string, rawFileContent: string, codeRoot: string): LintFinding[] {\n  const { content } = matter(rawFileContent);\n  // Inline-code spans only (single backtick). Fenced blocks are illustrative and\n  // over-match. Strip fenced blocks first so their backticks don't confuse the span regex.\n  const withoutFences = content.replace(/```[\\s\\S]*?```/g, \"\");\n  const findings: LintFinding[] = [];\n  const seen = new Set<string>();\n  const re = /`([^`\\n]+)`/g;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(withoutFences)) !== null) {\n    let token = m[1].trim();\n    if (!looksLikeRepoPath(token)) continue;\n    token = token.replace(/^\\.\\//, \"\");\n    if (seen.has(token)) continue;\n    seen.add(token);\n    const firstSeg = token.split(\"/\")[0];\n    // Only judge paths anchored in a directory that actually exists in this repo.\n    if (!existsSync(join(codeRoot, firstSeg))) continue;\n    if (!existsSync(join(codeRoot, token))) {\n      findings.push({\n        path: relPath,\n        rule: \"code_symbols\",\n        severity: \"warn\",\n        message: `inline code path \\`${token}\\` does not exist under the project root (stale reference?)`,\n      });\n    }\n  }\n  return findings;\n}\n\nfunction looksLikeRepoPath(token: string): boolean {\n  if (!token.includes(\"/\")) return false;\n  if (/\\s/.test(token)) return false; // commands, prose\n  if (token.includes(\"://\")) return false; // URLs\n  if (/[*?\\[\\]{}()<>|]/.test(token)) return false; // globs / shell / placeholders\n  if (token.startsWith(\"/\") || token.startsWith(\"~\")) return false; // absolute / home\n  const normalized = token.replace(/^\\.\\//, \"\");\n  if (normalized.startsWith(\"..\")) return false; // escapes the repo\n  const last = normalized.split(\"/\").pop() ?? \"\";\n  const dot = last.lastIndexOf(\".\");\n  if (dot <= 0) return false; // no extension → likely a dir or a symbol like a/b\n  const ext = last.slice(dot + 1).toLowerCase();\n  return CODE_EXTENSIONS.has(ext);\n}\n\n/** Multiplier at or below which a frequently-retrieved note is worth surfacing. */\nconst DECAY_CANDIDATE_THRESHOLD = 0.5;\n\n/**\n * Decay-candidates: notes that keep showing up in search results but have decayed.\n * Reads the selection log (search events record the paths each query returned),\n * computes each retrieved note's current decay multiplier from its frontmatter,\n * and flags those at/below the threshold — \"this keeps being relevant but is\n * going stale; verify or revise.\" Index-free (no embedder); a no-op when there's\n * no selection log yet.\n */\nasync function findDecayCandidates(\n  notesPath: string,\n  rawByPath: Map<string, string>,\n  todayIso?: string\n): Promise<LintFinding[]> {\n  const events = await readSelectionLog(notesPath);\n  if (events.length === 0) return [];\n\n  // Count how often each path was retrieved (appeared in a search's results).\n  const retrieved = new Map<string, number>();\n  for (const e of events) {\n    if (e.kind === \"search\") {\n      for (const r of e.results) retrieved.set(r.path, (retrieved.get(r.path) ?? 0) + 1);\n    }\n  }\n  if (retrieved.size === 0) return [];\n\n  const config = loadDecayConfig(notesPath);\n  if (!config.enabled) return [];\n  const nowMs = todayIso ? Date.parse(todayIso) : undefined;\n\n  const findings: LintFinding[] = [];\n  for (const [rel, count] of retrieved) {\n    const raw = rawByPath.get(rel);\n    if (!raw) continue; // retrieved path no longer in the vault — skip\n    const { data: fm } = matter(raw);\n    const decay = computeDecay({\n      type: typeof fm.type === \"string\" ? fm.type : undefined,\n      last_verified: normalizeVerifiedDate(fm.last_verified),\n      evergreen: fm.evergreen === true,\n      config,\n      nowMs,\n    });\n    if (decay.multiplier <= DECAY_CANDIDATE_THRESHOLD) {\n      findings.push({\n        path: rel,\n        rule: \"decay_candidates\",\n        severity: \"warn\",\n        message: `retrieved ${count}× recently but decayed to ${decay.multiplier.toFixed(2)} (age ${Math.round(decay.age_days)}d) — verify_note or revise`,\n      });\n    }\n  }\n  // Most-retrieved first — the ones worth re-verifying soonest.\n  findings.sort((a, b) => (retrieved.get(b.path) ?? 0) - (retrieved.get(a.path) ?? 0));\n  return findings;\n}\n\n/** A note must be retrieved at least this many times before \"never cited\" is signal. */\nconst DECOY_MIN_RETRIEVALS = 3;\n\n/**\n * Decoys (v1.5 Phase 9): notes retrieved ≥ DECOY_MIN_RETRIEVALS times that were\n * NEVER cited. Surfaced only — usage-feedback ranking never auto-down-ranks on\n * this ambiguous signal (a decoy might be genuine noise, or a note the answers\n * were wrong to skip). A human decides; the lint just points.\n */\nasync function findDecoys(notesPath: string, rawByPath: Map<string, string>): Promise<LintFinding[]> {\n  const events = await readSelectionLog(notesPath);\n  if (events.length === 0) return [];\n\n  const retrieved = new Map<string, number>();\n  const cited = new Set<string>();\n  for (const e of events) {\n    if (e.kind === \"search\") {\n      for (const r of e.results) retrieved.set(r.path, (retrieved.get(r.path) ?? 0) + 1);\n    } else if (e.kind === \"selection\") {\n      cited.add(e.note_path);\n    }\n  }\n\n  const findings: LintFinding[] = [];\n  for (const [rel, count] of retrieved) {\n    if (count < DECOY_MIN_RETRIEVALS) continue;\n    if (cited.has(rel)) continue;\n    if (!rawByPath.has(rel)) continue; // retrieved path no longer in the vault — skip\n    findings.push({\n      path: rel,\n      rule: \"decoys\",\n      severity: \"warn\",\n      message: `retrieved ${count}× but never cited — decoy noise, or a note answers wrongly skip? (surfaced, not auto-down-ranked)`,\n    });\n  }\n  findings.sort((a, b) => (retrieved.get(b.path) ?? 0) - (retrieved.get(a.path) ?? 0));\n  return findings;\n}\n\nexport function formatLintReport(report: LintReport, opts: { rule?: keyof LintReport[\"byRule\"] } = {}): string {\n  const target = opts.rule ? report.byRule[opts.rule] : report.findings;\n  if (target.length === 0) {\n    return `clean: 0 findings across ${report.counts.filesLinted} files`;\n  }\n  const lines = [\n    `${target.length} finding${target.length === 1 ? \"\" : \"s\"} (errors=${report.counts.errors}, warnings=${report.counts.warnings}, files=${report.counts.filesLinted})`,\n    \"\",\n  ];\n  for (const f of target) {\n    lines.push(`[${f.severity}] ${f.rule}: ${f.path} — ${f.message}`);\n  }\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-NTYYS53O.js

@@ -0,0 +1,91 @@
+import {
+  deriveSessionDir
+} from "./chunk-S4KW7VH4.js";
+
+// src/core/telemetry.ts
+import { appendFile, readFile, mkdir } from "fs/promises";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { parse as parseYaml } from "yaml";
+var LOG_FILE = "selection.jsonl";
+var CORRELATION_WINDOW_MS = 6e4;
+function selectionLogPath(vaultPath) {
+  return join(deriveSessionDir(vaultPath), LOG_FILE);
+}
+function telemetryEnabled(vaultPath) {
+  try {
+    const schemaPath = join(vaultPath, "vault.schema.yml");
+    if (!existsSync(schemaPath)) return true;
+    const parsed = parseYaml(readFileSync(schemaPath, "utf-8"));
+    const e = parsed?.telemetry?.enabled;
+    return typeof e === "boolean" ? e : true;
+  } catch {
+    return true;
+  }
+}
+async function appendEvent(vaultPath, event, nowIso) {
+  try {
+    if (!telemetryEnabled(vaultPath)) return;
+    const dir = deriveSessionDir(vaultPath);
+    await mkdir(dir, { recursive: true });
+    const line = JSON.stringify({ ts: nowIso ?? (/* @__PURE__ */ new Date()).toISOString(), ...event });
+    await appendFile(selectionLogPath(vaultPath), line + "\n", "utf-8");
+  } catch {
+  }
+}
+var recentSearch = /* @__PURE__ */ new Map();
+function recordSearchForCorrelation(vaultPath, paths, nowMs) {
+  recentSearch.set(vaultPath, { paths: new Set(paths), atMs: nowMs ?? Date.now() });
+}
+function wasRecentlySearched(vaultPath, notePath, nowMs) {
+  const r = recentSearch.get(vaultPath);
+  if (!r) return false;
+  if ((nowMs ?? Date.now()) - r.atMs > CORRELATION_WINDOW_MS) return false;
+  return r.paths.has(notePath);
+}
+async function readSelectionLog(vaultPath, opts = {}) {
+  try {
+    const p = selectionLogPath(vaultPath);
+    if (!existsSync(p)) return [];
+    const raw = await readFile(p, "utf-8");
+    const events = raw.split("\n").filter((l) => l.trim()).map((l) => {
+      try {
+        return JSON.parse(l);
+      } catch {
+        return null;
+      }
+    }).filter((e) => e !== null);
+    return opts.limit ? events.slice(-opts.limit) : events;
+  } catch {
+    return [];
+  }
+}
+async function computeSelectionStats(vaultPath) {
+  const events = await readSelectionLog(vaultPath);
+  const citedPaths = {};
+  const retrieved = /* @__PURE__ */ new Set();
+  let searches = 0;
+  let selections = 0;
+  for (const e of events) {
+    if (e.kind === "search") {
+      searches++;
+      for (const r of e.results) retrieved.add(r.path);
+    } else if (e.kind === "selection") {
+      selections++;
+      citedPaths[e.note_path] = (citedPaths[e.note_path] ?? 0) + 1;
+    }
+  }
+  const retrievedNeverCited = [...retrieved].filter((p) => !(p in citedPaths)).sort();
+  return { searches, selections, citedPaths, retrievedNeverCited };
+}
+
+export {
+  selectionLogPath,
+  telemetryEnabled,
+  appendEvent,
+  recordSearchForCorrelation,
+  wasRecentlySearched,
+  readSelectionLog,
+  computeSelectionStats
+};
+//# sourceMappingURL=chunk-NTYYS53O.js.map

package/dist/chunk-NTYYS53O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/telemetry.ts"],"sourcesContent":["import { appendFile, readFile, mkdir } from \"node:fs/promises\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { parse as parseYaml } from \"yaml\";\nimport { deriveSessionDir } from \"./session.js\";\n\n/**\n * Selection-logging telemetry (v1.3.1).\n *\n * Records what retrieval actually returned and which note the answer used, so a\n * later release (v1.4 usage-feedback ranking) can learn which knowledge is\n * load-bearing. Strictly local, append-only JSONL, fire-and-forget, opt-out.\n *\n * NO NETWORK: this module performs local filesystem I/O only, and never opens a\n * socket or issues a remote request — a unit test greps this file to keep it that way.\n */\n\nconst LOG_FILE = \"selection.jsonl\";\nconst CORRELATION_WINDOW_MS = 60_000;\n\nexport interface SearchEvent {\n  kind: \"search\";\n  tool: string;\n  query: string;\n  results: { path: string; score: number; decay?: number }[];\n}\n\nexport interface SelectionEvent {\n  kind: \"selection\";\n  note_path: string;\n  via: string;\n  /** True when this selection followed a recent search that returned this path. */\n  correlated?: boolean;\n}\n\nexport type TelemetryEvent = (SearchEvent | SelectionEvent) & { ts?: string };\n\n/** Absolute path to the selection log for a given vault. */\nexport function selectionLogPath(vaultPath: string): string {\n  return join(deriveSessionDir(vaultPath), LOG_FILE);\n}\n\n/**\n * Whether telemetry is enabled. Reads `telemetry.enabled` from vault.schema.yml;\n * defaults true (opt-out, not opt-in). Fails open to enabled only if the schema\n * is unreadable — a missing `telemetry` block means \"use the default (true)\".\n */\nexport function telemetryEnabled(vaultPath: string): boolean {\n  try {\n    const schemaPath = join(vaultPath, \"vault.schema.yml\");\n    if (!existsSync(schemaPath)) return true;\n    const parsed = parseYaml(readFileSync(schemaPath, \"utf-8\")) as { telemetry?: { enabled?: boolean } } | null;\n    const e = parsed?.telemetry?.enabled;\n    return typeof e === \"boolean\" ? e : true;\n  } catch {\n    return true;\n  }\n}\n\n/**\n * Append one event. Fire-and-forget: respects the opt-out and NEVER throws — a\n * telemetry failure must not affect the tool call that triggered it.\n */\nexport async function appendEvent(vaultPath: string, event: TelemetryEvent, nowIso?: string): Promise<void> {\n  try {\n    if (!telemetryEnabled(vaultPath)) return;\n    const dir = deriveSessionDir(vaultPath);\n    await mkdir(dir, { recursive: true });\n    const line = JSON.stringify({ ts: nowIso ?? new Date().toISOString(), ...event });\n    await appendFile(selectionLogPath(vaultPath), line + \"\\n\", \"utf-8\");\n  } catch {\n    // fire-and-forget\n  }\n}\n\n// --- In-process correlation ring ---\n// Remembers the most recent search's top-k paths per vault so a subsequent\n// read/synthesize can be attributed to it (best-effort, time-bounded).\n\nconst recentSearch = new Map<string, { paths: Set<string>; atMs: number }>();\n\nexport function recordSearchForCorrelation(vaultPath: string, paths: string[], nowMs?: number): void {\n  recentSearch.set(vaultPath, { paths: new Set(paths), atMs: nowMs ?? Date.now() });\n}\n\nexport function wasRecentlySearched(vaultPath: string, notePath: string, nowMs?: number): boolean {\n  const r = recentSearch.get(vaultPath);\n  if (!r) return false;\n  if ((nowMs ?? Date.now()) - r.atMs > CORRELATION_WINDOW_MS) return false;\n  return r.paths.has(notePath);\n}\n\n/** Read the selection log (oldest→newest). Returns [] if absent/unreadable. */\nexport async function readSelectionLog(vaultPath: string, opts: { limit?: number } = {}): Promise<TelemetryEvent[]> {\n  try {\n    const p = selectionLogPath(vaultPath);\n    if (!existsSync(p)) return [];\n    const raw = await readFile(p, \"utf-8\");\n    const events = raw\n      .split(\"\\n\")\n      .filter((l) => l.trim())\n      .map((l) => {\n        try {\n          return JSON.parse(l) as TelemetryEvent;\n        } catch {\n          return null;\n        }\n      })\n      .filter((e): e is TelemetryEvent => e !== null);\n    return opts.limit ? events.slice(-opts.limit) : events;\n  } catch {\n    return [];\n  }\n}\n\n/** For CLI/analysis: cited-vs-retrieved rollup over the log. */\nexport interface SelectionStats {\n  searches: number;\n  selections: number;\n  citedPaths: Record<string, number>;\n  retrievedNeverCited: string[];\n}\n\nexport async function computeSelectionStats(vaultPath: string): Promise<SelectionStats> {\n  const events = await readSelectionLog(vaultPath);\n  const citedPaths: Record<string, number> = {};\n  const retrieved = new Set<string>();\n  let searches = 0;\n  let selections = 0;\n  for (const e of events) {\n    if (e.kind === \"search\") {\n      searches++;\n      for (const r of e.results) retrieved.add(r.path);\n    } else if (e.kind === \"selection\") {\n      selections++;\n      citedPaths[e.note_path] = (citedPaths[e.note_path] ?? 0) + 1;\n    }\n  }\n  const retrievedNeverCited = [...retrieved].filter((p) => !(p in citedPaths)).sort();\n  return { searches, selections, citedPaths, retrievedNeverCited };\n}\n"],"mappings":";;;;;AAAA,SAAS,YAAY,UAAU,aAAa;AAC5C,SAAS,YAAY,oBAAoB;AACzC,SAAS,YAAY;AACrB,SAAS,SAAS,iBAAiB;AAcnC,IAAM,WAAW;AACjB,IAAM,wBAAwB;AAoBvB,SAAS,iBAAiB,WAA2B;AAC1D,SAAO,KAAK,iBAAiB,SAAS,GAAG,QAAQ;AACnD;AAOO,SAAS,iBAAiB,WAA4B;AAC3D,MAAI;AACF,UAAM,aAAa,KAAK,WAAW,kBAAkB;AACrD,QAAI,CAAC,WAAW,UAAU,EAAG,QAAO;AACpC,UAAM,SAAS,UAAU,aAAa,YAAY,OAAO,CAAC;AAC1D,UAAM,IAAI,QAAQ,WAAW;AAC7B,WAAO,OAAO,MAAM,YAAY,IAAI;AAAA,EACtC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMA,eAAsB,YAAY,WAAmB,OAAuB,QAAgC;AAC1G,MAAI;AACF,QAAI,CAAC,iBAAiB,SAAS,EAAG;AAClC,UAAM,MAAM,iBAAiB,SAAS;AACtC,UAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AACpC,UAAM,OAAO,KAAK,UAAU,EAAE,IAAI,WAAU,oBAAI,KAAK,GAAE,YAAY,GAAG,GAAG,MAAM,CAAC;AAChF,UAAM,WAAW,iBAAiB,SAAS,GAAG,OAAO,MAAM,OAAO;AAAA,EACpE,QAAQ;AAAA,EAER;AACF;AAMA,IAAM,eAAe,oBAAI,IAAkD;AAEpE,SAAS,2BAA2B,WAAmB,OAAiB,OAAsB;AACnG,eAAa,IAAI,WAAW,EAAE,OAAO,IAAI,IAAI,KAAK,GAAG,MAAM,SAAS,KAAK,IAAI,EAAE,CAAC;AAClF;AAEO,SAAS,oBAAoB,WAAmB,UAAkB,OAAyB;AAChG,QAAM,IAAI,aAAa,IAAI,SAAS;AACpC,MAAI,CAAC,EAAG,QAAO;AACf,OAAK,SAAS,KAAK,IAAI,KAAK,EAAE,OAAO,sBAAuB,QAAO;AACnE,SAAO,EAAE,MAAM,IAAI,QAAQ;AAC7B;AAGA,eAAsB,iBAAiB,WAAmB,OAA2B,CAAC,GAA8B;AAClH,MAAI;AACF,UAAM,IAAI,iBAAiB,SAAS;AACpC,QAAI,CAAC,WAAW,CAAC,EAAG,QAAO,CAAC;AAC5B,UAAM,MAAM,MAAM,SAAS,GAAG,OAAO;AACrC,UAAM,SAAS,IACZ,MAAM,IAAI,EACV,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,EACtB,IAAI,CAAC,MAAM;AACV,UAAI;AACF,eAAO,KAAK,MAAM,CAAC;AAAA,MACrB,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF,CAAC,EACA,OAAO,CAAC,MAA2B,MAAM,IAAI;AAChD,WAAO,KAAK,QAAQ,OAAO,MAAM,CAAC,KAAK,KAAK,IAAI;AAAA,EAClD,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAUA,eAAsB,sBAAsB,WAA4C;AACtF,QAAM,SAAS,MAAM,iBAAiB,SAAS;AAC/C,QAAM,aAAqC,CAAC;AAC5C,QAAM,YAAY,oBAAI,IAAY;AAClC,MAAI,WAAW;AACf,MAAI,aAAa;AACjB,aAAW,KAAK,QAAQ;AACtB,QAAI,EAAE,SAAS,UAAU;AACvB;AACA,iBAAW,KAAK,EAAE,QAAS,WAAU,IAAI,EAAE,IAAI;AAAA,IACjD,WAAW,EAAE,SAAS,aAAa;AACjC;AACA,iBAAW,EAAE,SAAS,KAAK,WAAW,EAAE,SAAS,KAAK,KAAK;AAAA,IAC7D;AAAA,EACF;AACA,QAAM,sBAAsB,CAAC,GAAG,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK;AAClF,SAAO,EAAE,UAAU,YAAY,YAAY,oBAAoB;AACjE;","names":[]}