How the systems are actually put together

A terminal monitor that tracks development session length on your active Git branch, issues break alerts, and logs focus metrics directly to a local CSV file.

#!/usr/bin/env node
/**
 * Session Time Guard - Dev Stamina Monitor
 * Tracks active development sessions and logs focus milestones.
 */
import fs from 'fs';
import path from 'path';
import { execSync } from 'child_process';

const LOG_FILE = path.join(process.env.HOME, '.solopreneur', 'focus-sessions.csv');
const MAX_DURATION_MINUTES = 120;
const WARNING_MINUTES = 90;

function getCurrentBranch() {
  try {
    return execSync('git rev-parse --abbrev-ref HEAD', {
      encoding: 'utf-8'
    }).trim();
  } catch {
    return 'detached';
  }
}

export function startSession(task) {
  const session = {
    startTime: new Date().toISOString(),
    task: task || 'General Refactoring',
    branch: getCurrentBranch()
  };
  fs.writeFileSync(
    path.join(process.env.HOME, '.solopreneur', 'current-session.json'),
    JSON.stringify(session, null, 2)
  );
  console.log(`[GUARD] Started focus session on branch: ${session.branch}`);
}

export function checkStamina(session) {
  const elapsed = (Date.now() - new Date(session.startTime).getTime()) / 60000;
  if (elapsed >= MAX_DURATION_MINUTES) {
    console.log(`[ALERT] Session exceeded ${MAX_DURATION_MINUTES}m! Step away from the monitor.`);
  } else if (elapsed >= WARNING_MINUTES) {
    console.log(`[WARNING] Stamina threshold met (${WARNING_MINUTES}m). Consider taking a 10m break.`);
  }
}