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

package/dist/src/shared/format-md-compact.d.ts

@@ -1,32 +0,0 @@
-/**
- * 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`).
- */
-export interface FormatMdCompactOptions {
-    /** Preserve code-fence (``` ... ```) and frontmatter (--- ... ---) content. Default true. */
-    preserveCodeBlocks?: boolean;
-    /** Preserve setext heading underlines (===, --- under a text line). Default true. */
-    preserveSetextHeadings?: boolean;
-    /** Preserve GFM table syntax (| ... | rows). Default true. */
-    preserveTables?: boolean;
-    /** Collapse 3+ blank lines to 1. Default true. */
-    collapseBlankLines?: boolean;
-    /** Strip trailing whitespace per line. Default true. */
-    stripTrailingWhitespace?: boolean;
-    /** Strip decorative `---` lines (lines surrounded by blanks OR trailing final line). Default true. */
-    stripDecorativeHorizontalRules?: boolean;
-    /** Strip frontmatter `description:` field-name repeat when same value already in body header. Default true. */
-    stripFrontmatterDescriptionRepeat?: boolean;
-}
-export declare function formatMdCompact(input: string, options?: FormatMdCompactOptions): string;

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

@@ -1,297 +0,0 @@
-/**
- * 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/src/shared/frontmatter.d.ts

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

package/dist/src/shared/frontmatter.js

@@ -1,165 +0,0 @@
-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/src/shared/fs-utils.d.ts

@@ -1,4 +0,0 @@
-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/src/shared/fs-utils.js

@@ -1,16 +0,0 @@
-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/src/shared/fs.d.ts

@@ -1,4 +0,0 @@
-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/src/shared/fs.js

@@ -1,26 +0,0 @@
-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/src/shared/incrementing-number.d.ts

@@ -1,23 +0,0 @@
-/**
- * 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/src/shared/incrementing-number.js

@@ -1,68 +0,0 @@
-/**
- * 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/src/shared/json-schema-mini.d.ts

@@ -1,10 +0,0 @@
-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;