project-logbook 0.3.4 → 0.4.0

package/dist/commands/build.js

@@ -13,6 +13,7 @@ import { getAboutContent } from '../lib/about-content.js';
 import { getPackageVersion } from '../lib/package-version.js';
 import { groupTimelineItems } from '../utils/timeline-helpers.js';
 import { getEntryDisplayId, getEntryDisplayTitle } from '../lib/entry-id.js';
+import { generateRssFeed, validateRssXml } from '../lib/rss.js';
 const version = getPackageVersion();
 export async function build() {
     const config = getConfig();
@@ -53,7 +54,7 @@ export async function build() {
         if (!dateStart || dateStart.includes('{{') || dateStart === '[DATE_START]')
             continue;
         const dateEndValue = data.dateEnd;
-        const dateEnd = typeof dateEndValue === 'string'
+        const dateEnd = typeof dateEndValue === 'string' && dateEndValue !== '[DATE_END]'
             ? dateEndValue
             : dateEndValue instanceof Date
                 ? dateEndValue.toISOString()
@@ -130,8 +131,10 @@ export async function build() {
             aboutHtml,
             jiraBaseUrl: config.jiraBaseUrl,
             jiraPrefix: config.jiraPrefix,
+            repositoryUrl: config.repositoryUrl,
             currentPage,
             totalPages,
+            includeRssLink: currentPage === 1, // Only show RSS link on first page
         }); // prettier-ignore
         const buildMeta = generateBuildMeta(version, buildTime);
         const timelineHtml = layout({
@@ -141,6 +144,7 @@ export async function build() {
             buildMeta,
             header: timelineHeader,
             content: timelineMainContent,
+            includeRssLink: currentPage === 1, // Only show RSS link on first page
         });
         const fileName = currentPage === 1 ? 'index.html' : `index-${currentPage}.html`;
         await fs.writeFile(join(outputDir, fileName), timelineHtml);
@@ -150,5 +154,22 @@ export async function build() {
         version,
         buildTime,
     });
+    // Generate RSS feed
+    const rssConfig = {
+        title: `${config.projectName} - Recent Updates`,
+        description: `Latest logbook entries from ${config.projectName}`,
+        language: 'en',
+        feed_url: `${config.projectName.toLowerCase().replace(/\s+/g, '-')}/rss.xml`,
+        site_url: config.projectName,
+        generator: `Project Logbook CLI v${version}`,
+    };
+    const rssXml = generateRssFeed(timelineEntries, rssConfig);
+    // Basic validation
+    if (!validateRssXml(rssXml)) {
+        console.error(error('Error: Generated RSS feed failed basic validation.'));
+        return;
+    }
+    await fs.writeFile(join(outputDir, 'rss.xml'), rssXml);
+    console.log(neutral(`  Generated RSS feed with ${Math.min(50, timelineEntries.length)} entries`));
     console.log(success(`\nSuccessfully built logbook to ${config.outputDir}/`));
 }

package/dist/commands/lint.js

@@ -1,8 +1,11 @@
 import fs from 'fs-extra';
+import { join } from 'node:path';
 import { error as errorStyle, header, success as successStyle, neutral as neutralStyle } from '../lib/theme.js';
 import { getConfig, getLogbookDirPath } from '../lib/config.js';
 import { runLinters } from '../lib/lint-runner.js';
 import { getLogbookEntries } from '../utils/fs.js';
+import { getActiveEntry } from '../lib/session.js';
+import { getLastLogEntry } from '../utils/log-timeline.js';
 export async function lint() {
     const config = getConfig();
     const logbookDir = getLogbookDirPath(config);
@@ -11,6 +14,21 @@ export async function lint() {
         return;
     }
     let overallSuccess = true;
+    // Show last log entry nudge if an entry is active
+    const active = await getActiveEntry();
+    if (active) {
+        const logPath = join(logbookDir, active.slug, 'log.md');
+        if (await fs.pathExists(logPath)) {
+            const logContent = await fs.readFile(logPath, 'utf8');
+            const lastEntry = getLastLogEntry(logContent);
+            if (lastEntry) {
+                const truncated = lastEntry.message.length > 80 ? lastEntry.message.slice(0, 77) + '...' : lastEntry.message;
+                console.log(header(`Active entry: ${active.slug}`));
+                console.log(`  Last Log: ${lastEntry.isoTimestamp}: ${truncated}`);
+                console.log(neutralStyle(`  → Use 'logbook log "<message>"' if there's anything to add.\n`));
+            }
+        }
+    }
     // 1. Project-level checks
     console.log(header('Checking project integrity...'));
     const projectSuccess = await runLinters({ config });

package/dist/commands/status.js

@@ -1,10 +1,12 @@
 import fs from 'fs-extra';
+import { join } from 'node:path';
 import { getConfig, getLogbookDirPath } from '../lib/config.js';
 import { getLogbookEntries } from '../utils/fs.js';
 import { getActiveEntry } from '../lib/session.js';
 import { parseTicketId } from '../utils/id.js';
 import { error, neutral, highlight, bold, warning } from '../lib/theme.js';
 import { getChangedLOC } from '../lib/git-helpers.js';
+import { getLastLogEntry } from '../utils/log-timeline.js';
 export async function status() {
     const config = getConfig();
     const logbookDir = getLogbookDirPath(config);
@@ -70,9 +72,9 @@ export async function status() {
         const latestTitle = latestEntry.data?.title || latestEntry.slug.replace(/^[A-Za-z]+-\d+-/, '').replace(/-/g, ' ');
         latestText = `${highlight(latestEntry.slug)} - ${latestTitle}`;
     }
-    // Print Active Task section
+    // Print Active Ticket section
     console.log(`\n${bold.underline('Logbook Status')}`);
-    console.log(`\n${bold('Active Task:')}`);
+    console.log(`\n${bold('Active Ticket:')}`);
     if (active) {
         const activeDetail = logbookEntries.find((e) => e.slug === active.slug);
         const activeTitle = activeDetail?.data?.title || active.slug.replace(/^[A-Za-z]+-\d+-/, '').replace(/-/g, ' ');
@@ -85,9 +87,20 @@ export async function status() {
         if (active.prompter) {
             console.log(`  ${bold('Prompter:')}   ${active.prompter}`);
         }
+        // Show last log entry as a nudge to keep logging
+        const logPath = join(logbookDir, active.slug, 'log.md');
+        if (await fs.pathExists(logPath)) {
+            const logContent = await fs.readFile(logPath, 'utf8');
+            const lastEntry = getLastLogEntry(logContent);
+            if (lastEntry) {
+                const truncated = lastEntry.message.length > 80 ? lastEntry.message.slice(0, 77) + '...' : lastEntry.message;
+                console.log(`  ${bold('Last Log:')}   ${lastEntry.isoTimestamp}: ${truncated}`);
+                console.log(`             ${neutral("→ Use 'logbook log \"<message>\"' if there's anything to add.")}`);
+            }
+        }
     }
     else {
-        console.log(`  ${neutral('No active task detected.')}`);
+        console.log(`  ${neutral('No active ticket detected.')}`);
     }
     // Calculate changed LOC
     try {
@@ -108,15 +121,18 @@ export async function status() {
     if (config.jiraPrefix) {
         console.log(`  ${bold('Jira Prefix:')}       ${config.jiraPrefix}`);
     }
+    if (config.repositoryUrl) {
+        console.log(`  ${bold('Repository URL:')}   ${config.repositoryUrl}`);
+    }
     if (config.tags?.allowed) {
         console.log(`  ${bold('Allowed Tags:')}      ${config.tags.allowed.join(', ')}`);
     }
     // Print Stats section
-    console.log(`\n${bold('Stats:')}`);
+    console.log(`\n${bold('Logbook stats:')}`);
     console.log(`  ${bold('Total Entries:')}    ${totalCount}`);
-    console.log(`  ${bold('Active Tasks:')}     ${activeCount}`);
-    console.log(`  ${bold('Completed Done:')}   ${doneCount}`);
-    console.log(`  ${bold('Ticket Drafts:')}    ${draftCount}`);
+    console.log(`  ${bold('Active:')}           ${activeCount}`);
+    console.log(`  ${bold('Done:')}.            ${doneCount}`);
+    console.log(`  ${bold('Drafts:')}           ${draftCount}`);
     console.log(`  ${bold('Latest Entry:')}     ${latestText}`);
     console.log('');
 }

package/dist/lib/build-helpers.js

@@ -3,30 +3,12 @@ import { join, resolve } from 'node:path';
 import matter from 'gray-matter';
 import { layout, postTemplate } from './templates.js';
 import { getGitCommits } from './git-helpers.js';
-import { visitHastElements } from './hast-helpers.js';
-import { createGeneralMarkdownProcessor, createEntryMarkdownProcessor } from './markdown-processors.js';
-import { isExternalUrl, isExternalUrlOrAnchor } from './url-helpers.js';
+import { createGeneralMarkdownProcessor, createEntryMarkdownProcessor, rehypeRewriteMdLinks, } from './markdown-processors.js';
+import { isExternalUrl } from './url-helpers.js';
 import { readFileIfExists, pathExistsOrNull } from '../utils/fs.js';
 import { getEntryFilePaths } from './entry-paths.js';
 import { mdToHtmlWithImages, extractImagePathsFromMarkdown, copyImages, rehypeRewriteImagePaths, } from './image-helpers.js';
-/** Rehype plugin: rewrite relative .md links to /index.html equivalents. */
-const rehypeRewriteMdLinks = () => {
-    return (tree) => {
-        visitHastElements(tree, 'a', (node) => {
-            const href = node.properties?.href;
-            if (typeof href !== 'string')
-                return;
-            if (isExternalUrlOrAnchor(href))
-                return;
-            const mdMatch = href.match(/^(.*?)\.md(#.*)?$/i);
-            if (!mdMatch)
-                return;
-            const base = mdMatch[1];
-            const fragment = mdMatch[2] ?? '';
-            node.properties.href = `${base}/index.html${fragment}`;
-        });
-    };
-};
+import { transformLogToTimeline } from '../utils/log-timeline.js';
 const processor = createGeneralMarkdownProcessor(rehypeRewriteMdLinks);
 const entryProcessor = createEntryMarkdownProcessor(rehypeRewriteMdLinks, rehypeRewriteImagePaths);
 export async function mdToHtml(md) {
@@ -129,16 +111,19 @@ export async function renderPost(data, i, allEntries, ctx) {
     const jiraUrl = ctx.config.jiraBaseUrl && data.ticket ? `${ctx.config.jiraBaseUrl}${data.ticket}` : undefined;
     const prev = i > 0 ? allEntries[i - 1] : null;
     const next = i < allEntries.length - 1 ? allEntries[i + 1] : null;
+    // Transform log to timeline if possible, otherwise fall back to plain markdown
+    const logHtml = logRaw ? await transformLogToTimeline(logRaw) : '';
     const { header: postHeader, content: postMainContent } = postTemplate({
         ...data,
         title: data.title ?? data.slug,
         harness: data.harness ?? '',
         content: storyHtml,
         ticketHtml: ticketRaw ? await mdToHtmlWithImagePathRewrite(ticketRaw) : '',
-        logHtml: logRaw ? await mdToHtmlWithImagePathRewrite(logRaw) : '',
+        logHtml,
         commits,
         version: ctx.version,
         jiraUrl,
+        repositoryUrl: ctx.config.repositoryUrl,
         prevEntry: prev ? { slug: prev.slug, title: prev.title ?? '', ticket: prev.ticket } : null,
         nextEntry: next ? { slug: next.slug, title: next.title ?? '', ticket: next.ticket } : null,
     });

package/dist/lib/config.d.ts

@@ -6,6 +6,7 @@ export interface LogbookConfig {
     primaryColor: string;
     jiraBaseUrl?: string;
     jiraPrefix?: string;
+    repositoryUrl?: string;
     tags?: {
         allowed: string[];
     };

package/dist/lib/config.js

@@ -1,5 +1,6 @@
 import { readFileSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
+import { getGitRemoteUrl, parseRemoteUrlToWebUrl } from './git-helpers.js';
 export function getWorkspaces(cwd = process.cwd()) {
     const pkgPath = join(cwd, 'package.json');
     if (!existsSync(pkgPath))
@@ -26,18 +27,21 @@ export const DEFAULT_CONFIG = {
 };
 export function getConfig(cwd = process.cwd()) {
     const configPath = join(cwd, '.project-logbook');
+    let config = { ...DEFAULT_CONFIG };
     if (existsSync(configPath)) {
         try {
             const userConfig = JSON.parse(readFileSync(configPath, 'utf8'));
-            return { ...DEFAULT_CONFIG, ...userConfig };
+            config = { ...DEFAULT_CONFIG, ...userConfig };
         }
         catch (err) {
             const errorMessage = err instanceof Error ? err.message : String(err);
             console.warn(`Warning: Failed to parse .project-logbook config — using defaults. (${errorMessage})`);
-            return DEFAULT_CONFIG;
         }
     }
-    return DEFAULT_CONFIG;
+    if (!config.repositoryUrl) {
+        config.repositoryUrl = parseRemoteUrlToWebUrl(getGitRemoteUrl(cwd));
+    }
+    return config;
 }
 /**
  * Get the absolute path to the logbook directory.

package/dist/lib/git-helpers.d.ts

@@ -1,4 +1,16 @@
 import type { GitCommit } from './template-types.js';
+/**
+ * Clean the repository URL by removing trailing slashes and .git extensions.
+ */
+export declare function cleanRepositoryUrl(url: string): string;
+/**
+ * Generate a URL to view a specific commit in a web interface (GitHub, GitLab, Bitbucket, etc.).
+ */
+export declare function getCommitUrl(repositoryUrl: string | undefined, sha: string): string | undefined;
+/**
+ * Generate a URL to view a specific tag in a web interface (GitHub, GitLab, Bitbucket, etc.).
+ */
+export declare function getTagUrl(repositoryUrl: string | undefined, tag: string): string | undefined;
 /**
  * Parse the raw output of `git log --pretty=format:"%H|%s|%aI"` into GitCommit objects.
  * Pure function (no I/O) — unit-testable without spawning git.
@@ -22,6 +34,15 @@ export declare function getGitTags(): Promise<{
     name: string;
     timestamp: string;
 }[]>;
+/**
+ * Get the git remote URL for origin.
+ * Synchronous execution — safe to use during synchronous config parsing.
+ */
+export declare function getGitRemoteUrl(cwd?: string): string | undefined;
+/**
+ * Parse a git remote URL (SSH or HTTPS) into a clean web/HTTP(S) repository homepage URL.
+ */
+export declare function parseRemoteUrlToWebUrl(remoteUrl: string | undefined): string | undefined;
 /**
  * Synchronous branch detection — used in session resolution (not the build pipeline).
  * Kept synchronous intentionally; simple-git is used for the heavier async build operations.

package/dist/lib/git-helpers.js

@@ -1,5 +1,55 @@
 import { execSync } from 'node:child_process';
 import { simpleGit } from 'simple-git';
+/**
+ * Clean the repository URL by removing trailing slashes and .git extensions.
+ */
+export function cleanRepositoryUrl(url) {
+    let cleaned = url.trim();
+    if (cleaned.endsWith('/')) {
+        cleaned = cleaned.slice(0, -1);
+    }
+    if (cleaned.endsWith('.git')) {
+        cleaned = cleaned.slice(0, -4);
+    }
+    if (cleaned.endsWith('/')) {
+        cleaned = cleaned.slice(0, -1);
+    }
+    return cleaned;
+}
+/**
+ * Generate a URL to view a specific commit in a web interface (GitHub, GitLab, Bitbucket, etc.).
+ */
+export function getCommitUrl(repositoryUrl, sha) {
+    if (!repositoryUrl)
+        return undefined;
+    const baseUrl = cleanRepositoryUrl(repositoryUrl);
+    const lowerUrl = baseUrl.toLowerCase();
+    if (lowerUrl.includes('gitlab')) {
+        return `${baseUrl}/-/commit/${sha}`;
+    }
+    if (lowerUrl.includes('bitbucket')) {
+        return `${baseUrl}/commits/${sha}`;
+    }
+    // Default to GitHub style
+    return `${baseUrl}/commit/${sha}`;
+}
+/**
+ * Generate a URL to view a specific tag in a web interface (GitHub, GitLab, Bitbucket, etc.).
+ */
+export function getTagUrl(repositoryUrl, tag) {
+    if (!repositoryUrl)
+        return undefined;
+    const baseUrl = cleanRepositoryUrl(repositoryUrl);
+    const lowerUrl = baseUrl.toLowerCase();
+    if (lowerUrl.includes('gitlab')) {
+        return `${baseUrl}/-/tags/${tag}`;
+    }
+    if (lowerUrl.includes('bitbucket')) {
+        return `${baseUrl}/src/${tag}`;
+    }
+    // Default to GitHub style
+    return `${baseUrl}/releases/tag/${tag}`;
+}
 function getGit() {
     return simpleGit(process.cwd());
 }
@@ -76,6 +126,47 @@ export async function getGitTags() {
         return [];
     }
 }
+/**
+ * Get the git remote URL for origin.
+ * Synchronous execution — safe to use during synchronous config parsing.
+ */
+export function getGitRemoteUrl(cwd = process.cwd()) {
+    try {
+        return (execSync('git remote get-url origin', {
+            encoding: 'utf8',
+            cwd,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim() || undefined);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parse a git remote URL (SSH or HTTPS) into a clean web/HTTP(S) repository homepage URL.
+ */
+export function parseRemoteUrlToWebUrl(remoteUrl) {
+    if (!remoteUrl)
+        return undefined;
+    let url = remoteUrl.trim();
+    // If it's already an HTTP/HTTPS URL, clean and return it
+    if (url.startsWith('https://') || url.startsWith('http://')) {
+        return cleanRepositoryUrl(url);
+    }
+    // Strip ssh:// scheme and git@ user if present
+    if (url.startsWith('ssh://')) {
+        url = url.slice(6);
+    }
+    if (url.startsWith('git@')) {
+        url = url.slice(4);
+    }
+    // Replace first colon with slash to map SSH path to web path (e.g. host:owner/repo -> host/owner/repo)
+    const firstColon = url.indexOf(':');
+    if (firstColon !== -1) {
+        url = url.slice(0, firstColon) + '/' + url.slice(firstColon + 1);
+    }
+    return `https://${cleanRepositoryUrl(url)}`;
+}
 /**
  * Synchronous branch detection — used in session resolution (not the build pipeline).
  * Kept synchronous intentionally; simple-git is used for the heavier async build operations.

package/dist/lib/image-helpers.js

@@ -3,7 +3,7 @@ import { join, dirname, relative, resolve } from 'node:path';
 import { warning } from './theme.js';
 import { visitHastElements } from './hast-helpers.js';
 import { isExternalUrl } from './url-helpers.js';
-import { createImageCollectionProcessor } from './markdown-processors.js';
+import { createImageCollectionProcessor, rehypeRewriteMdLinks } from './markdown-processors.js';
 /** Regex to match image links in markdown: ![alt](path) */
 const imageLinkRegex = /!\[.*?\]\(([^)]+\.(?:png|jpe?g|gif|svg|webp|bmp|ico))\)/gi;
 /**
@@ -74,7 +74,7 @@ export const rehypeRewriteImagePaths = () => {
  */
 export async function mdToHtmlWithImages(md) {
     imageProcessor.reset();
-    const processorWithImages = createImageCollectionProcessor(imageProcessor.rehypeCollectImages, rehypeRewriteImagePaths);
+    const processorWithImages = createImageCollectionProcessor(imageProcessor.rehypeCollectImages, rehypeRewriteImagePaths, rehypeRewriteMdLinks);
     const result = await processorWithImages.process(md);
     return { html: result.toString(), imagePaths: imageProcessor.getImagePaths() };
 }

package/dist/lib/markdown-processors.d.ts

@@ -1,6 +1,10 @@
 import { unified } from 'unified';
 import type { Plugin } from 'unified';
 import type { Root } from 'hast';
+/**
+ * Rehype plugin: rewrite relative .md links to /index.html equivalents.
+ */
+export declare const rehypeRewriteMdLinks: Plugin<[], Root>;
 /**
  * General markdown processor for project files (README.md, etc.)
  * Used for files that don't need image path rewriting
@@ -15,4 +19,4 @@ export declare function createEntryMarkdownProcessor(rehypeRewriteMdLinks: Plugi
  * Image collection processor
  * Collects all image paths during markdown-to-html conversion
  */
-export declare function createImageCollectionProcessor(imageCollectionPlugin: Plugin<[], Root>, rehypeRewriteImagePaths: Plugin<[], Root>): ReturnType<typeof unified.prototype.use>;
+export declare function createImageCollectionProcessor(imageCollectionPlugin: Plugin<[], Root>, rehypeRewriteImagePaths: Plugin<[], Root>, rehypeRewriteMdLinks?: Plugin<[], Root>): ReturnType<typeof unified.prototype.use>;

package/dist/lib/markdown-processors.js

@@ -5,6 +5,28 @@ import remarkRehype from 'remark-rehype';
 import rehypeSlug from 'rehype-slug';
 import rehypeFormat from 'rehype-format';
 import rehypeStringify from 'rehype-stringify';
+import { visitHastElements } from './hast-helpers.js';
+import { isExternalUrlOrAnchor } from './url-helpers.js';
+/**
+ * Rehype plugin: rewrite relative .md links to /index.html equivalents.
+ */
+export const rehypeRewriteMdLinks = () => {
+    return (tree) => {
+        visitHastElements(tree, 'a', (node) => {
+            const href = node.properties?.href;
+            if (typeof href !== 'string')
+                return;
+            if (isExternalUrlOrAnchor(href))
+                return;
+            const mdMatch = href.match(/^(.*?)\.md(#.*)?$/i);
+            if (!mdMatch)
+                return;
+            const base = mdMatch[1];
+            const fragment = mdMatch[2] ?? '';
+            node.properties.href = `${base}/index.html${fragment}`;
+        });
+    };
+};
 /**
  * Create a markdown processor with custom rehype plugins
  *
@@ -37,6 +59,10 @@ export function createEntryMarkdownProcessor(rehypeRewriteMdLinks, rehypeRewrite
  * Image collection processor
  * Collects all image paths during markdown-to-html conversion
  */
-export function createImageCollectionProcessor(imageCollectionPlugin, rehypeRewriteImagePaths) {
-    return createMarkdownProcessor([imageCollectionPlugin, rehypeRewriteImagePaths]);
+export function createImageCollectionProcessor(imageCollectionPlugin, rehypeRewriteImagePaths, rehypeRewriteMdLinks) {
+    const plugins = [imageCollectionPlugin, rehypeRewriteImagePaths];
+    if (rehypeRewriteMdLinks) {
+        plugins.unshift(rehypeRewriteMdLinks);
+    }
+    return createMarkdownProcessor(plugins);
 }

package/dist/lib/rss.d.ts

@@ -0,0 +1,29 @@
+import type { TimelineEntry } from './template-types.js';
+/**
+ * Configuration for RSS feed generation.
+ * Used by generateRssFeed() to create properly formatted RSS 2.0 feeds.
+ */
+interface RssFeedConfig {
+    title: string;
+    description: string;
+    language: string;
+    feed_url: string;
+    site_url: string;
+    image_url?: string;
+    generator?: string;
+}
+/**
+ * Generate RSS 2.0 feed XML from logbook entries
+ * @param entries - Array of timeline entries (will use latest 50)
+ * @param config - RSS feed configuration
+ * @param baseUrl - Base URL for the site (used for absolute feed URLs)
+ * @returns RSS XML string
+ */
+export declare function generateRssFeed(entries: TimelineEntry[], config: RssFeedConfig, baseUrl?: string): string;
+/**
+ * Validate RSS XML structure (basic validation)
+ * @param xml - RSS XML string
+ * @returns true if valid RSS structure
+ */
+export declare function validateRssXml(xml: string): boolean;
+export {};

package/dist/lib/rss.js

@@ -0,0 +1,77 @@
+import RSS from 'rss';
+import { formatDateTimeForRss } from '../utils/date.js';
+/**
+ * Generate RSS 2.0 feed XML from logbook entries
+ * @param entries - Array of timeline entries (will use latest 50)
+ * @param config - RSS feed configuration
+ * @param baseUrl - Base URL for the site (used for absolute feed URLs)
+ * @returns RSS XML string
+ */
+export function generateRssFeed(entries, config, baseUrl = '') {
+    // Use only the latest 50 entries
+    const limitedEntries = entries.slice(0, 50);
+    const feed = new RSS({
+        title: config.title,
+        description: config.description,
+        language: config.language,
+        feed_url: config.feed_url,
+        site_url: config.site_url,
+        image_url: config.image_url,
+        generator: config.generator,
+        ttl: 60, // Time to live in minutes
+    });
+    for (const entry of limitedEntries) {
+        const itemUrl = `${baseUrl}${entry.slug}/`;
+        const pubDate = formatDateTimeForRss(entry.dateStart);
+        feed.item({
+            title: entry.title || entry.slug,
+            description: stripMarkdown(entry.summary),
+            url: itemUrl,
+            guid: entry.slug,
+            date: pubDate,
+            author: entry.prompter || undefined,
+        });
+    }
+    return feed.xml({ indent: true });
+}
+/**
+ * Strip markdown formatting from text for RSS description
+ * Removes bold, italic, code, and heading markers
+ */
+function stripMarkdown(text) {
+    return text
+        .replace(/`([^`]+)`/g, '$1') // Remove inline code backticks
+        .replace(/\*\*([^*]+)\*\*/g, '$1') // Remove bold
+        .replace(/\*([^*]+)\*/g, '$1') // Remove italic
+        .replace(/#{1,6}\s+/g, '') // Remove heading markers
+        .replace(/\n+/g, ' ') // Replace newlines with spaces
+        .trim();
+}
+/**
+ * Validate RSS XML structure (basic validation)
+ * @param xml - RSS XML string
+ * @returns true if valid RSS structure
+ */
+export function validateRssXml(xml) {
+    try {
+        // Basic structure checks
+        if (!xml.includes('<?xml version'))
+            return false;
+        if (!xml.includes('<rss'))
+            return false;
+        if (!xml.includes('<channel>'))
+            return false;
+        if (!xml.includes('</channel>'))
+            return false;
+        if (!xml.includes('<item>'))
+            return false;
+        // Check for required RSS 2.0 elements
+        const hasTitle = xml.includes('<title>');
+        const hasLink = xml.includes('<link>');
+        const hasDescription = xml.includes('<description>');
+        return hasTitle && hasLink && hasDescription;
+    }
+    catch {
+        return false;
+    }
+}

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

@@ -2,8 +2,8 @@ import type { TimelineEntry, TimelineCommitItem, TimelineTagItem, EntryLink, Git
 export declare const html: (strings: TemplateStringsArray, ...values: unknown[]) => string;
 export declare const navLink: (entry: EntryLink, dir: "prev" | "next") => string;
 export declare const renderTagsAndWorkspaces: (tags: string[] | undefined, workspaces: string[] | undefined) => string;
-export declare const renderCommits: (commits: GitCommit[] | undefined) => string;
+export declare const renderCommits: (commits: GitCommit[] | undefined, repositoryUrl?: string) => string;
 export declare const renderTimelineEntryItem: (e: TimelineEntry) => string;
-export declare const renderTimelineCommitItem: (c: TimelineCommitItem, jiraBaseUrl?: string, jiraPrefix?: string) => string;
-export declare const renderTimelineTagItem: (t: TimelineTagItem) => string;
+export declare const renderTimelineCommitItem: (c: TimelineCommitItem, jiraBaseUrl?: string, jiraPrefix?: string, repositoryUrl?: string) => string;
+export declare const renderTimelineTagItem: (t: TimelineTagItem, repositoryUrl?: string) => string;
 export declare const paginationLinks: (currentPage: number, totalPages: number) => string;

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 = '';