peaks-loop 4.0.0-beta.8 → 4.0.0-beta.9

package/dist/shared/format-md-compact.js

@@ -0,0 +1,297 @@
+/**
+ * format-md-compact — single source of truth for whitespace / decoration
+ * normalization across every CLI body-output path.
+ *
+ * Slice 023 (R3) — `peaks project memories:show`, `peaks retrospective show`,
+ * and `peaks request show` (per-artifact) all funnel their `body` field through
+ * this helper so the LLM-consumed output is free of blank-line padding,
+ * decorative `---` rules, and frontmatter `description:` field-name repeats
+ * while preserving every semantically meaningful construct (code fences,
+ * setext heading underlines, GFM table syntax, frontmatter, list indentation,
+ * inline emphasis, code spans).
+ *
+ * Pure function: no fs, no I/O. Easy to unit-test (see
+ * `tests/unit/shared/format-md-compact.test.ts`).
+ */
+const FENCE_TRIPLE_BACKTICK = '```';
+const FENCE_TRIPLE_TILDE = '~~~';
+const FENCE_MARKER_RE = /^(```+|~~~+)/;
+const TABLE_ROW_RE = /^\s*\|.*\|\s*$/;
+const TABLE_ALIGN_ROW_RE = /^\s*\|?\s*:?-{1,}:?\s*(\|\s*:?-{1,}:?\s*)+\|?\s*$/;
+const ATX_HEADING_RE = /^#{1,6}\s/;
+const HEADING_LINE_RE = /^\S/;
+const SETEXT_UNDERLINE_RE = /^=+\s*$|^-{2,}\s*$/;
+export function formatMdCompact(input, options = {}) {
+    if (input.length === 0)
+        return input;
+    const opts = {
+        preserveCodeBlocks: options.preserveCodeBlocks ?? true,
+        preserveSetextHeadings: options.preserveSetextHeadings ?? true,
+        preserveTables: options.preserveTables ?? true,
+        collapseBlankLines: options.collapseBlankLines ?? true,
+        stripTrailingWhitespace: options.stripTrailingWhitespace ?? true,
+        stripDecorativeHorizontalRules: options.stripDecorativeHorizontalRules ?? true,
+        stripFrontmatterDescriptionRepeat: options.stripFrontmatterDescriptionRepeat ?? true
+    };
+    // 1. Split frontmatter from body (if any). The YAML block lives between
+    //    the first line `---` and the second line `---`. We carry it through
+    //    unchanged.
+    const fm = splitFrontmatter(input);
+    const body = fm.body;
+    // 2. Walk the body line-by-line, applying the protected-zone rules.
+    const normalizedBody = normalizeBody(body, opts);
+    // 3. Optional frontmatter `description:` repeat strip. The body's
+    //    first ATX heading is compared to the frontmatter `description:`
+    //    value; if the description text repeats the heading, the leading
+    //    paragraph is dropped. Implemented as a one-shot post-pass.
+    const finalBody = opts.stripFrontmatterDescriptionRepeat
+        ? stripDescriptionRepeat(normalizedBody, fm.description)
+        : normalizedBody;
+    // 4. Re-assemble. The frontmatter stays verbatim; the body carries the
+    //    normalized text. Match the original layout: if the input had
+    //    frontmatter, output is `frontmatter + blank + body`; otherwise
+    //    the body is the whole output.
+    if (fm.raw === '') {
+        return finalBody;
+    }
+    return fm.raw + '\n' + finalBody;
+}
+function splitFrontmatter(input) {
+    // Normalize line endings so Windows \r\n doesn't confuse the leading-marker check.
+    const normalized = input.replace(/\r\n/g, '\n');
+    const lines = normalized.split('\n');
+    if (lines[0] !== '---') {
+        return { raw: '', description: null, body: normalized };
+    }
+    let closeIndex = -1;
+    for (let index = 1; index < lines.length; index += 1) {
+        if (lines[index] === '---') {
+            closeIndex = index;
+            break;
+        }
+    }
+    if (closeIndex < 0) {
+        return { raw: '', description: null, body: normalized };
+    }
+    const raw = lines.slice(0, closeIndex + 1).join('\n');
+    // Body = everything after the closing `---` (preserving one optional blank line).
+    const bodyLines = lines.slice(closeIndex + 1);
+    while (bodyLines.length > 0 && bodyLines[0] === '') {
+        bodyLines.shift();
+    }
+    const body = bodyLines.join('\n');
+    // Extract the `description:` field. Walk the YAML block; pull the value
+    // as a single-line string. Multi-line (`|`) or folded (`>`) scalars are
+    // joined with a single space — the description is a short summary, the
+    // exact whitespace inside the block scalar is not preserved.
+    const frontmatterLines = lines.slice(1, closeIndex);
+    const description = extractFrontmatterDescription(frontmatterLines);
+    return { raw, description, body };
+}
+function extractFrontmatterDescription(frontmatterLines) {
+    for (let index = 0; index < frontmatterLines.length; index += 1) {
+        const line = frontmatterLines[index] ?? '';
+        const match = line.match(/^description:\s*(.*)$/);
+        if (match === null)
+            continue;
+        const inline = (match[1] ?? '').trim();
+        if (inline === '|' || inline === '>') {
+            const collected = [];
+            for (let inner = index + 1; inner < frontmatterLines.length; inner += 1) {
+                const innerLine = frontmatterLines[inner] ?? '';
+                if (/^[A-Za-z0-9_-]+:/.test(innerLine))
+                    break;
+                collected.push(innerLine.replace(/^\s{2}/, ''));
+            }
+            return collected.join(' ').trim();
+        }
+        // Strip surrounding quotes if the value is a quoted scalar.
+        return inline.replace(/^['"]|['"]$/g, '');
+    }
+    return null;
+}
+function normalizeBody(body, opts) {
+    // Walk line-by-line, tracking the protected-zone flags and emitting a
+    // transformed line stream. We keep three flag bits:
+    //   insideFence:   toggled on ``` / ~~~ lines
+    //   insideFrontmatterYAML: handled by splitFrontmatter; body has none.
+    //   insideTable:   detected by leading-pipe; carried until first non-pipe
+    //                  line.
+    const lines = body.split('\n');
+    // 1. Pre-pass: compute the `setextUnderlined` markers so the decorative
+    //    `---` strip can know when a line is a setext H2 underline (semantic)
+    //    vs a decoration.
+    const setextUnderlined = computeSetextUnderlines(lines);
+    const protection = [];
+    let insideFence = false;
+    let insideTable = false;
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index] ?? '';
+        if (opts.preserveCodeBlocks && isFenceOpenLine(line) && !isFenceCloseLine(line, insideFence)) {
+            insideFence = !insideFence;
+            protection.push('fence');
+            continue;
+        }
+        if (insideFence) {
+            protection.push('fence');
+            continue;
+        }
+        if (opts.preserveSetextHeadings && setextUnderlined.has(index)) {
+            protection.push('setext');
+            continue;
+        }
+        if (opts.preserveTables && isTableLine(line)) {
+            // Entering / continuing a table — first row that looks like a table
+            // starts the table zone; the alignment row (|---|) is included.
+            insideTable = true;
+            protection.push('table');
+            continue;
+        }
+        if (insideTable && !isTableLine(line) && line.trim() !== '') {
+            insideTable = false;
+        }
+        if (insideTable) {
+            protection.push('table');
+            continue;
+        }
+        protection.push('plain');
+    }
+    // 3. Per-line transforms: strip trailing whitespace outside protected
+    //    zones; strip decorative `---` outside setext / table / fence zones.
+    const out = [];
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index] ?? '';
+        const zone = protection[index] ?? 'plain';
+        let transformed = line;
+        if (zone !== 'fence' && opts.stripTrailingWhitespace) {
+            transformed = transformed.replace(/[ \t]+$/u, '');
+        }
+        if (zone !== 'fence' &&
+            zone !== 'setext' &&
+            zone !== 'table' &&
+            opts.stripDecorativeHorizontalRules) {
+            if (isDecorativeHorizontalRule(transformed)) {
+                // Mark for removal: push a sentinel. The blank-line collapse step
+                // will merge surrounding blanks.
+                transformed = '__PEAKS_HR_REMOVED__';
+            }
+        }
+        out.push(transformed);
+    }
+    // 4. Drop the sentinel lines (decorative `---` after classification).
+    let collapsed = out.filter((line) => line !== '__PEAKS_HR_REMOVED__');
+    // 5. Collapse 3+ consecutive blank lines into 1. Two blank lines
+    //    between two non-blank lines are also collapsed to 1 (matches PRD
+    //    R2's "decorative `---` is redundant" rule — the original visual
+    //    gap that surrounded the `---` collapses with it).
+    if (opts.collapseBlankLines) {
+        collapsed = collapseMultiBlanks(collapsed);
+    }
+    return collapsed.join('\n');
+}
+function isFenceOpenLine(line) {
+    return FENCE_MARKER_RE.test(line);
+}
+function isFenceCloseLine(line, insideFence) {
+    // The `isFenceOpenLine` already returned true for this line, so it
+    // starts with ``` or ~~~. A "close" line is one that opens a new fence
+    // of the *same* length. We approximate by treating any opener as a close
+    // when we are currently inside a fence.
+    return insideFence;
+}
+function isTableLine(line) {
+    return TABLE_ROW_RE.test(line) || TABLE_ALIGN_ROW_RE.test(line);
+}
+function computeSetextUnderlines(lines) {
+    // A `===` or `---` line is a setext heading underline ONLY when it sits
+    // directly under a non-blank, non-ATX text line (no blank line between
+    // them). The presence of a blank line between the text and the rule
+    // disqualifies it (a blank-separated `---` is decoration, not setext).
+    const result = new Set();
+    for (let index = 1; index < lines.length; index += 1) {
+        const line = lines[index] ?? '';
+        if (!SETEXT_UNDERLINE_RE.test(line))
+            continue;
+        const prev = lines[index - 1] ?? '';
+        if (prev === '')
+            continue;
+        if (ATX_HEADING_RE.test(prev))
+            continue;
+        if (!HEADING_LINE_RE.test(prev))
+            continue;
+        result.add(index);
+    }
+    return result;
+}
+function isDecorativeHorizontalRule(line) {
+    // A line that is exactly `---` (or any number of `-` chars) is a
+    // candidate horizontal rule. The caller has already excluded setext
+    // and table contexts via the `protection` array.
+    return /^-+$/.test(line);
+}
+function collapseMultiBlanks(lines) {
+    const result = [];
+    let blankRun = 0;
+    for (const line of lines) {
+        if (line === '') {
+            blankRun += 1;
+            // 1 blank line is the cap. Drop the rest.
+            if (blankRun <= 1) {
+                result.push(line);
+            }
+            continue;
+        }
+        blankRun = 0;
+        result.push(line);
+    }
+    return result;
+}
+function stripDescriptionRepeat(body, description) {
+    if (description === null || description.length === 0)
+        return body;
+    // Find the first ATX heading line. If it equals the frontmatter
+    // description text, drop it. Also drop a description-matching paragraph
+    // that immediately follows the heading (PRD's "frontmatter description
+    // already in body header" case). All other content is preserved.
+    const lines = body.split('\n');
+    if (lines.length === 0)
+        return body;
+    let firstHeadingIndex = -1;
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index] ?? '';
+        if (line.trim() === '')
+            continue;
+        if (ATX_HEADING_RE.test(line)) {
+            firstHeadingIndex = index;
+        }
+        break;
+    }
+    if (firstHeadingIndex < 0)
+        return body;
+    const headingText = (lines[firstHeadingIndex] ?? '').replace(/^#{1,6}\s+/, '').trim();
+    if (headingText !== description)
+        return body;
+    // Walk past the heading, then past any blank lines, then past the
+    // matching description paragraph (if present). Anything after the
+    // description paragraph is the body we want to keep.
+    const tail = lines.slice(firstHeadingIndex + 1);
+    let cursor = 0;
+    // Skip blanks.
+    while (cursor < tail.length && (tail[cursor] ?? '') === '') {
+        cursor += 1;
+    }
+    // Read the first non-blank paragraph.
+    const paragraphStart = cursor;
+    while (cursor < tail.length && (tail[cursor] ?? '') !== '') {
+        cursor += 1;
+    }
+    const paragraph = tail.slice(paragraphStart, cursor);
+    if (paragraph.join(' ').trim() !== description) {
+        // The paragraph doesn't match the description — don't drop it.
+        cursor = paragraphStart;
+    }
+    const kept = tail.slice(cursor);
+    if (kept.length === 0)
+        return '';
+    return kept.join('\n');
+}

package/dist/shared/frontmatter.d.ts

@@ -0,0 +1,6 @@
+export type SkillFrontmatter = {
+    name: string;
+    description: string;
+    [key: string]: string;
+};
+export declare function parseFrontmatter(markdown: string): SkillFrontmatter;

package/dist/shared/frontmatter.js

@@ -0,0 +1,165 @@
+const KEY_PATTERN = /^([A-Za-z0-9_.-]+):\s*(.*)$/;
+/**
+ * Flatten a nested YAML mapping (max 2 levels deep) into dotted keys.
+ * `metadata:\n  appliesTo: v2.12.0+` → `metadata.appliesTo: v2.12.0+`.
+ * `metadata:\n  sources:\n    - foo\n    - bar` →
+ *   `metadata.sources: foo, bar`.
+ *
+ * Skills only use this shape for the `metadata:` block (v2.12.0
+ * skill-versioning contract); deeper nesting is not currently emitted.
+ */
+function flattenNestedFrontmatter(frontmatterLines) {
+    const flat = [];
+    let i = 0;
+    while (i < frontmatterLines.length) {
+        const line = frontmatterLines[i];
+        if (line === undefined) {
+            i += 1;
+            continue;
+        }
+        if (line.trim().length === 0) {
+            flat.push(line);
+            i += 1;
+            continue;
+        }
+        const parentMatch = /^([A-Za-z0-9_-]+):\s*$/.exec(line);
+        if (!parentMatch || parentMatch[1] === undefined) {
+            flat.push(line);
+            i += 1;
+            continue;
+        }
+        const parent = parentMatch[1];
+        // Collect children (2nd-level keys OR list items OR a 2nd-level parent key).
+        const children = [];
+        let listItemsAtParent = [];
+        let grandTotalConsumed = 0;
+        let j = i + 1;
+        while (j < frontmatterLines.length) {
+            const childLine = frontmatterLines[j];
+            if (childLine === undefined || childLine.trim().length === 0)
+                break;
+            // 2nd-level parent key (e.g. "  sources:") — recurse one level.
+            const subParentMatch = /^\s{2,}([A-Za-z0-9_-]+):\s*$/.exec(childLine);
+            if (subParentMatch && subParentMatch[1] !== undefined) {
+                const subParent = subParentMatch[1];
+                const subList = [];
+                let k = j + 1;
+                let subConsumed = 0;
+                while (k < frontmatterLines.length) {
+                    const gcLine = frontmatterLines[k];
+                    if (gcLine === undefined || gcLine.trim().length === 0)
+                        break;
+                    const li = /^\s+-\s+(.+)$/.exec(gcLine);
+                    if (li && li[1] !== undefined) {
+                        subList.push(li[1].trim());
+                        subConsumed += 1;
+                        k += 1;
+                        continue;
+                    }
+                    break;
+                }
+                if (subList.length > 0) {
+                    children.push({ key: subParent, listItems: subList, grandChildren: [] });
+                }
+                else {
+                    // Empty sub-parent; preserve as bare key (no value).
+                    children.push({ key: subParent, listItems: [], grandChildren: [] });
+                }
+                grandTotalConsumed += subConsumed + 1;
+                j = k;
+                continue;
+            }
+            // Direct list item under parent (no nested key).
+            const directList = /^\s+-\s+(.+)$/.exec(childLine);
+            if (directList && directList[1] !== undefined) {
+                listItemsAtParent.push(directList[1].trim());
+                grandTotalConsumed += 1;
+                j += 1;
+                continue;
+            }
+            // 2nd-level scalar key.
+            const scalarMatch = /^\s{2,}([A-Za-z0-9_-]+):\s*(.*)$/.exec(childLine);
+            if (scalarMatch && scalarMatch[1] !== undefined) {
+                children.push({
+                    key: scalarMatch[1],
+                    listItems: [],
+                    grandChildren: [`${parent}.${scalarMatch[1]}: ${scalarMatch[2] ?? ''}`.trimEnd()]
+                });
+                grandTotalConsumed += 1;
+                j += 1;
+                continue;
+            }
+            break;
+        }
+        if (listItemsAtParent.length > 0) {
+            flat.push(`${parent}: ${listItemsAtParent.join(', ')}`);
+        }
+        else if (children.length > 0) {
+            for (const child of children) {
+                if (child.listItems.length > 0) {
+                    flat.push(`${parent}.${child.key}: ${child.listItems.join(', ')}`);
+                }
+                else if (child.grandChildren.length > 0) {
+                    for (const gc of child.grandChildren)
+                        flat.push(gc);
+                }
+                else {
+                    flat.push(`${parent}.${child.key}:`);
+                }
+            }
+        }
+        else {
+            flat.push(line);
+        }
+        i += grandTotalConsumed + 1;
+    }
+    return flat;
+}
+export function parseFrontmatter(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    if (lines[0] !== '---') {
+        throw new Error('Missing YAML frontmatter opening marker');
+    }
+    const endIndex = lines.findIndex((line, index) => index > 0 && line === '---');
+    if (endIndex === -1) {
+        throw new Error('Missing YAML frontmatter closing marker');
+    }
+    const rawLines = lines.slice(1, endIndex);
+    const frontmatterLines = flattenNestedFrontmatter(rawLines);
+    const metadata = {};
+    for (let index = 0; index < frontmatterLines.length; index += 1) {
+        const line = frontmatterLines[index];
+        if (!line || line.trim().length === 0) {
+            continue;
+        }
+        const blockMatch = line.match(/^([A-Za-z0-9_-]+):\s*[|>]\s*$/);
+        if (blockMatch?.[1]) {
+            const key = blockMatch[1];
+            const blockLines = [];
+            index += 1;
+            while (index < frontmatterLines.length) {
+                const blockLine = frontmatterLines[index];
+                if (blockLine && /^\S[^:]*:/.test(blockLine)) {
+                    index -= 1;
+                    break;
+                }
+                blockLines.push(blockLine?.replace(/^\s{2}/, '') ?? '');
+                index += 1;
+            }
+            metadata[key] = blockLines.join('\n').trim();
+            continue;
+        }
+        const match = line.match(KEY_PATTERN);
+        if (!match?.[1]) {
+            throw new Error(`Invalid frontmatter line: ${line}`);
+        }
+        metadata[match[1]] = (match[2] ?? '').trim().replace(/^['"]|['"]$/g, '');
+    }
+    if (!metadata.name) {
+        throw new Error('Missing required frontmatter field: name');
+    }
+    if (!metadata.description) {
+        throw new Error('Missing required frontmatter field: description');
+    }
+    return metadata;
+}

package/dist/shared/fs-utils.d.ts

@@ -0,0 +1,4 @@
+import type { Platform } from './platform.js';
+export declare function getDirectoryLinkType(targetPlatform?: Platform): 'junction' | 'dir';
+export declare function createDirectoryLinkSync(target: string, linkPath: string): void;
+export declare function readDirectoryLinkTarget(linkPath: string): string | null;

package/dist/shared/fs-utils.js

@@ -0,0 +1,16 @@
+import { symlinkSync as nodeSymlinkSync, readlinkSync } from 'node:fs';
+import { platform } from './platform.js';
+export function getDirectoryLinkType(targetPlatform = platform) {
+    return targetPlatform === 'win32' ? 'junction' : 'dir';
+}
+export function createDirectoryLinkSync(target, linkPath) {
+    nodeSymlinkSync(target, linkPath, getDirectoryLinkType());
+}
+export function readDirectoryLinkTarget(linkPath) {
+    try {
+        return readlinkSync(linkPath);
+    }
+    catch { // TODO(g2): legacy silent catch — grace: 1 minor release (v2.14.0)
+        return null;
+    }
+}

package/dist/shared/fs.d.ts

@@ -0,0 +1,4 @@
+export declare function pathExists(path: string): Promise<boolean>;
+export declare function readText(path: string): Promise<string>;
+export declare function listDirectories(path: string): Promise<string[]>;
+export declare function isDirectory(path: string): Promise<boolean>;

package/dist/shared/fs.js

@@ -0,0 +1,26 @@
+import { access, readdir, readFile, stat } from 'node:fs/promises';
+import { constants } from 'node:fs';
+export async function pathExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readText(path) {
+    return readFile(path, 'utf8');
+}
+export async function listDirectories(path) {
+    const entries = await readdir(path, { withFileTypes: true });
+    return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+}
+export async function isDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}

package/dist/shared/incrementing-number.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Utilities for generating incrementing numbered filenames.
+ * Used by session-based artifact storage to create files like 001-feature.md.
+ */
+/**
+ * Get the next available number in a directory.
+ * Scans existing .md files and finds the highest numeric prefix.
+ * Returns 1 if directory is empty or doesn't exist.
+ *
+ * @param dirPath - Directory to scan for numbered files
+ * @returns Next available number (1, 2, 3, ...)
+ */
+export declare function getNextNumber(dirPath: string): number;
+export declare function buildNumberedFilename(number: number, description: string): string;
+/**
+ * Get the next numbered file path in a directory.
+ * Combines getNextNumber() and buildNumberedFilename().
+ *
+ * @param dirPath - Directory to scan
+ * @param description - Description for the filename
+ * @returns Full path to the new numbered file
+ */
+export declare function getNextNumberedFilePath(dirPath: string, description: string): string;

package/dist/shared/incrementing-number.js

@@ -0,0 +1,68 @@
+/**
+ * Utilities for generating incrementing numbered filenames.
+ * Used by session-based artifact storage to create files like 001-feature.md.
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Get the next available number in a directory.
+ * Scans existing .md files and finds the highest numeric prefix.
+ * Returns 1 if directory is empty or doesn't exist.
+ *
+ * @param dirPath - Directory to scan for numbered files
+ * @returns Next available number (1, 2, 3, ...)
+ */
+export function getNextNumber(dirPath) {
+    if (!existsSync(dirPath))
+        return 1;
+    const files = readdirSync(dirPath).filter(f => f.endsWith('.md'));
+    if (files.length === 0)
+        return 1;
+    const numbers = files
+        .map(f => {
+        const match = /^(\d+)-/.exec(f);
+        return match && match[1] ? parseInt(match[1], 10) : NaN;
+    })
+        .filter(n => !isNaN(n));
+    return numbers.length > 0 ? Math.max(...numbers) + 1 : 1;
+}
+/**
+ * Build a numbered filename from a number and description.
+ * Format: 001-description-slug.md
+ *
+ * @param number - The file number (will be zero-padded to 3 digits)
+ * @param description - Human-readable description (converted to kebab-case slug)
+ * @returns Formatted filename like "001-feature-name.md"
+ */
+// Windows supports up to 255 chars per filename component (and 260 for the
+// full path). Pre-#015 the slug was silently truncated to 50 chars, which
+// produced orphaned artefacts (the on-disk file no longer matched the
+// request-id and the state machine could not find it). 255 is the OS-level
+// ceiling; if a requestId exceeds that, `mkdir` / `writeFile` will surface a
+// real ENAMETOOLONG error instead of a silent mismatch. We reserve 4 chars
+// for the `<NNN>-` numeric prefix and 3 chars for the `.md` suffix, so
+// the slug may be at most 248 chars (giving 4 + 248 + 3 = 255 total).
+const MAX_FILENAME_LENGTH = 255;
+const MAX_FILENAME_SLUG_LENGTH = MAX_FILENAME_LENGTH - 7;
+export function buildNumberedFilename(number, description) {
+    const padded = String(number).padStart(3, '0');
+    const slug = description
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, MAX_FILENAME_SLUG_LENGTH);
+    return `${padded}-${slug}.md`;
+}
+/**
+ * Get the next numbered file path in a directory.
+ * Combines getNextNumber() and buildNumberedFilename().
+ *
+ * @param dirPath - Directory to scan
+ * @param description - Description for the filename
+ * @returns Full path to the new numbered file
+ */
+export function getNextNumberedFilePath(dirPath, description) {
+    const number = getNextNumber(dirPath);
+    const filename = buildNumberedFilename(number, description);
+    return join(dirPath, filename);
+}

package/dist/shared/json-schema-mini.d.ts

@@ -0,0 +1,10 @@
+export type JsonSchemaIssue = {
+    path: string;
+    message: string;
+};
+export type JsonSchemaResult = {
+    valid: boolean;
+    errors: JsonSchemaIssue[];
+};
+export type JsonSchemaNode = Record<string, unknown>;
+export declare function validateAgainstSchema(value: unknown, schema: JsonSchemaNode): JsonSchemaResult;