project-logbook 0.3.2 → 0.3.4

package/README.md

@@ -17,7 +17,7 @@ Each entry in `logbook/` consists of:
 
 ## Installation
 ```bash
-npm i project-loogbook -g
+npm i project-logbook -g
 ```
 
 ## Commands

package/dist/commands/build.js

@@ -1,73 +1,33 @@
 import fs from 'fs-extra';
 import { join } from 'node:path';
-import chalk from 'chalk';
-import { getConfig, getWorkspaces } from '../lib/config.js';
+import { error, neutral, success } from '../lib/theme.js';
+import { getConfig, getWorkspaces, getLogbookDirPath, getOutputDirPath } from '../lib/config.js';
 import { layout, timelineTemplate } from '../lib/templates.js';
-import { getStyles } from '../lib/styles.js';
-import { getClientScript } from '../lib/logbook-client.js';
-import { mdToHtml, buildProjectMdFiles, renderPost } from '../lib/build-helpers.js';
-import { mdToHtmlWithImages, copyImages } from '../lib/image-helpers.js';
+import { buildProjectMdFiles, renderPost, generateBuildMeta } from '../lib/build-helpers.js';
 import { getGitCommits, getGitTags } from '../lib/git-helpers.js';
-import { formatRelativeDate, getMonthYear, getSortTime } from '../utils/date.js';
+import { setupOutputDirectory, processReadme, copyReadmeImages, processAboutContent } from '../lib/build-steps.js';
+import { formatAbsoluteDate, getMonthYear, getSortTime, formatDateTimeForDisplay } from '../utils/date.js';
 import { getLogbookEntries } from '../utils/fs.js';
+import { toDisplayString, asString, asStringArray } from '../utils/frontmatter.js';
 import { getAboutContent } from '../lib/about-content.js';
+import { getPackageVersion } from '../lib/package-version.js';
 import { groupTimelineItems } from '../utils/timeline-helpers.js';
-const pkg = JSON.parse(fs.readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
-const version = pkg.version;
-/** Normalises a frontmatter field that may be a scalar string or a YAML list of strings. */
-const toDisplayString = (v) => {
-    if (typeof v === 'string')
-        return v || undefined;
-    if (Array.isArray(v)) {
-        const joined = v.filter((x) => typeof x === 'string').join(' + ');
-        return joined || undefined;
-    }
-    return undefined;
-};
+import { getEntryDisplayId, getEntryDisplayTitle } from '../lib/entry-id.js';
+const version = getPackageVersion();
 export async function build() {
     const config = getConfig();
-    const logbookDir = join(process.cwd(), config.logbookDir);
-    const outputDir = join(process.cwd(), config.outputDir);
-    const buildTime = new Date()
-        .toLocaleString('de-DE', {
-        year: 'numeric',
-        month: '2-digit',
-        day: '2-digit',
-        hour: '2-digit',
-        minute: '2-digit',
-        second: '2-digit',
-        hour12: false,
-    })
-        .replace(',', '');
+    const logbookDir = getLogbookDirPath(config);
+    const outputDir = getOutputDirPath(config);
+    const buildTime = formatDateTimeForDisplay(new Date());
     if (!(await fs.pathExists(logbookDir))) {
-        console.error(chalk.red(`Error: Logbook directory '${config.logbookDir}' not found.`));
+        console.error(error(`Error: Logbook directory '${config.logbookDir}' not found.`));
         return;
     }
-    await fs.remove(outputDir);
-    await fs.mkdirp(outputDir);
-    await fs.copyFile(new URL('../templates/favicon.svg', import.meta.url), join(outputDir, 'favicon.svg'));
-    await fs.writeFile(join(outputDir, 'style.css'), getStyles(config.primaryColor));
-    await fs.writeFile(join(outputDir, 'logbook.js'), getClientScript());
-    const readmePath = join(process.cwd(), 'README.md');
-    let readmeHtml = '';
-    let readmeImages = [];
-    try {
-        if (await fs.pathExists(readmePath)) {
-            const readmeContent = await fs.readFile(readmePath, 'utf8');
-            const { html, imagePaths } = await mdToHtmlWithImages(readmeContent);
-            readmeHtml = html;
-            readmeImages = imagePaths;
-        }
-    }
-    catch (error) {
-        console.warn(chalk.yellow('Warning: Failed to read README.md:', error instanceof Error ? error.message : error));
-        readmeHtml = '<p>README unavailable.</p>';
-    }
-    // Copy README images to output
-    if (readmeImages.length > 0) {
-        await copyImages(process.cwd(), outputDir, readmeImages);
-    }
-    const aboutHtml = await mdToHtml(getAboutContent());
+    await setupOutputDirectory(outputDir, config);
+    const projectRoot = process.cwd();
+    const { html: readmeHtml, imagePaths: readmeImages } = await processReadme(projectRoot);
+    await copyReadmeImages(projectRoot, outputDir, readmeImages);
+    const aboutHtml = await processAboutContent(getAboutContent());
     const logbookEntries = await getLogbookEntries(logbookDir);
     const timelineEntries = [];
     const availableWorkspaces = getWorkspaces();
@@ -82,9 +42,7 @@ export async function build() {
                 ? firstParagraph.trim().substring(0, 200).replace(/[*#`]/g, '') + '...'
                 : 'No summary available.';
         }
-        const entryWorkspaces = Array.isArray(data.workspaces)
-            ? data.workspaces.filter((ws) => typeof ws === 'string' && availableWorkspaces.includes(ws))
-            : [];
+        const entryWorkspaces = asStringArray(data.workspaces).filter((ws) => availableWorkspaces.includes(ws));
         const dateStartValue = data.dateStart;
         const dateStart = typeof dateStartValue === 'string'
             ? dateStartValue
@@ -92,7 +50,7 @@ export async function build() {
                 ? dateStartValue.toISOString()
                 : '';
         // Skip DRAFT entries (no valid dateStart) — they break the timeline
-        if (!dateStart || dateStart.includes('{{'))
+        if (!dateStart || dateStart.includes('{{') || dateStart === '[DATE_START]')
             continue;
         const dateEndValue = data.dateEnd;
         const dateEnd = typeof dateEndValue === 'string'
@@ -105,14 +63,14 @@ export async function build() {
             slug,
             dateStart,
             dateEnd,
-            displayDate: formatRelativeDate(dateStart),
+            displayDate: formatAbsoluteDate(dateStart),
             sortTime: getSortTime(dateStart, dateEnd),
-            summary: typeof summary === 'string' ? summary : 'No summary available.',
-            ticket: typeof data.ticket === 'string' ? data.ticket : slug,
+            summary: asString(summary, 'No summary available.') || '',
+            ticket: getEntryDisplayId(asString(data.ticket), slug),
             monthGroup: getMonthYear(dateStart),
-            tags: Array.isArray(data.tags) ? data.tags.filter((t) => typeof t === 'string') : [],
+            tags: asStringArray(data.tags),
             workspaces: entryWorkspaces,
-            title: typeof data.title === 'string' ? data.title : undefined,
+            title: getEntryDisplayTitle(asString(data.title), slug),
             harness: toDisplayString(data.harness),
             llm: toDisplayString(data.llm),
             prompter: toDisplayString(data.prompter),
@@ -125,8 +83,7 @@ export async function build() {
         sha: c.sha,
         message: c.message,
         timestamp: c.timestamp,
-        relativeTime: c.relativeTime,
-        displayDate: formatRelativeDate(c.timestamp),
+        displayDate: formatAbsoluteDate(c.timestamp),
         monthGroup: getMonthYear(c.timestamp),
         sortTime: getSortTime(c.timestamp),
     }));
@@ -134,11 +91,11 @@ export async function build() {
         kind: 'tag',
         name: t.name,
         timestamp: t.timestamp,
-        displayDate: formatRelativeDate(t.timestamp),
+        displayDate: formatAbsoluteDate(t.timestamp),
         monthGroup: getMonthYear(t.timestamp),
         sortTime: getSortTime(t.timestamp),
     }));
-    console.log(chalk.gray(`Found ${timelineEntries.length} entr${timelineEntries.length === 1 ? 'y' : 'ies'}, ${commitItems.length} commit${commitItems.length === 1 ? '' : 's'} (max 100), and ${tagItems.length} tag${tagItems.length === 1 ? '' : 's'}.`));
+    console.log(neutral(`Found ${timelineEntries.length} entr${timelineEntries.length === 1 ? 'y' : 'ies'}, ${commitItems.length} commit${commitItems.length === 1 ? '' : 's'} (max 100), and ${tagItems.length} tag${tagItems.length === 1 ? '' : 's'}.`));
     timelineEntries.sort((a, b) => {
         const aEnd = a.dateEnd ? new Date(a.dateEnd).getTime() : new Date(a.dateStart).getTime();
         const bEnd = b.dateEnd ? new Date(b.dateEnd).getTime() : new Date(b.dateStart).getTime();
@@ -164,7 +121,7 @@ export async function build() {
             }
             group.items.push(item);
         }
-        const timelineContent = timelineTemplate({
+        const { header: timelineHeader, content: timelineMainContent } = timelineTemplate({
             projectName: config.projectName,
             version,
             buildTime,
@@ -176,14 +133,14 @@ export async function build() {
             currentPage,
             totalPages,
         }); // prettier-ignore
-        const buildMeta = `Generated by ${config.projectName} v${version} • ${buildTime}`;
+        const buildMeta = generateBuildMeta(version, buildTime);
         const timelineHtml = layout({
             title: 'Timeline',
             projectName: config.projectName,
             basePath: './',
             buildMeta,
-            header: timelineContent.split('</header>')[0] + '</header>',
-            content: timelineContent.split('</header>')[1],
+            header: timelineHeader,
+            content: timelineMainContent,
         });
         const fileName = currentPage === 1 ? 'index.html' : `index-${currentPage}.html`;
         await fs.writeFile(join(outputDir, fileName), timelineHtml);
@@ -193,5 +150,5 @@ export async function build() {
         version,
         buildTime,
     });
-    console.log(chalk.green(`\nSuccessfully built logbook to ${config.outputDir}/`));
+    console.log(success(`\nSuccessfully built logbook to ${config.outputDir}/`));
 }

package/dist/commands/init.js

@@ -1,9 +1,9 @@
 import fs from 'fs-extra';
 import { join } from 'node:path';
 import { createInterface } from 'node:readline';
-import chalk from 'chalk';
 import { DEFAULT_CONFIG } from '../lib/config.js';
 import { getTemplatesDir } from '../lib/migrations.js';
+import { warning, info, highlight, success } from '../lib/theme.js';
 const rl = createInterface({
     input: process.stdin,
     output: process.stdout,
@@ -34,22 +34,22 @@ export async function init() {
     const contributingPath = join(cwd, 'CONTRIBUTING.md');
     // 1. Config file
     if (await fs.pathExists(configPath)) {
-        console.log(chalk.yellow('Already initialized. .project-logbook exists.'));
+        console.log(warning('Already initialized. .project-logbook exists.'));
         rl.close();
         return;
     }
-    console.log(chalk.blue('\n📒 Initializing project-logbook\n'));
+    console.log(info('\n📒 Initializing project-logbook\n'));
     // Detect project name from package.json
     const detectedName = readPackageJsonName(cwd);
     const defaultName = detectedName || DEFAULT_CONFIG.projectName;
-    const nameInput = await question(chalk.cyan(`Project name (press Enter for "${defaultName}"): `));
+    const nameInput = await question(highlight(`Project name (press Enter for "${defaultName}"): `));
     const projectName = nameInput || defaultName;
     // Optional Jira config
-    const jiraPrefixInput = await question(chalk.cyan('Jira project prefix (e.g. MYAPP, leave blank to skip): '));
+    const jiraPrefixInput = await question(highlight('Jira project prefix (e.g. MYAPP, leave blank to skip): '));
     const jiraPrefix = jiraPrefixInput || undefined;
     let jiraBaseUrl;
     if (jiraPrefix) {
-        const jiraUrlInput = await question(chalk.cyan('Jira base URL (e.g. https://yourorg.atlassian.net, leave blank to skip): '));
+        const jiraUrlInput = await question(highlight('Jira base URL (e.g. https://yourorg.atlassian.net, leave blank to skip): '));
         jiraBaseUrl = jiraUrlInput || undefined;
     }
     rl.close();
@@ -63,21 +63,21 @@ export async function init() {
     if (jiraBaseUrl)
         config.jiraBaseUrl = jiraBaseUrl;
     await fs.writeJson(configPath, config, { spaces: 2 });
-    console.log(chalk.green('\n✔ Created .project-logbook config file.'));
+    console.log(success('\n✔ Created .project-logbook config file.'));
     // 2. Logbook directory
     if (!(await fs.pathExists(logbookDir))) {
         await fs.mkdirp(logbookDir);
-        console.log(chalk.green(`✔ Created ${DEFAULT_CONFIG.logbookDir}/ directory.`));
+        console.log(success(`✔ Created ${DEFAULT_CONFIG.logbookDir}/ directory.`));
     }
     // 3. CONTRIBUTING.md (from template)
     if (!(await fs.pathExists(contributingPath))) {
         const templatePath = join(getTemplatesDir(), 'CONTRIBUTING.md');
         if (await fs.pathExists(templatePath)) {
             await fs.copyFile(templatePath, contributingPath);
-            console.log(chalk.green('✔ Created CONTRIBUTING.md with agentic workflow protocol.'));
+            console.log(success('✔ Created CONTRIBUTING.md with agentic workflow protocol.'));
         }
     }
     // 4. Hint
-    console.log(chalk.dim('\n💡 Tip: Edit .project-logbook to customize primaryColor, add more tags, or configure Jira settings.'));
-    console.log(chalk.dim('   Run `logbook new` to create your first entry.\n'));
+    console.log(info('\n💡 Tip: Edit .project-logbook to customize primaryColor, add more tags, or configure Jira settings.'));
+    console.log(info('   Run `logbook new` to create your first entry.\n'));
 }

package/dist/commands/lint.js

@@ -1,19 +1,18 @@
 import fs from 'fs-extra';
-import { join } from 'node:path';
-import chalk from 'chalk';
-import { getConfig } from '../lib/config.js';
+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';
 export async function lint() {
     const config = getConfig();
-    const logbookDir = join(process.cwd(), config.logbookDir);
+    const logbookDir = getLogbookDirPath(config);
     if (!(await fs.pathExists(logbookDir))) {
-        console.error(chalk.red(`Error: Logbook directory '${config.logbookDir}' not found.`));
+        console.error(errorStyle(`Error: Logbook directory '${config.logbookDir}' not found.`));
         return;
     }
     let overallSuccess = true;
     // 1. Project-level checks
-    console.log(chalk.blue('Checking project integrity...'));
+    console.log(header('Checking project integrity...'));
     const projectSuccess = await runLinters({ config });
     if (!projectSuccess)
         overallSuccess = false;
@@ -23,7 +22,7 @@ export async function lint() {
     let skippedCount = 0; // Re-introducing skippedCount
     for (const entry of logbookEntries) {
         if (!entry.hasIndex) {
-            console.error(chalk.red(`  [MISSING] ${entry.slug}/index.md`));
+            console.error(errorStyle(`  [MISSING] ${entry.slug}/index.md`));
             overallSuccess = false;
             continue;
         }
@@ -48,12 +47,12 @@ export async function lint() {
     }
     if (overallSuccess) {
         const skippedNote = skippedCount > 0
-            ? chalk.gray(` (${skippedCount} DRAFT ${skippedCount === 1 ? 'entry' : 'entries'} skipped)`)
+            ? neutralStyle(` (${skippedCount} DRAFT ${skippedCount === 1 ? 'entry' : 'entries'} skipped)`)
             : '';
-        console.log(chalk.green(`\nAll ${passedCount} entries passed linting!`) + skippedNote);
+        console.log(successStyle(`\nAll ${passedCount} entries passed linting!`) + skippedNote);
     }
     else {
-        console.log(chalk.red('\nLinting failed with errors. If you are a LLM, try to fix the errors.'));
+        console.log(errorStyle('\nLinting failed with errors. If you are a LLM, try to fix the errors.'));
         process.exit(1);
     }
 }
@@ -66,5 +65,5 @@ function isDraft(entry) {
     // An entry is a draft if:
     // 1. The 'dateStart' key is missing from frontmatter (i.e., undefined or null).
     // 2. OR the string representation of 'dateStart' is '[DATE_START]'.
-    return !frontmatter?.dateStart || String(frontmatter.dateStart) === 'DATE_START';
+    return !frontmatter?.dateStart || String(frontmatter.dateStart) === '[DATE_START]';
 }

package/dist/commands/list.js

@@ -1,16 +1,16 @@
 import fs from 'fs-extra';
-import { join } from 'node:path';
-import chalk from 'chalk';
-import { getConfig } from '../lib/config.js';
+import { getConfig, getLogbookDirPath } from '../lib/config.js';
 import { getLogbookEntries } from '../utils/fs.js';
 import { stripAnsi } from '../utils/string.js';
 import { parseTicketId } from '../utils/id.js';
 import { getActiveEntry } from '../lib/session.js';
+import { asString } from '../utils/frontmatter.js';
+import { error, neutral, warning, highlight, success, bold } from '../lib/theme.js';
 export async function list(options = {}) {
     const config = getConfig();
-    const logbookDir = join(process.cwd(), config.logbookDir);
+    const logbookDir = getLogbookDirPath(config);
     if (!(await fs.pathExists(logbookDir))) {
-        console.error(chalk.red(`Error: Logbook directory '${config.logbookDir}' not found. Run 'logbook init' first.`));
+        console.error(error(`Error: Logbook directory '${config.logbookDir}' not found. Run 'logbook init' first.`));
         process.exit(1);
     }
     // Detect currently active entry (if any)
@@ -35,9 +35,9 @@ export async function list(options = {}) {
             }
             rows.push({
                 ticketId: draftTicketId,
-                title: chalk.gray(draftTitle),
+                title: neutral(draftTitle),
                 prompter: '',
-                status: chalk.yellow('DRAFT'),
+                status: warning('DRAFT'),
             });
             continue;
         }
@@ -58,16 +58,16 @@ export async function list(options = {}) {
         const bodyHasPlaceholders = contentWithoutCode.includes('TODO:') ||
             content.includes('Write a polished, highly readable "short story" of the change here.');
         const hasPlaceholders = frontmatterHasPlaceholders || bodyHasPlaceholders;
-        const status = isActive ? chalk.cyan('● ACTIVE') : hasPlaceholders ? chalk.yellow('DRAFT') : chalk.green('DONE');
+        const status = isActive ? highlight('● ACTIVE') : hasPlaceholders ? warning('DRAFT') : success('DONE');
         rows.push({
-            ticketId: typeof data.ticket === 'string' ? data.ticket : chalk.gray('-'),
-            title: typeof data.title === 'string' ? data.title : chalk.gray('(untitled)'),
-            prompter: typeof data.prompter === 'string' ? data.prompter : chalk.gray('-'),
+            ticketId: asString(data.ticket) || neutral('-'),
+            title: asString(data.title) || neutral('(untitled)'),
+            prompter: asString(data.prompter) || neutral('-'),
             status,
         });
     }
     if (rows.length === 0) {
-        console.log(chalk.yellow('No logbook entries found. Use `logbook new <id> <slug>` to create one.'));
+        console.log(warning('No logbook entries found. Use `logbook new <id> <slug>` to create one.'));
         return;
     }
     // Sort by ticket ID descending
@@ -97,10 +97,10 @@ export async function list(options = {}) {
     };
     const pad = (s, len) => s + ' '.repeat(Math.max(0, len - stripAnsi(s).length));
     const header = [
-        chalk.bold(pad('TICKET-ID', colWidths.ticketId)),
-        chalk.bold(pad('TITLE', colWidths.title)),
-        chalk.bold(pad('PROMPTER', colWidths.prompter)),
-        chalk.bold('STATUS'),
+        bold(pad('TICKET-ID', colWidths.ticketId)),
+        bold(pad('TITLE', colWidths.title)),
+        bold(pad('PROMPTER', colWidths.prompter)),
+        bold('STATUS'),
     ].join('  ');
     const divider = [
         '─'.repeat(colWidths.ticketId),
@@ -110,7 +110,7 @@ export async function list(options = {}) {
     ].join('  ');
     console.log('');
     console.log(header);
-    console.log(chalk.gray(divider));
+    console.log(neutral(divider));
     for (const row of displayedRows) {
         console.log([
             pad(row.ticketId, colWidths.ticketId),
@@ -123,5 +123,5 @@ export async function list(options = {}) {
     const countText = displayedRows.length === totalEntries
         ? `${totalEntries} ${totalEntries === 1 ? 'entry' : 'entries'}`
         : `Showing latest ${displayedRows.length} of ${totalEntries} entries (use --all to show all)`;
-    console.log(chalk.gray(`${countText} in ${config.logbookDir}/`));
+    console.log(neutral(`${countText} in ${config.logbookDir}/`));
 }

package/dist/commands/log.js

@@ -1,6 +1,6 @@
 import fs from 'fs-extra';
 import { join } from 'node:path';
-import chalk from 'chalk';
+import { error as errorStyle, successMessage } from '../lib/theme.js';
 import { getConfig } from '../lib/config.js';
 import { getActiveEntry } from '../lib/session.js';
 export async function log(messages, options = {}) {
@@ -8,14 +8,14 @@ export async function log(messages, options = {}) {
     // 1. Require an active entry
     const active = await getActiveEntry(options, cwd);
     if (!active) {
-        console.error(chalk.red(`Error: No active logbook entry resolved.`));
-        console.error(chalk.red(`Activate an entry via 'logbook start <id>', checkout a feature branch, or pass --id.`));
+        console.error(errorStyle(`Error: No active logbook entry resolved.`));
+        console.error(errorStyle(`Activate an entry via 'logbook start <id>', checkout a feature branch, or pass --id.`));
         process.exit(1);
     }
     const config = getConfig();
     const logPath = join(cwd, config.logbookDir, active.slug, 'log.md');
     if (!(await fs.pathExists(logPath))) {
-        console.error(chalk.red(`Error: log.md not found`));
+        console.error(errorStyle(`Error: log.md not found`));
         process.exit(1);
     }
     // 2. Build new lines: "- <ISO timestamp>: <message>"
@@ -26,6 +26,6 @@ export async function log(messages, options = {}) {
     const separator = existing.endsWith('\n') ? '' : '\n';
     await fs.writeFile(logPath, existing + separator + newLines + '\n');
     for (const msg of messages) {
-        console.log(chalk.green(`Logged to ${active.slug} (via ${active.source}): ${timestamp}: ${msg}`));
+        console.log(successMessage('Logged', `${active.slug} (via ${active.source}): ${timestamp}: ${msg}`));
     }
 }

package/dist/commands/new.js

@@ -1,13 +1,13 @@
 import fs from 'fs-extra';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { join } from 'node:path';
 import { createInterface } from 'node:readline';
-import chalk from 'chalk';
-import { getConfig } from '../lib/config.js';
+import { getConfig, getLogbookDirPath } from '../lib/config.js';
+import { getEntryPath } from '../lib/entry-paths.js';
 import { getTemplatesDir } from '../lib/migrations.js';
+import { header, warning as warningStyle, highlight, errorMessage, successMessage, warningMessage, } from '../lib/theme.js';
+import { getPackageVersion } from '../lib/package-version.js';
 import { parseTicketId, getNextId } from '../utils/id.js';
 import { sanitiseSlug } from '../utils/slug.js';
-const __dirname = dirname(fileURLToPath(import.meta.url));
 const rl = createInterface({
     input: process.stdin,
     output: process.stdout,
@@ -21,7 +21,7 @@ const question = (prompt) => {
 };
 export async function createNewEntry(id, slug) {
     const config = getConfig();
-    const logbookDir = join(process.cwd(), config.logbookDir);
+    const logbookDir = getLogbookDirPath(config);
     if (!(await fs.pathExists(logbookDir))) {
         await fs.mkdirp(logbookDir);
     }
@@ -29,19 +29,19 @@ export async function createNewEntry(id, slug) {
     let entrySlug = slug;
     // Interactive mode if no parameters provided
     if (!entryId || !entrySlug) {
-        console.log(chalk.blue('\n📝 Creating a new logbook entry (interactive mode)\n'));
+        console.log(header('\n📝 Creating a new logbook entry (interactive mode)\n'));
         // Determine if we have a jiraPrefix configured
         const hasJiraPrefix = !!config.jiraPrefix;
         if (!entryId) {
             if (hasJiraPrefix) {
                 // Auto-generate ID based on jiraPrefix
                 const nextId = getNextId(logbookDir, config.jiraPrefix);
-                const input = await question(chalk.cyan(`Enter entry ID (e.g. ${nextId}, press Enter for auto-generated): `));
+                const input = await question(highlight(`Enter entry ID (e.g. ${nextId}, press Enter for auto-generated): `));
                 if (input) {
                     const parsed = parseTicketId(input);
                     const bareNumber = /^\d+$/.test(input) ? parseInt(input, 10) : null;
                     if (parsed && parsed.prefix.toUpperCase() !== config.jiraPrefix?.toUpperCase()) {
-                        console.warn(chalk.yellow(`Warning: Prefix '${parsed.prefix}' doesn't match configured '${config.jiraPrefix}'. Using configured prefix.`));
+                        console.warn(warningStyle(`Warning: Prefix '${parsed.prefix}' doesn't match configured '${config.jiraPrefix}'. Using configured prefix.`));
                         entryId = `${config.jiraPrefix}-${parsed.number}`;
                     }
                     else if (parsed) {
@@ -51,7 +51,7 @@ export async function createNewEntry(id, slug) {
                         entryId = `${config.jiraPrefix}-${bareNumber}`;
                     }
                     else {
-                        console.warn(chalk.yellow('Invalid ID format. Using auto-generated ID.'));
+                        console.warn(warningStyle('Invalid ID format. Using auto-generated ID.'));
                         entryId = nextId;
                     }
                 }
@@ -61,7 +61,7 @@ export async function createNewEntry(id, slug) {
             }
             else {
                 const nextId = getNextId(logbookDir, 'LB');
-                const input = await question(chalk.cyan(`Enter entry ID (e.g. ${nextId}, press Enter for auto-generated): `));
+                const input = await question(highlight(`Enter entry ID (e.g. ${nextId}, press Enter for auto-generated): `));
                 if (input) {
                     const parsed = parseTicketId(input);
                     const bareNumber = /^\d+$/.test(input) ? parseInt(input, 10) : null;
@@ -72,7 +72,7 @@ export async function createNewEntry(id, slug) {
                         entryId = `LB-${bareNumber}`;
                     }
                     else {
-                        console.warn(chalk.yellow('Invalid ID format. Using auto-generated ID.'));
+                        console.warn(warningStyle('Invalid ID format. Using auto-generated ID.'));
                         entryId = nextId;
                     }
                 }
@@ -82,9 +82,9 @@ export async function createNewEntry(id, slug) {
             }
         }
         if (!entrySlug) {
-            const input = await question(chalk.cyan('Enter a short title (will be converted to slug): '));
+            const input = await question(highlight('Enter a short title (will be converted to slug): '));
             if (!input) {
-                console.error(chalk.red('Error: Title is required.'));
+                console.error(errorMessage('Error', 'Title is required.'));
                 process.exit(1);
             }
             entrySlug = sanitiseSlug(input);
@@ -97,17 +97,16 @@ export async function createNewEntry(id, slug) {
     // Sanitise slug
     const sanitised = sanitiseSlug(entrySlug);
     if (sanitised !== entrySlug) {
-        console.log(chalk.yellow(`Notice: Slug normalised from '${entrySlug}' to '${sanitised}'.`));
+        console.warn(warningMessage('Notice', `Slug normalised from '${entrySlug}' to '${sanitised}'.`));
         entrySlug = sanitised;
     }
-    const entryDir = join(process.cwd(), config.logbookDir, `${entryId}-${entrySlug}`);
+    const entryDir = getEntryPath(getLogbookDirPath(config), `${entryId}-${entrySlug}`);
     if (await fs.pathExists(entryDir)) {
-        console.error(chalk.red(`Error: Entry ${entryId}-${entrySlug} already exists.`));
+        console.error(errorMessage('Error', `Entry ${entryId}-${entrySlug} already exists.`));
         process.exit(1);
     }
     await fs.mkdirp(entryDir);
-    const pkg = JSON.parse(await fs.readFile(join(__dirname, '../../package.json'), 'utf8'));
-    const version = pkg.version;
+    const version = getPackageVersion();
     const now = new Date();
     const replacements = {
         id: entryId,
@@ -131,5 +130,5 @@ export async function createNewEntry(id, slug) {
     await fs.writeFile(join(entryDir, 'index.md'), fillTemplate(getTemplate('index.md')));
     await fs.writeFile(join(entryDir, 'ticket.md'), fillTemplate(getTemplate('ticket.md')));
     await fs.writeFile(join(entryDir, 'log.md'), fillTemplate(getTemplate('log.md')));
-    console.log(chalk.green(`\nSuccessfully created logbook entry in ${config.logbookDir}/${entryId}-${entrySlug}/`));
+    console.log(successMessage('Created', `logbook entry in ${config.logbookDir}/${entryId}-${entrySlug}/`));
 }

package/dist/commands/preview.js

@@ -1,19 +1,20 @@
-import { exec } from 'node:child_process';
+import { execFile } from 'node:child_process';
 import { join } from 'node:path';
-import chalk from 'chalk';
-import { getConfig } from '../lib/config.js';
+import { header, error as errorStyle } from '../lib/theme.js';
+import { getConfig, getOutputDirPath } from '../lib/config.js';
 import { build } from './build.js';
 export async function preview() {
     const config = getConfig();
-    const outputDir = join(process.cwd(), config.outputDir);
+    const outputDir = getOutputDirPath(config);
     const indexPath = join(outputDir, 'index.html');
-    console.log(chalk.blue('Building logbook before preview...'));
+    console.log(header('Building logbook before preview...'));
     await build();
-    console.log(chalk.blue(`Opening preview: ${indexPath}`));
+    console.log(header(`Opening preview: ${indexPath}`));
     const start = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
-    exec(`${start} "${indexPath}"`, (err) => {
+    // Use execFile with explicit args array to avoid shell interpolation
+    execFile(start, [indexPath], (err) => {
         if (err) {
-            console.error(chalk.red(`Failed to open preview: ${err.message}`));
+            console.error(errorStyle(`Failed to open preview: ${err.message}`));
         }
     });
 }

package/dist/commands/release.js

@@ -1,6 +1,6 @@
 import fs from 'fs-extra';
 import { join } from 'node:path';
-import chalk from 'chalk';
+import { neutral, warning as warningStyle, successMessage } from '../lib/theme.js';
 import matter from 'gray-matter';
 import { getConfig } from '../lib/config.js';
 import { getActiveEntry } from '../lib/session.js';
@@ -10,7 +10,7 @@ export async function release(options = {}) {
     const lockfilePath = join(cwd, LOCKFILE_NAME);
     const active = await getActiveEntry(options, cwd);
     if (!active) {
-        console.log(chalk.yellow('No active entry resolved. Nothing to release.'));
+        console.log(warningStyle('No active entry resolved. Nothing to release.'));
         return;
     }
     const releasedAt = new Date().toISOString();
@@ -21,7 +21,7 @@ export async function release(options = {}) {
     if (await fs.pathExists(indexPath)) {
         let raw = await fs.readFile(indexPath, 'utf8');
         // Always update dateEnd (replace placeholder OR existing value)
-        const hasPlaceholder = raw.includes('dateEnd: [DATE_END]');
+        const hasPlaceholder = raw.includes('dateEnd: "[DATE_END]"');
         const dateEndRegex = /dateEnd:.*$/m;
         if (hasPlaceholder || dateEndRegex.test(raw)) {
             raw = raw.replace(dateEndRegex, `dateEnd: ${releasedAt}`);
@@ -44,13 +44,13 @@ export async function release(options = {}) {
             await fs.remove(lockfilePath);
         }
     }
-    console.log(chalk.green(`Released entry: ${active.slug} (via ${active.source})`));
+    console.log(successMessage('Released', `entry: ${active.slug} (via ${active.source})`));
     if (active.startedAt) {
         const elapsed = formatElapsed(new Date(active.startedAt), new Date(releasedAt));
-        console.log(chalk.gray(`Active for ${elapsed}. You may now commit and build.`));
+        console.log(neutral(`Active for ${elapsed}. You may now commit and build.`));
     }
     else {
-        console.log(chalk.gray(`Released at ${releasedAt}. You may now commit and build.`));
+        console.log(neutral(`Released at ${releasedAt}. You may now commit and build.`));
     }
 }
 function formatElapsed(from, to) {