open-wiki-spec 0.1.0

package/dist/core/parser/note-parser.js

@@ -0,0 +1,106 @@
+import { readFileSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { extractFrontmatter, validateFrontmatter } from './frontmatter-parser.js';
+import { parseSections } from './section-parser.js';
+import { extractWikilinks } from './wikilink-parser.js';
+import { parseRequirements } from './requirement-parser.js';
+import { parseDeltaSummary } from './delta-summary-parser.js';
+import { parseTasks } from './task-parser.js';
+/**
+ * Parse a single markdown note into a complete ParseResult.
+ * Reads the file at the given path and orchestrates all sub-parsers.
+ *
+ * Returns ParseResult with raw wikilinks (not resolved to ids).
+ */
+export function parseNote(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    const errors = [];
+    // 1. Frontmatter
+    const { raw, errors: fmExtractErrors } = extractFrontmatter(content);
+    errors.push(...fmExtractErrors);
+    let frontmatter = null;
+    let rawFrontmatter = null;
+    let body = content;
+    let bodyStartLine = 1;
+    if (raw) {
+        rawFrontmatter = raw.data;
+        body = raw.body;
+        bodyStartLine = raw.bodyStartLine;
+        const { frontmatter: validated, errors: fmValidateErrors } = validateFrontmatter(raw.data);
+        errors.push(...fmValidateErrors);
+        frontmatter = validated;
+    }
+    // 2. Sections
+    const { sections, headings, errors: sectionErrors } = parseSections(body, bodyStartLine);
+    errors.push(...sectionErrors);
+    // 3. Wikilinks (from frontmatter YAML values and body)
+    const fmWikilinks = raw
+        ? extractWikilinksFromObject(raw.data, 'frontmatter')
+        : { wikilinks: [], errors: [] };
+    const bodyWikilinks = extractWikilinks(body, 'body', bodyStartLine);
+    errors.push(...fmWikilinks.errors, ...bodyWikilinks.errors);
+    const allWikilinks = [...fmWikilinks.wikilinks, ...bodyWikilinks.wikilinks];
+    // 4. Requirements (Feature only)
+    const noteType = frontmatter?.type;
+    let requirements = [];
+    if (noteType === 'feature') {
+        const reqResult = parseRequirements(sections);
+        requirements = reqResult.requirements;
+        errors.push(...reqResult.errors);
+    }
+    // 5. Delta Summary + Tasks (Change only)
+    let deltaSummary = [];
+    let tasks = [];
+    if (noteType === 'change') {
+        const deltaResult = parseDeltaSummary(sections);
+        deltaSummary = deltaResult.entries;
+        errors.push(...deltaResult.errors);
+        const taskResult = parseTasks(sections);
+        tasks = taskResult.tasks;
+        errors.push(...taskResult.errors);
+    }
+    // 6. Content hash
+    const contentHash = computeBodyHash(body);
+    return {
+        frontmatter,
+        rawFrontmatter,
+        sections,
+        headings,
+        wikilinks: allWikilinks,
+        requirements,
+        deltaSummary,
+        tasks,
+        body,
+        contentHash,
+        errors,
+    };
+}
+function computeBodyHash(body) {
+    const hash = createHash('sha256').update(body, 'utf-8').digest('hex');
+    return `sha256:${hash}`;
+}
+/**
+ * Recursively walk a frontmatter object and extract wikilinks from string values.
+ */
+function extractWikilinksFromObject(obj, location) {
+    const allWikilinks = [];
+    const allErrors = [];
+    function walk(value) {
+        if (typeof value === 'string') {
+            const { wikilinks, errors } = extractWikilinks(value, location, 1);
+            allWikilinks.push(...wikilinks);
+            allErrors.push(...errors);
+        }
+        else if (Array.isArray(value)) {
+            for (const item of value)
+                walk(item);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            for (const v of Object.values(value))
+                walk(v);
+        }
+    }
+    walk(obj);
+    return { wikilinks: allWikilinks, errors: allErrors };
+}
+//# sourceMappingURL=note-parser.js.map

package/dist/core/parser/note-parser.js.map

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

package/dist/core/parser/requirement-parser.d.ts

@@ -0,0 +1,13 @@
+import type { Section, ParseError } from './types.js';
+import type { Requirement } from '../../types/requirement.js';
+/**
+ * Parse requirement blocks from a Feature note's section tree.
+ *
+ * The `key` field is NOT set here (parser doesn't know feature_id).
+ * The index engine sets it as `${feature_id}::${name}`.
+ */
+export declare function parseRequirements(sections: Section[]): {
+    requirements: Requirement[];
+    errors: ParseError[];
+};
+//# sourceMappingURL=requirement-parser.d.ts.map

package/dist/core/parser/requirement-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-parser.d.ts","sourceRoot":"","sources":["../../../src/core/parser/requirement-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,4BAA4B,CAAC;AAOxE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EAAE,GAClB;IAAE,YAAY,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAmGvD"}

package/dist/core/parser/requirement-parser.js

@@ -0,0 +1,127 @@
+import { createHash } from 'node:crypto';
+import { findSection } from './section-parser.js';
+import { normalizeForHash } from '../../utils/normalize.js';
+const REQUIREMENT_HEADING_REGEX = /^Requirement:\s*(.+)$/;
+const SCENARIO_HEADING_REGEX = /^Scenario:\s*(.+)$/;
+/**
+ * Parse requirement blocks from a Feature note's section tree.
+ *
+ * The `key` field is NOT set here (parser doesn't know feature_id).
+ * The index engine sets it as `${feature_id}::${name}`.
+ */
+export function parseRequirements(sections) {
+    const requirements = [];
+    const errors = [];
+    const seenNames = new Set();
+    const reqSection = findSection(sections, 'Requirements');
+    if (!reqSection) {
+        return { requirements, errors };
+    }
+    for (const child of reqSection.children) {
+        const nameMatch = child.title.match(REQUIREMENT_HEADING_REGEX);
+        if (!nameMatch)
+            continue;
+        const name = nameMatch[1].trim();
+        if (seenNames.has(name)) {
+            errors.push({
+                level: 'error',
+                source: 'requirement',
+                message: `Duplicate requirement name: "${name}"`,
+                line: child.line,
+            });
+            continue;
+        }
+        seenNames.add(name);
+        const normative = extractNormativeStatement(child);
+        if (!normative) {
+            errors.push({
+                level: 'warning',
+                source: 'requirement',
+                message: `Requirement "${name}" has no normative statement`,
+                line: child.line,
+            });
+        }
+        if (normative && !normative.includes('SHALL') && !normative.includes('MUST')) {
+            errors.push({
+                level: 'warning',
+                source: 'requirement',
+                message: `Requirement "${name}" normative statement lacks SHALL or MUST`,
+                line: child.line,
+            });
+        }
+        const scenarios = [];
+        for (const scenarioChild of child.children) {
+            const scenarioMatch = scenarioChild.title.match(SCENARIO_HEADING_REGEX);
+            if (!scenarioMatch)
+                continue;
+            const scenarioName = scenarioMatch[1].trim();
+            const scenarioText = scenarioChild.content.trim();
+            if (!scenarioText) {
+                errors.push({
+                    level: 'warning',
+                    source: 'requirement',
+                    message: `Scenario "${scenarioName}" in requirement "${name}" is empty`,
+                    line: scenarioChild.line,
+                });
+                continue;
+            }
+            if (!scenarioText.includes('WHEN') || !scenarioText.includes('THEN')) {
+                errors.push({
+                    level: 'warning',
+                    source: 'requirement',
+                    message: `Scenario "${scenarioName}" in requirement "${name}" lacks WHEN/THEN structure`,
+                    line: scenarioChild.line,
+                });
+            }
+            scenarios.push({ name: scenarioName, raw_text: scenarioText });
+        }
+        if (scenarios.length === 0) {
+            errors.push({
+                level: 'warning',
+                source: 'requirement',
+                message: `Requirement "${name}" has no scenarios`,
+                line: child.line,
+            });
+        }
+        const hashInput = normalizeForHashing(normative || '', scenarios);
+        const content_hash = computeHash(hashInput);
+        requirements.push({
+            name,
+            key: '', // placeholder; set by index-builder
+            normative: normative || '',
+            scenarios,
+            content_hash,
+        });
+    }
+    return { requirements, errors };
+}
+/**
+ * Extract the normative statement from a requirement section.
+ * Content before the first child heading.
+ */
+function extractNormativeStatement(section) {
+    const lines = section.content.split('\n');
+    const normativeLines = [];
+    for (const line of lines) {
+        if (line.match(/^#{1,6}\s+/)) {
+            break;
+        }
+        normativeLines.push(line);
+    }
+    const text = normativeLines.join('\n').trim();
+    return text || null;
+}
+function normalizeForHashing(normative, scenarios) {
+    const parts = [
+        normalizeForHash(normative),
+    ];
+    for (const s of scenarios) {
+        parts.push(normalizeForHash(s.raw_text));
+    }
+    return parts.join('\n');
+}
+function computeHash(input) {
+    const hash = createHash('sha256').update(input, 'utf-8').digest('hex');
+    return `sha256:${hash}`;
+}
+//# sourceMappingURL=requirement-parser.js.map

package/dist/core/parser/requirement-parser.js.map

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

package/dist/core/parser/section-parser.d.ts

@@ -0,0 +1,15 @@
+import type { Section, ParseError } from './types.js';
+/**
+ * Parse a markdown body into a hierarchical section tree.
+ * Skips lines inside fenced code blocks.
+ */
+export declare function parseSections(body: string, bodyStartLine?: number): {
+    sections: Section[];
+    headings: string[];
+    errors: ParseError[];
+};
+/**
+ * Find a section by title (case-insensitive, recursive).
+ */
+export declare function findSection(sections: Section[], title: string): Section | undefined;
+//# sourceMappingURL=section-parser.d.ts.map

package/dist/core/parser/section-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-parser.d.ts","sourceRoot":"","sources":["../../../src/core/parser/section-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKtD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,MAAU,GACxB;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CA6EnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAUnF"}

package/dist/core/parser/section-parser.js

@@ -0,0 +1,90 @@
+const HEADING_REGEX = /^(#{1,6})\s+(.+)$/;
+const CODE_FENCE_REGEX = /^(`{3,}|~{3,})/;
+/**
+ * Parse a markdown body into a hierarchical section tree.
+ * Skips lines inside fenced code blocks.
+ */
+export function parseSections(body, bodyStartLine = 1) {
+    const errors = [];
+    const sections = [];
+    const headings = [];
+    const normalizedBody = body.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const lines = normalizedBody.split('\n');
+    const stack = [];
+    // Collect heading positions, skipping code fences
+    const headingPositions = [];
+    let insideCodeFence = false;
+    let codeFenceMarker = '';
+    for (let i = 0; i < lines.length; i++) {
+        const fenceMatch = lines[i].match(CODE_FENCE_REGEX);
+        if (fenceMatch) {
+            if (!insideCodeFence) {
+                insideCodeFence = true;
+                codeFenceMarker = fenceMatch[1][0];
+            }
+            else if (lines[i].trim().startsWith(codeFenceMarker.repeat(3))) {
+                insideCodeFence = false;
+                codeFenceMarker = '';
+            }
+            continue;
+        }
+        if (insideCodeFence)
+            continue;
+        const match = lines[i].match(HEADING_REGEX);
+        if (match) {
+            headingPositions.push({
+                index: i,
+                level: match[1].length,
+                title: match[2].trim(),
+            });
+        }
+    }
+    for (let h = 0; h < headingPositions.length; h++) {
+        const { index, level, title } = headingPositions[h];
+        headings.push(title);
+        // Content: lines after this heading until the next heading of same or higher level
+        const contentLines = [];
+        const nextSameOrHigher = headingPositions.findIndex((hp, idx) => idx > h && hp.level <= level);
+        const endIndex = nextSameOrHigher !== -1
+            ? headingPositions[nextSameOrHigher].index
+            : lines.length;
+        for (let i = index + 1; i < endIndex; i++) {
+            contentLines.push(lines[i]);
+        }
+        const section = {
+            level,
+            title,
+            content: contentLines.join('\n').trim(),
+            line: bodyStartLine + index,
+            children: [],
+        };
+        // Build hierarchy using stack
+        while (stack.length > 0 && stack[stack.length - 1].level >= level) {
+            stack.pop();
+        }
+        if (stack.length === 0) {
+            sections.push(section);
+        }
+        else {
+            stack[stack.length - 1].children.push(section);
+        }
+        stack.push(section);
+    }
+    return { sections, headings, errors };
+}
+/**
+ * Find a section by title (case-insensitive, recursive).
+ */
+export function findSection(sections, title) {
+    const target = title.toLowerCase();
+    for (const section of sections) {
+        if (section.title.toLowerCase() === target) {
+            return section;
+        }
+        const child = findSection(section.children, title);
+        if (child)
+            return child;
+    }
+    return undefined;
+}
+//# sourceMappingURL=section-parser.js.map

package/dist/core/parser/section-parser.js.map

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

package/dist/core/parser/task-parser.d.ts

@@ -0,0 +1,9 @@
+import type { Section, ParsedTaskItem, ParseError } from './types.js';
+/**
+ * Parse task checklist items from a Change note's Tasks section.
+ */
+export declare function parseTasks(sections: Section[]): {
+    tasks: ParsedTaskItem[];
+    errors: ParseError[];
+};
+//# sourceMappingURL=task-parser.d.ts.map

package/dist/core/parser/task-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-parser.d.ts","sourceRoot":"","sources":["../../../src/core/parser/task-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKtE;;GAEG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,OAAO,EAAE,GAClB;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAyBnD"}

package/dist/core/parser/task-parser.js

@@ -0,0 +1,35 @@
+import { findSection } from './section-parser.js';
+const TASK_REGEX = /^-\s+\[([ xX])\]\s+(.+)$/;
+/**
+ * Parse task checklist items from a Change note's Tasks section.
+ */
+export function parseTasks(sections) {
+    const tasks = [];
+    const errors = [];
+    const taskSection = findSection(sections, 'Tasks');
+    if (!taskSection) {
+        return { tasks, errors };
+    }
+    // taskSection.content already includes all lines up to the next same-or-higher-level heading,
+    // including child heading lines. No need to recurse into children.
+    const lines = taskSection.content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const match = lines[i].match(TASK_REGEX);
+        if (match) {
+            tasks.push({
+                text: match[2].trim(),
+                done: match[1] !== ' ',
+                line: taskSection.line + i + 1,
+            });
+        }
+    }
+    return { tasks, errors };
+}
+function gatherAllContent(section) {
+    let content = section.content;
+    for (const child of section.children) {
+        content += '\n' + gatherAllContent(child);
+    }
+    return content;
+}
+//# sourceMappingURL=task-parser.js.map

package/dist/core/parser/task-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-parser.js","sourceRoot":"","sources":["../../../src/core/parser/task-parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,QAAmB;IAEnB,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED,8FAA8F;IAC9F,mEAAmE;IACnE,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBACrB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;gBACtB,IAAI,EAAE,WAAW,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC;aAC/B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACxC,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,IAAI,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/parser/types.d.ts

@@ -0,0 +1,94 @@
+import type { Frontmatter } from '../schema/frontmatter.js';
+import type { Requirement } from '../../types/requirement.js';
+import type { DeltaSummaryEntry } from '../../types/delta.js';
+/** Result of frontmatter extraction (before Zod validation) */
+export interface RawFrontmatter {
+    /** The raw YAML object */
+    data: Record<string, unknown>;
+    /** The body content after the closing --- */
+    body: string;
+    /** Line number where the body starts (1-indexed) */
+    bodyStartLine: number;
+}
+/** A parsed section from the heading hierarchy */
+export interface Section {
+    /** Heading level (1-6) */
+    level: number;
+    /** Heading text (without # prefix) */
+    title: string;
+    /** Content between this heading and the next heading of same or higher level */
+    content: string;
+    /** Line number of the heading (1-indexed) */
+    line: number;
+    /** Child sections (headings of deeper level) */
+    children: Section[];
+}
+/** A wikilink occurrence in the document */
+export interface WikilinkOccurrence {
+    /** The raw wikilink text, e.g. "Feature: Auth Login" (without brackets) */
+    target: string;
+    /** Display alias if present, e.g. "Auth" in [[Feature: Auth Login|Auth]] */
+    alias: string | null;
+    /** Where this wikilink was found */
+    location: 'frontmatter' | 'body';
+    /** Line number (1-indexed) */
+    line: number;
+}
+/** A parsed task item from a checklist */
+export interface ParsedTaskItem {
+    /** The task text (without the checkbox marker) */
+    text: string;
+    /** Whether the checkbox is checked */
+    done: boolean;
+    /** Line number (1-indexed) */
+    line: number;
+}
+/** Errors collected during parsing */
+export interface ParseError {
+    /** Error severity */
+    level: 'error' | 'warning';
+    /** What component produced this error */
+    source: 'frontmatter' | 'section' | 'wikilink' | 'requirement' | 'delta_summary' | 'task' | 'hash';
+    /** Human-readable error message */
+    message: string;
+    /** Line number if applicable (1-indexed) */
+    line?: number;
+}
+/**
+ * Complete parse result for a single note.
+ *
+ * IMPORTANT: This is the parser's output, NOT the final IndexRecord shape.
+ * Per 00-unified-types.md Ownership Rules:
+ *   - `requirements[].key` is an empty string placeholder ('').
+ *     The index engine (Plan 04) computes the composite key as `feature_id::name`.
+ *   - `deltaSummary[].target_note_id` contains the RAW wikilink target text
+ *     (e.g. "Feature: Auth Login"), NOT a resolved id.
+ *     The index engine (Plan 04) resolves this to a canonical id.
+ *   - All wikilink strings in frontmatter fields are RAW (not resolved to ids).
+ *     The index engine (Plan 04) resolves them using stripWikilinkSyntax + lookup.
+ */
+export interface ParseResult {
+    /** Validated frontmatter (null if frontmatter is invalid) */
+    frontmatter: Frontmatter | null;
+    /** Raw frontmatter data (always present if file has ---) */
+    rawFrontmatter: Record<string, unknown> | null;
+    /** Section tree */
+    sections: Section[];
+    /** Flat list of heading titles */
+    headings: string[];
+    /** All wikilinks found in the document */
+    wikilinks: WikilinkOccurrence[];
+    /** Parsed requirements (Feature notes only). key is '' placeholder. */
+    requirements: Requirement[];
+    /** Parsed delta summary entries (Change notes only). target_note_id is raw wikilink text. */
+    deltaSummary: DeltaSummaryEntry[];
+    /** Parsed tasks (Change notes only) */
+    tasks: ParsedTaskItem[];
+    /** Body text (markdown without frontmatter) */
+    body: string;
+    /** SHA-256 hash of the full body text, format: sha256:<hex> */
+    contentHash: string;
+    /** Errors encountered during parsing */
+    errors: ParseError[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/parser/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/parser/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,kDAAkD;AAClD,MAAM,WAAW,OAAO;IACtB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAAC;IACjC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,OAAO,CAAC;IACd,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,yCAAyC;IACzC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;IACnG,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,mBAAmB;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,uEAAuE;IACvE,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,6FAA6F;IAC7F,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,uCAAuC;IACvC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB"}

package/dist/core/parser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/parser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/parser/types.ts"],"names":[],"mappings":""}

package/dist/core/parser/wikilink-parser.d.ts

@@ -0,0 +1,19 @@
+import type { WikilinkOccurrence, ParseError } from './types.js';
+/**
+ * Extract all wikilinks from a string, tracking their location.
+ * Skips wikilinks inside fenced code blocks.
+ */
+export declare function extractWikilinks(text: string, location: 'frontmatter' | 'body', startLine?: number): {
+    wikilinks: WikilinkOccurrence[];
+    errors: ParseError[];
+};
+/**
+ * Strip wikilink syntax from a raw wikilink string.
+ * Strips [[...]] brackets and drops the display text after |.
+ */
+export declare function stripWikilinkSyntax(wikilink: string): string;
+/**
+ * Get unique wikilink target strings.
+ */
+export declare function uniqueWikilinkTargets(wikilinks: WikilinkOccurrence[]): string[];
+//# sourceMappingURL=wikilink-parser.d.ts.map

package/dist/core/parser/wikilink-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikilink-parser.d.ts","sourceRoot":"","sources":["../../../src/core/parser/wikilink-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAKjE;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,GAAG,MAAM,EAChC,SAAS,GAAE,MAAU,GACpB;IAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CA8C3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAM/E"}

package/dist/core/parser/wikilink-parser.js

@@ -0,0 +1,74 @@
+const WIKILINK_REGEX = /\[\[([^\]|]*?)(?:\|([^\]]+?))?\]\]/g;
+const CODE_FENCE_REGEX = /^(`{3,}|~{3,})/;
+/**
+ * Extract all wikilinks from a string, tracking their location.
+ * Skips wikilinks inside fenced code blocks.
+ */
+export function extractWikilinks(text, location, startLine = 1) {
+    const wikilinks = [];
+    const errors = [];
+    const lines = text.split('\n');
+    let insideCodeFence = false;
+    let codeFenceMarker = '';
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const fenceMatch = line.match(CODE_FENCE_REGEX);
+        if (fenceMatch) {
+            if (!insideCodeFence) {
+                insideCodeFence = true;
+                codeFenceMarker = fenceMatch[1][0];
+            }
+            else if (line.trim().startsWith(codeFenceMarker.repeat(3))) {
+                insideCodeFence = false;
+                codeFenceMarker = '';
+            }
+            continue;
+        }
+        if (insideCodeFence)
+            continue;
+        // Reset regex state for each line
+        const regex = new RegExp(WIKILINK_REGEX.source, WIKILINK_REGEX.flags);
+        let match;
+        while ((match = regex.exec(line)) !== null) {
+            const target = match[1].trim();
+            const alias = match[2]?.trim() ?? null;
+            if (target.length === 0) {
+                errors.push({
+                    level: 'warning',
+                    source: 'wikilink',
+                    message: 'Empty wikilink target',
+                    line: startLine + i,
+                });
+                continue;
+            }
+            wikilinks.push({ target, alias, location, line: startLine + i });
+        }
+    }
+    return { wikilinks, errors };
+}
+/**
+ * Strip wikilink syntax from a raw wikilink string.
+ * Strips [[...]] brackets and drops the display text after |.
+ */
+export function stripWikilinkSyntax(wikilink) {
+    let result = wikilink.trim();
+    if (result.startsWith('[[') && result.endsWith(']]')) {
+        result = result.slice(2, -2);
+    }
+    const pipeIndex = result.indexOf('|');
+    if (pipeIndex !== -1) {
+        result = result.slice(0, pipeIndex);
+    }
+    return result.trim();
+}
+/**
+ * Get unique wikilink target strings.
+ */
+export function uniqueWikilinkTargets(wikilinks) {
+    const targets = new Set();
+    for (const wl of wikilinks) {
+        targets.add(wl.target);
+    }
+    return Array.from(targets);
+}
+//# sourceMappingURL=wikilink-parser.js.map

package/dist/core/parser/wikilink-parser.js.map

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