@organon-methodology/tools 0.3.0

package/dist/core/config.js

@@ -0,0 +1,130 @@
+/**
+ * OrganonConfig resolution.
+ *
+ * Discovery order:
+ * 1. Explicit config file path (--config flag)
+ * 2. organon.config.json in projectRoot
+ * 3. Convention-based defaults (scan for organon/, .claude/skills/, etc.)
+ */
+import { z } from 'zod';
+const CONFIG_FILENAME = 'organon.config.json';
+const WorkflowPathsSchema = z.object({
+    claudeCode: z.string().optional(),
+    cursor: z.string().optional(),
+    generic: z.string().optional(),
+}).strict();
+const ConfigFileSchema = z.object({
+    methodology_version: z.string().optional(),
+    organonPaths: z.array(z.string()).optional(),
+    organonGlobs: z.array(z.string()).optional(),
+    ignorePatterns: z.array(z.string()).optional(),
+    workflowPaths: WorkflowPathsSchema.optional(),
+    freshnessThresholdHours: z.number().positive().optional(),
+    testGlobs: z.array(z.string()).optional(),
+    testIgnorePatterns: z.array(z.string()).optional(),
+}).strict();
+const DEFAULT_ORGANON_GLOBS = [
+    '**/ETHOS.md',
+    '**/PHILOSOPHY.md',
+    '**/PROTOCOL.md',
+    '**/PROTOCOLS.md',
+    '**/README.md',
+    '**/components.md',
+];
+const DEFAULT_IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/.git/**',
+    '**/coverage/**',
+    '*.test.*',
+    '*.spec.*',
+];
+const CONVENTION_ORGANON_DIRS = [
+    'organon',
+    'book-llms',
+];
+const CONVENTION_WORKFLOW_PATHS = {
+    claudeCode: '.claude/skills',
+    cursor: '.cursor/rules',
+    generic: 'organon/workflows',
+};
+/**
+ * Resolve config by merging file-based config with convention defaults.
+ */
+export async function resolveConfig(projectRoot, fs, configPath) {
+    const fileConfig = await loadConfigFile(projectRoot, fs, configPath);
+    const conventionPaths = await discoverConventionPaths(projectRoot, fs);
+    const organonPaths = fileConfig?.organonPaths ?? conventionPaths;
+    const organonGlobs = fileConfig?.organonGlobs ?? DEFAULT_ORGANON_GLOBS;
+    const ignorePatterns = fileConfig?.ignorePatterns ?? DEFAULT_IGNORE_PATTERNS;
+    const workflowPaths = {
+        ...CONVENTION_WORKFLOW_PATHS,
+        ...fileConfig?.workflowPaths,
+    };
+    const freshnessThresholdHours = fileConfig?.freshnessThresholdHours ?? 24;
+    const testGlobs = fileConfig?.testGlobs;
+    const testIgnorePatterns = fileConfig?.testIgnorePatterns;
+    return {
+        projectRoot,
+        organonPaths,
+        organonGlobs,
+        ignorePatterns,
+        workflowPaths,
+        freshnessThresholdHours,
+        testGlobs,
+        testIgnorePatterns,
+    };
+}
+async function loadConfigFile(projectRoot, fs, configPath) {
+    const path = configPath
+        ? joinPath(projectRoot, configPath)
+        : joinPath(projectRoot, CONFIG_FILENAME);
+    if (!await fs.exists(path)) {
+        return null;
+    }
+    const raw = await fs.readFile(path);
+    const parsed = JSON.parse(raw);
+    return ConfigFileSchema.parse(parsed);
+}
+async function discoverConventionPaths(projectRoot, fs) {
+    const found = [];
+    for (const dir of CONVENTION_ORGANON_DIRS) {
+        if (await fs.exists(joinPath(projectRoot, dir))) {
+            found.push(dir);
+        }
+    }
+    // Always include project root for top-level ETHOS.md etc.
+    if (!found.includes('.')) {
+        found.push('.');
+    }
+    return found;
+}
+/**
+ * Simple path join that handles both / and \ separators.
+ * Avoids importing node:path in the core module.
+ */
+export function joinPath(...segments) {
+    return segments
+        .map((s, i) => (i === 0 ? s : s.replace(/^[/\\]+/, '')))
+        .join('/')
+        .replace(/\/+/g, '/');
+}
+/**
+ * Get the directory portion of a path.
+ */
+export function dirName(path) {
+    const normalized = path.replace(/\\/g, '/');
+    const lastSlash = normalized.lastIndexOf('/');
+    if (lastSlash === -1)
+        return '.';
+    return normalized.substring(0, lastSlash);
+}
+/**
+ * Get the filename from a path.
+ */
+export function baseName(path) {
+    const normalized = path.replace(/\\/g, '/');
+    const lastSlash = normalized.lastIndexOf('/');
+    return lastSlash === -1 ? normalized : normalized.substring(lastSlash + 1);
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/core/config.test.d.ts.map

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

package/dist/core/config.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect } from 'vitest';
+import { resolveConfig, joinPath, dirName, baseName } from './config.js';
+import { MemoryFileSystem } from './test-helpers.js';
+describe('resolveConfig', () => {
+    it('uses convention defaults when no config file exists', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/organon/ETHOS.md': 'content',
+            '/project/book-llms/ETHOS.md': 'content',
+        });
+        const config = await resolveConfig('/project', fs);
+        expect(config.projectRoot).toBe('/project');
+        expect(config.organonPaths).toContain('organon');
+        expect(config.organonPaths).toContain('book-llms');
+        expect(config.organonPaths).toContain('.');
+        expect(config.freshnessThresholdHours).toBe(24);
+    });
+    it('loads config from organon.config.json', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/organon.config.json': JSON.stringify({
+                organonPaths: ['docs'],
+                freshnessThresholdHours: 48,
+            }),
+        });
+        const config = await resolveConfig('/project', fs);
+        expect(config.organonPaths).toEqual(['docs']);
+        expect(config.freshnessThresholdHours).toBe(48);
+    });
+    it('loads config from custom path', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/custom/config.json': JSON.stringify({
+                organonPaths: ['custom-docs'],
+            }),
+        });
+        const config = await resolveConfig('/project', fs, 'custom/config.json');
+        expect(config.organonPaths).toEqual(['custom-docs']);
+    });
+    it('includes default workflow paths', async () => {
+        const fs = new MemoryFileSystem();
+        const config = await resolveConfig('/project', fs);
+        expect(config.workflowPaths.claudeCode).toBe('.claude/skills');
+        expect(config.workflowPaths.cursor).toBe('.cursor/rules');
+        expect(config.workflowPaths.generic).toBe('organon/workflows');
+    });
+    it('merges config file workflow paths with defaults', async () => {
+        const fs = new MemoryFileSystem({
+            '/project/organon.config.json': JSON.stringify({
+                workflowPaths: { claudeCode: '.custom/skills' },
+            }),
+        });
+        const config = await resolveConfig('/project', fs);
+        expect(config.workflowPaths.claudeCode).toBe('.custom/skills');
+        expect(config.workflowPaths.cursor).toBe('.cursor/rules'); // still default
+    });
+});
+describe('joinPath', () => {
+    it('joins path segments', () => {
+        expect(joinPath('/project', 'book-llms', 'ETHOS.md')).toBe('/project/book-llms/ETHOS.md');
+    });
+    it('handles trailing slashes', () => {
+        expect(joinPath('/project/', 'file.md')).toBe('/project/file.md');
+    });
+    it('handles leading slashes on segments', () => {
+        expect(joinPath('/project', '/book-llms')).toBe('/project/book-llms');
+    });
+});
+describe('dirName', () => {
+    it('returns directory portion', () => {
+        expect(dirName('book-llms/ETHOS.md')).toBe('book-llms');
+    });
+    it('returns . for root-level file', () => {
+        expect(dirName('ETHOS.md')).toBe('.');
+    });
+    it('handles nested paths', () => {
+        expect(dirName('organon/domains/genesis/ETHOS.md')).toBe('organon/domains/genesis');
+    });
+    it('normalizes backslashes', () => {
+        expect(dirName('organon\\domains\\genesis\\ETHOS.md')).toBe('organon/domains/genesis');
+    });
+});
+describe('baseName', () => {
+    it('returns filename', () => {
+        expect(baseName('book-llms/ETHOS.md')).toBe('ETHOS.md');
+    });
+    it('returns the input for bare filenames', () => {
+        expect(baseName('ETHOS.md')).toBe('ETHOS.md');
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/core/config.test.js.map

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

package/dist/core/find.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cross-domain discovery.
+ *
+ * Rewritten (not ported) from Agent Tavern — the AT version was
+ * 60% AT-specific. This version operates on organon files + frontmatter
+ * rather than components.md or domain-specific structures.
+ *
+ * Search modes:
+ *   by-file   — find organons that govern a given file path
+ *   by-scope  — list all organons at a given scope level
+ *   by-type   — list all organons of a given type
+ *   by-name   — find organons matching a name pattern
+ */
+import type { FileSystem, FindResult, FrontmatterScope, FrontmatterType, OrganonConfig } from './types.js';
+export interface FindOptions {
+    projectRoot: string;
+    config: OrganonConfig;
+    fs: FileSystem;
+    /** Find organons that govern this file path */
+    file?: string;
+    /** Find all organons at this scope level */
+    scope?: FrontmatterScope;
+    /** Find all organons of this type */
+    type?: FrontmatterType;
+    /** Find organons matching this name (substring) */
+    name?: string;
+}
+export declare function find(options: FindOptions): Promise<FindResult>;
+//# sourceMappingURL=find.d.ts.map

package/dist/core/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/core/find.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAEV,UAAU,EAEV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EAEd,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,UAAU,CAAC;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,qCAAqC;IACrC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA2DpE"}

package/dist/core/find.js

@@ -0,0 +1,191 @@
+/**
+ * Cross-domain discovery.
+ *
+ * Rewritten (not ported) from Agent Tavern — the AT version was
+ * 60% AT-specific. This version operates on organon files + frontmatter
+ * rather than components.md or domain-specific structures.
+ *
+ * Search modes:
+ *   by-file   — find organons that govern a given file path
+ *   by-scope  — list all organons at a given scope level
+ *   by-type   — list all organons of a given type
+ *   by-name   — find organons matching a name pattern
+ */
+import { parseOrganonFile } from './frontmatter-parser.js';
+import { joinPath, dirName } from './config.js';
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+export async function find(options) {
+    const { projectRoot, config, fs } = options;
+    const errors = [];
+    const warnings = [];
+    // Discover and parse all organon files
+    const allFiles = await discoverOrganonFiles(projectRoot, config, fs);
+    const parsed = [];
+    for (const file of allFiles) {
+        const absPath = joinPath(projectRoot, file);
+        try {
+            const content = await fs.readFile(absPath);
+            parsed.push(parseOrganonFile(file, content));
+        }
+        catch {
+            errors.push({
+                severity: 'error',
+                code: 'FILE_READ_ERROR',
+                message: `Cannot read file: ${file}`,
+                file,
+            });
+        }
+    }
+    let mode;
+    let matches;
+    if (options.file) {
+        mode = 'by-file';
+        matches = findByFile(options.file, parsed);
+    }
+    else if (options.scope) {
+        mode = 'by-scope';
+        matches = findByScope(options.scope, parsed);
+    }
+    else if (options.type) {
+        mode = 'by-type';
+        matches = findByType(options.type, parsed);
+    }
+    else if (options.name) {
+        mode = 'by-name';
+        matches = findByName(options.name, parsed);
+    }
+    else {
+        return {
+            success: false,
+            mode: 'by-name',
+            matches: [],
+            errors: [{
+                    severity: 'error',
+                    code: 'FIND_NO_CRITERIA',
+                    message: 'Specify at least one search criterion: file, scope, type, or name',
+                }],
+            warnings: [],
+        };
+    }
+    return {
+        success: errors.length === 0,
+        mode,
+        matches,
+        errors,
+        warnings,
+    };
+}
+// ---------------------------------------------------------------------------
+// Search implementations
+// ---------------------------------------------------------------------------
+/**
+ * Find organons that govern a given file path.
+ * Walks up the directory tree to find the nearest ETHOS.md,
+ * plus product-level constraints.
+ */
+function findByFile(targetFile, parsed) {
+    const normalized = targetFile.replace(/\\/g, '/');
+    const matches = [];
+    // Always include product-level organons (root ETHOS.md, etc.)
+    const productFiles = parsed.filter((f) => f.frontmatter?.scope === 'product' ||
+        (f.frontmatter === null && isRootFile(f.path)));
+    for (const pf of productFiles) {
+        matches.push({
+            file: pf.path,
+            frontmatter: pf.frontmatter,
+            relevance: 'product-level constraint',
+        });
+    }
+    // Walk up the directory tree to find governing organons
+    let dir = dirName(normalized);
+    const visited = new Set();
+    while (dir && dir !== '.' && !visited.has(dir)) {
+        visited.add(dir);
+        const governing = parsed.filter((f) => {
+            const organonDir = dirName(f.path.replace(/\\/g, '/'));
+            return organonDir === dir;
+        });
+        for (const g of governing) {
+            if (!matches.find((m) => m.file === g.path)) {
+                matches.push({
+                    file: g.path,
+                    frontmatter: g.frontmatter,
+                    relevance: `directory ancestor: ${dir}`,
+                });
+            }
+        }
+        // Move up
+        const lastSlash = dir.lastIndexOf('/');
+        dir = lastSlash > 0 ? dir.substring(0, lastSlash) : '';
+    }
+    // Find by domain name match in the path
+    for (const p of parsed) {
+        if (p.frontmatter?.scope === 'domain' && p.frontmatter?.name) {
+            if (normalized.includes(`/${p.frontmatter.name}/`) || normalized.includes(`\\${p.frontmatter.name}\\`)) {
+                if (!matches.find((m) => m.file === p.path)) {
+                    matches.push({
+                        file: p.path,
+                        frontmatter: p.frontmatter,
+                        relevance: `domain name match: ${p.frontmatter.name}`,
+                    });
+                }
+            }
+        }
+    }
+    return matches;
+}
+function findByScope(scope, parsed) {
+    return parsed
+        .filter((f) => f.frontmatter?.scope === scope)
+        .map((f) => ({
+        file: f.path,
+        frontmatter: f.frontmatter,
+        relevance: `scope: ${scope}`,
+    }));
+}
+function findByType(type, parsed) {
+    return parsed
+        .filter((f) => f.frontmatter?.type === type)
+        .map((f) => ({
+        file: f.path,
+        frontmatter: f.frontmatter,
+        relevance: `type: ${type}`,
+    }));
+}
+function findByName(name, parsed) {
+    const lower = name.toLowerCase();
+    return parsed
+        .filter((f) => f.frontmatter?.name?.toLowerCase().includes(lower) ||
+        f.path.toLowerCase().includes(lower))
+        .map((f) => ({
+        file: f.path,
+        frontmatter: f.frontmatter,
+        relevance: `name match: ${name}`,
+    }));
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isRootFile(path) {
+    const normalized = path.replace(/\\/g, '/');
+    return !normalized.includes('/') || normalized.split('/').length <= 2;
+}
+async function discoverOrganonFiles(projectRoot, config, fs) {
+    const allFiles = new Set();
+    for (const organonPath of config.organonPaths) {
+        for (const pattern of config.organonGlobs) {
+            const fullPattern = organonPath === '.' ? pattern : `${organonPath}/${pattern}`;
+            const matches = await fs.glob(fullPattern, {
+                cwd: projectRoot,
+                ignore: config.ignorePatterns,
+            });
+            for (const m of matches) {
+                allFiles.add(m);
+            }
+        }
+    }
+    return [...allFiles].sort();
+}
+//# sourceMappingURL=find.js.map

package/dist/core/find.js.map

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

package/dist/core/find.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=find.test.d.ts.map

package/dist/core/find.test.d.ts.map

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

package/dist/core/find.test.js

@@ -0,0 +1,91 @@
+import { describe, it, expect } from 'vitest';
+import { find } from './find.js';
+import { MemoryFileSystem, makeEthos, makeReadme } from './test-helpers.js';
+function makeConfig(projectRoot) {
+    return {
+        projectRoot,
+        organonPaths: ['.'],
+        organonGlobs: ['**/ETHOS.md', '**/README.md'],
+        ignorePatterns: [],
+        workflowPaths: {},
+        freshnessThresholdHours: 24,
+    };
+}
+describe('find', () => {
+    function makeFs() {
+        return new MemoryFileSystem({
+            '/project/ETHOS.md': makeEthos({ name: 'product', scope: 'product' }),
+            '/project/organon/domains/genesis/ETHOS.md': makeEthos({ name: 'genesis', scope: 'domain' }),
+            '/project/organon/domains/agents/ETHOS.md': makeEthos({ name: 'agents', scope: 'domain' }),
+            '/project/README.md': makeReadme({ name: 'root', scope: 'product' }),
+        });
+    }
+    describe('by-scope', () => {
+        it('finds all domain-scoped organons', async () => {
+            const fs = makeFs();
+            const config = makeConfig('/project');
+            const result = await find({ projectRoot: '/project', config, fs, scope: 'domain' });
+            expect(result.mode).toBe('by-scope');
+            expect(result.matches.length).toBe(2);
+            expect(result.matches.every((m) => m.frontmatter?.scope === 'domain')).toBe(true);
+        });
+        it('finds product-scoped organons', async () => {
+            const fs = makeFs();
+            const config = makeConfig('/project');
+            const result = await find({ projectRoot: '/project', config, fs, scope: 'product' });
+            expect(result.matches.length).toBeGreaterThanOrEqual(1);
+        });
+    });
+    describe('by-type', () => {
+        it('finds all constraints files', async () => {
+            const fs = makeFs();
+            const config = makeConfig('/project');
+            const result = await find({ projectRoot: '/project', config, fs, type: 'constraints' });
+            expect(result.mode).toBe('by-type');
+            expect(result.matches.length).toBe(3); // product + genesis + agents
+            expect(result.matches.every((m) => m.frontmatter?.type === 'constraints')).toBe(true);
+        });
+    });
+    describe('by-name', () => {
+        it('finds organons matching a name pattern', async () => {
+            const fs = makeFs();
+            const config = makeConfig('/project');
+            const result = await find({ projectRoot: '/project', config, fs, name: 'genesis' });
+            expect(result.mode).toBe('by-name');
+            expect(result.matches.length).toBeGreaterThanOrEqual(1);
+            expect(result.matches.some((m) => m.frontmatter?.name === 'genesis')).toBe(true);
+        });
+        it('returns empty for no match', async () => {
+            const fs = makeFs();
+            const config = makeConfig('/project');
+            const result = await find({ projectRoot: '/project', config, fs, name: 'nonexistent' });
+            expect(result.matches.length).toBe(0);
+        });
+    });
+    describe('by-file', () => {
+        it('finds governing organons for a file path', async () => {
+            const fs = makeFs();
+            const config = makeConfig('/project');
+            const result = await find({
+                projectRoot: '/project',
+                config,
+                fs,
+                file: 'organon/domains/genesis/something.ts',
+            });
+            expect(result.mode).toBe('by-file');
+            // Should include product-level and genesis-level
+            expect(result.matches.some((m) => m.frontmatter?.scope === 'product')).toBe(true);
+            expect(result.matches.some((m) => m.frontmatter?.name === 'genesis')).toBe(true);
+        });
+    });
+    describe('no criteria', () => {
+        it('returns error when no search criteria provided', async () => {
+            const fs = makeFs();
+            const config = makeConfig('/project');
+            const result = await find({ projectRoot: '/project', config, fs });
+            expect(result.success).toBe(false);
+            expect(result.errors).toContainEqual(expect.objectContaining({ code: 'FIND_NO_CRITERIA' }));
+        });
+    });
+});
+//# sourceMappingURL=find.test.js.map

package/dist/core/find.test.js.map

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

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

@@ -0,0 +1,45 @@
+/**
+ * YAML frontmatter extraction utility.
+ *
+ * Parses the --- delimited YAML block at the top of organon files.
+ * Returns typed Frontmatter or null if missing/invalid.
+ */
+import type { Frontmatter, ParsedOrganonFile } from './types.js';
+export interface ParseResult {
+    frontmatter: Frontmatter | null;
+    rawFrontmatter: string;
+    body: string;
+}
+/**
+ * Extract and parse YAML frontmatter from file content.
+ */
+export declare function parseFrontmatter(content: string): ParseResult;
+/**
+ * Build a ParsedOrganonFile from raw file content and path.
+ */
+export declare function parseOrganonFile(path: string, content: string): ParsedOrganonFile;
+/**
+ * Estimate token count from content.
+ * Heuristic: ~3.5 characters per token for markdown text.
+ * (Accounts for spaces, punctuation, and markdown syntax)
+ */
+export declare function estimateTokens(content: string): number;
+/**
+ * Count entries in a numbered/bulleted section.
+ * Matches patterns like:
+ *   1. **Name.**
+ *   ### 1. Name
+ *   - **Name.**
+ *   ### Invariant 1:
+ */
+export declare function countSectionEntries(sectionContent: string): number;
+/**
+ * Extract a specific ## section from markdown content.
+ * Returns the content between the matched heading and the next ## heading (or EOF).
+ */
+export declare function extractSection(content: string, heading: string): string | null;
+/**
+ * Count rows in a markdown table (excluding header and separator rows).
+ */
+export declare function countTableRows(sectionContent: string): number;
+//# sourceMappingURL=frontmatter-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-parser.d.ts","sourceRoot":"","sources":["../../src/core/frontmatter-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIjE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAkB7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAGjF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAelE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CA6B7D"}