@devness/useai 0.4.27 → 0.5.0

package/dist/index.js

@@ -112,7 +112,7 @@ var VERSION;
 var init_version = __esm({
   "../shared/dist/constants/version.js"() {
     "use strict";
-    VERSION = "0.4.22";
+    VERSION = "0.5.0";
   }
 });
 
@@ -1263,9 +1263,9 @@ var init_tools = __esm({
     init_dist();
     USEAI_INSTRUCTIONS_TEXT = [
       "## UseAI Session Tracking",
-      "- At the START of every response, call `useai_start` with the appropriate task_type.",
+      "- At the START of every response, call `useai_start` with the appropriate task_type. Also generate a short session `title` (generic, no project names) and `private_title` (detailed, can include specifics) from the user's prompt.",
       "- For LONG sessions (15+ min), call `useai_heartbeat` periodically.",
-      "- At the END of every response, call `useai_end` with languages used, files_touched_count, and milestones (generic descriptions only \u2014 no project names, file paths, or company names)."
+      "- At the END of every response, call `useai_end` with languages used, files_touched_count, milestones (generic descriptions only \u2014 no project names, file paths, or company names), and an `evaluation` object honestly assessing: prompt_quality (1-5), context_provided (1-5), task_outcome, iteration_count, independence_level (1-5), scope_quality (1-5), tools_leveraged count."
     ].join("\n");
     MCP_HTTP_URL = DAEMON_MCP_URL;
     MCP_HTTP_ENTRY = { type: "http", url: MCP_HTTP_URL };
@@ -1584,6 +1584,9 @@ var init_session_state = __esm({
       sessionRecordCount;
       clientName;
       sessionTaskType;
+      sessionTitle;
+      sessionPrivateTitle;
+      sessionPromptWordCount;
       project;
       chainTipHash;
       signingKey;
@@ -1595,6 +1598,9 @@ var init_session_state = __esm({
         this.sessionRecordCount = 0;
         this.clientName = "unknown";
         this.sessionTaskType = "coding";
+        this.sessionTitle = null;
+        this.sessionPrivateTitle = null;
+        this.sessionPromptWordCount = null;
         this.project = null;
         this.chainTipHash = GENESIS_HASH;
         this.signingKey = null;
@@ -1607,6 +1613,9 @@ var init_session_state = __esm({
         this.sessionRecordCount = 0;
         this.chainTipHash = GENESIS_HASH;
         this.sessionTaskType = "coding";
+        this.sessionTitle = null;
+        this.sessionPrivateTitle = null;
+        this.sessionPromptWordCount = null;
         this.detectProject();
       }
       detectProject() {
@@ -1618,6 +1627,15 @@ var init_session_state = __esm({
       setTaskType(type) {
         this.sessionTaskType = type;
       }
+      setTitle(title) {
+        this.sessionTitle = title;
+      }
+      setPrivateTitle(title) {
+        this.sessionPrivateTitle = title;
+      }
+      setPromptWordCount(count) {
+        this.sessionPromptWordCount = count;
+      }
       incrementHeartbeat() {
         this.heartbeatCount++;
       }
@@ -1691,20 +1709,27 @@ function resolveClient(server2, session2) {
 function registerTools(server2, session2) {
   server2.tool(
     "useai_start",
-    "Start tracking an AI coding session. Call this at the beginning of every response.",
+    `Start tracking an AI coding session. Call this at the beginning of every response. Generate a session title from the user's prompt: a generic public "title" (no project/file names) and a detailed "private_title" (can include specifics).`,
     {
-      task_type: z2.enum(["coding", "debugging", "testing", "planning", "reviewing", "documenting", "learning", "other"]).optional().describe("What kind of task is the developer working on?")
+      task_type: z2.enum(["coding", "debugging", "testing", "planning", "reviewing", "documenting", "learning", "other"]).optional().describe("What kind of task is the developer working on?"),
+      title: z2.string().optional().describe(`Short public session title derived from the user's prompt. No project names, file paths, or identifying details. Example: "Fix authentication bug"`),
+      private_title: z2.string().optional().describe('Detailed session title for private records. Can include project names and specifics. Example: "Fix JWT refresh in UseAI login flow"')
     },
-    async ({ task_type }) => {
+    async ({ task_type, title, private_title }) => {
       session2.reset();
       resolveClient(server2, session2);
       session2.setTaskType(task_type ?? "coding");
-      const record = session2.appendToChain("session_start", {
+      session2.setTitle(title ?? null);
+      session2.setPrivateTitle(private_title ?? null);
+      const chainData = {
         client: session2.clientName,
         task_type: session2.sessionTaskType,
         project: session2.project,
         version: VERSION
-      });
+      };
+      if (title) chainData.title = title;
+      if (private_title) chainData.private_title = private_title;
+      const record = session2.appendToChain("session_start", chainData);
       return {
         content: [
           {
@@ -1737,7 +1762,7 @@ function registerTools(server2, session2) {
   );
   server2.tool(
     "useai_end",
-    `End the current AI coding session and record milestones. Each milestone needs TWO titles: (1) a generic public "title" safe for public display (NEVER include project names, file names, class names, or any identifying details), and (2) an optional detailed "private_title" for the user's own records that CAN include project names, file names, and specific details. GOOD title: "Implemented user authentication". GOOD private_title: "Added JWT auth to UseAI API server". BAD title: "Fixed bug in Acme auth service".`,
+    'End the current AI coding session and record milestones. Each milestone needs TWO titles: (1) a generic public "title" safe for public display (NEVER include project names, file names, class names, or any identifying details), and (2) an optional detailed "private_title" for the user\'s own records that CAN include project names, file names, and specific details. GOOD title: "Implemented user authentication". GOOD private_title: "Added JWT auth to UseAI API server". BAD title: "Fixed bug in Acme auth service". Also provide an `evaluation` object assessing the session: prompt_quality (1-5), context_provided (1-5), task_outcome (completed/partial/abandoned/blocked), iteration_count, independence_level (1-5), scope_quality (1-5), and tools_leveraged count. Score honestly based on the actual interaction.',
     {
       task_type: z2.enum(["coding", "debugging", "testing", "planning", "reviewing", "documenting", "learning", "other"]).optional().describe("What kind of task was the developer working on?"),
       languages: z2.array(z2.string()).optional().describe("Programming languages used (e.g. ['typescript', 'python'])"),
@@ -1747,9 +1772,18 @@ function registerTools(server2, session2) {
         private_title: z2.string().optional().describe("Detailed description for the user's private records. CAN include project names, file names, and specific details. Example: 'Added private/public milestone support to UseAI MCP server'"),
         category: z2.enum(["feature", "bugfix", "refactor", "test", "docs", "setup", "deployment", "other"]).describe("Type of work completed"),
         complexity: z2.enum(["simple", "medium", "complex"]).optional().describe("How complex was this task?")
-      })).optional().describe("What was accomplished this session? List each distinct piece of work completed. Provide both a generic public title and an optional detailed private_title.")
+      })).optional().describe("What was accomplished this session? List each distinct piece of work completed. Provide both a generic public title and an optional detailed private_title."),
+      evaluation: z2.object({
+        prompt_quality: z2.number().min(1).max(5).describe("How clear, specific, and complete was the initial prompt? 1=vague/ambiguous, 5=crystal clear with acceptance criteria"),
+        context_provided: z2.number().min(1).max(5).describe("Did the user provide relevant context (files, errors, constraints)? 1=no context, 5=comprehensive context"),
+        task_outcome: z2.enum(["completed", "partial", "abandoned", "blocked"]).describe("Was the primary task achieved?"),
+        iteration_count: z2.number().min(1).describe("Number of user-to-AI turns in this session"),
+        independence_level: z2.number().min(1).max(5).describe("How self-directed was the user? 1=needed constant guidance, 5=gave clear spec and let AI execute"),
+        scope_quality: z2.number().min(1).max(5).describe("Was the task well-scoped? 1=vague or impossibly broad, 5=precise and achievable"),
+        tools_leveraged: z2.number().min(0).describe("Count of distinct AI capabilities used (code gen, debugging, refactoring, testing, docs, etc.)")
+      }).optional().describe("AI-assessed evaluation of this session. Score honestly based on the actual interaction.")
     },
-    async ({ task_type, languages, files_touched_count, milestones: milestonesInput }) => {
+    async ({ task_type, languages, files_touched_count, milestones: milestonesInput, evaluation }) => {
       const duration = session2.getSessionDuration();
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const finalTaskType = task_type ?? session2.sessionTaskType;
@@ -1759,7 +1793,8 @@ function registerTools(server2, session2) {
         task_type: finalTaskType,
         languages: languages ?? [],
         files_touched: files_touched_count ?? 0,
-        heartbeat_count: session2.heartbeatCount
+        heartbeat_count: session2.heartbeatCount,
+        ...evaluation ? { evaluation } : {}
       });
       const sealData = JSON.stringify({
         session_id: session2.sessionId,
@@ -1768,6 +1803,10 @@ function registerTools(server2, session2) {
         languages: languages ?? [],
         files_touched: files_touched_count ?? 0,
         project: session2.project,
+        title: session2.sessionTitle ?? void 0,
+        private_title: session2.sessionPrivateTitle ?? void 0,
+        prompt_word_count: session2.sessionPromptWordCount ?? void 0,
+        evaluation: evaluation ?? void 0,
         started_at: new Date(session2.sessionStartTime).toISOString(),
         ended_at: now,
         duration_seconds: duration,
@@ -1798,6 +1837,10 @@ function registerTools(server2, session2) {
         languages: languages ?? [],
         files_touched: files_touched_count ?? 0,
         project: session2.project ?? void 0,
+        title: session2.sessionTitle ?? void 0,
+        private_title: session2.sessionPrivateTitle ?? void 0,
+        prompt_word_count: session2.sessionPromptWordCount ?? void 0,
+        evaluation: evaluation ?? void 0,
         started_at: new Date(session2.sessionStartTime).toISOString(),
         ended_at: now,
         duration_seconds: duration,
@@ -1850,11 +1893,12 @@ function registerTools(server2, session2) {
       const durationStr = formatDuration(duration);
       const langStr = languages && languages.length > 0 ? ` using ${languages.join(", ")}` : "";
       const milestoneStr = milestoneCount > 0 ? ` \xB7 ${milestoneCount} milestone${milestoneCount > 1 ? "s" : ""} recorded` : "";
+      const evalStr = evaluation ? ` \xB7 eval: ${evaluation.task_outcome} (prompt: ${evaluation.prompt_quality}/5)` : "";
       return {
         content: [
           {
             type: "text",
-            text: `Session ended: ${durationStr} ${finalTaskType}${langStr}${milestoneStr}`
+            text: `Session ended: ${durationStr} ${finalTaskType}${langStr}${milestoneStr}${evalStr}`
           }
         ]
       };
@@ -1945,6 +1989,16 @@ function readBody(req) {
     req.on("error", reject);
   });
 }
+function deduplicateSessions(sessions2) {
+  const map = /* @__PURE__ */ new Map();
+  for (const s of sessions2) {
+    const existing = map.get(s.session_id);
+    if (!existing || s.duration_seconds > existing.duration_seconds) {
+      map.set(s.session_id, s);
+    }
+  }
+  return [...map.values()];
+}
 function calculateStreak(sessions2) {
   if (sessions2.length === 0) return 0;
   const days = /* @__PURE__ */ new Set();
@@ -1971,7 +2025,7 @@ function calculateStreak(sessions2) {
 }
 function handleLocalSessions(_req, res) {
   try {
-    const sessions2 = readJson(SESSIONS_FILE, []);
+    const sessions2 = deduplicateSessions(readJson(SESSIONS_FILE, []));
     json(res, 200, sessions2);
   } catch (err) {
     json(res, 500, { error: err.message });
@@ -1979,7 +2033,7 @@ function handleLocalSessions(_req, res) {
 }
 function handleLocalStats(_req, res) {
   try {
-    const sessions2 = readJson(SESSIONS_FILE, []);
+    const sessions2 = deduplicateSessions(readJson(SESSIONS_FILE, []));
     let totalSeconds = 0;
     let filesTouched = 0;
     const byClient = {};
@@ -2050,7 +2104,7 @@ async function handleLocalSync(req, res) {
       "Content-Type": "application/json",
       "Authorization": `Bearer ${token}`
     };
-    const sessions2 = readJson(SESSIONS_FILE, []);
+    const sessions2 = deduplicateSessions(readJson(SESSIONS_FILE, []));
     const sessionsRes = await fetch("https://api.useai.dev/api/sync", {
       method: "POST",
       headers,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devness/useai",
-  "version": "0.4.27",
+  "version": "0.5.0",
   "description": "Track your AI-assisted development workflow. MCP server that records usage metrics across all your AI tools.",
   "keywords": [
     "mcp",
@@ -39,6 +39,7 @@
     "@types/node": "^22.13.4",
     "tsup": "^8.0.0",
     "typescript": "^5.7.3",
+    "vitest": "^4.0.18",
     "@useai/shared": "0.3.0"
   },
   "repository": {
@@ -54,6 +55,8 @@
     "dev": "tsc --watch",
     "daemon": "pnpm run build && node dist/index.js daemon --port 19201",
     "bundle": "tsup src/index.ts --format esm --target node18 --no-splitting",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   }