dsh-memory-index

Configuration

- id: memory-index
  name: dsh-memory-index
  config:
    workspace: /home/you/notes
    indexDb: .memory/index.sqlite
    roots:
      - { path: MEMORY.md, source: core }
      - { path: memory, source: daily }
      - { path: wiki, source: wiki }
      - { path: archive/sessions, source: session }
    writeRoots:
      - MEMORY.md
      - memory
    digest:
      - { path: MEMORY.md, maxChars: 3500 }
      - { path: 'memory/{today}.md', maxChars: 1500 }
      - { path: 'memory/{yesterday}.md', maxChars: 1000 }
    timeZone: Asia/Shanghai
    sourcePriority:
      core: 0
      daily: 1
      wiki: 2
      session: 3
    writeMode: readonly       # readonly | readwrite
    autoRecall: off           # off | startup
    buildOnStart: false
    maxResults: 8
    maxFileBytes: 20971520
    maxWriteBytes: 204800
    maxDigestChars: 8000

Field	Default	Meaning
workspace	required	Directory containing the memory tree. Resolved once and used as the boundary for all reads/writes.
indexDb	.memory/index.sqlite	SQLite file, relative to workspace, or :memory:.
roots	MEMORY.md, memory/, wiki/, archive/sessions/	Files or directories to index. A file root is indexed directly; a directory root is walked recursively. source labels the results.
writeRoots	MEMORY.md, memory/	Paths the agent may write. Entries ending in .md are files; others are directories.
digest	MEMORY.md, today, yesterday	Optional startup excerpt. {today} and {yesterday} use timeZone.
timeZone	system zone	Used for daily-note filenames and digest placeholders.
sourcePriority	core, daily, wiki, session	Lower ranks first in ties. Unknown sources sort last.
writeMode	readonly	Set readwrite to enable memory_write.
autoRecall	off	Set startup to add the digest as prompt context for workspace agents.
buildOnStart	false	Build the index in the background after plugin load.
maxResults	8	Default and cap for memory_search (1–20).
maxFileBytes	20 MiB	Files larger than this are skipped.
maxWriteBytes	200 KiB	Maximum content accepted by one memory_write.
maxDigestChars	8000	Character budget for the startup digest.

roots and writeRoots are independent on purpose: you can index wiki/ and archive/sessions/ while allowing writes only to memory/.