heyiam 0.2.26 → 0.2.28

package/dist/archive.js

@@ -46,13 +46,13 @@ export async function archiveSessionFiles(sessions, configDir) {
  * Preserves the relative structure under the project directory.
  *
  * Claude:  ~/.claude/projects/{projectDir}/{sessionId}.jsonl
- *       →  ~/.config/heyiam/sessions/{projectDir}/{sessionId}.jsonl
+ *       →  ~/.local/share/heyiam/sessions/{projectDir}/{sessionId}.jsonl
  *
  * Codex:   ~/.codex/sessions/{nested}/{rollout-xxx}.jsonl
- *       →  ~/.config/heyiam/sessions/{projectDir}/{rollout-xxx}.jsonl
+ *       →  ~/.local/share/heyiam/sessions/{projectDir}/{rollout-xxx}.jsonl
  *
  * Gemini:  ~/.gemini/tmp/{hash}/logs.json
- *       →  ~/.config/heyiam/sessions/{projectDir}/{hash}.json
+ *       →  ~/.local/share/heyiam/sessions/{projectDir}/{hash}.json
  */
 function archiveDestination(originalPath, archiveBase, projectDir) {
     // Claude: find the project dir in the path and take everything after it

package/dist/daemon-install.js

@@ -1,7 +1,7 @@
 // Download and install the heyiam tray daemon binary from GitHub releases.
 //
 // Detects platform + arch, fetches the correct binary from the latest
-// daemon release, and saves it to ~/.config/heyiam/daemon/heyiam-tray.
+// daemon release, and saves it to ~/.local/share/heyiam/daemon/heyiam-tray.
 import { createWriteStream, mkdirSync, chmodSync, existsSync, renameSync, unlinkSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
@@ -30,7 +30,7 @@ export function getAssetName() {
  * Returns the directory where the daemon binary is stored.
  */
 export function getDaemonDir() {
-    return join(homedir(), '.config', 'heyiam', 'daemon');
+    return join(homedir(), '.local', 'share', 'heyiam', 'daemon');
 }
 /**
  * Returns the full path to the daemon binary.

package/dist/db.js

@@ -6,14 +6,13 @@ import { mkdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 // ── Constants ────────────────────────────────────────────────
-function getConfigDir() {
-    return process.env.HEYIAM_CONFIG_DIR || join(homedir(), '.config', 'heyiam');
+function getDataDir() {
+    return process.env.HEYIAM_DATA_DIR || join(homedir(), '.local', 'share', 'heyiam');
 }
 export function getDbPath() {
-    return join(getConfigDir(), 'sessions.db');
+    return join(getDataDir(), 'sessions.db');
 }
-// Keep backward-compat for any external consumers
-export const DB_PATH = join(homedir(), '.config', 'heyiam', 'sessions.db');
+export const DB_PATH = join(homedir(), '.local', 'share', 'heyiam', 'sessions.db');
 const CURRENT_SCHEMA_VERSION = 5;
 // ── Singleton ────────────────────────────────────────────────
 let _db = null;

package/dist/demo-seed.js

@@ -1,14 +1,14 @@
 /**
  * Seeds a demo environment with fake data for marketing recordings.
  *
- * Creates a self-contained directory at ~/.config/heyiam/demo/ with:
+ * Creates a self-contained directory at ~/.local/share/heyiam/demo/ with:
  *   - sessions.db       — SQLite database with fake sessions + FTS
  *   - enhanced/          — fake enhanced data for select sessions
  *   - project-enhance/   — cached project narrative
  *   - settings.json      — onboarding complete, fake API key
  *   - sessions/          — minimal JSONL session files
  *
- * The real ~/.config/heyiam/ is never touched.
+ * The real ~/.local/share/heyiam/ is never touched.
  */
 import { join } from 'node:path';
 import { homedir } from 'node:os';
@@ -16,7 +16,7 @@ import { mkdirSync, writeFileSync, existsSync, rmSync } from 'node:fs';
 import { createHash } from 'node:crypto';
 import { openDatabase } from './db.js';
 import { DEMO_PROJECTS, DEMO_SESSIONS, DEMO_TRANSCRIPT, DEMO_ENHANCE_RESULT, } from './demo-data.js';
-const DEMO_DIR = join(homedir(), '.config', 'heyiam', 'demo');
+const DEMO_DIR = join(homedir(), '.local', 'share', 'heyiam', 'demo');
 /**
  * Seed the demo environment. Returns the path so the caller can set
  * HEYIAM_CONFIG_DIR before starting the server.

package/dist/export.js

@@ -90,14 +90,14 @@ function writeAndTrack(filePath, content, files) {
     return statSync(filePath).size;
 }
 // ── Markdown Export ────────────────────────────────────────────
-export async function exportMarkdown(dirName, cache, sessions, outputPath) {
+export async function exportMarkdown(dirName, cache, sessions, outputPath, opts) {
     const files = [];
     let totalBytes = 0;
     mkdirSync(outputPath, { recursive: true });
     const { result } = cache;
     const title = cache.title ?? displayNameFromDir(dirName);
     // README.md — project narrative
-    const readme = buildReadme(title, result, sessions);
+    const readme = buildReadme(title, result, sessions, opts?.totalFilesChanged);
     totalBytes += writeAndTrack(join(outputPath, 'README.md'), readme, files);
     // sessions/*.md — per-session breakdowns
     const sessionsDir = join(outputPath, 'sessions');
@@ -113,7 +113,7 @@ export async function exportMarkdown(dirName, cache, sessions, outputPath) {
     totalBytes += writeAndTrack(join(outputPath, 'project.json'), projectJson, files);
     return { files, totalBytes, outputPath };
 }
-function buildReadme(title, result, sessions) {
+function buildReadme(title, result, sessions, totalFilesChanged) {
     const lines = [];
     lines.push(`# ${title}\n`);
     lines.push(result.narrative);
@@ -146,7 +146,7 @@ function buildReadme(title, result, sessions) {
     lines.push(`- Sessions: ${sessions.length}`);
     const totalLoc = sessions.reduce((sum, s) => sum + s.linesOfCode, 0);
     const totalMin = computeMergedSessionDuration(sessions);
-    const totalFiles = sessions.reduce((sum, s) => sum + s.filesChanged.length, 0);
+    const totalFiles = totalFilesChanged ?? new Set(sessions.flatMap(s => s.filesChanged.map(f => f.path))).size;
     lines.push(`- Lines of code: ${totalLoc.toLocaleString()}`);
     lines.push(`- Total time: ${(totalMin / 60).toFixed(1)}h`);
     lines.push(`- Files changed: ${totalFiles}`);
@@ -223,7 +223,7 @@ export async function exportHtml(dirName, cache, sessions, outputPath, username
     // Compute stats the same way the dashboard does
     const totalLoc = sessions.reduce((sum, s) => sum + s.linesOfCode, 0);
     const totalDurationMinutes = computeMergedSessionDuration(sessions);
-    const totalFilesChanged = opts?.totalFilesChanged ?? sessions.reduce((sum, s) => sum + s.filesChanged.length, 0);
+    const totalFilesChanged = opts?.totalFilesChanged ?? new Set(sessions.flatMap(s => s.filesChanged.map(f => f.path))).size;
     // Agent duration: sum child durations across all orchestrated sessions
     const totalAgentMinutes = sessions
         .filter((s) => s.isOrchestrated && s.children)
@@ -317,7 +317,7 @@ function buildProjectRenderInputs(dirName, cache, sessions, username, opts) {
     }));
     const totalLoc = sessions.reduce((sum, s) => sum + s.linesOfCode, 0);
     const totalDurationMinutes = computeMergedSessionDuration(sessions);
-    const totalFilesChanged = opts?.totalFilesChanged ?? sessions.reduce((sum, s) => sum + s.filesChanged.length, 0);
+    const totalFilesChanged = opts?.totalFilesChanged ?? new Set(sessions.flatMap(s => s.filesChanged.map(f => f.path))).size;
     const totalAgentMinutes = sessions
         .filter((s) => s.isOrchestrated && s.children)
         .reduce((sum, s) => sum + s.children.reduce((cs, c) => cs + c.durationMinutes, 0), 0);

package/dist/index.js

@@ -435,7 +435,7 @@ program
     const { existsSync, readFileSync } = await import('node:fs');
     const { join } = await import('node:path');
     const { homedir } = await import('node:os');
-    const pidFile = join(homedir(), '.config', 'heyiam', 'daemon', 'daemon.pid');
+    const pidFile = join(homedir(), '.local', 'share', 'heyiam', 'daemon', 'daemon.pid');
     let daemonRunning = false;
     if (existsSync(pidFile)) {
         const pid = parseInt(readFileSync(pidFile, 'utf-8').trim(), 10);
@@ -446,7 +446,7 @@ program
         catch { /* not running */ }
     }
     // Status file
-    const statusFile = join(homedir(), '.config', 'heyiam', 'daemon', 'status.json');
+    const statusFile = join(homedir(), '.local', 'share', 'heyiam', 'daemon', 'status.json');
     let lastSync = 'never';
     if (existsSync(statusFile)) {
         try {
@@ -489,7 +489,7 @@ daemon
     const { homedir } = await import('node:os');
     const { spawn } = await import('node:child_process');
     const { writeFileSync, mkdirSync } = await import('node:fs');
-    const daemonDir = join(homedir(), '.config', 'heyiam', 'daemon');
+    const daemonDir = join(homedir(), '.local', 'share', 'heyiam', 'daemon');
     const binaryPath = join(daemonDir, 'heyiam-tray');
     const pidFile = join(daemonDir, 'daemon.pid');
     if (!existsSync(binaryPath)) {
@@ -522,7 +522,7 @@ daemon
     const { existsSync, readFileSync, unlinkSync } = await import('node:fs');
     const { join } = await import('node:path');
     const { homedir } = await import('node:os');
-    const pidFile = join(homedir(), '.config', 'heyiam', 'daemon', 'daemon.pid');
+    const pidFile = join(homedir(), '.local', 'share', 'heyiam', 'daemon', 'daemon.pid');
     if (!existsSync(pidFile)) {
         console.log('\n  Daemon is not running.\n');
         return;
@@ -545,7 +545,7 @@ daemon
     const { existsSync, readFileSync } = await import('node:fs');
     const { join } = await import('node:path');
     const { homedir } = await import('node:os');
-    const daemonDir = join(homedir(), '.config', 'heyiam', 'daemon');
+    const daemonDir = join(homedir(), '.local', 'share', 'heyiam', 'daemon');
     const pidFile = join(daemonDir, 'daemon.pid');
     const statusFile = join(daemonDir, 'status.json');
     const binaryPath = join(daemonDir, 'heyiam-tray');
@@ -629,7 +629,7 @@ daemon
     const { join } = await import('node:path');
     const { homedir } = await import('node:os');
     // Stop first
-    const pidFile = join(homedir(), '.config', 'heyiam', 'daemon', 'daemon.pid');
+    const pidFile = join(homedir(), '.local', 'share', 'heyiam', 'daemon', 'daemon.pid');
     if (existsSync(pidFile)) {
         const pid = parseInt((await import('node:fs')).readFileSync(pidFile, 'utf-8').trim(), 10);
         try {
@@ -639,7 +639,7 @@ daemon
         unlinkSync(pidFile);
     }
     // Remove binary
-    const binaryPath = join(homedir(), '.config', 'heyiam', 'daemon', 'heyiam-tray');
+    const binaryPath = join(homedir(), '.local', 'share', 'heyiam', 'daemon', 'heyiam-tray');
     if (existsSync(binaryPath))
         unlinkSync(binaryPath);
     // Remove auto-start registration (macOS launchd, Linux XDG)

package/dist/routes/context.js

@@ -212,7 +212,7 @@ export function createRouteContext(sessionsBasePath, dbPath) {
         if (!basePath) {
             const archiveResult = await archiveSessionFiles(allSessions);
             if (archiveResult.archived > 0) {
-                console.log(`Preserved ${archiveResult.archived} sessions → ~/.config/heyiam/sessions/`);
+                console.log(`Preserved ${archiveResult.archived} sessions → ~/.local/share/heyiam/sessions/`);
             }
         }
         const byDir = new Map();
@@ -427,7 +427,7 @@ export function createRouteContext(sessionsBasePath, dbPath) {
         const parentMetas = proj.sessions.filter(s => !s.isSubagent);
         const allStats = await Promise.all(parentMetas.map((m) => getSessionStats(m, proj.name)));
         const totalLoc = allStats.reduce((s, st) => s + st.loc, 0);
-        const totalFiles = allStats.reduce((s, st) => s + st.files, 0);
+        const totalFiles = db.prepare('SELECT COUNT(DISTINCT file_path) as c FROM session_files WHERE session_id IN (SELECT id FROM sessions WHERE project_dir = ?)').get(proj.dirName)?.c ?? allStats.reduce((s, st) => s + st.files, 0);
         const naiveDuration = allStats.reduce((s, st) => s + st.duration, 0);
         const totalDuration = computeMergedDurationFromDb(db, proj.dirName, naiveDuration);
         let totalAgentDuration = totalDuration;

package/dist/routes/dashboard.js

@@ -15,7 +15,7 @@ export function createDashboardRouter(ctx) {
             const sync = getSyncState();
             // Count enhanced projects by checking the enhance cache directory
             let enhancedCount = 0;
-            const enhanceDir = join(homedir(), '.config', 'heyiam', 'project-enhance');
+            const enhanceDir = join(homedir(), '.local', 'share', 'heyiam', 'project-enhance');
             try {
                 const files = readdirSync(enhanceDir).filter((f) => f.endsWith('.json'));
                 enhancedCount = files.length;

package/dist/routes/export.js

@@ -4,7 +4,7 @@ import fs from 'node:fs';
 import { execFileSync } from 'node:child_process';
 import { exportMarkdown, exportHtml, generateHtmlFiles, createZipBuffer } from '../export.js';
 import { buildProjectDetail } from './context.js';
-const EXPORTS_BASE = path.resolve(process.env.HOME || '~', '.config', 'heyiam', 'exports');
+const EXPORTS_BASE = path.resolve(process.env.HOME || '~', '.local', 'share', 'heyiam', 'exports');
 /** Validate that an output path is within the safe exports directory. */
 function safeExportPath(outputPath, dirName, format) {
     const defaultPath = path.join(EXPORTS_BASE, dirName, format);
@@ -71,8 +71,9 @@ export function createExportRouter(ctx) {
                 return;
             }
             const cache = data.enhanceCache ?? buildFallbackCache(data.sessions);
+            const totalFilesChanged = data.project.totalFiles;
             const outputPath = path.join(EXPORTS_BASE, dirName, 'markdown');
-            const result = await exportMarkdown(dirName, cache, data.sessions, outputPath);
+            const result = await exportMarkdown(dirName, cache, data.sessions, outputPath, { totalFilesChanged });
             res.json(result);
         }
         catch (err) {
@@ -90,8 +91,9 @@ export function createExportRouter(ctx) {
                 return;
             }
             const cache = data.enhanceCache ?? buildFallbackCache(data.sessions);
+            const totalFilesChanged = data.project.totalFiles;
             const outDir = safeExportPath(outputPath, dirName, 'markdown');
-            const result = await exportMarkdown(dirName, cache, data.sessions, outDir);
+            const result = await exportMarkdown(dirName, cache, data.sessions, outDir, { totalFilesChanged });
             res.json(result);
         }
         catch (err) {
@@ -153,9 +155,10 @@ export function createExportRouter(ctx) {
                 return;
             }
             const cache = data.enhanceCache ?? buildFallbackCache(data.sessions);
+            const totalFilesChanged = data.project.totalFiles;
             // Re-use exportMarkdown to a temp dir, then zip the result
             const tmpDir = path.join(EXPORTS_BASE, '.tmp', `${dirName}-${Date.now()}`);
-            const result = await exportMarkdown(dirName, cache, data.sessions, tmpDir);
+            const result = await exportMarkdown(dirName, cache, data.sessions, tmpDir, { totalFilesChanged });
             // Read files into memory and zip
             const entries = result.files.map((filePath) => ({
                 path: path.relative(tmpDir, filePath),

package/dist/screenshot.js

@@ -3,7 +3,7 @@ import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir, platform } from 'node:os';
 import { get as httpGet } from 'node:http';
-export const SCREENSHOTS_DIR = join(homedir(), '.config', 'heyiam', 'screenshots');
+export const SCREENSHOTS_DIR = join(homedir(), '.local', 'share', 'heyiam', 'screenshots');
 /** Known Chrome binary paths by platform */
 const CHROME_PATHS = {
     darwin: [

package/dist/settings.js

@@ -6,12 +6,16 @@ import { readConfig, writeConfig } from './auth.js';
 function getConfigDir() {
     return process.env.HEYIAM_CONFIG_DIR || join(homedir(), '.config', 'heyiam');
 }
+/** XDG data directory — DB, enhanced data, archives, screenshots, published state. */
+export function getDataDir() {
+    return process.env.HEYIAM_DATA_DIR || join(homedir(), '.local', 'share', 'heyiam');
+}
 const ENHANCED_DIR = 'enhanced';
 const PROJECT_ENHANCE_DIR = 'project-enhance';
 const SETTINGS_FILE = 'settings.json';
 const SESSIONS_DIR = 'sessions';
 /** Directory where archived session hard links are stored. */
-export function getArchiveDir(configDir = getConfigDir()) {
+export function getArchiveDir(configDir = getDataDir()) {
     return join(configDir, SESSIONS_DIR);
 }
 export function isArchiveEnabled(configDir) {
@@ -50,10 +54,10 @@ export function resetOnboarding(configDir) {
 export function getAnthropicApiKey(configDir) {
     return process.env.ANTHROPIC_API_KEY || getSettings(configDir).anthropicApiKey || undefined;
 }
-function enhancedDir(configDir = getConfigDir()) {
+function enhancedDir(configDir = getDataDir()) {
     return join(configDir, ENHANCED_DIR);
 }
-function enhancedPath(sessionId, configDir = getConfigDir()) {
+function enhancedPath(sessionId, configDir = getDataDir()) {
     return join(enhancedDir(configDir), `${sessionId}.json`);
 }
 export function saveEnhancedData(sessionId, data, configDir) {
@@ -103,10 +107,10 @@ export function buildProjectFingerprint(selectedSessionIds, configDir) {
     });
     return createHash('sha256').update(parts.join('|')).digest('hex').slice(0, 16);
 }
-function projectEnhanceDir(configDir = getConfigDir()) {
+function projectEnhanceDir(configDir = getDataDir()) {
     return join(configDir, PROJECT_ENHANCE_DIR);
 }
-function projectEnhancePath(projectDirName, configDir = getConfigDir()) {
+function projectEnhancePath(projectDirName, configDir = getDataDir()) {
     // Sanitize project dir name for filesystem
     const safe = projectDirName.replace(/[^a-zA-Z0-9._-]/g, '_');
     return join(projectEnhanceDir(configDir), `${safe}.json`);
@@ -157,10 +161,10 @@ export function deleteProjectEnhanceResult(projectDirName, configDir) {
         unlinkSync(path);
 }
 const UPLOADED_DIR = 'published';
-function uploadedDir(configDir = getConfigDir()) {
+function uploadedDir(configDir = getDataDir()) {
     return join(configDir, UPLOADED_DIR);
 }
-function uploadedPath(projectDirName, configDir = getConfigDir()) {
+function uploadedPath(projectDirName, configDir = getDataDir()) {
     const safe = projectDirName.replace(/[^a-zA-Z0-9._-]/g, '_');
     return join(uploadedDir(configDir), `${safe}.json`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "heyiam",
-  "version": "0.2.26",
+  "version": "0.2.28",
   "description": "Turn AI coding sessions into portfolio case studies",
   "type": "module",
   "license": "MIT",