@try-works/dsh-memory 0.2.0 → 0.2.2

package/STATUS.md

@@ -28,10 +28,12 @@ What does NOT exist, by design: content indexing. The store documents a file ("W
 to read it"); it never extracts or indexes the file's contents, and a token that appears only
 inside a PDF is deliberately not searchable (pinned by the acceptance suite).
 
-Two integration decisions worth keeping: `refresh` skips the asset layer entirely (a supersede
-would hide the entry while its inventory refcount stayed, orphaning the blob), and an automatic
-capture over quota records a notice instead of asking, because `session/event` is reentrancy-
-sensitive and has no answerer; only `memory_asset_put` asks.
+Three integration decisions worth keeping: `refresh` skips the asset layer entirely (a supersede
+would hide the entry while its inventory refcount stayed, orphaning the blob); the generic
+`memory_forget` REFUSES an asset entry and names `memory_asset_forget`, which is the only path
+that decrements the inventory; and an automatic capture over quota records a notice instead of
+asking, because `session/event` is reentrancy-sensitive and has no answerer — only
+`memory_asset_put` asks.
 
 ## Store performance, 2026-11-01
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@try-works/dsh-memory",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Git-backed, workspace-scoped memory for the DeepSeek Harness (global layer + per-workspace layers)",
   "type": "module",
   "main": "src/index.js",

package/src/forget.js

@@ -40,6 +40,13 @@ export function isSuppressed(root, scope, text) {
 export function forget(store, id) {
   const entry = buildLedger(store.root).find((e) => e.id === id)
   if (!entry) throw new Error('no such entry: ' + id)
+  // An ASSET entry is removed by memory_asset_forget, which also decrements the inventory and
+  // deletes the object when it is the last reference. This function only marks an entry
+  // superseded, so allowing it here would hide the asset while the blob stayed in the store and in
+  // LFS with nothing pointing at it - the same orphan the refresh pass refuses to create.
+  if (entry.layer === 'asset') {
+    throw new Error('asset entries are removed with memory_asset_forget, not memory_forget (id ' + id + ')')
+  }
   const scope = entry.file.startsWith('global/') ? 'global' : entry.file.split('/')[1]
   const hash = suppressionHash(scope, entry.content)
   appendTombstone(store.root, { hash, scope, id, createdAt: new Date().toISOString(), reason: 'user-forget' })

package/src/store.js

@@ -7,7 +7,7 @@ import { GLOBAL_LAYERED, LAYER_DIRS, LAYERED } from './entry.js'
 import { sanitizeKey, deriveWorkspaceKey } from './workspace-key.js'
 import { workingPreamble } from './working.js'
 
-export const LAYER_FILES = ['INDEX.md', 'semantic.md', 'episodic.md', 'procedural.md', 'working.md', 'learnings.md', 'junk.md', 'codebase.md', 'history.md', 'decisions.md', 'state.md']
+export const LAYER_FILES = ['INDEX.md', 'semantic.md', 'episodic.md', 'procedural.md', 'working.md', 'learnings.md', 'junk.md', 'codebase.md', 'history.md', 'decisions.md', 'assets.md', 'state.md']
 
 /** Working memory is the current-state head of ONE repo/workspace, never of the
  * whole store: a global working.md would mix unrelated repositories together. */

package/src/system-doc.js

@@ -14,7 +14,7 @@ import { fileURLToPath } from 'node:url'
 import { LAYER_CODES, LAYER_DIRS, LAYERED, VOLATILITY_DAYS, WORKSPACE_ONLY_LAYERS } from './entry.js'
 
 /** Bumped whenever the described behaviour changes, so a stale on-disk copy is detectable. */
-export const SYSTEM_DOC_VERSION = 2
+export const SYSTEM_DOC_VERSION = 3
 
 /** The template ships beside this module; resolve it relative to the module, not the cwd. */
 export function templatePath() {
@@ -83,6 +83,7 @@ const LAYER_PURPOSE = {
   codebase: 'What a module, file or subsystem of THIS repository does. Workspace only.',
   history: 'How the repository changed: one entry per commit, grouped by day. Workspace only.',
   decision: 'A settled choice and why it won: dependencies, conventions, architecture. Available in both scopes.',
+  asset: 'A stored file - a document, an image or a data file - documented with what it is and when to read it. The bytes live under assets/objects and are fetched with memory_asset_get; the contents are never indexed.',
 }
 
 /**