project-logbook 0.3.0

package/dist/templates/styles.css

@@ -0,0 +1,641 @@
+* {
+  box-sizing: border-box;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Inter', 'Segoe UI', Roboto, sans-serif;
+  line-height: 1.6;
+  color: var(--text);
+  background: var(--bg);
+  margin: 0;
+  padding: 0;
+}
+
+header {
+  background: var(--card-bg);
+  border-bottom: 1px solid var(--border);
+  padding: 2rem 1rem;
+  text-align: center;
+}
+
+header h1 {
+  margin: 0;
+  font-size: 2.25rem;
+  font-weight: 800;
+  letter-spacing: -0.025em;
+}
+
+.tagline {
+  color: var(--text-muted);
+  font-size: 1.125rem;
+  margin-top: 0.5rem;
+}
+
+main {
+  max-width: var(--max-width);
+  margin: 2rem auto;
+  padding: 0 1.5rem;
+}
+
+/* Timeline */
+.timeline {
+  position: relative;
+}
+
+.month-group {
+  margin-bottom: 3rem;
+}
+
+.month-group h2 {
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+  color: var(--text-muted);
+  margin-bottom: 1.5rem;
+  display: flex;
+  align-items: center;
+}
+
+.month-group h2::after {
+  content: '';
+  flex: 1;
+  height: 1px;
+  background: var(--border);
+  margin-left: 1rem;
+}
+
+.timeline-item {
+  position: relative;
+  padding-left: 2rem;
+  padding-bottom: 3.5rem;
+  border-left: 1px solid #cccccc;
+}
+
+.timeline-item:last-child {
+  border-left: 1px solid transparent;
+}
+
+.timeline-item::before {
+  content: '';
+  position: absolute;
+  left: calc(-7px);
+  top: 0.75em;
+  width: 9px;
+  height: 9px;
+  border-radius: 50%;
+  background: var(--bg);
+  border: 2px solid var(--primary);
+}
+
+.item-meta {
+  font-size: 0.8125rem;
+  color: var(--text-muted);
+  margin-bottom: 0.25rem;
+}
+
+.timeline-card {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  text-decoration: none;
+  color: inherit;
+  border-radius: 8px;
+  transition: background 0.2s;
+  margin: -0.5rem -0.75rem;
+  padding: 0.5rem 0.75rem;
+}
+
+.timeline-card:hover {
+  background: var(--primary-soft);
+}
+
+.item-content {
+  flex: 1;
+}
+
+.item-title {
+  margin: 0 0 0.5rem 0;
+  font-size: 1.25rem;
+  font-weight: 600;
+  color: var(--text);
+  transition: color 0.2s;
+}
+
+.timeline-card:hover .item-title {
+  color: var(--primary);
+}
+
+.item-summary {
+  font-size: 0.9375rem;
+  color: var(--text-muted);
+  display: -webkit-box;
+  -webkit-line-clamp: 3;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+.item-arrow {
+  font-size: 2.8rem;
+  color: var(--primary);
+  opacity: 1;
+  flex-shrink: 0;
+  transition: transform 0.2s;
+  line-height: 1;
+  user-select: none;
+}
+
+.timeline-card:hover .item-arrow {
+  transform: translateX(4px);
+}
+
+/* Post Page */
+.back-link {
+  display: inline-flex;
+  align-items: center;
+  font-size: 0.8125rem;
+  font-weight: 500;
+  color: var(--primary);
+  text-decoration: none;
+  transition:
+    color 0.2s,
+    background 0.2s;
+  background: var(--primary-soft);
+  padding: 0.5rem 1rem;
+  border-radius: 2rem;
+}
+
+.back-link:hover {
+  background: var(--primary);
+  color: white;
+}
+
+/* Action bar - Back button + tabs on same line */
+.action-bar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  margin-bottom: 3rem;
+  flex-wrap: wrap;
+}
+
+.action-tabs-wrapper {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  flex-wrap: wrap;
+}
+
+.jira-link-btn {
+  display: inline-flex;
+  align-items: center;
+  font-size: 0.8125rem;
+  font-weight: 500;
+  color: var(--primary);
+  text-decoration: none;
+  transition:
+    color 0.2s,
+    background 0.2s;
+  background: var(--primary-soft);
+  padding: 0.5rem 1rem;
+  border-radius: 2rem;
+}
+
+.jira-link-btn:hover {
+  background: var(--primary);
+  color: white;
+}
+
+/* Jira link in build-meta - inline style */
+.build-meta .jira-link-btn {
+  margin-left: 0.5rem;
+  background: var(--primary-soft);
+  border-radius: 2rem;
+  padding: 0.25rem 0.75rem;
+  font-size: 0.8125rem;
+}
+
+.build-meta .jira-link-btn:hover {
+  background: var(--primary);
+  color: white;
+}
+
+article h1 {
+  font-size: 3rem;
+  font-weight: 800;
+  margin-bottom: 0.75rem;
+  letter-spacing: -0.03em;
+  line-height: 1.1;
+}
+
+.article-meta {
+  font-size: 0.875rem;
+  color: var(--text-muted);
+  margin-bottom: 3rem;
+  display: flex;
+  gap: 0.75rem;
+  align-items: center;
+}
+
+.article-meta::before {
+  content: '';
+  width: 2rem;
+  height: 1px;
+  background: var(--border);
+}
+
+.tabs {
+  display: flex;
+  gap: 0.5rem;
+  background: #f4f4f4;
+  padding: 0.25rem;
+  border-radius: 0.75rem;
+  width: fit-content;
+}
+
+.tab {
+  padding: 0.625rem 1.25rem;
+  font-size: 0.8125rem;
+  font-weight: 600;
+  color: var(--text-muted);
+  cursor: pointer;
+  border-radius: 0.5rem;
+  transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+.tab:hover {
+  color: var(--text);
+}
+
+.tab.active {
+  color: var(--primary);
+  background: white;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.05);
+}
+
+.content-section {
+  animation: fadeIn 0.4s cubic-bezier(0.4, 0, 0.2, 1);
+  font-size: 1.125rem;
+  line-height: 1.7;
+}
+
+.content-section h2 {
+  font-size: 1.5rem;
+  font-weight: 700;
+  margin-top: 2.5rem;
+  margin-bottom: 1rem;
+}
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(15px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+/* Typography */
+pre {
+  background: #1a1a1a;
+  color: #e0e0e0;
+  padding: 1.5rem;
+  border-radius: 0.75rem;
+  overflow-x: auto;
+  font-size: 0.875rem;
+  margin: 2rem 0;
+}
+
+code {
+  font-family: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  background: #f4f4f4;
+  padding: 0.2rem 0.4rem;
+  border-radius: 0.25rem;
+}
+
+pre code {
+  background: transparent;
+  padding: 0;
+}
+
+/* NEW badge on timeline */
+.new-badge {
+  display: none;
+  background: var(--primary);
+  color: white;
+  font-size: 0.625rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  padding: 0.15rem 0.45rem;
+  border-radius: 0.25rem;
+  vertical-align: middle;
+  margin-right: 0.5rem;
+  line-height: 1.6;
+}
+
+/* Prev / Next navigation */
+.post-nav {
+  display: flex;
+  justify-content: space-between;
+  gap: 1rem;
+  margin-top: 4rem;
+  padding-top: 2rem;
+  border-top: 1px solid var(--border);
+}
+
+.post-nav-prev,
+.post-nav-next {
+  flex: 1;
+}
+
+.post-nav-next {
+  text-align: right;
+}
+
+.post-nav-link {
+  display: inline-flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  text-decoration: none;
+  color: inherit;
+  transition: color 0.2s;
+}
+
+.post-nav-link:hover {
+  color: var(--primary);
+}
+
+.post-nav-label {
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: var(--text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.post-nav-title {
+  font-size: 0.9375rem;
+  font-weight: 500;
+}
+
+footer {
+  margin-top: 8rem;
+  padding: 4rem 1rem;
+  text-align: center;
+  border-top: 1px solid var(--border);
+  font-size: 0.8125rem;
+  color: var(--text-muted);
+  letter-spacing: 0.05em;
+  text-transform: uppercase;
+}
+
+footer .build-time {
+  margin: 0 0 0.5rem 0;
+  font-size: 0.875rem;
+}
+
+footer .build-time a {
+  color: var(--text-muted);
+}
+
+footer .build-time a:hover {
+  color: var(--primary);
+}
+
+/* Tag badges */
+.tags-wrapper {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  margin-top: 0.75rem;
+}
+
+.tag-badge {
+  display: inline-flex;
+  align-items: center;
+  font-size: 0.75rem;
+  font-weight: 600;
+  padding: 0.25rem 0.625rem;
+  border-radius: 0.375rem;
+  transition: opacity 0.2s;
+}
+
+.tag-badge:hover {
+  opacity: 0.85;
+}
+
+.tag-feature {
+  background: #dcfce7;
+  color: #166534;
+}
+
+.tag-bugfix {
+  background: #fee2e2;
+  color: #991b1b;
+}
+
+.tag-refactor {
+  background: #fef3c7;
+  color: #92400e;
+}
+
+.tag-workspace {
+  background: #e5e7eb;
+  color: #374151;
+}
+
+/* Timeline card tag styling */
+.timeline-card .tags-wrapper {
+  margin-top: 0.5rem;
+}
+
+.timeline-card:hover .tag-badge {
+  opacity: 0.75;
+}
+
+/* Detail view tags above story content */
+.content-section > .tags-wrapper:first-child {
+  margin-top: 0;
+  margin-bottom: 1.5rem;
+}
+
+/* Git commit list in Technical Log tab */
+.commit-list {
+  margin-top: 2rem;
+  border-top: 1px solid var(--border);
+  padding-top: 1.5rem;
+}
+
+.commit-list-heading {
+  font-size: 0.8125rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.07em;
+  color: var(--text-muted);
+  margin: 0 0 0.75rem 0;
+}
+
+.commit-item {
+  display: flex;
+  align-items: baseline;
+  gap: 0.625rem;
+  padding: 0.4rem 0;
+  border-bottom: 1px solid var(--border);
+  font-size: 0.875rem;
+  line-height: 1.5;
+}
+
+.commit-item:last-child {
+  border-bottom: none;
+}
+
+.commit-sha {
+  font-family: ui-monospace, 'Cascadia Code', 'Source Code Pro', Menlo, Consolas, monospace;
+  font-size: 0.8125rem;
+  color: var(--primary);
+  background: color-mix(in srgb, var(--primary) 5%, transparent);
+  padding: 0.125rem 0.375rem;
+  border-radius: 0.25rem;
+  white-space: nowrap;
+  flex-shrink: 0;
+}
+
+.commit-message {
+  flex: 1;
+  color: var(--text);
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.commit-time {
+  font-size: 0.8125rem;
+  color: var(--text-muted);
+  white-space: nowrap;
+  flex-shrink: 0;
+}
+
+/* Standalone git tag items in the timeline (non-clickable) */
+.timeline-item--tag {
+  padding-bottom: 3.5rem;
+}
+
+.timeline-item--tag:has(+ .timeline-item--tag),
+.timeline-item--tag:has(+ .timeline-item--commit) {
+  padding-bottom: 1rem;
+}
+
+.timeline-item--tag::before {
+  border-color: var(--text-muted);
+  width: 7px;
+  height: 7px;
+  border-width: 2px;
+  left: calc(-6px);
+  top: 0.5rem;
+}
+
+.tag-chip {
+  display: inline-flex;
+  align-items: baseline;
+  gap: 0.375rem;
+  font-size: 0.8125rem;
+  line-height: 1.4;
+  padding: 0.25rem 0.625rem;
+  border-radius: 0.375rem;
+  background: color-mix(in srgb, var(--primary) 8%, transparent);
+  border: 1px solid color-mix(in srgb, var(--primary) 20%, transparent);
+  width: fit-content;
+  max-width: 100%;
+}
+
+.tag-chip-icon {
+  flex-shrink: 0;
+  font-style: normal;
+}
+
+.tag-chip-name {
+  font-weight: 600;
+  color: var(--primary);
+  white-space: nowrap;
+}
+
+.tag-chip-date {
+  font-size: 0.75rem;
+  color: var(--text-muted);
+  white-space: nowrap;
+  flex-shrink: 0;
+}
+
+/* Standalone git commit items in the timeline (non-clickable) */
+.timeline-item--commit {
+  padding-bottom: 3.5rem;
+}
+
+.timeline-item--commit:has(+ .timeline-item--commit),
+.timeline-item--commit:has(+ .timeline-item--tag) {
+  padding-bottom: 0.5rem;
+}
+
+.timeline-item--commit::before {
+  border-color: var(--text-muted);
+  width: 7px;
+  height: 7px;
+  border-width: 2px;
+  left: calc(-6px);
+  top: 0.4rem;
+}
+
+.commit-chip {
+  display: flex;
+  align-items: baseline;
+  gap: 0.5rem;
+  font-size: 0.8125rem;
+  line-height: 1.4;
+  color: var(--text-muted);
+  padding-top: 0.125rem;
+  border-radius: 0.375rem;
+  width: fit-content;
+  max-width: 100%;
+}
+
+.commit-chip .commit-sha {
+  font-size: 0.75rem;
+  flex-shrink: 0;
+}
+
+.commit-chip .commit-message {
+  color: var(--text-muted);
+  font-size: 0.8125rem;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  min-width: 0;
+}
+
+.commit-chip .commit-time {
+  font-size: 0.75rem;
+  flex-shrink: 0;
+}
+
+/* Images */
+article img {
+  max-width: 100%;
+  height: auto;
+  border: 1px solid var(--border);
+  border-radius: 0.5rem;
+  margin: 1.5rem 0;
+  display: block;
+}
+
+article img[src$='.png'],
+article img[src$='.jpg'],
+article img[src$='.jpeg'],
+article img[src$='.gif'],
+article img[src$='.webp'],
+article img[src$='.svg'] {
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+}

package/dist/templates/ticket.md

@@ -0,0 +1,4 @@
+# Ticket {{id}}: {{title}}
+
+## Requirements
+(Paste Jira/Linear issue description here)

package/dist/utils/date.d.ts

@@ -0,0 +1,8 @@
+/** Format a date value as a relative time string (e.g., "today, May 16, 2026"). */
+export declare function formatRelativeDate(date: string | Date): string;
+/** Format a date value as YYYY-MM-DD. */
+export declare function formatIsoDate(value: string | Date): string;
+/** Get "Month Year" string for a date (e.g., "May 2026"). */
+export declare function getMonthYear(date: string | Date): string;
+/** Get a short "HH:mmh" string for sorting/display based on dateEnd or dateStart. */
+export declare function getSortTime(dateStart: string | Date, dateEnd?: string | Date): string;

package/dist/utils/date.js

@@ -0,0 +1,47 @@
+/** Format a date value as a relative time string (e.g., "today, May 16, 2026"). */
+export function formatRelativeDate(date) {
+    const d = new Date(date);
+    if (isNaN(d.getTime())) {
+        return 'unknown date';
+    }
+    const now = new Date();
+    const diffTime = Math.abs(now.getTime() - d.getTime());
+    const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
+    const rtf = new Intl.RelativeTimeFormat('en', { numeric: 'auto' });
+    const relative = diffDays === 0 ? 'today' : rtf.format(-diffDays, 'day');
+    const absolute = d.toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric',
+    });
+    return `${relative}, ${absolute}`;
+}
+/** Format a date value as YYYY-MM-DD. */
+export function formatIsoDate(value) {
+    const d = new Date(value);
+    const yyyy = d.getFullYear();
+    const mm = String(d.getMonth() + 1).padStart(2, '0');
+    const dd = String(d.getDate()).padStart(2, '0');
+    return `${yyyy}-${mm}-${dd}`;
+}
+/** Get "Month Year" string for a date (e.g., "May 2026"). */
+export function getMonthYear(date) {
+    const d = new Date(date);
+    if (isNaN(d.getTime()))
+        return 'Unknown Date';
+    return d.toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'long',
+    });
+}
+/** Get a short "HH:mmh" string for sorting/display based on dateEnd or dateStart. */
+export function getSortTime(dateStart, dateEnd) {
+    const dStart = new Date(dateStart);
+    const dEnd = dateEnd ? new Date(dateEnd) : null;
+    const date = dEnd && !isNaN(dEnd.getTime()) ? dEnd : dStart;
+    if (isNaN(date.getTime()))
+        return '--:--h';
+    const hours = date.getHours().toString().padStart(2, '0');
+    const minutes = date.getMinutes().toString().padStart(2, '0');
+    return `${hours}:${minutes}h`;
+}

package/dist/utils/fs.d.ts

@@ -0,0 +1,13 @@
+export interface EntryMeta {
+    slug: string;
+    path: string;
+    indexPath: string;
+    content: string;
+    data: Record<string, unknown>;
+    hasIndex: boolean;
+}
+/**
+ * Reads the logbook directory and returns metadata for all entries.
+ * Filters for directories and parses index.md if it exists.
+ */
+export declare function getLogbookEntries(logbookDir: string): Promise<EntryMeta[]>;