project-logbook 1.0.0 → 1.2.0

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

@@ -22,10 +22,18 @@ export interface TimelineTemplateProps {
     repositoryUrl?: string;
     currentPage?: number;
     totalPages?: number;
+    researchEntries?: TimelineResearchItem[];
+    adrItems?: TimelineAdrItem[];
+    customTabs?: {
+        id: string;
+        title: string;
+        items: TimelineResearchItem[];
+    }[];
+}
+export interface TimelineResearchItem extends TimelineEntry {
+    status: string;
+    updated: string;
 }
-/**
- * Configuration for a month group in the timeline
- */
 export interface TimelineGroup {
     month: string;
     items: TimelineItem[];
@@ -72,6 +80,10 @@ export interface TimelineEntry {
     summary: string;
     tags?: string[];
     workspaces?: string[];
+    teaserImage?: {
+        src: string;
+        ratio: number;
+    };
 }
 /**
  * A standalone git commit shown as a non-clickable info item in the timeline.
@@ -128,6 +140,7 @@ export interface PostTemplateProps {
     slug?: string;
     tags?: string[];
     workspaces?: string[];
+    backLink?: string;
 }
 /**
  * Configuration for navigation between entries

package/dist/lib/templates.d.ts

@@ -1,9 +1,10 @@
-import type { TabConfig, TimelineTemplateProps, PostTemplateProps } from './template-types.js';
+import type { TabConfig, TimelineTemplateProps } from './template-types.js';
+export { postTemplate } from './post-template.js';
 export declare const tabsComponent: (tabs: TabConfig[], defaultActive?: number) => {
     tabsHtml: string;
     sectionsHtml: string;
 };
-export declare const layout: ({ title, header, content, projectName, basePath, description, bodySlug, buildMeta, includeRssLink, prevUrl, nextUrl, }: {
+interface LayoutProps {
     title: string;
     header: string;
     content: string;
@@ -15,14 +16,11 @@ export declare const layout: ({ title, header, content, projectName, basePath, d
     includeRssLink?: boolean;
     prevUrl?: string;
     nextUrl?: string;
-}) => string;
+}
+export declare const layout: ({ title, header, content, projectName, basePath, description, bodySlug, buildMeta, includeRssLink, prevUrl, nextUrl, }: LayoutProps) => string;
 export declare const timelineTemplate: (props: TimelineTemplateProps & {
     includeRssLink?: boolean;
 }) => {
     header: string;
     content: string;
 };
-export declare const postTemplate: (props: PostTemplateProps) => {
-    header: string;
-    content: string;
-};

package/dist/lib/templates.js

@@ -1,6 +1,9 @@
-import { ATTR_PAGE_SLUG, ATTR_DATA_DATE } from './html-attributes.js';
-import { escapeHtml, validateUrlScheme } from './html-escape.js';
-import { html, navLink, renderTagsAndWorkspaces, renderCommits, renderTimelineEntryItem, renderTimelineCommitItem, renderTimelineTagItem, renderTimelineAdrItem, paginationLinks, } from './template-helpers.js';
+import { ATTR_PAGE_SLUG } from './html-attributes.js';
+import { escapeHtml } from './html-escape.js';
+import { html, renderTimelineEntryItem, renderTimelineCommitItem, renderTimelineTagItem, renderTimelineAdrItem, paginationLinks, } from './template-helpers.js';
+import { renderCustomCard } from './custom-card-renderer.js';
+import { autolinkReferences, getRegisteredResearchEntries } from './autolink.js';
+export { postTemplate } from './post-template.js';
 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="${escapeHtml(tab.id)}" tabindex="${index === defaultActive ? '0' : '-1'}" onclick="showTab(event, '${escapeHtml(tab.id)}')">${escapeHtml(tab.title)}</div>`)
@@ -13,6 +16,9 @@ export const tabsComponent = (tabs, defaultActive = 0) => {
 export const layout = ({ title, header, content, projectName, basePath = './', description, bodySlug, buildMeta, includeRssLink = false, prevUrl, nextUrl, }) => {
     const metaDescription = description ||
         `A chronological timeline of recent development changes, narrative updates, and commits for ${projectName}.`;
+    const registeredResearchEntries = getRegisteredResearchEntries();
+    const processedHeader = registeredResearchEntries.length > 0 ? autolinkReferences(header, registeredResearchEntries, basePath) : header;
+    const processedContent = registeredResearchEntries.length > 0 ? autolinkReferences(content, registeredResearchEntries, basePath) : content;
     return html `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -26,7 +32,7 @@ export const layout = ({ title, header, content, projectName, basePath = './', d
     <link rel="stylesheet" href="${basePath}style.css">
 </head>
 <body${bodySlug ? ` ${ATTR_PAGE_SLUG}="${bodySlug}"` : ''} class="tabs-wrapper">
-    ${header}<main>${content}</main>
+    ${processedHeader}<main>${processedContent}</main>
     <footer>
       ${buildMeta ? `<p class="build-time">${buildMeta}${includeRssLink ? ` • <a href="${basePath}rss.xml">RSS Feed</a>` : ''}</p>` : ''}
     </footer>
@@ -61,11 +67,35 @@ export const timelineTemplate = (props) => {
         .join('')}
       ${paginationLinks(currentPage, totalPages)}
     </div>`;
-    const { tabsHtml, sectionsHtml } = 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);
+    const tabs = [{ id: 'timeline', title: 'Timeline', content: timelineTab }];
+    if (props.adrItems && props.adrItems.length > 0) {
+        const adrTabHtml = html `
+      <div class="timeline">${props.adrItems.map((item) => renderTimelineAdrItem(item)).join('')}</div>
+    `;
+        tabs.push({ id: 'adrs', title: 'ADRs', content: adrTabHtml });
+    }
+    if (props.researchEntries && props.researchEntries.length > 0) {
+        const researchHtml = html `
+      <div class="timeline">
+        ${props.researchEntries.map((e) => renderCustomCard(e, 'research', 'RESEARCH')).join('')}
+      </div>
+    `;
+        tabs.push({ id: 'research', title: 'Research', content: researchHtml });
+    }
+    if (props.customTabs) {
+        for (const tab of props.customTabs) {
+            if (tab.items && tab.items.length > 0) {
+                const tabHtml = html `
+          <div class="timeline">
+            ${tab.items.map((e) => renderCustomCard(e, tab.id, tab.title.toUpperCase())).join('')}
+          </div>
+        `;
+                tabs.push({ id: tab.id, title: tab.title, content: tabHtml });
+            }
+        }
+    }
+    tabs.push({ 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>' });
+    const { tabsHtml, sectionsHtml } = tabsComponent(tabs, 0);
     const header = html `<header>
     <div class="header-inner">
       <h1><a href="./index.html">${escapeHtml(projectName)}</a></h1>
@@ -77,48 +107,4 @@ export const timelineTemplate = (props) => {
   </header>`;
     return { header, content: sectionsHtml };
 };
-export const postTemplate = (props) => {
-    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
-        ? `<a href="${escapeHtml(validatedJiraUrl)}" 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="${escapeHtml(id)}" tabindex="${active ? '0' : '-1'}" onclick="showTab(event, '${escapeHtml(id)}')">${escapeHtml(label)}</div>`;
-    const header = html `<header>
-    <div class="header-inner">
-      <h1>${escapeHtml(title)}</h1>
-      <div class="tagline">
-        <span ${ATTR_DATA_DATE}="${dateStart}">${displayDate}</span> •
-        ${llm ? `${escapeHtml(llm)} via ` : ''}${escapeHtml(harness)}${prompter ? ` / ${escapeHtml(prompter)}` : ''} •
-        v${version}
-      </div>
-      <div class="header-nav">
-        <div class="header-nav-left">
-          <a href="../index.html" class="back-link">← Back to Timeline</a>
-        </div>
-        <div class="tabs" role="tablist" aria-label="Entry sections">
-          ${tabBtn('story', 'Story', true)}${tabBtn('spec', 'Original Spec')}${tabBtn('log', 'Technical Log')}
-        </div>
-        <div class="header-nav-right">${jiraBtn ? `${jiraBtn}` : '<span></span>'}</div>
-      </div>
-    </div>
-  </header>`;
-    const mainContent = html `<article>
-    <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, repositoryUrl)}
-      </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>`;
-    return { header, content: mainContent };
-};
 //# sourceMappingURL=templates.js.map

package/dist/lib/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":"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"}

package/dist/templates/CONTRIBUTING.md

@@ -65,7 +65,17 @@ Once the work is ready:
 
 The linter enforces rules to be followed.
 
-### 4. Final Review
+### 4. Interactive Local QA Loop
+Development is an iterative process. Expect to go through several feedback loops with the prompter before a ticket is finalized:
+- **Test & Challenge**: The prompter will run and test your changes, challenge architectural patterns, and suggest revisions.
+- **Cycle Routine**: During each feedback round:
+  1. Update code according to feedback.
+  2. Log key decisions, errors, and pivots in `log.md` (`logbook log "..."`).
+  3. Keep the story in `index.md` fully up-to-date with any design/code changes.
+  4. Run `npm run pre` to verify linting and tests pass.
+- **Commit Optimization**: Once the implementation is solid, optimize the final git commit message to match project standards before releasing.
+
+### 5. Final Review
 Use the preview command to see how your entry looks in the context of the whole project:
 ```bash
 logbook preview
@@ -84,4 +94,35 @@ If `jiraPrefix` is configured, entry folder names and ticket references must mat
 ## Tone & Style
 - **Narrative over Lists**: In `index.md`, tell a story. Why did we make this change? What were the challenges?
 - **Technical Precision**: In `log.md`, be specific. Mention file paths, error messages, and specific design patterns. Log in real time — do not reconstruct after the fact.
-- **No Boilerplate in Commits**: All template placeholders must be replaced or removed before `logbook release`.
+- **No Boilerplate in Commits**: All template placeholders must be replaced or removed before `logbook release`.
+
+## Research Logs
+For exploratory research, technical spike investigations, and architectural decision groundwork, we use **Research Logs**.
+
+- **Required Setup**: Before creating your first research log, ensure that your configured research directory exists on your filesystem (for example, create it using `mkdir -p docs/research`).
+- **Location**: Stored in `docs/research/` (configurable via `researchDir` in `.project-logbook`).
+- **Scaffolding**: Run `logbook new [ID] [Slug] --research` or `logbook new -r` to scaffold. This automatically generates a numeric ID prefixed with `RES-` (e.g., `RES-1`).
+- **Commands**: Commands like `logbook start RES-1`, `logbook log`, and `logbook release` work transparently.
+- **Auto-Activity Tracking**: Writing a log message via `logbook log` automatically updates the `updated` frontmatter field inside the research log's `index.md`.
+- **Status Lifecycle**: The frontmatter `status` field tracks progress: `active`, `paused`, `postponed`, or `completed`.
+- **Visuals**: Research logs are compiled and displayed under a dedicated "Research" tab on the built logbook homepage, sorted by their latest `updated` date.
+
+## Custom Storyline Types
+Beyond standard logbook entries and Research Logs, you can define completely custom storyline types (e.g., "analyses", "spikes", "decisions") in `.project-logbook`.
+
+- **Required Setup**: Define the custom types inside your `.project-logbook` configuration file under `customTypes` and ensure the directory exists on your filesystem:
+  ```json
+  {
+    "customTypes": {
+      "analyses": {
+        "prefix": "ANA",
+        "dir": "docs/analyses",
+        "tabTitle": "Analyses",
+        "sortBy": "updated"
+      }
+    }
+  }
+  ```
+- **Directory Setup**: Ensure the directory configured (e.g., `docs/analyses`) is created on your filesystem (for example, create it using `mkdir -p docs/analyses`).
+- **Scaffolding**: Run `logbook new [ID] [Slug] --type analyses` or `logbook new -t analyses` to scaffold the entry.
+- **Visuals**: Just like Research Logs, these custom types will automatically compile into dedicated tabs on the built logbook homepage using your specified `tabTitle`.

package/dist/templates/adr.md

@@ -0,0 +1,34 @@
+---
+id: [ID_NUM]
+title: [YAML_TITLE]
+status: "proposed"
+date: [DATE]
+author: "[AUTHOR]"
+superseded_by: null
+tags: []
+---
+
+# ADR [ID]: [TITLE]
+
+## Context
+[Describe the issue motivating this decision and any context that influences it.]
+
+## Considered Options
+1. **[Option A]**: [Brief description.]
+2. **[Option B]**: [Brief description.]
+
+## Decision
+[State the decision and briefly explain what it means in practice.]
+
+## Rationale
+[Explain why this option was chosen over the alternatives.]
+
+## Consequences
+
+### Positive
+*   [Benefit 1]
+*   [Benefit 2]
+
+### Negative
+*   [Drawback 1]
+*   [Drawback 2]

package/dist/templates/index.md

@@ -2,7 +2,7 @@
 # The ticket field should match the ID portion (e.g., LB-34)
 ticket: {{id}}
 # The title should be a human-readable description of the work
-title: {{title}}
+title: {{yamlTitle}}
 prompter: "[PROMPTER]"
 harness: "[HARNESS]"
 llm: "[LLM]"
@@ -27,9 +27,10 @@ TODO: Write a polished, highly readable ticket summary that reads like an engagi
 
 ### 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).
-- **Use bullet points:** TODO: Whenever listing multiple items (like friction points, test scenarios, or rewritten paths), use a bulleted list instead of a dense paragraph to make it scannable.
+- **Add thematic headings:** TODO: Break the narrative down into logical chapters using action-oriented Markdown subheadings that describe what was improved/solved (e.g., ### Improving TabGroup Accessibility, ### Binding Dialog Colors to the Theme) rather than dry, generic headers like "Friction" or "The Fix".
+- **Avoid forced bullet points:** TODO: Write in natural, flowing paragraphs (like in a dev blog post). Only use bullet points for actual, simple lists of items (e.g., list of modified files or configuration options), never to structure or split your main story thoughts.
 - **Use bold emphasis:** TODO: Bold key concepts, problems, and solutions to guide the reader's eye.
 - **Format code:** TODO: Use inline backticks for files, plugins, HTML elements, and code snippets (e.g., `src/lib/build-helpers.ts`).
-- **Keep paragraphs short:** TODO: Ensure no paragraph is longer than 3-4 sentences. Keep the pacing quick and engaging.
+- **Keep paragraphs short:** TODO: Ensure no paragraph is longer than 4 sentences. Keep the pacing quick and engaging.
+- **Weave the narrative:** TODO: Do not list all friction points in one massive block followed by all fixes/solutions in another. Instead, weave them together chronologically or by component/theme (e.g., describe the friction and its corresponding fix within the same chapter or paragraph).
 - **Do not state the obvious**: TODO: Passed tests, lints, pre-commit suites are mandatory and no ticket is released without this. This does not need to be mentioned

package/dist/templates/log.md

@@ -1,4 +1,4 @@
-# Technical Log: {{id}}-{{slug}}
+# Technical Log: {{id}} - {{title}}
 
 > **REMINDER**: Log your work in real-time using `logbook log "<message>"`. Don't wait until the end!
 > 

package/dist/templates/steer.txt

@@ -33,9 +33,22 @@ You MUST log your work continuously using `logbook log "<message>"`. This is not
 Phase 3: Synthesize
 1. When implementation is finished, write the narrative in `index.md`.
 2. Storytelling Mode: Explain the "Why" and the "Journey." Avoid simple technical bullet points.
+   - **Keep paragraphs short**: Max 4 sentences per paragraph to ensure fast-paced, readable prose.
+   - **Use bold & code formatting**: Use inline backticks for files/code, and bolding for key terms/problems.
+   - **Structure with H3 headings**: Use action-oriented subheadings describing the topic/component modified (e.g., ### Improving TabGroup Accessibility, ### Binding Dialog Colors to the Theme) instead of generic "Friction" or "Fix" headers.
+   - **Avoid forced lists**: Write in natural, flowing paragraphs. Only use bullet points for simple lists of items (e.g., files modified, options checked), never to split or structure your core narrative thoughts.
+   - **Weave friction & fix**: Do not separate all problems into one block and all solutions into another. Weave them together chronologically or group them by component/theme.
 3. Clean up all template placeholders and complete the frontmatter (author, summary, dates).
 
 Phase 4: Verify
 1. Run `npm run pre` (which includes `logbook lint` and other quality gates).
 2. Ensure there are no linter errors, unreplaced placeholders, or architectural violations before concluding your work. 
-3. Hand back to the prompter, who will review and run `logbook release`.
+3. Hand back to the prompter for local QA/review.
+
+Phase 5: Local QA & Iterative Refinement
+1. Expect feedback loops: The prompter will test your changes, challenge decisions, and request refinements.
+2. In each iteration loop:
+   - Log decisions and pivots in `log.md` in real-time (`logbook log "<message>"`).
+   - Update the story in `index.md` to reflect any design/code changes.
+   - Run verification again (`npm run pre`).
+3. Optimize the git commit message (conforming to project standards) before final release.

package/dist/templates/styles.css

@@ -169,6 +169,38 @@ main {
   transform: translateX(4px);
 }
 
+.teaser-image-right {
+  flex-shrink: 0;
+  max-width: 200px;
+  max-height: 120px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  overflow: hidden;
+  border-radius: 4px;
+}
+
+.teaser-image-right img {
+  max-width: 100%;
+  max-height: 100%;
+  object-fit: contain;
+}
+
+.teaser-image-bottom {
+  margin-top: 0.75rem;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  width: 100%;
+}
+
+.teaser-image-bottom img {
+  max-width: 100%;
+  max-height: 200px;
+  object-fit: contain;
+  border-radius: 4px;
+}
+
 /* Post Page */
 .back-link {
   display: inline-flex;

package/dist/utils/prompt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Standard-library CLI selection menu using Node's readline and raw mode.
+ * Moves cursor up/down, handles carriage return, Ctrl+C to abort, and hides the cursor.
+ * ponytail: simple raw-mode keyboard selection, no massive external prompt libraries.
+ */
+export declare function selectPrompt(message: string, choices: string[]): Promise<number>;

package/dist/utils/prompt.js

@@ -0,0 +1,59 @@
+import readline from 'node:readline';
+/**
+ * Standard-library CLI selection menu using Node's readline and raw mode.
+ * Moves cursor up/down, handles carriage return, Ctrl+C to abort, and hides the cursor.
+ * ponytail: simple raw-mode keyboard selection, no massive external prompt libraries.
+ */
+export async function selectPrompt(message, choices) {
+    if (choices.length === 0) {
+        return -1;
+    }
+    const { stdin, stdout } = process;
+    // Non-interactive / non-TTY fallback to prevent hanging in CI/scripts
+    if (!stdin.isTTY) {
+        return 0;
+    }
+    return new Promise((resolve) => {
+        let index = 0;
+        const render = () => {
+            stdout.write('\r\x1B[K' + message + '\n');
+            choices.forEach((choice, i) => {
+                const prefix = i === index ? '> ' : '  ';
+                stdout.write('\x1B[K' + prefix + choice + '\n');
+            });
+            // Move cursor back up to the start of the list
+            stdout.write(`\x1B[${choices.length + 1}A`);
+        };
+        readline.emitKeypressEvents(stdin);
+        stdin.setRawMode(true);
+        stdout.write('\x1B[?25l'); // Hide cursor
+        render();
+        const onKey = (_str, key) => {
+            if (key.name === 'up') {
+                index = (index - 1 + choices.length) % choices.length;
+                render();
+            }
+            else if (key.name === 'down') {
+                index = (index + 1) % choices.length;
+                render();
+            }
+            else if (key.name === 'return') {
+                cleanup();
+                resolve(index);
+            }
+            else if (key.ctrl && key.name === 'c') {
+                cleanup();
+                process.exit(130); // 130 is standard SIGINT exit code
+            }
+        };
+        const cleanup = () => {
+            // Move cursor down past choices and show cursor again
+            stdout.write(`\x1B[${choices.length + 1}B\x1B[?25h\r`);
+            stdin.removeListener('keypress', onKey);
+            stdin.setRawMode(false);
+            stdin.pause(); // ponytail: pause stdin so Node can exit instead of hanging
+        };
+        stdin.on('keypress', onKey);
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/utils/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,OAAiB;IACnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAElC,sEAAsE;IACtE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;YAC1C,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;gBAC5B,MAAM,MAAM,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;gBACzC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;YACH,+CAA+C;YAC/C,MAAM,CAAC,KAAK,CAAC,QAAQ,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC,CAAC;QAEF,QAAQ,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACnC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc;QACzC,MAAM,EAAE,CAAC;QAET,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,GAAsC,EAAE,EAAE;YACrE,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACtB,KAAK,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;gBACtD,MAAM,EAAE,CAAC;YACX,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC/B,KAAK,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;gBACrC,MAAM,EAAE,CAAC;YACX,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;gBACxC,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC;YACxD,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,sDAAsD;YACtD,MAAM,CAAC,KAAK,CAAC,QAAQ,OAAO,CAAC,MAAM,GAAG,CAAC,cAAc,CAAC,CAAC;YACvD,KAAK,CAAC,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YACxC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACxB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,4DAA4D;QAC7E,CAAC,CAAC;QAEF,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-logbook",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "A command-line tool for project logbooks.",
   "workspaces": [
     "demo-app"
@@ -27,7 +27,7 @@
     "madge": "madge --circular --extensions ts --ts-config ./tsconfig.json src/index.ts",
     "jscpd": "jscpd src",
     "test": "vitest run",
-    "pre": "npm run format && npm run lint && npm audit && npm run test && npm run build && npm run knip && npm run madge && npm run jscpd && npm run dev build && npm run dev lint",
+    "pre": "npm run format && npm run lint && npm run test && npm run build && npm run knip && npm run madge && npm run jscpd && npm run dev build && npm run dev lint && npm audit --audit-level=high",
     "next": "node scripts/create-ticket-from-backlog.js",
     "link": "npm run build && npm link",
     "open": "npm run dev build && node scripts/open-and-view-dist.js"
@@ -46,7 +46,7 @@
     "@types/rss": "^0.0.32",
     "@typescript-eslint/eslint-plugin": "^8.32.1",
     "@typescript-eslint/parser": "^8.32.1",
-    "@vitest/coverage-v8": "^3.1.4",
+    "@vitest/coverage-v8": "^4.1.8",
     "cross-env": "^7.0.3",
     "eslint": "^9.27.0",
     "jscpd": "^4.2.4",
@@ -56,7 +56,7 @@
     "rimraf": "^6.1.3",
     "tsx": "^4.21.0",
     "typescript": "^6.0.3",
-    "vitest": "^3.1.4"
+    "vitest": "^4.1.8"
   },
   "overrides": {
     "typescript": "^6.0.3"

package/src/templates/CONTRIBUTING.md

@@ -65,7 +65,17 @@ Once the work is ready:
 
 The linter enforces rules to be followed.
 
-### 4. Final Review
+### 4. Interactive Local QA Loop
+Development is an iterative process. Expect to go through several feedback loops with the prompter before a ticket is finalized:
+- **Test & Challenge**: The prompter will run and test your changes, challenge architectural patterns, and suggest revisions.
+- **Cycle Routine**: During each feedback round:
+  1. Update code according to feedback.
+  2. Log key decisions, errors, and pivots in `log.md` (`logbook log "..."`).
+  3. Keep the story in `index.md` fully up-to-date with any design/code changes.
+  4. Run `npm run pre` to verify linting and tests pass.
+- **Commit Optimization**: Once the implementation is solid, optimize the final git commit message to match project standards before releasing.
+
+### 5. Final Review
 Use the preview command to see how your entry looks in the context of the whole project:
 ```bash
 logbook preview
@@ -84,4 +94,35 @@ If `jiraPrefix` is configured, entry folder names and ticket references must mat
 ## Tone & Style
 - **Narrative over Lists**: In `index.md`, tell a story. Why did we make this change? What were the challenges?
 - **Technical Precision**: In `log.md`, be specific. Mention file paths, error messages, and specific design patterns. Log in real time — do not reconstruct after the fact.
-- **No Boilerplate in Commits**: All template placeholders must be replaced or removed before `logbook release`.
+- **No Boilerplate in Commits**: All template placeholders must be replaced or removed before `logbook release`.
+
+## Research Logs
+For exploratory research, technical spike investigations, and architectural decision groundwork, we use **Research Logs**.
+
+- **Required Setup**: Before creating your first research log, ensure that your configured research directory exists on your filesystem (for example, create it using `mkdir -p docs/research`).
+- **Location**: Stored in `docs/research/` (configurable via `researchDir` in `.project-logbook`).
+- **Scaffolding**: Run `logbook new [ID] [Slug] --research` or `logbook new -r` to scaffold. This automatically generates a numeric ID prefixed with `RES-` (e.g., `RES-1`).
+- **Commands**: Commands like `logbook start RES-1`, `logbook log`, and `logbook release` work transparently.
+- **Auto-Activity Tracking**: Writing a log message via `logbook log` automatically updates the `updated` frontmatter field inside the research log's `index.md`.
+- **Status Lifecycle**: The frontmatter `status` field tracks progress: `active`, `paused`, `postponed`, or `completed`.
+- **Visuals**: Research logs are compiled and displayed under a dedicated "Research" tab on the built logbook homepage, sorted by their latest `updated` date.
+
+## Custom Storyline Types
+Beyond standard logbook entries and Research Logs, you can define completely custom storyline types (e.g., "analyses", "spikes", "decisions") in `.project-logbook`.
+
+- **Required Setup**: Define the custom types inside your `.project-logbook` configuration file under `customTypes` and ensure the directory exists on your filesystem:
+  ```json
+  {
+    "customTypes": {
+      "analyses": {
+        "prefix": "ANA",
+        "dir": "docs/analyses",
+        "tabTitle": "Analyses",
+        "sortBy": "updated"
+      }
+    }
+  }
+  ```
+- **Directory Setup**: Ensure the directory configured (e.g., `docs/analyses`) is created on your filesystem (for example, create it using `mkdir -p docs/analyses`).
+- **Scaffolding**: Run `logbook new [ID] [Slug] --type analyses` or `logbook new -t analyses` to scaffold the entry.
+- **Visuals**: Just like Research Logs, these custom types will automatically compile into dedicated tabs on the built logbook homepage using your specified `tabTitle`.

package/src/templates/adr.md

@@ -0,0 +1,34 @@
+---
+id: [ID_NUM]
+title: [YAML_TITLE]
+status: "proposed"
+date: [DATE]
+author: "[AUTHOR]"
+superseded_by: null
+tags: []
+---
+
+# ADR [ID]: [TITLE]
+
+## Context
+[Describe the issue motivating this decision and any context that influences it.]
+
+## Considered Options
+1. **[Option A]**: [Brief description.]
+2. **[Option B]**: [Brief description.]
+
+## Decision
+[State the decision and briefly explain what it means in practice.]
+
+## Rationale
+[Explain why this option was chosen over the alternatives.]
+
+## Consequences
+
+### Positive
+*   [Benefit 1]
+*   [Benefit 2]
+
+### Negative
+*   [Drawback 1]
+*   [Drawback 2]