project-logbook 1.1.0 → 1.3.0

package/dist/watch/strategies/narrative-missing.js

@@ -0,0 +1,21 @@
+/**
+ * Narrative Missing — the active ticket's index.md still has unfilled placeholders.
+ */
+export const narrativeMissingCheck = {
+    id: 'narrative-missing',
+    source: 'LOGBOOK',
+    description: "The active ticket's index.md still has unfilled placeholders like [HARNESS] or [LLM].",
+    blockedBy: ['squash-merged', 'released'],
+    check(metrics) {
+        if (metrics.hasNarrativePlaceholders) {
+            return {
+                id: 'narrative-missing',
+                label: 'Narrative Missing',
+                severity: 'warning',
+                detail: 'index.md has unfilled placeholders.',
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=narrative-missing.js.map

package/dist/watch/strategies/narrative-missing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative-missing.js","sourceRoot":"","sources":["../../../src/watch/strategies/narrative-missing.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,EAAE,EAAE,mBAAmB;IACvB,MAAM,EAAE,SAAS;IACjB,WAAW,EAAE,uFAAuF;IACpG,SAAS,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC;IACxC,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;YACrC,OAAO;gBACL,EAAE,EAAE,mBAAmB;gBACvB,KAAK,EAAE,mBAAmB;gBAC1B,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,qCAAqC;aAC9C,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/watch/strategies/no-mr.d.ts

@@ -0,0 +1,5 @@
+import type { StatusStrategy } from './types.js';
+/**
+ * No MR — there is no merge request for the current branch (or mrStatus is "none").
+ */
+export declare const noMrCheck: StatusStrategy;

package/dist/watch/strategies/no-mr.js

@@ -0,0 +1,21 @@
+/**
+ * No MR — there is no merge request for the current branch (or mrStatus is "none").
+ */
+export const noMrCheck = {
+    id: 'no-mr',
+    source: 'GitLab',
+    description: 'No merge request exists for the current branch.',
+    blockedBy: ['squash-merged', 'released'],
+    check(metrics) {
+        if (metrics.mrStatus === 'none' && metrics.isAheadOfRemote) {
+            return {
+                id: 'no-mr',
+                label: 'No MR',
+                severity: 'info',
+                detail: 'No merge request for this branch.',
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=no-mr.js.map

package/dist/watch/strategies/no-mr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-mr.js","sourceRoot":"","sources":["../../../src/watch/strategies/no-mr.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAmB;IACvC,EAAE,EAAE,OAAO;IACX,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,iDAAiD;IAC9D,SAAS,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC;IACxC,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC3D,OAAO;gBACL,EAAE,EAAE,OAAO;gBACX,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,MAAM;gBAChB,MAAM,EAAE,mCAAmC;aAC5C,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/watch/strategies/pipeline-failed.d.ts

@@ -0,0 +1,5 @@
+import type { StatusStrategy } from './types.js';
+/**
+ * Pipeline Failed — the CI pipeline for the current branch has failed.
+ */
+export declare const pipelineFailedCheck: StatusStrategy;

package/dist/watch/strategies/pipeline-failed.js

@@ -0,0 +1,21 @@
+/**
+ * Pipeline Failed — the CI pipeline for the current branch has failed.
+ */
+export const pipelineFailedCheck = {
+    id: 'pipeline-failed',
+    source: 'GitLab',
+    description: 'The CI pipeline for the current branch has failed.',
+    blockedBy: ['squash-merged', 'released'],
+    check(metrics) {
+        if (metrics.pipelineStatus === 'failed' || metrics.pipelineStatus === 'canceled') {
+            return {
+                id: 'pipeline-failed',
+                label: 'Pipeline Failed',
+                severity: 'warning',
+                detail: 'CI pipeline has failed.',
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=pipeline-failed.js.map

package/dist/watch/strategies/pipeline-failed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-failed.js","sourceRoot":"","sources":["../../../src/watch/strategies/pipeline-failed.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,EAAE,EAAE,iBAAiB;IACrB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,oDAAoD;IACjE,SAAS,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC;IACxC,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,cAAc,KAAK,QAAQ,IAAI,OAAO,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YACjF,OAAO;gBACL,EAAE,EAAE,iBAAiB;gBACrB,KAAK,EAAE,iBAAiB;gBACxB,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,yBAAyB;aAClC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/watch/strategies/pipeline-running.d.ts

@@ -0,0 +1,5 @@
+import type { StatusStrategy } from './types.js';
+/**
+ * Pipeline Running — the CI pipeline for the current branch is running or pending.
+ */
+export declare const pipelineRunningCheck: StatusStrategy;

package/dist/watch/strategies/pipeline-running.js

@@ -0,0 +1,21 @@
+/**
+ * Pipeline Running — the CI pipeline for the current branch is running or pending.
+ */
+export const pipelineRunningCheck = {
+    id: 'pipeline-running',
+    source: 'GitLab',
+    description: 'The CI pipeline for the current branch is running or pending.',
+    blockedBy: ['squash-merged', 'released'],
+    check(metrics) {
+        if (metrics.pipelineStatus === 'running' || metrics.pipelineStatus === 'pending') {
+            return {
+                id: 'pipeline-running',
+                label: 'Pipeline Running',
+                severity: 'info',
+                detail: 'CI pipeline is running.',
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=pipeline-running.js.map

package/dist/watch/strategies/pipeline-running.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-running.js","sourceRoot":"","sources":["../../../src/watch/strategies/pipeline-running.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,EAAE,EAAE,kBAAkB;IACtB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,+DAA+D;IAC5E,SAAS,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC;IACxC,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACjF,OAAO;gBACL,EAAE,EAAE,kBAAkB;gBACtB,KAAK,EAAE,kBAAkB;gBACzB,QAAQ,EAAE,MAAM;gBAChB,MAAM,EAAE,yBAAyB;aAClC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/watch/strategies/ready-for-release.d.ts

@@ -0,0 +1,7 @@
+import type { StatusStrategy } from './types.js';
+/**
+ * Ready for Release — the active ticket has no narrative placeholders,
+ * all changes are committed and pushed, the MR is approved, and the
+ * pipeline passed.
+ */
+export declare const readyForReleaseCheck: StatusStrategy;

package/dist/watch/strategies/ready-for-release.js

@@ -0,0 +1,35 @@
+/**
+ * Ready for Release — the active ticket has no narrative placeholders,
+ * all changes are committed and pushed, the MR is approved, and the
+ * pipeline passed.
+ */
+export const readyForReleaseCheck = {
+    id: 'ready-for-release',
+    source: 'LOGBOOK',
+    description: 'All checks pass: narrative written, changes committed and pushed, MR approved, pipeline passed.',
+    blockedBy: [
+        'squash-merged',
+        'released',
+        'unstaged-changes',
+        'ready-to-commit',
+        'ready-to-push',
+        'pipeline-failed',
+        'narrative-missing',
+    ],
+    check(metrics) {
+        if (metrics.hasActiveTicket &&
+            !metrics.hasNarrativePlaceholders &&
+            !metrics.isDirty &&
+            !metrics.isAheadOfRemote &&
+            (metrics.mrStatus === 'approved' || metrics.mrStatus === 'merged')) {
+            return {
+                id: 'ready-for-release',
+                label: 'Ready for Release',
+                severity: 'success',
+                detail: 'All checks pass. Ready to release.',
+            };
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=ready-for-release.js.map

package/dist/watch/strategies/ready-for-release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-for-release.js","sourceRoot":"","sources":["../../../src/watch/strategies/ready-for-release.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,EAAE,EAAE,mBAAmB;IACvB,MAAM,EAAE,SAAS;IACjB,WAAW,EAAE,iGAAiG;IAC9G,SAAS,EAAE;QACT,eAAe;QACf,UAAU;QACV,kBAAkB;QAClB,iBAAiB;QACjB,eAAe;QACf,iBAAiB;QACjB,mBAAmB;KACpB;IACD,KAAK,CAAC,OAAO;QACX,IACE,OAAO,CAAC,eAAe;YACvB,CAAC,OAAO,CAAC,wBAAwB;YACjC,CAAC,OAAO,CAAC,OAAO;YAChB,CAAC,OAAO,CAAC,eAAe;YACxB,CAAC,OAAO,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,EAClE,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,mBAAmB;gBACvB,KAAK,EAAE,mBAAmB;gBAC1B,QAAQ,EAAE,SAAS;gBACnB,MAAM,EAAE,oCAAoC;aAC7C,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { StatusStrategy } from './types.js';
+/**
+ * Ready to Commit — there are staged changes waiting to be committed.
+ */
+export declare const readyToCommitCheck: StatusStrategy;

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