project-logbook 1.2.0 → 1.3.0

package/dist/watch/strategies/ready-to-commit.js

@@ -0,0 +1,21 @@
+/**
+ * Ready to Commit — there are staged changes waiting to be committed.
+ */
+export const readyToCommitCheck = {
+    id: 'ready-to-commit',
+    source: 'Git',
+    description: 'There are staged changes ready to be committed.',
+    blockedBy: ['squash-merged', 'released'],
+    check(metrics) {
+        if (metrics.stagedFiles > 0) {
+            return {
+                id: 'ready-to-commit',
+                label: 'Ready to Commit',
+                severity: 'warning',
+                detail: `${metrics.stagedFiles} file${metrics.stagedFiles !== 1 ? 's' : ''} staged`,
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=ready-to-commit.js.map

package/dist/watch/strategies/ready-to-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-to-commit.js","sourceRoot":"","sources":["../../../src/watch/strategies/ready-to-commit.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,EAAE,EAAE,iBAAiB;IACrB,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,iDAAiD;IAC9D,SAAS,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC;IACxC,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO;gBACL,EAAE,EAAE,iBAAiB;gBACrB,KAAK,EAAE,iBAAiB;gBACxB,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,QAAQ,OAAO,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS;aACpF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/watch/strategies/ready-to-push.d.ts

@@ -0,0 +1,5 @@
+import type { StatusStrategy } from './types.js';
+/**
+ * Ready to Push — local commits are ahead of the remote.
+ */
+export declare const readyToPushCheck: StatusStrategy;

package/dist/watch/strategies/ready-to-push.js

@@ -0,0 +1,21 @@
+/**
+ * Ready to Push — local commits are ahead of the remote.
+ */
+export const readyToPushCheck = {
+    id: 'ready-to-push',
+    source: 'Git',
+    description: 'Local commits are ahead of the remote tracking branch.',
+    blockedBy: ['squash-merged', 'released'],
+    check(metrics) {
+        if (metrics.isAheadOfRemote) {
+            return {
+                id: 'ready-to-push',
+                label: 'Ready to Push',
+                severity: 'warning',
+                detail: 'Commits are ahead of remote.',
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=ready-to-push.js.map

package/dist/watch/strategies/ready-to-push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-to-push.js","sourceRoot":"","sources":["../../../src/watch/strategies/ready-to-push.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,EAAE,EAAE,eAAe;IACnB,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,wDAAwD;IACrE,SAAS,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC;IACxC,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,OAAO;gBACL,EAAE,EAAE,eAAe;gBACnB,KAAK,EAAE,eAAe;gBACtB,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,8BAA8B;aACvC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/watch/strategies/released.d.ts

@@ -0,0 +1,6 @@
+import type { StatusStrategy } from './types.js';
+/**
+ * Released — the active ticket has a dateEnd set (was released).
+ * When true, no other actionable strategies should show.
+ */
+export declare const releasedCheck: StatusStrategy;

package/dist/watch/strategies/released.js

@@ -0,0 +1,21 @@
+/**
+ * Released — the active ticket has a dateEnd set (was released).
+ * When true, no other actionable strategies should show.
+ */
+export const releasedCheck = {
+    id: 'released',
+    source: 'LOGBOOK',
+    description: 'The active ticket has a dateEnd set, meaning it has been released.',
+    check(metrics) {
+        if (metrics.isReleased && !metrics.isDirty) {
+            return {
+                id: 'released',
+                label: 'Released',
+                severity: 'success',
+                detail: 'Ticket has been released.',
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=released.js.map

package/dist/watch/strategies/released.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"released.js","sourceRoot":"","sources":["../../../src/watch/strategies/released.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,EAAE,EAAE,UAAU;IACd,MAAM,EAAE,SAAS;IACjB,WAAW,EAAE,oEAAoE;IACjF,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3C,OAAO;gBACL,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,UAAU;gBACjB,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,2BAA2B;aACpC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/watch/strategies/squash-merged.d.ts

@@ -0,0 +1,6 @@
+import type { StatusStrategy } from './types.js';
+/**
+ * Squash Merged — all branch commits are already on the default branch.
+ * When true, no other actionable strategies should show.
+ */
+export declare const squashMergedCheck: StatusStrategy;

package/dist/watch/strategies/squash-merged.js

@@ -0,0 +1,21 @@
+/**
+ * Squash Merged — all branch commits are already on the default branch.
+ * When true, no other actionable strategies should show.
+ */
+export const squashMergedCheck = {
+    id: 'squash-merged',
+    source: 'Git',
+    description: 'All commits on this branch are already on the default branch (squash-merged).',
+    check(metrics) {
+        if (metrics.isSquashMerged && !metrics.isDirty) {
+            return {
+                id: 'squash-merged',
+                label: 'Squash Merged',
+                severity: 'success',
+                detail: 'Branch commits are already on the default branch.',
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=squash-merged.js.map

package/dist/watch/strategies/squash-merged.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"squash-merged.js","sourceRoot":"","sources":["../../../src/watch/strategies/squash-merged.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,EAAE,EAAE,eAAe;IACnB,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,+EAA+E;IAC5F,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC/C,OAAO;gBACL,EAAE,EAAE,eAAe;gBACnB,KAAK,EAAE,eAAe;gBACtB,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,mDAAmD;aAC5D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Strategy interface for logbook watch status evaluations.
+ *
+ * A strategy inspects WatcherMetrics and returns a StatusResult when its
+ * condition is met, or null when the condition is not applicable.
+ *
+ * Strategies can declare a `blockedBy` list: if any ID in that list is
+ * already present in the results, this strategy is suppressed (not evaluated).
+ * This prevents redundant or contradictory badges from appearing together.
+ */
+import type { StatusResult, WatcherMetrics } from '../types.js';
+/** The origin source of a strategy (shown in the Help tab). */
+export type StrategySource = 'LOGBOOK' | 'Git' | 'GitLab' | 'Jira';
+/** A single status strategy. */
+export interface StatusStrategy {
+    /** Human-readable ID used for blockedBy references. */
+    id: string;
+    /** The source tool this strategy belongs to (for Help tab metadata). */
+    source?: StrategySource;
+    /** Human-readable description (for Help tab). */
+    description?: string;
+    /** List of strategy IDs that block this one. */
+    blockedBy?: string[];
+    /**
+     * Evaluate the strategy against the current metrics.
+     *
+     * @param metrics - The collected watcher metrics.
+     * @returns A status result when this strategy's condition is met, null otherwise.
+     */
+    check(metrics: WatcherMetrics): StatusResult | null;
+}

package/dist/watch/strategies/types.js

@@ -0,0 +1,12 @@
+/**
+ * Strategy interface for logbook watch status evaluations.
+ *
+ * A strategy inspects WatcherMetrics and returns a StatusResult when its
+ * condition is met, or null when the condition is not applicable.
+ *
+ * Strategies can declare a `blockedBy` list: if any ID in that list is
+ * already present in the results, this strategy is suppressed (not evaluated).
+ * This prevents redundant or contradictory badges from appearing together.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/watch/strategies/unstaged-changes.d.ts

@@ -0,0 +1,5 @@
+import type { StatusStrategy } from './types.js';
+/**
+ * Unstaged Changes — there are files with unstaged modifications.
+ */
+export declare const unstagedChangesCheck: StatusStrategy;

package/dist/watch/strategies/unstaged-changes.js

@@ -0,0 +1,21 @@
+/**
+ * Unstaged Changes — there are files with unstaged modifications.
+ */
+export const unstagedChangesCheck = {
+    id: 'unstaged-changes',
+    source: 'Git',
+    description: 'There are unstaged changes in the working tree.',
+    blockedBy: ['squash-merged', 'released'],
+    check(metrics) {
+        if (metrics.unstagedFiles > 0) {
+            return {
+                id: 'unstaged-changes',
+                label: 'Unstaged Changes',
+                severity: 'warning',
+                detail: `${metrics.unstagedFiles} file${metrics.unstagedFiles !== 1 ? 's' : ''} with unstaged changes`,
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=unstaged-changes.js.map

package/dist/watch/strategies/unstaged-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unstaged-changes.js","sourceRoot":"","sources":["../../../src/watch/strategies/unstaged-changes.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,EAAE,EAAE,kBAAkB;IACtB,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,iDAAiD;IAC9D,SAAS,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC;IACxC,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,EAAE,EAAE,kBAAkB;gBACtB,KAAK,EAAE,kBAAkB;gBACzB,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,QAAQ,OAAO,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,wBAAwB;aACvG,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/watch/strategies/wrong-branch.d.ts

@@ -0,0 +1,6 @@
+import type { StatusStrategy } from './types.js';
+/**
+ * Wrong Branch — the active ticket slug doesn't match the current git branch.
+ * Only fires when a lockfile exists (explicit active entry).
+ */
+export declare const wrongBranchCheck: StatusStrategy;

package/dist/watch/strategies/wrong-branch.js

@@ -0,0 +1,26 @@
+/**
+ * Wrong Branch — the active ticket slug doesn't match the current git branch.
+ * Only fires when a lockfile exists (explicit active entry).
+ */
+export const wrongBranchCheck = {
+    id: 'wrong-branch',
+    source: 'Git',
+    description: "The current git branch name does not match the active ticket. Run 'logbook start' on the correct branch.",
+    blockedBy: ['squash-merged', 'released'],
+    check(metrics) {
+        if (metrics.hasActiveTicket &&
+            metrics.hasLockfile &&
+            metrics.branch &&
+            metrics.activeTicketSlug &&
+            !metrics.branch.includes(metrics.activeTicketSlug)) {
+            return {
+                id: 'wrong-branch',
+                label: 'Not on Ticket Branch',
+                severity: 'warning',
+                detail: `Branch '${metrics.branch}' does not match '${metrics.activeTicketSlug}'`,
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=wrong-branch.js.map

package/dist/watch/strategies/wrong-branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrong-branch.js","sourceRoot":"","sources":["../../../src/watch/strategies/wrong-branch.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,EAAE,EAAE,cAAc;IAClB,MAAM,EAAE,KAAK;IACb,WAAW,EACT,0GAA0G;IAC5G,SAAS,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC;IACxC,KAAK,CAAC,OAAO;QACX,IACE,OAAO,CAAC,eAAe;YACvB,OAAO,CAAC,WAAW;YACnB,OAAO,CAAC,MAAM;YACd,OAAO,CAAC,gBAAgB;YACxB,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAClD,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,cAAc;gBAClB,KAAK,EAAE,sBAAsB;gBAC7B,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,WAAW,OAAO,CAAC,MAAM,qBAAqB,OAAO,CAAC,gBAAgB,GAAG;aAClF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/watch/types.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Shared types for the logbook watch subsystem.
+ *
+ * Defines the data contracts between the watcher, hub, status strategies,
+ * and dashboard.
+ */
+/** Severity levels for status checks. */
+export type StatusSeverity = 'info' | 'warning' | 'success';
+/** A single status determination produced by a strategy. */
+export interface StatusResult {
+    /** Machine-readable status identifier. */
+    id: string;
+    /** Human-readable label for display. */
+    label: string;
+    /** Severity determines badge color and priority. */
+    severity: StatusSeverity;
+    /** Optional detail message for context. */
+    detail?: string;
+}
+/** Raw metrics collected by the watcher before status evaluation. */
+export interface WatcherMetrics {
+    /** Current git branch name. */
+    branch: string | undefined;
+    /** Default branch (main/master). */
+    defaultBranch: string;
+    /** Whether there is an active logbook ticket. */
+    hasActiveTicket: boolean;
+    /** Active ticket ID (e.g., "LB-83"). */
+    activeTicketId: string | undefined;
+    /** Active ticket slug (full folder name). */
+    activeTicketSlug: string | undefined;
+    /** Latest log entry message. */
+    latestLog: string | undefined;
+    /** Latest log entry timestamp (ISO). */
+    latestLogTimestamp: string | undefined;
+    /** Whether the working tree has uncommitted changes. */
+    isDirty: boolean;
+    /** Number of files with staged changes. */
+    stagedFiles: number;
+    /** Number of files with unstaged changes. */
+    unstagedFiles: number;
+    /** Whether local commits are ahead of the remote. */
+    isAheadOfRemote: boolean;
+    /** Whether index.md has unfilled placeholders. */
+    hasNarrativePlaceholders: boolean;
+    /** Whether the most recent ticket has a dateEnd set (released). */
+    isReleased: boolean;
+    /** Whether the lockfile (.logbook-active) exists. */
+    hasLockfile: boolean;
+    /** Whether all branch commits are already on the default branch (squash-merged). */
+    isSquashMerged: boolean;
+    /** Number of commits the current branch is behind the default branch (0 = up to date). */
+    commitsBehindDefault: number;
+    /** ISO timestamp of the last meaningful activity (commit, log entry, file edit). */
+    lastActivityTimestamp: string;
+    /** Merge request status. */
+    mrStatus?: 'approved' | 'approval-optional' | 'open-comments' | 'changes-requested' | 'open' | 'merged' | 'draft' | 'none';
+    /** Number of unresolved discussion threads. */
+    mrOpenThreads?: number;
+    /** Web URL of the MR. */
+    mrUrl?: string;
+    /** Whether the MR has merge conflicts with the target branch. */
+    mrHasConflicts?: boolean;
+    /** Pipeline status for the current branch. */
+    pipelineStatus?: 'running' | 'passed' | 'failed' | 'pending' | 'canceled' | 'none';
+    /** Jira ticket status (e.g., "To Do", "In Progress", "Done"). */
+    jiraStatus?: string;
+}
+/** The full project status snapshot pushed to the hub. */
+export interface ProjectStatus {
+    /** Absolute path to the project root. */
+    projectPath: string;
+    /** Human-readable project name from .project-logbook config. */
+    projectName: string;
+    /** Current git branch. */
+    branch: string | undefined;
+    /** Active ticket ID. */
+    activeTicket: string | undefined;
+    /** Latest log entry text. */
+    latestLog: string | undefined;
+    /** Computed statuses from strategies. */
+    statuses: StatusResult[];
+    /** ISO timestamp of the last meaningful change in the project (file edit, commit, log entry). */
+    lastActivity: string;
+    /** Detailed metrics for the expandable detail view. */
+    details: ProjectDetails | undefined;
+    /** Rendered index.md HTML (story preview). Only set when a ticket is active. */
+    renderedStory: string | undefined;
+    /** Rendered log.md HTML (log preview). Only set when a ticket is active. */
+    renderedLog: string | undefined;
+    /** Rendered ticket.md HTML (ticket preview). Only set when a ticket is active. */
+    renderedTicket: string | undefined;
+    /** MR web URL for linking in the dashboard. */
+    mrUrl: string | undefined;
+    /** Jira ticket status (e.g., "In Progress", "Done"). */
+    jiraStatus: string | undefined;
+    /** Jira base URL for constructing ticket links. */
+    jiraBaseUrl: string | undefined;
+    /** Repository web URL for constructing branch links. */
+    repositoryUrl: string | undefined;
+    /** Primary accent color from the project's .project-logbook config. */
+    primaryColor: string | undefined;
+    /** Agent name from config, displayed alongside the project name. */
+    agentName: string | undefined;
+    /** ISO timestamp of last successful GitLab collector run. */
+    glabLastUpdated: string | undefined;
+    /** ISO timestamp of last successful Jira collector run. */
+    jiraLastUpdated: string | undefined;
+}
+/** Detailed metrics shown in the expandable project detail view. */
+export interface ProjectDetails {
+    /** Lines of code changed (insertions + deletions) vs default branch. */
+    locChanged: number;
+    /** Insertions count. */
+    insertions: number;
+    /** Deletions count. */
+    deletions: number;
+    /** Number of files with unstaged changes. */
+    unstagedFiles: number;
+    /** Number of files staged for commit. */
+    stagedFiles: number;
+    /** Number of commits ahead of remote. */
+    commitsAhead: number;
+    /** Number of commits on this branch vs default branch. */
+    commitsOnBranch: number;
+    /** Default branch name. */
+    defaultBranch: string;
+}
+/** Registration payload sent to the hub. */
+export interface RegisterPayload {
+    projectPath: string;
+    projectName: string;
+}
+/** Health response from the hub. */
+export interface HealthResponse {
+    logbook: true;
+    version: string;
+    projects: number;
+}
+/**
+ * Resolve the hub port from environment or default.
+ *
+ * Checks `LOGBOOK_WATCH_PORT` env var first, falls back to 4201.
+ *
+ * @returns The port number to use for the hub.
+ */
+export declare function resolveWatchPort(): number;
+/** A single event in the project activity timeline. */
+export interface ActivityEvent {
+    /** ISO timestamp of the event. */
+    timestamp: string;
+    /** Short description of what happened. */
+    description: string;
+    /** The command/source that produced this event. */
+    source: string;
+}
+/** A Jira issue assigned to the current user (for the Jira tab). */
+export interface JiraIssue {
+    /** Issue key (e.g., "ASP-232"). */
+    key: string;
+    /** Issue summary/title. */
+    summary: string;
+    /** Current status name (e.g., "In Review"). */
+    status: string;
+    /** Full URL to open the issue in the browser. */
+    url: string;
+    /** Jira base URL this issue belongs to (for grouping/dedup). */
+    jiraBaseUrl: string;
+    /** ISO timestamp of the last update in Jira. */
+    updated: string;
+}
+/** A GitLab merge request for the GitLab tab. */
+export interface GitLabMr {
+    /** MR IID (project-scoped). */
+    iid: number;
+    /** MR title. */
+    title: string;
+    /** MR state: open, merged, draft. */
+    status: string;
+    /** Number of unresolved discussion threads. */
+    comments: number;
+    /** Web URL to open the MR. */
+    url: string;
+    /** Source branch name. */
+    sourceBranch: string;
+    /** Project web URL (for grouping/dedup). */
+    projectUrl: string;
+    /** Project name (human-readable). */
+    projectName: string;
+}

package/dist/watch/types.js

@@ -0,0 +1,25 @@
+/**
+ * Shared types for the logbook watch subsystem.
+ *
+ * Defines the data contracts between the watcher, hub, status strategies,
+ * and dashboard.
+ */
+/** The default port for the logbook watch hub. */
+const WATCH_PORT_DEFAULT = 4201;
+/**
+ * Resolve the hub port from environment or default.
+ *
+ * Checks `LOGBOOK_WATCH_PORT` env var first, falls back to 4201.
+ *
+ * @returns The port number to use for the hub.
+ */
+export function resolveWatchPort() {
+    const envPort = process.env.LOGBOOK_WATCH_PORT;
+    if (envPort) {
+        const parsed = parseInt(envPort, 10);
+        if (!isNaN(parsed) && parsed > 0 && parsed < 65536)
+            return parsed;
+    }
+    return WATCH_PORT_DEFAULT;
+}
+//# sourceMappingURL=types.js.map

package/dist/watch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/watch/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0JH,kDAAkD;AAClD,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC/C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,KAAK;YAAE,OAAO,MAAM,CAAC;IACpE,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/watch/watcher-fs.d.ts

@@ -0,0 +1,39 @@
+/**
+ * File-system watcher setup for logbook watch.
+ *
+ * Handles debounced file-system events that trigger collector re-runs.
+ */
+import { watch as fsWatch } from 'node:fs';
+import type { Collector } from './collectors/types.js';
+import type { WatcherState } from './state.js';
+/** Context needed by the file-watcher to trigger collections and pushes. */
+interface FsWatcherContext {
+    cwd: string;
+    port: number;
+    entriesDir: string;
+    lockfilePath: string;
+    activeCollectors: Collector[];
+    state: WatcherState;
+    /** Callback to push a full status snapshot to the hub. */
+    pushStatus: (_reason: string) => Promise<void>;
+}
+/** Handles returned by setupFileWatchers for cleanup. */
+interface FsWatcherHandles {
+    /** Native fs.watch handles to close on shutdown. */
+    watchers: ReturnType<typeof fsWatch>[];
+    /** Debounce timer reference (may be null). */
+    getDebounceTimer: () => ReturnType<typeof setTimeout> | null;
+    /** Clear the debounce timer on shutdown. */
+    clearDebounce: () => void;
+}
+/**
+ * Set up file watchers for fs-triggered collectors.
+ *
+ * Watches the lockfile and entries directory for changes, debounces events,
+ * then re-runs fs-triggered collectors and pushes status to the hub.
+ *
+ * @param ctx - Watcher context with project paths, collectors, and state.
+ * @returns Handles for cleanup (watchers to close, timer to clear).
+ */
+export declare function setupFileWatchers(ctx: FsWatcherContext): FsWatcherHandles;
+export {};

package/dist/watch/watcher-fs.js

@@ -0,0 +1,105 @@
+/**
+ * File-system watcher setup for logbook watch.
+ *
+ * Handles debounced file-system events that trigger collector re-runs.
+ */
+import { watch as fsWatch, existsSync } from 'node:fs';
+import { postToHub } from './watcher-http.js';
+/** Debounce interval for file watcher events (500ms). */
+const DEBOUNCE_MS = 500;
+/**
+ * Set up file watchers for fs-triggered collectors.
+ *
+ * Watches the lockfile and entries directory for changes, debounces events,
+ * then re-runs fs-triggered collectors and pushes status to the hub.
+ *
+ * @param ctx - Watcher context with project paths, collectors, and state.
+ * @returns Handles for cleanup (watchers to close, timer to clear).
+ */
+export function setupFileWatchers(ctx) {
+    const { cwd, port, entriesDir, lockfilePath, activeCollectors, state, pushStatus } = ctx;
+    const fsWatchers = [];
+    let debounceTimer = null;
+    let lastKnownLog = state.latestLog;
+    const debouncedCollectAndPush = (reason) => {
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(async () => {
+            // Run all fs-triggered collectors.
+            for (const c of activeCollectors.filter((c) => c.schedule.type === 'fs')) {
+                await c.collect(cwd, state);
+            }
+            // If latestLog changed, emit an activity event for the timeline.
+            if (state.latestLog && state.latestLog !== lastKnownLog) {
+                lastKnownLog = state.latestLog;
+                const event = {
+                    projectPath: cwd,
+                    timestamp: state.latestLogTimestamp ?? new Date().toISOString(),
+                    description: state.latestLog,
+                    source: 'logbook log',
+                };
+                try {
+                    await postToHub(port, '/_logbook/event', event);
+                }
+                catch {
+                    // Hub may have died.
+                }
+            }
+            try {
+                await pushStatus(reason);
+            }
+            catch {
+                // Hub may have died.
+            }
+        }, DEBOUNCE_MS);
+    };
+    // Watch the lockfile if it exists.
+    try {
+        if (existsSync(lockfilePath)) {
+            const w = fsWatch(lockfilePath, () => {
+                debouncedCollectAndPush('Lockfile changed — ticket started or released');
+            });
+            fsWatchers.push(w);
+        }
+        const cwdWatcher = fsWatch(cwd, (_, filename) => {
+            if (filename === '.logbook-active') {
+                debouncedCollectAndPush('Lockfile created or removed — ticket state changed');
+            }
+        });
+        fsWatchers.push(cwdWatcher);
+    }
+    catch {
+        // fs.watch not supported — fall back to polling only.
+    }
+    // Watch the entries directory recursively.
+    try {
+        if (existsSync(entriesDir)) {
+            const w = fsWatch(entriesDir, { recursive: true }, (_, filename) => {
+                if (!filename)
+                    return;
+                if (filename.endsWith('log.md')) {
+                    debouncedCollectAndPush(`Log updated: ${filename}`);
+                }
+                else if (filename.endsWith('index.md')) {
+                    debouncedCollectAndPush(`Narrative updated: ${filename}`);
+                }
+                else if (filename.endsWith('ticket.md')) {
+                    debouncedCollectAndPush(`Ticket updated: ${filename}`);
+                }
+            });
+            fsWatchers.push(w);
+        }
+    }
+    catch {
+        // Recursive watch not supported.
+    }
+    return {
+        watchers: fsWatchers,
+        getDebounceTimer: () => debounceTimer,
+        clearDebounce: () => {
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+        },
+    };
+}
+//# sourceMappingURL=watcher-fs.js.map

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

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

package/dist/watch/watcher-http.d.ts

@@ -0,0 +1,19 @@
+/**
+ * HTTP utilities for the logbook watcher.
+ *
+ * Provides the hub communication helper and terminal logging timestamp.
+ */
+/**
+ * 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 declare function postToHub(port: number, path: string, data: unknown): Promise<void>;
+/**
+ * Format a short timestamp for terminal logging (HH:MM:SS).
+ *
+ * @returns Formatted time string.
+ */
+export declare function logTime(): string;