dsh-mnemon-source-runtime 0.5.8 → 0.5.9

package/README.md

@@ -19,6 +19,8 @@ Choose an existing data authority deliberately. Without `dataDir`, each stable S
 
 Disabling participation does not delete stored entries. Source data remains separate from the current turn's projection and access grants.
 
+Model projections annotate each entry with its recorded importance and elapsed whole-day ages, for example `[importance=critical; created=14d; updated=2d]`, followed by the exact content. Future timestamps show `future`; unparseable ones show `unknown`. Ages are captured once per projection and remain fixed for that turn. Annotations count toward the Strategy's projection budget, but do not change stored JSON/Markdown, content matching or storage capacity. For replacement/removal, use only the entry content. Current instructions retain priority.
+
 ## Source-owned UI and tests
 
 The optional `./client` entry is an ordinary DSH Client plugin. This package owns its pages and `presentation/` resources and uses `dsh-mnemon/client` for the shared frame and scoped management client. It never receives a Host Context, credentials or another Source's controller.

package/lib/index.js

@@ -162,6 +162,16 @@ function markdown(entries, target) {
 	const content = entries.filter((entry) => entry.target === target).map((entry) => entry.content).join(RUNTIME_ENTRY_DELIMITER);
 	return content === "" ? "" : `${content}\n`;
 }
+function age(timestamp, projectedAt) {
+	const time = Date.parse(timestamp);
+	if (!Number.isFinite(time)) return "unknown";
+	if (time > projectedAt) return "future";
+	return `${Math.floor((projectedAt - time) / 864e5)}d`;
+}
+/** Prompt-only annotations; stored content, matching and capacity stay unchanged. */
+function contextMarkdown(entries, target, projectedAt) {
+	return entries.filter((entry) => entry.target === target).map((entry) => `[importance=${entry.importance}; created=${age(entry.created_at, projectedAt)}; updated=${age(entry.updated_at, projectedAt)}]\n${entry.content}`).join(RUNTIME_ENTRY_DELIMITER);
+}
 function revision(file) {
 	return createHash("sha256").update(JSON.stringify(file)).digest("hex");
 }
@@ -299,7 +309,7 @@ function sleepSync(milliseconds) {
 }
 /**
 * Single authority for hot memory. JSON is the durable source of truth;
-* Markdown files are deterministic projections consumed by prompt assembly.
+* Markdown files retain plain content; prompt projections add recorded metadata.
 */
 var RuntimeMemoryController = class RuntimeMemoryController {
 	now;
@@ -352,8 +362,9 @@ var RuntimeMemoryController = class RuntimeMemoryController {
 	*/
 	contextProjection(branch) {
 		const branchScope = scopeBranch(branch);
-		const local = this.localContextProjection(branchScope);
-		const global = this.userController?.localContextProjection();
+		const projectedAt = this.now().getTime();
+		const local = this.localContextProjection(projectedAt, branchScope);
+		const global = this.userController?.localContextProjection(projectedAt);
 		const user = global?.user ?? local.user;
 		const memory = local.memory;
 		const entries = global === void 0 ? local.snapshot.entries : [...global.snapshot.entries.filter((entry) => entry.target === "user"), ...local.snapshot.entries.filter((entry) => entry.target === "memory")];
@@ -366,7 +377,7 @@ var RuntimeMemoryController = class RuntimeMemoryController {
 				version: 1,
 				entries
 			}),
-			generatedAt: this.now().toISOString(),
+			generatedAt: new Date(projectedAt).toISOString(),
 			entries,
 			targets: {
 				memory: {
@@ -392,6 +403,7 @@ var RuntimeMemoryController = class RuntimeMemoryController {
 			totalEntries: entries.length,
 			text: `MNEMON RUNTIME MEMORY SNAPSHOT
 Revision: ${snapshot.revision}${branchLine}
+Metadata lines are annotations; created/updated are ages at projection in whole days (future/unknown for future/invalid timestamps). Current instructions win. For old_text/oldText, use entry content only.
 
 Contents of USER.md (user profile; entries: ${visibleUser.entryCount}; UTF-8 bytes: ${storeUser.used}/${storeUser.limit})
 <runtime-memory-file name="USER.md">
@@ -404,7 +416,7 @@ ${memory || "(empty)"}
 </runtime-memory-file>`
 		};
 	}
-	localContextProjection(branch) {
+	localContextProjection(projectedAt, branch) {
 		const branchScope = scopeBranch(branch);
 		return this.withLock(() => {
 			const file = this.readSource();
@@ -416,15 +428,15 @@ ${memory || "(empty)"}
 					directory: this.directory,
 					sourcePath: this.sourcePath,
 					revision: revision(file),
-					generatedAt: this.now().toISOString(),
+					generatedAt: new Date(projectedAt).toISOString(),
 					entries,
 					targets: {
 						memory: this.targetView(visible, "memory"),
 						user: this.targetView(visible, "user")
 					}
 				},
-				user: readFileSync(this.localUserPath, "utf8").trimEnd(),
-				memory: branchScope === void 0 ? readFileSync(this.memoryPath, "utf8").trimEnd() : markdown(visible, "memory").trimEnd(),
+				user: contextMarkdown(visible, "user", projectedAt),
+				memory: contextMarkdown(visible, "memory", projectedAt),
 				hidden: branchScope === void 0 ? 0 : entries.length - visible.length
 			};
 		});
@@ -737,7 +749,7 @@ function createRuntimeMemorySource(config = {}) {
 						content: { type: "string" },
 						oldText: {
 							type: "string",
-							description: "Full content of the existing entry, or a unique substring. A unique full-content match takes precedence within the selected target. Required for replace and remove."
+							description: "Full content of the existing entry, or a unique substring, excluding the generated metadata line. A unique full-content match takes precedence within the selected target. Required for replace and remove."
 						},
 						importance: {
 							type: "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon-source-runtime",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "description": "Self-contained runtime Source for Composable View Memory.",
   "license": "MIT",
   "type": "module",
@@ -61,7 +61,7 @@
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
-    "dsh-mnemon": "^0.5.11",
+    "dsh-mnemon": "^0.5.15",
     "jsdom": "^26.0.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",