@rune-kit/rune 2.2.1 → 2.2.3

package/README.md

@@ -1,10 +1,16 @@
-# Rune
+<p align="center">
+  <img src="assets/banner.svg" alt="Rune — Skill Mesh for AI Coding Assistants" width="100%">
+</p>
 
-**Less skills. Deeper connections.**
+<p align="center">
+  <strong>Less skills. Deeper connections.</strong><br>
+  A lean, interconnected skill ecosystem for AI coding assistants.<br>
+  58 skills · 200+ mesh connections · 8 platforms · MIT
+</p>
 
-A lean, interconnected skill ecosystem for AI coding assistants. 58 skills, 200+ mesh connections, full project lifecycle — from idea to production.
-
-Works on **Claude Code** (native plugin) · **Cursor** · **Windsurf** · **Google Antigravity** · **OpenAI Codex** · **OpenCode** · any AI IDE
+<p align="center">
+  <strong>Claude Code</strong> (native plugin) · <strong>Cursor</strong> · <strong>Windsurf</strong> · <strong>Google Antigravity</strong> · <strong>OpenAI Codex</strong> · <strong>OpenCode</strong> · any AI IDE
+</p>
 
 ## Why Rune?
 
@@ -20,9 +26,11 @@ Mesh:      A ↔ B ↔ C             (B fails = A reaches C via D→E)
            D ↔ E ↔ F
 ```
 
-## What's New (v2.2.1)
+## What's New (v2.2.2)
 
-- **Enforcement Upgrade** — Antigravity-level IDE compliance: 5-type Request Classifier, File Ownership Matrix, Self-Verification HARD-GATE, Routing Proof, Clarification Gate, Phase Transition Protocol. Distributed via compiler — every skill file gets compliance preamble on non-Claude platforms
+- **UI/UX Pro Max Integration** — 161 palettes, 84 styles, 73 font pairings, 161 reasoning rules from [UI/UX Pro Max](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) (MIT, 42.8k★) meshed into `design` skill + `@rune/ui` pack
+- **11 Core Skill Enrichments** — deviation rules, repair operators, evidence quality gate, decision classification, debug knowledge base, CSO discipline, YAGNI pushback, formal pause/resume
+- **Enforcement Upgrade** — Antigravity-level IDE compliance: 5-type Request Classifier, File Ownership Matrix, Self-Verification HARD-GATE, Routing Proof, Clarification Gate, Phase Transition Protocol
 - **All 14 Free Packs Deep** — every L4 extension pack now exceeds 500 lines of production-ready patterns and code examples
 - **8 Platform Adapters** — Claude Code, Cursor, Windsurf, Google Antigravity, OpenAI Codex, OpenCode, OpenClaw, Generic
 - **58 Core Skills** — +3 since v2.1.0: adversary (red team), sentinel-env (env validation), chrome-ext pack
@@ -62,11 +70,12 @@ Rune started as a **Claude Code plugin** and now compiles to **every major AI ID
 ### Claude Code (Native Plugin)
 
 ```bash
-# Via Claude Code plugin marketplace
-/plugin marketplace add rune-kit/rune
-/plugin install rune@rune-kit
+# Install via Claude Code CLI
+claude plugin add rune-kit/rune
 ```
 
+Or add manually in `~/.claude/settings.json` under `installed_plugins`.
+
 Full mesh: subagents, hooks, adaptive routing, mesh analytics.
 
 ### Cursor / Windsurf / Antigravity / Any IDE
@@ -315,7 +324,20 @@ Business department packs for product, sales, and data teams. Same PACK.md forma
 | @rune-pro/data-science | data-exploration, sql-advanced, visualization, statistical-testing, dashboards | Data Science |
 | @rune-pro/support | ticket-triage, response-drafting, knowledge-base, escalation, faq, metrics | Customer Support |
 
-**$49 lifetime** (Pro) · **$149 lifetime** (Business). See [docs/plans/RUNE-PRO-PLAN.md](docs/plans/RUNE-PRO-PLAN.md).
+**$49 lifetime** — [rune-kit/rune-pro](https://github.com/rune-kit/rune-pro)
+
+### Rune Business (Enterprise)
+
+Department packs for finance, legal, HR, and cross-system search. Requires Rune Free core.
+
+| Pack | Skills | For |
+|------|--------|-----|
+| @rune-pro/finance | budget-planning, expense-analysis, revenue-forecasting, financial-reporting, compliance, invoicing, cash-flow | Finance Ops |
+| @rune-pro/legal | contract-review, compliance-check, policy-generator, nda-triage, ip-protection, incident-legal | Legal & Compliance |
+| @rune-pro/hr | jd-writer, resume-screener, interview-planner, scorecard, onboarding, comp-benchmarker, policy-writer | HR & Recruiting |
+| @rune-pro/enterprise-search | query-planner, source-connector, result-merger, permission-guard, knowledge-graph, search-analytics | Knowledge Retrieval |
+
+**$149 lifetime** — [rune-kit/rune-business](https://github.com/rune-kit/rune-business)
 
 ## Multi-Platform Compiler
 
@@ -349,15 +371,19 @@ See [docs/MULTI-PLATFORM.md](docs/MULTI-PLATFORM.md) for the full architecture.
 
 ```
 Core Skills:       58 (L0: 1 │ L1: 5 │ L2: 27 │ L3: 25)
-Extension Packs:   14 free + 4 pro + 2 business
+Extension Packs:   14 free + 4 pro + 4 business
 Mesh Connections:  200+ cross-references
 Connections/Skill: 3.4 avg
 Platforms:         8 (Claude Code, Cursor, Windsurf, Antigravity, Codex, OpenCode, OpenClaw, Generic)
 Compiler:          ~1400 LOC (parser + 8 transforms + 8 adapters + CLI)
 Quality:           58/58 skills with Output Format, Sharp Edges, Done When, Cost Profile
-Pack Depth:        20 packs total (14 free + 4 pro + 2 business, all free packs rated Deep)
+Pack Depth:        22 packs total (14 free + 4 pro + 4 business, all free packs rated Deep)
 ```
 
+## Acknowledgments
+
+- **[UI/UX Pro Max](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)** (MIT, 42.8k★) — Design intelligence databases powering Rune's `design` skill and `@rune/ui` pack: 161 color palettes, 84 UI styles, 73 font pairings, 99 UX guidelines, 161 industry reasoning rules.
+
 ## License
 
 MIT

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\\`'));
+});