project-logbook 0.3.4 → 0.4.1

package/dist/lib/template-helpers.js

@@ -1,6 +1,7 @@
 import { linkJiraIds } from './jira-helpers.js';
 import { formatAbsoluteDate } from '../utils/date.js';
 import { escapeHtml } from './html-escape.js';
+import { getCommitUrl, getTagUrl } from './git-helpers.js';
 import { ATTR_ENTRY_SLUG, ATTR_DATA_DATE, CLASS_COMMIT_SHA, CLASS_COMMIT_TIME, CLASS_COMMIT_MESSAGE, } from './html-attributes.js';
 export const html = (strings, ...values) => {
     return strings.reduce((acc, str, i) => acc + str + (values[i] ?? ''), '');
@@ -27,7 +28,7 @@ export const renderTagsAndWorkspaces = (tags, workspaces) => {
     return html `<div class="tags-wrapper">${tagsHtml}${wsHtml}</div>`;
 };
 // Renders a compact list of git commits to embed in the Technical Log tab.
-export const renderCommits = (commits) => {
+export const renderCommits = (commits, repositoryUrl) => {
     if (!commits || commits.length === 0)
         return '';
     const rows = commits
@@ -35,7 +36,11 @@ export const renderCommits = (commits) => {
         const formatted = formatAbsoluteDate(c.timestamp);
         const sha = escapeHtml(c.sha);
         const message = escapeHtml(c.message);
-        return `<div class="commit-item"><span class="${CLASS_COMMIT_SHA}">${sha}</span><span class="${CLASS_COMMIT_MESSAGE}">${message}</span><span class="${CLASS_COMMIT_TIME}" title="${c.timestamp}" ${ATTR_DATA_DATE}="${c.timestamp}">${formatted}</span></div>`;
+        const commitUrl = getCommitUrl(repositoryUrl, c.sha);
+        const shaHtml = commitUrl
+            ? `<a href="${escapeHtml(commitUrl)}" class="${CLASS_COMMIT_SHA}" target="_blank" rel="noopener noreferrer">${sha}</a>`
+            : `<span class="${CLASS_COMMIT_SHA}">${sha}</span>`;
+        return `<div class="commit-item">${shaHtml}<span class="${CLASS_COMMIT_MESSAGE}">${message}</span><span class="${CLASS_COMMIT_TIME}" title="${c.timestamp}" ${ATTR_DATA_DATE}="${c.timestamp}">${formatted}</span></div>`;
     })
         .join('');
     return `<div class="commit-list"><h3 class="commit-list-heading">Git Commits</h3>${rows}</div>`;
@@ -64,16 +69,24 @@ export const renderTimelineEntryItem = (e) => {
     >
   </div>`;
 };
-export const renderTimelineCommitItem = (c, jiraBaseUrl, jiraPrefix) => {
+export const renderTimelineCommitItem = (c, jiraBaseUrl, jiraPrefix, repositoryUrl) => {
     const message = jiraBaseUrl && jiraPrefix ? linkJiraIds(c.message, jiraBaseUrl, jiraPrefix) : escapeHtml(c.message);
     const formatted = formatAbsoluteDate(c.timestamp);
     const sha = escapeHtml(c.sha);
-    return `<div class="timeline-item timeline-item--commit"><div class="commit-chip"><span class="${CLASS_COMMIT_SHA}">${sha}</span><span class="${CLASS_COMMIT_MESSAGE}">${message}</span><span class="${CLASS_COMMIT_TIME}" title="${c.timestamp}" ${ATTR_DATA_DATE}="${c.timestamp}">${formatted}</span></div></div>`;
+    const commitUrl = getCommitUrl(repositoryUrl, c.sha);
+    const shaHtml = commitUrl
+        ? `<a href="${escapeHtml(commitUrl)}" class="${CLASS_COMMIT_SHA}" target="_blank" rel="noopener noreferrer">${sha}</a>`
+        : `<span class="${CLASS_COMMIT_SHA}">${sha}</span>`;
+    return `<div class="timeline-item timeline-item--commit"><div class="commit-chip">${shaHtml}<span class="${CLASS_COMMIT_MESSAGE}">${message}</span><span class="${CLASS_COMMIT_TIME}" title="${c.timestamp}" ${ATTR_DATA_DATE}="${c.timestamp}">${formatted}</span></div></div>`;
 };
-export const renderTimelineTagItem = (t) => {
+export const renderTimelineTagItem = (t, repositoryUrl) => {
     const formatted = formatAbsoluteDate(t.timestamp);
     const name = escapeHtml(t.name);
-    return `<div class="timeline-item timeline-item--tag"><div class="tag-chip"><span class="tag-chip-icon">🏷</span><span class="tag-chip-name">${name}</span><span class="tag-chip-date" title="${t.timestamp}" ${ATTR_DATA_DATE}="${t.timestamp}">${formatted}</span></div></div>`;
+    const tagUrl = getTagUrl(repositoryUrl, t.name);
+    const tagHtml = tagUrl
+        ? `<a href="${escapeHtml(tagUrl)}" class="tag-chip-name" target="_blank" rel="noopener noreferrer">${name}</a>`
+        : `<span class="tag-chip-name">${name}</span>`;
+    return `<div class="timeline-item timeline-item--tag"><div class="tag-chip"><span class="tag-chip-icon">🏷</span>${tagHtml}<span class="tag-chip-date" title="${t.timestamp}" ${ATTR_DATA_DATE}="${t.timestamp}">${formatted}</span></div></div>`;
 };
 export const paginationLinks = (currentPage, totalPages) => {
     let links = '';

package/dist/lib/template-types.d.ts

@@ -16,8 +16,10 @@ export interface TimelineTemplateProps {
     groups: TimelineGroup[];
     readmeHtml: string;
     aboutHtml: string;
+    welcomeHtml?: string;
     jiraBaseUrl?: string;
     jiraPrefix?: string;
+    repositoryUrl?: string;
     currentPage?: number;
     totalPages?: number;
 }
@@ -101,6 +103,7 @@ export interface PostTemplateProps {
     commits?: GitCommit[];
     version: string;
     jiraUrl?: string;
+    repositoryUrl?: string;
     prevEntry: EntryLink | null;
     nextEntry: EntryLink | null;
     slug?: string;

package/dist/lib/templates.d.ts

@@ -1,6 +1,6 @@
 import type { TabConfig, TimelineTemplateProps, PostTemplateProps } from './template-types.js';
 export declare const tabsComponent: (tabs: TabConfig[], defaultActive?: number) => string;
-export declare const layout: ({ title, header, content, projectName, basePath, description, bodySlug, buildMeta, }: {
+export declare const layout: ({ title, header, content, projectName, basePath, description, bodySlug, buildMeta, includeRssLink, }: {
     title: string;
     header: string;
     content: string;
@@ -9,8 +9,11 @@ export declare const layout: ({ title, header, content, projectName, basePath, d
     description?: string;
     bodySlug?: string;
     buildMeta?: string;
+    includeRssLink?: boolean;
 }) => string;
-export declare const timelineTemplate: (props: TimelineTemplateProps) => {
+export declare const timelineTemplate: (props: TimelineTemplateProps & {
+    includeRssLink?: boolean;
+}) => {
     header: string;
     content: string;
 };

package/dist/lib/templates.js

@@ -13,39 +13,49 @@ export const tabsComponent = (tabs, defaultActive = 0) => {
     ${sectionsHtml}
   </div>`;
 };
-export const layout = ({ title, header, content, projectName, basePath = './', description, bodySlug, buildMeta, }) => html `<!DOCTYPE html>
+export const layout = ({ title, header, content, projectName, basePath = './', description, bodySlug, buildMeta, includeRssLink = false, }) => html `<!DOCTYPE html>
 <html lang="en">
 <head>
     <meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>${escapeHtml(title)} | ${escapeHtml(projectName)}</title>
     ${description ? `<meta name="description" content="${escapeHtml(description).replace(/"/g, '&quot;').substring(0, 160)}">` : ''}
+    ${includeRssLink ? `<link rel="alternate" type="application/rss+xml" title="Subscribe to Project RSS Feed" href="${basePath}rss.xml">` : ''}
     <link rel="icon" type="image/svg+xml" href="${basePath}favicon.svg">
     <link rel="stylesheet" href="${basePath}style.css">
 </head>
 <body${bodySlug ? ` ${ATTR_PAGE_SLUG}="${bodySlug}"` : ''}>
     ${header}<main>${content}</main>
-    <footer>${buildMeta ? `<p class="build-time">${buildMeta}</p>` : ''}</footer>
+    <footer>
+      ${buildMeta ? `<p class="build-time">${buildMeta}${includeRssLink ? ` • <a href="${basePath}rss.xml">RSS Feed</a>` : ''}</p>` : ''}
+    </footer>
     <script src="${basePath}logbook.js"></script>
 </body></html>`;
 export const timelineTemplate = (props) => {
-    const { projectName, groups, readmeHtml, aboutHtml, jiraBaseUrl, jiraPrefix, currentPage, totalPages } = props;
-    const timelineTab = html `<div class="timeline">
-    ${groups
+    const { projectName, groups, readmeHtml, aboutHtml, welcomeHtml, jiraBaseUrl, jiraPrefix, repositoryUrl, currentPage, totalPages, } = props;
+    const welcomeBannerHtml = welcomeHtml
+        ? `<div id="welcome-banner" class="welcome-banner" style="display:none;">
+         <button id="welcome-banner-close" class="welcome-banner-close" aria-label="Dismiss welcome banner">&times;</button>
+         <div class="welcome-banner-content">${welcomeHtml}</div>
+       </div>`
+        : '';
+    const timelineTab = html `${welcomeBannerHtml}
+    <div class="timeline">
+      ${groups
         .map((g) => html `<section class="month-group">
-            <h2>${g.month}</h2>
-            ${g.items
+              <h2>${g.month}</h2>
+              ${g.items
         .map((item) => {
         if (item.kind === 'entry')
             return renderTimelineEntryItem(item);
         if (item.kind === 'tag')
-            return renderTimelineTagItem(item);
-        return renderTimelineCommitItem(item, jiraBaseUrl, jiraPrefix);
+            return renderTimelineTagItem(item, repositoryUrl);
+        return renderTimelineCommitItem(item, jiraBaseUrl, jiraPrefix, repositoryUrl);
     })
         .join('')}
-          </section>`)
+            </section>`)
         .join('')}
-    ${paginationLinks(currentPage, totalPages)}
-  </div>`;
+      ${paginationLinks(currentPage, totalPages)}
+    </div>`;
     const header = html `<header>
     <h1><a href="./index.html">${escapeHtml(projectName)}</a></h1>
     <p class="tagline">A brief summary of the recent changes to the project.</p>
@@ -58,7 +68,7 @@ export const timelineTemplate = (props) => {
     return { header, content };
 };
 export const postTemplate = (props) => {
-    const { title, displayDate, dateStart, harness, llm, prompter, content, ticketHtml, logHtml, commits, version, jiraUrl, prevEntry, nextEntry, tags, workspaces } = props; // prettier-ignore
+    const { title, displayDate, dateStart, harness, llm, prompter, content, ticketHtml, logHtml, commits, version, jiraUrl, repositoryUrl, prevEntry, nextEntry, tags, workspaces } = props; // prettier-ignore
     // Validate jiraUrl scheme to prevent javascript: URLs
     const validatedJiraUrl = jiraUrl ? validateUrlScheme(jiraUrl) : undefined;
     const jiraBtn = validatedJiraUrl
@@ -89,7 +99,7 @@ export const postTemplate = (props) => {
       </div>
       <div id="spec" class="content-section" role="tabpanel" style="display:none;">${ticketHtml}</div>
       <div id="log" class="content-section" role="tabpanel" style="display:none;">
-        ${logHtml}${renderCommits(commits)}
+        ${logHtml}${renderCommits(commits, repositoryUrl)}
       </div>
     </div>
     <nav class="post-nav">

package/dist/linters/index.js

@@ -6,6 +6,7 @@ import lockfile from './lockfile.js';
 import placeholders from './placeholders.js';
 import projectIntegrity from './project-integrity.js';
 import readability from './readability.js';
+import technicalLog from './technical-log.js';
 import workspaces from './workspaces.js';
 export const linters = [
     diffToNarrative,
@@ -16,5 +17,6 @@ export const linters = [
     placeholders,
     projectIntegrity,
     readability,
+    technicalLog,
     workspaces,
 ];

package/dist/linters/technical-log.d.ts

@@ -0,0 +1,7 @@
+import type { Linter } from '../lib/lint-types.js';
+/**
+ * Linter that checks for adequate technical logging.
+ * Ensures log.md has more than just the initial "Started investigation" entry.
+ */
+declare const technicalLog: Linter;
+export default technicalLog;

package/dist/linters/technical-log.js

@@ -0,0 +1,72 @@
+import fs from 'fs-extra';
+import { join } from 'node:path';
+/**
+ * Linter that checks for adequate technical logging.
+ * Ensures log.md has more than just the initial "Started investigation" entry.
+ */
+const technicalLog = {
+    name: 'technical-log',
+    description: 'Checks for adequate technical logging in log.md',
+    async check(context) {
+        const issues = [];
+        // Only check the active entry (the one with the lockfile)
+        // Old entries cannot be updated, so we don't warn about them
+        if (!context.entryName || !context.entryPath) {
+            return issues;
+        }
+        // Check if this is the active entry by verifying lockfile exists
+        const lockfilePath = join(process.cwd(), '.logbook-active');
+        if (!(await fs.pathExists(lockfilePath))) {
+            // No active entry, skip this linter
+            return issues;
+        }
+        const lockfileContent = await fs.readFile(lockfilePath, 'utf8');
+        const lockfileData = JSON.parse(lockfileContent);
+        const activeEntrySlug = lockfileData.slug;
+        // Only check if this entry matches the active entry slug
+        if (context.entryName !== activeEntrySlug) {
+            return issues;
+        }
+        const logPath = join(context.entryPath, 'log.md');
+        if (!(await fs.pathExists(logPath))) {
+            issues.push({
+                category: 'TECHNICAL_LOG',
+                level: 'warning',
+                message: 'Missing log.md file. Create one to document your technical decisions.',
+            });
+            return issues;
+        }
+        const logContent = await fs.readFile(logPath, 'utf8');
+        // Extract all protocol entries (lines starting with "- " under ## Protocol)
+        const protocolSection = logContent.split('## Protocol')[1];
+        if (!protocolSection) {
+            // No Protocol section found, might be malformed
+            issues.push({
+                category: 'TECHNICAL_LOG',
+                level: 'warning',
+                message: 'log.md missing "## Protocol" section. Add one to structure your log entries.',
+            });
+            return issues;
+        }
+        const lines = protocolSection.split('\n').filter((line) => line.trim().startsWith('- '));
+        const entryCount = lines.length;
+        // Check if there's only the initial "Started investigation" entry
+        if (entryCount <= 1) {
+            issues.push({
+                category: 'TECHNICAL_LOG',
+                level: 'warning',
+                message: 'log.md only contains the initial "Started investigation" entry. Log your work in real-time using `logbook log "<message>"` after each significant step.',
+            });
+        }
+        else if (entryCount < 5) {
+            // Less than 5 entries might indicate insufficient logging
+            issues.push({
+                category: 'TECHNICAL_LOG',
+                level: 'warning',
+                message: `log.md has only ${entryCount} entries. Consider adding more detail about your implementation process, decisions, and challenges.`,
+            });
+        }
+        return issues;
+    },
+};
+export default technicalLog;

package/dist/templates/WELCOME.md

@@ -0,0 +1,12 @@
+# Welcome to the Project Logbook!
+
+This website is a **Project Logbook** — a chronological timeline of this project's evolution, design decisions, and development history.
+
+Unlike traditional static documentation, a logbook behaves like a **dev log** or **news feed** of the codebase. Each item in the timeline below represents a completed feature or bugfix, containing:
+- **Original Specifications:** The initial requirements and user stories.
+- **Technical Log:** Step-by-step notes and decisions made during development.
+- **The Story:** An engaging narrative explaining the rationale, pivots, and solutions.
+
+Click around to explore how this project was built step by step!
+
+Wait, did we mention it has an [**RSS Feed**](rss.xml)? Yes, you can subscribe to stay updated on new logbook entries in real-time!

package/dist/templates/index.md

@@ -21,6 +21,10 @@ dateEnd: "[DATE_END]"
 ## Summary
 TODO: Write a polished, highly readable ticket summary that reads like an engaging technical narrative (similar to a well-written dev blog post).
 
+### Before You Start:
+- **Check `log.md`**: Review your technical log for all the decisions, errors, and pivots you recorded during implementation.
+- **Reference the log**: Use your real-time log entries as source material for the narrative — don't try to reconstruct from memory.
+
 ### Formatting & Style Rules:
 - **Maintain the narrative tone:** TODO: Keep the storytelling flair (e.g., describing how problems accumulated or how gaps surfaced), but stay strictly factual based on the provided changes.
 - **Add thematic headings:** TODO: Break the narrative down into logical chapters using Markdown headings (e.g., ### The Friction Points, ### The Fix, ### Closing the Gap).

package/dist/templates/log.md

@@ -1,4 +1,9 @@
 # Technical Log: {{id}}-{{slug}}
 
+> **REMINDER**: Log your work in real-time using `logbook log "<message>"`. Don't wait until the end!
+> 
+> Log after every significant step: investigation, errors, decisions, code changes, test runs, etc.
+>
+
 ## Protocol
 - {{fullIso}}: Started investigation.

package/dist/templates/logbook-client.js

@@ -168,6 +168,32 @@
     }
   }
 
+  /* ── 4. Welcome banner functionality ────────────────────────────────────── */
+  function initWelcomeBanner() {
+    var banner = document.getElementById('welcome-banner');
+    if (!banner) return;
+    try {
+      if (localStorage.getItem('welcome-banner-dismissed') !== 'true') {
+        banner.style.display = 'block';
+      }
+    } catch (e) {
+      // In case localStorage is disabled/unavailable, default to showing
+      banner.style.display = 'block';
+    }
+
+    var closeBtn = document.getElementById('welcome-banner-close');
+    if (closeBtn) {
+      closeBtn.addEventListener('click', function () {
+        banner.style.display = 'none';
+        try {
+          localStorage.setItem('welcome-banner-dismissed', 'true');
+        } catch (e) {
+          /* localStorage unavailable */
+        }
+      });
+    }
+  }
+
   /* ── Bootstrap ─────────────────────────────────────────────────────────── */
   document.addEventListener('DOMContentLoaded', function () {
     updateRelativeDates();
@@ -181,6 +207,9 @@
 
     // Initialize tab functionality
     initTabs();
+
+    // Initialize welcome banner if present
+    initWelcomeBanner();
   });
 
   // Expose showTab globally for onclick handlers

package/dist/templates/steer.txt

@@ -8,11 +8,27 @@ Phase 1: Understand
 2. Review `AGENTS.md` and `CONTRIBUTING.md` if you need architectural or workflow context.
 
 Phase 2: Execute & Trace
-1. Use `log.md` as a live technical scratchpad.
-2. Log your work in real-time using the `logbook log "<message>"` command. Record every major decision, error, and pivot. Do not reconstruct this at the end.
-   Example: logbook log "Investigated root cause — found issue in src/lib/config.ts"
-   One message per call. For multiple entries, call the command once per message.
-3. Stick to the active entry; never modify past entries in the logbook folder.
+
+**CRITICAL: Real-Time Logging**
+You MUST log your work continuously using `logbook log "<message>"`. This is not optional.
+
+1. Use `log.md` as your live technical scratchpad.
+2. After EVERY significant step, run: `logbook log "<what you just did>"`
+   - Investigated a file? Log it.
+   - Found an error? Log it.
+   - Made a design decision? Log it.
+   - Fixed a bug? Log it.
+   - Ran tests? Log the result.
+   
+   Examples:
+   - `logbook log "Investigated src/lib/config.ts - found missing validation"`
+   - `logbook log "Created new RSS module with generateRssFeed() function"`
+   - `logbook log "Test failed: TypeScript error on line 42 - fixed type assertion"`
+   - `logbook log "All 127 tests pass, pre-commit suite successful"`
+
+3. **One message per command call.** For multiple entries, call the command multiple times.
+4. Do NOT reconstruct the log at the end. If the log is empty when you finish, you did it wrong.
+5. Stick to the active entry; never modify past entries in the logbook folder.
 
 Phase 3: Synthesize
 1. When implementation is finished, write the narrative in `index.md`.

package/dist/templates/styles.css

@@ -696,3 +696,185 @@ article img[src$='.webp'],
 article img[src$='.svg'] {
   box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
 }
+
+/* Technical Log Timeline */
+#log .timeline {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  position: relative;
+}
+
+#log .timeline::before {
+  content: '';
+  position: absolute;
+  left: 8px;
+  top: 0;
+  bottom: 0;
+  width: 2px;
+  background: var(--border);
+}
+
+#log .timeline-entry {
+  position: relative;
+  padding-left: 2rem;
+  margin-bottom: 0.75rem;
+  min-height: 1.5rem;
+  display: grid;
+  grid-template-columns: 55px 1fr;
+  gap: 0.5rem;
+}
+
+#log .timeline-entry.no-time .timeline-message {
+  grid-column: 2;
+}
+
+#log .timeline-entry.has-time::before {
+  content: '';
+  position: absolute;
+  left: 5px;
+  top: 4px;
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--primary);
+  border: 2px solid var(--bg);
+  z-index: 1;
+}
+
+#log .timeline-entry.no-time::before {
+  content: '';
+  position: absolute;
+  left: 7px;
+  top: 0.6rem;
+  width: 4px;
+  height: 4px;
+  border-radius: 50%;
+  background: var(--text-muted);
+  opacity: 0.6;
+}
+
+#log .timeline-time {
+  font-family: ui-monospace, 'Cascadia Code', 'Source Code Pro', Menlo, Consolas, monospace;
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: var(--primary);
+  display: inline-block;
+}
+
+#log .timeline-message {
+  font-size: 0.9375rem;
+  color: var(--text);
+  line-height: 1.5;
+}
+
+#log .timeline-entry.no-time .timeline-message {
+  color: var(--text);
+  opacity: 0.85;
+}
+
+#log .timeline-gap {
+  position: relative;
+  padding-left: 2rem;
+  margin: 1.5rem 0;
+  min-height: 1rem;
+}
+
+#log .timeline-gap::before {
+  content: '';
+  position: absolute;
+  left: 7px;
+  top: 0.4rem;
+  width: 4px;
+  height: 4px;
+  border-radius: 50%;
+  background: var(--text-muted);
+  opacity: 0.5;
+}
+
+#log .gap-indicator {
+  font-size: 0.8125rem;
+  color: var(--text-muted);
+  font-style: italic;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+}
+
+#log .log-fallback {
+  font-size: 0.9375rem;
+  color: var(--text);
+  line-height: 1.6;
+  white-space: pre-wrap;
+  background: var(--primary-soft);
+  padding: 1rem;
+  border-radius: 0.5rem;
+  font-family: ui-monospace, 'Cascadia Code', 'Source Code Pro', Menlo, Consolas, monospace;
+  font-size: 0.8125rem;
+}
+
+/* Welcome Banner */
+.welcome-banner {
+  background: var(--bg-card, #ffffff);
+  border: 1px solid var(--border, #e2e8f0);
+  padding: 1.5rem;
+  border-radius: 0.5rem;
+  margin-top: 1.5rem;
+  margin-bottom: 2rem;
+  position: relative;
+  box-shadow:
+    0 1px 3px 0 rgba(0, 0, 0, 0.1),
+    0 1px 2px -1px rgba(0, 0, 0, 0.1);
+}
+
+.welcome-banner-content h1 {
+  font-size: 1.25rem;
+  margin-top: 0;
+  margin-bottom: 0.75rem;
+  color: var(--text-main, #1e293b);
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.welcome-banner-content p {
+  margin: 0 0 0.75rem 0;
+  line-height: 1.5;
+  color: var(--text, #334155);
+}
+
+.welcome-banner-content ul {
+  margin: 0 0 1rem 0;
+  padding-left: 1.25rem;
+  color: var(--text, #334155);
+}
+
+.welcome-banner-content li {
+  margin-bottom: 0.5rem;
+  line-height: 1.4;
+}
+
+.welcome-banner-close {
+  position: absolute;
+  top: 1rem;
+  right: 1rem;
+  background: none;
+  border: none;
+  font-size: 1.25rem;
+  cursor: pointer;
+  color: var(--text-muted, #64748b);
+  line-height: 1;
+  padding: 0.25rem;
+  border-radius: 0.25rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition:
+    background-color 0.2s,
+    color 0.2s;
+}
+
+.welcome-banner-close:hover {
+  background-color: var(--primary-soft, #f0fdf4);
+  color: var(--text-main, #1e293b);
+}

package/dist/utils/date.d.ts

@@ -28,3 +28,10 @@ export declare function getSortTime(dateStart: string | Date, dateEnd?: string |
  * Alias for formatAbsoluteDate for clarity in build context.
  */
 export declare function formatDateTimeForDisplay(date: string | Date): string;
+/**
+ * Format a date for RSS feed pubDate element.
+ * RSS requires RFC 822 date format: "Mon, 26 May 2026 10:51:00 GMT"
+ * @param date - The date to format
+ * @returns RFC 822 formatted date string
+ */
+export declare function formatDateTimeForRss(date: string | Date): string;

package/dist/utils/date.js

@@ -86,3 +86,15 @@ export function getSortTime(dateStart, dateEnd) {
 export function formatDateTimeForDisplay(date) {
     return formatAbsoluteDate(date);
 }
+/**
+ * Format a date for RSS feed pubDate element.
+ * RSS requires RFC 822 date format: "Mon, 26 May 2026 10:51:00 GMT"
+ * @param date - The date to format
+ * @returns RFC 822 formatted date string
+ */
+export function formatDateTimeForRss(date) {
+    const d = parseDate(date);
+    if (!d)
+        return new Date().toUTCString();
+    return d.toUTCString();
+}