@rune-kit/rune 2.2.2 → 2.2.4

package/compiler/__tests__/adapters.test.js

@@ -0,0 +1,109 @@
+import assert from 'node:assert';
+import { describe, test } from 'node:test';
+import { getAdapter, listPlatforms } from '../adapters/index.js';
+
+// --- Adapter registry ---
+
+test('listPlatforms returns all 8 platform adapters', () => {
+  const adapters = listPlatforms();
+  const expected = ['claude', 'cursor', 'windsurf', 'antigravity', 'codex', 'opencode', 'openclaw', 'generic'];
+  for (const name of expected) {
+    assert.ok(adapters.includes(name), `missing adapter: ${name}`);
+  }
+});
+
+test('getAdapter returns adapter by name', () => {
+  const cursor = getAdapter('cursor');
+  assert.strictEqual(cursor.name, 'cursor');
+  assert.strictEqual(cursor.fileExtension, '.mdc');
+});
+
+test('getAdapter throws for unknown adapter', () => {
+  assert.throws(() => getAdapter('nonexistent'), /unknown/i);
+});
+
+// --- Shared adapter contract ---
+
+const REQUIRED_METHODS = [
+  'transformReference',
+  'transformToolName',
+  'generateHeader',
+  'generateFooter',
+  'transformSubagentInstruction',
+  'postProcess',
+];
+
+const REQUIRED_PROPS = ['name', 'outputDir', 'fileExtension', 'skillPrefix', 'skillSuffix'];
+
+const ADAPTER_NAMES = ['cursor', 'windsurf', 'antigravity', 'codex', 'opencode', 'generic'];
+
+for (const adapterName of ADAPTER_NAMES) {
+  describe(`${adapterName} adapter contract`, () => {
+    const adapter = getAdapter(adapterName);
+
+    test('has all required properties', () => {
+      for (const prop of REQUIRED_PROPS) {
+        assert.ok(prop in adapter, `${adapterName} missing prop: ${prop}`);
+      }
+    });
+
+    test('has all required methods', () => {
+      for (const method of REQUIRED_METHODS) {
+        assert.strictEqual(typeof adapter[method], 'function', `${adapterName} missing method: ${method}`);
+      }
+    });
+
+    test('transformReference handles plain and backticked refs', () => {
+      const plain = adapter.transformReference('cook', 'cook');
+      assert.ok(typeof plain === 'string' && plain.length > 0);
+
+      const backticked = adapter.transformReference('cook', '`cook`');
+      assert.ok(typeof backticked === 'string' && backticked.length > 0);
+    });
+
+    test('transformToolName maps known tools', () => {
+      const result = adapter.transformToolName('Read');
+      assert.ok(typeof result === 'string' && result.length > 0);
+    });
+
+    test('generateHeader returns string', () => {
+      const skill = { name: 'test', layer: 'L2', group: 'workflow', description: 'Test skill' };
+      const header = adapter.generateHeader(skill);
+      assert.strictEqual(typeof header, 'string');
+    });
+
+    test('generateFooter includes Rune branding', () => {
+      const footer = adapter.generateFooter();
+      assert.ok(footer.includes('Rune'), `${adapterName} footer missing Rune branding`);
+    });
+
+    test('postProcess strips Claude-specific directives', () => {
+      const input = 'context: fork\ncontent\nagent: general-purpose\nmore';
+      const result = adapter.postProcess(input);
+      assert.ok(!result.includes('context: fork'));
+      assert.ok(!result.includes('agent: general-purpose'));
+    });
+  });
+}
+
+// --- Cursor-specific ---
+
+test('cursor adapter generates .mdc frontmatter with alwaysApply', () => {
+  const cursor = getAdapter('cursor');
+  const l0Skill = { name: 'router', layer: 'L0', group: 'meta', description: 'Routes tasks' };
+  const l2Skill = { name: 'fix', layer: 'L2', group: 'workflow', description: 'Fix code' };
+
+  const l0Header = cursor.generateHeader(l0Skill);
+  assert.ok(l0Header.includes('alwaysApply: true'));
+
+  const l2Header = cursor.generateHeader(l2Skill);
+  assert.ok(l2Header.includes('alwaysApply: false'));
+});
+
+// --- Codex-specific ---
+
+test('codex adapter uses skill directories', () => {
+  const codex = getAdapter('codex');
+  assert.strictEqual(codex.useSkillDirectories, true);
+  assert.strictEqual(codex.skillFileName, 'SKILL.md');
+});

package/compiler/__tests__/openclaw-adapter.test.js

@@ -1,140 +1,149 @@
-import openclaw from '../adapters/openclaw.js';
-import { test } from 'node:test';
-import assert from 'node:assert';
-
-// --- Adapter shape ---
-
-test('openclaw adapter has all required properties', () => {
-  const required = [
-    'name', 'outputDir', 'fileExtension', 'skillPrefix', 'skillSuffix',
-    'transformReference', 'transformToolName', 'generateHeader', 'generateFooter',
-    'transformSubagentInstruction', 'postProcess',
-    'generateManifest', 'generateEntryPoint',
-  ];
-  for (const prop of required) {
-    assert.ok(prop in openclaw, `missing property: ${prop}`);
-  }
-});
-
-test('openclaw adapter has correct name and outputDir', () => {
-  assert.strictEqual(openclaw.name, 'openclaw');
-  assert.strictEqual(openclaw.outputDir, '.openclaw/rune/skills');
-  assert.strictEqual(openclaw.fileExtension, '.md');
-  assert.strictEqual(openclaw.skillPrefix, 'rune-');
-  assert.strictEqual(openclaw.skillSuffix, '');
-});
-
-// --- transformReference ---
-
-test('transformReference returns correct skill file reference', () => {
-  const result = openclaw.transformReference('cook', 'cook');
-  assert.strictEqual(result, 'rune-cook.md');
-});
-
-test('transformReference preserves backticks', () => {
-  const result = openclaw.transformReference('plan', '`plan`');
-  assert.strictEqual(result, '`rune-plan.md`');
-});
-
-// --- transformToolName ---
-
-test('transformToolName maps Claude Code tools to OpenClaw equivalents', () => {
-  assert.strictEqual(openclaw.transformToolName('Read'), 'read_file');
-  assert.strictEqual(openclaw.transformToolName('Write'), 'write_file');
-  assert.strictEqual(openclaw.transformToolName('Edit'), 'edit_file');
-  assert.strictEqual(openclaw.transformToolName('Bash'), 'run_command');
-  assert.strictEqual(openclaw.transformToolName('Glob'), 'glob');
-  assert.strictEqual(openclaw.transformToolName('Grep'), 'grep');
-});
-
-test('transformToolName passes through unknown tools', () => {
-  assert.strictEqual(openclaw.transformToolName('CustomTool'), 'CustomTool');
-});
-
-// --- generateHeader / generateFooter ---
-
-test('generateHeader produces valid markdown', () => {
-  const skill = { name: 'cook', layer: 'L1', group: 'orchestrator' };
-  const header = openclaw.generateHeader(skill);
-  assert.ok(header.startsWith('# rune-cook'));
-  assert.ok(header.includes('L1'));
-  assert.ok(header.includes('orchestrator'));
-});
-
-test('generateFooter includes Rune branding', () => {
-  const footer = openclaw.generateFooter();
-  assert.ok(footer.includes('Rune Skill Mesh'));
-  assert.ok(footer.includes('github.com/rune-kit/rune'));
-});
-
-// --- postProcess ---
-
-test('postProcess strips Claude-specific directives', () => {
-  const input = 'context: fork\nsome content\nagent: general-purpose\nmore content';
-  const result = openclaw.postProcess(input);
-  assert.ok(!result.includes('context: fork'));
-  assert.ok(!result.includes('agent: general-purpose'));
-  assert.ok(result.includes('some content'));
-  assert.ok(result.includes('more content'));
-});
-
-// --- generateManifest ---
-
-test('generateManifest returns valid openclaw.plugin.json structure', () => {
-  const skills = [
-    { name: 'cook', layer: 'L1', group: 'orchestrator' },
-    { name: 'plan', layer: 'L2', group: 'workflow' },
-  ];
-  const pluginJson = { version: '2.1.1', name: 'rune' };
-
-  const manifest = openclaw.generateManifest(skills, pluginJson);
-
-  assert.strictEqual(manifest.id, 'rune');
-  assert.strictEqual(manifest.name, 'Rune');
-  assert.strictEqual(manifest.kind, 'skills');
-  assert.strictEqual(manifest.version, '2.1.1');
-  assert.ok(Array.isArray(manifest.skills));
-  assert.deepStrictEqual(manifest.skills, ['./skills']);
-  assert.ok(manifest.configSchema);
-  assert.ok(manifest.configSchema.jsonSchema);
-  assert.strictEqual(manifest.configSchema.jsonSchema.type, 'object');
-});
-
-test('generateManifest defaults version when missing', () => {
-  const manifest = openclaw.generateManifest([], {});
-  assert.strictEqual(manifest.version, '0.0.0');
-});
-
-// --- generateEntryPoint ---
-
-test('generateEntryPoint returns valid TypeScript with register(api)', () => {
-  const skills = [
-    { name: 'cook', layer: 'L1', group: 'orchestrator', description: 'Feature orchestrator' },
-    { name: 'fix', layer: 'L2', group: 'workflow', description: 'Apply fixes' },
-  ];
-  const routerContent = '# skill-router\n\nRoute all tasks.';
-
-  const ts = openclaw.generateEntryPoint(skills, routerContent);
-
-  assert.ok(ts.includes('register(api'));
-  assert.ok(ts.includes("before_agent_start"));
-  assert.ok(ts.includes('prependSystemContext'));
-  assert.ok(ts.includes('export default plugin'));
-  assert.ok(ts.includes('cook'));
-  assert.ok(ts.includes('fix'));
-  assert.ok(ts.includes('skill-router'));
-});
-
-test('generateEntryPoint handles empty router content', () => {
-  const ts = openclaw.generateEntryPoint([], '');
-  assert.ok(ts.includes('register(api'));
-  assert.ok(ts.includes('export default plugin'));
-});
-
-test('generateEntryPoint escapes backticks in router content', () => {
-  const routerContent = 'Use `cook` skill for code tasks';
-  const ts = openclaw.generateEntryPoint([], routerContent);
-  // Should not have unescaped backticks inside template literal
-  assert.ok(!ts.includes('Use `cook`'));
-  assert.ok(ts.includes('\\`cook\\`'));
-});
+import assert from 'node:assert';
+import { test } from 'node:test';
+import openclaw from '../adapters/openclaw.js';
+
+// --- Adapter shape ---
+
+test('openclaw adapter has all required properties', () => {
+  const required = [
+    'name',
+    'outputDir',
+    'fileExtension',
+    'skillPrefix',
+    'skillSuffix',
+    'transformReference',
+    'transformToolName',
+    'generateHeader',
+    'generateFooter',
+    'transformSubagentInstruction',
+    'postProcess',
+    'generateManifest',
+    'generateEntryPoint',
+  ];
+  for (const prop of required) {
+    assert.ok(prop in openclaw, `missing property: ${prop}`);
+  }
+});
+
+test('openclaw adapter has correct name and outputDir', () => {
+  assert.strictEqual(openclaw.name, 'openclaw');
+  assert.strictEqual(openclaw.outputDir, '.openclaw/rune/skills');
+  assert.strictEqual(openclaw.fileExtension, '.md');
+  assert.strictEqual(openclaw.skillPrefix, 'rune-');
+  assert.strictEqual(openclaw.skillSuffix, '');
+});
+
+// --- transformReference ---
+
+test('transformReference returns correct skill file reference', () => {
+  const result = openclaw.transformReference('cook', 'cook');
+  assert.strictEqual(result, 'rune-cook.md');
+});
+
+test('transformReference preserves backticks', () => {
+  const result = openclaw.transformReference('plan', '`plan`');
+  assert.strictEqual(result, '`rune-plan.md`');
+});
+
+// --- transformToolName ---
+
+test('transformToolName maps Claude Code tools to OpenClaw equivalents', () => {
+  assert.strictEqual(openclaw.transformToolName('Read'), 'read_file');
+  assert.strictEqual(openclaw.transformToolName('Write'), 'write_file');
+  assert.strictEqual(openclaw.transformToolName('Edit'), 'edit_file');
+  assert.strictEqual(openclaw.transformToolName('Bash'), 'run_command');
+  assert.strictEqual(openclaw.transformToolName('Glob'), 'glob');
+  assert.strictEqual(openclaw.transformToolName('Grep'), 'grep');
+});
+
+test('transformToolName passes through unknown tools', () => {
+  assert.strictEqual(openclaw.transformToolName('CustomTool'), 'CustomTool');
+});
+
+// --- generateHeader / generateFooter ---
+
+test('generateHeader produces valid markdown', () => {
+  const skill = { name: 'cook', layer: 'L1', group: 'orchestrator' };
+  const header = openclaw.generateHeader(skill);
+  assert.ok(header.startsWith('# rune-cook'));
+  assert.ok(header.includes('L1'));
+  assert.ok(header.includes('orchestrator'));
+});
+
+test('generateFooter includes Rune branding', () => {
+  const footer = openclaw.generateFooter();
+  assert.ok(footer.includes('Rune Skill Mesh'));
+  assert.ok(footer.includes('github.com/rune-kit/rune'));
+});
+
+// --- postProcess ---
+
+test('postProcess strips Claude-specific directives', () => {
+  const input = 'context: fork\nsome content\nagent: general-purpose\nmore content';
+  const result = openclaw.postProcess(input);
+  assert.ok(!result.includes('context: fork'));
+  assert.ok(!result.includes('agent: general-purpose'));
+  assert.ok(result.includes('some content'));
+  assert.ok(result.includes('more content'));
+});
+
+// --- generateManifest ---
+
+test('generateManifest returns valid openclaw.plugin.json structure', () => {
+  const skills = [
+    { name: 'cook', layer: 'L1', group: 'orchestrator' },
+    { name: 'plan', layer: 'L2', group: 'workflow' },
+  ];
+  const pluginJson = { version: '2.1.1', name: 'rune' };
+
+  const manifest = openclaw.generateManifest(skills, pluginJson);
+
+  assert.strictEqual(manifest.id, 'rune');
+  assert.strictEqual(manifest.name, 'Rune');
+  assert.strictEqual(manifest.kind, 'skills');
+  assert.strictEqual(manifest.version, '2.1.1');
+  assert.ok(Array.isArray(manifest.skills));
+  assert.deepStrictEqual(manifest.skills, ['./skills']);
+  assert.ok(manifest.configSchema);
+  assert.ok(manifest.configSchema.jsonSchema);
+  assert.strictEqual(manifest.configSchema.jsonSchema.type, 'object');
+});
+
+test('generateManifest defaults version when missing', () => {
+  const manifest = openclaw.generateManifest([], {});
+  assert.strictEqual(manifest.version, '0.0.0');
+});
+
+// --- generateEntryPoint ---
+
+test('generateEntryPoint returns valid TypeScript with register(api)', () => {
+  const skills = [
+    { name: 'cook', layer: 'L1', group: 'orchestrator', description: 'Feature orchestrator' },
+    { name: 'fix', layer: 'L2', group: 'workflow', description: 'Apply fixes' },
+  ];
+  const routerContent = '# skill-router\n\nRoute all tasks.';
+
+  const ts = openclaw.generateEntryPoint(skills, routerContent);
+
+  assert.ok(ts.includes('register(api'));
+  assert.ok(ts.includes('before_agent_start'));
+  assert.ok(ts.includes('prependSystemContext'));
+  assert.ok(ts.includes('export default plugin'));
+  assert.ok(ts.includes('cook'));
+  assert.ok(ts.includes('fix'));
+  assert.ok(ts.includes('skill-router'));
+});
+
+test('generateEntryPoint handles empty router content', () => {
+  const ts = openclaw.generateEntryPoint([], '');
+  assert.ok(ts.includes('register(api'));
+  assert.ok(ts.includes('export default plugin'));
+});
+
+test('generateEntryPoint escapes backticks in router content', () => {
+  const routerContent = 'Use `cook` skill for code tasks';
+  const ts = openclaw.generateEntryPoint([], routerContent);
+  // Should not have unescaped backticks inside template literal
+  assert.ok(!ts.includes('Use `cook`'));
+  assert.ok(ts.includes('\\`cook\\`'));
+});