@rune-kit/rune 2.2.2 → 2.2.4

package/compiler/__tests__/transforms.test.js

@@ -0,0 +1,92 @@
+import assert from 'node:assert';
+import { describe, test } from 'node:test';
+import { addBranding } from '../transforms/branding.js';
+import { transformCrossReferences } from '../transforms/cross-references.js';
+import { transformToolNames } from '../transforms/tool-names.js';
+
+// --- Mock adapter ---
+
+const mockAdapter = {
+  name: 'test',
+  transformReference(skillName, raw) {
+    const isBackticked = raw.startsWith('`') && raw.endsWith('`');
+    const ref = `@rune-${skillName}.mdc`;
+    return isBackticked ? `\`${ref}\`` : ref;
+  },
+  transformToolName(toolName) {
+    const map = { Read: 'read file', Write: 'write file', Bash: 'run command' };
+    return map[toolName] || toolName;
+  },
+  generateFooter() {
+    return '\n---\n> Rune Test Footer';
+  },
+};
+
+const claudeAdapter = {
+  name: 'claude',
+};
+
+// --- Cross-reference transform ---
+
+describe('transformCrossReferences', () => {
+  test('rewrites backticked rune:cook reference', () => {
+    const input = 'Use `rune:cook` for features.';
+    const result = transformCrossReferences(input, mockAdapter);
+    assert.ok(result.includes('`@rune-cook.mdc`'));
+    assert.ok(!result.includes('rune:cook'));
+  });
+
+  test('rewrites bare rune:plan reference', () => {
+    const input = 'Delegate to rune:plan for planning.';
+    const result = transformCrossReferences(input, mockAdapter);
+    assert.ok(result.includes('@rune-plan.mdc'));
+    assert.ok(!result.includes('rune:plan'));
+  });
+
+  test('handles multiple refs in same line', () => {
+    const input = 'Use `rune:cook` then `rune:test` then `rune:fix`.';
+    const result = transformCrossReferences(input, mockAdapter);
+    assert.ok(result.includes('@rune-cook.mdc'));
+    assert.ok(result.includes('@rune-test.mdc'));
+    assert.ok(result.includes('@rune-fix.mdc'));
+  });
+
+  test('does not modify text without refs', () => {
+    const input = 'Regular markdown without any references.';
+    const result = transformCrossReferences(input, mockAdapter);
+    assert.strictEqual(result, input);
+  });
+});
+
+// --- Tool name transform ---
+
+describe('transformToolNames', () => {
+  test('rewrites tool references in backticks', () => {
+    const input = 'Use `Read` to check the file.';
+    const result = transformToolNames(input, mockAdapter);
+    assert.ok(!result.includes('`Read`'));
+  });
+
+  test('does not modify non-tool words', () => {
+    const input = 'Read the documentation carefully.';
+    const result = transformToolNames(input, mockAdapter);
+    // Should not touch bare "Read" without backticks in tool pattern
+    assert.ok(result.includes('Read'));
+  });
+});
+
+// --- Branding transform ---
+
+describe('addBranding', () => {
+  test('adds footer for non-Claude adapters', () => {
+    const body = '# Skill\n\nSome content.';
+    const result = addBranding(body, mockAdapter);
+    assert.ok(result.includes('Rune Test Footer'));
+  });
+
+  test('skips footer for Claude adapter', () => {
+    const body = '# Skill\n\nSome content.';
+    const result = addBranding(body, claudeAdapter);
+    assert.strictEqual(result, body);
+  });
+});

package/compiler/adapters/antigravity.js

@@ -41,9 +41,10 @@ export default {
     return [
       '',
       '---',
-      '> **Rune Skill Mesh** — 58 skills, 200+ connections',
-      '> Source: https://github.com/rune-kit/rune',
-      '> Full experience with subagents, hooks, adaptive routing → use Rune on Claude Code.',
+      '> **Rune Skill Mesh** — 58 skills, 200+ connections, 14 extension packs',
+      '> Source: https://github.com/rune-kit/rune (MIT)',
+      '> **Rune Pro** ($49 lifetime) — product, sales, data-science, support packs → [rune-kit/rune-pro](https://github.com/rune-kit/rune-pro)',
+      '> **Rune Business** ($149 lifetime) — finance, legal, HR, enterprise-search packs → [rune-kit/rune-business](https://github.com/rune-kit/rune-business)',
     ].join('\n');
   },
 
@@ -52,8 +53,6 @@ export default {
   },
 
   postProcess(content) {
-    return content
-      .replace(/^context: fork\n/gm, '')
-      .replace(/^agent: general-purpose\n/gm, '');
+    return content.replace(/^context: fork\n/gm, '').replace(/^agent: general-purpose\n/gm, '');
   },
 };

package/compiler/adapters/claude.js

@@ -11,7 +11,7 @@ export default {
   skillPrefix: '',
   skillSuffix: '',
 
-  transformReference(skillName, raw) {
+  transformReference(_skillName, raw) {
     return raw;
   },
 

package/compiler/adapters/codex.js

@@ -1,77 +1,69 @@
-/**
- * OpenAI Codex Adapter
- *
- * Emits SKILL.md files into .codex/skills/{name}/ directories.
- * Codex uses the same SKILL.md frontmatter format (name, description)
- * with markdown body — very close to Rune's native format.
- *
- * Codex project context: AGENTS.md (equivalent to CLAUDE.md)
- * Codex skills dir: .codex/skills/
- * Codex skill format: .codex/skills/{name}/SKILL.md
- */
-
-const TOOL_MAP = {
-  Read: 'read the file',
-  Write: 'write/create the file',
-  Edit: 'edit the file',
-  Glob: 'find files by pattern',
-  Grep: 'search file contents',
-  Bash: 'run a shell command',
-  TodoWrite: 'track task progress',
-  Skill: 'follow the referenced skill',
-  Agent: 'execute the workflow',
-};
-
-export default {
-  name: 'codex',
-  outputDir: '.codex/skills',
-  fileExtension: '.md',
-  skillPrefix: 'rune-',
-  skillSuffix: '',
-
-  // Codex uses directory-per-skill: .codex/skills/{name}/SKILL.md
-  useSkillDirectories: true,
-  skillFileName: 'SKILL.md',
-
-  transformReference(skillName, raw) {
-    const isBackticked = raw.startsWith('`') && raw.endsWith('`');
-    const ref = `the rune-${skillName} skill`;
-    return isBackticked ? `\`${ref}\`` : ref;
-  },
-
-  transformToolName(toolName) {
-    return TOOL_MAP[toolName] || toolName;
-  },
-
-  generateHeader(skill) {
-    const desc = (skill.description || '').replace(/"/g, '\\"');
-    return [
-      '---',
-      `name: rune-${skill.name}`,
-      `description: "${desc}"`,
-      '---',
-      '',
-      '',
-    ].join('\n');
-  },
-
-  generateFooter() {
-    return [
-      '',
-      '---',
-      '> **Rune Skill Mesh** — 58 skills, 200+ connections',
-      '> Source: https://github.com/rune-kit/rune',
-      '> Full experience with subagents, hooks, adaptive routing → use Rune on Claude Code.',
-    ].join('\n');
-  },
-
-  transformSubagentInstruction(text) {
-    return text;
-  },
-
-  postProcess(content) {
-    return content
-      .replace(/^context: fork\n/gm, '')
-      .replace(/^agent: general-purpose\n/gm, '');
-  },
-};
+/**
+ * OpenAI Codex Adapter
+ *
+ * Emits SKILL.md files into .codex/skills/{name}/ directories.
+ * Codex uses the same SKILL.md frontmatter format (name, description)
+ * with markdown body — very close to Rune's native format.
+ *
+ * Codex project context: AGENTS.md (equivalent to CLAUDE.md)
+ * Codex skills dir: .codex/skills/
+ * Codex skill format: .codex/skills/{name}/SKILL.md
+ */
+
+const TOOL_MAP = {
+  Read: 'read the file',
+  Write: 'write/create the file',
+  Edit: 'edit the file',
+  Glob: 'find files by pattern',
+  Grep: 'search file contents',
+  Bash: 'run a shell command',
+  TodoWrite: 'track task progress',
+  Skill: 'follow the referenced skill',
+  Agent: 'execute the workflow',
+};
+
+export default {
+  name: 'codex',
+  outputDir: '.codex/skills',
+  fileExtension: '.md',
+  skillPrefix: 'rune-',
+  skillSuffix: '',
+
+  // Codex uses directory-per-skill: .codex/skills/{name}/SKILL.md
+  useSkillDirectories: true,
+  skillFileName: 'SKILL.md',
+
+  transformReference(skillName, raw) {
+    const isBackticked = raw.startsWith('`') && raw.endsWith('`');
+    const ref = `the rune-${skillName} skill`;
+    return isBackticked ? `\`${ref}\`` : ref;
+  },
+
+  transformToolName(toolName) {
+    return TOOL_MAP[toolName] || toolName;
+  },
+
+  generateHeader(skill) {
+    const desc = (skill.description || '').replace(/"/g, '\\"');
+    return ['---', `name: rune-${skill.name}`, `description: "${desc}"`, '---', '', ''].join('\n');
+  },
+
+  generateFooter() {
+    return [
+      '',
+      '---',
+      '> **Rune Skill Mesh** — 58 skills, 200+ connections, 14 extension packs',
+      '> Source: https://github.com/rune-kit/rune (MIT)',
+      '> **Rune Pro** ($49 lifetime) — product, sales, data-science, support packs → [rune-kit/rune-pro](https://github.com/rune-kit/rune-pro)',
+      '> **Rune Business** ($149 lifetime) — finance, legal, HR, enterprise-search packs → [rune-kit/rune-business](https://github.com/rune-kit/rune-business)',
+    ].join('\n');
+  },
+
+  transformSubagentInstruction(text) {
+    return text;
+  },
+
+  postProcess(content) {
+    return content.replace(/^context: fork\n/gm, '').replace(/^agent: general-purpose\n/gm, '');
+  },
+};

package/compiler/adapters/cursor.js

@@ -49,9 +49,10 @@ export default {
     return [
       '',
       '---',
-      '> **Rune Skill Mesh** — 58 skills, 200+ connections',
-      '> Source: https://github.com/rune-kit/rune',
-      '> Full experience with subagents, hooks, adaptive routing → use Rune on Claude Code.',
+      '> **Rune Skill Mesh** — 58 skills, 200+ connections, 14 extension packs',
+      '> Source: https://github.com/rune-kit/rune (MIT)',
+      '> **Rune Pro** ($49 lifetime) — product, sales, data-science, support packs → [rune-kit/rune-pro](https://github.com/rune-kit/rune-pro)',
+      '> **Rune Business** ($149 lifetime) — finance, legal, HR, enterprise-search packs → [rune-kit/rune-business](https://github.com/rune-kit/rune-business)',
     ].join('\n');
   },
 
@@ -60,8 +61,6 @@ export default {
   },
 
   postProcess(content) {
-    return content
-      .replace(/^context: fork\n/gm, '')
-      .replace(/^agent: general-purpose\n/gm, '');
+    return content.replace(/^context: fork\n/gm, '').replace(/^agent: general-purpose\n/gm, '');
   },
 };

package/compiler/adapters/generic.js

@@ -42,9 +42,10 @@ export default {
     return [
       '',
       '---',
-      '> **Rune Skill Mesh** — 58 skills, 200+ connections',
-      '> Source: https://github.com/rune-kit/rune',
-      '> Full experience with subagents, hooks, adaptive routing → use Rune on Claude Code.',
+      '> **Rune Skill Mesh** — 58 skills, 200+ connections, 14 extension packs',
+      '> Source: https://github.com/rune-kit/rune (MIT)',
+      '> **Rune Pro** ($49 lifetime) — product, sales, data-science, support packs → [rune-kit/rune-pro](https://github.com/rune-kit/rune-pro)',
+      '> **Rune Business** ($149 lifetime) — finance, legal, HR, enterprise-search packs → [rune-kit/rune-business](https://github.com/rune-kit/rune-business)',
     ].join('\n');
   },
 
@@ -53,8 +54,6 @@ export default {
   },
 
   postProcess(content) {
-    return content
-      .replace(/^context: fork\n/gm, '')
-      .replace(/^agent: general-purpose\n/gm, '');
+    return content.replace(/^context: fork\n/gm, '').replace(/^agent: general-purpose\n/gm, '');
   },
 };

package/compiler/adapters/index.js

@@ -4,14 +4,14 @@
  * Central registry for all platform adapters.
  */
 
+import antigravity from './antigravity.js';
 import claude from './claude.js';
+import codex from './codex.js';
 import cursor from './cursor.js';
-import windsurf from './windsurf.js';
-import antigravity from './antigravity.js';
 import generic from './generic.js';
 import openclaw from './openclaw.js';
-import codex from './codex.js';
 import opencode from './opencode.js';
+import windsurf from './windsurf.js';
 
 const adapters = {
   claude,

package/compiler/adapters/openclaw.js

@@ -1,150 +1,146 @@
-/**
- * OpenClaw Adapter
- *
- * Emits an OpenClaw plugin structure:
- *   .openclaw/rune/openclaw.plugin.json  (manifest)
- *   .openclaw/rune/src/index.ts          (register entrypoint)
- *   .openclaw/rune/skills/*.md           (transformed skill files)
- *
- * Follows the NeuralMemory OpenClaw plugin pattern.
- */
-
-const TOOL_MAP = {
-  Read: 'read_file',
-  Write: 'write_file',
-  Edit: 'edit_file',
-  Glob: 'glob',
-  Grep: 'grep',
-  Bash: 'run_command',
-  TodoWrite: 'todo_write',
-  Skill: 'follow the referenced skill',
-  Agent: 'execute the workflow',
-};
-
-export default {
-  name: 'openclaw',
-  outputDir: '.openclaw/rune/skills',
-  fileExtension: '.md',
-  skillPrefix: 'rune-',
-  skillSuffix: '',
-
-  transformReference(skillName, raw) {
-    const isBackticked = raw.startsWith('`') && raw.endsWith('`');
-    const ref = `rune-${skillName}.md`;
-    return isBackticked ? `\`${ref}\`` : ref;
-  },
-
-  transformToolName(toolName) {
-    return TOOL_MAP[toolName] || toolName;
-  },
-
-  generateHeader(skill) {
-    return `# rune-${skill.name}\n\n> Rune ${skill.layer} Skill | ${skill.group}\n\n`;
-  },
-
-  generateFooter() {
-    return [
-      '',
-      '---',
-      '> **Rune Skill Mesh** — 55 skills, 200+ connections',
-      '> Source: https://github.com/rune-kit/rune',
-    ].join('\n');
-  },
-
-  transformSubagentInstruction(text) {
-    return text;
-  },
-
-  postProcess(content) {
-    return content
-      .replace(/^context: fork\n/gm, '')
-      .replace(/^agent: general-purpose\n/gm, '');
-  },
-
-  /**
-   * Generate openclaw.plugin.json manifest
-   *
-   * @param {object[]} skills - parsed skill objects
-   * @param {object} pluginJson - Rune's .claude-plugin/plugin.json
-   * @returns {object} manifest object
-   */
-  generateManifest(skills, pluginJson) {
-    return {
-      id: 'rune',
-      name: 'Rune',
-      kind: 'skills',
-      description: '55-skill mesh for AI coding assistants. Routes all code tasks through specialized skills.',
-      version: pluginJson.version || '0.0.0',
-      skills: ['./skills'],
-      configSchema: {
-        jsonSchema: {
-          type: 'object',
-          properties: {
-            disabledSkills: {
-              type: 'array',
-              items: { type: 'string' },
-              description: 'Skills to disable (by name)',
-              default: [],
-            },
-          },
-          additionalProperties: false,
-        },
-        uiHints: {
-          disabledSkills: {
-            label: 'Disabled Skills',
-            help: 'Comma-separated list of skill names to exclude from routing',
-          },
-        },
-      },
-    };
-  },
-
-  /**
-   * Generate src/index.ts entry point with register(api) pattern
-   *
-   * @param {object[]} skills - parsed skill objects
-   * @param {string} routerContent - skill-router SKILL.md content for injection
-   * @returns {string} TypeScript source
-   */
-  generateEntryPoint(skills, routerContent) {
-    const skillNames = skills.map(s => s.name);
-    const routingTable = skills
-      .map(s => `//   ${s.name} (${s.layer}) — ${s.description || s.group}`)
-      .join('\n');
-
-    // Escape backticks and backslashes in router content for template literal
-    const escapedRouter = (routerContent || '')
-      .replace(/\\/g, '\\\\')
-      .replace(/`/g, '\\`')
-      .replace(/\$/g, '\\$');
-
-    return `/**
- * Rune — OpenClaw Plugin Entry Point
- *
- * Auto-generated by Rune compiler.
- * Do not edit manually — regenerate with: rune build --platform openclaw
- *
- * Skills (${skillNames.length}):
-${routingTable}
- */
-
-const SKILL_ROUTER_INSTRUCTIONS = \`${escapedRouter}\`;
-
-const plugin = {
-  id: 'rune',
-  name: 'Rune',
-
-  register(api: any): void {
-    // Inject skill-router instructions so the agent routes through Rune skills
-    api.on('before_agent_start', async () => {
-      return {
-        prependSystemContext: SKILL_ROUTER_INSTRUCTIONS,
-      };
-    }, { priority: 5 });
-  },
-};
-
-export default plugin;
-`;
-  },
-};
+/**
+ * OpenClaw Adapter
+ *
+ * Emits an OpenClaw plugin structure:
+ *   .openclaw/rune/openclaw.plugin.json  (manifest)
+ *   .openclaw/rune/src/index.ts          (register entrypoint)
+ *   .openclaw/rune/skills/*.md           (transformed skill files)
+ *
+ * Follows the NeuralMemory OpenClaw plugin pattern.
+ */
+
+const TOOL_MAP = {
+  Read: 'read_file',
+  Write: 'write_file',
+  Edit: 'edit_file',
+  Glob: 'glob',
+  Grep: 'grep',
+  Bash: 'run_command',
+  TodoWrite: 'todo_write',
+  Skill: 'follow the referenced skill',
+  Agent: 'execute the workflow',
+};
+
+export default {
+  name: 'openclaw',
+  outputDir: '.openclaw/rune/skills',
+  fileExtension: '.md',
+  skillPrefix: 'rune-',
+  skillSuffix: '',
+
+  transformReference(skillName, raw) {
+    const isBackticked = raw.startsWith('`') && raw.endsWith('`');
+    const ref = `rune-${skillName}.md`;
+    return isBackticked ? `\`${ref}\`` : ref;
+  },
+
+  transformToolName(toolName) {
+    return TOOL_MAP[toolName] || toolName;
+  },
+
+  generateHeader(skill) {
+    return `# rune-${skill.name}\n\n> Rune ${skill.layer} Skill | ${skill.group}\n\n`;
+  },
+
+  generateFooter() {
+    return [
+      '',
+      '---',
+      '> **Rune Skill Mesh** — 58 skills, 200+ connections, 14 extension packs',
+      '> Source: https://github.com/rune-kit/rune (MIT)',
+      '> **Rune Pro** ($49 lifetime) — product, sales, data-science, support packs → [rune-kit/rune-pro](https://github.com/rune-kit/rune-pro)',
+      '> **Rune Business** ($149 lifetime) — finance, legal, HR, enterprise-search packs → [rune-kit/rune-business](https://github.com/rune-kit/rune-business)',
+    ].join('\n');
+  },
+
+  transformSubagentInstruction(text) {
+    return text;
+  },
+
+  postProcess(content) {
+    return content.replace(/^context: fork\n/gm, '').replace(/^agent: general-purpose\n/gm, '');
+  },
+
+  /**
+   * Generate openclaw.plugin.json manifest
+   *
+   * @param {object[]} skills - parsed skill objects
+   * @param {object} pluginJson - Rune's .claude-plugin/plugin.json
+   * @returns {object} manifest object
+   */
+  generateManifest(_skills, pluginJson) {
+    return {
+      id: 'rune',
+      name: 'Rune',
+      kind: 'skills',
+      description:
+        '58-skill mesh for AI coding assistants. Routes all code tasks through specialized skills. 200+ connections, 14 extension packs.',
+      version: pluginJson.version || '0.0.0',
+      skills: ['./skills'],
+      configSchema: {
+        jsonSchema: {
+          type: 'object',
+          properties: {
+            disabledSkills: {
+              type: 'array',
+              items: { type: 'string' },
+              description: 'Skills to disable (by name)',
+              default: [],
+            },
+          },
+          additionalProperties: false,
+        },
+        uiHints: {
+          disabledSkills: {
+            label: 'Disabled Skills',
+            help: 'Comma-separated list of skill names to exclude from routing',
+          },
+        },
+      },
+    };
+  },
+
+  /**
+   * Generate src/index.ts entry point with register(api) pattern
+   *
+   * @param {object[]} skills - parsed skill objects
+   * @param {string} routerContent - skill-router SKILL.md content for injection
+   * @returns {string} TypeScript source
+   */
+  generateEntryPoint(skills, routerContent) {
+    const skillNames = skills.map((s) => s.name);
+    const routingTable = skills.map((s) => `//   ${s.name} (${s.layer}) — ${s.description || s.group}`).join('\n');
+
+    // Escape backticks and backslashes in router content for template literal
+    const escapedRouter = (routerContent || '').replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$/g, '\\$');
+
+    return `/**
+ * Rune — OpenClaw Plugin Entry Point
+ *
+ * Auto-generated by Rune compiler.
+ * Do not edit manually — regenerate with: rune build --platform openclaw
+ *
+ * Skills (${skillNames.length}):
+${routingTable}
+ */
+
+const SKILL_ROUTER_INSTRUCTIONS = \`${escapedRouter}\`;
+
+const plugin = {
+  id: 'rune',
+  name: 'Rune',
+
+  register(api: any): void {
+    // Inject skill-router instructions so the agent routes through Rune skills
+    api.on('before_agent_start', async () => {
+      return {
+        prependSystemContext: SKILL_ROUTER_INSTRUCTIONS,
+      };
+    }, { priority: 5 });
+  },
+};
+
+export default plugin;
+`;
+  },
+};