dsh-mnemon-strategy-default-three-tier 0.5.11 → 0.5.12

package/README.md

@@ -69,6 +69,19 @@ the same role, the original ambiguity check applies rather than silently
 choosing a Source. Projection limits are not token limits or delta injection;
 capture guidance is not a background worker or a guarantee of model behavior.
 
+## Sources with another role
+
+An installed Source whose role is not `working-context`, `narrative` or
+`durable-evidence` is not a failure and is not admitted either: the strategy
+keeps composing the three tiers and returns one `unsupported-source-role`
+entry per such Source in `ViewSpec.diagnostics`. The Host validates those
+entries and merges them into `view.diagnostics`, so the turn's
+`MNEMON VIEW AVAILABILITY` line and the View inspection name the Source and its
+role. A diagnostic is an explanation, never authority: the Source still gets no
+projection, Route or ActionOffer. Select the general Strategy to compose it;
+an explicit `selection` still rejects unsupported roles. An unavailable Source keeps
+the Host's own diagnostic instead.
+
 Its own directory is a standalone project: install its declared dependencies,
 then run `pnpm verify`. When developing against an unreleased Mnemon, install a
 packed `dsh-mnemon` artifact as the peer instead of linking its source tree.

package/lib/index.js

@@ -510,11 +510,30 @@ const VIEW_ROLES = [
 	"narrative",
 	"durable-evidence"
 ];
+/** The Host accepts at most 32 ViewSpec diagnostics; the summary keeps us inside it. */
+const MAX_DIAGNOSTICS = 32;
 function soleSource(sources, role) {
 	const matches = sources.filter((source) => source.role === role && source.availability !== "unavailable").sort((left, right) => left.sourceInstanceKey.localeCompare(right.sourceInstanceKey));
 	if (matches.length > 1) throw new Error(`default-three-tier View Strategy found ambiguous ${role} Sources; select an explicit Strategy`);
 	return matches[0];
 }
+/**
+* Why an installed Source stays out of this View (#504). A custom role is not a
+* failure, so it is explained instead of silently dropped; an unavailable Source
+* already carries the Host's own diagnostic. Sorted by instance key so repeated
+* composition stays deterministic.
+*/
+function unsupportedRoleDiagnostics(sources) {
+	const unsupported = sources.filter((source) => source.availability !== "unavailable" && !VIEW_ROLES.includes(source.role)).sort((left, right) => left.sourceInstanceKey.localeCompare(right.sourceInstanceKey));
+	const reported = unsupported.length <= MAX_DIAGNOSTICS ? unsupported : unsupported.slice(0, 31);
+	return [...reported.map((source) => ({
+		code: "unsupported-source-role",
+		message: `Installed Source ${source.sourceInstanceKey} declares the role "${source.role}", which the default-three-tier Strategy does not admit, so it contributes no projection, Routes or Actions to this View. Use the general Strategy to compose it.`
+	})), ...reported.length === unsupported.length ? [] : [{
+		code: "unsupported-source-role",
+		message: `${unsupported.length - reported.length} more installed Sources declare a role the default-three-tier Strategy does not admit.`
+	}]];
+}
 /** Pure View composition; no dependency on any Source implementation. */
 const DEFAULT_THREE_TIER_VIEW_STRATEGY = defineMemoryStrategy({
 	createTurn: createThreeTierTurn,
@@ -536,7 +555,12 @@ const DEFAULT_THREE_TIER_VIEW_STRATEGY = defineMemoryStrategy({
 		workflows: ["idle-review", "runtime-capacity"]
 	},
 	compose(request, sources, contributions = []) {
-		if (contributions.length === 0) return composeThreeTier(request, sources);
+		const diagnostics = unsupportedRoleDiagnostics(sources);
+		const explained = (spec) => diagnostics.length === 0 ? spec : {
+			...spec,
+			diagnostics
+		};
+		if (contributions.length === 0) return explained(composeThreeTier(request, sources));
 		const policies = threeTierContributions(contributions);
 		const boundedRequest = policies.projection === void 0 ? request : {
 			...request,
@@ -545,7 +569,7 @@ const DEFAULT_THREE_TIER_VIEW_STRATEGY = defineMemoryStrategy({
 				maxProjectionCharacters: Math.min(request.budget.maxProjectionCharacters, policies.projection.maxProjectionCharacters)
 			}
 		};
-		const spec = policies.selection === void 0 ? composeThreeTier(boundedRequest, sources) : composeSelected(boundedRequest, sources, policies.selection);
+		const spec = explained(policies.selection === void 0 ? composeThreeTier(boundedRequest, sources) : composeSelected(boundedRequest, sources, policies.selection));
 		if (policies.capture !== void 0) {
 			const targets = spec.sources.filter((selected) => (policies.capture.sourceKeys === void 0 || policies.capture.sourceKeys.includes(selected.sourceInstanceKey)) && sources.some((source) => source.sourceInstanceKey === selected.sourceInstanceKey && source.actions.some((action) => selected.actionIds?.includes(action.id) && policies.capture.actionIds.includes(action.id) && action.authority === void 0 && ["write", "maintain"].includes(action.capability))));
 			if (targets.length > 0) {
@@ -627,7 +651,7 @@ function composeSelected(request, sources, selection) {
 	const selected = selection.sourceKeys.map((key) => {
 		const source = sources.find((source) => source.sourceInstanceKey === key);
 		if (source === void 0) throw new Error(`scoped three-tier Source is not installed: ${key}`);
-		if (!VIEW_ROLES.includes(source.role)) throw new Error(`unsupported scoped three-tier Source role: ${source.role}`);
+		if (!VIEW_ROLES.includes(source.role)) throw new Error(`unsupported scoped three-tier Source role: ${source.role} (${source.sourceInstanceKey}); default-three-tier admits ${VIEW_ROLES.join(", ")} only, so remove it from the selection or select the general Strategy`);
 		return source;
 	}).filter((source) => source.availability !== "unavailable");
 	const projected = selected.filter((source) => source.capabilities.includes("project"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon-strategy-default-three-tier",
-  "version": "0.5.11",
+  "version": "0.5.12",
   "description": "Explicit three-tier View Strategy for Composable View Memory.",
   "license": "MIT",
   "type": "module",
@@ -36,7 +36,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "dsh-mnemon": "^0.5.35",
+    "dsh-mnemon": "^0.5.40",
     "tsdown": "^0.22.0",
     "typescript": "^5.9.0",
     "vitest": "^3.2.0"