workday-daemon 0.10.0 → 0.15.0

package/dist/core/janitor.js

@@ -0,0 +1,156 @@
+import { readdirSync, rmdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { getDataDir } from './config.js';
+import { readDailyLog, writeDailyLog, deleteDailyLog, trimTrailingPauses, generateSessionId } from './daily-log.js';
+import { ClosedBy } from './types.js';
+import { DEFAULT_ACTIVITY } from './constants.js';
+/**
+ * One-time migration: legacy per-session manualAdjustments become one
+ * session-born ManualEntry per session (minutes summed, reasons dropped as
+ * noise, createdAt = first addedAt). Totals are unchanged and session-born
+ * entries fold back into the session aggregate at push time, so the day
+ * status is deliberately NOT flipped to Draft — a re-push produces the exact
+ * same worklogs. Idempotent: the legacy field is removed from the file.
+ */
+function migrateAdjustments(log) {
+    let migrated = 0;
+    for (const session of log.sessions) {
+        const adjustments = session.manualAdjustments;
+        if (!Array.isArray(adjustments))
+            continue;
+        const minutes = adjustments.reduce((sum, a) => sum + (a.minutes ?? 0), 0);
+        // Task-less sessions can't become entries (and were never pushable) —
+        // leave their legacy field untouched rather than dropping data.
+        if (minutes > 0 && session.task) {
+            const entry = {
+                id: generateSessionId(),
+                task: session.task,
+                minutes,
+                description: '',
+                activity: DEFAULT_ACTIVITY,
+                createdAt: adjustments[0]?.addedAt ?? session.lastSeenAt,
+                sourceSessionId: session.id,
+            };
+            if (!log.manualEntries)
+                log.manualEntries = [];
+            log.manualEntries.push(entry);
+            migrated += adjustments.length;
+            delete session.manualAdjustments;
+        }
+        else if (minutes === 0) {
+            delete session.manualAdjustments; // empty legacy array — plain cleanup
+        }
+    }
+    return migrated;
+}
+/** A day record with zero confirmed facts — safe to delete. */
+export function isEmptyDayLog(log) {
+    return log.sessions.length === 0
+        && (log.manualEntries ?? []).length === 0
+        && !log.pushedAt;
+}
+/** Close orphaned open sessions at their trimmed honest end. */
+function closeOrphans(log) {
+    let count = 0;
+    for (const session of log.sessions) {
+        if (session.closedBy)
+            continue;
+        const trimmedEnd = trimTrailingPauses(session);
+        if (trimmedEnd)
+            session.lastSeenAt = trimmedEnd;
+        session.closedBy = ClosedBy.DaemonCrash;
+        count++;
+    }
+    return count;
+}
+/** Drop sessions that never reached ACTIVE — invisible to reports. */
+function pruneNeverActivated(log) {
+    const before = log.sessions.length;
+    log.sessions = log.sessions.filter(s => !!s.activatedAt);
+    return before - log.sessions.length;
+}
+/** All stored dates (any content), oldest first. */
+function listAllStoredDates() {
+    const dataDir = getDataDir();
+    if (!existsSync(dataDir))
+        return [];
+    const dates = [];
+    let monthDirs;
+    try {
+        monthDirs = readdirSync(dataDir).filter(d => /^\d{4}-\d{2}$/.test(d));
+    }
+    catch {
+        return [];
+    }
+    for (const monthDir of monthDirs) {
+        let files;
+        try {
+            files = readdirSync(join(dataDir, monthDir));
+        }
+        catch {
+            continue;
+        }
+        for (const file of files) {
+            const match = file.match(/^\d{2}-(\d{2})\.json$/);
+            if (match)
+                dates.push(`${monthDir}-${match[1]}`);
+        }
+    }
+    return dates.sort();
+}
+/** Remove month dirs that ended up empty after file deletion. */
+function removeEmptyMonthDirs() {
+    const dataDir = getDataDir();
+    if (!existsSync(dataDir))
+        return;
+    let monthDirs;
+    try {
+        monthDirs = readdirSync(dataDir).filter(d => /^\d{4}-\d{2}$/.test(d));
+    }
+    catch {
+        return;
+    }
+    for (const monthDir of monthDirs) {
+        try {
+            rmdirSync(join(dataDir, monthDir));
+        }
+        catch { /* not empty — fine */ }
+    }
+}
+/**
+ * Run the full startup pass for every stored date before `currentDate`.
+ * Corrupted files (unparseable, no backup) are left alone — never deleted
+ * blindly. Idempotent: a clean data dir is a no-op.
+ */
+export function runStartupJanitor(currentDate) {
+    let recovered = 0;
+    let pruned = 0;
+    let migrated = 0;
+    const deletedFiles = [];
+    for (const date of listAllStoredDates()) {
+        if (date >= currentDate)
+            continue;
+        const log = readDailyLog(date);
+        // Unparseable or structurally alien files are left alone — never delete
+        // what we don't understand.
+        if (!log || !Array.isArray(log.sessions))
+            continue;
+        const closedHere = closeOrphans(log);
+        const prunedHere = pruneNeverActivated(log);
+        const migratedHere = migrateAdjustments(log);
+        recovered += closedHere;
+        pruned += prunedHere;
+        migrated += migratedHere;
+        if (isEmptyDayLog(log)) {
+            deleteDailyLog(date);
+            deletedFiles.push(date);
+        }
+        else if (closedHere > 0 || prunedHere > 0 || migratedHere > 0) {
+            writeDailyLog(log);
+        }
+    }
+    if (deletedFiles.length > 0)
+        removeEmptyMonthDirs();
+    return { recoveredSessions: recovered, prunedSessions: pruned, deletedFiles, migratedAdjustments: migrated };
+}
+//# sourceMappingURL=janitor.js.map

package/dist/core/janitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"janitor.js","sourceRoot":"","sources":["../../src/core/janitor.ts"],"names":[],"mappings":"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"}

package/dist/core/session-tracker.d.ts

@@ -67,13 +67,29 @@ export declare class SessionTracker {
         oldLog: DailyLog;
         materialized: boolean;
     };
-    /** Set dayStartedAt (called by daemon on startup) */
-    setDayStartedAt(timestamp: string): void;
-    /** Add manual time adjustment to a session */
-    addAdjustment(target: string, minutes: number, reason: string): {
+    /**
+     * Delete a session from today's log — a user decision at review time
+     * (junk from a stray touch), never automatic. The record is removed
+     * entirely; if the day loses its last confirmed fact the file goes too
+     * (storage invariant), unless the day was already pushed — then the file
+     * stays as the push marker and the status drops to Draft for re-sync.
+     * Deleting an open session is allowed: current activity simply re-births
+     * a fresh candidate on the next tick.
+     */
+    deleteSession(target: string): {
+        ok: boolean;
+        error?: string;
+        deleted?: Session;
+        dayFileDeleted?: boolean;
+    };
+    /**
+     * "+ Add time" on a session card: a session-born manual entry. Task comes
+     * from the session, activity is Development, no description by design.
+     */
+    addSessionEntry(target: string, minutes: number): {
         ok: boolean;
         error?: string;
-        sessionId?: string;
+        entry?: ManualEntry;
     };
     /** Add a manual entry to today's log */
     addManualEntry(input: {
@@ -95,8 +111,6 @@ export declare class SessionTracker {
         ok: boolean;
         error?: string;
     };
-    /** Get manual minutes for a session */
-    getManualMinutes(session: Session): number;
     /**
      * Write current daily log to disk (atomic). No-op until the day is
      * materialized: file exists ⇔ a confirmed fact happened (lazy day).
@@ -142,21 +156,37 @@ export declare class SessionTracker {
     resumeAllSessions(): void;
     /** Check if a session is currently paused */
     hasOpenPause(session: Session): boolean;
+    /**
+     * Idle auto-close (honest session end): a session sitting in an open
+     * IdleTimeout pause longer than session.idleCloseHours closes with a
+     * trimmed end (= where the pause chain began). Manual pauses are exempt —
+     * a frozen session waits for the user; Superseded transitions into
+     * IdleTimeout once the score drains, so it is covered transitively.
+     * Runs at the start of each daemon tick, so after a PC-sleep gap the
+     * stale session closes before wake-up activity births a new one.
+     */
+    closeIdleSessions(now: number): void;
+    /**
+     * Retroactive idle pause after an observation gap (PC sleep / hibernate,
+     * suspended process). Every open, unpaused session gets an IdleTimeout
+     * pause opened at its own pre-gap lastSeenAt — the last moment work was
+     * actually observed — so the gap never counts as work. Sessions already
+     * paused keep their pause (it spans the gap naturally; the chain trim
+     * yields the honest end either way). Returns the number paused.
+     */
+    applyGapPauses(): number;
     /**
      * True when someone is plausibly mid-work: at least one open, unpaused
-     * session OR a live candidate (a session mid-birth). Used as the
+     * session OR a candidate (a session mid-birth — live by construction:
+     * a drained candidate evaporates on the same tick). Used as the
      * quiet-window gate for self-update restarts.
      */
     hasActiveWork(): boolean;
     /** Candidate sessions (in-memory, not yet confirmed facts) in birth order. */
     getCandidates(): readonly Session[];
-    /**
-     * TTL evaporation: a candidate whose last activity is older than
-     * CANDIDATE_TTL_MINUTES vanishes without logs or traces (A-7).
-     */
-    sweepCandidates(now: number): void;
     private dropCandidate;
-    private dropAllCandidates;
+    /** Evaporate every candidate (rollover, observation gap — state is stale). */
+    dropAllCandidates(): void;
     private findOpenSession;
     /** Open session first, then candidate — for baseSha/ledger poll context. */
     private findOpenOrCandidateSession;

package/dist/core/session-tracker.js

@@ -1,10 +1,10 @@
 import { basename } from 'node:path';
-import { SessionState, ClosedBy, SignalType, PauseSource } from './types.js';
+import { SessionState, ClosedBy, DayStatus, SignalType, PauseSource } from './types.js';
 import { applyLedgerUpdate, countSessionCommits, createEmptyLedger } from './commit-ledger.js';
 import { isDayMaterialized } from './day-lifecycle.js';
-import { CANDIDATE_TTL_MINUTES, MS_PER_MINUTE } from './constants.js';
-import { generateSessionId, createEmptyEvidence, createEmptyLog, writeDailyLog, addSignal, addManualAdjustment, addManualEntry, editManualEntry, resolveSessionTarget, computeManualMinutes, getOpenPause, } from './daily-log.js';
+import { generateSessionId, createEmptyEvidence, createEmptyLog, writeDailyLog, deleteDailyLog, addSignal, addManualEntry, editManualEntry, resolveSessionTarget, getOpenPause, trimTrailingPauses, } from './daily-log.js';
 import { computeWorkingDate, getSensitivityForRepo, resolveSensitivityTicks, writeConfig } from './config.js';
+import { DEFAULT_ACTIVITY } from './constants.js';
 /**
  * Manages session lifecycle within a DailyLog.
  *
@@ -33,21 +33,19 @@ export class SessionTracker {
     lastEvaluatorResult = null;
     // In-memory candidate sessions (born from activity, not yet confirmed
     // facts) keyed by repo name. Promoted to dailyLog.sessions by the
-    // evaluator (score > 0 && leader); evaporate on TTL / checkout / rollover.
+    // evaluator (score > 0 && leader); evaporate when the stamina score
+    // drains to zero, on checkout away, or at rollover.
     candidates = new Map();
     // Lazy-day gate: a day loaded from disk keeps being written; a fresh draft
     // materializes only on the first confirmed fact (activation/manual entry).
     loadedFromDisk;
     onSessionClosed = null;
     constructor(config, initialLog) {
-        const today = computeWorkingDate(Date.now(), config.schedule.end, config.timezone);
+        const today = computeWorkingDate(Date.now(), config.boundaryHour, config.timezone);
         this.config = config;
         this.dailyLog = initialLog ?? createEmptyLog(today, config);
         this.loadedFromDisk = initialLog !== undefined;
         // Normalize old logs that lack new fields
-        if (this.dailyLog.dayStartedAt === undefined) {
-            this.dailyLog.dayStartedAt = null;
-        }
         if (!this.dailyLog.manualEntries) {
             this.dailyLog.manualEntries = [];
         }
@@ -55,8 +53,6 @@ export class SessionTracker {
         for (const session of this.dailyLog.sessions) {
             if (!session.pauses)
                 session.pauses = [];
-            if (!session.manualAdjustments)
-                session.manualAdjustments = [];
             if (session.activatedAt === undefined)
                 session.activatedAt = null;
             if (session.evidence.linesAdded === undefined)
@@ -134,23 +130,17 @@ export class SessionTracker {
         // 3. Candidate lifecycle — sessions are born from activity, never from
         //    the mere presence of a task branch (checkout alone is not activity).
         let candidate = this.candidates.get(repoName);
-        if (candidate && candidate.session.task !== result.task) {
+        if (candidate && candidate.task !== result.task) {
             this.dropCandidate(repoName);
             candidate = undefined;
         }
         if (!candidate) {
             if (!hasActivity)
                 return; // watching — nothing exists yet
-            candidate = {
-                session: this.createSession(repoName, result.task, result.branch, now),
-                lastActivityAt: Date.now(),
-            };
+            candidate = this.createSession(repoName, result.task, result.branch, now);
             this.candidates.set(repoName, candidate);
         }
-        else if (hasActivity) {
-            candidate.lastActivityAt = Date.now();
-        }
-        this.updateSessionTick(candidate.session, result, now);
+        this.updateSessionTick(candidate, result, now);
     }
     /**
      * Close orphaned sessions from a previous daemon crash.
@@ -160,7 +150,9 @@ export class SessionTracker {
         let count = 0;
         for (const session of this.dailyLog.sessions) {
             if (!session.closedBy) {
-                this.closeOpenPause(session, session.lastSeenAt);
+                const trimmedEnd = trimTrailingPauses(session);
+                if (trimmedEnd)
+                    session.lastSeenAt = trimmedEnd;
                 session.closedBy = ClosedBy.DaemonCrash;
                 count++;
             }
@@ -219,27 +211,62 @@ export class SessionTracker {
         const completedLog = this.dailyLog;
         const materialized = isDayMaterialized(completedLog, this.loadedFromDisk);
         this.dropAllCandidates();
-        const newDate = computeWorkingDate(Date.now(), this.config.schedule.end, this.config.timezone);
+        const newDate = computeWorkingDate(Date.now(), this.config.boundaryHour, this.config.timezone);
         this.dailyLog = createEmptyLog(newDate, this.config);
         this.loadedFromDisk = false;
         this.lastEvaluatorResult = null;
         return { oldLog: completedLog, materialized };
     }
-    /** Set dayStartedAt (called by daemon on startup) */
-    setDayStartedAt(timestamp) {
-        if (!this.dailyLog.dayStartedAt) {
-            this.dailyLog.dayStartedAt = timestamp;
+    /**
+     * Delete a session from today's log — a user decision at review time
+     * (junk from a stray touch), never automatic. The record is removed
+     * entirely; if the day loses its last confirmed fact the file goes too
+     * (storage invariant), unless the day was already pushed — then the file
+     * stays as the push marker and the status drops to Draft for re-sync.
+     * Deleting an open session is allowed: current activity simply re-births
+     * a fresh candidate on the next tick.
+     */
+    deleteSession(target) {
+        const session = resolveSessionTarget(this.dailyLog, target);
+        if (!session) {
+            return { ok: false, error: `Session not found: ${target}` };
+        }
+        this.dailyLog.sessions = this.dailyLog.sessions.filter(s => s !== session);
+        this.onSessionClosed?.(session.id);
+        if (this.dailyLog.sessions.length === 0
+            && (this.dailyLog.manualEntries ?? []).length === 0
+            && !this.dailyLog.pushedAt) {
+            deleteDailyLog(this.dailyLog.date);
+            this.loadedFromDisk = false; // day de-materializes back into a draft
+            return { ok: true, deleted: session, dayFileDeleted: true };
+        }
+        if (this.dailyLog.status !== DayStatus.Draft) {
+            this.dailyLog.status = DayStatus.Draft; // pushed day edited → re-sync on next push
         }
+        this.flush();
+        return { ok: true, deleted: session, dayFileDeleted: false };
     }
-    /** Add manual time adjustment to a session */
-    addAdjustment(target, minutes, reason) {
+    /**
+     * "+ Add time" on a session card: a session-born manual entry. Task comes
+     * from the session, activity is Development, no description by design.
+     */
+    addSessionEntry(target, minutes) {
         const session = resolveSessionTarget(this.dailyLog, target);
         if (!session) {
             return { ok: false, error: `Session not found: ${target}` };
         }
+        if (!session.task) {
+            return { ok: false, error: 'Session has no task — log the time with `workday log <task> ...`' };
+        }
         try {
-            addManualAdjustment(this.dailyLog, session.id, minutes, reason, this.config);
-            return { ok: true, sessionId: session.id };
+            const entry = addManualEntry(this.dailyLog, {
+                task: session.task,
+                minutes,
+                description: '',
+                activity: DEFAULT_ACTIVITY,
+                sourceSessionId: session.id,
+            }, this.config);
+            return { ok: true, entry };
         }
         catch (err) {
             return { ok: false, error: err instanceof Error ? err.message : String(err) };
@@ -265,10 +292,6 @@ export class SessionTracker {
             return { ok: false, error: err instanceof Error ? err.message : String(err) };
         }
     }
-    /** Get manual minutes for a session */
-    getManualMinutes(session) {
-        return computeManualMinutes(session);
-    }
     /**
      * Write current daily log to disk (atomic). No-op until the day is
      * materialized: file exists ⇔ a confirmed fact happened (lazy day).
@@ -339,8 +362,8 @@ export class SessionTracker {
             }
             ticks.push(this.toTickInput(session, resultMap));
         }
-        for (const entry of this.candidates.values()) {
-            ticks.push(this.toTickInput(entry.session, resultMap));
+        for (const session of this.candidates.values()) {
+            ticks.push(this.toTickInput(session, resultMap));
         }
         return ticks;
     }
@@ -390,18 +413,25 @@ export class SessionTracker {
                 }
             }
         }
-        // Candidate promotion: score > 0 AND leadership — the first active tick
-        // when the repo leads. The session becomes a confirmed fact: pushed into
-        // the log and flushed immediately (the moment the day materializes).
+        // Candidate lifecycle by evaluator score. Promotion: leadership (implies
+        // score > 0) — the first active tick when the repo leads; the session
+        // becomes a confirmed fact, pushed into the log and flushed immediately
+        // (the moment the day materializes). Fade-out: score drained to zero —
+        // the same decay that idle-pauses a session, but an unconfirmed fact has
+        // nothing to pause, so it evaporates. Raw score, not isIdleTimeout: an
+        // Always-on repo must not breed an immortal candidate.
         let promoted = false;
-        for (const [repoName, entry] of [...this.candidates]) {
-            const sessionScore = result.scores.get(entry.session.id);
+        for (const [repoName, session] of [...this.candidates]) {
+            const sessionScore = result.scores.get(session.id);
             if (!sessionScore)
                 continue;
-            if (sessionScore.score > 0 && result.leaderId === entry.session.id) {
-                entry.session.state = SessionState.Active;
-                entry.session.activatedAt = now;
-                this.dailyLog.sessions.push(entry.session);
+            if (sessionScore.score === 0) {
+                this.dropCandidate(repoName);
+            }
+            else if (result.leaderId === session.id) {
+                session.state = SessionState.Active;
+                session.activatedAt = now;
+                this.dailyLog.sessions.push(session);
                 this.candidates.delete(repoName);
                 promoted = true;
             }
@@ -475,9 +505,55 @@ export class SessionTracker {
     hasOpenPause(session) {
         return getOpenPause(session) !== null;
     }
+    /**
+     * Idle auto-close (honest session end): a session sitting in an open
+     * IdleTimeout pause longer than session.idleCloseHours closes with a
+     * trimmed end (= where the pause chain began). Manual pauses are exempt —
+     * a frozen session waits for the user; Superseded transitions into
+     * IdleTimeout once the score drains, so it is covered transitively.
+     * Runs at the start of each daemon tick, so after a PC-sleep gap the
+     * stale session closes before wake-up activity births a new one.
+     */
+    closeIdleSessions(now) {
+        const thresholdMs = this.config.session.idleCloseHours * 3_600_000;
+        if (thresholdMs <= 0)
+            return;
+        const nowIso = new Date(now).toISOString();
+        for (const session of this.dailyLog.sessions) {
+            if (session.closedBy)
+                continue;
+            const pause = getOpenPause(session);
+            if (!pause || pause.source !== PauseSource.IdleTimeout)
+                continue;
+            if (now - Date.parse(pause.from) >= thresholdMs) {
+                this.closeSession(session, ClosedBy.IdleTimeout, nowIso);
+            }
+        }
+    }
+    /**
+     * Retroactive idle pause after an observation gap (PC sleep / hibernate,
+     * suspended process). Every open, unpaused session gets an IdleTimeout
+     * pause opened at its own pre-gap lastSeenAt — the last moment work was
+     * actually observed — so the gap never counts as work. Sessions already
+     * paused keep their pause (it spans the gap naturally; the chain trim
+     * yields the honest end either way). Returns the number paused.
+     */
+    applyGapPauses() {
+        let count = 0;
+        for (const session of this.dailyLog.sessions) {
+            if (session.closedBy)
+                continue;
+            if (this.hasOpenPause(session))
+                continue;
+            session.pauses.push({ from: session.lastSeenAt, to: null, source: PauseSource.IdleTimeout });
+            count++;
+        }
+        return count;
+    }
     /**
      * True when someone is plausibly mid-work: at least one open, unpaused
-     * session OR a live candidate (a session mid-birth). Used as the
+     * session OR a candidate (a session mid-birth — live by construction:
+     * a drained candidate evaporates on the same tick). Used as the
      * quiet-window gate for self-update restarts.
      */
     hasActiveWork() {
@@ -487,27 +563,16 @@ export class SessionTracker {
     // ─── Candidates ──────────────────────────────────────────────────────
     /** Candidate sessions (in-memory, not yet confirmed facts) in birth order. */
     getCandidates() {
-        return [...this.candidates.values()].map(entry => entry.session);
-    }
-    /**
-     * TTL evaporation: a candidate whose last activity is older than
-     * CANDIDATE_TTL_MINUTES vanishes without logs or traces (A-7).
-     */
-    sweepCandidates(now) {
-        const ttlMs = CANDIDATE_TTL_MINUTES * MS_PER_MINUTE;
-        for (const [repoName, entry] of [...this.candidates]) {
-            if (now - entry.lastActivityAt > ttlMs) {
-                this.dropCandidate(repoName);
-            }
-        }
+        return [...this.candidates.values()];
     }
     dropCandidate(repoName) {
-        const entry = this.candidates.get(repoName);
-        if (!entry)
+        const session = this.candidates.get(repoName);
+        if (!session)
             return;
         this.candidates.delete(repoName);
-        this.onSessionClosed?.(entry.session.id);
+        this.onSessionClosed?.(session.id);
     }
+    /** Evaporate every candidate (rollover, observation gap — state is stale). */
     dropAllCandidates() {
         for (const repoName of [...this.candidates.keys()]) {
             this.dropCandidate(repoName);
@@ -519,7 +584,7 @@ export class SessionTracker {
     }
     /** Open session first, then candidate — for baseSha/ledger poll context. */
     findOpenOrCandidateSession(repo) {
-        return this.findOpenSession(repo) ?? this.candidates.get(repo)?.session ?? null;
+        return this.findOpenSession(repo) ?? this.candidates.get(repo) ?? null;
     }
     createSession(repo, task, branch, now) {
         // Every session starts from a clean slate — nothing is inherited from
@@ -542,7 +607,6 @@ export class SessionTracker {
             closedBy: null,
             evidence: createEmptyEvidence(),
             pauses: [],
-            manualAdjustments: [],
             baseSha: null,
             mergeBaseSha: null,
             evidenceBaseline: null,
@@ -553,10 +617,11 @@ export class SessionTracker {
     closeSession(session, reason, now) {
         if (session.closedBy)
             return; // already closed
-        // Close any open pause before closing the session
-        this.closeOpenPause(session, now);
+        // Honest end: an open trailing pause chain means work actually stopped
+        // where the chain began — trim it and end the session there.
+        const trimmedEnd = trimTrailingPauses(session);
         session.closedBy = reason;
-        session.lastSeenAt = now;
+        session.lastSeenAt = trimmedEnd ?? now;
         // state stays as 'pending' or 'active' — preserved for reporting
         this.onSessionClosed?.(session.id);
     }