@lmzhen/dsh-skill-usage 0.4.1 → 0.5.0

package/lib/index.js

@@ -1,6 +1,6 @@
 import { Service } from "@deepseek-ai/cordis";
 import z from "@deepseek-ai/schemastery";
-import { ToolDispatchNormalizer, appendEvolutionEvent, bumpPatch, bumpUse, bumpView, eventsFile, evolutionIoAdapter, evolutionRoot, getRecord, loadUsage, makeSerialQueue, markAgentCreated, mutateUsage, resolveSkillsRoot, sessionAudited, skillReadNameOf, usageObserved } from "@lmzhen/dsh-evolution-core";
+import { DEFAULT_SUPPORT_READ_TOOL_NAMES, ToolDispatchNormalizer, appendEvolutionEvent, bumpPatch, bumpSupportRead, bumpUse, bumpView, eventsFile, evolutionIoAdapter, evolutionRoot, getRecord, isReviewChannelSession, loadUsage, makeSerialQueue, markAgentCreated, mutateUsage, resolveSkillsRoot, sessionAudited, skillReadNameOf, supportFileReadOf, usageObserved } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Skill usage telemetry service for the evolution family.
@@ -42,16 +42,19 @@ var SkillUsageRegistry = class extends Service {
 	static Config = z.object({
 		root: z.string().default(""),
 		eventsHome: z.string().default(""),
-		sessionScoped: z.boolean().default(false)
+		sessionScoped: z.boolean().default(false),
+		supportReadToolNames: z.array(z.string()).default([...DEFAULT_SUPPORT_READ_TOOL_NAMES])
 	});
 	root;
 	eventsHome;
 	io;
+	supportReadToolNames;
 	/** Process-local RMW queue (v34 B14 / v35 R6: the same factory the other sidecars use). */
 	serial = makeSerialQueue();
 	constructor(ctx, config = {}) {
 		super(ctx, "skillUsage");
 		this.root = resolveSkillsRoot(config);
+		this.supportReadToolNames = config.supportReadToolNames ?? DEFAULT_SUPPORT_READ_TOOL_NAMES;
 		this.eventsHome = config.eventsHome?.trim() || evolutionRoot();
 		this.io = evolutionIoAdapter(() => ctx.evolutionIo.provider());
 		ctx.effect(() => {
@@ -62,8 +65,12 @@ var SkillUsageRegistry = class extends Service {
 				const settled = reads.settledSignalOf(event, session.id);
 				if (settled === null || settled.ok === false) return;
 				const settledName = skillReadNameOf(settled);
-				if (settledName === void 0) return;
-				this.observeRead(settledName).catch(() => {});
+				if (settledName !== void 0) this.observeRead(settledName).catch(() => {});
+				const supportHit = supportFileReadOf(settled, {
+					toolNames: this.supportReadToolNames,
+					root: this.root
+				});
+				if (supportHit !== null && !isReviewChannelSession(session.id)) this.recordSupportRead(supportHit.skill, supportHit.rel).catch(() => {});
 			});
 		}, "skill-usage.telemetry");
 	}
@@ -89,6 +96,18 @@ var SkillUsageRegistry = class extends Service {
 		});
 	}
 	/**
+	* Demand telemetry (design §5.5): count one observed support-file read on an
+	* EXISTING record only — the same creation-free discipline as `observeRead`,
+	* so a read can never mint a usage record.
+	*/
+	recordSupportRead(name, rel) {
+		const normalized = name.trim();
+		return this.mutate((map) => {
+			if (!map.has(normalized)) return;
+			bumpSupportRead(map, normalized, rel, /* @__PURE__ */ new Date());
+		});
+	}
+	/**
 	* Append the observation-window anchor event; best-effort, never fails the
 	* observation.
 	*

package/lib/types/index.d.ts

@@ -17,6 +17,10 @@ export interface Config {
     /** Act only on sessions that carry the family's model tools (evolution-core's
      * per-session probe). The shipped bundles set it; false observes every session. */
     sessionScoped?: boolean;
+    /** Tool names whose dispatch reads one FILE (design §5.5). Demand for a
+     * support file is attributed from these; a deployment whose file tool has a
+     * different name configures it here instead of being mis-detected. */
+    supportReadToolNames?: string[];
 }
 export declare class SkillUsageRegistry extends Service {
     static inject: string[];
@@ -24,6 +28,7 @@ export declare class SkillUsageRegistry extends Service {
     readonly root: string;
     private readonly eventsHome;
     private readonly io;
+    private readonly supportReadToolNames;
     /** Process-local RMW queue (v34 B14 / v35 R6: the same factory the other sidecars use). */
     private readonly serial;
     constructor(ctx: Context, config?: Config);
@@ -40,6 +45,12 @@ export declare class SkillUsageRegistry extends Service {
      * that anchor exists (curator gates churn on `usageObserved()`).
      */
     private observeRead;
+    /**
+     * Demand telemetry (design §5.5): count one observed support-file read on an
+     * EXISTING record only — the same creation-free discipline as `observeRead`,
+     * so a read can never mint a usage record.
+     */
+    private recordSupportRead;
     /**
      * Append the observation-window anchor event; best-effort, never fails the
      * observation.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-skill-usage",
   "description": "Skill usage telemetry service (community build)",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,16 +27,16 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.4.1"
+    "@lmzhen/dsh-evolution-core": "^0.5.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@lmzhen/dsh-evolution-io": "^0.4.1"
+    "@lmzhen/dsh-evolution-io": "^0.5.0"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.4.1",
-    "@lmzhen/dsh-evolution-io": "^0.4.1"
+    "@lmzhen/dsh-evolution-core": "^0.5.0",
+    "@lmzhen/dsh-evolution-io": "^0.5.0"
   }
 }