@productbrain/cli 0.1.0-beta.1 → 0.1.0-beta.14

package/dist/generators/portable-knowledge.js

@@ -0,0 +1,246 @@
+/**
+ * Portable knowledge — reads canonical skills/rules from .productbrain/
+ * and generates tool-specific copies for Cursor, Claude Code, etc.
+ */
+import { readdirSync, readFileSync, existsSync } from 'fs';
+import { join, basename } from 'path';
+import { MARKER } from './adapters.js';
+/** Returns true if the entry should be emitted to the given target. */
+export function shouldEmitToTarget(entry, target) {
+    if (!entry.targets)
+        return true;
+    return entry.targets.includes(target);
+}
+const LEVEL_HIERARCHY = {
+    beginner: ['core'],
+    intermediate: ['core', 'intermediate'],
+    expert: ['core', 'intermediate', 'expert'],
+};
+const VALID_LEVELS = new Set(Object.keys(LEVEL_HIERARCHY));
+/**
+ * Filter items by graduated level.
+ * - If requestedLevel is undefined/null: return ALL items (backward compat).
+ * - Items with no `level` field: always included (backward compat).
+ * - Otherwise: include items whose level is within the hierarchy for requestedLevel.
+ */
+export function filterByLevel(items, requestedLevel) {
+    if (!requestedLevel)
+        return items;
+    if (!VALID_LEVELS.has(requestedLevel)) {
+        throw new Error(`Unknown level "${requestedLevel}". Valid levels: ${[...VALID_LEVELS].join(', ')}`);
+    }
+    const allowedLevels = LEVEL_HIERARCHY[requestedLevel];
+    return items.filter((item) => !item.level || allowedLevels.includes(item.level));
+}
+// ── Frontmatter parser ─────────────────────────────────────────────────
+function parseFrontmatter(raw) {
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return { fields: new Map(), arrayFields: new Map(), body: raw };
+    const yaml = match[1];
+    const body = match[2];
+    const fields = new Map();
+    const arrayFields = new Map();
+    const lines = yaml.split('\n');
+    let currentKey = null;
+    let collectingMultiline = false;
+    let collectingArray = false;
+    for (const line of lines) {
+        // Array item: "  - value"
+        if (collectingArray && currentKey && /^\s+-\s/.test(line)) {
+            const items = arrayFields.get(currentKey) ?? [];
+            items.push(line.replace(/^\s+-\s+/, '').trim().replace(/^["']|["']$/g, ''));
+            arrayFields.set(currentKey, items);
+            continue;
+        }
+        // Multiline continuation: indented text after >- or >
+        if (collectingMultiline && currentKey && /^\s+\S/.test(line)) {
+            const existing = fields.get(currentKey) ?? '';
+            fields.set(currentKey, (existing ? existing + ' ' : '') + line.trim());
+            continue;
+        }
+        // New key — reset collection state
+        collectingMultiline = false;
+        collectingArray = false;
+        const kv = line.match(/^([\w-]+):\s*(.*)/);
+        if (!kv)
+            continue;
+        currentKey = kv[1];
+        const val = kv[2].trim();
+        if (val === '' || val === '>-' || val === '>') {
+            // Could be array or multiline — peek ahead via next iterations
+            // If next line starts with "  -", it's an array; if indented text, it's multiline
+            collectingMultiline = val === '>-' || val === '>';
+            collectingArray = val === '';
+            continue;
+        }
+        fields.set(currentKey, val.replace(/^["']|["']$/g, ''));
+    }
+    return { fields, arrayFields, body };
+}
+// ── Readers ────────────────────────────────────────────────────────────
+export function readCanonicalSkills(productbrainDir) {
+    const skillsDir = join(productbrainDir, 'skills');
+    if (!existsSync(skillsDir))
+        return [];
+    const files = readdirSync(skillsDir).filter((f) => f.endsWith('.md'));
+    const skills = [];
+    for (const file of files) {
+        const filePath = join(skillsDir, file);
+        const raw = readFileSync(filePath, 'utf8');
+        const { fields, arrayFields, body } = parseFrontmatter(raw);
+        const name = fields.get('name') ?? basename(file, '.md');
+        const description = fields.get('description') ?? '';
+        const triggers = arrayFields.get('triggers') ?? [];
+        const targets = arrayFields.get('targets');
+        const level = fields.get('level');
+        skills.push({ name, description, triggers, body, sourcePath: filePath, targets: targets?.length ? targets : undefined, level: level || undefined });
+    }
+    return skills.sort((a, b) => a.name.localeCompare(b.name));
+}
+export function readCanonicalRules(productbrainDir) {
+    const rulesDir = join(productbrainDir, 'rules');
+    if (!existsSync(rulesDir))
+        return [];
+    const files = readdirSync(rulesDir).filter((f) => f.endsWith('.md'));
+    const rules = [];
+    for (const file of files) {
+        const filePath = join(rulesDir, file);
+        const raw = readFileSync(filePath, 'utf8');
+        const { fields, arrayFields, body } = parseFrontmatter(raw);
+        const name = fields.get('name') ?? basename(file, '.md');
+        const description = fields.get('description') ?? '';
+        const scope = fields.get('scope');
+        const autoApply = fields.get('autoApply') === 'true';
+        const targets = arrayFields.get('targets');
+        const level = fields.get('level');
+        rules.push({ name, description, scope, autoApply, body, sourcePath: filePath, targets: targets?.length ? targets : undefined, level: level || undefined });
+    }
+    return rules.sort((a, b) => a.name.localeCompare(b.name));
+}
+// ── Transport section stripping ───────────────────────────────────────
+/**
+ * Strip transport-conditional sections from a skill body.
+ *
+ * Sections are delimited by HTML comments:
+ *   <!-- transport:TARGET_NAME -->
+ *   ...content...
+ *   <!-- /transport -->
+ *
+ * - Blocks matching the current target: keep the content, remove the delimiter comments.
+ * - Blocks for OTHER targets: remove entirely (delimiters + content).
+ * - Content outside any transport block: keep as-is (universal content).
+ */
+export function stripTransportSections(body, target) {
+    // Match transport blocks: <!-- transport:NAME -->...<!-- /transport -->
+    // Using a non-greedy match between the opening and the NEXT closing tag.
+    const transportBlockRe = /<!-- transport:(\w+) -->\n?([\s\S]*?)<!-- \/transport -->\n?/g;
+    return body.replace(transportBlockRe, (_match, blockTarget, content) => {
+        if (blockTarget === target) {
+            // Keep the content, remove the delimiter comments
+            return content;
+        }
+        // Remove the entire block for other targets
+        return '';
+    });
+}
+// ── Cursor generators ──────────────────────────────────────────────────
+/**
+ * Generate a Cursor SKILL.md from a canonical skill.
+ * Cursor expects: name, description (with triggers embedded).
+ */
+export function generateCursorSkill(skill) {
+    // Cursor puts trigger phrases in the description field
+    const triggerLine = skill.triggers.length > 0
+        ? `  Use when the user says ${skill.triggers.map((t) => `"${t}"`).join(', ')}.`
+        : '';
+    const description = skill.description + triggerLine;
+    // Strip transport sections BEFORE path replacement
+    const stripped = stripTransportSections(skill.body, 'cursor');
+    // Replace canonical paths with Cursor paths in body
+    const body = stripped
+        .replace(/\.productbrain\/rules\/(\S+)\.md/g, '.cursor/rules/$1.mdc')
+        .replace(/\.productbrain\/skills\/(\S+)\.md/g, '.cursor/skills/$1/SKILL.md');
+    return `---
+name: ${skill.name}
+description: >-
+  ${description.replace(/\n/g, '\n  ')}
+---
+<!-- ${MARKER} — source: .productbrain/skills/${skill.name}.md -->
+
+${body}`;
+}
+/**
+ * Generate a Cursor .mdc rule from a canonical rule.
+ * Cursor expects: description, globs, alwaysApply.
+ */
+export function generateCursorRule(rule) {
+    // Replace canonical paths with Cursor paths in body
+    const body = rule.body
+        .replace(/\.productbrain\/rules\/(\S+)\.md/g, '.cursor/rules/$1.mdc')
+        .replace(/\.productbrain\/skills\/(\S+)\.md/g, '.cursor/skills/$1/SKILL.md');
+    return `---
+description: ${rule.description}
+globs: ${rule.scope ?? ''}
+alwaysApply: ${rule.autoApply}
+---
+<!-- ${MARKER} — source: .productbrain/rules/${rule.name}.md -->
+
+${body}`;
+}
+// ── Claude Code generators ────────────────────────────────────────────
+/**
+ * Generate a Claude Code .md rule from a canonical rule.
+ * Claude Code expects: description, optional paths (array).
+ */
+export function generateClaudeRule(rule) {
+    // Replace canonical paths with Claude Code paths in body
+    const body = rule.body
+        .replace(/\.productbrain\/rules\/(\S+)\.md/g, '.claude/rules/$1.md')
+        .replace(/\.productbrain\/skills\/(\S+)\.md/g, '.productbrain/skills/$1.md');
+    // Build frontmatter
+    const fmLines = ['---'];
+    fmLines.push(`description: "${rule.description.replace(/"/g, '\\"')}"`);
+    if (rule.scope) {
+        fmLines.push('paths:');
+        fmLines.push(`  - "${rule.scope}"`);
+    }
+    fmLines.push('---');
+    return `${fmLines.join('\n')}
+<!-- ${MARKER} — source: .productbrain/rules/${rule.name}.md -->
+
+${body}`;
+}
+/**
+ * Generate a Claude Code skill-router.md — imperative skill activation rule.
+ * Loaded automatically by Claude Code via .claude/rules/ with no paths (always active).
+ */
+export function generateClaudeSkillRouter(skills) {
+    if (skills.length === 0)
+        return '';
+    const triggerBlocks = skills.map((skill) => {
+        const triggerList = skill.triggers.map((t) => `"${t}"`).join(' / ');
+        return `- User says ${triggerList}
+  → READ \`.productbrain/skills/${skill.name}.md\` — follow its full protocol`;
+    });
+    return `---
+description: "Skill activation router — MUST read skill file before responding when triggers match"
+---
+<!-- ${MARKER} — source: generated from .productbrain/skills/*.md -->
+
+# Skill Router — Mandatory Activation
+
+BEFORE responding to ANY user message, scan for these triggers.
+If ANY trigger matches: READ the skill file FIRST, then follow its full protocol.
+Do NOT respond with your own approach. The skill IS the approach.
+
+## Triggers
+
+${triggerBlocks.join('\n\n')}
+
+## Why This Matters
+
+Skipping the skill file produces a shallow response that misses governance, blast radius, and Chain context. This is the #1 quality failure in this workspace. The skill files encode the full protocol — including Chain checks, domain identification, and review gates — that a direct response will miss.
+`;
+}
+//# sourceMappingURL=portable-knowledge.js.map

package/dist/generators/portable-knowledge.js.map

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

package/dist/generators/portable-knowledge.test.d.ts

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

package/dist/generators/portable-knowledge.test.d.ts.map

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

package/dist/generators/portable-knowledge.test.js

@@ -0,0 +1,399 @@
+/**
+ * portable-knowledge — unit tests.
+ * BET-169: transport-aware skill dispatch, target filtering, and transport section stripping.
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { join } from 'path';
+// vi.mock calls are hoisted — use vi.hoisted() for constants referenced inside factories.
+const { vfs } = vi.hoisted(() => ({
+    vfs: {},
+}));
+vi.mock('fs', () => ({
+    mkdirSync: vi.fn(),
+    writeFileSync: vi.fn((path, content) => {
+        vfs[path] = content;
+    }),
+    existsSync: vi.fn((path) => {
+        // Check if the path itself or any child key exists (for directory checks)
+        if (path in vfs)
+            return true;
+        // For directory checks: return true if any key starts with path + '/'
+        return Object.keys(vfs).some((k) => k.startsWith(path + '/'));
+    }),
+    readFileSync: vi.fn((path, _enc) => {
+        if (path in vfs)
+            return vfs[path];
+        throw Object.assign(new Error(`ENOENT: no such file '${path}'`), { code: 'ENOENT' });
+    }),
+    readdirSync: vi.fn((dir) => {
+        const prefix = dir.endsWith('/') ? dir : dir + '/';
+        const files = new Set();
+        for (const key of Object.keys(vfs)) {
+            if (key.startsWith(prefix)) {
+                const rest = key.slice(prefix.length);
+                const parts = rest.split('/');
+                if (parts.length === 1)
+                    files.add(parts[0]);
+            }
+        }
+        return [...files];
+    }),
+}));
+import { readCanonicalSkills, shouldEmitToTarget, stripTransportSections, filterByLevel, generateCursorSkill, generateClaudeSkillRouter, } from './portable-knowledge.js';
+const PB_DIR = '/tmp/pb-test/.productbrain';
+describe('readCanonicalSkills', () => {
+    beforeEach(() => {
+        Object.keys(vfs).forEach((k) => delete vfs[k]);
+    });
+    it('parses targets from frontmatter', () => {
+        vfs[join(PB_DIR, 'skills', 'test-skill.md')] = `---
+name: test-skill
+description: A test skill
+triggers:
+  - test
+targets:
+  - claude
+---
+
+# Test Skill Body
+`;
+        const skills = readCanonicalSkills(PB_DIR);
+        expect(skills).toHaveLength(1);
+        expect(skills[0].targets).toEqual(['claude']);
+    });
+    it('returns undefined targets when not specified in frontmatter', () => {
+        vfs[join(PB_DIR, 'skills', 'universal-skill.md')] = `---
+name: universal-skill
+description: A universal skill
+triggers:
+  - universal
+---
+
+# Universal Skill Body
+`;
+        const skills = readCanonicalSkills(PB_DIR);
+        expect(skills).toHaveLength(1);
+        expect(skills[0].targets).toBeUndefined();
+    });
+    it('parses multiple targets', () => {
+        vfs[join(PB_DIR, 'skills', 'multi-target.md')] = `---
+name: multi-target
+description: Multi-target skill
+triggers:
+  - multi
+targets:
+  - claude
+  - cursor
+---
+
+# Multi-Target Body
+`;
+        const skills = readCanonicalSkills(PB_DIR);
+        expect(skills).toHaveLength(1);
+        expect(skills[0].targets).toEqual(['claude', 'cursor']);
+    });
+    it('parses level from frontmatter', () => {
+        vfs[join(PB_DIR, 'skills', 'leveled-skill.md')] = `---
+name: leveled-skill
+description: A leveled skill
+level: core
+triggers:
+  - leveled
+---
+
+# Leveled Skill Body
+`;
+        const skills = readCanonicalSkills(PB_DIR);
+        expect(skills).toHaveLength(1);
+        expect(skills[0].level).toBe('core');
+    });
+    it('returns undefined level when not specified in frontmatter', () => {
+        vfs[join(PB_DIR, 'skills', 'no-level-skill.md')] = `---
+name: no-level-skill
+description: A skill without level
+triggers:
+  - nolevel
+---
+
+# No Level Skill Body
+`;
+        const skills = readCanonicalSkills(PB_DIR);
+        expect(skills).toHaveLength(1);
+        expect(skills[0].level).toBeUndefined();
+    });
+});
+describe('shouldEmitToTarget', () => {
+    it('returns true when targets is undefined (emit to all)', () => {
+        const skill = {
+            name: 'test',
+            description: '',
+            triggers: [],
+            body: '',
+            sourcePath: '',
+        };
+        expect(shouldEmitToTarget(skill, 'claude')).toBe(true);
+        expect(shouldEmitToTarget(skill, 'cursor')).toBe(true);
+        expect(shouldEmitToTarget(skill, 'copilot')).toBe(true);
+    });
+    it('returns true when target is in the list', () => {
+        const skill = {
+            name: 'test',
+            description: '',
+            triggers: [],
+            body: '',
+            sourcePath: '',
+            targets: ['claude'],
+        };
+        expect(shouldEmitToTarget(skill, 'claude')).toBe(true);
+    });
+    it('returns false when target is not in the list', () => {
+        const skill = {
+            name: 'test',
+            description: '',
+            triggers: [],
+            body: '',
+            sourcePath: '',
+            targets: ['claude'],
+        };
+        expect(shouldEmitToTarget(skill, 'cursor')).toBe(false);
+        expect(shouldEmitToTarget(skill, 'copilot')).toBe(false);
+    });
+    it('works for CanonicalRule as well', () => {
+        const rule = {
+            name: 'test-rule',
+            description: '',
+            autoApply: true,
+            body: '',
+            sourcePath: '',
+            targets: ['cursor'],
+        };
+        expect(shouldEmitToTarget(rule, 'cursor')).toBe(true);
+        expect(shouldEmitToTarget(rule, 'claude')).toBe(false);
+    });
+});
+describe('stripTransportSections', () => {
+    it('keeps content for the matching target and removes delimiters', () => {
+        const body = `Universal content above.
+
+<!-- transport:claude -->
+Claude-specific instructions here.
+<!-- /transport -->
+
+Universal content below.`;
+        const result = stripTransportSections(body, 'claude');
+        expect(result).toContain('Claude-specific instructions here.');
+        expect(result).toContain('Universal content above.');
+        expect(result).toContain('Universal content below.');
+        expect(result).not.toContain('<!-- transport:claude -->');
+        expect(result).not.toContain('<!-- /transport -->');
+    });
+    it('removes blocks for other targets entirely', () => {
+        const body = `Universal content.
+
+<!-- transport:cursor -->
+Cursor-only instructions.
+<!-- /transport -->
+
+More universal.`;
+        const result = stripTransportSections(body, 'claude');
+        expect(result).toContain('Universal content.');
+        expect(result).toContain('More universal.');
+        expect(result).not.toContain('Cursor-only instructions.');
+        expect(result).not.toContain('<!-- transport:cursor -->');
+    });
+    it('handles multiple transport blocks for different targets', () => {
+        const body = `# Heading
+
+<!-- transport:claude -->
+Claude dispatch: use Agent tool.
+<!-- /transport -->
+
+<!-- transport:cursor -->
+Cursor dispatch: use fresh conversation.
+<!-- /transport -->
+
+## Footer`;
+        const claudeResult = stripTransportSections(body, 'claude');
+        expect(claudeResult).toContain('Claude dispatch: use Agent tool.');
+        expect(claudeResult).not.toContain('Cursor dispatch: use fresh conversation.');
+        expect(claudeResult).toContain('# Heading');
+        expect(claudeResult).toContain('## Footer');
+        const cursorResult = stripTransportSections(body, 'cursor');
+        expect(cursorResult).toContain('Cursor dispatch: use fresh conversation.');
+        expect(cursorResult).not.toContain('Claude dispatch: use Agent tool.');
+        expect(cursorResult).toContain('# Heading');
+        expect(cursorResult).toContain('## Footer');
+    });
+    it('keeps universal content untouched when no transport blocks exist', () => {
+        const body = `# Just a normal skill
+
+No transport sections here.
+
+## Section 2
+
+More content.`;
+        const result = stripTransportSections(body, 'claude');
+        expect(result).toBe(body);
+    });
+    it('handles markdown and code blocks inside transport sections', () => {
+        const body = `Universal.
+
+<!-- transport:claude -->
+**Bold text** and \`inline code\`.
+
+\`\`\`bash
+git diff main..HEAD
+\`\`\`
+
+- List item 1
+- List item 2
+<!-- /transport -->
+
+End.`;
+        const result = stripTransportSections(body, 'claude');
+        expect(result).toContain('**Bold text** and `inline code`.');
+        expect(result).toContain('git diff main..HEAD');
+        expect(result).toContain('- List item 1');
+        expect(result).toContain('End.');
+    });
+    it('handles transport sections with no trailing newline after closing tag', () => {
+        const body = `Before.
+<!-- transport:claude -->
+Content.
+<!-- /transport -->After.`;
+        const result = stripTransportSections(body, 'claude');
+        expect(result).toContain('Content.');
+        expect(result).toContain('After.');
+    });
+});
+describe('generateCursorSkill (transport stripping)', () => {
+    it('strips non-cursor transport sections from generated output', () => {
+        const skill = {
+            name: 'test-skill',
+            description: 'Test skill',
+            triggers: ['test'],
+            body: `# Heading
+
+<!-- transport:claude -->
+Claude-only content.
+<!-- /transport -->
+
+<!-- transport:cursor -->
+Cursor-only content.
+<!-- /transport -->
+
+Universal content.`,
+            sourcePath: '/tmp/.productbrain/skills/test-skill.md',
+        };
+        const output = generateCursorSkill(skill);
+        expect(output).toContain('Cursor-only content.');
+        expect(output).not.toContain('Claude-only content.');
+        expect(output).toContain('Universal content.');
+        expect(output).not.toContain('<!-- transport:');
+    });
+});
+describe('generateClaudeSkillRouter (target filtering)', () => {
+    it('includes only skills with matching or no targets', () => {
+        const claudeOnly = {
+            name: 'claude-skill',
+            description: 'Claude only',
+            triggers: ['test-claude'],
+            body: '# Claude',
+            sourcePath: '/tmp/skills/claude-skill.md',
+            targets: ['claude'],
+        };
+        const cursorOnly = {
+            name: 'cursor-skill',
+            description: 'Cursor only',
+            triggers: ['test-cursor'],
+            body: '# Cursor',
+            sourcePath: '/tmp/skills/cursor-skill.md',
+            targets: ['cursor'],
+        };
+        const universal = {
+            name: 'universal-skill',
+            description: 'Universal',
+            triggers: ['test-universal'],
+            body: '# Universal',
+            sourcePath: '/tmp/skills/universal-skill.md',
+        };
+        // Filter skills for Claude (as handshake.ts would do)
+        const claudeSkills = [claudeOnly, cursorOnly, universal].filter((s) => shouldEmitToTarget(s, 'claude'));
+        const router = generateClaudeSkillRouter(claudeSkills);
+        expect(router).toContain('claude-skill');
+        expect(router).toContain('universal-skill');
+        expect(router).not.toContain('cursor-skill');
+    });
+    it('skill with targets: [claude] does not appear in Cursor output', () => {
+        const claudeOnly = {
+            name: 'claude-exclusive',
+            description: 'Claude exclusive skill',
+            triggers: ['claude-trigger'],
+            body: '# Claude Exclusive',
+            sourcePath: '/tmp/skills/claude-exclusive.md',
+            targets: ['claude'],
+        };
+        // Filter for Cursor (as handshake.ts would do)
+        const cursorSkills = [claudeOnly].filter((s) => shouldEmitToTarget(s, 'cursor'));
+        expect(cursorSkills).toHaveLength(0);
+    });
+    it('skill with no targets appears in both Claude and Cursor output', () => {
+        const universal = {
+            name: 'universal',
+            description: 'Universal skill',
+            triggers: ['uni'],
+            body: '# Universal',
+            sourcePath: '/tmp/skills/universal.md',
+        };
+        const claudeSkills = [universal].filter((s) => shouldEmitToTarget(s, 'claude'));
+        const cursorSkills = [universal].filter((s) => shouldEmitToTarget(s, 'cursor'));
+        expect(claudeSkills).toHaveLength(1);
+        expect(cursorSkills).toHaveLength(1);
+        const router = generateClaudeSkillRouter(claudeSkills);
+        expect(router).toContain('universal');
+        const cursorOutput = generateCursorSkill(cursorSkills[0]);
+        expect(cursorOutput).toContain('universal');
+    });
+});
+describe('filterByLevel', () => {
+    const items = [
+        { name: 'core-item', level: 'core' },
+        { name: 'intermediate-item', level: 'intermediate' },
+        { name: 'expert-item', level: 'expert' },
+        { name: 'no-level-item' },
+    ];
+    it('filterByLevel("beginner") returns only level:core items + items with no level', () => {
+        const result = filterByLevel(items, 'beginner');
+        const names = result.map((i) => i.name);
+        expect(names).toContain('core-item');
+        expect(names).toContain('no-level-item');
+        expect(names).not.toContain('intermediate-item');
+        expect(names).not.toContain('expert-item');
+        expect(result).toHaveLength(2);
+    });
+    it('filterByLevel("intermediate") returns core + intermediate + no level', () => {
+        const result = filterByLevel(items, 'intermediate');
+        const names = result.map((i) => i.name);
+        expect(names).toContain('core-item');
+        expect(names).toContain('intermediate-item');
+        expect(names).toContain('no-level-item');
+        expect(names).not.toContain('expert-item');
+        expect(result).toHaveLength(3);
+    });
+    it('filterByLevel("expert") returns all items', () => {
+        const result = filterByLevel(items, 'expert');
+        expect(result).toHaveLength(4);
+    });
+    it('filterByLevel(undefined) returns all items (backward compat)', () => {
+        const result = filterByLevel(items, undefined);
+        expect(result).toHaveLength(4);
+    });
+    it('filterByLevel(null-ish) returns all items (backward compat)', () => {
+        const result = filterByLevel(items);
+        expect(result).toHaveLength(4);
+    });
+    it('unknown level throws an error', () => {
+        expect(() => filterByLevel(items, 'unknown')).toThrow('Unknown level "unknown"');
+    });
+});
+//# sourceMappingURL=portable-knowledge.test.js.map