vibeflow-cli 0.1.1 → 0.1.2

package/index.js

@@ -35,9 +35,10 @@ const getDataDir = () => {
   return path.join(xdg, "vibeflow-cli");
 };
 
-const DATA_DIR = getDataDir();
-const SESSIONS_FILE = path.join(DATA_DIR, "sessions.json");
-const STATE_FILE = path.join(DATA_DIR, "state.json");
+const DATA_DIR = getDataDir();
+const SESSIONS_FILE = path.join(DATA_DIR, "sessions.json");
+const STATE_FILE = path.join(DATA_DIR, "state.json");
+const DEFAULT_IDLE_MINUTES = 240;
 
 const ensureDir = () => {
   fs.mkdirSync(DATA_DIR, { recursive: true });
@@ -69,15 +70,20 @@ const saveSessions = (sessions) => {
   saveJson(SESSIONS_FILE, sessions);
 };
 
-const loadState = () => {
-  const data = loadJson(STATE_FILE, { activeByRepo: {} });
-  if (!data || typeof data !== "object") {
-    return { activeByRepo: {} };
-  }
-  return {
-    activeByRepo: data.activeByRepo || {}
-  };
-};
+const loadState = () => {
+  const data = loadJson(STATE_FILE, {
+    activeByRepo: {},
+    idleTimeoutMinutes: DEFAULT_IDLE_MINUTES
+  });
+  if (!data || typeof data !== "object") {
+    return { activeByRepo: {}, idleTimeoutMinutes: DEFAULT_IDLE_MINUTES };
+  }
+  return {
+    activeByRepo: data.activeByRepo || {},
+    idleTimeoutMinutes:
+      typeof data.idleTimeoutMinutes === "number" ? data.idleTimeoutMinutes : DEFAULT_IDLE_MINUTES
+  };
+};
 
 const saveState = (state) => {
   saveJson(STATE_FILE, state);
@@ -173,24 +179,26 @@ const getLastSessionForRepo = (sessions, repoKey) => {
   return filtered[0];
 };
 
-const usage = () => {
-  console.log(`
-VibeFlow CLI
-
-Usage:
-  vf start [path]        Start a session
-  vf intent "text"       Set intent for current repo session
-  vf park "note"         Park a thought
-  vf status              Show current session status
+const usage = () => {
+  console.log(`
+VibeFlow CLI
+
+Usage:
+  vf start [path]        Start a session
+  vf intent "text"       Set intent for current repo session
+  vf park "note"         Park a thought
+  vf status              Show current session status
   vf status --watch      Live session timer
   vf timer               Live session timer (alias)
-  vf resume [path]       Show last session summary
+  vf idle [value]        Get/set idle timeout (minutes or Nh)
+  vf touch               Refresh activity timestamp
+  vf resume [path]       Show last session summary
   vf history [path]      List recent sessions
   vf end                 End current session
   vf receipt [id]        Print receipt (defaults to last session)
-  vf help                Show this help
-`);
-};
+  vf help                Show this help
+`);
+};
 
 const printSessionSummary = (session, active = false) => {
   const durationMs = session.endedAt
@@ -206,40 +214,76 @@ const printSessionSummary = (session, active = false) => {
   }
   console.log(`Duration: ${formatDuration(durationMs)}`);
   console.log(`Intent: ${session.intent?.text || "Not set"}`);
-  console.log(`Parked: ${session.parkedThoughts.length}`);
-};
+  console.log(`Parked: ${(session.parkedThoughts || []).length}`);
+};
 
-const ensureActiveSession = (sessions, state, repoKey) => {
-  const activeId = state.activeByRepo[repoKey];
-  if (!activeId) {
-    return null;
-  }
-  const session = findSessionById(sessions, activeId);
-  return session || null;
-};
+const getIdleTimeoutMs = (state) => {
+  const minutes =
+    typeof state.idleTimeoutMinutes === "number" ? state.idleTimeoutMinutes : DEFAULT_IDLE_MINUTES;
+  if (minutes <= 0) {
+    return 0;
+  }
+  return minutes * 60 * 1000;
+};
+
+const normalizeSession = (session) => {
+  if (!session.lastActivityAt) {
+    session.lastActivityAt = session.startedAt;
+  }
+  if (!session.parkedThoughts) {
+    session.parkedThoughts = [];
+  }
+  return session;
+};
+
+const ensureActiveSession = (sessions, state, repoKey) => {
+  const activeId = state.activeByRepo[repoKey];
+  if (!activeId) {
+    return { session: null, autoEnded: false, endedSession: null };
+  }
+  const session = findSessionById(sessions, activeId);
+  if (!session) {
+    return { session: null, autoEnded: false, endedSession: null };
+  }
+  normalizeSession(session);
+  const timeoutMs = getIdleTimeoutMs(state);
+  if (timeoutMs > 0) {
+    const last = Date.parse(session.lastActivityAt || session.startedAt);
+    if (Date.now() - last > timeoutMs) {
+      session.endedAt = nowIso();
+      session.endedReason = "idle";
+      saveSessions(sessions);
+      delete state.activeByRepo[repoKey];
+      saveState(state);
+      return { session: null, autoEnded: true, endedSession: session };
+    }
+  }
+  return { session, autoEnded: false, endedSession: null };
+};
 
-const startSession = (targetPath) => {
-  const cwd = targetPath ? path.resolve(targetPath) : process.cwd();
-  const repoKey = getRepoKey(cwd);
-  const repoName = path.basename(repoKey);
-  const sessions = loadSessions();
+const startSession = (targetPath, watch) => {
+  const cwd = targetPath ? path.resolve(targetPath) : process.cwd();
+  const repoKey = getRepoKey(cwd);
+  const repoName = path.basename(repoKey);
+  const sessions = loadSessions();
   const state = loadState();
 
-  const existing = ensureActiveSession(sessions, state, repoKey);
-  if (existing && !existing.endedAt) {
-    console.log(c.yellow("Session already active:"));
-    printSessionSummary(existing, true);
-    return;
-  }
+  const existing = ensureActiveSession(sessions, state, repoKey);
+  if (existing.session && !existing.session.endedAt) {
+    console.log(c.yellow("Session already active:"));
+    printSessionSummary(existing.session, true);
+    return;
+  }
 
-  const session = {
-    id: `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
-    repoKey,
-    repoName,
-    cwd,
-    startedAt: nowIso(),
-    parkedThoughts: []
-  };
+  const session = {
+    id: `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
+    repoKey,
+    repoName,
+    cwd,
+    startedAt: nowIso(),
+    lastActivityAt: nowIso(),
+    parkedThoughts: []
+  };
 
   sessions.push(session);
   state.activeByRepo[repoKey] = session.id;
@@ -258,7 +302,11 @@ const startSession = (targetPath) => {
   console.log(c.dim("Terminal IDE - Intent - Context - Flow\n"));
   console.log(c.green("Session started."));
   printSessionSummary(session, true);
-  renderLiveTimer(session);
+  if (watch) {
+    renderLiveTimer(session);
+    return;
+  }
+  console.log(c.gray("Live timer: run `vf timer` when you want a live view."));
 };
 
 const setIntent = (text) => {
@@ -267,18 +315,24 @@ const setIntent = (text) => {
     console.error("Intent text is required.");
     return;
   }
-  const repoKey = getRepoKey(process.cwd());
-  const sessions = loadSessions();
-  const state = loadState();
-  const session = ensureActiveSession(sessions, state, repoKey);
-  if (!session) {
-    console.error("No active session. Run `vf start` first.");
-    return;
-  }
-  session.intent = { text: value, setAt: nowIso() };
-  saveSessions(sessions);
-  console.log("Intent saved.");
-};
+  const repoKey = getRepoKey(process.cwd());
+  const sessions = loadSessions();
+  const state = loadState();
+  const active = ensureActiveSession(sessions, state, repoKey);
+  if (!active.session) {
+    if (active.autoEnded) {
+      console.error("Session auto-ended due to inactivity. Run `vf start` to begin a new one.");
+      printSessionSummary(active.endedSession, false);
+      return;
+    }
+    console.error("No active session. Run `vf start` first.");
+    return;
+  }
+  active.session.intent = { text: value, setAt: nowIso() };
+  active.session.lastActivityAt = nowIso();
+  saveSessions(sessions);
+  console.log("Intent saved.");
+};
 
 const parkThought = (text) => {
   const value = text.trim();
@@ -286,19 +340,35 @@ const parkThought = (text) => {
     console.error("Parked thought text is required.");
     return;
   }
-  const repoKey = getRepoKey(process.cwd());
-  const sessions = loadSessions();
-  const state = loadState();
-  const session = ensureActiveSession(sessions, state, repoKey);
-  if (!session) {
-    console.error("No active session. Run `vf start` first.");
-    return;
-  }
-  session.parkedThoughts.push({ text: value, createdAt: nowIso() });
-  saveSessions(sessions);
-  console.log("Thought parked.");
-};
+  const repoKey = getRepoKey(process.cwd());
+  const sessions = loadSessions();
+  const state = loadState();
+  const active = ensureActiveSession(sessions, state, repoKey);
+  if (!active.session) {
+    if (active.autoEnded) {
+      console.error("Session auto-ended due to inactivity. Run `vf start` to begin a new one.");
+      printSessionSummary(active.endedSession, false);
+      return;
+    }
+    console.error("No active session. Run `vf start` first.");
+    return;
+  }
+  active.session.parkedThoughts.push({ text: value, createdAt: nowIso() });
+  active.session.lastActivityAt = nowIso();
+  saveSessions(sessions);
+  console.log("Thought parked.");
+};
 
+const printBigTimeOnce = (elapsed) => {
+  const lines = renderBigTime(elapsed);
+  const tinted = lines.map((line, idx) => {
+    if (idx < 2) return c.cyan(line);
+    if (idx < 4) return c.blue(line);
+    return c.magenta(line);
+  });
+  console.log(tinted.join("\n"));
+};
+
 const renderLiveTimer = (session) => {
   console.log(c.cyan("== VibeFlow Timer =="));
   console.log(c.gray("Ctrl+C to stop\n"));
@@ -330,35 +400,47 @@ const status = (watch = false) => {
   const repoKey = getRepoKey(process.cwd());
   const sessions = loadSessions();
   const state = loadState();
-  const session = ensureActiveSession(sessions, state, repoKey);
-  if (session) {
+  const active = ensureActiveSession(sessions, state, repoKey);
+  if (active.session) {
     if (watch) {
-      renderLiveTimer(session);
+      active.session.lastActivityAt = nowIso();
+      saveSessions(sessions);
+      renderLiveTimer(active.session);
       return;
     }
-    printSessionSummary(session, true);
+    printSessionSummary(active.session, true);
     return;
   }
-  const last = getLastSessionForRepo(sessions, repoKey);
-  if (!last) {
-    console.log("No sessions found for this repo.");
+  if (active.autoEnded && active.endedSession) {
+    console.log(c.yellow("Session auto-ended due to inactivity."));
+    printSessionSummary(active.endedSession, false);
+    return;
+  }
+  const last = getLastSessionForRepo(sessions, repoKey);
+  if (!last) {
+    console.log("No sessions found for this repo.");
     return;
   }
   console.log("No active session. Last session:");
   printSessionSummary(last, false);
 };
 
-const resume = (targetPath) => {
-  const cwd = targetPath ? path.resolve(targetPath) : process.cwd();
-  const repoKey = getRepoKey(cwd);
-  const sessions = loadSessions();
-  const state = loadState();
-  const active = ensureActiveSession(sessions, state, repoKey);
-  if (active) {
-    console.log("Active session:");
-    printSessionSummary(active, true);
-    return;
-  }
+const resume = (targetPath) => {
+  const cwd = targetPath ? path.resolve(targetPath) : process.cwd();
+  const repoKey = getRepoKey(cwd);
+  const sessions = loadSessions();
+  const state = loadState();
+  const active = ensureActiveSession(sessions, state, repoKey);
+  if (active.session) {
+    console.log("Active session:");
+    printSessionSummary(active.session, true);
+    return;
+  }
+  if (active.autoEnded && active.endedSession) {
+    console.log("Last session (auto-ended due to inactivity):");
+    printSessionSummary(active.endedSession, false);
+    return;
+  }
   const last = getLastSessionForRepo(sessions, repoKey);
   if (!last) {
     console.log("No sessions found for this repo.");
@@ -396,17 +478,22 @@ const end = () => {
   const repoKey = getRepoKey(process.cwd());
   const sessions = loadSessions();
   const state = loadState();
-  const session = ensureActiveSession(sessions, state, repoKey);
-  if (!session) {
+  const active = ensureActiveSession(sessions, state, repoKey);
+  if (!active.session) {
+    if (active.autoEnded) {
+      console.error("Session already auto-ended due to inactivity.");
+      printSessionSummary(active.endedSession, false);
+      return;
+    }
     console.error("No active session to end.");
     return;
   }
-  session.endedAt = nowIso();
+  active.session.endedAt = nowIso();
   saveSessions(sessions);
   delete state.activeByRepo[repoKey];
   saveState(state);
   console.log("Session ended.");
-  printSessionSummary(session, false);
+  printSessionSummary(active.session, false);
   process.exit(0);
 };
 
@@ -433,15 +520,99 @@ const receipt = (id) => {
   const durationMs = session.endedAt
     ? Date.parse(session.endedAt) - Date.parse(session.startedAt)
     : Date.now() - Date.parse(session.startedAt);
-  console.log(`Duration: ${formatDuration(durationMs)}`);
-  console.log(`Intent: ${session.intent?.text || "Not set"}`);
-  console.log(`Parked: ${session.parkedThoughts.length}`);
-};
+  console.log(`Duration: ${formatDuration(durationMs)}`);
+  console.log(`Intent: ${session.intent?.text || "Not set"}`);
+  console.log(`Parked: ${(session.parkedThoughts || []).length}`);
+};
+
+const parseIdleMinutes = (value) => {
+  if (!value) {
+    return null;
+  }
+  const cleaned = value.trim().toLowerCase();
+  if (cleaned === "off" || cleaned === "disable" || cleaned === "0") {
+    return 0;
+  }
+  const match = cleaned.match(/^(\d+)(h|m)?$/);
+  if (!match) {
+    return null;
+  }
+  const amount = Number(match[1]);
+  if (!Number.isFinite(amount) || amount <= 0) {
+    return null;
+  }
+  if (match[2] === "h") {
+    return amount * 60;
+  }
+  return amount;
+};
+
+const setIdle = (value) => {
+  const state = loadState();
+  if (!value) {
+    const current = getIdleTimeoutMs(state);
+    if (current === 0) {
+      console.log("Idle timeout: disabled");
+      return;
+    }
+    console.log(`Idle timeout: ${state.idleTimeoutMinutes} minutes`);
+    return;
+  }
+  const minutes = parseIdleMinutes(value);
+  if (minutes === null) {
+    console.error("Invalid idle timeout. Use minutes (e.g. 90) or hours (e.g. 4h) or 'off'.");
+    return;
+  }
+  state.idleTimeoutMinutes = minutes;
+  saveState(state);
+  if (minutes === 0) {
+    console.log("Idle timeout disabled.");
+    return;
+  }
+  console.log(`Idle timeout set to ${minutes} minutes.`);
+};
+
+const touch = () => {
+  const repoKey = getRepoKey(process.cwd());
+  const sessions = loadSessions();
+  const state = loadState();
+  const active = ensureActiveSession(sessions, state, repoKey);
+  if (!active.session) {
+    if (active.autoEnded) {
+      console.error("Session auto-ended due to inactivity.");
+      printSessionSummary(active.endedSession, false);
+      return;
+    }
+    console.error("No active session. Run `vf start` first.");
+    return;
+  }
+  active.session.lastActivityAt = nowIso();
+  saveSessions(sessions);
+  console.log("Session activity refreshed.");
+};
 
-switch (command) {
-  case "start":
-    startSession(args[1]);
-    break;
+const parseStartArgs = (values) => {
+  let watch = false;
+  let targetPath = null;
+  for (const arg of values) {
+    if (arg === "--watch" || arg === "--timer") {
+      watch = true;
+      continue;
+    }
+    if (!targetPath) {
+      targetPath = arg;
+    }
+  }
+  return { watch, targetPath };
+};
+
+switch (command) {
+  case "start":
+    {
+      const parsed = parseStartArgs(args.slice(1));
+      startSession(parsed.targetPath, parsed.watch);
+    }
+    break;
   case "intent":
     setIntent(args.slice(1).join(" "));
     break;
@@ -454,15 +625,21 @@ switch (command) {
   case "timer":
     timer();
     break;
-  case "resume":
-    resume(args[1]);
-    break;
-  case "history":
-    history(args[1]);
-    break;
-  case "end":
-    end();
-    break;
+  case "resume":
+    resume(args[1]);
+    break;
+  case "history":
+    history(args[1]);
+    break;
+  case "idle":
+    setIdle(args[1]);
+    break;
+  case "touch":
+    touch();
+    break;
+  case "end":
+    end();
+    break;
   case "receipt":
     receipt(args[1]);
     break;

package/package.json

@@ -1,7 +1,7 @@
-{
+{
   "name": "vibeflow-cli",
-  "version": "0.1.1",
-  "description": "VibeFlow CLI — intent, context, and session memory for any repo.",
+  "version": "0.1.2",
+  "description": "VibeFlow CLI - intent, context, and session memory for any repo.",
   "author": "Dev Kuns (https://github.com/atobouh)",
   "license": "MIT",
   "type": "commonjs",
@@ -13,4 +13,4 @@
     "README.md",
     "package.json"
   ]
-}
+}