@lmzhen/dsh-skill-usage 0.1.0-rc.4 → 0.1.0-rc.41

package/lib/index.js

@@ -1,6 +1,6 @@
 import { Service } from "@deepseek-ai/cordis";
 import z from "@deepseek-ai/schemastery";
-import { bumpPatch, bumpUse, bumpView, evolutionIoAdapter, loadUsage, saveUsage, skillsRoot } from "@lmzhen/dsh-evolution-core";
+import { bumpPatch, bumpUse, bumpView, evolutionIoAdapter, loadUsage, markAgentCreated, saveUsage, skillsRoot } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Skill usage telemetry service for the evolution family.
@@ -15,7 +15,7 @@ var SkillUsageRegistry = class extends Service {
 	chain = Promise.resolve();
 	constructor(ctx, config = {}) {
 		super(ctx, "skillUsage");
-		this.root = config.root ?? skillsRoot();
+		this.root = config.root || skillsRoot();
 		this.io = evolutionIoAdapter(() => ctx.evolutionIo.provider());
 	}
 	async map() {
@@ -44,11 +44,34 @@ var SkillUsageRegistry = class extends Service {
 	}
 	async markAgentCreated(name) {
 		await this.mutate(async (map) => {
-			const { markAgentCreated } = await import("@lmzhen/dsh-evolution-core");
 			markAgentCreated(map, name);
 			await this.flush();
 		});
 	}
+	/**
+	* Mark a skill's usage record as archived (delete / curator archive paths).
+	* Unlike `record('patch')` this never bumps the patch counter — archiving is
+	* a state transition, not a content mutation.
+	*/
+	async markArchived(name, at = /* @__PURE__ */ new Date()) {
+		await this.mutate(async (map) => {
+			const record = map.get(name);
+			if (record) {
+				record.state = "archived";
+				record.archived_at = at.toISOString();
+			}
+			await this.flush();
+		});
+	}
+	/**
+	* Drop the in-memory cache once queued work drains, so the next `map()` reads
+	* the file again. The curator writes the sidecar directly; without this, the
+	* next tool telemetry flush would re-cover its quality/state/pinned writes.
+	*/
+	async invalidate() {
+		await this.chain;
+		this.usage = null;
+	}
 	/** Write feedback-derived quality onto the usage sidecar; curator reads it. */
 	async setQuality(name, score, warn) {
 		await this.mutate(async (map) => {

package/lib/types/index.d.ts

@@ -28,6 +28,18 @@ export declare class SkillUsageRegistry extends Service {
     record(name: string, kind: 'use' | 'view' | 'patch', at?: Date): Promise<void>;
     report(): Promise<UsageMap>;
     markAgentCreated(name: string): Promise<void>;
+    /**
+     * Mark a skill's usage record as archived (delete / curator archive paths).
+     * Unlike `record('patch')` this never bumps the patch counter — archiving is
+     * a state transition, not a content mutation.
+     */
+    markArchived(name: string, at?: Date): Promise<void>;
+    /**
+     * Drop the in-memory cache once queued work drains, so the next `map()` reads
+     * the file again. The curator writes the sidecar directly; without this, the
+     * next tool telemetry flush would re-cover its quality/state/pinned writes.
+     */
+    invalidate(): Promise<void>;
     /** Write feedback-derived quality onto the usage sidecar; curator reads it. */
     setQuality(name: string, score: number, warn: boolean): Promise<void>;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-skill-usage",
   "description": "Skill usage telemetry service (community build)",
-  "version": "0.1.0-rc.4",
+  "version": "0.1.0-rc.41",
   "publishConfig": {
     "access": "public"
   },
@@ -33,16 +33,16 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.4"
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.41"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
-    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.4"
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.41"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
-    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.4",
-    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.4"
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.41",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.41"
   }
 }