@danypops/papyrus 0.59.2 → 0.59.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danypops/papyrus",
-  "version": "0.59.2",
+  "version": "0.59.3",
   "description": "Daemon-backed graph artifacts, evidence-bearing tasks, rules, skills, and native TUI workflows for Pi",
   "type": "module",
   "main": "./src/index.ts",
@@ -57,9 +57,9 @@
   },
   "files": ["src", "README.md"],
   "dependencies": {
-    "@danypops/vehicle-client": "^0.10.1",
+    "@danypops/vehicle-client": "^0.10.3",
     "@danypops/vehicle-core": "^0.17.1",
-    "@danypops/vehicle-server": "^0.24.5",
+    "@danypops/vehicle-server": "^0.25.2",
     "@stricli/core": "^1.3.0"
   }
 }

package/src/constants.ts

@@ -363,6 +363,12 @@ export function dbPath(): string {
 	return `${xdg}/papyrus/papyrus.db`;
 }
 
+/** $XDG_DATA_HOME/papyrus/metrics.sqlite -- vehicle-server's own tool/operation usage metrics store, sibling of dbPath() above. */
+export function metricsPath(): string {
+	const xdg = process.env.XDG_DATA_HOME || `${process.env.HOME}/.local/share`;
+	return `${xdg}/papyrus/metrics.sqlite`;
+}
+
 /**
  * The initial status a newly created artifact of a kind gets when no caller-supplied
  * status is given. This must be an explicit, named mapping — never derived from row order

package/src/daemon/daemon.ts

@@ -3,9 +3,12 @@ import { join } from "node:path";
 import { createNodeAtomicJsonFsAdapter } from "@danypops/vehicle-server/atomic-json";
 import { readLaunchProvenance } from "@danypops/vehicle-server/daemon";
 import { diagnoseDaemon, openDaemonLifecycleLog } from "@danypops/vehicle-server/daemon-lifecycle";
+import { openVehicleMetricsStore } from "@danypops/vehicle-server/metrics";
+import { createVehicleMetricsMiddleware } from "@danypops/vehicle-server/metrics-middleware";
+import { registerVehicleMetricsOperations } from "@danypops/vehicle-server/metrics-operations";
 import { acquireDaemonLock, releaseDaemonLock } from "@danypops/vehicle-server/paths";
 import { PushChannel } from "@danypops/vehicle-server/push-channel";
-import { DAEMON_HOST, DB_OPTIMIZE_INTERVAL_MS, dbPath, WAL_CHECKPOINT_INTERVAL_MS } from "../constants.ts";
+import { DAEMON_HOST, DB_OPTIMIZE_INTERVAL_MS, dbPath, metricsPath, WAL_CHECKPOINT_INTERVAL_MS } from "../constants.ts";
 import { logEvent, logger } from "../log/log.ts";
 import { createApp, createPapyrusService } from "../service.ts";
 import {
@@ -69,6 +72,14 @@ export async function serveMain(): Promise<void> {
 	const startedAt = new Date().toISOString();
 	const token = loadOrCreateToken(stateDir);
 	const service = createPapyrusService(dbPath());
+	// Records how often each real operation is invoked (server-side, every caller) plus, via
+	// metrics.recordClientEvent, client-observed Vehicle Shell meta-tool calls -- see
+	// @danypops/vehicle-server's own metrics README section. Wired directly onto the same registry
+	// every real papyrus operation is already registered on, so it's discoverable through the exact
+	// same tools_list/tools_man path as any other operation.
+	const vehicleMetrics = openVehicleMetricsStore(metricsPath());
+	service.vehicle.useExecutionMiddleware(createVehicleMetricsMiddleware(vehicleMetrics, "papyrus"));
+	registerVehicleMetricsOperations(service.vehicle, vehicleMetrics, "papyrus");
 	const pushChannel = new PushChannel({ token });
 	const app = createApp({
 		service,
@@ -106,6 +117,7 @@ export async function serveMain(): Promise<void> {
 	});
 	if (!server.port) {
 		service.close();
+		vehicleMetrics.close();
 		releaseDaemonLock(lockPath);
 		throw new Error("Papyrus daemon failed to bind a listener");
 	}
@@ -168,6 +180,7 @@ export async function serveMain(): Promise<void> {
 		}
 		releaseDaemonLock(lockPath);
 		service.close();
+		vehicleMetrics.close();
 		// .finally() re-throws rather than handling a rejection -- catching it first turns a bare
 		// unhandled-rejection warning into a real, queryable shutdown-failure log line.
 		void recordLifecycle("stopped", signal)