project-logbook 1.2.0 → 1.3.0

package/dist/watch/collectors/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Collector registry for logbook watch.
+ *
+ * Exports all available collectors. The watcher runner checks `available()`
+ * for each and only activates those whose prerequisites are met.
+ */
+import type { Collector } from './types.js';
+/** All registered collectors. */
+/** acli takes priority over jira when both are available — order matters. */
+export declare const ALL_COLLECTORS: Collector[];

package/dist/watch/collectors/index.js

@@ -0,0 +1,21 @@
+/**
+ * Collector registry for logbook watch.
+ *
+ * Exports all available collectors. The watcher runner checks `available()`
+ * for each and only activates those whose prerequisites are met.
+ */
+import { gitCollector } from './git.js';
+import { entriesCollector } from './entries.js';
+import { glabCollector } from './glab.js';
+import { acliCollector } from './acli.js';
+import { jiraCollector } from './jira.js';
+/** All registered collectors. */
+/** acli takes priority over jira when both are available — order matters. */
+export const ALL_COLLECTORS = [
+    gitCollector,
+    entriesCollector,
+    glabCollector,
+    acliCollector,
+    jiraCollector,
+];
+//# sourceMappingURL=index.js.map

package/dist/watch/collectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/watch/collectors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,iCAAiC;AACjC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,YAAY;IACZ,gBAAgB;IAChB,aAAa;IACb,aAAa;IACb,aAAa;CACd,CAAC"}

package/dist/watch/collectors/jira.d.ts

@@ -0,0 +1,3 @@
+/** HTTP Jira collector — fallback when acli is not available. */
+import type { Collector } from './types.js';
+export declare const jiraCollector: Collector;

package/dist/watch/collectors/jira.js

@@ -0,0 +1,110 @@
+/** HTTP Jira collector — fallback when acli is not available. */
+import { request } from 'node:https';
+import { execSync } from 'node:child_process';
+import { getConfig } from '../../lib/config.js';
+import { getCurrentBranch } from '../../lib/git-helpers.js';
+import { extractTicketFromBranch } from '../git-utils.js';
+import { isJiraIssue } from './type-guards.js';
+function buildAssignedJql(accountId) {
+    return `assignee = "${accountId}" AND resolution = Unresolved ORDER BY updated DESC`;
+}
+function httpGet(url, token, timeout = 5000) {
+    return new Promise((resolve) => {
+        const req = request(url, { method: 'GET', headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' }, timeout }, (res) => {
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => {
+                if (res.statusCode !== 200) {
+                    resolve(null);
+                    return;
+                }
+                try {
+                    const parsed = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+                    resolve(parsed);
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        });
+        req.on('error', () => resolve(null));
+        req.on('timeout', () => {
+            req.destroy();
+            resolve(null);
+        });
+        req.end();
+    });
+}
+function fetchMyself(baseUrl, token) {
+    return httpGet(new URL('/rest/api/3/myself', baseUrl), token, 5000);
+}
+function searchIssues(baseUrl, token, jql) {
+    const url = new URL('/rest/api/3/search', baseUrl);
+    url.searchParams.set('jql', jql);
+    url.searchParams.set('fields', 'summary,status,updated,assignee');
+    url.searchParams.set('maxResults', '50');
+    return httpGet(url, token, 10_000).then((body) => {
+        const issues = (body?.issues ?? []).filter(isJiraIssue);
+        return issues;
+    });
+}
+function fetchIssue(baseUrl, token, issueKey) {
+    const url = new URL(`/rest/api/3/issue/${issueKey}`, baseUrl);
+    url.searchParams.set('fields', 'summary,status,updated,assignee');
+    return httpGet(url, token, 5000).then((body) => (body && isJiraIssue(body) ? body : null));
+}
+function getJiraToken() {
+    return process.env.JIRA_API_TOKEN;
+}
+export const jiraCollector = {
+    name: 'jira',
+    schedule: { type: 'interval', ms: 60_000 },
+    async available(_cwd) {
+        if (!getJiraToken())
+            return false;
+        try {
+            execSync('which acli', { stdio: ['ignore', 'pipe', 'ignore'] });
+            return false;
+        }
+        catch {
+            return true;
+        }
+    },
+    async collect(cwd, state) {
+        try {
+            const config = getConfig(cwd);
+            const baseUrl = config.jiraBaseUrl;
+            const token = getJiraToken();
+            if (!baseUrl || !token) {
+                state.jiraStatus = undefined;
+                state.jiraAssignedIssues = [];
+                state.jiraLastUpdated = new Date().toISOString();
+                return;
+            }
+            const myself = await fetchMyself(baseUrl, token);
+            if (!myself) {
+                state.jiraAssignedIssues = [];
+                state.jiraLastUpdated = new Date().toISOString();
+                return;
+            }
+            const rawIssues = await searchIssues(baseUrl, token, buildAssignedJql(myself.accountId));
+            state.jiraAssignedIssues = rawIssues.map((issue) => ({
+                key: issue.key,
+                summary: issue.fields.summary,
+                status: issue.fields.status.name,
+                url: `${baseUrl}/browse/${issue.key}`,
+                jiraBaseUrl: baseUrl,
+                updated: issue.fields.updated,
+            }));
+            const branch = getCurrentBranch(cwd);
+            const ticketKey = state.activeTicketId ?? (branch ? extractTicketFromBranch(branch, config.jiraPrefix) : undefined);
+            if (ticketKey) {
+                const issue = await fetchIssue(baseUrl, token, ticketKey);
+                state.jiraStatus = issue?.fields.status.name;
+            }
+            state.jiraLastUpdated = new Date().toISOString();
+        }
+        catch { }
+    },
+};
+//# sourceMappingURL=jira.js.map

package/dist/watch/collectors/jira.js.map

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

package/dist/watch/collectors/type-guards.d.ts

@@ -0,0 +1,17 @@
+/** Type guards for GitLab and Jira API response types. */
+interface JiraIssueRaw {
+    key: string;
+    fields: {
+        summary: string;
+        status: {
+            name: string;
+        };
+        updated: string;
+        assignee: {
+            displayName: string;
+        } | null;
+    };
+}
+export declare function isJiraIssue(value: unknown): value is JiraIssueRaw;
+export declare function parsePipelineStatus(status: string): 'running' | 'passed' | 'failed' | 'pending' | 'canceled' | 'none';
+export {};

package/dist/watch/collectors/type-guards.js

@@ -0,0 +1,35 @@
+/** Type guards for GitLab and Jira API response types. */
+export function isJiraIssue(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    if (!('key' in value) || !('fields' in value))
+        return false;
+    if (typeof value.key !== 'string')
+        return false;
+    const fields = value.fields;
+    if (!fields || typeof fields !== 'object')
+        return false;
+    if (!('summary' in fields) || !('status' in fields))
+        return false;
+    if (typeof fields.summary !== 'string')
+        return false;
+    const status = fields.status;
+    if (!status || typeof status !== 'object')
+        return false;
+    return 'name' in status && typeof status.name === 'string';
+}
+export function parsePipelineStatus(status) {
+    const lower = status.toLowerCase();
+    if (lower === 'running')
+        return 'running';
+    if (lower === 'passed' || lower === 'success')
+        return 'passed';
+    if (lower === 'failed')
+        return 'failed';
+    if (lower === 'pending')
+        return 'pending';
+    if (lower === 'canceled')
+        return 'canceled';
+    return 'none';
+}
+//# sourceMappingURL=type-guards.js.map

package/dist/watch/collectors/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../../src/watch/collectors/type-guards.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAY1D,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAClE,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxD,OAAO,MAAM,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC/D,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/watch/collectors/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Collector interface for logbook watch.
+ *
+ * A collector gathers a subset of metrics from a specific source (git, files,
+ * CLI tools, APIs). Each collector runs independently on its own schedule and
+ * writes its results into the shared WatcherState.
+ */
+import type { WatcherState } from '../state.js';
+/** Schedule type for a collector. */
+export type CollectorSchedule = 
+/** Runs on file-system events (instant, debounced). */
+{
+    type: 'fs';
+    patterns: string[];
+}
+/** Runs on a fixed interval. */
+ | {
+    type: 'interval';
+    ms: number;
+};
+/** A collector that gathers metrics from a specific source. */
+export interface Collector {
+    /** Human-readable name for logging. */
+    name: string;
+    /** When this collector should run. */
+    schedule: CollectorSchedule;
+    /**
+     * Check if this collector is available (e.g., CLI tool installed).
+     * Returns false if prerequisites are missing — collector will be skipped.
+     */
+    available(cwd: string): Promise<boolean>;
+    /**
+     * Collect metrics and write them into the shared state.
+     * Must not throw — failures should result in undefined/default values.
+     */
+    collect(cwd: string, state: WatcherState): Promise<void>;
+}

package/dist/watch/collectors/types.js

@@ -0,0 +1,9 @@
+/**
+ * Collector interface for logbook watch.
+ *
+ * A collector gathers a subset of metrics from a specific source (git, files,
+ * CLI tools, APIs). Each collector runs independently on its own schedule and
+ * writes its results into the shared WatcherState.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/watch/collectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/watch/collectors/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/watch/dashboard-html.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Dashboard HTML structure for logbook watch hub.
+ *
+ * Provides the page skeleton with tab navigation and content areas.
+ */
+/**
+ * Generate the HTML body structure with tab navigation.
+ *
+ * @param aboutHtml - Pre-rendered HTML content for the About tab.
+ */
+export declare function dashboardHtml(aboutHtml: string): string;

package/dist/watch/dashboard-html.js

@@ -0,0 +1,73 @@
+/**
+ * Dashboard HTML structure for logbook watch hub.
+ *
+ * Provides the page skeleton with tab navigation and content areas.
+ */
+/**
+ * Generate the HTML body structure with tab navigation.
+ *
+ * @param aboutHtml - Pre-rendered HTML content for the About tab.
+ */
+export function dashboardHtml(aboutHtml) {
+    return `
+  <header>
+    <h1>Logbook Hub</h1>
+  </header>
+  <nav class="tab-bar">
+    <button class="tab-btn active" data-tab="projects">Local Projects <span class="tab-count" id="project-count">0</span></button>
+    <button class="tab-btn" data-tab="jira">Jira <span class="tab-count" id="jira-count">0</span></button>
+    <button class="tab-btn" data-tab="gitlab">GitLab <span class="tab-count" id="gitlab-count">0</span></button>
+    <button class="tab-btn" data-tab="help">Help</button>
+    <button class="tab-btn" data-tab="about">About</button>
+  </nav>
+  <div class="container">
+    <div id="tab-projects" class="tab-content active">
+      <div class="tab-header-row" style="justify-content: flex-end;">
+        <button class="sort-toggle" id="sort-toggle">Sort (Newest)</button>
+      </div>
+      <div id="projects" class="projects">
+        <div class="empty">Waiting for projects to connect...</div>
+      </div>
+    </div>
+    <div id="tab-help" class="tab-content">
+      <h2 class="tab-heading">Status Badges Reference</h2>
+      <p class="tab-description">
+        These badges appear on project cards based on the current state of your code, merge requests, and Jira tickets.
+        Badges marked "blocked by" will not appear if the blocking badge is already active.
+      </p>
+      <table class="help-table">
+        <thead><tr><th>Badge</th><th>Source</th><th>Severity</th><th>Description</th><th>Blocked By</th></tr></thead>
+        <tbody id="help-table-body"><tr><td colspan="5" class="table-loading">Loading...</td></tr></tbody>
+      </table>
+    </div>
+    <div id="tab-about" class="tab-content">
+      <div class="about-content">${aboutHtml}</div>
+    </div>
+    <div id="tab-jira" class="tab-content">
+      <div class="tab-header-row">
+        <h2 class="tab-heading">Assigned Jira Issues</h2>
+        <button class="sort-toggle" id="jira-sort-toggle">Sort (Updated)</button>
+      </div>
+      <div id="jira-issues-content">
+        <div class="placeholder-msg">No assigned Jira issues found.<br>Set the <code>JIRA_API_TOKEN</code> environment variable and connect a project with <code>jiraBaseUrl</code> configured.</div>
+      </div>
+      <div class="tab-collector-footer" id="jira-tab-footer" style="display:none"></div>
+    </div>
+    <div id="tab-gitlab" class="tab-content">
+      <h2 class="tab-heading">Open Merge Requests</h2>
+      <div id="gitlab-mrs-content">
+        <div class="placeholder-msg">No open merge requests found.<br>Install the <code>glab</code> CLI and run <code>glab auth login</code> to connect.</div>
+      </div>
+      <div class="tab-collector-footer" id="gitlab-tab-footer" style="display:none"></div>
+    </div>
+  </div>
+  <div class="connection-status" id="conn-status">connected</div>
+  <div class="lightbox" id="lightbox">
+    <div class="lightbox-content">
+      <button class="lightbox-close" id="lightbox-close">&times;</button>
+      <div class="lightbox-title" id="lightbox-title"></div>
+      <div class="lightbox-body" id="lightbox-body"></div>
+    </div>
+  </div>`;
+}
+//# sourceMappingURL=dashboard-html.js.map

package/dist/watch/dashboard-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-html.js","sourceRoot":"","sources":["../../src/watch/dashboard-html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAgC0B,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;SA2BnC,CAAC;AACV,CAAC"}

package/dist/watch/dashboard-script.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Dashboard client-side JavaScript for logbook watch hub.
+ *
+ * Reads from the static hub.js template file instead of embedding JavaScript
+ * in a TypeScript string literal.
+ */
+/**
+ * Read and return the Hub JavaScript wrapped in a script tag.
+ *
+ * @returns A `<script>` element string with the full dashboard JS.
+ */
+export declare function dashboardScript(): string;

package/dist/watch/dashboard-script.js

@@ -0,0 +1,20 @@
+/**
+ * Dashboard client-side JavaScript for logbook watch hub.
+ *
+ * Reads from the static hub.js template file instead of embedding JavaScript
+ * in a TypeScript string literal.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getTemplatesDir } from '../lib/migrations.js';
+/**
+ * Read and return the Hub JavaScript wrapped in a script tag.
+ *
+ * @returns A `<script>` element string with the full dashboard JS.
+ */
+export function dashboardScript() {
+    const jsPath = join(getTemplatesDir(), 'hub.js');
+    const js = readFileSync(jsPath, 'utf8');
+    return `<script>\n${js}\n</script>`;
+}
+//# sourceMappingURL=dashboard-script.js.map

package/dist/watch/dashboard-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-script.js","sourceRoot":"","sources":["../../src/watch/dashboard-script.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,aAAa,EAAE,aAAa,CAAC;AACtC,CAAC"}

package/dist/watch/dashboard-styles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Dashboard CSS styles for logbook watch hub.
+ *
+ * Reads from the static hub.css template file instead of embedding CSS
+ * in a TypeScript string literal.
+ */
+/**
+ * Read and return the Hub CSS wrapped in a style tag.
+ *
+ * @returns A `<style>` element string with the full dashboard CSS.
+ */
+export declare function dashboardStyles(): string;

package/dist/watch/dashboard-styles.js

@@ -0,0 +1,20 @@
+/**
+ * Dashboard CSS styles for logbook watch hub.
+ *
+ * Reads from the static hub.css template file instead of embedding CSS
+ * in a TypeScript string literal.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getTemplatesDir } from '../lib/migrations.js';
+/**
+ * Read and return the Hub CSS wrapped in a style tag.
+ *
+ * @returns A `<style>` element string with the full dashboard CSS.
+ */
+export function dashboardStyles() {
+    const cssPath = join(getTemplatesDir(), 'hub.css');
+    const css = readFileSync(cssPath, 'utf8');
+    return `<style>\n${css}\n</style>`;
+}
+//# sourceMappingURL=dashboard-styles.js.map

package/dist/watch/dashboard-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-styles.js","sourceRoot":"","sources":["../../src/watch/dashboard-styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,YAAY,GAAG,YAAY,CAAC;AACrC,CAAC"}

package/dist/watch/dashboard.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Dashboard assembler for logbook watch hub.
+ *
+ * The "logbook Hub" is the web-based UI for `logbook watch` instances. It
+ * composes the full HTML page from separate style, script, and HTML modules.
+ */
+/**
+ * Generate the full dashboard HTML document.
+ *
+ * @returns Complete HTML string for the dashboard page.
+ */
+export declare function generateDashboardHtml(): Promise<string>;

package/dist/watch/dashboard.js

@@ -0,0 +1,50 @@
+/**
+ * Dashboard assembler for logbook watch hub.
+ *
+ * The "logbook Hub" is the web-based UI for `logbook watch` instances. It
+ * composes the full HTML page from separate style, script, and HTML modules.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { dashboardStyles } from './dashboard-styles.js';
+import { dashboardScript } from './dashboard-script.js';
+import { dashboardHtml } from './dashboard-html.js';
+import { getTemplatesDir } from '../lib/migrations.js';
+import { mdToHtml } from '../lib/build-helpers.js';
+/**
+ * Read the about-watch.md template and return raw markdown content.
+ * Falls back to a default message if the file is missing.
+ */
+function readAboutMarkdown() {
+    try {
+        const templatePath = join(getTemplatesDir(), 'about-watch.md');
+        return readFileSync(templatePath, 'utf8');
+    }
+    catch {
+        return 'No about-watch.md template found.';
+    }
+}
+/**
+ * Generate the full dashboard HTML document.
+ *
+ * @returns Complete HTML string for the dashboard page.
+ */
+export async function generateDashboardHtml() {
+    const aboutMd = readAboutMarkdown();
+    const aboutHtml = await mdToHtml(aboutMd);
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Logbook Hub</title>
+  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'%3E%3Crect width='100' height='100' rx='18' fill='%232563eb'/%3E%3Ctext x='50' y='50' fill='%23fff' font-family='Arial,Helvetica,sans-serif' font-size='55' font-weight='700' text-anchor='middle' dominant-baseline='central'%3EHUB%3C/text%3E%3C/svg%3E">
+  ${dashboardStyles()}
+</head>
+<body>
+  ${dashboardHtml(aboutHtml)}
+  ${dashboardScript()}
+</body>
+</html>`;
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/watch/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/watch/dashboard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD;;;GAGG;AACH,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAC/D,OAAO,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,mCAAmC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE1C,OAAO;;;;;;;IAOL,eAAe,EAAE;;;IAGjB,aAAa,CAAC,SAAS,CAAC;IACxB,eAAe,EAAE;;QAEb,CAAC;AACT,CAAC"}

package/dist/watch/git-utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared git utility helpers for logbook watch collectors.
+ *
+ * Provides a single `git()` runner and common git queries used by multiple
+ * collectors, eliminating duplication across collector files.
+ */
+/**
+ * Parse `git status --porcelain` into staged and unstaged file counts.
+ */
+export declare function parseGitStatus(cwd: string): {
+    staged: number;
+    unstaged: number;
+};
+/**
+ * Count commits ahead of the remote tracking branch.
+ */
+export declare function commitsAheadOfRemote(cwd: string): number;
+/**
+ * Count commits on the current branch vs the default branch.
+ */
+export declare function commitsVsDefault(cwd: string, defaultBranch: string): number;
+/** Extract a ticket ID from a branch name using the configured prefix or a generic pattern. */
+export declare function extractTicketFromBranch(branch: string | undefined, jiraPrefix: string | undefined): string | undefined;
+/**
+ * Resolve the active ticket ID. Checks lockfile first, then falls back to
+ * extracting it from the git branch name.
+ */
+export declare function resolveActiveTicketId(cwd: string, branch: string | undefined, jiraPrefix: string | undefined): string | undefined;
+/** Read the full active ticket slug from the lockfile (folder name). */
+export declare function readActiveTicketSlug(cwd: string): string | undefined;

package/dist/watch/git-utils.js

@@ -0,0 +1,101 @@
+/**
+ * Shared git utility helpers for logbook watch collectors.
+ *
+ * Provides a single `git()` runner and common git queries used by multiple
+ * collectors, eliminating duplication across collector files.
+ */
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Run a git command and return trimmed stdout, or undefined on failure.
+ *
+ * @param cwd - Working directory.
+ * @param args - Git arguments (e.g., 'status --porcelain').
+ * @returns Trimmed output string, or undefined if the command fails or returns empty.
+ */
+function git(cwd, args) {
+    try {
+        return (execSync(`git ${args}`, {
+            encoding: 'utf8',
+            cwd,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim() || undefined);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parse `git status --porcelain` into staged and unstaged file counts.
+ */
+export function parseGitStatus(cwd) {
+    const output = git(cwd, 'status --porcelain') ?? '';
+    let staged = 0;
+    let unstaged = 0;
+    for (const line of output.split('\n').filter(Boolean)) {
+        const idx = line[0];
+        const wt = line[1];
+        if (idx && idx !== ' ' && idx !== '?')
+            staged++;
+        if (wt && wt !== ' ' && wt !== '?')
+            unstaged++;
+        if (idx === '?' && wt === '?')
+            unstaged++;
+    }
+    return { staged, unstaged };
+}
+/**
+ * Count commits ahead of the remote tracking branch.
+ */
+export function commitsAheadOfRemote(cwd) {
+    const out = git(cwd, 'rev-list --count @{upstream}..HEAD');
+    return out ? parseInt(out, 10) : 0;
+}
+/**
+ * Count commits on the current branch vs the default branch.
+ */
+export function commitsVsDefault(cwd, defaultBranch) {
+    const out = git(cwd, `rev-list --count ${defaultBranch}..HEAD`);
+    return out ? parseInt(out, 10) : 0;
+}
+/** Read the active ticket slug from the lockfile, if it exists. */
+function readLockfileSlug(cwd) {
+    const lockPath = join(cwd, '.logbook-active');
+    if (!existsSync(lockPath))
+        return undefined;
+    try {
+        const data = JSON.parse(readFileSync(lockPath, 'utf8'));
+        return data.slug || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Extract a ticket ID (e.g. "IBB-558") from the first two dash-separated segments of a slug. */
+function ticketIdFromSlug(slug) {
+    const parts = slug.split('-');
+    return parts.length >= 2 ? `${parts[0]}-${parts[1]}` : slug;
+}
+/** Extract a ticket ID from a branch name using the configured prefix or a generic pattern. */
+export function extractTicketFromBranch(branch, jiraPrefix) {
+    if (!branch)
+        return undefined;
+    const regex = jiraPrefix ? new RegExp(`\\b${jiraPrefix}-\\d+\\b`, 'i') : /\b[A-Z]+-\d+\b/;
+    return branch.match(regex)?.[0]?.toUpperCase();
+}
+/**
+ * Resolve the active ticket ID. Checks lockfile first, then falls back to
+ * extracting it from the git branch name.
+ */
+export function resolveActiveTicketId(cwd, branch, jiraPrefix) {
+    const slug = readLockfileSlug(cwd);
+    if (slug)
+        return ticketIdFromSlug(slug);
+    return extractTicketFromBranch(branch, jiraPrefix);
+}
+/** Read the full active ticket slug from the lockfile (folder name). */
+export function readActiveTicketSlug(cwd) {
+    return readLockfileSlug(cwd);
+}
+//# sourceMappingURL=git-utils.js.map