dsh-mnemon-source-runtime 0.5.13 → 0.5.14

package/lib/contracts-B6vRCw3C.js

@@ -0,0 +1,32 @@
+//#region src/defaults.ts
+const DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES = 10240;
+const DEFAULT_RUNTIME_USER_LIMIT_BYTES = 4096;
+const MAX_RUNTIME_MEMORY_LIMIT_BYTES = 1048576;
+//#endregion
+//#region src/contracts.ts
+const RUNTIME_MEMORY_VERSION = 1;
+const RUNTIME_ENTRY_DELIMITER = "\n§\n";
+const RUNTIME_MEMORY_LIMITS = {
+	memory: DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES,
+	user: DEFAULT_RUNTIME_USER_LIMIT_BYTES
+};
+/** The longest git branch name a scope may hold. */
+const RUNTIME_BRANCH_NAME_MAX = 128;
+/** The characters a git branch name in a scope may use. */
+const RUNTIME_BRANCH_NAME_PATTERN = /^[A-Za-z0-9._/-]+$/u;
+/**
+* Read a stored branch scope. Absent or malformed data reads as no scope, so an entry that
+* a hand edit or another installation left malformed is projected on every branch instead
+* of breaking the projection that reads it.
+*/
+function parseRuntimeBranches(value) {
+	if (!Array.isArray(value)) return void 0;
+	const branches = [];
+	for (const item of value) {
+		if (typeof item !== "string" || item === "" || item.length > 128 || !RUNTIME_BRANCH_NAME_PATTERN.test(item)) return void 0;
+		branches.push(item);
+	}
+	return branches;
+}
+//#endregion
+export { RUNTIME_MEMORY_VERSION as a, DEFAULT_RUNTIME_USER_LIMIT_BYTES as c, RUNTIME_MEMORY_LIMITS as i, MAX_RUNTIME_MEMORY_LIMIT_BYTES as l, RUNTIME_BRANCH_NAME_PATTERN as n, parseRuntimeBranches as o, RUNTIME_ENTRY_DELIMITER as r, DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES as s, RUNTIME_BRANCH_NAME_MAX as t };

package/lib/contracts.d.ts

@@ -2,6 +2,12 @@
 type RuntimeMemoryTarget = 'memory' | 'user';
 type RuntimeMemoryImportance = 'critical' | 'normal' | 'low';
 type RuntimeMemoryAction = 'add' | 'replace' | 'remove';
+/** Provenance a DSH Host stamps when an entry crosses machines; absent for local writes. */
+interface RuntimeMemoryEntryOrigin {
+  machine: string;
+  label: string;
+  at: string;
+}
 interface RuntimeMemoryEntry {
   content: string;
   created_at: string;
@@ -10,6 +16,8 @@ interface RuntimeMemoryEntry {
   importance: RuntimeMemoryImportance;
   /** Optional git branch names that limit where this entry is projected. Absent means every branch. */
   branches?: string[];
+  /** Which installation wrote this entry, so a merge can tell two machines apart. */
+  origin?: RuntimeMemoryEntryOrigin;
 }
 interface RuntimeMemoryUsage {
   used: number;
@@ -89,5 +97,15 @@ interface RuntimeMemoryLimits {
   readonly user: number;
 }
 declare const RUNTIME_MEMORY_LIMITS: RuntimeMemoryLimits;
+/** The longest git branch name a scope may hold. */
+declare const RUNTIME_BRANCH_NAME_MAX = 128;
+/** The characters a git branch name in a scope may use. */
+declare const RUNTIME_BRANCH_NAME_PATTERN: RegExp;
+/**
+ * Read a stored branch scope. Absent or malformed data reads as no scope, so an entry that
+ * a hand edit or another installation left malformed is projected on every branch instead
+ * of breaking the projection that reads it.
+ */
+declare function parseRuntimeBranches(value: unknown): string[] | undefined;
 //#endregion
-export { RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION, RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryImportance, RuntimeMemoryLimits, RuntimeMemoryMaintenancePlan, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage };
+export { RUNTIME_BRANCH_NAME_MAX, RUNTIME_BRANCH_NAME_PATTERN, RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION, RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryEntryOrigin, RuntimeMemoryImportance, RuntimeMemoryLimits, RuntimeMemoryMaintenancePlan, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage, parseRuntimeBranches };

package/lib/contracts.js

@@ -1,2 +1,2 @@
-import { n as RUNTIME_MEMORY_LIMITS, r as RUNTIME_MEMORY_VERSION, t as RUNTIME_ENTRY_DELIMITER } from "./contracts-BqaPCrGD.js";
-export { RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION };
+import { a as RUNTIME_MEMORY_VERSION, i as RUNTIME_MEMORY_LIMITS, n as RUNTIME_BRANCH_NAME_PATTERN, o as parseRuntimeBranches, r as RUNTIME_ENTRY_DELIMITER, t as RUNTIME_BRANCH_NAME_MAX } from "./contracts-B6vRCw3C.js";
+export { RUNTIME_BRANCH_NAME_MAX, RUNTIME_BRANCH_NAME_PATTERN, RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION, parseRuntimeBranches };

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-import { RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION, RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryImportance, RuntimeMemoryLimits, RuntimeMemoryMaintenancePlan, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage } from "./contracts.js";
+import { RUNTIME_BRANCH_NAME_MAX, RUNTIME_BRANCH_NAME_PATTERN, RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION, RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryEntryOrigin, RuntimeMemoryImportance, RuntimeMemoryLimits, RuntimeMemoryMaintenancePlan, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage, parseRuntimeBranches } from "./contracts.js";
 import z from "@deepseek-ai/schemastery";
 import { MemorySourceDefinition } from "dsh-mnemon/contracts";
 import { Context } from "@deepseek-ai/cordis";
@@ -21,4 +21,4 @@ declare const inject: string[];
 declare const memoryPlugin: import("dsh-mnemon/extension-sdk").MemoryPluginDescriptor;
 declare function apply(ctx: Context, config?: Config): void;
 //#endregion
-export { Config, type RUNTIME_ENTRY_DELIMITER, type RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_SOURCE, type RUNTIME_MEMORY_VERSION, type RuntimeMemoryAction, type RuntimeMemoryCompactedEntry, type RuntimeMemoryEntry, type RuntimeMemoryImportance, type RuntimeMemoryLimits, type RuntimeMemoryMaintenancePlan, type RuntimeMemoryMutation, type RuntimeMemoryMutationResult, type RuntimeMemorySnapshot, type RuntimeMemoryTarget, type RuntimeMemoryTargetView, type RuntimeMemoryUsage, apply, createRuntimeMemorySource, inject, memoryPlugin, name };
+export { Config, type RUNTIME_BRANCH_NAME_MAX, type RUNTIME_BRANCH_NAME_PATTERN, type RUNTIME_ENTRY_DELIMITER, type RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_SOURCE, type RUNTIME_MEMORY_VERSION, type RuntimeMemoryAction, type RuntimeMemoryCompactedEntry, type RuntimeMemoryEntry, type RuntimeMemoryEntryOrigin, type RuntimeMemoryImportance, type RuntimeMemoryLimits, type RuntimeMemoryMaintenancePlan, type RuntimeMemoryMutation, type RuntimeMemoryMutationResult, type RuntimeMemorySnapshot, type RuntimeMemoryTarget, type RuntimeMemoryTargetView, type RuntimeMemoryUsage, apply, createRuntimeMemorySource, inject, memoryPlugin, name, type parseRuntimeBranches };

package/lib/index.js

@@ -1,4 +1,4 @@
-import { n as RUNTIME_MEMORY_LIMITS, o as MAX_RUNTIME_MEMORY_LIMIT_BYTES, t as RUNTIME_ENTRY_DELIMITER } from "./contracts-BqaPCrGD.js";
+import { i as RUNTIME_MEMORY_LIMITS, l as MAX_RUNTIME_MEMORY_LIMIT_BYTES, n as RUNTIME_BRANCH_NAME_PATTERN, o as parseRuntimeBranches, r as RUNTIME_ENTRY_DELIMITER } from "./contracts-B6vRCw3C.js";
 import { createMemoryMutationReceipt, defineMemoryPlugin, defineMemorySource, installMemory, memoryConfigurationDigest, memoryInputRecord, memoryInputStringArray, memoryInputText, truncateMemoryText } from "dsh-mnemon/extension-sdk";
 import { homedir } from "node:os";
 import { basename, isAbsolute, join } from "node:path";
@@ -34,6 +34,19 @@ const GIT_BRANCH_TIMEOUT_MS = 2e3;
 * the directory is not a git working tree, HEAD is detached, or the probe
 * fails or times out, so callers fall back to the unfiltered view.
 */
+/**
+* Git takes the repository location from the environment, so a launcher that
+* exports `GIT_DIR` for its own reasons would point this probe at a directory
+* that is not the workspace. The probe runs with those variables removed.
+*/
+function gitEnvironment(environment = process.env) {
+	const sanitized = {};
+	for (const [name, value] of Object.entries(environment)) {
+		if (value === void 0 || name.toUpperCase().startsWith("GIT_")) continue;
+		sanitized[name] = value;
+	}
+	return sanitized;
+}
 function resolveGitBranch(cwd) {
 	const root = cwd?.trim();
 	if (root === void 0 || root === "") return void 0;
@@ -51,7 +64,8 @@ function resolveGitBranch(cwd) {
 				"pipe",
 				"ignore"
 			],
-			windowsHide: true
+			windowsHide: true,
+			env: gitEnvironment()
 		}).trim();
 		return branch === "" ? void 0 : branch;
 	} catch {
@@ -105,7 +119,6 @@ function isTarget(value) {
 function isImportance(value) {
 	return value === "critical" || value === "normal" || value === "low";
 }
-const RUNTIME_BRANCH_NAME_RE = /^[A-Za-z0-9._/-]+$/u;
 /** Validate a model-supplied branch scope. Returns the normalized list; an empty list means "no scope". */
 function normalizeRuntimeBranches(value, field = "branches") {
 	if (!Array.isArray(value)) throw new Error(`${field} must be an array of git branch names`);
@@ -114,7 +127,7 @@ function normalizeRuntimeBranches(value, field = "branches") {
 	for (const item of value) {
 		if (typeof item !== "string") throw new Error(`${field} must contain only git branch names`);
 		const branch = item.trim();
-		if (branch === "" || branch.length > 128 || !RUNTIME_BRANCH_NAME_RE.test(branch) || branch === "-" || branch.startsWith("/") || branch.startsWith("-") || branch.endsWith("/") || branch.endsWith(".") || branch.includes("..") || branch.includes("//") || branch.includes("@{")) throw new Error(`${field} must contain git branch names (letters, numbers, dot, underscore, slash, dash)`);
+		if (branch === "" || branch.length > 128 || !RUNTIME_BRANCH_NAME_PATTERN.test(branch) || branch === "-" || branch.startsWith("/") || branch.startsWith("-") || branch.endsWith("/") || branch.endsWith(".") || branch.includes("..") || branch.includes("//") || branch.includes("@{")) throw new Error(`${field} must contain git branch names (letters, numbers, dot, underscore, slash, dash)`);
 		if (seen.has(branch)) throw new Error(`${field} must not repeat a branch name`);
 		seen.add(branch);
 		branches.push(branch);
@@ -122,17 +135,6 @@ function normalizeRuntimeBranches(value, field = "branches") {
 	if (branches.length > 16) throw new Error(`${field} supports at most 16 branch names`);
 	return branches;
 }
-/** Parse a stored branch scope. Returns undefined for absent or invalid data. */
-function parseRuntimeBranches(value) {
-	if (value === void 0) return void 0;
-	if (!Array.isArray(value)) return void 0;
-	const branches = [];
-	for (const item of value) {
-		if (typeof item !== "string" || item === "" || item.length > 128 || !RUNTIME_BRANCH_NAME_RE.test(item)) return void 0;
-		branches.push(item);
-	}
-	return branches;
-}
 function entryMatchesBranch(entry, branch) {
 	return entry.branches === void 0 || entry.branches.length === 0 || entry.branches.includes(branch);
 }
@@ -148,6 +150,15 @@ function normalizeContent(value, field) {
 	if (bytes > MAX_ENTRY_BYTES) throw new Error(`${field} is too large (${bytes} bytes; max ${MAX_ENTRY_BYTES})`);
 	return content;
 }
+function parseOrigin(value) {
+	if (!isRecord(value)) return void 0;
+	if (typeof value.machine !== "string" || typeof value.label !== "string" || typeof value.at !== "string") return void 0;
+	return {
+		machine: value.machine,
+		label: value.label,
+		at: value.at
+	};
+}
 function parseEntry(value) {
 	if (!isRecord(value) || typeof value.content !== "string" || !isTarget(value.target) || !isImportance(value.importance)) return void 0;
 	if (typeof value.created_at !== "string" || typeof value.updated_at !== "string") return void 0;
@@ -155,13 +166,15 @@ function parseEntry(value) {
 	if (content === "" || content.includes("§")) return void 0;
 	if (value.target === "user" && value.branches !== void 0) return void 0;
 	const branches = parseRuntimeBranches(value.branches);
+	const origin = parseOrigin(value.origin);
 	return {
 		content,
 		created_at: value.created_at,
 		updated_at: value.updated_at,
 		target: value.target,
 		importance: value.importance,
-		...branches === void 0 ? {} : { branches }
+		...branches === void 0 ? {} : { branches },
+		...origin === void 0 ? {} : { origin }
 	};
 }
 function byteCount(entries, target) {

package/lib/types/contracts.d.ts

@@ -1,6 +1,12 @@
 export type RuntimeMemoryTarget = 'memory' | 'user';
 export type RuntimeMemoryImportance = 'critical' | 'normal' | 'low';
 export type RuntimeMemoryAction = 'add' | 'replace' | 'remove';
+/** Provenance a DSH Host stamps when an entry crosses machines; absent for local writes. */
+export interface RuntimeMemoryEntryOrigin {
+    machine: string;
+    label: string;
+    at: string;
+}
 export interface RuntimeMemoryEntry {
     content: string;
     created_at: string;
@@ -9,6 +15,8 @@ export interface RuntimeMemoryEntry {
     importance: RuntimeMemoryImportance;
     /** Optional git branch names that limit where this entry is projected. Absent means every branch. */
     branches?: string[];
+    /** Which installation wrote this entry, so a merge can tell two machines apart. */
+    origin?: RuntimeMemoryEntryOrigin;
 }
 export interface RuntimeMemoryUsage {
     used: number;
@@ -88,3 +96,13 @@ export interface RuntimeMemoryLimits {
     readonly user: number;
 }
 export declare const RUNTIME_MEMORY_LIMITS: RuntimeMemoryLimits;
+/** The longest git branch name a scope may hold. */
+export declare const RUNTIME_BRANCH_NAME_MAX = 128;
+/** The characters a git branch name in a scope may use. */
+export declare const RUNTIME_BRANCH_NAME_PATTERN: RegExp;
+/**
+ * Read a stored branch scope. Absent or malformed data reads as no scope, so an entry that
+ * a hand edit or another installation left malformed is projected on every branch instead
+ * of breaking the projection that reads it.
+ */
+export declare function parseRuntimeBranches(value: unknown): string[] | undefined;

package/package.json

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

package/lib/contracts-BqaPCrGD.js

@@ -1,14 +0,0 @@
-//#region src/defaults.ts
-const DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES = 10240;
-const DEFAULT_RUNTIME_USER_LIMIT_BYTES = 4096;
-const MAX_RUNTIME_MEMORY_LIMIT_BYTES = 1048576;
-//#endregion
-//#region src/contracts.ts
-const RUNTIME_MEMORY_VERSION = 1;
-const RUNTIME_ENTRY_DELIMITER = "\n§\n";
-const RUNTIME_MEMORY_LIMITS = {
-	memory: DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES,
-	user: DEFAULT_RUNTIME_USER_LIMIT_BYTES
-};
-//#endregion
-export { DEFAULT_RUNTIME_USER_LIMIT_BYTES as a, DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES as i, RUNTIME_MEMORY_LIMITS as n, MAX_RUNTIME_MEMORY_LIMIT_BYTES as o, RUNTIME_MEMORY_VERSION as r, RUNTIME_ENTRY_DELIMITER as t };