@danypops/papyrus 0.59.2 → 0.60.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danypops/papyrus",
-  "version": "0.59.2",
+  "version": "0.60.0",
   "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

@@ -93,7 +93,7 @@ export const RULE_TEXT_HARD_LIMIT_CHARACTERS = 4000;
 /** Compact task-context limits keep recurring prompt injection bounded. */
 export const TASK_CONTEXT_CURRENT_LIMIT = 3;
 export const TASK_CONTEXT_REJECTED_LIMIT = 3;
-export const TASK_WIDGET_OPEN_LIMIT = 3;
+export const TASK_WIDGET_OPEN_LIMIT = 9;
 export const TASK_DETAIL_MIN_VISIBLE_LINES = 8;
 /**
  * Event-triggered refresh (tool_execution_end, session_compact/tree) can't see a Task
@@ -103,6 +103,14 @@ export const TASK_DETAIL_MIN_VISIBLE_LINES = 8;
 export const TASK_WIDGET_POLL_INTERVAL_MS = 20_000;
 /** Same fallback purpose as TASK_WIDGET_POLL_INTERVAL_MS, for the Notes widget's own count. */
 export const NOTE_WIDGET_POLL_INTERVAL_MS = 20_000;
+/** Max note titles kept for the Notes widget card. */
+export const NOTE_WIDGET_OPEN_LIMIT = 8;
+/** Visible rows per page in the Notes card. */
+export const NOTE_WIDGET_VISIBLE_ROWS = 3;
+/** Visible rows per page in the Tasks card. */
+export const TASK_WIDGET_VISIBLE_ROWS = 3;
+/** How often a paging widget card advances to its next page. */
+export const WIDGET_CARD_ROTATION_INTERVAL_MS = 6_000;
 export const TASK_DETAIL_MAX_VISIBLE_LINES = 24;
 export const TASK_DETAIL_RESERVED_ROWS = 8;
 export const TASK_DETAIL_HORIZONTAL_PAN_COLUMNS = 4;
@@ -363,6 +371,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)