project-logbook 1.2.0 → 1.3.0

package/dist/watch/watcher-http.js

@@ -0,0 +1,47 @@
+/**
+ * HTTP utilities for the logbook watcher.
+ *
+ * Provides the hub communication helper and terminal logging timestamp.
+ */
+import { request } from 'node:http';
+/**
+ * Send a JSON POST request to the hub.
+ *
+ * @param port - Hub port number.
+ * @param path - URL path (e.g., '/_logbook/status').
+ * @param data - JSON-serializable payload.
+ */
+export function postToHub(port, path, data) {
+    const body = JSON.stringify(data);
+    return new Promise((resolve, reject) => {
+        const req = request({
+            hostname: '127.0.0.1',
+            port,
+            path,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+            },
+        }, (res) => {
+            res.resume();
+            res.on('end', resolve);
+        });
+        req.on('error', reject);
+        req.write(body);
+        req.end();
+    });
+}
+/**
+ * Format a short timestamp for terminal logging (HH:MM:SS).
+ *
+ * @returns Formatted time string.
+ */
+export function logTime() {
+    const now = new Date();
+    const h = String(now.getHours()).padStart(2, '0');
+    const m = String(now.getMinutes()).padStart(2, '0');
+    const s = String(now.getSeconds()).padStart(2, '0');
+    return `${h}:${m}:${s}`;
+}
+//# sourceMappingURL=watcher-http.js.map

package/dist/watch/watcher-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-http.js","sourceRoot":"","sources":["../../src/watch/watcher-http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAY,EAAE,IAAa;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,OAAO,CACjB;YACE,QAAQ,EAAE,WAAW;YACrB,IAAI;YACJ,IAAI;YACJ,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;aAC1C;SACF,EACD,CAAC,GAAG,EAAE,EAAE;YACN,GAAG,CAAC,MAAM,EAAE,CAAC;YACb,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACzB,CAAC,CACF,CAAC;QACF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxB,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,CAAC"}

package/dist/watch/watcher.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Start the watcher loop for the given project.
+ */
+export declare function startWatcher(cwd: string, port: number): Promise<void>;

package/dist/watch/watcher.js

@@ -0,0 +1,174 @@
+/** Local project watcher — pushes status snapshots to the hub. */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import matter from 'gray-matter';
+import { getConfig, getLogbookDirPath } from '../lib/config.js';
+import { getEntryFilePaths } from '../lib/entry-paths.js';
+import { mdToHtml } from '../lib/build-helpers.js';
+import { transformLogToTimeline } from '../utils/log-timeline.js';
+import { info, success } from '../lib/theme.js';
+import { ALL_COLLECTORS } from './collectors/index.js';
+import { createEmptyState } from './state.js';
+import { evaluateStatuses } from './strategies/index.js';
+import { collectDetails } from './collector.js';
+import { postToHub, logTime } from './watcher-http.js';
+import { setupFileWatchers } from './watcher-fs.js';
+const LOCKFILE_NAME = '.logbook-active';
+/**
+ * Build and push a full status snapshot to the hub.
+ */
+async function pushStatus(cwd, port, projectName, state, reason, jiraBaseUrl, repositoryUrl, primaryColor, agentName) {
+    const statuses = evaluateStatuses(state);
+    const details = await collectDetails(cwd);
+    // Render previews: read entry files, strip frontmatter, render to HTML.
+    let renderedStory;
+    let renderedLog;
+    let renderedTicket;
+    if (state.hasActiveTicket && state.activeTicketSlug) {
+        const config = getConfig(cwd);
+        const entriesDir = getLogbookDirPath(config, cwd);
+        const paths = getEntryFilePaths(entriesDir, state.activeTicketSlug);
+        if (existsSync(paths.index)) {
+            try {
+                const raw = readFileSync(paths.index, 'utf8');
+                renderedStory = await mdToHtml(matter(raw).content);
+            }
+            catch { }
+        }
+        if (existsSync(paths.log)) {
+            try {
+                const raw = readFileSync(paths.log, 'utf8');
+                renderedLog = await transformLogToTimeline(raw);
+            }
+            catch { }
+        }
+        if (existsSync(paths.ticket)) {
+            try {
+                const raw = readFileSync(paths.ticket, 'utf8');
+                renderedTicket = await mdToHtml(raw);
+            }
+            catch { }
+        }
+    }
+    const status = {
+        projectPath: cwd,
+        projectName,
+        branch: state.branch,
+        activeTicket: state.activeTicketId ?? undefined,
+        latestLog: state.latestLog ?? undefined,
+        statuses,
+        lastActivity: state.lastActivityTimestamp,
+        details,
+        renderedStory,
+        renderedLog,
+        renderedTicket,
+        mrUrl: state.mrUrl,
+        jiraStatus: state.jiraStatus,
+        jiraBaseUrl,
+        repositoryUrl,
+        primaryColor,
+        agentName,
+        glabLastUpdated: state.glabLastUpdated,
+        jiraLastUpdated: state.jiraLastUpdated,
+    };
+    await postToHub(port, '/_logbook/status', status);
+    if (state.jiraAssignedIssues) {
+        await postToHub(port, '/_logbook/jira-issues', {
+            projectPath: cwd,
+            issues: state.jiraAssignedIssues,
+        });
+    }
+    if (state.glabOpenMrs) {
+        await postToHub(port, '/_logbook/gitlab-mrs', {
+            projectPath: cwd,
+            mrs: state.glabOpenMrs,
+        });
+    }
+    console.log(info(`[${logTime()}] ${reason}`));
+}
+/**
+ * Start the watcher loop for the given project.
+ */
+export async function startWatcher(cwd, port) {
+    const config = getConfig(cwd);
+    const projectName = config.projectName;
+    const entriesDir = getLogbookDirPath(config, cwd);
+    const lockfilePath = join(cwd, LOCKFILE_NAME);
+    // --- Check availability once at startup ---
+    const activeCollectors = [];
+    for (const collector of ALL_COLLECTORS) {
+        const isAvailable = await collector.available(cwd);
+        if (isAvailable) {
+            activeCollectors.push(collector);
+            console.log(info(`[${logTime()}] Collector '${collector.name}' active`));
+        }
+        else {
+            console.log(info(`[${logTime()}] Collector '${collector.name}' skipped (not available)`));
+        }
+    }
+    // --- Initialize shared state ---
+    const state = createEmptyState();
+    for (const collector of activeCollectors) {
+        await collector.collect(cwd, state);
+    }
+    const payload = { projectPath: cwd, projectName };
+    await postToHub(port, '/_logbook/register', payload);
+    const agentName = undefined;
+    const pushCfg = {
+        jiraBaseUrl: config.jiraBaseUrl ?? '',
+        repositoryUrl: config.repositoryUrl,
+        primaryColor: config.primaryColor,
+        agentName,
+    };
+    const ps = (reason) => pushStatus(cwd, port, projectName, state, reason, pushCfg.jiraBaseUrl, pushCfg.repositoryUrl, pushCfg.primaryColor, pushCfg.agentName);
+    await ps('Initial status collected');
+    const runAndPush = async (collector, reason) => {
+        try {
+            const prevBranch = state.branch;
+            await collector.collect(cwd, state);
+            if (collector.name === 'git' && state.branch !== prevBranch) {
+                for (const c of activeCollectors) {
+                    if (c.name === 'entries' || c.name === 'glab' || c.name === 'jira')
+                        await c.collect(cwd, state);
+                }
+            }
+            await ps(reason);
+        }
+        catch { }
+    };
+    const fsHandles = setupFileWatchers({ cwd, port, entriesDir, lockfilePath, activeCollectors, state, pushStatus: ps });
+    // --- Interval timers for interval-triggered collectors ---
+    const intervals = [];
+    for (const collector of activeCollectors) {
+        const schedule = collector.schedule;
+        if (schedule.type !== 'interval')
+            continue;
+        const timer = setInterval(() => {
+            void runAndPush(collector, `${collector.name} collector (periodic)`);
+        }, schedule.ms);
+        intervals.push(timer);
+    }
+    // --- Graceful shutdown ---
+    const cleanup = async () => {
+        for (const timer of intervals)
+            clearInterval(timer);
+        fsHandles.clearDebounce();
+        for (const w of fsHandles.watchers)
+            w.close();
+        try {
+            await Promise.race([
+                postToHub(port, '/_logbook/deregister', { projectPath: cwd }),
+                new Promise((resolve) => setTimeout(resolve, 1000)),
+            ]);
+        }
+        catch {
+            // Hub already gone.
+        }
+        console.log(info(`[${logTime()}] Watcher stopped. Goodbye.`));
+        process.exit(0);
+    };
+    process.on('SIGINT', () => void cleanup());
+    process.on('SIGTERM', () => void cleanup());
+    console.log(success(`[${logTime()}] Watching with ${activeCollectors.length} collector(s): ${activeCollectors.map((c) => c.name).join(', ')}`));
+}
+//# sourceMappingURL=watcher.js.map

package/dist/watch/watcher.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-logbook",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A command-line tool for project logbooks.",
   "workspaces": [
     "demo-app"
@@ -20,6 +20,7 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "rimraf dist && tsc && mkdir -p dist/templates && cp src/templates/*.* dist/templates/ && chmod +x dist/index.js",
+    "crawl": "node scripts/crawl.js",
     "prepublishOnly": "npm run build",
     "lint": "eslint src --ext .ts --fix",
     "format": "prettier --write --list-different .",

package/src/templates/about-watch.md

@@ -0,0 +1,29 @@
+# logbook Hub
+
+The **logbook Hub** is a real-time dashboard for monitoring multiple project-logbook instances on your machine.
+
+## How it works
+
+- The first `logbook watch` invocation binds **port 4201** and becomes the Hub server.
+- Subsequent invocations detect the Hub, register as a Watcher, and push status updates.
+- Each project appears as a card on the dashboard with status badges.
+- The dashboard updates in real time via **Server-Sent Events (SSE)**.
+
+## What you see
+
+| Element | Description |
+|---------|-------------|
+| **Badges** | Color-coded status indicators (green = good, yellow = warning, blue = info) |
+| **Branch** | Current git branch, click to open in the repository |
+| **Ticket** | Active logbook ticket, click to open in Jira (if configured) |
+| **Activity** | Recent events: log entries, starts, releases |
+| **Previews** | Story, Log, and Ticket content rendered as HTML (click buttons) |
+| **Details** | LOC stats, staged/unstaged files, commit counts (click card to expand) |
+
+## Status badges
+
+The Help tab lists every status strategy with its severity and which badges it blocks.
+
+## Jira & GitLab tabs
+
+When a project has `jiraBaseUrl` configured and `JIRA_API_TOKEN` set, assigned issues appear in the Jira tab. When `glab` CLI is installed and authenticated, open merge requests appear in the GitLab tab.