project-logbook 0.3.0

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

@@ -0,0 +1,118 @@
+/**
+ * Configuration for a single tab
+ */
+export interface TabConfig {
+    id: string;
+    title: string;
+    content: string;
+}
+/**
+ * Configuration for the timeline template
+ */
+export interface TimelineTemplateProps {
+    projectName: string;
+    version: string;
+    buildTime: string;
+    groups: TimelineGroup[];
+    readmeHtml: string;
+    aboutHtml: string;
+    jiraBaseUrl?: string;
+    jiraPrefix?: string;
+}
+/**
+ * Configuration for a month group in the timeline
+ */
+export interface TimelineGroup {
+    month: string;
+    items: TimelineItem[];
+}
+/**
+ * A timeline item is either a logbook entry card, a git commit, or a git tag.
+ */
+export type TimelineItem = TimelineEntry | TimelineCommitItem | TimelineTagItem;
+/**
+ * Configuration for a timeline entry
+ */
+export interface TimelineEntry {
+    kind: 'entry';
+    slug: string;
+    dateStart: string;
+    dateEnd?: string;
+    displayDate: string;
+    sortTime: string;
+    harness?: string;
+    llm?: string;
+    prompter?: string;
+    ticket?: string;
+    title?: string;
+    summary: string;
+    tags?: string[];
+    workspaces?: string[];
+}
+/**
+ * A standalone git commit shown as a non-clickable info item in the timeline.
+ */
+export interface TimelineCommitItem {
+    kind: 'commit';
+    sha: string;
+    message: string;
+    timestamp: string;
+    relativeTime: string;
+    displayDate: string;
+    monthGroup: string;
+    sortTime: string;
+}
+/**
+ * A standalone git tag shown as a non-clickable info item in the timeline.
+ */
+export interface TimelineTagItem {
+    kind: 'tag';
+    name: string;
+    timestamp: string;
+    displayDate: string;
+    monthGroup: string;
+    sortTime: string;
+}
+/**
+ * A single git commit associated with a logbook entry.
+ */
+export interface GitCommit {
+    sha: string;
+    message: string;
+    timestamp: string;
+    relativeTime: string;
+}
+/**
+ * Configuration for the post template
+ */
+export interface PostTemplateProps {
+    title: string;
+    displayDate: string;
+    dateStart: string;
+    harness: string;
+    llm?: string;
+    prompter?: string;
+    ticket?: string;
+    summary?: string;
+    content: string;
+    ticketHtml: string;
+    logHtml: string;
+    commits?: GitCommit[];
+    version: string;
+    jiraUrl?: string;
+    prevEntry: EntryLink | null;
+    nextEntry: EntryLink | null;
+    slug?: string;
+    tags?: string[];
+    workspaces?: string[];
+}
+/**
+ * Configuration for navigation between entries
+ */
+export interface EntryLink {
+    slug: string;
+    title: string;
+    ticket?: string;
+    tags?: string[];
+    [key: string]: unknown;
+}

package/dist/lib/template-types.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/templates.d.ts

@@ -0,0 +1,14 @@
+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, }: {
+    title: string;
+    header: string;
+    content: string;
+    projectName: string;
+    basePath?: string;
+    description?: string;
+    bodySlug?: string;
+    buildMeta?: string;
+}) => string;
+export declare const timelineTemplate: (props: TimelineTemplateProps) => string;
+export declare const postTemplate: (props: PostTemplateProps) => string;

package/dist/lib/templates.js

@@ -0,0 +1,158 @@
+import { linkJiraIds } from './jira-helpers.js';
+const html = (strings, ...values) => {
+    return strings.reduce((acc, str, i) => acc + str + (values[i] ?? ''), '');
+};
+export const tabsComponent = (tabs, defaultActive = 0) => {
+    const tabsHtml = tabs
+        .map((tab, index) => `<div class="tab ${index === defaultActive ? 'active' : ''}" role="tab" aria-selected="${index === defaultActive}" aria-controls="${tab.id}" tabindex="${index === defaultActive ? '0' : '-1'}" onclick="showTab(event, '${tab.id}')">${tab.title}</div>`)
+        .join('');
+    const sectionsHtml = tabs
+        .map((tab, index) => `<div id="${tab.id}" class="content-section" role="tabpanel" style="${index === defaultActive ? '' : 'display:none;'}">${tab.content}</div>`)
+        .join('');
+    return html `<div class="tabs-wrapper">
+    <div class="tabs" id="tabs" role="tablist" aria-label="Navigation tabs">${tabsHtml}</div>
+    ${sectionsHtml}
+  </div>`;
+};
+export const layout = ({ title, header, content, projectName, basePath = './', description, bodySlug, buildMeta, }) => html `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${title} | ${projectName}</title>
+    ${description ? `<meta name="description" content="${description.replace(/"/g, '"').substring(0, 160)}">` : ''}
+    <link rel="icon" type="image/svg+xml" href="${basePath}favicon.svg">
+    <link rel="stylesheet" href="${basePath}style.css">
+</head>
+<body${bodySlug ? ` data-page-slug="${bodySlug}"` : ''}>
+    ${header}<main>${content}</main>
+    <footer>${buildMeta ? `<p class="build-time">${buildMeta}</p>` : ''}</footer>
+    <script src="${basePath}logbook.js"></script>
+</body></html>`;
+const navLink = (entry, dir) => {
+    const label = dir === 'prev' ? '← Previous' : 'Next →';
+    const t = `${entry.ticket ? `${entry.ticket}: ` : ''}${entry.title}`;
+    return `<a href="../${entry.slug}/index.html" class="post-nav-link"><span class="post-nav-label">${label}</span><span class="post-nav-title">${t}</span></a>`;
+};
+const renderWorkspaces = (workspaces) => {
+    if (!workspaces || workspaces.length === 0)
+        return '';
+    return workspaces.map((ws) => `<span class="tag-badge tag-workspace">${ws}</span>`).join('');
+};
+const renderTagsAndWorkspaces = (tags, workspaces) => {
+    const tagsHtml = tags && tags.length > 0
+        ? tags.map((tag) => `<span class="tag-badge tag-${tag.replace('#', '')}">${tag}</span>`).join('')
+        : '';
+    const wsHtml = renderWorkspaces(workspaces);
+    if (!tagsHtml && !wsHtml)
+        return '';
+    return html `<div class="tags-wrapper">${tagsHtml}${wsHtml}</div>`;
+};
+// Renders a compact list of git commits to embed in the Technical Log tab.
+const renderCommits = (commits) => {
+    if (!commits || commits.length === 0)
+        return '';
+    const rows = commits
+        .map((c) => `<div class="commit-item"><span class="commit-sha">${c.sha}</span><span class="commit-message">${c.message}</span><span class="commit-time" title="${c.timestamp}">${c.relativeTime}</span></div>`)
+        .join('');
+    return `<div class="commit-list"><h3 class="commit-list-heading">Git Commits</h3>${rows}</div>`;
+};
+const renderTimelineEntryItem = (e) => html `<div class="timeline-item" data-entry-slug="${e.slug}">
+    <a class="timeline-card" href="./${e.slug}/index.html"
+      ><div class="item-content">
+        <div class="item-meta">
+          <span data-date="${e.dateStart}">${e.displayDate}</span> • <span class="sort-time">${e.sortTime}</span> •
+          ${e.llm ? ` ${e.llm} via ` : ''}${e.harness}${e.prompter ? ` / ${e.prompter}` : ''}
+        </div>
+        <h3 class="item-title">
+          <span class="new-badge" style="display:none;">NEW</span>${e.ticket ? `${e.ticket}: ` : ''}${e.title}
+        </h3>
+        <div class="item-summary">${e.summary}</div>
+        ${renderTagsAndWorkspaces(e.tags, e.workspaces)}
+      </div>
+      <span class="item-arrow">›</span></a
+    >
+  </div>`;
+const renderTimelineCommitItem = (c, jiraBaseUrl, jiraPrefix) => {
+    const message = jiraBaseUrl && jiraPrefix ? linkJiraIds(c.message, jiraBaseUrl, jiraPrefix) : c.message;
+    return `<div class="timeline-item timeline-item--commit"><div class="commit-chip"><span class="commit-sha">${c.sha}</span><span class="commit-message">${message}</span><span class="commit-time" title="${c.timestamp}">${c.relativeTime}</span></div></div>`;
+};
+const renderTimelineTagItem = (t) => {
+    const formatted = new Date(t.timestamp)
+        .toLocaleString('de-DE', {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    })
+        .replace(',', '');
+    return `<div class="timeline-item timeline-item--tag"><div class="tag-chip"><span class="tag-chip-icon">🏷</span><span class="tag-chip-name">${t.name}</span><span class="tag-chip-date" title="${t.timestamp}">${formatted}</span></div></div>`;
+};
+export const timelineTemplate = (props) => {
+    const { projectName, groups, readmeHtml, aboutHtml, jiraBaseUrl, jiraPrefix } = props;
+    const timelineTab = html `<div class="timeline">
+    ${groups
+        .map((g) => html `<section class="month-group">
+            <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);
+    })
+        .join('')}
+          </section>`)
+        .join('')}
+  </div>`;
+    return html `<header>
+      <h1>${projectName}</h1>
+      <p class="tagline">A brief summary of the recent changes to the project.</p>
+    </header>
+    ${tabsComponent([
+        { id: 'timeline', title: 'Timeline', content: timelineTab },
+        { id: 'readme', title: 'Project Readme', content: readmeHtml || '<p>No README available.</p>' },
+        { id: 'about', title: 'About this Logbook', content: aboutHtml || '<p>No information available.</p>' },
+    ], 0)}`;
+};
+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 jiraBtn = jiraUrl
+        ? `<a href="${jiraUrl}" class="jira-link-btn" target="_blank" rel="noopener noreferrer">View in Jira ↗</a>`
+        : '';
+    const tabBtn = (id, label, active = false) => `<div class="tab${active ? ' active' : ''}" role="tab" aria-selected="${active}" aria-controls="${id}" tabindex="${active ? '0' : '-1'}" onclick="showTab(event, '${id}')">${label}</div>`;
+    return html `<header>
+      <h1>${title}</h1>
+      <div class="tagline">
+        <span data-date="${dateStart}">${displayDate}</span> •
+        ${llm ? `${llm} via ` : ''}${harness}${prompter ? ` / ${prompter}` : ''} • v${version}
+      </div>
+    </header>
+    <article class="tabs-wrapper">
+      <div class="action-bar">
+        <a href="../index.html" class="back-link">← Back to Timeline</a>
+        <div class="action-tabs-wrapper">
+          <div class="tabs" role="tablist" aria-label="Entry sections">
+            ${tabBtn('story', 'Story', true)}${tabBtn('spec', 'Original Spec')}${tabBtn('log', 'Technical Log')}
+          </div>
+        </div>
+        ${jiraBtn ? `${jiraBtn}` : ''}
+      </div>
+      <div class="content-sections">
+        <div id="story" class="content-section" role="tabpanel">
+          ${renderTagsAndWorkspaces(tags, workspaces)}${content}
+        </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)}
+        </div>
+      </div>
+      <nav class="post-nav">
+        <div class="post-nav-prev">${prevEntry ? navLink(prevEntry, 'prev') : '<span></span>'}</div>
+        <div class="post-nav-next">${nextEntry ? navLink(nextEntry, 'next') : '<span></span>'}</div>
+      </nav>
+    </article>`;
+};

package/dist/linters/frontmatter.d.ts

@@ -0,0 +1,3 @@
+import { Linter } from '../lib/lint-types.js';
+declare const linter: Linter;
+export default linter;

package/dist/linters/frontmatter.js

@@ -0,0 +1,68 @@
+// These fields are defined by the tool schema — not user-configurable.
+const ALLOWED_FRONTMATTER_FIELDS = [
+    'ticket',
+    'title',
+    'prompter',
+    'harness',
+    'llm',
+    'summary',
+    'tags',
+    'dateStart',
+    'dateEnd',
+    'workspaces',
+    'author',
+];
+const linter = {
+    name: 'frontmatter',
+    description: 'Validates frontmatter fields and tags',
+    async check(context) {
+        if (!context.entryName || !context.frontmatter)
+            return [];
+        const { frontmatter, config } = context;
+        const issues = [];
+        // 1. Mandatory Fields
+        const requiredFields = ['ticket', 'title', 'prompter', 'harness', 'llm', 'summary', 'tags', 'dateStart', 'dateEnd'];
+        for (const field of requiredFields) {
+            if (!frontmatter[field]) {
+                issues.push({
+                    level: 'error',
+                    category: 'frontmatter',
+                    message: `Missing mandatory field: ${field}`,
+                });
+            }
+        }
+        // 2. Allowed Fields — enforced by tool schema, not user config
+        const actualFields = Object.keys(frontmatter);
+        for (const field of actualFields) {
+            if (!ALLOWED_FRONTMATTER_FIELDS.includes(field)) {
+                issues.push({
+                    level: 'warning',
+                    category: 'frontmatter',
+                    message: `Unknown frontmatter field: '${field}'. Allowed: ${ALLOWED_FRONTMATTER_FIELDS.join(', ')}`,
+                });
+            }
+        }
+        // 3. Tags validation
+        const allowedTags = config.tags?.allowed || [];
+        if (!frontmatter.tags || !Array.isArray(frontmatter.tags) || frontmatter.tags.length === 0) {
+            issues.push({
+                level: 'error',
+                category: 'frontmatter',
+                message: 'Missing mandatory field: tags (at least one tag required)',
+            });
+        }
+        else if (allowedTags.length > 0) {
+            for (const tag of frontmatter.tags) {
+                if (!allowedTags.includes(tag)) {
+                    issues.push({
+                        level: 'error',
+                        category: 'tag',
+                        message: `Invalid tag "${tag}". Allowed tags: "${allowedTags.join('", "')}". Use double quotes to format tags in markdown.`,
+                    });
+                }
+            }
+        }
+        return issues;
+    },
+};
+export default linter;

package/dist/linters/index.d.ts

@@ -0,0 +1 @@
+export declare const linters: import("../lib/lint-types.js").Linter[];

package/dist/linters/index.js

@@ -0,0 +1,18 @@
+import frontmatter from './frontmatter.js';
+import jiraPrefix from './jira-prefix.js';
+import links from './links.js';
+import lockfile from './lockfile.js';
+import placeholders from './placeholders.js';
+import projectIntegrity from './project-integrity.js';
+import readability from './readability.js';
+import workspaces from './workspaces.js';
+export const linters = [
+    frontmatter,
+    jiraPrefix,
+    links,
+    lockfile,
+    placeholders,
+    projectIntegrity,
+    readability,
+    workspaces,
+];

package/dist/linters/jira-prefix.d.ts

@@ -0,0 +1,3 @@
+import { Linter } from '../lib/lint-types.js';
+declare const linter: Linter;
+export default linter;

package/dist/linters/jira-prefix.js

@@ -0,0 +1,34 @@
+const linter = {
+    name: 'jira-prefix',
+    description: 'Validates entry names and ticket IDs against jiraPrefix config',
+    async check(context) {
+        if (!context.entryName || !context.frontmatter || !context.config.jiraPrefix)
+            return [];
+        const { entryName, frontmatter, config } = context;
+        const issues = [];
+        const jiraPrefix = config.jiraPrefix;
+        if (!jiraPrefix)
+            return [];
+        const jiraPrefixPattern = new RegExp(`^${jiraPrefix}-\\d+-`, 'i');
+        if (!jiraPrefixPattern.test(entryName)) {
+            issues.push({
+                level: 'error',
+                category: 'jira_prefix',
+                message: `Entry folder '${entryName}' does not match configured prefix '${jiraPrefix}'. Expected format: ${jiraPrefix}-<ID>-<slug>`,
+            });
+        }
+        const ticketMatch = frontmatter.ticket;
+        if (typeof ticketMatch === 'string') {
+            const ticketPrefix = ticketMatch.split('-')[0];
+            if (ticketPrefix.toUpperCase() !== jiraPrefix.toUpperCase()) {
+                issues.push({
+                    level: 'error',
+                    category: 'jira_prefix',
+                    message: `Entry '${entryName}' has ticket '${frontmatter.ticket}' which doesn't match configured prefix '${jiraPrefix}'.`,
+                });
+            }
+        }
+        return issues;
+    },
+};
+export default linter;

package/dist/linters/links.d.ts

@@ -0,0 +1,3 @@
+import { Linter } from '../lib/lint-types.js';
+declare const linter: Linter;
+export default linter;

package/dist/linters/links.js

@@ -0,0 +1,28 @@
+import fs from 'fs-extra';
+import { join } from 'node:path';
+const linter = {
+    name: 'links',
+    description: 'Validates relative links within entries',
+    async check(context) {
+        if (!context.entryName || !context.content || !context.entryPath)
+            return [];
+        const issues = [];
+        const linkRegex = /\[.*?\]\((.*?)\)/g;
+        let match;
+        while ((match = linkRegex.exec(context.content)) !== null) {
+            const link = match[1];
+            if (link.startsWith('http') || link.startsWith('#'))
+                continue;
+            const linkedPath = join(context.entryPath, link);
+            if (!(await fs.pathExists(linkedPath))) {
+                issues.push({
+                    level: 'error',
+                    category: 'link',
+                    message: `Cannot resolve: ${link}`,
+                });
+            }
+        }
+        return issues;
+    },
+};
+export default linter;

package/dist/linters/lockfile.d.ts

@@ -0,0 +1,3 @@
+import { Linter } from '../lib/lint-types.js';
+declare const linter: Linter;
+export default linter;

package/dist/linters/lockfile.js

@@ -0,0 +1,20 @@
+import { getActiveEntry } from '../lib/session.js';
+const linter = {
+    name: 'lockfile',
+    description: 'Checks if a logbook entry is still active',
+    async check(context) {
+        if (context.entryName)
+            return [];
+        const issues = [];
+        const active = await getActiveEntry();
+        if (active && active.source === 'lockfile') {
+            issues.push({
+                level: 'warning',
+                category: 'active',
+                message: `Entry '${active.slug}' is still active via lockfile. Run 'logbook release' after the current ticket is approved by prompter.`,
+            });
+        }
+        return issues;
+    },
+};
+export default linter;

package/dist/linters/placeholders.d.ts

@@ -0,0 +1,3 @@
+import { Linter } from '../lib/lint-types.js';
+declare const linter: Linter;
+export default linter;

package/dist/linters/placeholders.js

@@ -0,0 +1,62 @@
+import fs from 'fs-extra';
+import { join } from 'node:path';
+const linter = {
+    name: 'placeholders',
+    description: 'Checks for unremoved template placeholders',
+    async check(context) {
+        if (!context.entryName || !context.content || !context.entryPath)
+            return [];
+        const issues = [];
+        // Read the raw file to extract the frontmatter block. context.content is body-only
+        // (gray-matter strips the frontmatter), so we cannot check it for frontmatter placeholders.
+        // Fall back to context.content if indexPath is unavailable (e.g. in unit tests).
+        let rawFile = context.content;
+        if (context.indexPath && (await fs.pathExists(context.indexPath))) {
+            rawFile = await fs.readFile(context.indexPath, 'utf8');
+        }
+        // Scan only the frontmatter block for bracket-style placeholders to avoid false
+        // positives when placeholder names are mentioned in the narrative body.
+        const frontmatterMatch = rawFile.match(/^---\n[\s\S]*?\n---/);
+        const frontmatterBlock = frontmatterMatch ? frontmatterMatch[0] : rawFile;
+        const frontmatterPlaceholders = [
+            '[PROMPTER]',
+            '[HARNESS]',
+            '[LLM]',
+            '[WRITE_SUMMARY_HERE]',
+            '[DATE_START]',
+            // '[DATE_END]' is automatically set by `logbook release`, so it is not
+            // checked here. It is expected to be present in draft tickets and will be
+            // replaced with the actual release timestamp when the ticket is finalized.
+        ];
+        for (const placeholder of frontmatterPlaceholders) {
+            if (frontmatterBlock.includes(placeholder)) {
+                issues.push({
+                    level: 'error',
+                    category: 'placeholder',
+                    message: `Unremoved placeholder in index.md: ${placeholder}`,
+                });
+            }
+        }
+        // Check boilerplate body text against the full content (body only is fine here).
+        if (context.content.includes('TODO: ')) {
+            issues.push({
+                level: 'error',
+                category: 'placeholder',
+                message: 'Found "TODO: "\'s in index.md: Write a polished, highly readable "short story" of the change here. Use the hints provided inside the file.',
+            });
+        }
+        const ticketPath = join(context.entryPath, 'ticket.md');
+        if (await fs.pathExists(ticketPath)) {
+            const ticketContent = await fs.readFile(ticketPath, 'utf8');
+            if (ticketContent.includes('(Paste Jira/Linear issue description here)')) {
+                issues.push({
+                    level: 'error',
+                    category: 'placeholder',
+                    message: 'Unremoved placeholder in ticket.md: (Paste Jira/Linear issue description here)',
+                });
+            }
+        }
+        return issues;
+    },
+};
+export default linter;

package/dist/linters/project-integrity.d.ts

@@ -0,0 +1,3 @@
+import { Linter } from '../lib/lint-types.js';
+declare const linter: Linter;
+export default linter;

package/dist/linters/project-integrity.js

@@ -0,0 +1,29 @@
+const linter = {
+    name: 'project-integrity',
+    description: 'Checks if project files are missing or outdated',
+    async check(context) {
+        if (context.entryName)
+            return [];
+        const issues = [];
+        const { getProjectStatus } = await import('../lib/migrations.js');
+        const projectStatus = await getProjectStatus();
+        for (const file of projectStatus) {
+            if (file.status === 'OUTDATED') {
+                issues.push({
+                    level: 'warning',
+                    category: 'outdated',
+                    message: `${file.name} is different from the latest template. Run 'logbook upgrade' to sync.`,
+                });
+            }
+            else if (file.status === 'MISSING') {
+                issues.push({
+                    level: 'error',
+                    category: 'missing',
+                    message: `${file.name} is missing. Run 'logbook upgrade' to create it.`,
+                });
+            }
+        }
+        return issues;
+    },
+};
+export default linter;

package/dist/linters/readability.d.ts

@@ -0,0 +1,3 @@
+import { Linter } from '../lib/lint-types.js';
+declare const linter: Linter;
+export default linter;

package/dist/linters/readability.js

@@ -0,0 +1,41 @@
+const linter = {
+    name: 'readability',
+    description: 'Checks for readability, headings usage, and length',
+    async check(context) {
+        if (!context.entryName || !context.content)
+            return [];
+        const issues = [];
+        const contentParts = context.content.split('---');
+        // Content is after the second '---' if frontmatter exists
+        const contentWithoutFrontmatter = (contentParts.length >= 3 ? contentParts.slice(2).join('---') : context.content).trim();
+        if (contentWithoutFrontmatter.length === 0)
+            return [];
+        // 1. Heading Check
+        const h2Match = contentWithoutFrontmatter.match(/^##\s+.+$/gm);
+        if (!h2Match || h2Match.length < 1) {
+            issues.push({
+                level: 'warning',
+                category: 'readability',
+                message: 'Narrative should use at least one H2 heading (##) to group content.',
+            });
+        }
+        // 2. Length Check
+        const words = contentWithoutFrontmatter.split(/\s+/).filter((w) => w.length > 0).length;
+        if (words < 50) {
+            issues.push({
+                level: 'warning',
+                category: 'readability',
+                message: `Narrative seems too short (${words} words). Aim for a professional "short story".`,
+            });
+        }
+        else if (words > 1000) {
+            issues.push({
+                level: 'warning',
+                category: 'readability',
+                message: `Narrative is quite long (${words} words). Consider being more concise.`,
+            });
+        }
+        return issues;
+    },
+};
+export default linter;

package/dist/linters/workspaces.d.ts

@@ -0,0 +1,3 @@
+import { Linter } from '../lib/lint-types.js';
+declare const linter: Linter;
+export default linter;