project-logbook 1.2.0 → 1.4.0

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,81 @@
+/**
+ * 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="workitems">GitLab Work Items <span class="tab-count" id="workitems-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 id="tab-workitems" class="tab-content">
+      <h2 class="tab-heading">Open GitLab Work Items</h2>
+      <div id="workitems-content">
+        <div class="placeholder-msg">No open work items 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="workitems-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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAiC0B,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAkCnC,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,36 @@
+/**
+ * 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.
+ *
+ * Prefers the configured Jira prefix (e.g. "LB-34"), then falls back to a
+ * bare numeric GitLab work item segment when a gitlab prefix is configured
+ * (e.g. "feat/36-content-api" -> "#36").
+ */
+export declare function extractTicketFromBranch(branch: string | undefined, jiraPrefix: string | undefined, gitlabPrefix?: string): string | undefined;
+/**
+ * Resolve the active ticket ID. Checks lockfile first, then falls back to
+ * extracting it from the git branch name (Jira prefix or GitLab work item).
+ */
+export declare function resolveActiveTicketId(cwd: string, branch: string | undefined, jiraPrefix: string | undefined, gitlabPrefix?: string): 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,117 @@
+/**
+ * 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.
+ *
+ * Prefers the configured Jira prefix (e.g. "LB-34"), then falls back to a
+ * bare numeric GitLab work item segment when a gitlab prefix is configured
+ * (e.g. "feat/36-content-api" -> "#36").
+ */
+export function extractTicketFromBranch(branch, jiraPrefix, gitlabPrefix) {
+    if (!branch)
+        return undefined;
+    const regex = jiraPrefix ? new RegExp(`\\b${jiraPrefix}-\\d+\\b`, 'i') : /\b[A-Z]+-\d+\b/;
+    const jira = branch.match(regex)?.[0]?.toUpperCase();
+    if (jira)
+        return jira;
+    // GitLab work items appear as a bare numeric branch segment after a slash or
+    // dash, e.g. "feat/36-content-api-garbage-endpoints" -> "#36".
+    if (gitlabPrefix) {
+        const gl = branch.match(/(?:^|[\/\\_#-])(\d+)(?:-|$)/);
+        if (gl)
+            return `${gitlabPrefix}${gl[1]}`;
+    }
+    return undefined;
+}
+/**
+ * Resolve the active ticket ID. Checks lockfile first, then falls back to
+ * extracting it from the git branch name (Jira prefix or GitLab work item).
+ */
+export function resolveActiveTicketId(cwd, branch, jiraPrefix, gitlabPrefix) {
+    const slug = readLockfileSlug(cwd);
+    if (slug)
+        return ticketIdFromSlug(slug);
+    return extractTicketFromBranch(branch, jiraPrefix, gitlabPrefix);
+}
+/** Read the full active ticket slug from the lockfile (folder name). */
+export function readActiveTicketSlug(cwd) {
+    return readLockfileSlug(cwd);
+}
+//# sourceMappingURL=git-utils.js.map

package/dist/watch/git-utils.js.map

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

package/dist/watch/hub-state.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Hub shared state and utilities for logbook watch.
+ *
+ * Contains the in-memory stores for projects, events, Jira issues, and GitLab
+ * MRs, plus HTTP helper functions used by the route handler.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ActivityEvent, GitLabMr, GitLabWorkItem, JiraIssue, ProjectStatus } from './types.js';
+/** Connected SSE clients. */
+export declare const sseClients: Set<ServerResponse>;
+/** Current state of all registered projects. */
+export declare const projectStates: Map<string, ProjectStatus>;
+/** Activity timeline per project (keyed by projectPath). Max 50 events per project. */
+export declare const projectEvents: Map<string, ActivityEvent[]>;
+/** Jira assigned issues, deduplicated by key+jiraBaseUrl. */
+export declare const jiraIssues: Map<string, JiraIssue>;
+/** GitLab open MRs, deduplicated by projectUrl+iid. */
+export declare const gitlabMrs: Map<string, GitLabMr>;
+/** GitLab open work items, deduplicated by projectUrl+iid. */
+export declare const gitlabWorkItems: Map<string, GitLabWorkItem>;
+/** Maximum number of events to keep per project. */
+export declare const MAX_EVENTS_PER_PROJECT = 50;
+/**
+ * Broadcast an SSE event to all connected clients.
+ *
+ * @param data - The data object to send as JSON.
+ */
+export declare function broadcast(data: unknown): void;
+/**
+ * Read the full request body as a string.
+ *
+ * @param req - The incoming HTTP request.
+ * @returns The request body string.
+ */
+export declare function readBody(req: IncomingMessage): Promise<string>;
+/**
+ * Send a JSON response.
+ */
+export declare function jsonResponse(res: ServerResponse, status: number, data: unknown): void;

package/dist/watch/hub-state.js

@@ -0,0 +1,57 @@
+/**
+ * Hub shared state and utilities for logbook watch.
+ *
+ * Contains the in-memory stores for projects, events, Jira issues, and GitLab
+ * MRs, plus HTTP helper functions used by the route handler.
+ */
+/** Connected SSE clients. */
+export const sseClients = new Set();
+/** Current state of all registered projects. */
+export const projectStates = new Map();
+/** Activity timeline per project (keyed by projectPath). Max 50 events per project. */
+export const projectEvents = new Map();
+/** Jira assigned issues, deduplicated by key+jiraBaseUrl. */
+export const jiraIssues = new Map();
+/** GitLab open MRs, deduplicated by projectUrl+iid. */
+export const gitlabMrs = new Map();
+/** GitLab open work items, deduplicated by projectUrl+iid. */
+export const gitlabWorkItems = new Map();
+/** Maximum number of events to keep per project. */
+export const MAX_EVENTS_PER_PROJECT = 50;
+/**
+ * Broadcast an SSE event to all connected clients.
+ *
+ * @param data - The data object to send as JSON.
+ */
+export function broadcast(data) {
+    const payload = `data: ${JSON.stringify(data)}\n\n`;
+    for (const client of sseClients) {
+        client.write(payload);
+    }
+}
+/**
+ * Read the full request body as a string.
+ *
+ * @param req - The incoming HTTP request.
+ * @returns The request body string.
+ */
+export function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        req.on('error', reject);
+    });
+}
+/**
+ * Send a JSON response.
+ */
+export function jsonResponse(res, status, data) {
+    const body = JSON.stringify(data);
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body),
+    });
+    res.end(body);
+}
+//# sourceMappingURL=hub-state.js.map

package/dist/watch/hub-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-state.js","sourceRoot":"","sources":["../../src/watch/hub-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAwB,IAAI,GAAG,EAAE,CAAC;AAEzD,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAA+B,IAAI,GAAG,EAAE,CAAC;AAEnE,uFAAuF;AACvF,MAAM,CAAC,MAAM,aAAa,GAAiC,IAAI,GAAG,EAAE,CAAC;AAErE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,UAAU,GAA2B,IAAI,GAAG,EAAE,CAAC;AAE5D,uDAAuD;AACvD,MAAM,CAAC,MAAM,SAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;AAE1D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAgC,IAAI,GAAG,EAAE,CAAC;AAEtE,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;IACpD,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAoB;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAmB,EAAE,MAAc,EAAE,IAAa;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE;QACpB,cAAc,EAAE,kBAAkB;QAClC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;KAC1C,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/watch/hub.d.ts

@@ -0,0 +1,2 @@
+/** Hub server — serves the dashboard UI and bridges watchers ↔ SSE. */
+export declare function startHub(port: number): Promise<string>;