project-logbook 1.1.0 → 1.2.0

package/README.md

@@ -71,3 +71,6 @@ Running `logbook init` creates a `.project-logbook` configuration file in your p
 }
 ```
 
+### Tests
+
+The [Demo App](./demo-app/README.md) README must be compiled to html too!

package/dist/commands/new-helpers.d.ts

@@ -0,0 +1,26 @@
+export declare function getGitUsername(): string;
+export declare function detectIdFromBranch(prefix: string): string | undefined;
+export declare function resolveInteractiveId({ input, prefix, nextId, isResearch, hasCustomType, jiraPrefix, }: {
+    input: string;
+    prefix: string;
+    nextId: string;
+    isResearch: boolean;
+    hasCustomType: boolean;
+    jiraPrefix?: string;
+}): string;
+export declare function writeAdrFile({ targetDir, entryId, entrySlug, originalTitle, nextIdNum, id_padded, }: {
+    targetDir: string;
+    entryId: string;
+    entrySlug: string;
+    originalTitle: string;
+    nextIdNum: number;
+    id_padded: string;
+}): Promise<void>;
+export declare function writeStandardEntryFiles({ entryDir, entryId, entrySlug, originalTitle, isResearch, hasCustomType, }: {
+    entryDir: string;
+    entryId: string;
+    entrySlug: string;
+    originalTitle: string;
+    isResearch: boolean;
+    hasCustomType: boolean;
+}): Promise<void>;

package/dist/commands/new-helpers.js

@@ -0,0 +1,103 @@
+import fs from 'fs-extra';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import { getTemplatesDir } from '../lib/migrations.js';
+import { getPackageVersion } from '../lib/package-version.js';
+import { getCurrentBranch } from '../lib/git-helpers.js';
+import { highlight, warning as warningStyle } from '../lib/theme.js';
+import { parseTicketId } from '../utils/id.js';
+export function getGitUsername() {
+    try {
+        return (execSync('git config user.name', { stdio: ['ignore', 'pipe', 'ignore'] })
+            .toString()
+            .trim() || 'Author');
+    }
+    catch {
+        return 'Author';
+    }
+}
+export function detectIdFromBranch(prefix) {
+    const branchName = getCurrentBranch();
+    if (branchName) {
+        const match = branchName.match(new RegExp(`(?:^|[/\\-_])(${prefix})-(\\d+)(?:-|$)`, 'i'));
+        if (match) {
+            const id = `${match[1].toUpperCase()}-${match[2]}`;
+            console.log(highlight(`Autodetected ID ${id} from Git branch '${branchName}'.`));
+            return id;
+        }
+    }
+    return undefined;
+}
+export function resolveInteractiveId({ input, prefix, nextId, isResearch, hasCustomType, jiraPrefix, }) {
+    const parsed = parseTicketId(input);
+    const bareNumber = /^\d+$/.test(input) ? parseInt(input, 10) : null;
+    if (parsed &&
+        !isResearch &&
+        !hasCustomType &&
+        jiraPrefix &&
+        parsed.prefix.toUpperCase() !== jiraPrefix.toUpperCase()) {
+        console.warn(warningStyle(`Warning: Prefix '${parsed.prefix}' doesn't match configured '${jiraPrefix}'. Using configured prefix.`));
+        return `${jiraPrefix}-${parsed.number}`;
+    }
+    else if (parsed) {
+        return input.toUpperCase();
+    }
+    else if (bareNumber !== null) {
+        return `${prefix}-${bareNumber}`;
+    }
+    else {
+        console.warn(warningStyle('Invalid ID format. Using auto-generated ID.'));
+        return nextId;
+    }
+}
+export async function writeAdrFile({ targetDir, entryId, entrySlug, originalTitle, nextIdNum, id_padded, }) {
+    const adrFile = join(targetDir, `${entryId}-${entrySlug}.md`);
+    const templatesDir = getTemplatesDir();
+    const adrTemplatePath = join(templatesDir, 'adr.md');
+    if (!fs.existsSync(adrTemplatePath)) {
+        throw new Error('Template adr.md not found in templates.');
+    }
+    let raw = await fs.readFile(adrTemplatePath, 'utf8');
+    const author = getGitUsername();
+    raw = raw
+        .replace(/\[ID_NUM\]/g, String(nextIdNum))
+        .replace(/\[ID\]/g, id_padded)
+        .replace(/\[TITLE\]/g, originalTitle)
+        .replace(/\[YAML_TITLE\]/g, JSON.stringify(originalTitle))
+        .replace(/\[DATE\]/g, new Date().toISOString())
+        .replace(/\[AUTHOR\]/g, author);
+    await fs.writeFile(adrFile, raw);
+}
+export async function writeStandardEntryFiles({ entryDir, entryId, entrySlug, originalTitle, isResearch, hasCustomType, }) {
+    await fs.mkdirp(entryDir);
+    const version = getPackageVersion();
+    const now = new Date();
+    const replacements = {
+        id: entryId,
+        slug: entrySlug,
+        title: originalTitle,
+        yamlTitle: JSON.stringify(originalTitle),
+        date: now.toISOString().split('T')[0],
+        time: now.toLocaleTimeString('en-GB', { hour: '2-digit', minute: '2-digit', second: '2-digit' }),
+        fullIso: now.toISOString(),
+        version: `v${version}`,
+    };
+    const templatesDir = getTemplatesDir();
+    const getTemplate = (name) => {
+        const p = join(templatesDir, name);
+        if (fs.existsSync(p))
+            return fs.readFileSync(p, 'utf8');
+        throw new Error(`Template ${name} not found.`);
+    };
+    const fillTemplate = (template) => {
+        return template.replace(/{{(\w+)}}/g, (_, key) => replacements[key] || `{{${key}}}`);
+    };
+    let indexTemplate = getTemplate('index.md');
+    if (isResearch || hasCustomType) {
+        indexTemplate = indexTemplate.replace('dateEnd: "[DATE_END]"', 'dateEnd: "[DATE_END]"\nstatus: active\nupdated: {{fullIso}}');
+    }
+    await fs.writeFile(join(entryDir, 'index.md'), fillTemplate(indexTemplate));
+    await fs.writeFile(join(entryDir, 'ticket.md'), fillTemplate(getTemplate('ticket.md')));
+    await fs.writeFile(join(entryDir, 'log.md'), fillTemplate(getTemplate('log.md')));
+}
+//# sourceMappingURL=new-helpers.js.map

package/dist/commands/new-helpers.js.map

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

package/dist/commands/new.js

@@ -1,91 +1,104 @@
 import fs from 'fs-extra';
 import { join } from 'node:path';
 import { createInterface } from 'node:readline';
-import { getConfig, getLogbookDirPath, getResearchDirPath } from '../lib/config.js';
+import { getConfig, getLogbookDirPath, getResearchDirPath, getAdrDirPath } 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 { header, highlight, errorMessage, successMessage, warningMessage } from '../lib/theme.js';
+import { getNextId } from '../utils/id.js';
 import { sanitiseSlug } from '../utils/slug.js';
-import { getCurrentBranch } from '../lib/git-helpers.js';
-const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-});
+import { selectPrompt } from '../utils/prompt.js';
+import { writeAdrFile, writeStandardEntryFiles, detectIdFromBranch, resolveInteractiveId } from './new-helpers.js';
 const question = (prompt) => {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
     return new Promise((resolve) => {
         rl.question(prompt, (answer) => {
+            rl.close();
             resolve(answer.trim());
         });
     });
 };
 export async function createNewEntry(id, slug, options) {
     const config = getConfig();
-    const isResearch = !!options?.research;
-    const customTypeName = options?.type;
+    let isResearch = !!options?.research, customTypeName = options?.type, isAdr = customTypeName?.toLowerCase() === 'adr';
+    if (!id && !slug && !options?.research && !options?.type) {
+        const types = [{ label: 'Default Logbook Entry', value: 'logbook', isResearch: false, isAdr: false }];
+        if (config.researchDir)
+            types.push({ label: 'Research Log', value: 'research', isResearch: true, isAdr: false });
+        if (config.adrDir)
+            types.push({ label: 'Architecture Decision Record (ADR)', value: 'adr', isResearch: false, isAdr: true });
+        if (config.customTypes) {
+            for (const [name, cc] of Object.entries(config.customTypes)) {
+                if (name.toLowerCase() !== 'adr') {
+                    types.push({
+                        label: `${cc.tabTitle || name} (${name})`,
+                        value: name,
+                        isResearch: false,
+                        isAdr: false,
+                        customTypeName: name,
+                    });
+                }
+            }
+        }
+        if (types.length > 1) {
+            const idx = await selectPrompt('Select the type of entry to create:', types.map((t) => t.label));
+            if (idx === -1)
+                process.exit(1);
+            const choice = types[idx];
+            isResearch = choice.isResearch;
+            isAdr = choice.isAdr;
+            customTypeName = choice.customTypeName;
+        }
+    }
     const customType = customTypeName && config.customTypes?.[customTypeName];
-    if (customTypeName && !customType) {
+    if (customTypeName && !customType && !isAdr) {
         console.error(errorMessage('Error', `Custom type "${customTypeName}" is not defined in .project-logbook config.`));
         process.exit(1);
     }
-    const targetDir = customType
-        ? join(process.cwd(), customType.dir)
-        : isResearch
-            ? getResearchDirPath(config) || join(process.cwd(), 'docs/research')
-            : getLogbookDirPath(config);
-    if (!(await fs.pathExists(targetDir))) {
+    const targetDir = isAdr
+        ? getAdrDirPath(config) || join(process.cwd(), 'docs/adr')
+        : customType
+            ? join(process.cwd(), customType.dir)
+            : isResearch
+                ? getResearchDirPath(config) || join(process.cwd(), 'docs/research')
+                : getLogbookDirPath(config);
+    if (!(await fs.pathExists(targetDir)))
         await fs.mkdirp(targetDir);
+    let nextIdNum = 1, id_padded = '';
+    if (isAdr && (await fs.pathExists(targetDir))) {
+        const parsedIds = (await fs.readdir(targetDir))
+            .map((f) => {
+            const m = f.match(/^(\d+)-/);
+            return m ? parseInt(m[1], 10) : null;
+        })
+            .filter((n) => n !== null);
+        if (parsedIds.length > 0)
+            nextIdNum = Math.max(...parsedIds) + 1;
+        id_padded = String(nextIdNum).padStart(4, '0');
     }
-    let entryId = id;
+    let entryId = isAdr ? id_padded : id;
     let entrySlug = slug;
-    // Autodetect ID from the current Git branch if not provided
-    if (!entryId) {
-        const branchName = getCurrentBranch();
-        if (branchName) {
-            const prefix = customType ? customType.prefix : isResearch ? 'RES' : config.jiraPrefix || 'LB';
-            const branchRegex = new RegExp(`(?:^|[/\\-_])(${prefix})-(\\d+)(?:-|$)`, 'i');
-            const match = branchName.match(branchRegex);
-            if (match) {
-                entryId = `${match[1].toUpperCase()}-${match[2]}`;
-                console.log(highlight(`Autodetected ID ${entryId} from Git branch '${branchName}'.`));
-            }
-        }
+    if (!entryId && !isAdr) {
+        const prefix = customType ? customType.prefix : isResearch ? 'RES' : config.jiraPrefix || 'LB';
+        entryId = detectIdFromBranch(prefix);
     }
     let originalTitle = '';
-    const typeDisplayName = customType ? customTypeName : isResearch ? 'research' : 'logbook';
-    // Interactive mode if no parameters provided
+    const typeDisplayName = isAdr ? 'ADR' : customType ? customTypeName : isResearch ? 'research' : 'logbook';
     if (!entryId || !entrySlug) {
         console.log(header(`\n📝 Creating a new ${typeDisplayName} entry (interactive mode)\n`));
-        if (!entryId) {
+        if (!entryId && !isAdr) {
             const prefix = customType ? customType.prefix : isResearch ? 'RES' : config.jiraPrefix || 'LB';
             const nextId = getNextId(targetDir, prefix);
             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 &&
-                    !isResearch &&
-                    !customType &&
-                    config.jiraPrefix &&
-                    parsed.prefix.toUpperCase() !== config.jiraPrefix.toUpperCase()) {
-                    console.warn(warningStyle(`Warning: Prefix '${parsed.prefix}' doesn't match configured '${config.jiraPrefix}'. Using configured prefix.`));
-                    entryId = `${config.jiraPrefix}-${parsed.number}`;
-                }
-                else if (parsed) {
-                    entryId = input.toUpperCase();
-                }
-                else if (bareNumber !== null) {
-                    entryId = `${prefix}-${bareNumber}`;
-                }
-                else {
-                    console.warn(warningStyle('Invalid ID format. Using auto-generated ID.'));
-                    entryId = nextId;
-                }
-            }
-            else {
-                entryId = nextId;
-            }
+            entryId = input
+                ? resolveInteractiveId({
+                    input,
+                    prefix,
+                    nextId,
+                    isResearch,
+                    hasCustomType: !!customType,
+                    jiraPrefix: config.jiraPrefix,
+                })
+                : nextId;
         }
         if (!entrySlug) {
             const input = await question(highlight('Enter a short title (will be converted to slug): '));
@@ -99,52 +112,38 @@ export async function createNewEntry(id, slug, options) {
         else {
             originalTitle = entrySlug;
         }
-        rl.close();
     }
     else {
         originalTitle = entrySlug;
-        rl.close();
     }
-    // Sanitise slug
     const sanitised = sanitiseSlug(entrySlug);
     if (sanitised !== entrySlug) {
         console.warn(warningMessage('Notice', `Slug normalised from '${entrySlug}' to '${sanitised}'.`));
         entrySlug = sanitised;
     }
+    if (isAdr) {
+        const adrFile = join(targetDir, `${entryId}-${entrySlug}.md`);
+        if (await fs.pathExists(adrFile)) {
+            console.error(errorMessage('Error', `ADR ${entryId}-${entrySlug}.md already exists.`));
+            process.exit(1);
+        }
+        await writeAdrFile({ targetDir, entryId: entryId, entrySlug, originalTitle, nextIdNum, id_padded });
+        console.log(successMessage('Created', `ADR in ${config.adrDir || 'docs/adr'}/${entryId}-${entrySlug}.md`));
+        return;
+    }
     const entryDir = getEntryPath(targetDir, `${entryId}-${entrySlug}`);
     if (await fs.pathExists(entryDir)) {
         console.error(errorMessage('Error', `Entry ${entryId}-${entrySlug} already exists.`));
         process.exit(1);
     }
-    await fs.mkdirp(entryDir);
-    const version = getPackageVersion();
-    const now = new Date();
-    const replacements = {
-        id: entryId,
-        slug: entrySlug,
-        title: originalTitle,
-        date: now.toISOString().split('T')[0],
-        time: now.toLocaleTimeString('en-GB', { hour: '2-digit', minute: '2-digit', second: '2-digit' }),
-        fullIso: now.toISOString(),
-        version: `v${version}`,
-    };
-    const templatesDir = getTemplatesDir();
-    const getTemplate = (name) => {
-        const p = join(templatesDir, name);
-        if (fs.existsSync(p))
-            return fs.readFileSync(p, 'utf8');
-        throw new Error(`Template ${name} not found.`);
-    };
-    const fillTemplate = (template) => {
-        return template.replace(/{{(\w+)}}/g, (_, key) => replacements[key] || `{{${key}}}`);
-    };
-    let indexTemplate = getTemplate('index.md');
-    if (isResearch || customType) {
-        indexTemplate = indexTemplate.replace('dateEnd: "[DATE_END]"', 'dateEnd: "[DATE_END]"\nstatus: active\nupdated: {{fullIso}}');
-    }
-    await fs.writeFile(join(entryDir, 'index.md'), fillTemplate(indexTemplate));
-    await fs.writeFile(join(entryDir, 'ticket.md'), fillTemplate(getTemplate('ticket.md')));
-    await fs.writeFile(join(entryDir, 'log.md'), fillTemplate(getTemplate('log.md')));
+    await writeStandardEntryFiles({
+        entryDir,
+        entryId: entryId,
+        entrySlug,
+        originalTitle,
+        isResearch,
+        hasCustomType: !!customType,
+    });
     const relativeDestDir = customType
         ? customType.dir
         : isResearch

package/dist/commands/new.js.map

@@ -1 +1 @@
-{"version":3,"file":"new.js","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,MAAM,EACN,OAAO,IAAI,YAAY,EACvB,SAAS,EACT,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,EAAE,GAAG,eAAe,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,MAAM,EAAE,OAAO,CAAC,MAAM;CACvB,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAmB,EAAE;IACnD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YAC7B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAW,EAAE,IAAa,EAAE,OAA+C;IAC9G,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC;IACvC,MAAM,cAAc,GAAG,OAAO,EAAE,IAAI,CAAC;IACrC,MAAM,UAAU,GAAG,cAAc,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC,cAAc,CAAC,CAAC;IAE1E,IAAI,cAAc,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,gBAAgB,cAAc,8CAA8C,CAAC,CAAC,CAAC;QACnH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,UAAU;QAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC;QACrC,CAAC,CAAC,UAAU;YACV,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC;YACpE,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAEhC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,SAAS,GAAG,IAAI,CAAC;IAErB,4DAA4D;IAC5D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;QACtC,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;YAC/F,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,iBAAiB,MAAM,iBAAiB,EAAE,GAAG,CAAC,CAAC;YAC9E,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC5C,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,OAAO,qBAAqB,UAAU,IAAI,CAAC,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,aAAa,GAAG,EAAE,CAAC;IAEvB,MAAM,eAAe,GAAG,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1F,6CAA6C;IAC7C,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,uBAAuB,eAAe,6BAA6B,CAAC,CAAC,CAAC;QAEzF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;YAC/F,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,wBAAwB,MAAM,qCAAqC,CAAC,CAAC,CAAC;YAC7G,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBACpC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACpE,IACE,MAAM;oBACN,CAAC,UAAU;oBACX,CAAC,UAAU;oBACX,MAAM,CAAC,UAAU;oBACjB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,EAC/D,CAAC;oBACD,OAAO,CAAC,IAAI,CACV,YAAY,CACV,oBAAoB,MAAM,CAAC,MAAM,+BAA+B,MAAM,CAAC,UAAU,6BAA6B,CAC/G,CACF,CAAC;oBACF,OAAO,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBACpD,CAAC;qBAAM,IAAI,MAAM,EAAE,CAAC;oBAClB,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;gBAChC,CAAC;qBAAM,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;oBAC/B,OAAO,GAAG,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;gBACtC,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,6CAA6C,CAAC,CAAC,CAAC;oBAC1E,OAAO,GAAG,MAAM,CAAC;gBACnB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,MAAM,CAAC;YACnB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,mDAAmD,CAAC,CAAC,CAAC;YAC7F,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,aAAa,GAAG,KAAK,CAAC;YACtB,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;QAED,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,SAAS,CAAC;QAC1B,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IAED,gBAAgB;IAChB,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,yBAAyB,SAAS,SAAS,SAAS,IAAI,CAAC,CAAC,CAAC;QACjG,SAAS,GAAG,SAAS,CAAC;IACxB,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,EAAE,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;IAEpE,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,OAAO,IAAI,SAAS,kBAAkB,CAAC,CAAC,CAAC;QACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE1B,MAAM,OAAO,GAAW,iBAAiB,EAAE,CAAC;IAE5C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,YAAY,GAA2B;QAC3C,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,EAAE,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAChG,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE;QAC1B,OAAO,EAAE,IAAI,OAAO,EAAE;KACvB,CAAC;IAEF,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE;QAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,aAAa,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,EAAE;QACxC,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC;IACvF,CAAC,CAAC;IAEF,IAAI,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC;QAC7B,aAAa,GAAG,aAAa,CAAC,OAAO,CACnC,uBAAuB,EACvB,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5E,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAElF,MAAM,eAAe,GAAG,UAAU;QAChC,CAAC,CAAC,UAAU,CAAC,GAAG;QAChB,CAAC,CAAC,UAAU;YACV,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,eAAe;YACvC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;IAExB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,eAAe,aAAa,eAAe,IAAI,OAAO,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;AACpH,CAAC"}
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"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"}

package/dist/commands/start.d.ts

@@ -1 +1 @@
-export declare function start(id: string, cwd?: string): Promise<void>;
+export declare function start(id?: string, cwd?: string): Promise<void>;

package/dist/commands/start.js

@@ -6,6 +6,8 @@ import matter from 'gray-matter';
 import { getConfig, getLogbookDirPath } from '../lib/config.js';
 import { getActiveEntry } from '../lib/session.js';
 import { getLogbookEntries } from '../utils/fs.js';
+import { selectPrompt } from '../utils/prompt.js';
+import { parseTicketId } from '../utils/id.js';
 import { LOCKFILE_NAME } from '../lib/lockfile.js';
 function getGitUsername() {
     try {
@@ -28,8 +30,6 @@ export async function start(id, cwd = process.cwd()) {
     }
     // 2. Resolve folder by ID prefix or exact match
     const config = getConfig();
-    // If a bare or suffixed number is given (e.g. "20-fix"), auto-prepend the configured jiraPrefix
-    const resolvedId = /^\d+(?:-.*)?$/.test(id) && config.jiraPrefix ? `${config.jiraPrefix}-${id}` : id;
     const logbookDir = getLogbookDirPath(config, cwd);
     const logbookEntries = await getLogbookEntries(logbookDir);
     if (config.researchDir) {
@@ -52,56 +52,99 @@ export async function start(id, cwd = process.cwd()) {
     }
     let slug;
     let entryDir;
-    // 2a. Direct folder name match bypasses all other logic
-    const exactSlugMatch = logbookEntries.find((e) => e.slug.toLowerCase() === id.toLowerCase());
-    if (exactSlugMatch) {
-        slug = exactSlugMatch.slug;
-        entryDir = exactSlugMatch.path;
-    }
-    else {
-        // 2b. Query all logbook entries for frontmatter and folder structure
-        // First Pass: Exact Ticket ID Match in Frontmatter
-        const exactTicketMatches = logbookEntries.filter((e) => {
-            const ticket = typeof e.data?.ticket === 'string' ? e.data.ticket.trim().toLowerCase() : '';
-            return ticket === resolvedId.toLowerCase();
-        });
-        if (exactTicketMatches.length === 1) {
-            slug = exactTicketMatches[0].slug;
-            entryDir = exactTicketMatches[0].path;
+    if (!id) {
+        if (logbookEntries.length === 0) {
+            console.error(errorStyle(`Error: No entries found in logbook or research directories.`));
+            console.error(errorStyle(`Run 'logbook new' to create one first.`));
+            process.exit(1);
         }
-        else if (exactTicketMatches.length > 1) {
-            console.error(errorStyle(`Error: Multiple entries found with the exact same ticket ID '${resolvedId}'.`));
-            console.error(errorStyle(`Please specify the unique folder name/slug directly instead:`));
-            for (const match of exactTicketMatches) {
-                console.error(errorStyle(`  logbook start ${match.slug}`));
+        // Sort entries descending
+        logbookEntries.sort((a, b) => {
+            const idA = parseTicketId(a.slug);
+            const idB = parseTicketId(b.slug);
+            if (idA && idB) {
+                if (idA.prefix !== idB.prefix) {
+                    return idB.prefix.localeCompare(idA.prefix);
+                }
+                return idB.number - idA.number;
             }
+            return b.slug.localeCompare(a.slug);
+        });
+        const choices = logbookEntries.map((e) => {
+            const title = e.data?.title ? `: ${e.data.title}` : '';
+            const ticketId = e.data?.ticket || e.slug;
+            return `${ticketId}${title}`;
+        });
+        const selectedIndex = await selectPrompt('Select an entry to start:', choices);
+        if (selectedIndex === -1) {
             process.exit(1);
         }
+        const selectedEntry = logbookEntries[selectedIndex];
+        slug = selectedEntry.slug;
+        entryDir = selectedEntry.path;
+    }
+    else {
+        // If a bare or suffixed number is given (e.g. "20-fix"), auto-prepend the configured jiraPrefix
+        const resolvedId = /^\d+(?:-.*)?$/.test(id) && config.jiraPrefix ? `${config.jiraPrefix}-${id}` : id;
+        // 2a. Direct folder name match bypasses all other logic
+        const exactSlugMatch = logbookEntries.find((e) => e.slug.toLowerCase() === id.toLowerCase());
+        if (exactSlugMatch) {
+            slug = exactSlugMatch.slug;
+            entryDir = exactSlugMatch.path;
+        }
         else {
-            // Second Pass: Fallback Prefix Match on Folder Names
-            const prefixMatches = logbookEntries.filter((e) => {
-                const prefix = e.slug.split('-').slice(0, resolvedId.split('-').length).join('-');
-                return prefix.toLowerCase() === resolvedId.toLowerCase();
+            // 2b. Query all logbook entries for frontmatter and folder structure
+            // First Pass: Exact Ticket ID Match in Frontmatter
+            const exactTicketMatches = logbookEntries.filter((e) => {
+                const ticket = typeof e.data?.ticket === 'string' ? e.data.ticket.trim().toLowerCase() : '';
+                return ticket === resolvedId.toLowerCase();
             });
-            if (prefixMatches.length === 1) {
-                slug = prefixMatches[0].slug;
-                entryDir = prefixMatches[0].path;
+            if (exactTicketMatches.length === 1) {
+                slug = exactTicketMatches[0].slug;
+                entryDir = exactTicketMatches[0].path;
             }
-            else if (prefixMatches.length > 1) {
-                console.error(errorStyle(`Error: Multiple entries found matching prefix '${resolvedId}'.`));
-                console.error(errorStyle(`Please be more specific. Run one of:`));
-                for (const match of prefixMatches) {
-                    const ticketId = typeof match.data?.ticket === 'string' ? match.data.ticket : match.slug;
-                    console.error(errorStyle(`  logbook start ${ticketId}`));
+            else if (exactTicketMatches.length > 1) {
+                const choices = exactTicketMatches.map((e) => {
+                    const title = e.data?.title ? `: ${e.data.title}` : '';
+                    return `${e.slug}${title}`;
+                });
+                const selectedIndex = await selectPrompt(`Multiple entries found with the exact same ticket ID '${resolvedId}'. Select one:`, choices);
+                if (selectedIndex === -1) {
+                    process.exit(1);
+                }
+                slug = exactTicketMatches[selectedIndex].slug;
+                entryDir = exactTicketMatches[selectedIndex].path;
+            }
+            else {
+                // Second Pass: Fallback Prefix Match on Folder Names
+                const prefixMatches = logbookEntries.filter((e) => {
+                    const prefix = e.slug.split('-').slice(0, resolvedId.split('-').length).join('-');
+                    return prefix.toLowerCase() === resolvedId.toLowerCase();
+                });
+                if (prefixMatches.length === 1) {
+                    slug = prefixMatches[0].slug;
+                    entryDir = prefixMatches[0].path;
+                }
+                else if (prefixMatches.length > 1) {
+                    const choices = prefixMatches.map((e) => {
+                        const title = e.data?.title ? `: ${e.data.title}` : '';
+                        const ticketId = e.data?.ticket || e.slug;
+                        return `${ticketId}${title}`;
+                    });
+                    const selectedIndex = await selectPrompt(`Multiple entries found matching prefix '${resolvedId}'. Select one:`, choices);
+                    if (selectedIndex === -1) {
+                        process.exit(1);
+                    }
+                    slug = prefixMatches[selectedIndex].slug;
+                    entryDir = prefixMatches[selectedIndex].path;
                 }
-                process.exit(1);
             }
         }
-    }
-    if (!slug || !entryDir) {
-        console.error(errorStyle(`Error: No entry found matching ID '${resolvedId}' in logbook or research directories.`));
-        console.error(errorStyle(`Run 'logbook new <id> <slug>' to create it first.`));
-        process.exit(1);
+        if (!slug || !entryDir) {
+            console.error(errorStyle(`Error: No entry found matching ID '${resolvedId}' in logbook or research directories.`));
+            console.error(errorStyle(`Run 'logbook new <id> <slug>' to create it first.`));
+            process.exit(1);
+        }
     }
     // Warn if branch-resolved entry is different
     const activeFromBranch = await getActiveEntry({}, cwd);