ai-gains 1.3.1 → 1.3.3

package/README.md

@@ -5,7 +5,7 @@ Track the time you save using AI in your development workflow. AI Gains automati
 ## How it works
 
 1. **Hooks** record each Claude Code session — start time, author, end time
-2. **A skill** prompts Claude to log achievements and estimate how long the work would have taken without AI
+2. **A skill** reminds you to log achievements at natural stopping points; run `/ai-gains` whenever you want to capture what was done and estimate how long it would have taken without AI
 3. **A dashboard** visualises sessions, time saved, and speedup across your project
 
 ## Setup
@@ -32,17 +32,15 @@ To use a different port:
 PORT=4000 npx ai-gains
 ```
 
-## Logging a session
+## Logging achievements
 
-At the end of a Claude Code session, run:
+After completing a meaningful piece of work — a feature, a bug fix, a refactor — run:
 
 ```
 /ai-gains
 ```
 
-Claude will reflect on the work done, estimate how long it would have taken a human, and write the session log to `.ai-gains/`.
-
-You can also run `/ai-gains` mid-session to log a checkpoint.
+Claude will reflect on what was done, estimate how long it would have taken a human, and write the achievement to the session log. Run it as many times as you like within a session to capture checkpoints, or once at the end to log everything in one go. The hooks handle start and end time automatically — `/ai-gains` is purely for recording what was accomplished.
 
 ## Dashboard features
 
@@ -74,7 +72,7 @@ Each session file (`.ai-gains/<session-id>.json`) contains:
 
 ## Committing session logs
 
-Add `.ai-gains/` to your repository to share gains across your team. Each file is named by session ID so concurrent sessions never conflict.
+Add `.ai-gains/` to your repository to share gains across your team. Each file is named `<timestamp>_<session-id>.json` so files sort chronologically and concurrent sessions never conflict.
 
 ## Requirements
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-gains",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "Interactive browser dashboard for AI development session tracking",
   "main": "src/server.js",
   "bin": {

package/src/dashboard.html

@@ -703,7 +703,7 @@
       const branchPill = s.branch ? `<span class="pill branch">⎇ ${esc(s.branch)}</span>` : '';
 
       return `
-        <div class="session-card" onclick="showSession('${esc(s.uuid)}')">
+        <div class="session-card" onclick="showSession('${esc(s.uuid || s.session_id)}')">
           <div class="session-icon">⚡</div>
           <div class="session-body">
             <div class="session-top">
@@ -725,7 +725,7 @@
   // ── Session detail ──────────────────────────────────────────────────────────
 
   function showSession(uuid) {
-    const s  = sessions.find(x => x.uuid === uuid);
+    const s  = sessions.find(x => (x.uuid || x.session_id) === uuid);
     if (!s) return;
     const sp = speedup(s);
     const ht = humanTime(s);
@@ -750,7 +750,7 @@
     const authorStat = s.author ? `
         <div class="detail-stat">
           <div class="detail-stat-label">Author</div>
-          <div class="detail-stat-value" style="font-size:13px;font-weight:500;color:var(--muted)">${esc(s.author)}</div>
+          <div class="detail-stat-value" style="font-size:13px;font-weight:500;color:var(--muted);word-break:break-all;overflow-wrap:anywhere">${esc(s.author)}</div>
         </div>` : '';
     const branchStat = s.branch ? `
         <div class="detail-stat">
@@ -761,7 +761,7 @@
 
     document.getElementById('detail-content').innerHTML = `
       <div class="detail-title">${esc(fmtDate(s.start_time))}</div>
-      <div class="detail-uuid">${esc(s.uuid)}</div>
+      <div class="detail-uuid">${esc(s.uuid || s.session_id)}</div>
 
       <div class="detail-stats">
         <div class="detail-stat">